|
|
@@ -0,0 +1,177 @@
|
|
|
+# 实施计划：需求文档一致性修正
|
|
|
+
|
|
|
+> 基于 `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行）：**
|
|
|
+```json
|
|
|
+"isSeedPrice": true, // 当前用户是否能享受种子价（三重条件判断）
|
|
|
+"seedReason": "eligible", // "eligible"=三条件均满足 | "not_founder_code"=非创始人码 | "expired"=有效期已过 | "quota_full"=名额已满 | "no_referrer"=无推荐人（自然注册）
|
|
|
+```
|
|
|
+
|
|
|
+**修改为：**
|
|
|
+```json
|
|
|
+"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）
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 验证方法
|
|
|
+
|
|
|
+1. **文档一致性检查：**
|
|
|
+ ```bash
|
|
|
+ grep -n "创始人码" docs/phase1-user-stories.md # 应无命中
|
|
|
+ grep -n "三重条件" docs/phase1-user-stories.md # 应无命中
|
|
|
+ grep -n "与现有 sys_config 的对应关系" docs/distribution-model-v2.md # 应无命中（已删除）
|
|
|
+ ```
|
|
|
+
|
|
|
+2. **逻辑一致性检查：**
|
|
|
+ - `isSeedPrice` 条件数量：文档中应只出现"两个条件"
|
|
|
+ - 触发事件表中能量师价格：应出现种子价备注
|
|
|
+ - 直接邀请佣金：全文应统一为 40%
|
|
|
+
|
|
|
+3. **渲染检查：**
|
|
|
+ - 确认 `distribution-model-v2.md` 目录层级无重复（只有"## 五、与旧体系对比"）
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 回滚方案
|
|
|
+
|
|
|
+若修改后发现问题，通过 git 回滚：
|
|
|
+```bash
|
|
|
+git revert <commit-hash>
|
|
|
+```
|
|
|
+
|
|
|
+单文件回滚：
|
|
|
+```bash
|
|
|
+git checkout HEAD~1 -- docs/phase1-user-stories.md
|
|
|
+git checkout HEAD~1 -- docs/distribution-model-v2.md
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 备注
|
|
|
+
|
|
|
+- 修改 1.3（种子会员定义）为可选修改，不影响后端逻辑，仅文档表述优化
|
|
|
+- 修改 3.1（system-spec）需先确认实际命中位置，避免误改历史记录
|
|
|
+- 本计划不涉及代码层修改，仅修正文档不一致
|
