RGS/bridge vasitəsilə canlı oyunların və şou formatlarının inteqrasiyası

Məqalənin tam mətni

💡 18+. Operator, studiya və aqreqator komandaları üçün texniki material. Oyuna çağırış deyil. Terminlər: platforma - PAM/cüzdan/kassa/bonuslar/RG; RGS - Remote Game Server (studiya oyunlarının nüvəsi); bridge - provayderin canlı nüvəsi ilə platforma/aqreqator arasındakı inteqrasiya təbəqəsi.

1) Live və platforma arasında niyə körpü lazımdır

Canlı oyunlar (rulet, blackjack, bakara) və şou formatları (Crazy-/Wheel-/Dice-/Game Show) video ekrandan + real nəticədən istifadə edir. RNG slotlarından fərqli olaraq:

Nəticə bahis pəncərəsi və fiziki hadisə (spin, kart açılması) bağlandıqdan sonra gəlir.
Ciddi vaxt çərçivəsi (cut-off) və sinxron bahislər tələb olunur.
Ödənişlərin hesablanması slotun ana nüvəsinə görə deyil, canlı oyun cədvəllərinə görə aparılır.
Cüzdan, bonuslar, turnirlər, cekpotlar, RG/AML, həmçinin telemetry/hesabat razılaşdırılmalıdır.

Bridge - canlı mexanikanı platforma müqaviləsinə «köçürən» S2S-şlyuzdur: seans tokenləri, avtorizasiya və limitlər, bahis qəbulu, pəncərə fiksasiyası, quraşdırma, kompensasiya, hadisələr və daşbordlar.

2) İnteqrasiyanın əsas arxitekturası


Player Client (Web/Mobile + HLS/WebRTC)
│

Live Provider Front (video, UI) —— Live Engine (round control, GCU)
│                │
│ (S2S)            │ emits outcomes

Bridge (RGS/bridge): auth, bet capture, lock, settle, rollback, jackpots/promos
│

Platform: PAM / Wallet(Ledger) / Cashier / Bonus / RG / Risk / BI
│

Aggregator (optional)

Rollar:

Live Engine: raund, zamanlayıcı, nəticələr (dealer/GCU) idarə edir.
Bridge: platforma üçün yeganə inteqrasiya konturu. Pul və hadisələri sinxronlaşdırır.
Platforma: balans, bonuslar, RG/AML, hesabatlar üzrə həqiqət mənbəyi.

3) Axınlar və vaxtlar: tarifdən ödənişə qədər

3. 1 Raundun həyat dövrü (sadələşdirilmiş)

1. session. create - marka/geo/yaş yoxlaması, session_token verilməsi.

2. bet. place - dərəcələrin qəbulu pəncərəsində; RG limitlərinin, bonus qaydalarının yoxlanılması, idempotentlik ('Idempotency-Key').

3. bet. lock - pəncərənin bağlanması (cut-off). Bütün qeydiyyatsız müraciətlər rədd edilir.

4. live. outcome - Live Engine-dən nəticə (roulette: nömrə; show: sektor/çarpan/bonus tur).

5. bet. settle - atom settlement: debet dərəcəsi təsdiq, kredit uduşlar (cüzdan vasitəsilə).

6. bonus/jackpot/tournament - depozit/tetikleyicilər.

7. rollback/compensation - kanal uğursuz olduqda, ancaq tur qaydalarına əsasən.

3. 2 Pəncərələr və gecikmələr

Hədəf latency (glass-to-glass): HLS 2-5 c seqment; WebRTC 200-500 ms.

SLO bridge:

p95 `bet. place`/`bet. lock '<150 ms (oyunçu şəbəkəsi olmadan), p95' settle '<300 ms sonra' live. outcome ', «itirilmiş/dublyaj edilmiş settlementlər» = 0.

4) API bridge platforma müqavilələri (nümunə)

4. 1 bridge → platforma sorğuları

'POST/wallet/debit' - dərəcənin avtorizasiyası (idempotent, cavab - hold_id).

'POST/wallet/commit' - lock-da silinmənin təsdiqidir.

'POST/wallet/credit' - qalib kredit.

'POST/rg/check' - depozit/itki/vaxt limitləri, özünü istisna.

'POST/bonus/apply' - oyun növünə görə əmanət (e. g., live 10–25%).

`POST /jackpot/contribute	trigger '- faiz payı/uduşlar.
'POST/analytics/event' - telemetriya (round, table, latency, error).

