diff --git a/ops/ops/SPRINT-3-BOTS.md b/ops/ops/SPRINT-3-BOTS.md index ceb2cb5..c98f702 100644 --- a/ops/ops/SPRINT-3-BOTS.md +++ b/ops/ops/SPRINT-3-BOTS.md @@ -98,3 +98,79 @@ Matrix) не находятся, если русского алиаса нет * словарь алиасов/транслитерации для русских запросов к англоязычным тайтлам; * перенос разбора намерений в профильные боты (сейчас через секретаря); * статистика использования по ролям (кто чем пользуется). + +--- + +# Дополнение (20:15): закрыты оставшиеся пункты спринта + +## 1. История и кэш слоя сбора — ✅ + +| Механизм | Реализация | +|---|---| +| **Кэш каталога** | `load()` держит JSON в памяти, обновляет по `mtime` файла | +| **История изменений** | `/var/lib/hub-core/catalog_history.jsonl` | +| **Журнал диалогов** | `/var/lib/hub-bots/dialog.jsonl` (был) | + +История пишется при каждой сборке, только при изменениях: + +```json +{"event": "state", "title": "Test", "from": "tracked", "to": "in_library"} +{"event": "added", "title": "New", "kind": "movie", "year": 2024} +{"event": "removed", "title": "..."} +``` + +Проверено: при подмене «до/после» записались 2 события. + +## 4. Разбор входящих (inbox) — ✅ + +`/opt/hub-core/inbox_parse.py` + `hub-inbox.timer` (каждые 30 минут). + +Читает `/var/lib/hub-bots/inbox/*.jsonl`, классифицирует по правилам и +складывает в базу пожеланий с тегом: + +| Тег | Ключевые слова | Сколько | +|---|---|---| +| content | фильм, сериал, книг, скачать | 12 | +| feature | хочу чтобы, дашборд, отчёт | 4 | +| other | остальное | 14 | +| bug | не работает, ошибка, падает | 0 (пока) | + +Первый прогон: **разобрано 15 записей**, всего в базе **31 пожелание**. +Обработанное помечается в `inbox_state.json` — повторно не разбирается. + +Колонки в `wishes`: `tag`, `inbox_ref` (ссылка `2026-10-23#4`). + +## 3. Роли во всех ботах (не только в секретаре) — ✅ + +В `matrix.py` добавлен `_role_gate`, вызывается в `dispatch()` **до** любой +команды и свободной фразы. + +| Роль | Опасные команды (restart/delete/approve/config) | Остальное | +|---|---|---| +| owner | разрешено | разрешено | +| family | **запрещено** | разрешено | +| guest | запрещено | только help/find/search + безопасные намерения | +| unknown | запрещено | только help | + +Проверка `_role_gate`: + +``` +owner restart -> разрешено +family restart -> ЗАПРЕЩЕНО +family help -> разрешено +guest restart -> ЗАПРЕЩЕНО +guest help -> разрешено +unknown restart -> ЗАПРЕЩЕНО +``` + +Гость при свободной фразе сначала прогоняется через `/intent`: если это +поиск/рекомендация/статистика — отвечаем, иначе вежливый отказ. + +## Итог по спринту 3 + +| Пункт | Статус | +|---|---| +| 1. Слой сбора: нормализация, история, кэш | ✅ | +| 2. Понимание запросов (правила + LLM) | ✅ (локальная модель отложена) | +| 3. Роли: владелец/семья/гость | ✅ во всех ботах | +| 4. Пожелания: разбор inbox + статусы | ✅ |