
QwizPro на RelaxDev: игры по коду на сотни участников — WebSocket, комнаты в памяти, отложенная запись в PostgreSQL и Redis
QwizPro — русский сервис тестов для школы, вуза и мероприятий. Учитель собирает тест и проводит его онлайн: ученики заходят по коду с телефонов, как в Quizizz или Kahoot. Тот же тест можно напечатать в нескольких вариантах с ключами для учителя. Проект живёт на RelaxDev с октября 2026 года. Ниже — как устроена игра в реальном времени: сокеты, комнаты в памяти, отложенная запись в PostgreSQL и Redis для лимитов. И что пригодилось от платформы.
Экран ведущего во время игры: живой рейтинг и статистика по вопросам
Что видят учитель и ученики
Учитель запускает игру, на проекторе появляется код из 4 цифр и QR-код. Ученики вводят код на qwizpro.ru/join — аккаунт им не нужен, только имя.
Лобби: код игры, QR и участники, которые уже зашли
Дальше каждый идёт в своём темпе. У ведущего — живой рейтинг: полоса ответов у каждого участника (зелёные — верно, ярче при серии, красные — ошибки), процент верных по каждому вопросу и кнопка «Завершить игру».
Вопрос на телефоне ученика
Архитектура в одном контейнере
Next.js 16 и WebSocket-сервер игры работают в одном Node.js-процессе на одном порту. Свой server/index.ts поднимает HTTP-сервер и отдаёт обычные запросы Next.js, а апгрейд на /ws забирает шлюз игры. Один порт — значит, не нужны отдельный домен, второй контейнер и настройка CORS. HTTPS и сертификат даёт платформа, внутри контейнера всё работает по HTTP.
браузер ── 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 секунд, поэтому новая версия выкатывается без потери ответов.
Раз в минуту в лог пишется строка состояния — по ней видно, что игра в порядке:
[game] комнат 3, соединений 9, вход 0.6/с, ответов 0.1/с, запись 2 мс, в очереди 0Клиент: переподключение и часы
Мобильный интернет в школе рвётся постоянно, поэтому клиент:
- Переподключается со ступенчатой задержкой и случайным разбросом, чтобы 30 телефонов не стучались в одну миллисекунду, и восстанавливает место в игре по токену игрока.
- Синхронизирует часы с сервером по пингам. Берёт выборки с наименьшей задержкой и оценивает смещение, так что таймер вопроса на телефоне совпадает с серверным. После дедлайна сервер ждёт ещё 1,5 с на сетевые задержки.
- Ведёт контроль выхода из вкладки. Уход короче 3 секунд не считается: это случайное касание или уведомление. Остальные уходы сервер записывает с временем и длительностью, учитель видит их в отчёте.
Redis: только то, что можно потерять
Redis на RelaxDev общий для команды и работает с вытеснением ключей (allkeys-lru). Поэтому важного состояния в нём нет — комнаты игры живут в памяти процесса, результаты в PostgreSQL. Redis отвечает за три вещи:
- 1.Лимиты частоты.
MULTI→INCR+TTL; если у ключа ещё нет срока, ставитсяEXPIREна окно. Так работают лимиты на вход по паролю и коду из письма, генерацию нейросетью (на бесплатном тарифе 3 в минуту), импорт, загрузку картинок, чат поддержки и проверку по фото. - 2.Блокировки.
SET lock:… <токен> EX <ttl> NX, а снимает блокировку только тот, чей токен. Пример: одна генерация нейросетью за раз на пользователя. Иначе две вкладки параллельно обошли бы месячную квоту. - 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: создать тест бесплатно или взять готовый в библиотеке.
Читайте также

ХОМС РФ — агрегатор недвижимости от застройщиков: новостройки, дома, коттеджные посёлки и участки в 12…

ADelivo — сервис доставки для интернет-магазинов. Теперь он есть в Маркетплейсе RetailCRM: магазин ставит…
В октябре мы перевезли Bazari Ara — магазин грузинских продуктов, подарков и туристического снаряжения в…
Комментарии (0)
Ответить без регистрации