Архитектура платформы браузерных игр

Документ описывает крупные блоки разработки платформы по типу Яндекс Игр / Poki: что нужно построить, кто чем пользуется и как это связано.

Продуктовые ограничения платформы: на каталог допускаются только PvP-игры; поиск оппонентов и рейтинг ведёт платформенный матчмейкинг на основе Эло (игра не реализует свой матчмейкинг вместо платформенного).

0. Роли и поверхности

Платформа — это не одна админка. Есть три мира с разным UX и разными правами:

Роль	Поверхность	Задача
Игрок	Каталог + плеер + кошелёк + матчмейкинг	Найти PvP-игру, найти матч по Эло, играть, платить, ставить портальную валюту, выводить средства, оставлять отзывы
Разработчик	Консоль разработчика + SDK	Загрузить билд, настроить карточку, монетизацию, LiveOps
Модератор	Внутренняя панель модерации	Проверять билды, промо, акции; одобрять / отклонять
Администратор платформы	Внутренняя админка	Пользователи, каталог, фичеринг, финансы, безопасность, CSP, инциденты

Документация и консоль Яндекс Игр показывают только то, что видит разработчик. Всё, что делает модератор и админ (очереди, чек-листы, ручной фичеринг, разбор жалоб), — отдельная внутренняя реализация.

1. Каталог и сторона игрока

То, ради чего существует платформа. Без этого блока консоль и модерация бессмысленны.

1.1. Каталог и навигация

Главная, жанры, теги, поиск, подборки («Новые», «Популярные», «Скидки и акции»).
Карточка игры: иконка, обложки, описание, скриншоты, видео, возраст, платформы, рейтинг отзывов, рейтинг Эло игрока в этой игре (если авторизован).
В каталоге только PvP-проекты; соло / PvE без противостояния игроков не публикуются.
Гео-фильтрация: игра видна только в разрешённых странах и регионах.
Локализация карточки под язык игрока.
Ранжирование и рекомендации (по метрикам: сессии, удержание, доход, заполненность карточки) — см. органическое продвижение.

Как это выглядит у игрока: открыл сайт → увидел подборки PvP-игр → кликнул карточку → прочитал описание / отзывы → нажал «Играть» / «Найти матч».

1.2. Плеер (runtime запуска игры)

Хостинг статики игры (архив, загруженный разработчиком) или прокси к разрешённым хостам.
Iframe / изолированный контейнер с CSP.
Инъекция платформенного SDK в окружение игры.
Lifecycle: загрузка → инициализация SDK → Game Ready → поиск матча (Эло) → PvP-сессия → пауза при уходе со вкладки / рекламе.
Адаптация под desktop / mobile / tablet / TV.
Полноэкранный режим, ориентация, обработка focus/blur.

Как это выглядит у игрока: после «Играть» открывается страница игры, идёт загрузка, платформа подбирает оппонента(ов) по Эло, стартует PvP. Авторизация, сохранения, реклама и покупки — через SDK.

1.2.1. Матчмейкинг на основе Эло (платформенный сервис)

Обязательная функция платформы, единая для всех игр. Игра потребляет матчмейкинг через SDK, а не заменяет его своим.

Очередь поиска матча: 1v1 и/или команды (режим задаётся игрой в манифесте/черновике, подбор — платформой).
Рейтинг Эло на пару «игрок × игра» (отдельный рейтинг в каждой игре каталога).
Подбор по близости Эло с расширением окна поиска со временем ожидания.
Статусы: в очереди → матч найден → сессия создана → результат зафиксирован → пересчёт Эло.
Пересчёт Эло только по серверному подтверждению результата матча (антифрод: нельзя доверять клиенту игры вслепую).
Начальный рейтинг, K-фактор, защита от smurf/boosting — политики платформы.
UI ожидания матча может быть платформенным оверлеем и/или экраном внутри игры через SDK-колбэки.
Метрики матчмейкинга: время в очереди, доля отмен, разброс Эло в матче, abandon rate.

