Files

T

хранилище, файлы записей и очередь переведены на встроенную PocketBase

- записи, метаданные и файлы съехались под один каталог данных; появилась
  панель владельца, а gin, goqu, goose и требование CGO ушли
- захват задачи стал одним запросом с RETURNING; заведены число попыток,
  состояние dead и нарастающая пауза вместо признака is_error
- имя файла в хранилище задаёт сервис и в журнал не идёт: вместе с
  идентификатором записи оно собирало бы ссылку на скачивание

2026-08-12 08:31:59 +03:00

3.5 KiB

Raw Blame History

Журнал решений

Одна запись — одно решение. ADR продвигает уже написанное решение, а не сочиняет его заново: запись цитирует решение и ссылается на источник — openspec/changes/archive/<id>/design.md, а у решения, принятого разведкой без изменения, на её записку.

Когда заводить

Верно одно из трёх:

дорогой откат — переделка стоит дороже переписывания одного файла;
намеренный отказ от очевидного подхода;
пересмотр прежнего решения — тогда у старой записи обязателен статус «заменено на».

Не заводить для рутины и для того, что видно из кода и git log.

Соглашения

Имя файла — ADR-ГГГГ-ММ-ДД-slug.md, дата — когда решение реально принято. Слаг английский по сути, а не транслитом: queue-as-table, не ochered-tablicej. Форму имени и слаг проверяет docs.py check.
Записи неизменяемы: передумали — новая запись, старой ставится статус.
Активная запись статуса не имеет. Значений два: заменено на ADR-… и устарело; ставятся полем меты записи — - **Статус:** … рядом с датой и источником, а не абзацем в теле.

Записи

Новые сверху.

Дата	Запись	Статус
2026-08-12	Ссылка на файл открыта знанием записи, а защищает её отсутствие имени в журнале
2026-08-12	Каталог данных задаётся одним ключом `[storage] data_dir`
2026-08-11	Границу распознавания доменного признака держит норма, а не код
2026-08-11	Отказ, который решено не проверять, объявляется поимённо
2026-08-11	Наружу расширение выходит только приведённым к перечню
2026-08-11	Приложение пишем на Vue, а Node входит в гейт и в образ
2026-08-11	Очередь остаётся своей таблицей, но коллекцией PocketBase
2026-08-11	Хранилище, файлы и вход переезжают в PocketBase
2026-08-11	Проверки не зовут внешних программ

Решения, принятые до заведения канона 2026-08-10, источника в архиве изменений не имеют — сочинять их задним числом правило запрещает.

3.5 KiB Raw Blame History

Журнал решений

Когда заводить

Соглашения

Записи

3.5 KiB

Raw Blame History