--- 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](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_detail` JSON、§18 回滚不做。 - Q4「下线 win 状态路由与比例拆分」结论不变（命中 Bonus 记 `frozen_bonus` 不复活比例拆分）。