QuizRoom
Как проходит одна игра
Учебный проект: квизы в реальном времени. Ведущий запускает комнату, игроки подключаются с телефонов по коду или QR-коду и отвечают, пока идёт таймер.
Разобрать игруЗадача
Сделать квиз, в который можно играть в одной комнате: вопрос на большом экране, ответы с телефонов, без установки приложения и обязательной регистрации.
Все должны видеть одно и то же в один момент, а обновление страницы не должно выбивать игрока из игры.
Одна игра
Демо-квиз «Разминка: мир технологий» из тестовых данных репозитория, три вопроса.
-
Комната и код
Ведущий запускает квиз и получает шестизначный код и QR-код. Игрок входит гостем: нужно только имя. Ведущий видит, кто уже в комнате.
- Код
- 6 цифр
- Вход
- по QR, без регистрации
Комната готова -
Вопрос на всех экранах
Socket.IO одновременно показывает вопрос на экране и телефонах. Таймер идёт на сервере, после него ответы не принимаются. Ведущий видит, сколько игроков ответили, и промежуточный лидерборд.
- Таймер
- 20 секунд
- Баллы
- за точность и скорость
Вопрос и лидерборд -
Итоги
После последнего вопроса показывается финальный рейтинг со статистикой: точность, среднее время ответа и самый сложный вопрос. Результаты сохраняются в истории.
- Точность
- 75%
- Средний ответ
- 2,6 с
Финальный рейтинг
Что я сделал
- Сценарии ведущего и игрока и модель данных: пользователи, квизы, вопросы, игровые сессии и ответы.
- REST API на Express с JWT-авторизацией и ролями «Организатор» и «Участник».
- Игровые комнаты на Socket.IO: единый серверный таймер, приём ответов и начисление баллов.
- Гостевой вход по QR-коду, восстановление после обновления страницы, пояснения к ответам и звуки.
- Проверки: API-тесты на Vitest и Supertest и smoke-тест полной игры через Socket.IO.
Ограничения
- Один сервер: для нескольких экземпляров понадобилось бы общее хранилище состояния, например Redis.
- Таймеры комнат живут в памяти и не переживают перезапуск сервера.
- Картинки к вопросам хранятся на диске, а не в объектном хранилище.
Код и ссылки
Код открыт. В README есть быстрый запуск с демо-пользователями и макет интерфейса в Figma.
Нужно что‑то похожее?
Беру проекты и открыт к работе в команде. Расскажу, как устроен QuizRoom.
Почта ilalatorcev@gmail.com
отвечаю в течение дня