4. 2 Kolbeki platforma → bridge

`wallet. debit. authorized	rejected`
`wallet. commit. ok	failed`
`wallet. credit. ok	failed`
`rg. blocked` / `rg. limit. hit`
`bonus. state. updated`
`compensation. required '(raund protokolu ilə)

İdempotentlik: 'round _ id', 'bet _ id', 'settle _ id' açarları; cüzdan və körpü tərəfində dedup.

5) Hadisə modeli (Kafka/Pulsar)

Əsas topiklər

`live. session. started	ended`
`live. bet. placed	locked
`live. round. outcome`
`live. bet. settled`
`wallet. debit. requested	committed
`bonus. contributed	awarded`, `jackpot. contribution
`rg. limit. hit`, `rg. reality_check`
`risk. alert. raised`

Müqavilələr: Avro/JSON Schema + Registry, semantik versiyalar, partizan 'tenant _ id', 'table _ id', 'player _ id'.

6) Pul invariantları və dastanlar

Balans həqiqəti - Ledger platforması; bridge bahis/tur vəziyyətlərini saxlayır.

Bütün pul əməliyyatları idempotentdir, 'Idempotency-Key' ilə.

Сага «authorize → lock/commit → settle → credit»:

saxta 'commit' - avtorizasiyanın ləğvi/hold geri qaytarılması;
saxta 'credit' ilə - müvəffəqiyyətə qədər təkrarlama;
balans əl düzəlişləri - qadağandır; yalnız kompensasiya hadisələr.

7) Bonuslar, turnirlər, canlı cekpotlar

Vajer töhfə: canlı oyunlar adətən 10-25% çəki verir; bridge açıq masa/oyun növü ötürmək məcburiyyətindədir.

Turnirlər/reyslər: dövriyyəyə görə xallar, çoxluqlar, streaks; mənbə 'live hadisələridir. bet. settled`.

Jackpotlar: fix/proqressiv (lokal/şəbəkə). Hər bir ixtisaslı dərəcə ilə ödəniş; trigger - bridge/cekpot xidmətinin tərəfində.

Məsuliyyət: promo mexaniklər əsas oyun şanslarını dəyişməməlidir; əks halda - ayrıca sertifikatlaşdırma.

8) Antifrod və risk

Velocity/arbitraj gecikmələr: «fakt sonra» bahis qadağan; sərt cut-off.

Multi-hesab/ümumi cihazlar: qrafik yoxlamalar, device-fingerprinting.

Uduşların anomaliyaları: masa/oyunçu/region üzrə gözlənilən həddindən artıq nümunələr.

Chargeback defense: depozitlər/satıcılar, hold/commit qeydləri ilə bahis əlaqəsi.

9) Observability və telemetriya

Biznes metrika

`bets_per_round`, `players_on_table`, `avg_bet`, `payout_ratio`, `rake`, `jackpot_latency`, `settle_lag_ms`.

Texnometrika

p50/p95/p99 'bet. place`, `bet. lock`, `settle`, `wallet. debit/commit/credit`;

depth очередей, consumer lag, CPU/mem/GC, TLS errors, WebRTC/HLS QoE (stall ratio).

Daşbordlar

NOC: masalar/şoular, onlayn, bets/min, settle lag, error heatmap regionlar üzrə.

SRE: latency per endpoint, queue lag, retrу storms, success of commit/credit.

Alertlər (SLO-büdcə): p95 'settle'> X, error rate> Y%, lag> Z san, artım 'cancelled' konkret masada.

WORM auditi: limitlərin, şou-raundların RTP profillərinin, cekpotların parametrlərinin, fich bayraqlarının dəyişdirilməsi.

10) Təhlükəsizlik və uyğunluq

