Хранение времени: RFC 3339 (UTC) + таймзона отображения в конфиге
Метки времени в SQLite переведены с формата datetime('now')
(«2006-01-02 15:04:05») на RFC 3339 всегда-UTC («2006-01-02T15:04:05Z»):
самоописываемое хранилище (зона в значении), валидный ISO 8601, единый
формат с логами. Фиксированная ширина сохраняет лексикографическую
сортировку TEXT = хронологию (COALESCE(source_added_at, created_at)).
- Единая точка генерации времени в Go: store.Now()/FormatTime; DEFAULT
(datetime('now')) снят со всех колонок — время всегда пишет приложение
(зеркально ident.NewID для id), fail-loud при забытой вставке (NOT NULL).
Все INSERT-сайты в store передают created_at/updated_at явно.
- Миграция 0008 (rebuild 7 таблиц без DEFAULT + backfill strftime, FK/PK/
индексы сохранены байт-в-байт по образцу 0006); симметричная down.
- Новая секция конфига [general] с полем timezone (дефолт UTC) — зона
ОТОБРАЖЕНИЯ в веб-UI; хранение остаётся UTC. Жёсткая валидация зоны на
старте; zoneinfo встроен (time/tzdata), заменён зашитый Europe/Moscow.
- Тесты: round-trip миграции (up/down, NULL source_added_at), валидация
зоны, сдвиг даты по зоне; обновлены фикстуры и TestUlidMigration.
- Docs: конвенции database/config, ER-схема; спека web-ui (таймзона).
OpenSpec change time-storage-rfc3339 (заархивирован).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -17,6 +17,7 @@ const DefaultPath = "config.toml"
|
||||
|
||||
// Config — корневая конфигурация сервиса (см. config.example.toml).
|
||||
type Config struct {
|
||||
General General `toml:"general"`
|
||||
QBittorrent QBittorrent `toml:"qbittorrent"`
|
||||
Paths Paths `toml:"paths"`
|
||||
Storage Storage `toml:"storage"`
|
||||
@@ -30,6 +31,15 @@ type Config struct {
|
||||
Log Log `toml:"log"`
|
||||
}
|
||||
|
||||
// General — общие настройки приложения.
|
||||
type General struct {
|
||||
// Timezone — таймзона ОТОБРАЖЕНИЯ времени в веб-UI (IANA, напр.
|
||||
// "Europe/Moscow"). Хранение всегда UTC; настройка влияет только на рендеринг.
|
||||
// Пусто → UTC. База зон встроена (time/tzdata), поэтому имя валидируется
|
||||
// одинаково на любом хосте (см. DisplayLocation).
|
||||
Timezone string `toml:"timezone"`
|
||||
}
|
||||
|
||||
// QBittorrent — доступ к qBittorrent WebUI и раскладка путей загрузок.
|
||||
type QBittorrent struct {
|
||||
URL string `toml:"url"`
|
||||
@@ -152,10 +162,26 @@ func (d *Duration) UnmarshalText(text []byte) error {
|
||||
// Std возвращает обычный time.Duration.
|
||||
func (d Duration) Std() time.Duration { return time.Duration(d) }
|
||||
|
||||
// DisplayLocation возвращает таймзону отображения времени в веб-UI (пусто → UTC).
|
||||
// Ошибка — если имя зоны не распознано; валидируется на старте (validate).
|
||||
// Зоны доступны на любом хосте: база zoneinfo встроена в бинарь (time/tzdata),
|
||||
// поэтому ошибка означает именно битое имя, а не отсутствие zoneinfo.
|
||||
func (c *Config) DisplayLocation() (*time.Location, error) {
|
||||
if c.General.Timezone == "" {
|
||||
return time.UTC, nil
|
||||
}
|
||||
loc, err := time.LoadLocation(c.General.Timezone)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("general.timezone %q: %w", c.General.Timezone, err)
|
||||
}
|
||||
return loc, nil
|
||||
}
|
||||
|
||||
// Default возвращает конфиг с разумными умолчаниями; значения из файла
|
||||
// перекрывают их при загрузке.
|
||||
func Default() *Config {
|
||||
return &Config{
|
||||
General: General{Timezone: "UTC"},
|
||||
QBittorrent: QBittorrent{
|
||||
URL: "http://qbit:8989",
|
||||
Username: "admin",
|
||||
@@ -229,6 +255,10 @@ func (c *Config) validate() error {
|
||||
if c.LLM.Type != "openai-compat" {
|
||||
errs = append(errs, fmt.Errorf("unsupported llm.type %q (supported: openai-compat)", c.LLM.Type))
|
||||
}
|
||||
// Таймзона отображения: имя должно распознаваться (zoneinfo встроен).
|
||||
if _, err := c.DisplayLocation(); err != nil {
|
||||
errs = append(errs, err)
|
||||
}
|
||||
|
||||
// Медиа-пути песочницы: абсолютные, без traversal, существующие каталоги.
|
||||
for _, p := range []struct{ name, path string }{
|
||||
|
||||
@@ -5,6 +5,7 @@ import (
|
||||
"path/filepath"
|
||||
"strings"
|
||||
"testing"
|
||||
"time"
|
||||
)
|
||||
|
||||
// validCfg возвращает минимально валидный конфиг поверх Default() с медиа-путями
|
||||
@@ -55,6 +56,24 @@ func TestValidate_KeylessLocalLLM(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// TestDisplayLocation — зона отображения: пусто → UTC, валидная зона грузится,
|
||||
// zoneinfo встроен (time/tzdata) → доступна на любом хосте.
|
||||
func TestDisplayLocation(t *testing.T) {
|
||||
empty := &Config{}
|
||||
if loc, err := empty.DisplayLocation(); err != nil || loc != time.UTC {
|
||||
t.Fatalf("пустая зона → UTC, got %v, %v", loc, err)
|
||||
}
|
||||
|
||||
c := &Config{General: General{Timezone: "Europe/Moscow"}}
|
||||
loc, err := c.DisplayLocation()
|
||||
if err != nil {
|
||||
t.Fatalf("Europe/Moscow должна грузиться (tzdata встроен): %v", err)
|
||||
}
|
||||
if loc.String() != "Europe/Moscow" {
|
||||
t.Fatalf("loc = %q, want Europe/Moscow", loc.String())
|
||||
}
|
||||
}
|
||||
|
||||
func TestValidate_Errors(t *testing.T) {
|
||||
cases := []struct {
|
||||
name string
|
||||
@@ -74,6 +93,7 @@ func TestValidate_Errors(t *testing.T) {
|
||||
{"jellyfin enabled no url", func(c *Config) { c.Jellyfin.Enabled = true; c.Jellyfin.URL = "" }, "jellyfin.url"},
|
||||
{"jellyfin enabled no key", func(c *Config) { c.Jellyfin.Enabled = true; c.Jellyfin.URL = "http://j"; c.Jellyfin.APIKey = "" }, "jellyfin.api_key"},
|
||||
{"telegram enabled no token", func(c *Config) { c.Telegram.Enabled = true }, "telegram.token"},
|
||||
{"bad timezone", func(c *Config) { c.General.Timezone = "Mars/Phobos" }, "general.timezone"},
|
||||
}
|
||||
for _, tc := range cases {
|
||||
t.Run(tc.name, func(t *testing.T) {
|
||||
|
||||
Reference in New Issue
Block a user