avandClaude Opus 4.8
6b7c090ce4
Завершённая загрузка ложно «воскресала» из deleted в orphaned, когда её целевой путь переиспользовала другая загрузка (повторная закачка того же фильма в другом качестве): сверка проверяла лишь существование пути, не проверяя, что файл по нему — наша раскладка. Вводим инвариант «один целевой путь — один владелец»: - при успешной раскладке на освободившийся чужой путь владение переходит к новой загрузке — прежние file_link на этот путь помечаются статусом superseded и перестают считаться целью при сверке; - deleted исключён из desyncStates — терминальное состояние больше не переоценивается (источник к нему не вернётся из-за идемпотентности, цель отбирается переходом владения); - Undo снимает только реально свои разложенные ссылки (superseded пропускает — файл по пути теперь чужой хардлинк); - ошибку перехода владения трактуем как некритичную (WARN-and-continue): файлы уже разложены, рассинхрон чужих задач исправит следующий тик. Без миграции схемы (status — TEXT). Дельта влита в основную спеку, обновлены workflow.md и jellyfin-layout.md. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Спецификации
Живые документы о том, как устроена система — целевое и актуальное состояние. В отличие от ADR, спецификации изменяемы: их правят по мере развития проекта и держат в соответствии с кодом. В отличие от черновиков, описывают принятое и реализуемое, а не идеи.
Соглашения
- Имя файла —
kebab-topic.md, без дат (дата живёт в git-истории). - Одна спецификация — одна тема.
- Если решение требует объяснения «почему именно так» с долгим следом — заведи ADR и сошлись на него из спецификации.
Записи
- architecture.md — общее устройство: компоненты, транспорты, хранилище, раскладка, деплой.
- workflow.md — жизненный цикл загрузки: машина состояний, переходы, сопоставление состояний qBittorrent.
- recognition.md — распознавание контента и модель уверенности.
- review-ux.md — ревью раскладки человеком: UI/UX-сценарии на случай, когда система не уверена.
- jellyfin-layout.md — конвенции именования файлов Jellyfin, в которые раскладываем.