Модуль турниров и миссий: события, рейтинги, награды

1) Бизнес-цели и типы активностей

Цели: рост удержания (D1/D7), ARPPU, увеличение глубины сессий, продвижение новых игр и рынков.

Форматы:

Турниры: по сумме очков/выигрышей/мультипликаторам, спринты (30–60 мин), дневные, сезонные.
Миссии/квесты: последовательности задач (сыграй N спинов, выиграй X, попробуй Y провайдера), с прогрессом и наградами по этапам.
Лидерборды: глобальные, по рынкам/играм/ставкам, приватные (друзья/VIP).
Джекпоты/рейтинги студий: «топ провайдеров недели», «охота за множителем».

KPI: участие ≥ 12–25% активной аудитории, доля дохода из промо 10–20%, жалобы < 0.5% участников, выданный призовой фонд ≤ план.

2) Архитектура и потоки данных

Компоненты

1. Events Gateway → прием игровых событий (spin, bet, win, round_end) из game-gateway/провайдеров.

2. Rules Engine → матчит события на правила турниров/миссий, начисляет очки (idempotent).

3. Leaderboard Service → агрегирует очки, хранит топы/срезы, поддерживает сортировку и тай-брейки.

4. Progress Service (миссии) → состояние задач/этапов, выдача промежуточных наград.

5. Rewards Service → расчёт и безопасная выплата (через кошелёк: cash/bonus/fs/points).

6. Admin/Studio UI → создание, планирование, превью экономики, симуляции.

7. Realtime/WS → публикация обновлений лидерборда, прогресса, уведомлений.

8. Anti-Abuse → лимиты, сигналы риска, интеграция с антифродом/бот-менеджером.

9. Storage/Cache → KV/Redis для горячих топов, OLTP для фактов, DWH для аналитики.

Поток (e2e)

`game_event → gateway → rules_match → points → leaderboard_update → (progress_update) → notify → rewards_at_close → wallet_postings`

3) Событийная модель (минимум полей)

json
{
"event_id": "e_9f2",  "ts": "2025-10-23T17:41:26Z",  "user_id": "u_123",  "market": "DE",  "brand": "X",  "game": {"id":"g_77", "provider":"PragmaticPlay", "type":"slot"},  "bet": {"amount_minor": 100, "currency":"EUR"},  "win": {"amount_minor": 250, "multiplier":2.5},  "round": {"id":"r_abc","status":"ended"},  "device": {"platform":"mobile","asn":"mno"},  "trace_id": "t_…"
}

Транспорт — Kafka/HTTP, idempotent обработка (dedupe по `event_id`), подпись провайдера/игрового шлюза (HMAC).

4) Правила турниров и конструктор задач

Декларативная схема (пример YAML):

yaml id: t_october_sprint window: {start: 2025-10-25T18:00Z, end: 2025-10-25T19:00Z, tz: Europe/Kyiv}
scope:
markets: [DE, SE]
providers: [PragmaticPlay, Hacksaw]
scoring:
formula: "points = min(win.amount/bet.amount, 50) 100" # по множителю min_bet_minor: 50 eligible_games: ["g_"]
leaderboard:
type: "best_n_rounds"  # суммируем лучшие N раундов n: 20 tiebreaker: ["highest_single_multiplier","earliest_finish_ts"]
rewards:
pool: {currency: EUR, total_minor: 1000000}
distribution: "ladder" # лестница, топ-100 anti_abuse:
min_round_duration_ms: 800 max_rps_per_user: 0.5 exclude_asn_categories: ["hosting", "proxy"]

Миссии (DSL):

yaml mission_id: m_halloween steps:
- id: s1 goal: {type: "spin_count", game_type: "slot", count: 50}
reward: {type: "freespins", value: 10, game: "g_66"}
- id: s2 goal: {type: "win_multiplier", min: 10}
reward: {type:"bonus", amount_minor: 500}
completion_reward: {type: "points", amount: 1000}

