TRIBALCORE Написать
Все проекты

QuizRoom

Как проходит одна игра

Учебный проект: квизы в реальном времени. Ведущий запускает комнату, игроки подключаются с телефонов по коду или QR-коду и отвечают, пока идёт таймер.

  • React
  • Node.js
  • Express
  • Socket.IO
  • SQLite
Разобрать игру
Демо-игра, 36 секундигроки ненастоящие

Задача

Сделать квиз, в который можно играть в одной комнате: вопрос на большом экране, ответы с телефонов, без установки приложения и обязательной регистрации.

Все должны видеть одно и то же в один момент, а обновление страницы не должно выбивать игрока из игры.

Одна игра

Демо-квиз «Разминка: мир технологий» из тестовых данных репозитория, три вопроса.

  1. Комната и код

    Ведущий запускает квиз и получает шестизначный код и QR-код. Игрок входит гостем: нужно только имя. Ведущий видит, кто уже в комнате.

    Код
    6 цифр
    Вход
    по QR, без регистрации
    Экран ведущего: код подключения, QR-код для входа без регистрации и четыре игрока в комнате
    Комната готова
  2. Вопрос на всех экранах

    Socket.IO одновременно показывает вопрос на экране и телефонах. Таймер идёт на сервере, после него ответы не принимаются. Ведущий видит, сколько игроков ответили, и промежуточный лидерборд.

    Таймер
    20 секунд
    Баллы
    за точность и скорость
    Экран ведущего: вопрос 3 из 3 с вариантами ответа, справа счётчик ответивших 1 из 4 и лидерборд
    Вопрос и лидерборд
  3. Итоги

    После последнего вопроса показывается финальный рейтинг со статистикой: точность, среднее время ответа и самый сложный вопрос. Результаты сохраняются в истории.

    Точность
    75%
    Средний ответ
    2,6 с
    Финальный рейтинг: 4 участника, точность 75%, средний ответ 2,6 секунды, таблица игроков с баллами
    Финальный рейтинг

Что я сделал

  • Сценарии ведущего и игрока и модель данных: пользователи, квизы, вопросы, игровые сессии и ответы.
  • REST API на Express с JWT-авторизацией и ролями «Организатор» и «Участник».
  • Игровые комнаты на Socket.IO: единый серверный таймер, приём ответов и начисление баллов.
  • Гостевой вход по QR-коду, восстановление после обновления страницы, пояснения к ответам и звуки.
  • Проверки: API-тесты на Vitest и Supertest и smoke-тест полной игры через Socket.IO.

Ограничения

  • Один сервер: для нескольких экземпляров понадобилось бы общее хранилище состояния, например Redis.
  • Таймеры комнат живут в памяти и не переживают перезапуск сервера.
  • Картинки к вопросам хранятся на диске, а не в объектном хранилище.

Код открыт. В README есть быстрый запуск с демо-пользователями и макет интерфейса в Figma.

Нужно что‑то похожее?

Беру проекты и открыт к работе в команде. Расскажу, как устроен QuizRoom.

Почта ilalatorcev@gmail.com

отвечаю в течение дня