docs(wiki): add FAQ / Troubleshooting — Telegram + Discord

2026-05-21 18:45:57 +03:00
parent 612d418a1f
commit c2b985241d
+48
@@ -0,0 +1,48 @@
# FAQ / Устранение неполадок
## Telegram
### Бот не отвечает на команды
- Проверьте, что бот добавлен в группу и имеет права администратора.
- Убедитесь, что вы пишете команду с `/` (например, `/start`).
- Попробуйте перезапустить бота: `/start`.
### Кнопки не работают
- Боту нужно право "Manage Messages" для редактирования schedule.
- Если кнопки "зависли" — подождите 1–2 минуты и попробуйте снова.
### Mini App не открывается
- Убедитесь, что `TELEGRAM_MINI_APP_URL` использует **HTTPS**.
- Проверьте, что домен добавлен в BotFather (`/setdomain`).
- На iOS убедитесь, что Telegram обновлён до последней версии.
## Discord
### Slash-команды не появляются
- Перезапустите Docker Compose (регистрация команд происходит при старте).
- Проверьте, что у бота есть scope `applications.commands`.
- На сервере должно быть не более 100 глобальных команд (у нас их < 10).
### Кнопки Join/Leave не работают
- Боту нужны права: Send Messages, Embed Links, Manage Messages.
- Если кнопка "не нажимается" — проверьте, что вы не заблокировали бота.
### DM-уведомления не приходят
- Проверьте Discord Privacy Settings → "Allow direct messages from server members".
- Бот не может писать первым, если вы его заблокировали.
- Сбои DM логируются — ГМ увидит, что уведомление не дошло.
## Общее
### Reschedule голосование не завершилось
- Голосование завершается по дедлайну (обычно через N часов).
- Если голосов мало — побеждает вариант с наибольшим количеством голосов.
- При равенстве — выбирается первый по времени.
### Игрок из waitlist не поднялся автоматически
- Проверьте, что у сессии установлен `max_players` > 0.
- Если `max_players` не задан — waitlist не работает (все помещаются в основной состав).
### Статистика показывает 0%
- Статистика считается только для **завершённых** сессий (статус `completed`).
- Если все сессии в статусе `planned` или `cancelled` — статистики не будет.