Хранение времени: 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:
@@ -0,0 +1,30 @@
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: Таймзона отображения времени
|
||||
|
||||
Веб-UI SHALL отображать все временные метки (абсолютные даты добавления и
|
||||
создания, относительная давность) в **таймзоне отображения из конфигурации**
|
||||
(`[general].timezone`, дефолт `UTC`). Зона MUST NOT быть зашита в код.
|
||||
Метки в БД хранятся всегда в UTC (RFC 3339); конвертация в зону отображения
|
||||
SHALL выполняться только на рендеринге, не затрагивая хранение и сортировку.
|
||||
|
||||
База зон (zoneinfo) SHALL встраиваться в бинарь (`time/tzdata`), поэтому зоны
|
||||
доступны независимо от окружения контейнера. Некорректное (нераспознаваемое)
|
||||
значение `timezone` в конфиге SHALL приводить к ошибке на старте приложения
|
||||
(валидация конфигурации), а не к тихой подмене зоны на рендеринге.
|
||||
|
||||
#### Scenario: Дата в сконфигурированной зоне
|
||||
|
||||
- **WHEN** в конфиге `timezone = "Europe/Moscow"` и рендерится карточка загрузки
|
||||
- **THEN** абсолютная дата добавления показана в зоне `Europe/Moscow`
|
||||
- **AND** та же метка в БД хранится в UTC с суффиксом `Z`
|
||||
|
||||
#### Scenario: Зона по умолчанию — UTC
|
||||
|
||||
- **WHEN** `[general].timezone` в конфиге не задан
|
||||
- **THEN** времена в веб-UI отображаются в UTC
|
||||
|
||||
#### Scenario: Невалидная зона в конфиге
|
||||
|
||||
- **WHEN** `[general].timezone` содержит нераспознаваемое значение
|
||||
- **THEN** приложение завершается с ошибкой конфигурации на старте
|
||||
Reference in New Issue
Block a user