ok

plans/拆分win派奖文档_adbf09a1.plan.md

@@ -0,0 +1,56 @@
+---
+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 细节后仍可作为钱包总览
+- 两文档目录和交叉链接可直接跳转，且不存在明显冲突描述