5) Рейтинги и алгоритмы подсчёта

Основные модели

Сумма очков: линейная/логарифмическая/с капом за раунд.

Лучшие N раундов: снижает «pay-to-grind», удерживает «спринтовую» динамику.

Максимальный множитель (xWin): нормирует валюты и ставки.

MMR/рейтинговая система: ELO-подобная для PvP/таблиц дружеской конкуренции.

Тай-брейки

1. `highest_single_multiplier` → 2) `fewest_rounds` → 3) `earliest_finish_ts` → 4) `user_id` лексикографически (фиксировано в правилах).

Производительность

Храните топ-K (например, 10k) в Redis Sorted Set `ZADD key score member`.

Для «лучшие N раундов»: храните min-heap последних лучших N на пользователя и сумму, обновляйте «на лету».

Периодически snapshot (каждые 30–60 с) в OLTP/объектное.

6) Награды и выплаты

Типы наград: cash/bonus/free spins/points/предметы/билеты.

Правила:

Выдача только после финализации (окно обжалований 5–10 мин).
Все выплаты — через Rewards Service → Wallet (ledger): double-entry, идемпотентность по `reward_id`.
Для промежуточных этапов миссий — выдача «мягких» наград (FS/points), cash — по завершении цепочки.
KYC/ответственная игра: при блокировке аккаунта — удержание/заморозка приза до проверки.

Схемы распределения:

Fixed ladder: заранее заданные ступени (1-е место 30%, 2-е 20%, …).
Proportional: доля от пула по очкам, но с cap на место.
Ticket-based: миссии дают «билеты», розыгрыш по билетам (прозрачный RNG).

7) Анти-абьюз, честность и комплаенс

Фильтры eligibility: min ставка/длительность раунда, исключение «0-bet», повторных ре-трещей, «микро-ставок» в конвейере.

Бот-сигналы: headless-UA, аномальная периодичность, аномально стабильный RPS, прокси-ASN → скрытые челленджи/заморозка очков.

Дедуп/идемпотентность: события по `event_id`, начисления по `score_id`.

Audit trail: снимки лидерборда, seed RNG (для ticket-розыгрыша), версия правил, хэш расчётов.

Юридическое: правила/ограничения по рынкам, возраст, самоисключение.

8) Экономика турниров

Budget guardrails: верхняя граница пула + динамический «safety valve» (снижение промежуточных бонусов при перегреве).

Эластичность: смещение наград в points/FS вместо cash для удержания маржи.

Коэффициенты окупаемости: призовой фонд / поступления из сегмента турнирных игр; таргет 8–15%.

Симулятор в админке: прогон исторических событий → прогноз выплат/участия.

9) API-контракты (упрощённо)

Получить активные турниры/миссии

http
GET /v1/contests?market=DE&brand=X
→ 200 [{"id":"t_october_sprint","start":"…","end":"…","type":"xwin","status":"live"}]

Событие игры (ingest)

http
POST /v1/events
{"event_id":"e_9f2", "...": "..."}
→ 202 {"accepted":true}

Лидерборд (топ-K и позиция пользователя)

http
GET /v1/leaderboards/t_october_sprint?top=100&me=u_123
→ 200 {"top":[{"pos":1,"user":"u_9","score":18400},...],    "me":{"pos":342,"score":5600,"delta":+200}}

Прогресс миссии и награда

http
GET /v1/missions/m_halloween/progress?user=u_123
→ 200 {"steps":[{"id":"s1","done":true},{"id":"s2","done":false}],"reward_ready":true}

POST /v1/rewards/claim
{"context":"mission","id":"m_halloween","step":"s1"}
→ 201 {"status":"granted","reward_id":"rw_77"}

10) Хранилища и масштабирование

Горячий путь: Redis (Sorted Sets/Hash) для топов и прогресса; TTL на «шумные» ключи, шардирование по `contest_id`.

Истина: OLTP (Postgres/MySQL) — факты очков/прогресса/выплат (WORM-снимки).

