QwizPro на RelaxDev: игры по коду на сотни участников — WebSocket, комнаты в памяти, отложенная запись в PostgreSQL и Redis
Назад в блог

QwizPro на RelaxDev: игры по коду на сотни участников — WebSocket, комнаты в памяти, отложенная запись в PostgreSQL и Redis

R
relaxdev
10.11.2026 64 просмотров 0

QwizPro — русский сервис тестов для школы, вуза и мероприятий. Учитель собирает тест и проводит его онлайн: ученики заходят по коду с телефонов, как в Quizizz или Kahoot. Тот же тест можно напечатать в нескольких вариантах с ключами для учителя. Проект живёт на RelaxDev с октября 2026 года. Ниже — как устроена игра в реальном времени: сокеты, комнаты в памяти, отложенная запись в PostgreSQL и Redis для лимитов. И что пригодилось от платформы.

Экран ведущего во время игры: живой рейтинг и статистика по вопросамЭкран ведущего во время игры: живой рейтинг и статистика по вопросам

Что видят учитель и ученики

Учитель запускает игру, на проекторе появляется код из 4 цифр и QR-код. Ученики вводят код на qwizpro.ru/join — аккаунт им не нужен, только имя.

Лобби: код игры, QR и участники, которые уже зашлиЛобби: код игры, QR и участники, которые уже зашли

Дальше каждый идёт в своём темпе. У ведущего — живой рейтинг: полоса ответов у каждого участника (зелёные — верно, ярче при серии, красные — ошибки), процент верных по каждому вопросу и кнопка «Завершить игру».

Вопрос на телефоне ученикаВопрос на телефоне ученика

Архитектура в одном контейнере

Next.js 16 и WebSocket-сервер игры работают в одном Node.js-процессе на одном порту. Свой server/index.ts поднимает HTTP-сервер и отдаёт обычные запросы Next.js, а апгрейд на /ws забирает шлюз игры. Один порт — значит, не нужны отдельный домен, второй контейнер и настройка CORS. HTTPS и сертификат даёт платформа, внутри контейнера всё работает по HTTP.

CODE
1
2
3
4
5
6
браузер ── https://qwizpro.ru ──► RelaxDev (TLS) ──► контейнер :8080
                                                     ├─ Next.js: страницы и API
                                                     └─ /ws: шлюз → реестр комнат → комната
                                                                       │
                                     PostgreSQL ◄── отложенная запись ─┘
                                     Redis ◄── лимиты, блокировки, кэш (из API)

Шлюз: защита до того, как сообщение дойдёт до игры

  • Origin. Браузер всегда присылает Origin. Соединение с чужого домена шлюз закрывает сразу.
  • Токен-бакет на соединение: 20 сообщений в секунду, всплеск до 40. Крупное сообщение «стоит» дороже — +1 токен за каждые 8 КБ.
  • Размер сообщения: обычные до 16 КБ, ответ-рисунок до 64 КБ.
  • Медленный клиент. Если в буфере отправки больше 4 МБ, соединение рвётся. Клиент переподключится и получит актуальное состояние, а память сервера не растёт.
  • Подбор кода. Код короткий, поэтому неверных кодов с одного IP — не больше 60 за 10 минут. Лимит на число соединений с IP щедрый: школа выходит в интернет через один адрес, и весь класс — это один IP.
  • Пинг каждые 25 секунд отсеивает «мёртвые» соединения мобильных сетей.

Комната — авторитетный конечный автомат

Каждая игра — объект Room в памяти. Сервер сам ведёт таймеры, проверяет ответы и считает очки (600 за верный ответ и до 400 за скорость, бонус за серию). Правильный ответ уходит игроку только после того, как он ответил, — подсмотреть его в DevTools нельзя.

Рассылки ведущему идут не на каждое событие, а с частотой. Список игроков — раз в 500 мс, рейтинг — раз в 500 мс, общая таблица — раз в 2 с, статистика по вопросам — раз в секунду. Когда 300 человек отвечают одновременно, сервер не рассылает 300 обновлений: ведущий получает одно сводное раз в полсекунды.

Реестр комнат загружает игру из базы по первому обращению. Два одновременных запроса к одной игре получают один и тот же промис загрузки. Раз в 30 секунд реестр выгружает неактивные комнаты: живую игру — через 30 минут тишины, домашнее задание — через 10.

Отложенная запись: ~0 запросов к базе на ответ

Ответы не пишутся в PostgreSQL по одному. Они копятся в памяти, и раз в 300 мс уходят пачкой до 200 строк одним INSERT … VALUES (…), (…) ON CONFLICT DO NOTHING. Уникальный ключ (участник, попытка, вопрос, раунд) защищает от дублей при переподключении. Состояние участников (очки, серия, прогресс, счётчики анти-списывания) обновляется пачкой раз в секунду.

