Daebak Platform · Wallet / Rolling

지갑 · 롤링 · Rebate 설정 미리보기

한국어 이름 + (영문 필드명) 기준으로 한 페이지에서 값을 확인·입력하는 UI 시뮬레이터입니다. 현재는 실제 서버 설정에는 적용되지 않습니다.

Scope · game_server / wallet_server / web_server / admin_server

Mode · UI-only (백엔드 미연결)

Wallet

Rolling

Bonus / Coupon

Rebate / Cashback

일반지갑 결산 시뮬레이터 (普通钱包 Settlement)

BTi/BT1 · Digitain 공급사별 单注/串子 결산 로직을 실시간으로 테스트합니다. (普通钱包0315.md 기반, 2026.03.14 업데이트)

Interactive Sim

▶ 결산 시뮬레이션 입력

공급사 (Provider)

폴더 유형

최종 폴더 상태

배팅금 (BetAmount)

적중금 (WinAmount)

초기 일반지갑 잔액

초기 출금가능지갑 잔액

경기별 상태 · 배당 설정

경기 1

상태 대조표 (BTi/BT1 vs Digitain)

BTi/BT1	Digitain	설명	유효배당 처리
Won	Won	승리	원래 배당 그대로
Lost	Lost	패배	판단 불필요
Half Won	Half-Win	반승 (유효배당 = (배당+1)/2)	`(odds + 1) / 2`
Half Lost	Half-Return	반패 → 적중금 일반지갑	0.5 고정
Draw	—	평국 → 일반지갑 반환	판단 불필요
Canceled	Canceled	취소 → 일반지갑 반환	판단 불필요
Cashout	Cashout	조기결산	금액 비교
—	Return	퇴환 → 일반지갑 반환	판단 불필요
—	Rejected	거절 → 일반지갑 반환	판단 불필요

▶ 핵심 규칙 요약

• 유효배당 ≥ 1.50 → 적중금 전액 출금가능지갑으로 이동

• 유효배당 < 1.50 → 배팅금 일반지갑 반환, 이익(적중금-배팅금)만 출금가능지갑으로

• 취소/평국/퇴환류 (Draw, Canceled, Return, Rejected) → 적중금 일반지갑 반환

• 캐시아웃 → 적중금 < 배팅금이면 일반지갑 반환 / 적중금 > 배팅금이면 이익만 출금가능지갑

• 串子 배당 → 각 경기 유효배당의 곱 (Canceled/Draw/Return은 ×1, Half Won → (odds+1)/2, Half Lost → 0.5)

주요 설정값 (GlobalVar / env 기반)

실제 시스템에서 이미 변수로 관리 중인 값들을 한 곳에서 확인하고 가상으로 수정해볼 수 있습니다.

Config backed

설정 항목 (필드명)	단위	Source	설명
스포츠 유효 배당 기준 (odds_limit)	배당	env	dev: 1.3 / stg·prod: 1.5. 이 값 이상일 때만 유효 배팅·Rolling·Rebate 로 인정.
Lossback 최소 배당 (LOSSBACK_ODDS_MIN)	배당	GlobalVar	손실보너스(Lossback) 적용을 위한 최소 배당.
Live 리베이트 최소 베팅 (REBATE_LIVE_MIN_BET)	KRW	GlobalVar	Live 게임 Rebate 산정 시 필요한 최소 regular_bet.
Slots 리베이트 최소 베팅 (REBATE_SLOTS_MIN_BET)	KRW	GlobalVar	Slots 게임 Rebate 산정 시 필요한 최소 regular_bet.
Sports 리베이트 최소 베팅 (REBATE_SPORTS_MIN_BET)	KRW	GlobalVar	스포츠 Rebate 산정 시 필요한 최소 regular_bet.
Rebate 전환 롤링 모드 (REBATE_ROLLING)	-	GlobalVar	Rebate → 지갑 전환 시 Balance 롤링을 생성할지 여부.
Rebate 전환 최소 금액 (REBATE_TRANSFER_MIN)	KRW	GlobalVar	Rebate → Balance/Cash 전환이 가능한 최소 금액.
Cashback 최소 손실 금액 (CASHBACK_MIN_LOSE)	KRW	GlobalVar	이 손실 금액 이상일 때만 Cashback을 지급.
Cashback 일일 최대 지급액 (CASHBACK_MAX_SEND_DAILY)	KRW	GlobalVar	하루에 한 플레이어에게 지급 가능한 Cashback 상한.
입금 최소/최대 금액 (PLAYER_DEPOSIT_AMOUNT_MIN/MAX)	KRW	GlobalVar	플레이어 단일 입금 한도 (최소/최대).
출금 최소/최대 금액 (PLAYER_WITHDRAW_AMOUNT_MIN/MAX)	KRW	GlobalVar	플레이어 단일 출금 한도 (최소/최대).

