implementation-plan-consistency-fixes.md 6.0 KB
实施计划：需求文档一致性修正
基于
v20260604.5决策（直接邀请统一40%、间接邀请10积分、种子价无创始人码限制），对现有文档进行一致性修正。
状态：草稿，待用户确认后执行
修改清单总览
| # | 优先级 | 修改文件 | 修改位置 | 修改类型 | 风险 |
|---|---|---|---|---|---|
| 1 | ⭐⭐⭐ | docs/phase1-user-stories.md |
US-4.2 第417-420行 + 第1402-1415行 | 种子价条件：创始人码→时间/名额 | 中（影响定价逻辑文档） |
| 2 | ⭐⭐ | docs/distribution-model-v2.md |
第140行（删除空壳标题） + 触发事件表 | 章节去重 + 种子价分佣澄清 | 低 |
| 3 | ⭐ | docs/system-spec.md |
全局搜索旧比例15%/18% | 比例统一为40% | 低 |
修改 1：种子价分佣条件（phase1-user-stories.md）
1.1 US-4.2 验收标准（第417-420行）
当前内容：
2. `isSeedPrice = true` 需**同时满足三重条件**：
- **条件① 注册渠道**：用户的直接推荐人（`invitedBy`）是创始人（`invitedBy IS NULL AND vipType='practitioner'`）的自然注册用户（无推荐人，`invitedBy IS NULL`）**不享受种子价**
- **条件② 有效期**：当前时间 ≤ `sys_config.pricing.practitioner.seed_period_end`（种子价有效期截止时间）
- **条件③ 名额**：已通过创始人码付费的能量师记录数 < `sys_config.pricing.practitioner.seed_limit`（默认 300）
修改为：
2. `isSeedPrice = true` 需**同时满足两个条件**：
- **条件① 有效期**：当前时间 ≤ `sys_config.pricing.practitioner.seed_period_end`（种子价有效期截止时间）
- **条件② 名额**：已以种子价付费的能量师记录数 < `sys_config.pricing.practitioner.seed_limit`（默认 300）
影响行号： 417, 418, 420（删除条件①，条件②③顺位为①②）
1.2 API响应字段说明（第1402-1415行）
当前内容（第1402-1403行）：
"isSeedPrice": true, // 当前用户是否能享受种子价（三重条件判断）
"seedReason": "eligible", // "eligible"=三条件均满足 | "not_founder_code"=非创始人码 | "expired"=有效期已过 | "quota_full"=名额已满 | "no_referrer"=无推荐人（自然注册）
修改为：
"isSeedPrice": true, // 当前用户是否能享受种子价（时间+名额双条件判断）
"seedReason": "eligible", // "eligible"=双条件均满足 | "expired"=有效期已过 | "quota_full"=名额已满
影响行号： 1402, 1403, 1412-1415（删除"非创始人码"和"无推荐人"相关说明）
1.3 种子会员定义（第408-412行，可选修改）
当前内容：
种子会员 = 通过扫描**创始人码**注册并付费成为能量师的用户。创始人码 = **没有推荐人的能量师**（`invitedBy IS NULL` 且 `vipType='practitioner'`）的推广码。
修改为：
种子会员 = 在种子价**有效期内**且**名额未满**时，以种子价（¥1,314）付费成为能量师的用户。
影响行号： 408-412（删除创始人码定义段落）
修改 2：分销文档章节去重 + 种子价分佣澄清
2.1 删除空壳标题（第140行）
当前内容：
140: ## 五、与现有 sys_config 的对应关系
141: （空行）
142: ## 五、与旧体系对比
修改： 删除第140行，保留"## 五、与旧体系对比"
2.2 触发事件表增加种子价备注（第42-50行）
当前内容：
| 购买 能量师 ¥1,314+ | 40% 佣金（¥525.60） | 10 积分 | ✅（能量师的直接上级拿佣金，能量师自己的团队拿分红） |
修改为：
| 购买 能量师 ¥1,314+ | 40% 佣金（¥525.60） | 10 积分 | ✅（能量师的直接上级拿佣金，能量师自己的团队拿分红） |
> **种子价用户分佣说明**：以种子价（¥1,314）购买的能量师同样享受 40% 直接邀请佣金，不受创始人码限制。
影响行号： 在表后新增备注段落
修改 3：system-spec.md 比例统一（可选，低优先级）
3.1 全局搜索旧比例
搜索模式： 15%|18%|20%（排除 changelog 和历史记录）
预期命中位置：
- 分销佣金对比表
- 角色权限矩阵（如有独立于 phase1-user-stories.md 的版本）
修改为： 所有一级佣金统一为 40%
验证方法： grep -n "15%\|18%\|20%" docs/system-spec.md
实施顺序
1. 修改 1.1（US-4.2 条件） — 快（单次 edit）
2. 修改 1.2（API字段说明） — 快（单次 edit）
3. 修改 2.1（删除空标题） — 快（单次 edit）
4. 修改 2.2（触发事件备注） — 快（单次 edit）
5. 修改 3.1（system-spec 比例） — 中（需确认命中位置）
6. 全部修改完成后统一 commit
预计总耗时： 10-15分钟（不含 review）
验证方法
文档一致性检查：
grep -n "创始人码" docs/phase1-user-stories.md # 应无命中 grep -n "三重条件" docs/phase1-user-stories.md # 应无命中 grep -n "与现有 sys_config 的对应关系" docs/distribution-model-v2.md # 应无命中（已删除）逻辑一致性检查：
isSeedPrice条件数量：文档中应只出现"两个条件"- 触发事件表中能量师价格：应出现种子价备注
- 直接邀请佣金：全文应统一为 40%
渲染检查：
- 确认
distribution-model-v2.md目录层级无重复（只有"## 五、与旧体系对比"）
- 确认
回滚方案
若修改后发现问题，通过 git 回滚：
git revert <commit-hash>
单文件回滚：
git checkout HEAD~1 -- docs/phase1-user-stories.md
git checkout HEAD~1 -- docs/distribution-model-v2.md
备注
- 修改 1.3（种子会员定义）为可选修改，不影响后端逻辑，仅文档表述优化
- 修改 3.1（system-spec）需先确认实际命中位置，避免误改历史记录
- 本计划不涉及代码层修改，仅修正文档不一致