[SPRINT-3] Каталог медиа с нормализацией, разбор намерений, роли, статусы пожеланий

This commit is contained in:
buryan-agent committed 2026-10-23 20:07:12 +03:00
1 parent 3b73397fd8
commit afe563d265
1 file changed
+100
+100
View File
@@ -0,0 +1,100 @@
# Спринт 3: боты — переделка (23.10)
## 1. Слой сбора и нормализации — ✅
`/opt/hub-core/media_catalog.py` собирает единый каталог из Jellyfin, Radarr,
Sonarr и Seerr и сводит один фильм к **одной карточке**.
| Показатель | Значение |
|---|---|
| Источников | 4 (jellyfin 3, radarr 14, sonarr 6, seerr 0) |
| Карточек после склейки | **20** |
| Склеено из нескольких источников | **3** |
| В медиатеке | 3 |
| В планах | 17 |
Склейка идёт **по tmdb/tvdb**, а не по названию — потому что Jellyfin хранит
русские названия («Дюна»), Radarr — английские («Dune»).
Примеры склеек:
```
Дюна ← jellyfin + radarr (tmdb 438631)
Ферма Кларксона ← jellyfin + sonarr (tvdb 378165)
Interstellar ← jellyfin + radarr (tmdb 157336)
```
Алиасы сохраняются: у «Дюны» есть и «Dune», поэтому поиск по `dune` находит её.
### API
```
GET /catalog?q=&kind=&state=&limit= — поиск по каталогу
GET /catalog/stats — сводка
GET /catalog/rebuild — пересобрать
```
### Ловушки
1. **Год терялся у Jellyfin** — карточки не склеивались. Решение: склейка по
внешним ID (ProviderIds), а не по названию+году.
2. **Стеммер не работал для 4-буквенных слов** — «дюну» не находило «Дюна».
Порог понижен, теперь режем окончания и у коротких слов.
3. **Seerr отдаёт 403** на `/api/v1/request` даже с ключом (права ключа), и
заявок в его базе сейчас 0 — источник подключён, но данных нет.
## 2. Понимание запросов — ✅ (правила + ИИ)
`/opt/hub-core/intents.py`: разбор намерений по правилам, при неудаче —
**DeepSeek** (JSON-ответ).
| Запрос | Намерение | Ответ |
|---|---|---|
| найди дюну | find | «Дюна (2021) — в медиатеке» |
| что посмотреть | recommend | 4 варианта с оценками |
| сколько всего | stats | «20 карточек, 3 в медиатеке, 17 в планах» |
| кто дома | who | «Роман дома» |
| скачай дюну | add | «уже есть в медиатеке» |
| скачай сериал Severance | add | «уже добавлен» |
| хочу чтобы был дашборд погоды | wish | пожелание |
Секретарь вызывает `/intent` **до** RAG — быстрый ответ вместо долгого поиска.
**Ограничение:** русские запросы к англоязычным названиям («матрицу» → The
Matrix) не находятся, если русского алиаса нет ни в одной системе. Нужен
словарь транслитерации/алиасов.
## 3. Роли — ✅
`/etc/hub-bots/roles.json`:
| Роль | Кто | Права |
|---|---|---|
| owner | @akadmin | всё |
| family | elena, sergey, polina, nikita | спрашивать, искать, пожелания |
| guest | alextest | спрашивать, искать |
| unknown | остальные | только «помощь» |
`hub/roles.py`: `role_of()`, `allowed_users()`, `can()`.
`main.py` берёт список допущенных из ролей (5 человек вместо одного владельца).
Команда `!ктоя` показывает роль.
## 4. Пожелания — ✅
Статусы: `new → in_progress → done` (или `rejected`).
| Команда | Кто | Что делает |
|---|---|---|
| `!хочу <идея>` | все | создать пожелание |
| `!пожелания` | владелец | список со статусами и иконками |
| `!взял N` | владелец | в работу |
| `!готово N` | владелец | закрыть |
| `!отказ N` | владелец | отклонить |
При смене статуса автору уходит уведомление.
## Что осталось по спринту
* словарь алиасов/транслитерации для русских запросов к англоязычным тайтлам;
* перенос разбора намерений в профильные боты (сейчас через секретаря);
* статистика использования по ролям (кто чем пользуется).