하드코딩 값 · 제안 변수

현재는 코드 상수이지만 GlobalVar로 빼면 좋을 후보들을 UI 상에서 미리 설계합니다.

UI-only · Hard-coded

1) 보너스 · 쿠폰 롤링 정리 규칙

잔액이 특정 값 미만일 때 Rolling 을 자동 정리하는 기준입니다. 현재는 코드에 직접 박혀 있습니다.

설정 항목 (필드명)	값 (입력 가능)	Source	비고
쿠폰 롤링 정리 임계값 (COUPON_ROLLING_PURGE_THRESHOLD)		HardCoded	현재: `1000` 하드코딩. 쿠폰 < 임계값 이고 미완료 스포츠 없음 → coupon rolling 종료.
보너스 롤링 정리 임계값 (BONUS_ROLLING_PURGE_THRESHOLD)		HardCoded	현재: `5000` 하드코딩. 보너스 < 임계값, 미완료 스포츠 없음 → bonus rolling 종료.

2) 미롤링 배당 수신 지갑 정책

Rolling 이 없는 Balance 베팅의 배당을 어느 지갑으로 보낼지에 대한 정책입니다.

설정 항목 (필드명)	값 (입력 가능)	Source	메모
미롤링 배당 수신 지갑 타입 (UNROLLED_PAYOUT_TARGET_WALLET)		HardCoded	현재 구현: `payout_balance > 0 → new_cash += payout_balance` 로 Cash 고정.

3) 상태 집합 (Rolling / Rebate 필터)

어떤 경기 상태를 Rolling·Rebate 계산에서 제외/포함할지에 대한 현재 코드 상수입니다.

사용처	상태 집합 (편집 가능)	Source
스포츠 Rolling 제외 상태 (sports_no_rolling_statuses)		HardCoded
Rebate 무효 상태 (invalid_status)		HardCoded
BTI/BT1 Rebate 유효 상태 (default_valid_status)		HardCoded
Digitain Rebate 유효 상태 (digitain_valid_status)		HardCoded

4) Provider 별 기본 한도

일부 Provider 의 최소/최대 베팅금이 콜백 XML/코드에 고정되어 있습니다.

Provider 설정 (필드명)	값 (입력 가능)	단위	Source
BTI 최소/최대 베팅금 (BTI_MIN_BET / BTI_MAX_BET)		KRW	HardCoded (XML)
BT1 최소/최대 베팅금 (BT1_MIN_BET / BT1_MAX_BET)		KRW	HardCoded (XML)

5) Rebate / Cashback / Rolling 설정 (항목별 상세)

각 보상 시스템의 세부 조건을 항목별로 확인/수정할 수 있습니다.

▶ Live / Slots Rebate

rebate_settle()

항목	설정	상태	비고
기준 금액 공식	`regular_bet = bet_all - coupon - bonus`	전체적용	Balance + Cash 만 포함
산출 공식	`round(regular_bet x percent / 100)`	전체적용	Python round (반올림)
Balance 지갑		포함	regular_bet 기준에 포함
Cash 지갑		포함	regular_bet 기준에 포함
Bonus 지갑		제외	bet_bonus 차감됨
Coupon 지갑		제외	bet_coupon 차감됨
Live 최소 베팅		GlobalVar	REBATE_LIVE_MIN_BET
Slots 최소 베팅		GlobalVar	REBATE_SLOTS_MIN_BET
Live payout 감산		개별적용	Live만 해당. Slots는 무조건 전액
Slots payout 감산		미적용	Slots는 payout 무관 전액 인정
지급 지갑		고정	Rebate 지갑에 적립 후 전환

▶ Sports Rebate

record_sports_rebate()

항목	설정	상태	비고
기준 금액	`valid_bet` (Bonus/Coupon 제외)	전체적용	odds >= limit 일 때만 인정
산출 공식	`int(valid_bet x day_percent / 100)`	전체적용	int 절사 (반올림 아님)
최소 배당 기준		env	odds_limit (dev:1.3 / prod:1.5)
Sports 최소 베팅		GlobalVar	REBATE_SPORTS_MIN_BET
BTI/BT1 유효 상태		HardCoded	Opened 존재 시 전체 스킵
Digitain 유효 상태		HardCoded	Opened 허용, Half Lost 제외
BTI Opened 미결산		제외	BTI/BT1 전용 규칙
HalfWon 배당 보정	`(odds + 1) / 2` 2자리 절사	적용	Rebate용 재계산
HalfLost 배당 보정	고정	적용	Rebate용 재계산
HalfReturn 배당 보정	고정	적용	Rebate용 재계산
Config 매칭 방식	`odds <= eff AND parlay <= eff -> max`	전체적용	최대 매칭 config 선택
기록 시점		고정	일일 정산에서 합산
지급 지갑		고정	Rebate 지갑에 적립 후 전환

