42 lines
3.2 KiB
Markdown
42 lines
3.2 KiB
Markdown
# Дорожная карта
|
|
|
|
Черновик плана реализации. Ориентир, не обязательство; по ходу
|
|
уточняется. Что реализовано и как устроено — в `docs/specs`.
|
|
|
|
## Фазы
|
|
|
|
- **Ф0 — каркас.** go.mod, раскладка пакетов, загрузка TOML-конфига,
|
|
SQLite + миграции, slog-логи, `Dockerfile` (минимальный рантайм-образ,
|
|
копирует готовый бинарь), golangci-lint, lefthook. Документация (этот
|
|
этап — частично готов).
|
|
- **Ф1 — ingest + tracking (без LLM).** `Ingest()` + добавление в
|
|
qBittorrent (источник отдаём ему, категория `jellybit`, ключ
|
|
идемпотентности по infohash) + `worker`-поллинг завершения (трансляция
|
|
`path_map`) + машина состояний. Наружу: HTTP API, список в веб-UI,
|
|
`jellybit add`.
|
|
- **Ф2 — распознавание.** `go-ptn` + LLM (structured output) → план +
|
|
оценка уверенности. Без записи на диск.
|
|
- **Ф3 — раскладка + минимальный review.** Хардлинки по конвенциям
|
|
Jellyfin (санитизация пути, never-overwrite), субтитры, идемпотентность,
|
|
**undo**. Авто только при матче в базе и чистой валидации; иначе → review
|
|
(htmx): подсказка + перераспознавание, из ручного — тип, выбор кандидата
|
|
базы, пометка «игнор». Полный редактор маппинга — Ф5. См.
|
|
[review-ux.md](../specs/review-ux.md).
|
|
- **Ф4 — метаданные.** TMDB/TVDB опционально, provider-id в именах,
|
|
валидация распознавания против числа серий.
|
|
- **Ф5 — Telegram + UX.** Бот-адаптер + парсер сообщений торрент-бота,
|
|
подтверждение в боте (карточка + кнопки + reply-подсказка, эскалация в
|
|
веб), полный редактор маппинга «файл → серия», триггер скана Jellyfin,
|
|
нотификации.
|
|
- **Ф6 — деплой.** Сборка статического бинаря здесь; доставка бинаря +
|
|
`Dockerfile` на сервер, `docker build` и запуск на месте; оркестрация —
|
|
`playbook-jellybit.yml` в umbar: `network_mode: host`, `user 1000:1000`,
|
|
mount `/srv` + data-том `/srv/applications/jellybit/data`, healthcheck.
|
|
|
|
## Заметки по порядку
|
|
|
|
- Минимальный review-экран нужен уже в Ф3 (как только появляется режим
|
|
«спросить при сомнении»), полноценный UX — в Ф5.
|
|
- Jellyfin в umbar ещё не развёрнут — раскладку файлов это не блокирует,
|
|
тестируется без него; триггер скана подключаем, когда Jellyfin поднят.
|