From afe563d265675e95d6b05fdc3d17df2086b42d7f Mon Sep 17 00:00:00 2001 From: buryan-agent Date: Fri, 23 Oct 2026 20:07:12 +0300 Subject: [PATCH] =?UTF-8?q?[SPRINT-3]=20=D0=9A=D0=B0=D1=82=D0=B0=D0=BB?= =?UTF-8?q?=D0=BE=D0=B3=20=D0=BC=D0=B5=D0=B4=D0=B8=D0=B0=20=D1=81=20=D0=BD?= =?UTF-8?q?=D0=BE=D1=80=D0=BC=D0=B0=D0=BB=D0=B8=D0=B7=D0=B0=D1=86=D0=B8?= =?UTF-8?q?=D0=B5=D0=B9,=20=D1=80=D0=B0=D0=B7=D0=B1=D0=BE=D1=80=20=D0=BD?= =?UTF-8?q?=D0=B0=D0=BC=D0=B5=D1=80=D0=B5=D0=BD=D0=B8=D0=B9,=20=D1=80?= =?UTF-8?q?=D0=BE=D0=BB=D0=B8,=20=D1=81=D1=82=D0=B0=D1=82=D1=83=D1=81?= =?UTF-8?q?=D1=8B=20=D0=BF=D0=BE=D0=B6=D0=B5=D0=BB=D0=B0=D0=BD=D0=B8=D0=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/ops/SPRINT-3-BOTS.md | 100 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 100 insertions(+) create mode 100644 ops/ops/SPRINT-3-BOTS.md diff --git a/ops/ops/SPRINT-3-BOTS.md b/ops/ops/SPRINT-3-BOTS.md new file mode 100644 index 0000000..ceb2cb5 --- /dev/null +++ b/ops/ops/SPRINT-3-BOTS.md @@ -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` | владелец | отклонить | + +При смене статуса автору уходит уведомление. + +## Что осталось по спринту + +* словарь алиасов/транслитерации для русских запросов к англоязычным тайтлам; +* перенос разбора намерений в профильные боты (сейчас через секретаря); +* статистика использования по ролям (кто чем пользуется).