48 lines
3.4 KiB
Markdown
48 lines
3.4 KiB
Markdown
<!-- 3895e6da-dd34-4ce4-b39b-e1e4ccf1c60c -->
|
||
---
|
||
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` 不复活比例拆分）。 |