3.4 KiB
3.4 KiB
todos:
- id: "sec2-4" content: "改 §2 差异 bullet 与 §4.1：deposit_balance/frozen_bonus 语义、不变量拆两条、移除差异 note、展示口径三桶" status: pending
- id: "sec5-6" content: "改 §5 对应关系补聚合桶映射；§6.1 入账改为 deposit_balance += 本金、frozen_bonus += bonus" status: pending
- id: "sec10-11" content: "改 §10.4 扣款分桶、§11.3 派奖按命中侧落 deposit_balance / frozen_bonus" status: pending
- id: "sec12-13" content: "改 §12 整组解锁拆 Deposit/Bonus 分桶转 Cash；§13.1 PlayedOut 表述" status: pending
- id: "sec15-19" content: "改 §15 Account 更新规则分桶、§16 不变量、§19 总结条款 2/3" status: pending isProject: false
钱包系统V2.md：恢复 frozen_bonus 分桶记账
仅修订 docs/requirements/钱包系统V2.md 中与"聚合余额落桶"相关的章节。打码组推进、消耗顺序、派奖命中归属、Completed/PlayedOut、fund_detail JSON、Redis 命中摘要等核心逻辑保持不变。
修订内容
- 三处不变量/语义：
deposit_balance = Σ 进行中 Deposit Lot.remaining；frozen_bonus ⊇ Σ 进行中组内 Bonus Lot.remaining（含 Trial/其它发奖，超集）。 - 派奖落桶：命中 Deposit →
deposit_balance += payout；命中 Bonus →frozen_bonus += payout。 - 整组解锁：
group_remaining拆 Deposit 侧（扣deposit_balance）+ Bonus 侧（扣frozen_bonus），合并进withdraw_balance（对应现网moveDepositToWithdraw+moveBonusToWithdraw）。 - 前端"锁定可玩/Locked Play"如需整体展示，须从 Lot/Group 聚合算组内 Bonus，不能直接取
frozen_bonus（默认口径：展示为 Locked Deposit + Bonus Credits 两项，可玩 = 三桶和）。
待改小节（逐节）
- 第 42 行 §2 差异 bullet：删除"充值 Bonus 进 deposit_balance"这条差异（改回后与现网一致）。
- §4.1：
deposit_balance语义改为"仅 Deposit 本金 + Deposit 侧派奖"；frozen_bonus语义改为"组内 Bonus + Trial 体验金 + 其它发奖"；不变量拆两条；移除第 120-121 行"与现网差异"note；展示口径调整为三桶。 - §5 对应关系：补注聚合桶映射（Deposit 侧→
deposit_balance、Bonus 侧→frozen_bonus）。 - §6.1：改为
deposit_balance += 100、frozen_bonus += 50；删除"不更新 frozen_bonus"与差异 note。 - §10.4：扣款分桶改为 扣 Deposit Lot→
deposit_balance--、扣 Bonus Lot→frozen_bonus--、扣 Cash→withdraw_balance--。 - §11.3：命中 Deposit→
deposit_balance += payout、命中 Bonus→frozen_bonus += payout（各自累加对应 Lot remaining）。 - §12 打码完成：
group_remaining拆 Deposit/Bonus 分桶扣减后合并进withdraw_balance。 - §13.1 PlayedOut：Bonus Lot 置 PlayedOut 时
frozen_bonus对应部分已为 0，无需额外扣。 - §15 Account 更新规则：15.1 / 15.2 / 15.4 / 15.6 改为分桶表述。
- §16 不变量、§19 总结条款 2、3：同步为分桶口径。
不改动
- §9 局生命周期、§10.1-10.3 进度归属与扣款顺序、§11.1-11.2 命中归属与终态降级、§4.4
fund_detailJSON、§18 回滚不做。 - Q4「下线 win 状态路由与比例拆分」结论不变（命中 Bonus 记
frozen_bonus不复活比例拆分）。