Админ: параметры Эло глобально и per-game overrides, мониторинг очередей, ручной сброс рейтинга при абьюзе.

1.3. Аккаунт игрока

Гость / авторизованный пользователь (для матчмейкинга и Эло нужна авторизация).
Профиль, аватар, прогресс на стороне платформы (Player в SDK).
Рейтинги Эло по играм, история матчей, win/loss.
Облачные сохранения, синхронизация между устройствами.
История покупок, ставок портальной валюты, выводов; избранное.
Для вывода денег — отдельный юридический статус (договор с платформой, реквизиты, KYC при необходимости).

1.4. Портальная валюта, ставки на игру и вывод средств

Собственный экономический контур игрока (не путать с инап-покупками разработчика внутри билда).

Портальная валюта

Единица баланса на платформе (начисление за активность, покупка за реальные деньги, награды, акции).
Кошелёк в профиле игрока: баланс, история операций, замороженные суммы.
Правила конвертации валюта ↔ деньги задаёт платформа (курс, комиссии, лимиты).

Ставка портальной валюты на игру

Игрок может поставить (застейкать / поставить) портальную валюту на конкретную игру со страницы карточки или из профиля.
Смысл для продукта: поддержка / «ставка» на игру (видимость поддержки, участие в экономике игры, влияние на продвижение — по правилам платформы).
Состояния ставки: активна → рассчитана / возвращена / проиграна (если есть модель исхода) либо удерживается как стейк с возможностью снять по правилам.
Лимиты: мин/макс ставки, частота, возраст, гео-ограничения, антифрод.
Разработчик в консоли видит агрегированно: сколько валюты поставлено на его игру (без персональных данных сверх политики).

Вывод денег игроком

Игрок может вывести доступный денежный остаток (после конвертации / заработка на платформе) на свои реквизиты.
Обязательное условие: заключённый договор с игроком (аналогично контуру выплат разработчику): оферта/договор, статус (физлицо / самозанятый / ИП и т.д. по юрисдикции), реквизиты, налоговый профиль.
Без подписанного договора и верификации вывод недоступен; баланс может копиться, но к выплате не уходит.
Заявки на вывод: статус (создана → проверка → выплата / отказ), холды, лимиты, комиссии.
Админ: очередь выплат игрокам, сверка, блокировки, разбор споров.

1.5. Социальные и retention-механики у игрока

Отзывы и оценки на карточке.
Промо-бейджи «Акция» на карточке, раздел скидок.
Запрос оценки / shortcut на рабочий стол (через SDK).
Отображение поддержки игры портальной валютой (если продукт это показывает публично).

1.6. Монетизация глазами игрока

Реклама: interstitial, rewarded, sticky — показ поверх / внутри игры.
Инап-покупки: каталог товаров в игре → платёжный UI платформы → выдача товара.
Портальная валюта: покупка / начисление → ставка на игру → (при наличии договора) вывод в деньги.
Прозрачность: что покупается, цена, условия ставки и вывода, возрастные ограничения.

2. Аккаунты разработчиков и доступ

Аналог аккаунта разработчика и командного доступа.

Регистрация разработчика / студии.
Профиль, контакты, язык общения с поддержкой.
Команда: роли (владелец, редактор, аналитик, финансы) и доступы к играм.
Юридический контур: договоры, реквизиты, статус (физлицо / ИП / юрлицо) для выплат.
Связка с рекламной / платёжной системой партнёра (аналог РСЯ).

Админская часть: верификация разработчиков, блокировка аккаунтов, аудит действий, поддержка споров.

3. Консоль разработчика (админка игры)

Личный кабинет, где разработчик управляет одной игрой. Ниже — вкладки, которые должны быть в продукте (по аналогии с консолью Яндекс Игр и LiveOps).

3.1. Панель управления

