Хранение времени: 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 }{
|
||||
|
||||
Reference in New Issue
Block a user