Кантип API джекпот системалары иштейт

Макаланын толук тексти

💡 18+. Материал - инженердик-колдонмо, оюнга чакыруу жок. Терминдер: платформа - PAM/капчык/касса/бонустар/RG; RGS - Remote Game Server (студия оюндарынын өзөгү); агрегатор - көп RGS үчүн бирдиктүү катмар; JP - jackpot кызматы.

1) Jackpot системасы деген эмне жана ал экосистемада турган жерде

Джекпот системасы - бул коюмдардан төгүмдөрдү чогулткан, утуштардын пулдарын жана триггерлерин башкарган, байгелерди бөлүштүрүүнү эсептеген жана оператордун төлөм контуру аркылуу төлөмдөрдү демилгелеген өзүнчө сервис (кээде сервистер кластери). Ал бириктирет:

RGS менен (коюмдар/натыйжалар жана квалификациялар жөнүндө билдирүүлөр), платформа/капчык менен (төгүмдөрдү эсептен чыгаруу жана утуштарды кредиттөө), агрегатор менен (көптөгөн студиялардан/бренддерден роутинг), BI/жөнгө салуучу менен (телеметрия жана отчеттуулук).

2) джекпот түрлөрү (жана эмне API өзгөртүлөт)

1. Белгиленген (Fixed): алдын ала белгилүү сыйлык суммасы. APIде пул жок, болгону шарттарды текшерүү жана насыя.

2. Прогрессивдүү (Прогрессивдүү): Бассейн ставкалардан өсөт. Салымдын эндпоинттери жана учурдагы өлчөмдү жарыялоо керек.

3. Көп баскычтуу (Multi-tier: Mini/Major/Grand): ар кандай мүмкүнчүлүктөр жана капчыктар менен бир нече параллелдүү пулдар.

4. Жергиликтүү vs тармак: жергиликтүү бассейн - бир оператор/бренд; тармактык - көптөгөн операторлор/бренддер/региондор боюнча жалпы (мультитенанттуулук жана репликация маанилүү).

5. Убактылуу/иш-чара: мөөнөт менен же график боюнча пул (таймерлер жана авто-чүчүкулактар керек).

3) Акча инварианттары

балансы боюнча чындык булагы - капчык/ledger платформа. JP гана бассейн жана милдеттенмелердин абалын сактайт.

Бардык акча операциялары - демпотенттик (ачкычтар 'jp _ contrib _ id', 'jp _ trigger _ id', 'jp _ payout _ id').

"Жоголгон/кайталанган төлөмдөр" = 0. Компенсация - гана окуялар (сагалар), эмес, кол менен түзөтүүлөр DD.

Өз телеметрия менен өз алдынча транзакциялар катары төлөмдү (contribution), триггерди (trigger) жана төлөмдү (payout) бөлүшүү.

4) Эталондук келишимдер API

4. 1 RGS/агрегатор → JP (салымдар жана триггерлер)

'POST/v1/jp/contributions' - пулга салымды эсепке алуу

json
{
"jp_contrib_id": "uuid-1",  "tenant_id": "brand-42",  "pool_id": "grand-eu-01",  "player_id": "p_abc",  "game_id": "studio:slot_777",  "round_id": "r_123",  "bet": {"amount": 2. 00, "currency": "EUR"},  "contrib": {"amount": 0. 02, "currency": "EUR"},  "occurred_at": "2025-10-23T15:12:05Z",  "idempotency_key": "round_r_123"
}

'POST/v1/jp/candidates' - катышуу өтүнмөсү/шарттарды текшерүү (кошумча)

Жооп: 'eligible: true/false', салмагы же мүмкүнчүлүк, эрежелер.

'POST/v1/jp/triggers' - ишке киргизүү

json
{
"jp_trigger_id": "uuid-2",  "pool_id": "grand-eu-01",  "reason": "random_hit",  "selector": {"player_id": "p_abc", "round_id": "r_123"},  "occurred_at": "2025-10-23T15:12:06Z",  "idempotency_key": "jp_t_grand_r_123"
}

💡 Эскертүү: Кээ бир моделдерде триггердин демилгечиси JP (ички рулетка) өзү, ал эми RGS раунд жөнүндө гана билдирет. Андан кийин 'triggers' деп аталган JP → платформа, жана RGS иш-чарага жазылат.