Сводка по игре: статус публикации, DAU/MAU, доход, алерты.
Быстрые ссылки: открыть игру, debug-режим, черновик.
Сигналы о падении метрик, ошибках, отклонениях модерации.

Бэкенд: агрегация метрик, alerting, статусная машина игры.

3.2. Черновик

Центральный блок публикации (заполнение черновика):

Загрузка архива (билда) HTML5-игры.
Обязательно PvP: режим(ы) противостояния игроков (1v1, команда и т.д.); одиночные игры без PvP отклоняются на модерации.
Параметры матчмейкинга для игры: размер команды, таймаут поиска, допустимый разброс Эло (в рамках лимитов платформы).
Метаданные: название, категория/жанр, теги, возрастной рейтинг.
Языки и локализованные описания.
Промоматериалы: иконки, обложки, скриншоты, видео.
Поддерживаемые платформы (ПК, телефон, планшет, ТВ).
Отсроченная публикация.
Комментарий для модерации.
Заполненность карточки (% готовности к фичерингу).
Действия: сохранить → отправить на модерацию → отозвать (в окне) → опубликовать (если «Проверен»).

Статусы черновика/игры (минимум): Черновик / Создан → Ожидает модерации → Проверен / Опубликовано / Отклонен → (обновление) снова в очередь.

Админ/модератор: видит тот же пакет данных + инструменты проверки (см. блок 5).

3.3. Инап-покупки

Каталог товаров: ID, цена, тип (consumable / non-consumable), локализации, картинки.
Включение покупок для игры (часто с отдельным согласованием).
Тестовые покупки без списания.
Статусы товаров и синхронизация с платёжным провайдером.

Связь с SDK: getPurchases / purchase / consume / проверка подписи на сервере платформы.

Админ: модерация ассортимента, антифрод, споры по платежам, каталог цен по регионам.

3.4. Метрики

Продуктовая, техническая и денежная аналитика (метрики):

Аудитория, сессии, время в игре, retention, вовлечение.
Матчмейкинг: среднее время в очереди, число матчей, abandon, распределение Эло.
Рейтинг качества / «зелёный» порог для продвижения.
Технические ошибки, время загрузки, Crash/JS errors.
Разрезы: платформа, страна, язык.

Инфра: event pipeline из плеера/SDK → хранилище → дашборды в консоли.

3.5. Метрики покупок

Выручка, ARPDAU/ARPU, конверсия в платящих.
Топ товаров, воронка покупки, возвраты.
Разрезы по странам и устройствам.

3.6. Продвижение

Органика: рекомендации, «Новые», готовность к фичерингу.
Платное продвижение (стартовые экраны / баннеры в каталоге) при выполнении порогов метрик.
Заявки на ручные подборки («Популярные»).
(Опционально) влияние объёма ставок портальной валюты на игру на видимость — только если это явно заложено в правила ранжирования.

Админ: слоты фичеринга, кампании, биллинг продвижения, ручной отбор в подборки.

3.7. Промоакции

Создание акции: игровое событие или скидка.
Креативы, даты, привязка к товарам/флагам.
Отправка на модерацию → появление в каталоге «Скидки и акции» и бейджа на карточке.
Выключение через флаги или новый билд.

Модератор: проверка акции на правила (понятность оффера, запрет обхода экономики платформы и т.д.).

3.8. Флаги (Remote Config)

Удалённая конфигурация без модерации билда (флаги):

Ключ–значение, дефолт + условные значения (язык, регион, платформа, custom params).
Версионирование и публикация конфига.
Выдача в игру через SDK getFlags().

Админ: лимиты, аудит опасных флагов, kill-switch на уровне платформы.

3.9. Отзывы

Лента отзывов по игре.
Ответы разработчика от имени студии.
Жалобы / скрытие (через модерацию платформы).

Админ/модератор: модерация UGC, токсичность, фейковые оценки.

3.10. Реклама

