GlitchMe!

Настольная игра с REST-API, реактивным фронтендом и Telegram-ботом.

📖 Описание

GlitchMe! — это уникальная комбинация настольной игры и компьютерного интерфейса: Полностью модульная архитектура, все на Python 3.13

• FastAPI - стабильный бэкенд
• Flet - фронтенд (веб-интерфейс) на версии 0.28
• Aiogram 3 - Telegram-бот для удобного подключения и взаимодействия

---

🚀 Установка и запуск

1. Установите зависимости

   pip install -r requirements.txt

2. Запустите бекенд

    python -m fastapi run api/main.py

3. Запустите фронтенд

   python -m app.main

4. Запустите Telegram-бот

   python -m bot.main

---

🛠 Killer-фичи

• Модульная архитектура — механика в REST-API, клиенты (Flet, бот) только отображают и отправляют данные
• Мгновенная регистрация — скан QR + 1 клик в боте
• Конфигурируемость — неограниченное число тем/заданий
• Реактивный интерфейс — Flet-сайт обновляется в реальном времени без перезагрузки

---

🎮 Механика игры

1. Подготовка:

   • Администратор создаёт игру (POST /game/create → QR + метаданные)
   • Игроки подключаются (PATCH /game/connect/{id})

2. Раунды: N раундов, в каждом:

   1. Начало: рассылка заданий с учётом роли «Глюка»
   2. Обсуждение: опросы игроков (каждый не более 1 раза)
   3. Голосование: исключение наиболее подозрительного (секретный алгоритм при «ничье»)

3. Завершение: выжившие побеждают или побеждает Глюк после последнего раунда

---

📚 Конфигурация

Все темы и задания настраиваются в файле config.json в словаре rounds_questions. Просто добавьте новые ключи и списки строк — и они автоматически появятся в игре!

---

Enjoy the glitch! 🎲