From c2b985241dee2967e1fd40eac4c1681abee67046 Mon Sep 17 00:00:00 2001
From: Toutsu <hegin4@yandex.ru>
Date: Thu, 21 May 2026 18:45:57 +0300
Subject: [PATCH] =?UTF-8?q?docs(wiki):=20add=20FAQ=20/=20Troubleshooting?=
 =?UTF-8?q?=20=E2=80=94=20Telegram=20+=20Discord?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 FAQ.md | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 FAQ.md

diff --git a/FAQ.md b/FAQ.md
new file mode 100644
index 0000000..ed18b62
--- /dev/null
+++ b/FAQ.md
@@ -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` — статистики не будет.