4. 2 JP → платформа (төлөмдөр/камдар)

'POST/v1/wallet/reserve' - (кошумча) келечектеги төлөм үчүн камдык

'POST/v1/wallet/credit' - оюнчу кредит утуп

json
{
"jp_payout_id": "uuid-3",  "tenant_id": "brand-42",  "player_id": "p_abc",  "pool_id": "grand-eu-01",  "amount": {"amount": 500000. 00, "currency": "EUR"},  "meta": {"tax": "withheld=false", "tier": "grand"},  "idempotency_key": "jp_p_grand_r_123"
}

Платфоманын жооптору: 'credit. ok	failed ', себептердин коддору менен (RG/AML, чегерүү лимиттери, санкциялар, гео-блок).

4. 3 бассейн статусун жарыялоо (Front/Widget үчүн)

'GET/v1/jp/pools/{ pool _ id}' → учурдагы көлөмү, seed, cap, катышуучулардын саны, ETA ж.б.

'GET/v1/jp/pools' → бренд/чыпкалар менен аймак боюнча пулдардын тизмеси.

5) Окуя модели (Kafka/Pulsar) жана схемалар

Негизги топиктер:

`jp. contribution. recorded`
`jp. pool. updated '(көлөмү, атаандаштык жаңыртуулар)
`jp. triggered`

`jp. payout. requested	credited	failed`
`wallet. credit. '(сакалар үчүн күзгү)
`rg. limit. hit`, `aml. alert. opened '(төлөм бөгөттөлгөн болсо)
`audit. config. changed '(лимиттер, seed, cap, бөлүштүрүү)

Келишимдер: Euro/JSON Schema + Schema Registry, партиялаштыруу ачкычтары 'tenant _ id', 'pool _ id', 'player _ id'. Версиялоо - backward-compatible.

6) Триггер алгоритмдер (жогорку деңгээл)

Ыктымалдык (p-туруктуу): ар бир квалификациялуу раунд үчүн 'p' ыктымалдыгы менен hit түзөбүз (деңгээлдин пулуна/түрүнө жараша).

Диапазон (must-drop): бассейн cap-суммасына же мөөнөтүнө чейин төмөндөшү керек - ички random диапазонунда [min, max] кармап, cap/ETA жарыялайт.

Sid жана entropy башкаруу: Server seed + per-round salt; джекпот үчүн кардар орундарды баш тартуу. Бардык seed өзгөртүүлөр - WORM аудит астында.

Чынчылдык: триггер оюнчунун конкреттүү инсандыгына көз каранды болбошу керек (гео/лицензия/квалификация эрежелеринен тышкары). Ар кандай "жеке" максаттуу - табу.

7) SLO жана аткаруу

p95 'contribution' <120 мс, p99 <250 мс.

p95 'trigger → credit' <500 ms (тышкы төлөм хопсуз).

"Жоголгон/кайталанган төлөмдөр" = 0 (контракттык тесттер менен текшерилет).

BI окуяларды жеткирүү ≤ 5 мин.

JP API критикалык жолдор үчүн жеткиликтүүлүгү ≥ 99. 95%.

8) Коопсуздук жана комплаенс

mTLS + кол (HMAC/EdDSA) бардык S2S чалуулар боюнча; кыска мөөнөттүү токендер.

Zero-trust: тармактык саясат/mesh, минималдуу артыкчылыктар, региондор боюнча сегменттөө.

WORM-аудит өзгөрүүлөр лимиттери, формулалар, seed/entropy, бассейн конфигурациялары.

GDPR/Data residency/PCI: PII жана логи - аймакта; сезгич талааларды токенизациялоо; кросс-аймактык окууга тыюу салуу.

RG/AML: төлөө боюнча синхрондуу токтоо сигналдары; SAR/STR-разгрузка автоматташтырылган.

9) ырааттуулук жана сагалар

