Näme üçin kazinolar modul arhitekturasyna geçýärler?

Näme üçin kazino modullylygy

Taryhy monolit ösüşi haýalladýar: her bir üýtgeşme tutuş ulgamy çykarýar, üpjün edijiler we PSP integrasiýasy SLO-ny urýar, ähli kody doldurýar. Modul arhitekturasy (domain-driven + şertnama API + wakalar):

"Hemmeler bilen" utgaşdyrmazdan çalt çeňňek çykarmak we üpjün edijileri birikdirmek;
Saýlap ölçemek (live-wideo kassadan, gapjyk oýun katalogyndan aýratyn);
Töwekgelçilikleri izolirlemek (mahabatdaky ýalňyşlyk gapjygy taşlamaýar);
Ygtyýarnamalary berjaý etmek (domen çäklerinde logirlemek/wersiýalary/syýasatlary);
TCO-ny anyk şertnamalar, gaýtadan ulanmak we awtomatlaşdyrmak arkaly azaltmak.

Domen kartoçkasy (bölünişigiň mysaly)

Wallet/Ledger - pul, walýuta hedjisi, bonus balanslary, PITR, audit.

Cashier/Payments - PSP, on-rampa/off-rampa, KYT, idempotent webhuklar.

Gaming Bridge - üpjün edijileriň adapterleri, round/bet kadalaşmagy.

Catalog/Lobby - oýunlar, üpjün edijiler, fiçering we görkeziş düzgünleri.

Promo/Bonus - paýnamalaryň, talonlaryň, wageriň düzgünleri.

KYC/AML/RG - şahsyýeti barlamak, sanksiýalar/PP, çäklendirmeler we öz-özüni aýyrmak.

Experience - frontend, CDN, i18n, A/B, Telegram WebApp.

Telemetry/Analytics - wakalar, vitrinler, ML/AI.

Compliance & Audit - MGA/UKGC hasabatlary, WORM-arhiw.

💡 Her modulyň öz maglumat shemasy, API we waka şertnamasy bar; özara täsir - wakalaryň şinasy we berk wersiýaly interfeýsler arkaly.

Modul arhitekturasynyň ýörelgeleri

1. DDD serhetleri (bounded context). Maglumatlary we logikany anyk bilmek.

2. API-birinji + wakalar. OpenAPI/AsyncAPI, JSON-Shema, şertnama synaglary.

3. Wersiýalaşdyrmak we gabat gelmek. 'v1 → v1. 1 → v2` (expand→migrate→contract).

4. Idempotency & Exactly-once-intent. Soraglaryň açarlary, wakalaryň gaýtalanmagy.

5. Ygtybarly. mTLS, HMAC-gollar, gysga JWT, RBAC/ABAC.

6. Garaşsyz neşirler. Kanar/gök-ýaşyl depla, "iki gol" bilen göçmek gadagandyr.

7. Syn edilişi. Geçiş 'traceId', modul üçin SLO metrikleri.

8. Baýdaklar. Traffik/geo/ulanyjy segmentleri, howpsuz yza gaýdyp gelmek.

Integrasiýa gatlagy: üpjün edijileri we PSP-leri nädip birikdirmeli

Adapter/Bridge-pattern: Her bir oýun/töleg üpjün edijisi - platformanyň ýeke-täk şertnamasy bolan plugin.

Oýunlar: normalizasiýa 'roundId/betId/status', mapping ýalňyşlyklary, keş limitleri.

Tölegler: ýeke-täk interfeýs 'authorize/capture/refund/payout', idempotentlik webhukki.

Öçürilmezlik: nädogry adapter beýlekilere täsir etmezden maintenance-a geçirilýär.

Şertnamanyň mysaly (OpenAPI bölegi):

yaml post /wallet/debit:
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DebitRequest@v1'
responses:
'200': { $ref: '#/components/schemas/DebitResult@v1' }
'409': { description: IDEMPOTENT_REPLAY }

"Gan aýlanyş ulgamy" ýaly wakalar

