Мережа студій та провайдерів

1) Ролі і топології мережі

Студії - створюють ігри (клієнт, математика, арт, звуки), ведуть лайв-студії або стрімінг.
RGS (Remote Game Server) - хостить математику/раунди/пули джекпотів, експонує API.
Агрегатори/хаби - єдина інтеграція до десятків RGS/студій, каталог, білінг, промоінструменти.
Оператори/бренди - вітрина, платежі, KYC/AML, відповідальні ігри, саппорт.
Сертифікаційні лабораторії - випробування RNG/математики, відповідність ринкам.

1. Студія → RGS → Оператор (прямі інтеграції).

2. Студія → RGS → Агрегатор → Оператор (масштаб і єдиний контракт).

3. Лайв-студія → Медіа-потік → Оператор (низька латентність, багато камер).

4. White-label RGS (ядро агрегатора + скіни студій).

2) Життєвий цикл гри і артефакти

1. Дизайн/математика → симуляції, волатильність, RTP-профілі.
2. Імплементація → клієнт (WebGL/Canvas), сервер (раунди, RNG), протокол.
3. QA/сертифікація → протоколи раундів, RNG-тести, юрисдикції, відповідальні ігри.
4. Каталогізація → метадані (жанр, лінії, фічі, волатильність, мови, пристрої).
5. Реліз/дистрибуція → rollout-по регіонах, A/B, ліміти.
6. Експлуатація → телеметрія, розрахунки, баланс джекпотів, контент-ротації.
7. Зняття/апдейти → депрекейт, міграція RTP-варіанту, правки комплаєнсу.

yaml game_id: "studioX:fire-temple"
version: "1.3.2"
rgs: "rgs-alpha"
genres: ["slot","bonus-buy"]
volatility: "high"
rtp_profiles:
- { market: "EU", value: 96.2 }
- { market: "DE", value: 94.0 }
localization: { languages: ["en","de","tr","es"], currencies: ["EUR","USD","TRY"] }
jurisdictions: ["MGA","UKGC","RO","ES"]
devices: ["mobile","desktop"]
promos: ["freespins","tournaments","missions"]
media: { poster: "cdn://.../poster.webp", sprites: "cdn://.../assets.bin" }

3) Контракти даних і каталоги

3. 1 Каталог провайдера (мінімум полів)

yaml catalog.item.v1:
game_id: string title: string studio: string rgs: string tags: [string]     # "jackpot","crash","megaways","hold&win"
volatility: low    med    high    extreme rtp_profiles: [{market:string, value:float}]
jurisdictions: [string]
devices: [string]
release_date: date deprecates: [game_id]

3. 2 Події раундів і розрахунки

json
{
"event_id": "uuid",
"type": "round.settled.v1",
"occurred_at_utc": "2025-10-31T12:01:02Z",
"operator_id": "op-42",
"brand_id": "brand-1",
"rgs": "rgs-alpha",
"game_id": "studioX:fire-temple",
"round_id": "r-789",
"user_pseudo_id": "u-...",
"bet": 1.00,
"win": 0.00,
"currency": "EUR",
"jackpot": {"contrib": 0.01, "payout": 0.00},
"signature": "ed25519:..."
}

3. 3 Wallet/Session API (ідеї полів)

`authorizeBet(round_id, amount)` / `commitRound(round_id, delta)` / `rollbackRound(round_id)`

'createSession (user_id, game_id, region, currency)'→ токен, ліміти, RTP-профіль.
Ідемпотентність: `Idempotency-Key = round_id + step`.

4) Інтеграційні патерни