▶ Sports 배당 재계산 (Rolling vs Rebate 차이)

주의

비교 항목	Rolling 재계산	Rebate 재계산	차이점
Opened 포함		BTI: Digitain:	BTI Opened: Rolling 포함, Rebate 스킵
HalfWon 처리			동일 베팅 유효배당 차이 발생
HalfLost 처리	고정	고정	동일
HalfReturn 처리			Rolling != Rebate
기타 상태 절사			동일 (ROUND_DOWN)

▶ Cashback

cashback_settle()

항목	설정	상태	비고
손실 공식	`loss = deposit - withdraw - balance`	전체적용	모든 지갑 잔액 포함
산출 공식	`min(loss x percent / 100, max_daily)`	전체적용	일일 최대 한도 적용
Balance 잔액		포함	current_balance에 포함
Cash 잔액		포함	current_balance에 포함
Sports Bonus 잔액		포함	current_balance에 포함
Live/Slots Bonus 잔액		포함	current_balance에 포함
Coupon 잔액		포함	current_balance에 포함
최소 손실 금액		GlobalVar	CASHBACK_MIN_LOSE
일일 최대 지급액		GlobalVar	CASHBACK_MAX_SEND_DAILY
지급 지갑		고정	Rebate 지갑에 적립 후 전환

▶ Rolling 증가 (Rolling Increment)

settle_extra() / rolling_update.py

항목	설정	상태	비고
Rolling 대상 금액	`bet_bonus + bet_coupon`	전체적용	보너스/쿠폰 금액만 Rolling 증가
Live 적용 조건		개별적용	Win/Loss 외 상태는 Rolling 불증가
Slots 적용 조건		개별적용	제외 상태가 아니면 모두 Rolling 증가
Sports 적용 조건		개별적용	아래 제외 상태 참조
Sports 제외 상태		HardCoded	sports_no_rolling_statuses
Cashout 시 Rolling		제외	is_cashout == True 시 중단
Resettle 시 Rolling		제외	is_resettle == True 시 중단
HalfWon/Lost/Return		전체적용	Rolling 측에서는 가중치 없음

▶ 정산 스케줄 (Settlement Schedule)

schedule_daily()

항목	설정	상태	비고
일일 정산 시간		적용	무조건 실행
주간 정산		적용	weekday() == 0
월간 정산	일	적용	day == 1
Sports 누적 초기화		적용	PlayerRebateSports clear()
Rebate 전환 모드		GlobalVar	REBATE_ROLLING
전환 최소 금액		GlobalVar	REBATE_TRANSFER_MIN

6) 지갑별 포함/제외 요약 (Rebate · Rolling · 손실)

각 지갑이 Rebate 기준 금액, Rolling 증가, 손실(Cashback) 계산에 어떻게 영향을 주는지 현재 로직을 기준으로 정리했습니다.

지갑	Rebate 기준 금액에 포함?	Rolling 증가에 사용?	손실(Cashback) 계산에 영향?
일반 지갑 (Balance)	✅ `regular_bet = bet_all - coupon - bonus` 기준에 포함	✅ Deposit/Event/Coupon/Rebate Rolling 의 베이스	✅ 입금/출금/현재 잔액이 모두 손실 계산에 포함
출금 지갑 (Cash)	✅ Balance 와 함께 regular_bet 기준에 포함	⚠ 미롤링 금액의 배당은 Cash 로 직행	✅ 잔액/출금 내역이 손실 계산에 포함
스포츠 보너스 지갑 (SportsBonus)	❌ 항상 제외	✅ `bet_bonus_amount` 로 Event Rolling 증가	✅ 현재 잔액이 손실 계산에 포함
Live/Slots 보너스 지갑 (LiveSlotsBonus)	❌ Rebate 기준에서 제외	✅ Live/Slots 보너스 Rolling 에 사용	✅ 잔액이 손실 계산에 포함
쿠폰 지갑 (Coupon)	❌ Rebate 기준에서 제외	✅ Coupon Rolling 증가	✅ 잔액이 손실 계산에 포함
Rebate 지갑 (Rebate)	– (결과 적립 지갑)	❌ 자체로 Rolling 증가 안 함 (전환 시 Balance 쪽 Rolling 생성 가능)	✅ 잔액이 손실 계산에 포함

※ 이 페이지는 구조 설계 및 값 조정 시뮬레이션용입니다. 입력한 값은 서버 설정(GlobalVar, env, 코드)에는 적용되지 않으며, 추후 BO 설정 페이지 구현 시 이 구조를 참고해 실제 API 와 연결하면 됩니다.