Хранение времени: 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:
@@ -10,6 +10,24 @@ import (
|
||||
"git.vakhrushev.me/av/jellybit/internal/worker"
|
||||
)
|
||||
|
||||
// TestFmtDateZone — дата отображается в переданной таймзоне: полуночное UTC-время
|
||||
// сдвигается на следующий день под Europe/Moscow (UTC+3), в UTC остаётся прежним.
|
||||
func TestFmtDateZone(t *testing.T) {
|
||||
// 2026-06-14 22:30 UTC == 2026-06-15 01:30 MSK.
|
||||
ts := time.Date(2026, 6, 14, 22, 30, 0, 0, time.UTC)
|
||||
|
||||
if got := fmtDate(ts, time.UTC); got != "2026-06-14" {
|
||||
t.Fatalf("UTC: got %q, want 2026-06-14", got)
|
||||
}
|
||||
msk, err := time.LoadLocation("Europe/Moscow")
|
||||
if err != nil {
|
||||
t.Fatalf("load Europe/Moscow (tzdata встроен): %v", err)
|
||||
}
|
||||
if got := fmtDate(ts, msk); got != "2026-06-15" {
|
||||
t.Fatalf("MSK: got %q, want 2026-06-15", got)
|
||||
}
|
||||
}
|
||||
|
||||
func TestHumanizeAge(t *testing.T) {
|
||||
now := time.Date(2026, 7, 4, 12, 0, 0, 0, time.UTC)
|
||||
cases := []struct {
|
||||
|
||||
@@ -58,6 +58,8 @@ type Deps struct {
|
||||
Reader Reader
|
||||
Reviewer Reviewer
|
||||
Live LiveStatus
|
||||
// Loc — таймзона отображения дат в веб-UI (хранение всегда UTC). nil → UTC.
|
||||
Loc *time.Location
|
||||
}
|
||||
|
||||
type server struct {
|
||||
@@ -89,6 +91,9 @@ func NewRouter(d Deps) (http.Handler, error) {
|
||||
if d.Live == nil {
|
||||
d.Live = noLive{} // источник телеметрии не подключён — деградируем штатно
|
||||
}
|
||||
if d.Loc == nil {
|
||||
d.Loc = time.UTC // таймзона отображения не задана — показываем в UTC
|
||||
}
|
||||
s := &server{deps: d, tmpl: tmpl, assetVer: assetVer}
|
||||
|
||||
r := chi.NewRouter()
|
||||
@@ -285,7 +290,7 @@ func (s *server) handleIndex(w http.ResponseWriter, r *http.Request) {
|
||||
|
||||
now := time.Now()
|
||||
for _, d := range downloads {
|
||||
v := toView(d, now)
|
||||
v := s.toView(d, now)
|
||||
// Живой снимок читаем для всех карточек (map-lookup, без сети/БД): рейтинг
|
||||
// и размер нужны в любом состоянии, пока торрент есть в qBittorrent.
|
||||
l, ok := s.liveFor(d)
|
||||
@@ -542,7 +547,7 @@ func toDTO(d store.Download) downloadDTO {
|
||||
}
|
||||
}
|
||||
|
||||
func toView(d store.Download, now time.Time) downloadView {
|
||||
func (s *server) toView(d store.Download, now time.Time) downloadView {
|
||||
state := string(d.State)
|
||||
v := downloadView{
|
||||
ID: d.ID,
|
||||
@@ -561,7 +566,7 @@ func toView(d store.Download, now time.Time) downloadView {
|
||||
// Дата добавления в карточке — всегда (source_added_at → фолбэк created_at,
|
||||
// как в порядке списка); неразбираемое время просто опускаем.
|
||||
if t, ok := addedTime(d); ok {
|
||||
v.Added = fmtDate(t)
|
||||
v.Added = fmtDate(t, s.deps.Loc)
|
||||
v.AddedAgo = humanizeAge(t, now)
|
||||
}
|
||||
return v
|
||||
|
||||
@@ -186,19 +186,11 @@ func fmtRatio(r float64) string {
|
||||
return fmt.Sprintf("%.2f", r)
|
||||
}
|
||||
|
||||
// mskLoc — TZ сервера (Europe/Moscow) для показа дат в веб-UI (инвариант «время
|
||||
// с явным TZ»). Если zoneinfo недоступен в окружении — деградируем до UTC:
|
||||
// дата остаётся корректной с точностью до смещения, UI не падает.
|
||||
var mskLoc = func() *time.Location {
|
||||
if loc, err := time.LoadLocation("Europe/Moscow"); err == nil {
|
||||
return loc
|
||||
}
|
||||
return time.UTC
|
||||
}()
|
||||
|
||||
// fmtDate — абсолютная дата добавления для карточки в TZ сервера.
|
||||
func fmtDate(t time.Time) string {
|
||||
return t.In(mskLoc).Format("2006-01-02")
|
||||
// fmtDate — абсолютная дата добавления для карточки в таймзоне отображения
|
||||
// (general.timezone; хранение всегда UTC). loc не бывает nil — NewRouter
|
||||
// подставляет UTC по умолчанию.
|
||||
func fmtDate(t time.Time, loc *time.Location) string {
|
||||
return t.In(loc).Format("2006-01-02")
|
||||
}
|
||||
|
||||
// humanizeAge — относительная давность («5 дней назад») от now до t. Будущее
|
||||
|
||||
Reference in New Issue
Block a user