Чӣ тавр jackpot API кор мекунад

Мақолаи пурра

💡 18+. Мавод муҳандисӣ буда, бидуни занг ба бозӣ истифода мешавад. Шартҳо: платформа - PAM/ҳамён/кассаи нақд/мукофотпулӣ/RG; RGS - Сервери бозикунии дурдаст (аслии бозиҳои студия); агрегатор - қабати ягона барои якчанд RGS; JP - хидмати jackpot.

1) Системаи jackpot чист ва он дар экосистема дар куҷост

Системаи jackpot як хидмати алоҳида (баъзан кластери хидматҳо) мебошад, ки саҳмҳоро аз гаравҳо ҷамъоварӣ мекунад, ҳавзҳоро идора мекунад ва триггерҳо ба даст меорад, тақсимоти тӯҳфаҳоро ҳисоб мекунад ва пардохтҳоро тавассути ҳалқаи пардохти оператор оғоз мекунад. Он ҳамгиро мекунад:

бо RGS (паёмҳо дар бораи нархҳо/натиҷаҳо ва тахассусҳо), бо платформа/ҳамён (аз ҳисоб баровардани саҳмҳо ва бурдҳои кредитӣ), бо агрегат (масир аз бисёр студияҳо/брендҳо), бо BI/танзимкунанда (телеметрия ва ҳисобот).

2) Намудҳои jackpots (ва чӣ дар API тағйир меёбад)

1. Собит-Маблағи ҷоиза пешакӣ маълум аст. Дар API ҳавз вуҷуд надорад, танҳо санҷиши шартӣ ва қарз.

2. Прогрессивӣ: Ҳавз аз саҳмҳои гарав меафзояд. Мо ба нуқтаҳои ниҳоии саҳм ва нашри андозаи ҷорӣ ниёз дорем.

3. Бисёрзинагӣ (бисёрзинагӣ: Мини/Майор/Гранд): ҳавзҳои параллелии сершумор бо эҳтимолияти гуногун ва ҳадди аққал.

4. Маҳаллӣ ва шабака: ҳавзи маҳаллӣ - як оператор/бренд; шабака - ҳамагӣ барои бисёр операторҳо/брендҳо/минтақаҳо (бисёрҷанба ва такрорӣ муҳим аст).

5. Вақт/ҳодиса: ҳавзи дорои мӯҳлати ниҳоӣ ё ҷадвал (вақтсанҷ ва худкор кашидан лозим аст).

3) Инвариантҳои пулӣ

Манбаи ҳақиқат дар тавозун ҳамён/дафтарчаи платформа мебошад. JP танҳо ҳолати ҳавзҳо ва ӯҳдадориҳоро нигоҳ медорад.

Ҳама амалиётҳои пулӣ номуайянанд (калидҳои 'jp _ curb _ id', 'jp _ trigger _ id', 'jp _ payout _ id').

Пардохтҳои гумшуда/такрорӣ = 0. Ҷуброн - танҳо аз рӯи рӯйдодҳо (сагҳо), на аз рӯи таҳрири пойгоҳи додаҳо.

Саҳми алоҳида, триггер ва пардохт ҳамчун амалиёти мустақил бо телеметрияи худ.

4) Шартномаҳои истинодҳои API

4. 1 RGS/→ агрегатори JP (саҳмҳо ва триггерҳо)

'POST/v1/jp/саҳмияҳо' - баҳисобгирии саҳми ҳавз

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," бет ": {" маблағ ": 2. 00, "асъор": "EUR"}, "": {"маблағ": 0. 02, "асъор": "EUR"}, "occurred_at": "2025-10-23T15:12:05Z," "idempotency_key": "round_r_123"
}

'POST/v1/jp/номзадҳо' - ариза барои иштирок/санҷиши шартҳо (ихтиёрӣ)

Ҷавоб: 'қобили қабул: дуруст/бардурӯғ', вазн ё имконият, қоидаҳо.

'POST/v1/jp/triggers' - сабти далели амалиёт

json
{
"jp_trigger_id": "uuid-2", "pool_id": "grand-eu-01", "сабаб": "random_hit," "селектор": {"player _ id": "p_abc," "round_id": "r_123"} ", occurred_at": "2025-10-23T15:12:06Z," "idempotency_key": "jp_t_grand_r_123"
}

💡 Эзоҳ: дар баъзе моделҳо, триггер аз ҷониби худи JP (roulette дохилӣ) оғоз ёфтааст ва RGS танҳо даврро гузориш медиҳад. Он гоҳ 'триггерҳо' JP → platforma номида мешаванд ва RGS ба ин чорабинӣ обуна мешавад.

4. 2 платформаи JP → (пардохтҳо/муқаррарот)

'POST/v1/ҳамён/захира' - (ихтиёрӣ) барои пардохти оянда

'POST/v1/ҳамён/қарз' - қарзи бурди бозингар