Подключение монетизации (внутренняя / внешняя схема).
Автосоздание рекламных блоков по форматам и устройствам.
До публикации — тестовые креативы; после — боевые.
Настройки частоты / форматов на стороне разработчика ограничены; основной контроль — платформа + вызов из SDK.

Админ: политики показа, блоклисты, revenue share, сверка с ad-network.

3.11. Страны и регионы

Whitelist/blacklist стран показа игры в каталоге и плеере.
Влияние на флаги, цены, рекламные сети, требования к контенту, доступность ставок и выводов.

3.12. CSP и настройки хостов

Политика Content Security Policy для песочницы игры.
Заявки разработчика на внешние хосты (CDN ассетов, API) с обоснованием.
Одобрение хостов администратором/безопасностью.
Блокировка произвольных внешних запросов по умолчанию.

4. SDK и интеграция игры

Обязательный слой между игрой и платформой (SDK).

4.1. Клиентский SDK (JS + плагины движков)

Инициализация, environment (язык, платформа, домен).
Loading / Game Ready.
Player: auth, данные, сохранения, Эло по текущей игре.
Matchmaking API: встать в очередь, отменить поиск, колбэк «матч найден», получить состав сторон и session id.
Match result API: сообщить исход на сервер платформы (или подтвердить серверный авторитетный результат) для пересчёта Эло.
Ads API.
Payments API (инапы).
Review, Shortcut, Server Time.
Remote Config (getFlags).
Debug-панель / индикатор лоадера для самопроверки.

Ставки портальной валюты и вывод денег — преимущественно UI/API профиля платформы (не обязательно внутри билда), но баланс и статусы договора могут быть доступны игре через SDK при необходимости.

4.2. Серверная часть SDK / Platform API

Выдача конфигов, токенов, подписей покупок.
Хранение player data.
Сервис матчмейкинга и Эло: очереди, подбор, создание сессии, пересчёт рейтинга, антифрод результатов.
Валидация платежей.
Кошелёк: баланс портальной валюты, ставки на игры, заявки на вывод.
События аналитики.

4.3. Требования к билду (продуктовые правила)

Отдельный продуктовый артефакт — требования к игре плюс правила этой платформы:

UI, звук, пауза, SDK, сохранения, соответствие описанию, запрещённый контент.
Только PvP: основной геймплей — противостояние игроков; чистый singleplayer / PvE без PvP не допускается.
Обязательная интеграция платформенного матчмейкинга на базе Эло; свой подбор «в обход» платформы запрещён.
Фиксация результата матча через платформенный API.

Это и чек-лист модерации, и документация для разработчика.

5. Модерация (внутренняя система)

Публично разработчик видит только статусы и замечания. Внутри нужен полноценный продукт.

5.1. Очереди

Полная модерация (новый билд / первая публикация).
Контентная (только промоматериалы, тексты).
Очереди промоакций, товаров IAP, заявок на CSP-хосты, фичеринга.
(Смежно с финансами) проверка договоров и заявок на вывод у игроков — отдельная очередь compliance/финансов, не контент-модерация билдов.
Приоритеты, SLA, назначение модераторам.

5.2. Рабочее место модератора

Просмотр черновика: метаданные, промо, архив.
Запуск игры в песочнице (те же устройства/браузеры, что в методиках).
Чек-лист по пунктам требований (PvP, интеграция матчмейкинга/Эло, UI, SDK и т.д.).
Проверка, что поиск матча идёт через платформу, а не через сторонний лобби-сервер в обход.
Запись экрана / скриншоты нарушений.
Вердикт: одобрить / отклонить с привязкой к пунктам правил.
Кулдауны повторной отправки, сброс кулдауна (редко, по политике).
Апелляции / перепроверка.

5.3. Автоматизация (ускорители)

Статический анализ архива (наличие SDK, манифест, размер, вирусы).
Проверка CSP / запрещённых доменов.
Автотесты smoke (старт, Game Ready).
Дубликаты игр, смена контента под тем же ID.
ML/эвристики на запрещённый контент — как помощь, не замена человека.

