잭팟 API의 작동 방식

전체 기사

💡 18+. 재료는 재생을 요구하지 않고 엔지니어링에 적용됩니다. 용어: 플랫폼-PAM/지갑/현금 데스크/보너스/RG; RGS - 원격 게임 서버 (스튜디오 게임의 핵심); 애그리 게이터 - 다중 RGS를위한 통합 계층; JP-잭팟 서비스.

1) 잭팟 시스템이란 무엇이며 생태계에서 어디에 서 있습니까?

잭팟 시스템은 베팅에서 기부금을 모으고 풀을 관리하며 트리거를 획득하고 상품 배포를 계산하며 운영자의 지불 루프를 통해 지불을 시작하는 별도의 서비스 (때로는 서비스 클러스터) 입니다. 통합됩니다:

RGS (요율/결과 및 자격에 관한 메시지), 플랫폼/지갑 (기부 및 신용 상금 작성), 애그리 게이터 (많은 스튜디오/브랜드에서 라우팅), BI/레귤레이터 (원격 측정 및보고).

2) 잭팟의 종류 (및 API의 변경 사항)

1. 사전에 알려진 상금을 고정했습니다. API에는 풀이 없으며 조건 확인 및 크레딧 만 있습니다.

2. 프로그레시브: 수영장은 베팅 기여에서 자랍니다. 기여의 종점과 현재 규모의 출판이 필요합니다.

3. 멀티 티어 (멀티 티어: 미니/메이저/그랜드): 확률과 캡이 다른 여러 병렬 풀.

4. 로컬 vs 네트워크: 로컬 풀-하나의 운영자/브랜드; 네트워크-많은 운영자/브랜드/지역의 총계 (멀티 테넌시 및 복제가 중요합니다).

5. 시간/이벤트: 마감일 또는 일정에 따라 수영장 (타이머 및 자동 추첨이 필요함).

3) 통화 불변량

균형에 대한 진실의 원천은 플랫폼의 지갑/원장입니다. JP는 수영장과 부채 상태 만 저장합니다.

모든 머니 트랜잭션은 dempotent입니다 (키 'jp _ curve _ id', 'jp _ triker _ id', 'jp _ payout _ id').

분실/복제 결제 = 0. 보상 - 수동 데이터베이스 편집이 아닌 이벤트 (sagas) 에 의해서만.

자신의 원격 측정과의 독립형 거래로서 별도의 기여, 트리거 및 지불금.

4) API 참조 계약

4. 1 RGS/→ 애그리 게이터 JP (기여 및 트리거)

'POST/v1/jp/기여' -풀 기여 설명

json
{
"jp _ contrib _ id": "uIS-1", "tenent _ id": "brand-42", "pool _ id": "grand-eu-01", "player _ id": "p _ abc", "game _ id": 슬롯 _ 777, "" round _ id ":" r _ 123 "," bet ". 00, "통화": "EUR"}, "contrib": {"금액": 0. 02, "통화": "EUR"}, "arsed _ at": "2025-10-23T15: 12: 05Z", "dedempotency _ key": "round _ r _ 123"
}

'POST/v1/jp/plookers' -조건 참여/검증 신청 (선택 사항)

답: '적격: 참/거짓', 무게 또는 기회, 규칙.

'POST/v1/jp/triggers' -작동 사실 기록

json
{
"jp _ triker _ id": "uIS-2", "pool _ id": "grand-eu-01", "reason": "random _ hit", "selector": {"player _ id": "p _ abc", "round _ id": "r _ 123"} ", where _ at": "2025-10-23T15: 025", Z ", 012" demempotency _ key ":" jp _ t _ grand _ r _ 123 "
}

💡 참고: 일부 모델에서는 트리거가 JP 자체 (내부 룰렛) 에 의해 시작되며 RGS는 라운드 만보고합니다. 그런 다음 '트리거' 를 JP → platforma라고하며 RGS는 이벤트를 구독합니다.