Төлөм ('contribution') - JPге бекитүү, jp жарыялоо. contribution. recorded`.

Триггер ('triggered') - милдеттенме түзөт; JP 'payout' дастанын ишке киргизет.

Төлөм ('payout. requested → wallet. credit. ok ') - дастанды аяктайт; фейл - дедупликация менен ретра.

Outbox/CDC - окуяларды жарыялоонун жалгыз жолу; эч кандай "айланып өтүүчү" логгерлер жок.

10) Телеметрия жана дашборддор

Бизнес:

`pool_size`, `contrib_rate`, `avg_contrib_per_bet`, `time_to_drop`, `payouts_count/sum`, `tier_distribution`.

Техникалык:

p50/p95/p99 по `contribution`, `trigger`, `payout`;
error rate с типами (5xx/4xx/business), retry storms, queue lag;
`wallet. credit` latency/ok-rate; бассейнди жаңылоонун карама-каршылыгы.

Алерталар:

'payout. failed '> X% бренд/аймак боюнча,' pool _ size '> cap - Y% убакыт (конфигурация катасы), drift ортосунда' pool _ size 'жана салымдардын суммасы> Z ppm.

11) Multitenanthy жана изоляция

Бардык суроолор жана окуялар 'tenant _ id/brand _ id/license/region' деп белгиленет.

Жергиликтүү/тармактык бассейндер физикалык жактан бөлүнгөн (DB/cluster) ар кандай лицензиялар/региондор боюнча.

Row-level security (RLS) жана BI терезелеринде жашыруу.

Жеке ачкычтар/сырлар жана бренд/аймак боюнча схемалык мейкиндик.

12) Бонустар/турнирлер менен интеграция

Төгүмдөр түздөн-түз көбөйтпөйт; бонуска салымы - төгүмдөн эмес, коюмдан келип чыгат.

Турнирлер "JP катышуу" же "жогорку депозиттерге кирүү" үчүн упай алышы мүмкүн. Булак - окуялар 'jp. contribution. recorded` и `jp. triggered`.

Милдеттүү эреже: джекпот-механика негизги RTP оюн өзгөртпөйт; болбосо өзүнчө сертификация керек.

13) тестирлөө жана башаламандык-практикасы

Контракттык тесттер RGS, JP, капчык: кош жеткирүү, кечигүү, out-of-order, rollback.

Load Tests: Storm коюмдар жана триггерлер, көлмөнүн Worker масштабдоо.

Хаос машыгуулары: JP аймагынын кулашы, оффлайн капчык, убакытты синхрондоштуруу; outbox жана деградацияларды текшерүү (pause triggers/no new contributions).

14) Чек-баракчалар

Студия/RGS үчүн

Idempotent 'contribution' жана туура 'round _ id '/' bet _ id'.
эч кандай жарыялоо "айланып" бүтүмдөр (гана outbox/CDC).
Эки жолу сыноо/кайталап триггер/ордун толтуруу.
max bet чеги/квалификация JP өткөрүлүп берилет.

Оператор/платформа үчүн

Ledger - чындыктын булагы, 'wallet. credit 'менен чоң атасы.
RG/AML-Stop төлөө боюнча иштелип чыккан; SAR/STR отчеттору.
Dashboard p95 'trigger → credit', error rate, пулдун салыштыруу.

JP ээси үчүн

WORM-аудит өзгөрүүлөр formula/seed/чеги.
Registry жана versioning окуялардын схемалары.
DR: RPO ≤ 5 мин, RTO ≤ 30 мин; үзгүлтүксүз машыгуулар.
RLS/бренддер/лицензиялар боюнча изоляция; ачкычтары/per аймак сырлары.

15) Кызыл желектер (анти-үлгүлөрү)

DD пулдардын жана төлөмдөрдүн өлчөмдөрүн кол менен оңдоо.

double кредиттер → жоктугу.

outbox/CDC жок телеметрия жарыялоо → "жоголгон" салымдар/триггерлер.

Ар кайсы аймактардын PII жана акча маалыматтарды аралаштыруу.

жаңы күбөлүк жок RTP негизги оюн таасир Jackpot.

Капчык менен бассейнди салыштыруу жок; отчеттор согуштук OLTP боюнча түзүлөт.

API джекпот системалары - бул студия, платформа жана оператор ортосундагы акча-чара келишими. Анын пайдубалы: демпотенттик жана сагалар, акчаны катуу изоляциялоо, окуялардын так схемалары, коопсуздук жана WORM-аудит, байкоо жүргүзүү жана SLO. Мындай дизайнда фикс/прогрессивдүү жана тармактык бассейндер болжолдуу масштабдалат, төлөмдөр туура бойдон калат, ал эми жөнгө салуучу жана бизнес отчеттуулук ачык жана ишенимдүү болот.