json
{
"jp_payout_id": "uuid-3", "tenant_id": "brand-42", "player_id": "p_abc," "pool_id": "grand-eu-01", "маблағ": {"маблағ": 500000. 00, "асъор": "EUR"}, "meta": {"андоз": "нигоҳ дошта мешавад = дурӯғ", "сатҳ": "grand"}, "idempotency_key": "jp_p_grand_r_123"
}

Ҷавобҳои платформа: 'қарз. хуб	ноком ', бо рамзҳои сабабӣ (RG/AML, маҳдудиятҳои хуруҷ, таҳримот, гео-блок).

4. 3 Нашр кардани ҳолати ҳавз (барои ҷабҳаҳо/виджетҳо)

'GET/v1/jp/pools/{ pool _ id}' → андозаи ҳозира, тухм, ҳадди аққал, шумораи иштирокчиён, ETA ва ғайра.

Рӯйхати ҳавзҳои 'GET/v1/jp/pools' аз рӯи бренд/минтақа бо филтрҳо.

5) Модели чорабиниҳо (Кафка/Пулсар) ва диаграммаҳо

Мавзӯъҳои асосӣ:

'jp. саҳм. сабт шудааст '
'jp. ҳавз. навсозӣ '(андоза, навсозиҳои рақобат)
'jp. триггер '

'jp. пардохт. дархост карда шуд	қарз гирифта шудааст	ноком '
'wallet. қарз. '(оина барои сагҳо)
'rg. лимит. зад ',' амл. ҳушдор. кушода '(агар пардохт манъ карда шуда бошад)
'аудит. конфигуратсия. тағир ёфт '(маҳдудиятҳо, тухмӣ, ҳадди ақалл, тақсимот)

Шартномаҳо: Avro/JSON Schema + Феҳристи схема, калидҳои иштирок 'иҷорагир _ ид', 'pool _ id', 'player _ id'. Версия - ба қафо мувофиқ.

6) Алгоритмҳои триггер (сатҳи баланд)

Эҳтимолияти (p-устувор): барои ҳар як даври тахассусӣ мо зарбаеро бо эҳтимолияти 'p' тавлид мекунем (вобаста ба ҳавз/навъи сатҳ).

Диапазон (бояд афтад): ҳавз бояд ба ҳадди ақалл ё мӯҳлати ниҳоӣ рост ояд - тасодуфии дохилиро дар диапазон нигоҳ доред [min, max], нашр cap/ETA.

Идоракунии тухмӣ ва энтропия: тухми сервер + намак дар як давр; даст кашидан аз курсиҳои jackpot муштарӣ. Ҳама тағирот ба тухмӣ зери санҷиши WORM мебошанд.

Ростқавлӣ: Триггер набояд аз шахсияти мушаххаси бозингар вобаста бошад (ба ғайр аз қоидаҳои гео/литсензия/тахассус). Ҳама гуна ҳадафи "шахсӣ" мамнӯъ аст.

7) SLO ва иҷрои

p95 'саҳм' <120 ms, p99 <250 ms.

p95 'триггер → кредит' <500 мс (бидуни пардохти беруна).

"Пардохтҳои гумшуда/такрорӣ" = 0 (бо санҷишҳои шартномавӣ санҷида мешаванд).

Расонидани чорабинӣ ба BI ≤ 5 дақиқа.

Мавҷудияти JP API барои роҳҳои муҳим ≥ 99. 95%.

8) Бехатарӣ ва риояи

Имзоҳои M TLS + (HMAC/Ed 'DSA) дар ҳама зангҳои аломатҳои кӯтоҳмуддат.

Боварӣ ба сифр: сиёсати шабака/фикрию, имтиёзҳои ҳадди аққал, тақсимот аз рӯи минтақа.

Аудити WORM оид ба тағирот ба маҳдудиятҳо, формулаҳо, тухмиҳо/энтропия, конфигуратсияҳои ҳавз.

GDPR/Резидентураи маълумот/PCI: PII ва гузоришҳо - дар минтақа; токенизатсияи майдонҳои ҳассос; манъ кардани хониши байниминтақавӣ.

RG/AML: чароғҳои синхронии тормоз дар пардохт; Боркуниҳои SAR/STR автоматӣ мебошанд.

9) Ҳамоҳангӣ ва сагҳо

Саҳм ('саҳм') - ислоҳ дар JP, нашр 'jp. саҳм. сабт '.

Триггер ('триггер') - ӯҳдадорӣ эҷод мекунад; JP 'payout' saga -ро оғоз мекунад.

Пардохт ('пардохт. дархост → ҳамён. қарз. ok ') - достонро ба итмом мерасонад; бо қалбакӣ - retrai бо deduplication.

Outbox/CDC роҳи ягонаи интишори чорабиниҳо мебошад; ягон сабти "гузариш" нест.

10) Телеметрия ва панели панелҳо

Тиҷорат:

'pool _ size', '_ rate', 'avg _ _ _ _ per _ bet', 'time _ to _ drop', 'payouts _ count/sum', 'tier _ distribution'.