Şina (Kafka/NATS) → wakalar:

`bet. placed`, `round. settled`, `payout. requested/approved`, `kyc. verified/failed`, `rg. limit_set`, `bonus. issued/consumed`, `cashier. webhook. received`, `wallet. hold/release`, `alert. slo_breach`.

Düzgünler:

Wakalar geçmişi ýatyrmaýar; düzedişler - aýry-aýry öwezini dolýan wakalar bilen.
Her modul diňe öz başlangyç wakalaryny ýazýar, emele gelenler - täze mowzuklar ýaly.

Maglumatlar: gatlaklar we sazlaşyk

ALTP modulyna: Postgres/MySQL/KeyDB - izolirlenen amallar.

OLAP/vitrinler: ClickHouse/BigQuery wakalardan gurlupdyr; OLTP we analitikany garyşdyrmaýarys.

Feature Store/ML: ALTP-den garaşsyz fich we TTL wersiýalary bolan gatlak.

Sazlaşyk: modullaryň arasynda strategiki taýdan eventual, pul üçin bolsa - ýerli ACID + serhetlerdäki demokratik hereketler.

Deploý we masştab

Konteýnerler (Docker/K8s): modul boýunça awtoskeýl (wallet - CPU/IO; live-video - tor; bridge — RPS).

Perimetri izolýasiýa etmek: tor syýasatlary, modul üçin aýry-aýry syrlar/açarlar, dürli PII/pul/telemetriýa ammarlary.

Traffik-şeýping: fiça-baýdaklar, kanareýa paýy, sebit ugurlary.

DR/HA: Multi-AZ; pul üçin aktiw-passiw, okamak/metbugat üçin aktiw-aktiw.

Modullara "gabat gelýär"

KYC/AML/RG - syýasatçylaryň we çözgütler magazineurnalynyň ('policyVer') öz moduly.

Audit/WORM - pul/tapgyrlar/tölegler wakalarynyň üýtgemeýän ammary.

Hasabat - ýurisdiksiýalar boýunça eksport (MGA/UKGC), doly/öz wagtynda SLA.

Akym nusgasy

Nyrh → hasaplaşyk → töleg

1. 'gaming-bridge' iberýär 'bet. placed` (idempotent).

2. 'wallet' hold 'edýär we' wallet 'çap edýär. hold`.

3. 'gaming-bridge' üpjün edijiniň netijesini alýar → 'round. settled`.

4. 'wallet' settle '(release/payout) →' wallet hasaplaýar. settled`.

5. 'promo' wakalary sarp edýär we bonus hasaplaýar → 'bonus. issued`.

Kassa (goýum)

1. 'cashier' 'payment' döredýär. intent` с `Idempotency-Key`.

2. PSP vebhuk çagyrýar → 'cashier. webhook. received`.

