From 177a2bb21fb7875ef5b02549e8ed6f7cff4b15ca Mon Sep 17 00:00:00 2001 From: Toutsu Date: Thu, 21 May 2026 19:32:54 +0300 Subject: [PATCH] =?UTF-8?q?Create=20wiki=20page=20'=D0=A0=D1=83=D0=BA?= =?UTF-8?q?=D0=BE=D0=B2=D0=BE=D0=B4=D1=81=D1=82=D0=B2=D0=BE=20=D0=93=D0=9C?= =?UTF-8?q?=D0=B0'?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...81%D1%82%D0%B2%D0%BE-%D0%93%D0%9C%D0%B0.md | 127 ++++++++++++++++++ 1 file changed, 127 insertions(+) create mode 100644 %D0%A0%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%BE-%D0%93%D0%9C%D0%B0.md diff --git a/%D0%A0%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%BE-%D0%93%D0%9C%D0%B0.md b/%D0%A0%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%BE-%D0%93%D0%9C%D0%B0.md new file mode 100644 index 0000000..69f8353 --- /dev/null +++ b/%D0%A0%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%BE-%D0%93%D0%9C%D0%B0.md @@ -0,0 +1,127 @@ +# Руководство ГМа + +## Создание группы + +### Telegram +- Напишите боту `/newgroup`. +- Укажите название группы. +- Группа создана — вы назначены owner. + +### Веб-дашборд +- Зайдите на сайт / откройте Mini App. +- Нажмите "Создать группу". +- Укажите название, описание, платформу (Telegram / Discord / обе). + +## Создание расписания (Batch) + +### Telegram: `/newsession` +Формат сообщения: +``` +Название: Название кампании +Ссылка: https://roll20.net/... +Картинка: https://... (опционально) + +2026-05-25 19:00 5 +2026-05-28 19:00 5 +``` +- Каждая строка: `YYYY-MM-DD HH:MM max_players`. +- `max_players` — максимальный состав (0 = без ограничений). +- `Картинка:` — обложка batch (опционально). + +### Discord: `/newsession` +- Slash-команда `/newsession`. +- Заполните поля: title, dates (через запятую), max-players, link. +- Бот создаст batch и пришлёт подтверждение. + +## Публикация расписания + +### Telegram: `/listsessions` +- Показывает все сессии группы с inline-кнопками Join/Leave. +- Можно отменить (`❌`) или удалить (`🗑`) сессию. +- Можно инициировать перенос (`🔄`). + +### Discord: `/listsessions` +- Публикует embed с расписанием и кнопками Join/Leave. +- При нажатии кнопок schedule message автоматически обновляется. + +## Управление игроками + +### Лист ожидания (Waitlist) +- Когда сессия заполнена — новые игроки попадают в waitlist. +- При выходе участника первый из waitlist автоматически поднимается в основной состав. +- В веб-дашборде ГМ может вручную поднять игрока из очереди. + +### Co-GM +- Owner может назначить co-GM по Telegram ID в веб-дашборде. +- Co-GM может: создавать/редактировать сессии, управлять waitlist. +- Co-GM **не может** назначать других co-GM. + +## Шаблоны кампаний + +- В веб-дашборде: вкладка `Шаблоны`. +- Сохраните типовые параметры (title, max-players, link). +- Запустите новый batch из шаблона в один клик. + +## Bulk-операции (Web Dashboard) + +- **Обновить title/link**: применить к всему batch. +- **Сдвинуть даты**: перенести все сессии на +N дней. +- **Клонировать**: скопировать batch на следующую неделю или месяц. + +## Переносы (Reschedule Voting) + +### Как инициировать +- **Telegram**: в `/listsessions` нажмите `🔄` у сессии. +- **Discord**: в schedule message нажмите кнопку reschedule. + +### Как работает +- Бот предлагает варианты новых дат/времени. +- Игроки голосуют кнопками. +- Голосование завершается по дедлайну (обычно через N часов). +- Побеждает вариант с наибольшим количеством голосов. +- Schedule message автоматически обновляется. + +## RSVP (Подтверждения) + +- За 24 часа до сессии бот отправляет запрос подтверждения. +- **Telegram**: inline-кнопки "Подтвердить" / "Отклонить". +- **Discord**: кнопки **Confirm** / **Decline**. +- GM получает итоги RSVP. + +## Уведомления + +### Режимы +- `В группе и в личку` — каждый игрок получает DM + групповое сообщение. +- `Только в группе` — только групповые сообщения. + +### Типы уведомлений +- За 24ч: запрос подтверждения (RSVP). +- За 1ч: напоминание. +- За 5 мин: ссылка на игру. +- Отмена / перенос: уведомление об изменении. + +## Статистика посещаемости + +- Страница `/group/{id}/stats`. +- Показывает долю присутствия, пропуски, среднюю явку по каждому игроку. +- Считается только для завершённых сессий (статус `completed`). + +## История изменений + +- Страница `/session/{id}/history`. +- Аудит-лог: время, ссылка, название, участники, статус. +- Указывается актор и дата изменения. + +## FAQ для ГМа + +### Бот не отвечает +- Проверьте права администратора в группе. +- Попробуйте `/start`. + +### Кнопки не работают +- Нужно право "Manage Messages". +- Подождите 1–2 минуты — возможно, rate limit. + +### Mini App не открывается +- Должен быть HTTPS. +- Домен должен быть зарегистрирован в BotFather (`/setdomain`).