Files
jellybit/docs/specs
avandClaude Opus 4.8 5c3ef79496 Раскладка: сходимость папки сериала (второй сезон в ту же папку)
При подтверждённом матче база папки (имя+год) наследуется от живой
папки-якоря того же (provider, provider_id) вместо печати заново из выхода
LLM — так второй/последующий сезон ложится в ТУ ЖЕ папку, а не заводит
рядом почти одинаковую. Отдельная сущность «тайтл» не вводится.

- layout: Plan.FolderBase перекрывает базу в папке и именах файлов;
  TitleFolder разбирает dst_path в папку тайтла и базу (снятие тега).
- store: LiveTitleFolders — dst_path живых ссылок того же матча.
- worker: resolveFolderBase (живость якоря — по наличию папки на диске,
  os.Lstat, а не по статусу ссылки в БД) в linkPlan и в превью ревью
  (превью=применение); рассинхрон нескольких живых папок → review из
  linking (deferred→review в графе нет).

Схема БД не менялась. Change series-folder-convergence заархивирован,
требования влиты в openspec/specs/file-layout.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-10 13:50:49 +03:00
..

Спецификации

Живые документы о том, как устроена система — целевое и актуальное состояние. В отличие от ADR, спецификации изменяемы: их правят по мере развития проекта и держат в соответствии с кодом. В отличие от черновиков, описывают принятое и реализуемое, а не идеи.

Соглашения

  • Имя файла — kebab-topic.md, без дат (дата живёт в git-истории).
  • Одна спецификация — одна тема.
  • Если решение требует объяснения «почему именно так» с долгим следом — заведи ADR и сошлись на него из спецификации.

Записи

  • architecture.md — общее устройство: компоненты, транспорты, хранилище, раскладка, деплой.
  • workflow.md — жизненный цикл загрузки: машина состояний, переходы, сопоставление состояний qBittorrent.
  • recognition.md — распознавание контента и модель уверенности.
  • review-ux.md — ревью раскладки человеком: UI/UX-сценарии на случай, когда система не уверена.
  • jellyfin-layout.md — конвенции именования файлов Jellyfin, в которые раскладываем.