Files
jellybit/docs/specs
avandClaude Opus 4.8 c0b5ab7295 UI/UX списка и карточки загрузки: серверные фильтр/поиск/пагинация, матч-ссылка, имя раздачи (web-ui-list-detail)
- Список: серверные фильтр по группе состояний, поиск и пагинация (GET
  f/q/page/all, по 25), сортировка по времени добавления в qBittorrent
  (added_on) с фолбеком на created_at и tie-break по id.
- Заголовок загрузки = имя раздачи (display_name) → распознанное название →
  усечённый источник; сырой magnet вынесен в блок «Информация о торренте».
- Матч метабазы показан ссылкой на запись (страница загрузки и ревью);
  URL берётся у выбранного кандидата либо строится по provider+id и типу.
- Полировка вёрстки; клиентская JS-фильтрация убрана (всё серверное, без JS).
- Миграция 0005 (display_name, source_added_at); воркер однократно
  фиксирует source_added_at при поллинге/усыновлении; ER-схема обновлена.
- OpenSpec: дельты влиты в specs/{web-ui,ingest}, change заархивирован.

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

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

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

Соглашения

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

Записи

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