Files
cursor/plans/拆分win派奖文档_adbf09a1.plan.md
ray zhou f71a5c59af ok
2026-05-29 11:21:40 +08:00

2.7 KiB
Raw Blame History

name, overview, todos, isProject
name overview todos isProject
拆分win派奖文档 将 wallet PRD 中与 win派奖强相关的需求从主文档拆分到独立文档降低耦合并保持规则可追踪。计划默认采用“从 wallet.md 迁移到 win.md并在原处保留索引入口”的方式。
id content status
identify-win-sections 标记 wallet.md 中所有 win派奖主规则与引用依赖段落 completed
id content status
create-win-doc 创建 win.md 并迁移/重组派奖规则、流程与示例 completed
id content status
refactor-wallet-doc 在 wallet.md 用摘要+链接替换已迁移内容并更新目录 completed
id content status
consistency-pass 统一术语与交叉引用,确保无重复冲突定义 completed
false

将 win派奖需求拆分到独立文档

目标

doc/wallet.md 中“win派奖”相关需求整理到新文档 doc/win.md,并保证两份文档职责清晰:

  • wallet.md 保留钱包总规则与对外索引
  • win.md 承载派奖、Round 结算、出资分配等细则

拆分范围(默认)

doc/wallet.md 迁移以下“win 主体”内容到 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/win.md 的链接
    • 更新目录,新增 win 文档入口
  • doc/win.md
    • 新建“win派奖需求”专题文档
    • 按“背景 → 结算时序 → 分配规则 → 边界条件 → 示例流程”重组内容
    • 明确与 LotTaskWithdrawable 的关系保留必要术语一致性Round/FinalSettlement/AllocatedPayout

一致性与可维护性约束

  • 术语与口径与 doc/wallet.md 保持一致Bonus/Deposit/Withdrawable、Final Settlement、PlayedOut
  • 避免双份正文维护:同一规则只在一个文档定义,另一侧做引用
  • 若保留示例在两文档同时出现,仅保留“简版示意”在 wallet.md,完整口径放 win.md

验收标准

  • doc/win.md 可单独说明“派奖”完整业务规则
  • doc/wallet.md 删除/替换原 win 细节后仍可作为钱包总览
  • 两文档目录和交叉链接可直接跳转,且不存在明显冲突描述