3. `wallet. credit 'fakto → analitika we RG üçin waka.

Duralgasyz üýtgeşmeler (expand → migrate → contract)

1. Expand: 'v1-de meýdanlar/endpoint goşuldy. 1 ', köne müşderiler bozulmaýar.

2. Migrate: sarp edijiler täze okaýarlar, iki wersiýada ýazýarlar (dual-write diňe nagt däl).

3. Contract: EOL 'v1 diýip yglan etdi. 0 ', meýilnama boýunça N hepdeden soň aýryldy.

Platforma in engineeringenerligi

Golden Paths: modullaryň şablonlary (repo-askeleon, CI/CD, alertler, SLO, syrlar).

Şertnama synaglary: CI-de Pact/AsyncAPI testleri; galp üpjün edijiler bilen integrasiýa gurşawy.

Hyzmat katalogy (Backstage): eýesi kim, SLA, API wersiýalary, rukbook hadysasy.

Modullygyň üstünlik metrikleri

Lead time ideýadan prodostere çenli ↓ X gezek.

Modul boýunça goýberilişleriň ýygylygy ↑ (günde/hepdede), change-fail rate ↓.

MTTR hadysalar boýunça ↓ (izolýasiýa sebäpli).

Infra cost/GGR durnukly ýa-da ulag ulalanda ↓ (saýlaw skeýli).

Üpjün edijiniň/PSP-iň integrasiýa wagty (brifingden önüme çenli) ↓.

Anti-patternler

"Mikroservisler üçin mikroservisler". Maglumatlaryň anyk çäkleri bolmazdan, baglanyşyk we çylşyrymlylyk ösýär.

Modullaryň arasyndaky umumy DB/shemalar. Izolýasiýa we garaşsyz çykaryşlary öldürýär.

Wersiýasy/şertnamasy bolmadyk wakalar. Sarp edijileri "ýuwaşlyk bilen" döwýärler.

Pul üçin dual-write. Ylalaşmazlyk töwekgelçiligi diňe bir ýazyjynyň üsti bilen ýüze çykýan ädimlerdir.

Hemme zat bilen global "ulanyjy gatlagy". Gizlin monolite öwrülýär.

Fiç baýdaklary we kill-switch ýok. Islendik ýalňyşlyk hemmelere birbada täsir edýär.

OLTP/OLAP garyndysy. Hasabatlar nyrhlary/gapjygy haýalladýar.

Gözegçiliksiz. SLO ölçemek we hadysalary baglanyşdyrmak üçin hiç zat ýok.

Modul arhitekturasyna geçişiň barlag sanawy

Strategiýa we domenler

Modul boýunça bounded contexts, eýeleri we KPI kesgitlenildi.
Özara gatnaşyk kartasy: API/wakalar, kritiklik we SLO.

Şertnamalar we howpsuzlyk

OpenAPI/AsyncAPI + JSON-Schema; wersiýasy we durmuş sikli.
mTLS/HMAC, gysga JWT, RBAC/ABAC serhetlerde.

Maglumat

Bölünen ALTP; wakalar - OLAP üçin çeşme.
API/webhuklarda idempotency, habarlaryň duplikasiýasy.

CI/CD we neşirler

Kanareýa/blue-green, ficha-baýdaklar, modul boýunça awtoskeýl.
CI-de şertnama synaglary; galp üpjün edijiler bilen gurşaw.

Syn ediliş

'traceId' -den loglar/metrikler/söwdalar; SLO-daşbordlar.
Iş ölçegleri boýunça aladalar (VOID, reject, payout lag).

Utgaşma

WORM-Pul/tapgyrlar arhiwi, kadalaşdyryjy hasabatyň eksporty.
KYC/AML/RG çözgütler magazineurnaly bilen aýratyn modul hökmünde.

Kiçi mysallar

Waka 'round. settled@v1`:

json
{
"event":"round. settled",  "v":"1",  "roundId":"R-2025-10-17-evo-23",  "gameId":"evo_blackjack_23",  "bets":[{"betId":"b_92f","playerId":"p_1","stake":"10. 00","payout":"15. 00","outcome":"WIN"}],  "ts":"2025-10-17T14:23:13. 120Z",  "traceId":"tr_5f1"
}

Idempotent gapjyk:

http
POST /wallet/settle
X-Idempotency-Key: 9a7f-2b1c
{
"roundId":"R-2025-10-17-evo-23",  "operations":[{"playerId":"p_1","delta":"5. 00","currency":"EUR"}]
}

Modully binagärlik kazino platformasyny "gowşak kombaýndan" ygtybarly domenleriň kompozisiýasyna öwürýär: her biri öz şertnamalary, maglumatlary we SLO bilen. Bu integrasiýalary we goýberişleri çaltlaşdyrýar, saýlama masştaby berýär, laýyklygy ýönekeýleşdirýär we hadysalaryň töwekgelçiligini azaldýar. Domen çäklerini, şertnamalary we wakalary bellemekden başlaň, howpsuzlygy we gözegçiligi "dokaň" - önümi haýallatmak däl-de, onuň bilen ösýän platforma alarsyňyz.