mTLS + bütün S2S çağırışlarında imzalar (HMAC/EdDSA); qısa ömürlü tokenlər.

Zero-trust: mesh siyasətləri, minimum imtiyazlar, regionlara görə seqmentləşdirmə.

PCI/GDPR/Data residency: PII və log - regionda (EU/UK/BR...), cross-oxu qadağandır.

RG: sinxron stop siqnalları (depozit/itki/vaxt limitləri, özünü istisna), reality-check.

Audit: krit hərəkətlərinin qeydləri - dəyişməz (WORM), «dörd göz» girişləri.

11) Multitenantlıq və multibrend

Bütün hadisələr və çağırışlar 'tenant _ id/brand _ id/license/region' ilə qeyd olunur.

Ledger/Cashier/PII - per lisenziya/region (tez-tez ayrı-ayrı DB/klasterlər) təcrid.

Ümumi xidmətlər (bridge-nüvəsi, turnirlər, cekpotlar) - şəreable, lakin məlumatlarda sərt RLS ilə.

Ficha bayraqları/limitləri/bonus pulları - marka/yurisdiksiya səviyyəsində.

12) Performans və deqradasiya

Back-pressure: həddindən artıq yükləndikdə - cut-off əvvəl 'no new bets', commit/settle prioritetləşdirilməsi.

Degrade modes: əlavə promo/cekpotların bağlanması, əsas dərəcələrin və ödənişlərin qorunması.

DR-plan: aktiv-aktiv/aktiv-passiv; RPO ≤ 5 dəq, RTO ≤ 30 dəq; outbox sinxronizasiya.

13) Giriş çek siyahısı (operator/provayder)

Memarlıq

Hadisə müqavilələri (Schema Registry), idempotentlik açarları 'round _ id/bet _ id/settle _ id'.
Саги authorize→commit→settle→credit; əl düzəlişləri olmadan kompensasiya.
Bütün pul sərvətləri üçün Outbox/CDC; heç bir nəşr «yan keçmək».
Cut-off/lock canlı nüvənin tərəfində həyata keçirilir və şəbəkə gecikmələri ilə qorunur.

Pul/bonuslar

Ledger həqiqət mənbəyi kimi; hold/commit/credit atom.
Canlı Vager töhfəsi şəffafdır; turnirlər/cekpotlar əsas oyun şanslarını dəyişmir.

Observability/SLO

Daşbordlar NOC/SRE; SLO-alertlər latency/error/lag.
WORM-audit limitləri və fich bayraqları; postmortem prosesi.

Təhlükəsizlik/uyğunluq

mTLS + imzalar; Vault/HSM; RBAC/ABAC; data residency.
RG-ayaq sinxron; AML siqnalları və hesabat avtomatlaşdırılmışdır.

14) Qırmızı bayraqlar (anti-nümunələr)

DB-də balansların/düzəlişlərin əl ilə düzəldilməsi.

Pəncərədən sonra bahis qəbulu (ciddi lock yoxdur).

outbox/CDC → olmadan telemetriya nəşr «itirmək» raundlar.

İdempotentlik və dedupun olmaması → ödənişlərin dubli.

Müxtəlif bölgələrin/markaların PII və pul dövrünün qarışdırılması.

Heç bir deqradasiya yoxdur: promosyonun düşməsi uduşların hesablanmasına səbəb olur.

BI/tənzimləyici hesabatlar döyüş OLTP ilə işləyir.

15) Yekun

Canlı oyunlar üçün Bridge sadəcə «API adapteri» deyil, canlı nəticəni platformanın ciddi invariantları ilə əlaqələndirən pul hadisəsi nüvəsidir: cüzdan, bonuslar, RG/AML və hesabat. Onun gücü idempotentlik və saqalarda, sərt pəncərələrdə və dirəklərdə, müşahidə və təhlükəsizlikdədir. Belə bir təməldə canlı casino və şou formatları proqnozlaşdırıla bilən şəkildə ölçülür, pik efirlərə dözür və oyunçu, marka və tənzimləyici üçün şəffaf olaraq qalır.