iFrame/Remote UI - швидкий go-live, RGS управляє клієнтом; увага до sandbox/політиків.
Native Embed/SDK - глибше контроль UX, офлайн-кеш, більш сувора сумісність.
Wallet API - атомарні дебет/кредит, захист від подвійної проводки, сейф-стан.
Session API - фічі RG (ліміти, reality check), гео/вікові гейти, деактивація.
Eventing/Webhooks — `round. started/settled', промо-події, джекпоти, турніри.
Promotions API - місії, змагальні таблиці, фріспіни, бонус-баї (ліміти та комплаєнс).
Live Casino/Streaming - WebRTC/HLS/DASH, синхронізація ставок, мультикамерні розкладки.

python def commit_round(req):
if seen(req.round_id): return 200 # идемпотентно lock(req.user_id)
try:
wallet.apply(req.delta) # атомарно mark_seen(req.round_id)
finally: unlock(req.user_id)

5) Промоінструменти та метагейм

Джекпоти: локальні/мережеві, фікс/прогресив, рівні (міні/міді/мега), ізоляція пулів по ринках.
Турніри/місії: події гри → очки → таблиці лідерів, анти-аб'юз, призові фонди.
Фриспіни/бонус-коди: бюджет, термін, прив'язка до гри/студії, атрибуція.
Feature flags: включення «bonus-buy», авторотація RTP-профілю по ринку.

yaml promo.id: "tournament-2025w44"
games: ["studioX:","studioY:volcano-"]
budget: "€50k"
prizes: [{rank:1, amount:"€10k"}, {rank:2, amount:"€5k"}]
fairness: { anti_bot: true, per_user_cap: 1000 }
jurisdictions: ["EU","TR"]

6) Комплаєнс, RTP і сертифікація

RNG/математика: незалежна верифікація, випробувальні протоколи, контроль seed/entropy.
RTP-варіанти по ринках: фіксуйте профілі та їх вікна застосування, обов'язкові звіти за вибіркою.
Відповідальна гра: ліміти депозиту/ставки/часу, reality check, самовиключення, вікові гейти.
Юрисдикції/ліцензії: гео-пінінг асетів/серверів, дозволені механіки (наприклад, заборона на «autoplay» в частині країн).
Звітність: таблиці раундів, аномалії (дисперсія vs очікувана), аудит логів.

rego package rtp.policy deny["RTP profile mismatch"] {
input.market == "DE"
input.game.rtp_profile.value > 94.0
}

7) Спостережуваність і SLO контенту

SLI: `game_start_success`, `round_settle_success`, `p95 game_load`, `client_error_rate`, `round_latency`.
SLO: per-гра, per-провайдер, per-ринок; окремі вікна для лайв-ігор (суворіше за латентністю).
Телеметрія: наскрізні «trace _ id», логи раундів (без ПД), метрики потоків (бітрейт, буферизації).
«Повільний успіх» - окрема метрика: довгі завантаження → падіння ARPU.
Дешборди каталогу: утилізація по тайтлам, share-of-wallet, «втома» гравців, сезонність.

yaml gate: content-release checks:
- p95_game_load < 2500ms
- round_settle_success >= 99.95% (24h)
- client_error_rate < 0.5%
on_fail: block

8) Розрахунки та reconciliation

Модель розрахунків: Gross vs Net, податки, платформні збори, джекпот-фонди.
Атрибуція виручки: per-раунд, per-гра, per-студія, per-ринок.
Реєстри: незмінні логи'round. settled', підписи, хеші батчів (WORM/immutability).
Звірки: двосторонні звіти провайдера і оператора, дедуп по'round _ id', ε -допуск.
Chargeback/коригування: вікна і причини (фрод, збої мережі, скасовані раунди).

sql
SELECT a.round_id
FROM provider_rounds a
LEFT JOIN operator_rounds b ON a.round_id = b.round_id
WHERE a.ts BETWEEN:from AND:to AND b.round_id IS NULL;

9) Продуктивність доставки

CDN для асетів: версіяція, prefetch, упаковка спрайтів, компресія, WebP/AVIF.
Мобільний рендеринг: адаптивні текстури/шейдери, FPS-гарантії.
Краш-тайтли/лайв-ігри: WebSocket/WebRTC, пріоритет трафіку, edge-вузли, jitter-буфери.
Failover: альтернативні CDN/медіа, деградація з честю (низька якість → пауза турніру).

10) Безпека і чесність

Підпис артефактів і маніфестів (supply-chain, SLSA/SBOM), контроль цілісності клієнта.
Анти-тампер: обфускація клієнта, перевірка середовища (root/jailbreak, емулятори).
Анти-бот і колюзія: device/поведінкові сигнатури, ліміти на підозрілі патерни.
Секрети: KMS, короткоживучі токени з вузьким скоупом, захист джекпот-ключів.
Приватність: псевдонімізація'user _ pseudo _ id', заборона ПД в раунд-логах, TTL.

11) Управління портфелем: вітрини та рекомендації

Ротації/піни: свіжі релізи, локальний смак, сезонні теми.
Рекомендатори: гібрид (топові × персональні), охорона холодного старту студій.
A/B-тести: позиція тайл-сету, розмір постеру, «рівень шуму» банерів.
Якість контенту: рейтинг з утримання, «довгого хвоста» і скарг.

python score = 0.4retention_w4 + 0.3net_rev_per_1000 + 0.2quality_reviews - 0.1error_rate

12) Плейбуки та навчання

12. 1 «Зрив провайдера»

1. Авто-зняття трафіку на проблемні тайтли →

2. Повідомлення у вітрину/підтримку →

3. Включення альтернатив/клонів →

4. Пост-інцидент: кредит по SLA, оновлення версій.

12. 2 «Зміна RTP-профілю»

1. Застосувати прапор по ринку →

2. Анонс та вікно міграції →

3. Контроль звітності та скарг →

4. Оновити паспорти ігор.

12. 3 «Розбіжність раундів»

1. Freeze settlements для діапазону →

2. Re-drive з outbox провайдера →

3. Дифф/патч, загальний акт, розморожування.

13) Метрики зрілості мережі

Coverage: частка ринків/жанрів з ≥X активними тайтлами.
Freshness: медіана днів з релізу в топ-N лістингах.
Reliability: SLO pass-rate провайдерів (місяць/квартал).
Fair-share: дисперсія обороту по студіях при рівній якості.
Promo-lift: ∆ARPU/retention з промо-кампаній.
Recon-health: швидкість закриття розбіжностей, залишок ε.

14) Анти-патерни

«Єдиний RTP/одна математика для всіх ринків» → регуляторні ризики.
Логи раундів з ПД → порушення приватності.
Синхронні «довгі» виклики RGS по гарячому шляху → каскад таймаутів.
Відсутність ідемпотентності - подвійні списання.
Немає WORM-реєстру раундів - суперечки і блокування виплат.
Жорсткий вендор-локін агрегатора - відсутність exit-плану і second-source.
«Гігантський реліз-пак» без канарок і rollback.

15) Чек-лист архітектора

1. Для кожної гри є паспорт (версія, RTP-профілі, юрисдикції, пристрої)?
2. Каталог і події стандартизовані, версії і вікна сумісності закріплені?
3. Wallet/Session/API ідемпотентні; є rollback раундів і сейф-стан?
4. Промоінструменти (джекпоти/турніри/фріспіни) інтегровані і лімітовані?
5. SLI/SLO per-провайдер/гра/ринок налаштовані; зовнішня синтетика є?
6. Розрахунки: round-by-round, WORM-лог, підписи, reconciliation з ε -допуском?
7. Безпека: підпис артефактів, анти-тампер, анти-бот, KMS/ротація ключів?
8. Комплаєнс: RTP-варіанти, заборони механік, RG-фічі, geo-pinning активів?
9. Продуктивність: CDN/edge, WebSocket/WebRTC, fallback потоку?
10. Плейбуки: зрив провайдера, зміна RTP, розбіжність раундів - перевірені і відрепетирувані?
11. Exit-план: альтернативні агрегатори/RGS, міграція каталогу, «сухий вихід»?

Висновок

Мережа студій і провайдерів - це сукупність протоколів, каталогів і зобов'язань, а не просто список інтеграцій. Коли є стандарти подій і API, паспорт кожної гри, прозорі розрахунки, SLO/комплаєнс, сильна доставка і безпека, контент масштабується передбачувано: релізи виходять швидко, гравці отримують стабільну якість, а екосистема - стійке зростання без регуляторних і операційних сюрпризів.