docs: устранены расхождения документов между собой и с кодом
- README разгружен: контракт HTTP API, таблицы БД, состояния задач и белый список отданы нормативным источникам ссылками - в `architecture.md` и `review.md` числа и механика захвата задачи заменены ссылками на `database.md`, а описание конвейера ревью — на прогон от 2026-08-11 - в `CLAUDE.md` и `security.md` поправлены границы домена, оценка объёма записи и адрес очереди задач
This commit is contained in:
+10
-5
@@ -2,8 +2,11 @@
|
||||
|
||||
## Как настроен конвейер
|
||||
|
||||
Конвейера ревью в проекте пока нет: плагин не подключён, ни одного прогона не
|
||||
было. Раздел заполнен наперёд по коду — он и служит настройкой первому прогону.
|
||||
Конвейер ревью прогонялся один раз — 2026-08-11, на изменении
|
||||
`fix-http-handler-tests`; его триаж лежит в
|
||||
`openspec/changes/archive/2026-08-11-fix-http-handler-tests/review/triage.md`.
|
||||
Разделы ниже заполнены наперёд по коду и правятся по итогам прогонов: «Типовые
|
||||
ложноположительные» первым прогоном уже пользовались.
|
||||
|
||||
### Типовые узлы
|
||||
|
||||
@@ -71,8 +74,9 @@
|
||||
[conventions/errors.md](conventions/errors.md).
|
||||
- **«Захват задачи не в транзакции — гонка двух воркеров».** По построению её
|
||||
нет: три воркера читают три разных состояния, и одну строку они не делят.
|
||||
Находка становится настоящей ровно тогда, когда появится второй экземпляр
|
||||
процесса или второй воркер на то же состояние.
|
||||
Механика захвата и её слабые места — [database.md](database.md),
|
||||
«Представление данных». Находка становится настоящей ровно тогда, когда
|
||||
появится второй экземпляр процесса или второй воркер на то же состояние.
|
||||
- **«Файлы и объекты не удаляются, диск растёт».** Факт верный и записан в
|
||||
[database.md](database.md); срок хранения не задан сознательно, задачи на него нет.
|
||||
Новой находкой это не считается, пока не измерен рост.
|
||||
@@ -103,7 +107,8 @@
|
||||
`createTranscribeJob` — сегодня через него идут оба входа
|
||||
([architecture.md](architecture.md), «Единые точки проекта»).
|
||||
- `architecture`: не поехало ли поведение в `architecture.md` вместо спеки —
|
||||
спек ещё нет, и соблазн описать поведение в обзоре максимальный.
|
||||
заведена одна capability (`openspec/specs/intake`), поведение прочих узлов
|
||||
живёт в обзоре под маркерами долга, и соблазн дописать туда ещё максимальный.
|
||||
- `conventions`: новая колонка правится во всех четырёх местах репозитория
|
||||
(CLAUDE.md, «Инварианты»).
|
||||
- `autotests`: покрыт ли изменённый шаг конвейера хоть одним тестом — сегодня
|
||||
|
||||
Reference in New Issue
Block a user