56 lines
2.7 KiB
Markdown
56 lines
2.7 KiB
Markdown
---
|
||
name: 拆分win派奖文档
|
||
overview: 将 wallet PRD 中与 win（派奖）强相关的需求从主文档拆分到独立文档，降低耦合并保持规则可追踪。计划默认采用“从 wallet.md 迁移到 win.md，并在原处保留索引入口”的方式。
|
||
todos:
|
||
- id: identify-win-sections
|
||
content: 标记 wallet.md 中所有 win（派奖）主规则与引用依赖段落
|
||
status: completed
|
||
- id: create-win-doc
|
||
content: 创建 win.md 并迁移/重组派奖规则、流程与示例
|
||
status: completed
|
||
- id: refactor-wallet-doc
|
||
content: 在 wallet.md 用摘要+链接替换已迁移内容并更新目录
|
||
status: completed
|
||
- id: consistency-pass
|
||
content: 统一术语与交叉引用，确保无重复冲突定义
|
||
status: completed
|
||
isProject: false
|
||
---
|
||
|
||
# 将 win（派奖）需求拆分到独立文档
|
||
|
||
## 目标
|
||
把 [doc/wallet.md](doc/wallet.md) 中“win（派奖）”相关需求整理到新文档 [doc/win.md](doc/win.md)，并保证两份文档职责清晰：
|
||
- `wallet.md` 保留钱包总规则与对外索引
|
||
- `win.md` 承载派奖、Round 结算、出资分配等细则
|
||
|
||
## 拆分范围（默认）
|
||
从 [doc/wallet.md](doc/wallet.md) 迁移以下“win 主体”内容到 [doc/win.md](doc/win.md)：
|
||
- §12 `Slots 多次派奖与最终结算规则`
|
||
- §20 中 win 强相关子流程：
|
||
- `20.4 Round 多次派奖`
|
||
- `20.5 Round 最终结算`
|
||
- 与派奖直接相关且需避免重复维护的规则片段（在 `wallet.md` 中改为引用）：
|
||
- §10.3 `派奖归属规则`
|
||
- §11 中 `Round 总派奖` 分配示例
|
||
- §16.2 `派奖按比例拆分余数`
|
||
|
||
## 文档结构调整
|
||
- 在 [doc/wallet.md](doc/wallet.md)：
|
||
- 保留“钱包主规则”定位
|
||
- 将迁移段落替换为简要摘要 + 指向 [doc/win.md](doc/win.md) 的链接
|
||
- 更新目录，新增 `win` 文档入口
|
||
- 在 [doc/win.md](doc/win.md)：
|
||
- 新建“win（派奖）需求”专题文档
|
||
- 按“背景 → 结算时序 → 分配规则 → 边界条件 → 示例流程”重组内容
|
||
- 明确与 `Lot`、`Task`、`Withdrawable` 的关系，保留必要术语一致性（Round/FinalSettlement/AllocatedPayout）
|
||
|
||
## 一致性与可维护性约束
|
||
- 术语与口径与 [doc/wallet.md](doc/wallet.md) 保持一致（Bonus/Deposit/Withdrawable、Final Settlement、PlayedOut）
|
||
- 避免双份正文维护：同一规则只在一个文档定义，另一侧做引用
|
||
- 若保留示例在两文档同时出现，仅保留“简版示意”在 `wallet.md`，完整口径放 `win.md`
|
||
|
||
## 验收标准
|
||
- [doc/win.md](doc/win.md) 可单独说明“派奖”完整业务规则
|
||
- [doc/wallet.md](doc/wallet.md) 删除/替换原 win 细节后仍可作为钱包总览
|
||
- 两文档目录和交叉链接可直接跳转，且不存在明显冲突描述 |