[SPRINT-3] Каталог медиа с нормализацией, разбор намерений, роли, статусы пожеланий
This commit is contained in:
1 parent
3b73397fd8
commit
afe563d265
1 file changed
+100
@@ -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` | владелец | отклонить |
|
||||
|
||||
При смене статуса автору уходит уведомление.
|
||||
|
||||
## Что осталось по спринту
|
||||
|
||||
* словарь алиасов/транслитерации для русских запросов к англоязычным тайтлам;
|
||||
* перенос разбора намерений в профильные боты (сейчас через секретаря);
|
||||
* статистика использования по ролям (кто чем пользуется).
|
||||
Reference in new issue
Block a user