5.4. После вердикта

Публикация в CDN/каталог или статус «Проверен» при отложенном релизе.
Письма/уведомления разработчику.
История модераций по игре.

6. Администрирование платформы

То, чего нет в публичной консоли разработчика.

Управление каталогом: ручные подборки, баннеры главной, feature flags платформы.
Пользователи: игроки и разработчики, баны, GDPR/удаление данных.
Финансы: комиссии, выплаты разработчикам, выплаты игрокам, отчёты, холды, чарджбеки.
Договоры с игроками на вывод: шаблоны, статусы подписания, KYC, реквизиты, налоговый учёт.
Экономика портальной валюты: эмиссия, курс, лимиты ставок, антифрод ставок на игры.
Рекламная политика и интеграции с ad-сетями.
Безопасность: CSP whitelist глобально, abuse, DDoS, изоляция игр.
Контент-политика: возрастные рейтинги, региональные запреты.
Поддержка: тикеты, эскалация к модерации и финансам.
Наблюдаемость: uptime плеера, ошибки SDK, деградации CDN, очередь выводов.
Конфиг платформы: лимиты флагов, кулдауны модерации, пороги для платного продвижения, правила ставок и выводов, параметры Эло и матчмейкинга.

7. Публикация и жизненный цикл игры

Склейка консоли, модерации и каталога (быстрый старт + модерация).

Обновления: новый архив или только промо → снова модерация нужного типа → раскатка. Флаги — без полной модерации билда.

8. Как это работает со стороны игрока (сквозной сценарий)

Обнаружение. Игрок заходит на сайт/приложение платформы. Видит персональные и редакторские подборки, поиск, жанры. Новые игры неделю крутятся в «Новых», дальше трафик в основном от рекомендаций.
Карточка. Смотрит описание, скриншоты, рейтинг, отзывы, бейдж акции (если есть). Если страна не в списке дистрибуции — игры нет в выдаче.
Запуск. Жмёт «Играть». Плеер грузит билд из CDN в песочнице с CSP. Подключается SDK, определяется язык и устройство.
Матчмейкинг. Игрок встаёт в очередь; платформа подбирает оппонента(ов) по Эло; при нахождении матча стартует PvP-сессия.
Сессия. Игра вызывает Game Ready (до или в связке с поиском — по контракту SDK), идёт PvP, по окончании результат уходит на сервер платформы, Эло пересчитывается. Реклама и покупки — через SDK. При уходе со вкладки — пауза.
Портальная экономика. Может купить или получить портальную валюту, поставить её на понравившуюся игру, следить за балансом в кошельке.
Вывод. Чтобы вывести деньги, подписывает договор с платформой, указывает реквизиты, проходит проверки — только после этого создаёт заявку на выплату.
Социальное. Может оценить игру и написать отзыв.
Возврат. Рекомендации и retention-механики (события, акции, прогресс в облаке, рост Эло) возвращают игрока; разработчик это видит в метриках и крутит LiveOps.

Игрок не видит черновики, очереди модерации, CSP-заявки и флаги — только результат их работы в каталоге и в рантайме. Кошелёк, ставки и выводы — его собственный кабинет на платформе. Очередь матчмейкинга и Эло — платформенный слой вокруг любой PvP-игры.

9. Инфраструктурные блоки (под все поверхности)

Крупные технические системы, на которые садятся фичи выше:

