Турнирлер мен миссиялар модулі: оқиғалар, рейтингтер, наградалар

1) Бизнес-мақсаттар және белсенділік түрлері

Мақсаттары: ұстап қалудың өсуі (D1/D7), ARPPU, сессиялардың тереңдігін ұлғайту, жаңа ойындар мен нарықтарды ілгерілету.

Пішімдер:

Турнирлер: ұпай/ұтыс/мультипликаторлар сомасы бойынша, спринттер (30-60 мин), күндізгі, маусымдық.
Миссиялар/квесттер: кезеңдер бойынша ілгерілеушілікпен және наградалармен тапсырмалардың дәйектілігі (N спинді ойна, X ұтып ал, Y провайдерін сынап көр).
Көшбасшы борттар: жаһандық, нарықтар/ойындар/мөлшерлемелер бойынша, жеке (достар/VIP).
Студиялардың джекпоттары/рейтингтері: «аптаның үздік провайдерлері», «көбейткішке аңшылық жасау».

KPI: белсенді аудиторияның 12-25% ≥ қатысуы, промо кірісінің үлесі 10-20%, шағымдар <0. Қатысушылардың 5% -ы жүлде қоры жоспарды ≤.

2) Сәулет және деректер ағындары

Компоненттер

1. Events Gateway → game-gateway/провайдерлерден ойын оқиғаларын (spin, bet, win, round_end) қабылдау.

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. 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/рейтингтік жүйе: PvP/достық бәсекелестік кестелеріне ұқсас ELO.

Тай-брейктер

1. 'highest _ single _ multiplier' → 2) 'fewest _ rounds' → 3) 'earliest _ finish _ ts' → 4) 'user _ id' лексикографиялық (ережелерде тіркелген).

Өнімділік

Redis Sorted Set 'ZADD key score member' ішінде top-K (мысалы, 10k) сақтаңыз.

«Ең жақсы N раундтар» үшін: пайдаланушы мен сомаға ең жақсы N min-heap сақтаңыз, «ұшуда» жаңартыңыз.

Мерзімдік snapshot (әрбір 30-60 с) OLTP/объектілік.

6) Наградалар мен төлемдер

Марапаттардың түрлері: cash/bonus/free spins/points/заттар/билеттер.

Ережелер:

Тек аяқтағаннан кейін ғана беру (шағымдану терезесі 5-10 минут).
Барлық төлемдер - Rewards Service → Wallet (ledger) арқылы: double-entry, 'reward _ id' бойынша теңсіздік.
Миссиялардың аралық кезеңдері үшін - «жұмсақ» наградалар (FS/points), cash - тізбек аяқталғаннан кейін беріледі.
ҚҰС/жауапты ойын: аккаунтты бұғаттау кезінде - жүлделерді тексеру алдында ұстау/мұздату.

Бөлу схемалары:

Fixed ladder: алдын ала берілген сатылар (1-орын 30%, 2-орын 20%,...).
Proportional: көзілдірік бойынша пулдан үлес, бірақ бір орыннан бір орынға.
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» (қызған кезде аралық бонустарды төмендету).

Икемділік: маржаны ұстап қалу үшін cash орнына наградалардың points/FS-ке ығысуы.

Өтелімділік коэффициенттері: жүлде қоры/турнирлік ойындар сегментінен түсімдер; таргет 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.
Тай-брейктер ережелерде белгіленген, сұрыптаудың детерминизмі.
Көшбасшы борттар: Redis топ-K + снапшоттар; дауылға қарсы (jitter, coalescing).
Anti-abuse: eligibility, боттар/ASN, velocity-лимиттер.
Double-entry арқылы Rewards → Wallet; cash алдында KYC-чек.
Бақылау қабілеті: SLI/SLO, дашбордтар, алерталар; WORM-аудит.
DR/Failover: multi-AZ, бэкаптар/restore, «freeze & finalize» сценарийі.
Оқшаулау, лицензиялар, жария ережелер және consent.
Runbook 'және lag/грант қателері/боттар, коммуникация үлгілері.

Түйіндеме

Турнирлер мен миссиялардың табысты модулі - бұл оқиғалық шина + детерминирленген ережелер + жылдам көшбасшы борттар + қауіпсіз төлемдер. Қатаң тай-брейктерді, анти-абьюзды, экономика симуляторын және SLO бақылауын қосыңыз, барлық операцияларды демпотентті және аудитті ұстаңыз - және сіз ойыншылармен, реттеушілермен және қолдау командасымен дауласпай тартымды және табысты өсіретін құралды аласыз.