Files
jellybit/docs/specs
avandClaude Opus 4.8 aac3ced262 Реализовал выбор источника и предпросмотр в ревью (review-source-selection)
Экран ревью теперь показывает единый список источников совпадения: строка
«распознано нейронкой» наравне с кандидатами баз; выбор/переключение/снятие
в пользу нейронки; ручное добавление по id или URL (TMDB/IMDb — по URL,
TVDB — по числовому id); предпросмотр полей и целевых путей каждого источника
до применения (место под режиссёра зарезервировано). «Раскладка» осталась
отдельной секцией для активного источника, инлайн-превью неактивных — по клику.

Ядро: единая деривация «источник → overrides» (sourcePins), общая для превью
и коммита → preview == apply; заодно чинит латентный залипший override
title/year при переключении источника. Превью считается эфемерно, без записи
в БД; пользовательский URL только парсится (SSRF нет).

Ревью дизайна и кода пройдены; правки ревьюеров учтены (сообщение об ошибке
ручного ввода доходит до пользователя, URL без схемы принимается).

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

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

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

Соглашения

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

Записи

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