Очереди: Kafka — поток событий; Consumer-группы по регионам/брендам.

Кэши: короткий TTL 1–5 с; stale-while-revalidate для публичных топов (через CDN).

WebSocket: отдельный кластер/пул под realtime, батч-рассылка и rate-limit сообщений.

11) Наблюдаемость и контроль качества

SLI/SLO:

`leaderboard_update_latency_p95 ≤ 250мс`
`events_ingest_success ≥ 99.9%`
`rewards_grant_success ≥ 99.9%`
`ws_push_rtt_p95 ≤ 120мс`
жалобы на несправедливость < 0.5% участников.

Метрики:

rate событий/участников, уникальные игроки, распределение по ставке/играм, средний множитель; `grant_errors`, `dedupe_hits`.
Трейсы: ingest → rules → score → LB update → reward; теги `contest_id`, `rule_id`.
Логи: JSON с `trace_id`, запрет PII; WORM для аудита.

12) Инциденты и runbook’и (сокращённо)

A. Отставание лидерборда (lag > 2с)

Действия: увеличить потребителей Kafka, снизить партиционный «горячий ключ» (repartition), включить batching update.

Временное: заморозить realtime-анимации, показывать «~1–2с задержка».

B. Ошибки выдачи наград

Действия: остановить новые `grant`, свериться со снапшотом, переиграть `grant` идемпотентно; статус-апдейт в лобби.

C. Всплеск абьюза (proxy ASN)

Действия: усилить eligibility, включить невидимый челлендж, временно не учитывать очки сомнительным сессиям, пост-верификация.

13) UX и локализация

Реальное время: индикатор «live», плавные дельты очков, позиция и расстояние до следующего места.

Прозрачные правила: доступ к формуле/тай-брейкам/ограничениям.

Нотификации: «осталось 5 минут», «ты в топ-50», «доступна награда».

Локализация/правовые тексты: по рынкам, часовые пояса (Europe/Kyiv и локали участников).

14) Безопасность и приватность

Псевдонимы игроков на публичных топах; скрытие PII по умолчанию.

Подписи вебхуков/событий, mTLS; защита от «кэш-пойзона» на edge.

Rate-limit API, защита от кэш-бастинга, контроль `idempotency_key`.

GDPR: сроки хранения событий, право на удаление (анонимизация) без порчи аудита.

15) Тестирование и симуляции

Реплей исторических событий для валидации правил и экономики.

Нагрузочные: bursts 30–120 с перед стартом; soak 2–4 ч.

Property-based: инварианты («сумма выданных наград ≤ бюджет», «тай-брейк детерминирован»).

A/B: разные формулы очков, глубина лестницы, формат миссий.

16) Чек-лист продакшн-готовности

Декларативные правила (версии, подписи), симулятор экономики.
Идемпотентность: `event_id`, `score_id`, `reward_id`; Inbox/Outbox.
Тай-брейки фиксированы в правилах, детерминизм сортировки.
Лидерборды: топ-K в Redis + снапшоты; анти-шторм (jitter, coalescing).
Anti-abuse: eligibility, боты/ASN, velocity-лимиты.
Rewards → Wallet через double-entry; KYC-чек перед cash.
Наблюдаемость: SLI/SLO, дашборды, алерты; WORM-аудит.
DR/Failover: multi-AZ, бэкапы/restore, «freeze & finalize» сценарий.
Локализация, лицензии, публичные правила и consent.
Runbook’и на lag/ошибки grant/всплеск ботов, шаблоны коммуникаций.

Резюме

Успешный модуль турниров и миссий — это событийная шина + детерминированные правила + быстрые лидерборды + безопасные выплаты. Добавьте строгие тай-брейки, анти-абьюз, симулятор экономики и наблюдаемость SLO, держите все операции идемпотентными и аудируемыми — и вы получите инструмент, который растит вовлечённость и выручку без споров с игроками, регуляторами и командой поддержки.