Блок	Назначение
Хранение билдов / CDN	Загрузка архивов, версионирование, раздача плееру
Песочница + CSP proxy	Изоляция игр, контроль внешних хостов
Identity	Игроки, разработчики, сотрудники (RBAC)
Game catalog service	Карточки, поиск, подборки, гео, статусы
Moderation service	Очереди, вердикты, кулдауны, артефакты
SDK / Platform API	Ads, IAP, player, flags, time, matchmaking
Matchmaking / Elo	Очереди, подбор по Эло, сессии, пересчёт рейтинга, антифрод результатов
Payments	Инапы, чеки, рефанды
Player wallet	Портальная валюта, ставки на игры, конвертация
Player payouts	Договоры с игроками, KYC, заявки на вывод, выплаты
Ads mediation	Блоки, fill, тестовый/боевой режим
Analytics pipeline	События → метрики консоли и ранжирования
Remote config	Флаги, раскатки конфигов
Notifications	Почта/кабинет: модерация, алерты, выплаты игрокам и разработчикам
Admin backoffice	Фичеринг, финансы, безопасность, поддержка
Docs & portal	Публичная документация для разработчиков

10. Карта соответствия: вкладка консоли → системы

Вкладка у разработчика	Игрок видит	Модератор/админ делает
Панель управления	—	Алерты платформы, health игр
Черновик	Карточку и PvP-билд после публикации	Полная/контентная проверка; отказ non-PvP
Инап-покупки	Окна оплаты и товары в игре	Модерация товаров, антифрод
Метрики / метрики покупок	Косвенно (рекомендации); Эло в профиле	Сверка, антинакрутка, мониторинг очередей
Продвижение	Баннеры, место в выдаче	Слоты, ручной фичеринг
Промоакции	Бейдж и раздел акций	Модерация акций
Флаги	Изменённый геймплей/баланс	Аудит, kill-switch
Отзывы	Отзывы и ответы студии	Модерация UGC
Реклама	Рекламные блоки	Политики, mediation
Страны и регионы	Наличие игры в стране; доступность ставок/выводов	Санкции/комплаенс
CSP	Стабильный запуск без лишних запросов	Одобрение хостов
(кабинет игрока, не консоль) Кошелёк / ставки	Баланс, ставка на игру	Антифрод экономики
(платформа) Матчмейкинг Эло	Очередь, матч, рейтинг	Параметры Эло, антифрод, сбросы

11. Рекомендуемый порядок разработки (крупными этапами)

Не детальный план спринта, а порядок появления ценности:

Каркас платформы: identity, загрузка билда, плеер с песочницей, простой каталог, ручная публикация админом.
Консоль + черновик + модерация: статусы, очередь, чек-лист (PvP), публикация после approve.
SDK MVP: init, Game Ready, player, матчмейкинг + Эло + результат матча.
Каталог для игрока: карточки PvP-игр, поиск, базовые подборки, гео, отображение Эло.
Монетизация: реклама и/или IAP + финансы разработчиков.
LiveOps: метрики (в т.ч. очереди), отзывы, флаги, промоакции.
Экономика игрока: портальная валюта, ставки на игры, договоры и выводы.
Рост: платное продвижение, рекомендации.
Укрепление: CSP-процесс, антифрод (ставки, выводы, накрутка Эло), командный доступ, backoffice админа.

12. Что сознательно «за кадром» публичной документации

При проектировании закладывать отдельно (в Яндекс Играх это есть у платформы, но не описано как продукт для разработчика):

RBAC сотрудников, смены модераторов, качество модерации.
Хранение доказательств нарушений (видео, логи).
Юридический и налоговый контур выплат разработчикам и игрокам.
Договоры с игроками на вывод, KYC, возрастные и региональные ограничения азартно-подобных механик (если ставки квалифицируются как таковые в юрисдикции).
Антифрод трафика, платежей, ставок портальной валюты, выводов и накрутки Эло / фиктивных матчей.
ML ранжирования и холодный старт новых игр; бутстрап Эло для новых игроков.
Abuse от игроков и DMCA/жалобы на контент.
Мультирегиональный CDN и локализация самой платформы.

Документ предназначен для декомпозиции продукта и планирования команд. Следующий шаг — выбрать MVP-срез (блоки 1–2–3.2–4–5) и детализировать сущности/API.