Если запись не удалась, пачка возвращается в начало очереди и уходит со следующей попыткой. При остановке контейнера (SIGTERM при выкладке) шлюз сначала дописывает очередь и только потом закрывает пул соединений. На всё даётся 15 секунд, поэтому новая версия выкатывается без потери ответов.

Раз в минуту в лог пишется строка состояния — по ней видно, что игра в порядке:

CODE
1
[game] комнат 3, соединений 9, вход 0.6/с, ответов 0.1/с, запись 2 мс, в очереди 0

Клиент: переподключение и часы

Мобильный интернет в школе рвётся постоянно, поэтому клиент:

  • Переподключается со ступенчатой задержкой и случайным разбросом, чтобы 30 телефонов не стучались в одну миллисекунду, и восстанавливает место в игре по токену игрока.
  • Синхронизирует часы с сервером по пингам. Берёт выборки с наименьшей задержкой и оценивает смещение, так что таймер вопроса на телефоне совпадает с серверным. После дедлайна сервер ждёт ещё 1,5 с на сетевые задержки.
  • Ведёт контроль выхода из вкладки. Уход короче 3 секунд не считается: это случайное касание или уведомление. Остальные уходы сервер записывает с временем и длительностью, учитель видит их в отчёте.

Redis: только то, что можно потерять

Redis на RelaxDev общий для команды и работает с вытеснением ключей (allkeys-lru). Поэтому важного состояния в нём нет — комнаты игры живут в памяти процесса, результаты в PostgreSQL. Redis отвечает за три вещи:

  1. 1.Лимиты частоты. MULTI → INCR + TTL; если у ключа ещё нет срока, ставится EXPIRE на окно. Так работают лимиты на вход по паролю и коду из письма, генерацию нейросетью (на бесплатном тарифе 3 в минуту), импорт, загрузку картинок, чат поддержки и проверку по фото.
  2. 2.Блокировки. SET lock:… <токен> EX <ttl> NX, а снимает блокировку только тот, чей токен. Пример: одна генерация нейросетью за раз на пользователя. Иначе две вкладки параллельно обошли бы месячную квоту.
  3. 3.Кэш выборок библиотеки и счётчиков разделов.

Если Redis недоступен, приложение не падает: те же функции переключаются на Map в памяти процесса с таймером очистки, а в лог раз в минуту пишется предупреждение. Все ключи идут с префиксом qwiz:, чтобы не пересекаться с другими проектами команды.

Лимиты тарифов — в одном файле и на сервере

Все цифры тарифов лежат в одном файле plans.ts: участники, вопросы в тесте, генерации, импорт, варианты печати, проверки по фото. Из него же собирается таблица на странице тарифов, поэтому сайт и логика не расходятся. Интерфейс лимиты только показывает, проверяет их сервер:

  • генерация нейросетью списывается, только если удалась;
  • импорт сверх лимита загружает первые N вопросов и честно пишет «Загружено 20 из 47»;
  • тест, который стал больше лимита в пробный период, можно править, но нельзя увеличивать.

Печать вариантов и бланки

Печать теста: варианты, перемешивание и ключ в концеПечать теста: варианты, перемешивание и ключ в конце

Варианты печати детерминированы: порядок вопросов и ответов строится генератором случайных чисел с зерном «тест + вариант». Поэтому лист ученика и ключ учителя всегда совпадают. Кнопка «Перемешать заново» добавляет в адрес новый код перемешивания — набор поменялся, ссылка по-прежнему воспроизводит его.

Для теста на бумаге есть бланки как в ЕГЭ. Учитель фотографирует их, нейросеть переписывает клетки, а баллы по ключу считает сервер, а не модель.

Отчёт по игре: баллы, процент, ответы каждого участникаОтчёт по игре: баллы, процент, ответы каждого участника

Что дала платформа

  • Свой Git и сборка по коммиту. На время большой выкладки автодеплой выключается: серия коммитов, затем одна полная сборка и проверка живого сайта.
  • Домены и редиректы. Основной домен qwizpro.ru, старый quizizz.pro отдаёт постоянный редирект — поисковики склеивают дубли.
  • Ретранслятор вебхуков. Telegram не всегда достаёт до серверов в России, поэтому вебхук бота приходит через постоянный зарубежный адрес платформы.
  • PostgreSQL, Redis и хранилище с CDN подключаются к проекту переменными. База, логи и переменные доступны из панели и через коннектор: схема, запрос, логи после выкладки, смена переменной без пересборки.

Что дальше

  • Адреса вида /library/предмет/класс/тема и обязательные поля при публикации — для поиска.
  • Античит для онлайн-контрольных: полный экран, режим «по одному вопросу без возврата», настройки учителя на N выходов.
  • Приложения: Android в RuStore на основе готового сайта, затем iOS.

Попробовать можно на qwizpro.ru: создать тест бесплатно или взять готовый в библиотеке.

Проект из статьи
qwizizz

Комментарии (0)

Ответить без регистрации

Изображения, PDF, TXT • Ctrl+V для скриншота • до 5 файлов, 10 MB
Пока нет комментариев. Будьте первым!