Техникӣ:

p50/p95/p99 po 'саҳм', 'триггер', 'пардохт';
сатҳи хатогӣ s tipami (5xx/4xx/business), тӯфонҳои такрорӣ, ақибмонии навбат;
'wallet. қарз 'таъхир/ok-rate; муноқишаи навсозии ҳавз.

Огоҳиҳо:

афзоиш 'пардохт. ноком '> X% аз рӯи бренд/минтақа,' pool _ size '> cap - Y% вақт (хатои конфигуратсия), гузариш байни' pool _ size 'ва маблағи саҳми мусолиҳа> Z ppm.

11) Бисёрҳуҷрагӣ ва ҷудоӣ

Ҳама дархостҳо ва чорабиниҳо 'иҷорагир _ id/brand _ id/license/минтақа' қайд карда шудаанд.

Ҳавзҳои маҳаллӣ/шабакавӣ аз рӯи литсензияҳо/минтақаҳои гуногун аз ҷиҳати ҷисмонӣ ҷудо карда мешаванд (DB/кластер).

Амнияти сатр (RLS) ва ниқоб дар мағозаҳои BI.

Калидҳои инфиродӣ/асрҳо ва фазои схемавӣ барои як бренд/минтақа.

12) Ҳамгироӣ бо мукофотпулӣ/мусобиқаҳо

Ҳиссагузорӣ vager-ро мустақиман зиёд намекунад; саҳм ба бонус - на аз саҳм, балки аз Бет меояд.

Мусобиқаҳо метавонанд барои "иштироки JP" ё "саҳми боло" холҳо диҳанд. "Манбаъ - jp. саҳм. сабт 'i' jp. триггер '.

Қоидаи ҳатмӣ: Механикаи Jackpot RTP-и асосии бозиро тағир намедиҳад; вагарна сертификатсияи алоҳида лозим аст.

13) Таҷрибаҳои озмоишӣ ва бетартибӣ

Санҷишҳои шартномавӣ RGS↔JP↔koshelyok: таҳвили дукарата, таъхирҳо, фармоишӣ, бознишастагӣ.

Санҷишҳои сарборӣ: тӯфони гаравҳо ва триггерҳо, миқёси кормандони ҳавз.

Машқҳои бетартибӣ: суқути минтақаи JP, ҳамёни офлайнӣ, desynchronization вақт; қуттиҳо ва таназзулро тафтиш кунед (триггерҳои таваққуф/саҳмҳои нав нестанд).

14) Рӯйхати санҷишҳо

Барои Студия/RGS

Саҳми 'Idempotent' ва дуруст 'round _ id '/' bet _ id'.
Ягон нашрия муомилотро "сарфи назар намекунад" (танҳо outbox/CDC).
Санҷишҳои такрорӣ/триггерҳо/ҷубронҳои такрорӣ.
ҳадди ниҳоии Бет/тахассус ба JP гузаронида мешавад.

Барои оператор/платформа

Китобча манбаи ҳақиқат аст, 'ҳамён. қарз 'бо ихтисор кардан.
Истгоҳҳои RG/AML бо маош коркард мешаванд; Дар ин бора SAR/STR хабар медиҳад.
p95 'trigger → credit' панели панелҳо, меъёри хатогӣ, мусолиҳаи ҳавзҳо.

Барои соҳиби JP

Санҷиши WORM аз тағиротҳои формула/насл/лимит.
Схемаҳои чорабиниҳо дар Феҳрист ва версия.
DR: RPO ≤ 5 дақ, RTO ≤ 30 дақ; машқҳои мунтазам.
RLS/ҷудокунӣ аз рӯи бренд/литсензия; калидҳо/асрори як минтақа.

15) Парчамҳои сурх (зидди намунаҳо)

Таҳрири дастии андозаҳо ва пардохтҳо дар пойгоҳи додаҳо.

Набудани idempotence → қарзҳои такрорӣ.

Интишори телеметрия бидуни outbox/CDC → саҳмҳо/триггерҳои "гумшуда".

Омезиши PII ва маълумоти пулии минтақаҳои гуногун.

Jackpot, ки ба RTP бозии асосӣ бе сертификатсияи нав таъсир мерасонад.

Оштии ҳамён ва ҳавз нест; гузоришҳо ба муборизаи OLTP асос ёфтаанд.

Системаҳои Jackpot API шартномаи чорабинии пулӣ байни студия, платформа ва оператор мебошад. Таҳкурсии он: idempotence ва sagas, ҷудокунии қатъии пул, нақшаҳои возеҳи рӯйдодҳо, аудити амният ва WORM, мушоҳида ва SLO. Дар ин тарҳ, ҳавзҳои ислоҳкунӣ/прогрессивӣ ва шабакавӣ пешгӯӣ карда мешаванд, пардохтҳо дуруст боқӣ мемонанд ва ҳисоботи танзимкунанда ва тиҷорӣ шаффоф ва боэътимод мебошанд.