Files
buryan-infra/docs/BOTS-ROLES.md
buryan-agent cc7c98dad7 Доступ всем участникам + у каждого бота своя инструкция по направлению
ALLOWED_USERS расширен: владелец, Полина, Елена, Никита, Сергей, Алекс.

Для каждого бота написана подробная инструкция именно по его зоне:
медиа (Jellyfin/Seerr/Sonarr/Radarr/Navidrome), фото (Immich), книги
(Calibre), дом (HA, Android/Google TV), инфраструктура, поиск, дайджест,
камеры. В инструкции — что умеет, примеры человеческих фраз, ссылки и
ограничения.

Бот присылает инструкцию при первом обращении от человека (один раз,
состояние в onboarded.json), «помощь» повторяет её.

Проверено: инструкции различаются (610–1249 символов), повторное
обращение не спамит, «помощь» отдаёт нужную.
2026-10-19 20:10:30 +03:00

50 lines
2.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Зоны ответственности ботов и доступ
Дата: 19.10.2026.
## Кто за что отвечает
| Бот | Зона | Источники | Ссылки |
|---|---|---|---|
| `@media` | фильмы, сериалы, музыка: что есть, что качается, что заказать | Jellyfin, Seerr, Sonarr, Radarr, Navidrome | media, ombi, sonarr |
| `@photo` | фотографии и альбомы | Immich | immich |
| `@book` | книги: что есть, что нового, поиск | Calibre | books, каталог |
| `@home` | устройства и датчики дома (Android, Google TV) | Home Assistant | home |
| `@infra` | службы, диски, бэкапы, проблемы, входящие | Prometheus, Kuma, ядро | status, backup |
| `@search` | поиск сразу по всем сервисам, карточки, лента | ядро hub-core | панель |
| `@digest` | сводки за сутки и неделю, карта платформы | ядро | панель |
| `@cam` | видеонаблюдение | Frigate | Frigate (LAN) |
У каждого бота — **своя полная инструкция**: что умеет, как спросить
по-человечески, полезные ссылки и важные ограничения. Не общая, а именно
по направлению.
## Как это работает
1. Человек пишет боту в личку впервые.
2. Бот присылает свою инструкцию (один раз на человека, состояние в
`/var/lib/hub-bots/onboarded.json`).
3. Дальше можно писать обычными словами: «что нового», «найди дюна».
4. «Помощь» в любой момент повторяет инструкцию.
## Доступ
Открыт всем участникам (`ALLOWED_USERS` в `/etc/hub-bots/bots.env`):
* @akadmin (владелец)
* @polina
* @elena
* @nikita
* @sergey
* @alextest
Каждый получает тот же набор команд — разграничение по ролям будет
следующим шагом (сейчас все в одной роли «свой»).
## Проверено
* у всех восьми ботов инструкции различаются (610–1249 символов);
* первое обращение присылает инструкцию, повторное — нет;
* «помощь» отдаёт инструкцию направления;
* `@cam` рассказывает про камеры, `@media` — про медиатеку.