jellybit/openspec/changes/archive/2026-07-04-time-storage-rfc3339/specs/web-ui/spec.md at 7473cbd6d3984c7519ad10bc164710e5859fe084

av/jellybit

Fork 0

Files

T

avandClaude Opus 4.8 5d5456fa68

Хранение времени: 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>

2026-07-04 11:32:07 +03:00

2.0 KiB

Raw Blame History

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 приложение завершается с ошибкой конфигурации на старте

2.0 KiB Raw Blame History