Хранение времени: 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:
Claude Opus 4.8
@@ -112,9 +112,17 @@ Ansible + Vault). Приложение просто читает TOML — отд
|
||||
- диапазоны: `recognition.auto_confidence_threshold` ∈ [0, 1],
|
||||
`llm.max_retries` ≥ 0;
|
||||
- длительности парсятся (`llm.timeout`, `worker.poll_interval`, …);
|
||||
- `general.timezone` — распознаваемая IANA-зона (валидируется
|
||||
`time.LoadLocation`; zoneinfo встроен через `time/tzdata`, поэтому ошибка =
|
||||
битое имя, а не отсутствие базы в окружении);
|
||||
- включённые секции консистентны: `metadata.tmdb.enabled` → задан `api_key`;
|
||||
`jellyfin.enabled` → заданы `url`+`api_key`; `telegram.enabled` → `token`.
|
||||
|
||||
**Таймзоны.** Хранение времени в БД и логи — всегда UTC. Зона **отображения** в
|
||||
веб-UI задаётся `[general].timezone` (дефолт `UTC`); только она конфигурируема,
|
||||
на хранение/сортировку/логи не влияет. Бизнес-логика оперирует временем с явным
|
||||
TZ (см. [CLAUDE.md](../../CLAUDE.md)).
|
||||
|
||||
## Структура в коде
|
||||
|
||||
- Весь разбор и валидация — в `internal/config`; наружу отдаётся готовая
|
||||
|
||||
@@ -39,8 +39,14 @@
|
||||
|
||||
- Enum-поля (`state`, `kind`, …) — обычный `TEXT` без `CHECK`; допустимые
|
||||
значения держит код (`internal/store`).
|
||||
- Временные метки — `TEXT DEFAULT (datetime('now'))` (UTC), формат
|
||||
`store.ParseTime`/`FormatTime`.
|
||||
- Временные метки — `TEXT` в **RFC 3339, UTC (суффикс `Z`)**, напр.
|
||||
`2006-01-02T15:04:05Z` (секундная точность). Фиксированная ширина сохраняет
|
||||
лексикографическую сортировку TEXT = хронологию (`ORDER BY created_at`).
|
||||
Единая точка генерации — приложение: `store.Now()` + `store.FormatTime`/
|
||||
`ParseTime` (аналогично `ident.NewID` для id); `DEFAULT (datetime('now'))` на
|
||||
колонках **не используется** (fail-loud при забытой вставке: `NOT NULL` без
|
||||
дефолта). Зона хранения всегда UTC; таймзона отображения в UI — конфиг
|
||||
`[general].timezone`.
|
||||
- Миграции — goose (`internal/store/migrations`): SQL-файлы для DDL;
|
||||
Go-миграции (`goose.AddMigrationContext`) — когда нужен код (генерация
|
||||
id, backfill). При изменении структуры обновляем ER-схему
|
||||
|
||||
+14
-10
@@ -11,12 +11,16 @@
|
||||
>
|
||||
> Состояние на: миграции `0001_init`, `0002_recognition_plan`,
|
||||
> `0003_source_miss_count`, `0004_candidate_url`, `0005_display_name`,
|
||||
> `0006_ulid_identity` (Go-миграция: ULID-идентификаторы, `download_infohash`).
|
||||
> `0006_ulid_identity` (Go-миграция: ULID-идентификаторы, `download_infohash`),
|
||||
> `0007_file_link_size`, `0008_rfc3339_time` (метки времени → RFC 3339 UTC,
|
||||
> `DEFAULT` убран).
|
||||
|
||||
Назначение таблиц и почему так — [architecture.md](architecture.md) →
|
||||
«Хранилище». Значения `state` и переходы — [workflow.md](workflow.md).
|
||||
Первичные ключи — ULID (TEXT, lowercase), генерятся приложением
|
||||
(`internal/ident`) — см. [конвенцию](../conventions/database.md).
|
||||
(`internal/ident`) — см. [конвенцию](../conventions/database.md). Метки времени
|
||||
(`created_at`/`updated_at`) — TEXT в RFC 3339, UTC (суффикс `Z`); пишет
|
||||
приложение (`store.Now`/`FormatTime`), без `DEFAULT` на колонках.
|
||||
|
||||
## ER-диаграмма
|
||||
|
||||
@@ -40,15 +44,15 @@ erDiagram
|
||||
TEXT error_msg "nullable"
|
||||
INTEGER source_miss_count "NOT NULL DEFAULT 0; дебаунс пропажи источника (миграция 0003)"
|
||||
TEXT source_added_at "nullable; время добавления в qBittorrent (added_on), базис сортировки (миграция 0005)"
|
||||
TEXT created_at "NOT NULL DEFAULT datetime('now')"
|
||||
TEXT updated_at "NOT NULL DEFAULT datetime('now')"
|
||||
TEXT created_at "NOT NULL; RFC 3339 UTC (Z), пишет приложение"
|
||||
TEXT updated_at "NOT NULL; RFC 3339 UTC (Z), пишет приложение"
|
||||
}
|
||||
|
||||
download_infohash {
|
||||
TEXT download_id PK_FK "NOT NULL; ON DELETE CASCADE; PK(infohash, download_id)"
|
||||
TEXT infohash PK "NOT NULL; lowercase hex (40 — v1, 64 — v2)"
|
||||
TEXT kind "NOT NULL; v1|v2"
|
||||
TEXT created_at "NOT NULL DEFAULT datetime('now')"
|
||||
TEXT created_at "NOT NULL; RFC 3339 UTC (Z), пишет приложение"
|
||||
}
|
||||
|
||||
recognition {
|
||||
@@ -66,14 +70,14 @@ erDiagram
|
||||
TEXT reasons "NOT NULL DEFAULT '[]'; JSON: причины не-авто"
|
||||
TEXT raw_llm "nullable; сырой ответ LLM"
|
||||
TEXT plan "nullable; JSON recognize.Plan (миграция 0002)"
|
||||
TEXT created_at "NOT NULL DEFAULT datetime('now')"
|
||||
TEXT created_at "NOT NULL; RFC 3339 UTC (Z), пишет приложение"
|
||||
}
|
||||
|
||||
hint {
|
||||
TEXT id PK "ULID"
|
||||
TEXT download_id FK "NOT NULL; ON DELETE CASCADE"
|
||||
TEXT text "NOT NULL"
|
||||
TEXT created_at "NOT NULL DEFAULT datetime('now')"
|
||||
TEXT created_at "NOT NULL; RFC 3339 UTC (Z), пишет приложение"
|
||||
}
|
||||
|
||||
override {
|
||||
@@ -81,7 +85,7 @@ erDiagram
|
||||
TEXT download_id FK "NOT NULL; ON DELETE CASCADE"
|
||||
TEXT field "NOT NULL; UNIQUE(download_id, field)"
|
||||
TEXT value "NOT NULL"
|
||||
TEXT created_at "NOT NULL DEFAULT datetime('now')"
|
||||
TEXT created_at "NOT NULL; RFC 3339 UTC (Z), пишет приложение"
|
||||
}
|
||||
|
||||
metadata_candidate {
|
||||
@@ -93,7 +97,7 @@ erDiagram
|
||||
INTEGER year "nullable"
|
||||
TEXT url "nullable; ссылка на страницу на сайте провайдера"
|
||||
INTEGER chosen "NOT NULL DEFAULT 0; 0/1"
|
||||
TEXT created_at "NOT NULL DEFAULT datetime('now')"
|
||||
TEXT created_at "NOT NULL; RFC 3339 UTC (Z), пишет приложение"
|
||||
}
|
||||
|
||||
file_link {
|
||||
@@ -105,7 +109,7 @@ erDiagram
|
||||
TEXT kind "NOT NULL; video|subtitle|..."
|
||||
TEXT status "NOT NULL; linked|..."
|
||||
INTEGER size "NOT NULL DEFAULT 0; размер файла (байт), фолбэк размера раздачи"
|
||||
TEXT created_at "NOT NULL DEFAULT datetime('now')"
|
||||
TEXT created_at "NOT NULL; RFC 3339 UTC (Z), пишет приложение"
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
Reference in New Issue
Block a user