4. 2 JP → 플랫폼 (지불/조항)

'POST/v1/지갑/예약' - (선택 사항) 향후 지불금 제공

'POST/v1/지갑/크레딧' -플레이어 승리 크레딧

json
{
"jp _ payout _ id": "uIS-3", "tenit _ id": "brand-42", "player _ id": "p _ abc", "pool _ id": "grand-eu-01", "amount": {"amount": 500000. 00, "통화": "EUR"}, "meta": {"tax": "production = ausy", "tier": "grand"}, "demempotency _ key": "jp _ p _ grand _ r _ 123"
}

플랫폼 응답: '신용. 확인	이유 코드 (RG/AML, 철회 제한, 제재, 지리 블록) 로 실패했습니다.

4. 3 게시 풀 상태 (앞/위젯의 경우)

'GET/v1/jp/pools/{ pool _ id}' → 현재 크기, 시드, 캡, 참가자 수, ETA 등

'GET/v1/jp/pools' → 필터가있는 브랜드/지역별 풀 목록.

5) 이벤트 모델 (Kafka/Pulsar) 및 다이어그램

기본 주제:

'jp. 기여. 녹음 됨 '
'jp. 수영장. 업데이트 '(크기, 경쟁 업데이트)
'jp. 트리거 '

'jp. 지불. 요청	신용	실패 '
'지갑. 신용. '(사가를위한 미러 링)
'rg. 한계. ',' aml. 경고. '(결제가 차단되면)
'감사. 설정. '변경 (한계, 종자, 모자, 분포)

계약: Avro/JSON Schema + Schema Registry, 참여 키 'tenant _ id', 'pool _ id', 'player _ id'. Versioning-역 호환.

6) 트리거 알고리즘 (높은 수준)

확률 (p-stable): 각 적격 라운드마다 풀/레벨 유형에 따라 확률 'p' 로 히트를 생성합니다.

범위 (필수 드롭): 풀은 캡섬 또는 마감일로 떨어져야합니다. [min, max] 범위의 내부 무작위를 유지하고 캡/ETA를 게시하십시오.

종자 및 엔트로피 관리: 서버 종자 + 라운드 당 소금; 클라이언트 잭팟 좌석 포기. 종자에 대한 모든 변경 사항은 WORM 감사하에 있습니다.

정직: 방아쇠는 플레이어의 특정 성격 (지리/라이센스/자격 규칙 제외) 에 의존해서는 안됩니다. 모든 "개인" 타겟팅은 금기입니다.

7) SLO 및 성능

p95 '기여' <120 ms, p99 <250 ms.

p95 '트리거 → 크레딧' <500 ms (외부 결제 홉 없음).

"분실/중복 지불" = 0 (계약 테스트로 확인).

BI 소 5 분으로의 이벤트 전달.

중요 경로에 대한 JP API 가용성은 99 이상입니다. 95%.

8) 안전 및 준수

모든 S2S의 mSL + 서명 (HMAC/EdUSA) 은 수명이 짧은 토큰을 호출합니다.

제로 트러스트: 네트워크 정책/메쉬, 최소 권한, 지역 별 세분화.

한계, 공식, 종자/엔트로피, 수영장 구성에 대한 변경 사항에 대한 WORM 감사.

GDPR/데이터 거주자/PCI: 지역의 PII 및 로그; 민감한 필드의 토큰 화; 지역 간 판독 금지.

RG/AML: 지불시 동기식 브레이크 라이트; SAR/STR 업로드가 자동화되었습니다.

9) 일관성과 사가

기여 ('기여') -JP에서 수정, 'jp. 기여. 녹음 '.

방아쇠 ('트리거') -의무를 만듭니다. JP는 '지불금' 을 시작합니다.

지불 ('지불. 요청 → 지갑. 신용. ok ') -사가를 끝내십시오. 가짜-중복 제거 된 retrai.

전송/CDC는 이벤트를 게시하는 유일한 방법입니다. "바이 패스" 로거가 없습니다.

