diff --git a/CLAUDE.md b/CLAUDE.md index 657fee1..9eaf4c1 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -137,20 +137,19 @@ Module path — `git.vakhrushev.me/av/jellybit`. Go 1.26, `CGO_ENABLED=0`. - Раскладка: `cmd/jellybit` (точка входа) + `internal/<пакет>` по компонентам из [architecture.md](docs/specs/architecture.md). -- Ошибки — stdlib, обёртка с контекстом (`fmt.Errorf("...: %w", err)`), - проверка через `errors.Is`/`errors.As`, трансляция на внешней границе: - [docs/conventions/errors.md](docs/conventions/errors.md). -- Логирование только через `slog`, без `fmt.Println` — уровни, обязательные - поля и что не логировать см. [docs/conventions/logging.md](docs/conventions/logging.md). -- Конфигурация — только TOML; секреты рендерит деплой (Ansible+Vault) в - файл (`config.toml` не коммитится, `0600`), не в env; валидация на старте: - [docs/conventions/config.md](docs/conventions/config.md). -- Время — храним в UTC, RFC 3339 с суффиксом `Z`; генерирует только приложение - (`store.Now()`), таймзона отображения — конфиг `[general].timezone`: - [docs/conventions/database.md](docs/conventions/database.md). -- Идентификаторы — TEXT ULID (lowercase) через `internal/ident`, без числовых - AUTOINCREMENT; внешние id валидируются `ident.Parse` на границе: - [docs/conventions/database.md](docs/conventions/database.md). +- Механизируемое проверяет `task gate` (`.golangci.yml` + `internal/archrules`): + форма ошибок и логов, конфиг мимо env, время мимо `store.Now()`, AUTOINCREMENT + в миграциях, направление зависимостей ядро↔транспорты. Пересказывать эти + правила не нужно — гейт скажет точнее. +- Прозой остаётся то, что правилом не выражается, и читается в источнике: + [ошибки](docs/conventions/errors.md) (трансляция доменной ошибки на внешней + границе, sentinel против типизированной), + [логи](docs/conventions/logging.md) (уровень по адресату, единственный + логирующий чокпоинт, `ext.*`, что не логируем), + [конфиг](docs/conventions/config.md) (секреты рендерит деплой в файл `0600`, + самодокументируемый `config.example.toml`, валидация на старте), + [БД](docs/conventions/database.md) (время в UTC RFC 3339, TEXT ULID через + `internal/ident`, `ident.Parse` на входной границе). - Миграции БД (goose, `internal/store/migrations`; SQL для DDL, Go — когда нужен код) — при изменении структуры (таблица/столбец/индекс/связь) в том же change обновляем ER-схему [docs/specs/database.md](docs/specs/database.md). diff --git a/docs/conventions/database.md b/docs/conventions/database.md index 80ed953..59aa9ec 100644 --- a/docs/conventions/database.md +++ b/docs/conventions/database.md @@ -46,10 +46,9 @@ лексикографическую сортировку TEXT = хронологию (`ORDER BY created_at`). Единая точка генерации — приложение: `store.Now()` + `store.FormatTime`/ `ParseTime` (аналогично `ident.NewID` для id), а не дефолт в схеме — так - забытая вставка падает громко (`NOT NULL` без дефолта). Измерение - длительности — не метка времени: для внешних вызовов его засекает - `logging.StartCall`. Зона хранения всегда UTC; таймзона отображения в UI — конфиг - `[general].timezone`. + забытая вставка падает громко. Измерение длительности — не метка времени: у + внешних вызовов его засекает `logging.StartCall`. Таймзона отображения в + UI — конфиг `[general].timezone`. - Миграции — goose (`internal/store/migrations`): SQL-файлы для DDL; Go-миграции (`goose.AddMigrationContext`) — когда нужен код (генерация id, backfill). При изменении структуры обновляем ER-схему