72 lines
3.2 KiB
Markdown
72 lines
3.2 KiB
Markdown
# Session Status Bot
|
||
|
||
Бот на `aiogram 3` для управления статусами персонажей через кнопки и автоматического обновления одного сообщения в канале.
|
||
|
||
## Что умеет
|
||
|
||
- показывает пользователю только его кнопку, если он привязан по `operator_user_id` или `operator_user_ids`
|
||
- позволяет админам видеть все кнопки
|
||
- после выбора персонажа предлагает статус: `open`, `backstage`, `delay`, `rest`
|
||
- после выбора статуса все основные действия доступны кнопками: шаблон, без фразы, своя фраза, назад
|
||
- обновляет заданное сообщение в канале через `edit_message_text`
|
||
- рендерит пост как HTML с кликабельными ссылками
|
||
- хранит текущее состояние в `data/state.json`
|
||
|
||
## Настройка
|
||
|
||
1. Установите зависимости:
|
||
|
||
```powershell
|
||
uv sync
|
||
```
|
||
|
||
2. Заполните `.env` по примеру из `[.env.example](/c:/Users/admin/Desktop/pidoras/.env.example)`.
|
||
|
||
Обязательные переменные:
|
||
|
||
- `BOT_TOKEN` — токен бота
|
||
- `CHANNEL_ID` — ID канала, где лежит обновляемое сообщение
|
||
- `CHANNEL_MESSAGE_ID` — ID сообщения в канале
|
||
- `ADMIN_IDS` — список Telegram user id через запятую
|
||
|
||
3. Отредактируйте `[config/actors.json](/c:/Users/admin/Desktop/pidoras/config/actors.json)`.
|
||
|
||
Для каждого участника задаются:
|
||
|
||
- `key` — внутренний ключ
|
||
- `button_text` — текст на кнопке
|
||
- `display_name` — имя в посте
|
||
- `link` — ссылка на бота
|
||
- `operator_user_id` или `operator_user_ids` — Telegram user id человека, который может менять этот статус
|
||
- `phrases` — шаблонные фразы под каждый статус
|
||
|
||
## Запуск
|
||
|
||
```powershell
|
||
uv run python main.py
|
||
```
|
||
|
||
## Команды
|
||
|
||
- `/start` или `/panel` — открыть панель
|
||
- `/help` — показать справку
|
||
- `/refresh` — принудительно перерисовать сообщение канала
|
||
- `/cancel` — сбросить текущий ввод и вернуться к панели
|
||
|
||
## Как это работает
|
||
|
||
1. Пользователь пишет `/start`.
|
||
2. Бот показывает доступные кнопки персонажей.
|
||
3. После выбора персонажа бот показывает кнопки статусов.
|
||
4. После выбора статуса бот показывает кнопки вариантов фразы.
|
||
5. Если выбрать `Своя фраза`, бот ждет одно текстовое сообщение.
|
||
6. После выбора бот редактирует сообщение в канале.
|
||
|
||
## Проверка
|
||
|
||
Тест рендера:
|
||
|
||
```powershell
|
||
uv run --with pytest python -m pytest
|
||
```
|