10) 원격 측정 및 대시 보드

비즈니스:

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

기술:

p50/p95/p99 체 '기여', '트리거', '지불';
오류율이 높으면 (5xx/4xx/business), 폭풍 재시도, 대기열 지연;
'지갑. 신용 대기 시간/확률; 풀 업데이트 충돌.

경고:

성장 지불. 브랜드/지역별 '> X%' 풀 _ 크기 '> 캡 - 시간의 Y% (구성 오류),' 풀 _ 크기 '와 조정 기여 금액> Z ppm 사이의 드리프트.

11) 다중 임대 및 격리

모든 요청 및 이벤트에는 '테넌트 _ id/브랜드 _ id/라이센스/지역' 이 표시됩니다.

로컬/네트워크 풀은 라이센스/지역마다 물리적으로 분리되어 있습니다 (DB/클러스터).

행 레벨 보안 (RLS) 및 BI 상점에서의 마스킹.

브랜드/지역당 개별 키/비밀 및 회로도 공간.

12) 보너스/토너먼트와의 통합

기여는 베이거를 직접 증가시키지 않습니다. 보너스에 대한 기여-기부금이 아니라 내기에서 나옵니다.

토너먼트는 "JP 참여" 또는 "최고 기여" 에 대한 포인트를 부여 할 수 있습니다. "출처-이벤트 jp. 기여. nbsp; nbsp; 트리거 '.

필수 규칙: 대박 역학은 게임의 기본 RTP를 변경하지 않습니다. 그렇지 않으면 별도의 인증이 필요합니

13) 테스트 및 혼돈 관행

계약 테스트 RGS 얼마 안되는 코셀리크: 이중 전달, 지연, 주문 외 롤백.

로드 테스트: 베팅 및 트리거의 폭풍, 풀 작업자 확장.

혼돈 운동: JP 지역의 몰락, 오프라인 지갑, 시간 비동기화; 아웃 박스 및 저하를 확인하십시오 (일시 중지 트리거/새로운 기여 없음).

14) 점검표

Studio/RGS 용

이념적 인 '기여' 와 올바른 'round _ id '/' bet _ id'.
"우회" 트랜잭션 (아웃 박스/CDC 만 해당) 출판물이 없습니다.
중복/반복 트리거/보상 테스트.
최대 베팅/자격 제한이 JP로 이전됩니다.

운영자/플랫폼

원장은 진실의 원천입니다. '지갑. 중복 제거로 신용 '.
RG/AML 정류장은 유료로 처리됩니다. SAR/STR 보고서.
p95 'trike → credit' 대시 보드, 오류율, 풀 조정.

JP 소유자의 경우

공식/종자/제한 변경에 대한 WORM 감사.
레지스트리 및 버전의 이벤트 스키마.
DR: RPO 규칙적인 운동.
브랜드/라이센스에 의한 RLS/격리; 지역당 키/비밀.

15) 적색 플래그 (패턴 방지)

데이터베이스의 풀 크기 및 결제에 대한 수동 편집.

demmpotence의 부족 → 중복 대출.

Outbox/CDC → "잃어버린" 기여/트리거없이 원격 측정을 게시합니다.

다른 지역의 PII 및 통화 데이터 혼합.

새로운 인증없이 기본 게임의 RTP에 영향을 미치는 대박.

지갑과 수영장 조정이 없습니다. 보고서는 전투 OLTP를 기반으로합니다.

Jackpot 시스템 API는 스튜디오, 플랫폼 및 운영자 간의 통화 이벤트 계약입니다. 그 기초: dempotence와 sagas, 엄격한 돈 격리, 명확한 이벤트 체계, 보안 및 WORM 감사, 관찰 및 SLO. 이 설계에서 수정/진보 및 네트워크 풀은 예상대로 확장되며 지불은 정확하게 유지되며 규제 및 비즈니스보고는 투명하고 신뢰할 수 있습니다.