# 统一实施计划 — Phase 1 收尾 + Phase 2 启动

> **版本:** v1.0
> **日期:** 2026-07-21
> **基于:** PROJECT-OVERVIEW.md v1.1 审计校准
> **状态:** 待审批

---

## 一、审计验证结论

### 1.1 验证方法
- 4 个并行 explore 代理扫描前后端代码
- 直接读取 PROJECT-OVERVIEW.md 中每个 🚧/🟡 功能的关联代码
- 50 个 plans/ 文档逐一核实

### 1.2 验证结果汇总

| 分类 | 数量 | 说明 |
|------|------|------|
| ✅ 实际已完成（文档仍标 🚧/🟡） | 12 | 需更新 PROJECT-OVERVIEW.md |
| ⚠️ 部分完成（有后端无前端 / 有前端无后端） | 4 | 需补齐缺口 |
| 🚧 Phase 1 真正未完成 | 5 | 需实施 |
| ⏳ Phase 2 待开发 | 4 | 需规划 |
| ⏳ Phase 3-4 待开发 | 5 | 需规划（不在本计划范围） |

### 1.3 需降级为 ✅ 的功能（12项）

| # | 功能 | 当前标记 | 实际状态 | 证据 |
|---|------|---------|---------|------|
| 1 | 富沛（我的）页面重构 | 🟡 设计稿 | ✅ 已完成 | profile/ 6组件 1338行，git `d6a99332` 记录"移除富相关组件" |
| 2 | 行远页重要关系维护 | 🟡 设计稿 | ✅ 已完成 | action/ 5页面 2116行，含 OctopusGraph + 关系问卷 + 互动日志 |
| 3 | 登录前浏览体验 | 🟡 设计稿 | ✅ 已完成 | index.vue 1147行，含游客态、wuxing-sandbox preview、热门推荐 |
| 4 | 情绪打卡数据接入 | 🟡 设计稿 | ✅ 已完成 | mind/ 6文件 4837行，含效价-激活度网格、Plutchik轮、趋势图、EMI报告 |
| 5 | 家长首页改造 | 🟡 计划中 | ✅ 已完成 | parent-index.vue 1460行，已修复10个实现问题 |
| 6 | 文章中心主页 | 🚧 实施中 | ✅ 已完成 | 4页面 1429行 + ArticleController + DB表 |
| 7 | 菌群报告页面 | 🚧 实施中 | ✅ 已完成 | 4页面 1214行 + KnowledgeBase后端 |
| 8 | 家庭会员体系 P0 | 🚧 部分实施 | ✅ 后端完成 | MembershipService 275行 + MembershipController + 2 DB表 |
| 9 | 会员体系前端 | — | ✅ 已完成 | membership/index.vue 685行 + 3子页面 |
| 10 | 五维TabBar统一改造 | 🚧 进行中 | ✅ 核心完成 | 5页面 4548行 |
| 11 | 家庭关系图谱 | ✅ 已实施 | ✅ 已广泛集成 | FamilyRelationGraph.vue 797行，10+页面使用 |
| 12 | 成员详情维度区 | 🟡 设计完成 | ✅ 已完成 | member-detail.vue 505行 + 4维度section 879行 |

### 1.4 需补齐的功能（4项 — 部分完成）

| # | 功能 | 已完成部分 | 缺失部分 | 优先级 |
|---|------|-----------|---------|:------:|
| A | 家庭推广体系 P2-P4 | P1 后端（env_version修复 + wxacode改造） | P2 前端推广中心页 + P3 成员贡献榜 + P4 管理后台 | P1 |
| B | 报告购买链接 | 前端 purchase.vue 537行 | 后端模板数据 mock → 真实 API | P2 |
| C | 家庭会员体系 P1 | 后端 Service+Controller | AI健康管家推荐引擎 | P2 |
| D | 综合差异修复 | 分散在多个 fix commit | 无系统性扫描和修复 | P3 |

---

## 二、Phase 1 真正未完成（5项）

### 2.1 家庭成员辈分重构 ⭐ P0
- **计划文档:** `plans/2026-07-07-家庭成员辈分重构实施计划.md`
- **当前状态:** GenerationLevel.java 枚举已引入，generation/is_spouse 列未迁移
- **需要做:**
  1. DatabaseInitializer 新增迁移：添加 generation + is_spouse 列
  2. 旧数据 mapping（spouse→0, parent→1, child→-1, sibling→0）
  3. 删除 relationship_type/role_override 列（确认无引用后）
  4. 删除 relationship_types 表 + RelationshipType 实体/Mapper/Service
  5. 重写 FamilyMemberService.addMember()/toFamilyMemberVO()
  6. 前端 GenerationPicker.vue 组件
  7. 删除 RelationshipPicker.vue
  8. 更新 FamilyMembersController DTO
- **工作量估计:** 3-5天
- **依赖:** 无前置依赖

### 2.2 富维度子维度拆分 + 身克富杠杆 ⭐ P0
- **计划文档:** `plans/2026-07-12-wealth-dimension-redesign.md`
- **当前状态:** EnergyService v2.1 已完成核心算法
- **需要做:**
  1. 确认子维度拆分是否需要新增 DB 列或表
  2. 前端财富维度页面适配子维度展示
  3. 身克富杠杆算法集成到 EnergyService
- **工作量估计:** 2-3天
- **依赖:** EnergyService v2.1（已完成）

### 2.3 CFC 原生电商扩展（shop_前缀表） ⭐ P1
- **计划文档:** `specs/2026-06-24-cfc-ecommerce-extension-design.md`
- **当前状态:** ProductController 161行已存在，但 schema.sql 中 0 个 shop_ 前缀表
- **需要做:**
  1. 确认 shop_ 前缀表的完整 DDL（参考设计文档）
  2. DatabaseInitializer 新增 shop_ 表迁移
  3. 创建对应 Entity/Mapper/Service
  4. ProductController 适配新表结构
- **工作量估计:** 3-5天
- **依赖:** 无

### 2.4 DAN 测评题目录入优化 ⭐ P1
- **计划文档:** `plans/2026-07-13-dan-assessment-phase2-5.md`
- **当前状态:** 🟡 计划中
- **需要做:** 读取计划文档确认具体任务
- **工作量估计:** 2-3天
- **依赖:** 无

### 2.5 维度页面缺口修复（Phase 2） ⭐ P1
- **计划文档:** `plans/2026-07-12-dimension-pages-gap-fix.md`
- **当前状态:** Phase 1 已完成（记录在"已完成功能"），Phase 2 待实施
- **需要做:** 读取计划文档确认 Phase 2 具体任务
- **工作量估计:** 2-3天
- **依赖:** 五维TabBar改造（已完成）

---

## 三、Phase 2 待开发（4项）

### 3.1 供应商销售体系 ⭐ P2
- **计划文档:** `plans/2026-07-05-supply-distribution-system.md`
- **当前状态:** 后端已有 SupplySystemService/SupplyHierarchyService/SupplySettlementService + Mapper
- **需要做:**
  1. 确认后端 Service 是否完整（有 Mapper 无 Controller？）
  2. 前端供应商管理页面
  3. 账期 + 留利逻辑
- **工作量估计:** 5-8天
- **依赖:** shop_ 前缀表（2.3）

### 3.2 家庭会员体系 P1（AI健康管家） ⭐ P2
- **计划文档:** `plans/2026-07-09-family-membership-ai-butler.md`
- **当前状态:** ⏳ 待开发
- **需要做:** 读取计划文档确认任务
- **工作量估计:** 5-8天
- **依赖:** LangGraph Phase 2（ChatAgent + 记忆）

### 3.3 身体健康7维子体系模型 ⭐ P2
- **计划文档:** `specs/2026-06-26-health-dimensions-design-spec.md`
- **当前状态:** 🟡 设计稿
- **需要做:** 读取设计文档确认范围
- **工作量估计:** 5-8天
- **依赖:** 五维能量系统核心（已完成）

### 3.4 成长档案重建 ⭐ P2
- **计划文档:** `specs/2026-06-22-growth-record-rebuild-design.md`
- **当前状态:** 🟡 设计稿，待评审
- **需要做:** 读取设计文档确认范围
- **工作量估计:** 5-8天
- **依赖:** 无

---

## 四、技术债务（6项）

| # | 项 | 优先级 | 工作量 | 关联 |
|---|---|:------:|:------:|------|
| T1 | 供应商订单修复 | P2 | 1-2天 | `plans/2026-06-20-danshop-order-fix.md` |
| T2 | 供应商体系缺口修复 | P2 | 1-2天 | `plans/2026-07-13-supplier-system-gap-fix.md` |
| T3 | 营养健康缺陷修复 | P2 | 1-2天 | `plans/2026-06-22-营养健康部分缺陷修复计划.md` |
| T4 | 确定性缺口修复 | P1 | 2-3天 | `plans/2026-07-10-determinism-gap-fix-plan.md` |
| T5 | Web端E2E测试修复 | P1 | 2-3天 | `plans/2026-06-20-cfc-web-e2e-test-fix.md` |
| T6 | Web端重构 | P2 | 3-5天 | `plans/2026-06-20-cfc-web-refactor.md` |

---

## 五、统一执行计划

### Sprint 1: Phase 1 收尾（Week 1-2）

**目标:** 完成所有 Phase 1 遗留项，Phase 1 正式关闭

| 任务 | 优先级 | 工作量 | 并行度 | 依赖 |
|------|:------:|:------:|:------:|------|
| T4 确定性缺口修复 | P1 | 2-3天 | 可并行 | 无 |
| T5 Web端E2E测试修复 | P1 | 2-3天 | 可并行 | 无 |
| 2.4 DAN测评优化 | P1 | 2-3天 | 可并行 | 无 |
| 2.5 维度页面缺口修复 Phase 2 | P1 | 2-3天 | 可并行 | 无 |
| 2.1 家庭成员辈分重构 | P0 | 3-5天 | 可并行 | 无 |
| 2.2 富维度子维度拆分 | P0 | 2-3天 | 可并行 | 无 |

**Sprint 1 估算:** 2周，4人并行可压缩至1周

### Sprint 2: Phase 1 关闭 + Phase 2 启动（Week 3-4）

**目标:** 关闭 Phase 1 所有收尾，启动 Phase 2 核心

| 任务 | 优先级 | 工作量 | 并行度 | 依赖 |
|------|:------:|:------:|:------:|------|
| 2.3 电商 shop_ 前缀表迁移 | P1 | 3-5天 | 可并行 | 无 |
| T1 供应商订单修复 | P2 | 1-2天 | 可并行 | 无 |
| T2 供应商体系缺口修复 | P2 | 1-2天 | 可并行 | 无 |
| T3 营养健康缺陷修复 | P2 | 1-2天 | 可并行 | 无 |
| A 家庭推广体系 P2-P4 | P1 | 3-5天 | 可并行 | P1后端（已完成） |
| B 报告购买链接后端对接 | P2 | 1-2天 | 可并行 | 无 |

**Sprint 2 估算:** 2周

### Sprint 3: Phase 2 核心（Week 5-8）

**目标:** Phase 2 主要功能上线

| 任务 | 优先级 | 工作量 | 并行度 | 依赖 |
|------|:------:|:------:|:------:|------|
| 3.1 供应商销售体系 | P2 | 5-8天 | 可并行 | shop_表（Sprint 2） |
| 3.3 身体健康7维子体系 | P2 | 5-8天 | 可并行 | 无 |
| 3.4 成长档案重建 | P2 | 5-8天 | 可并行 | 无 |
| T6 Web端重构 | P2 | 3-5天 | 可并行 | 无 |

**Sprint 3 估算:** 4周

### Sprint 4: Phase 2 收尾 + Phase 3 启动（Week 9-12）

**目标:** Phase 2 关闭，启动 LangGraph Phase 2+

| 任务 | 优先级 | 工作量 | 依赖 |
|------|:------:|:------:|------|
| 3.2 AI健康管家（会员P1） | P2 | 5-8天 | LangGraph Phase 2 |
| LangGraph Phase 2（ChatAgent + 记忆） | P0 | 3-4周 | Phase 1（已完成） |
| C 综合差异修复 | P3 | 2-3天 | 无 |

**Sprint 4 估算:** 4周

---

## 六、里程碑时间线

```
Week 1-2:  Sprint 1 — Phase 1 收尾（辈分重构 + 富维度 + DAN + 维度缺口 + 测试）
Week 3-4:  Sprint 2 — Phase 1 关闭（电商表 + 推广前端 + 供应商修复 + 购买链接）
Week 5-8:  Sprint 3 — Phase 2 核心（供应商体系 + 7维模型 + 成长档案 + Web重构）
Week 9-12: Sprint 4 — Phase 2 收尾（AI管家 + LangGraph Phase 2）
Week 13+:  Phase 3 — LangGraph Phase 2-4 + 知识库自动化
```

---

## 七、PROJECT-OVERVIEW.md 待更新项

审计后发现 12 个功能实际已完成但文档仍标 🚧/🟡，需更新：

| 功能 | 当前标记 | 应更正为 |
|------|---------|---------|
| 富沛页面重构 | 🟡 设计稿 | ✅ 已完成 |
| 行远页重要关系维护 | 🟡 设计稿 | ✅ 已完成 |
| 登录前浏览体验 | 🟡 设计稿 | ✅ 已完成 |
| 情绪打卡数据接入 | 🟡 设计稿 | ✅ 已完成 |
| 家长首页改造 | 🟡 计划中 | ✅ 已完成 |
| 文章中心主页 | 🚧 实施中 | ✅ 已完成 |
| 菌群报告页面 | 🚧 实施中 | ✅ 已完成 |
| 家庭会员 P0 | 🚧 部分实施 | ✅ 后端完成 |
| 会员体系前端 | — | ✅ 已完成 |
| 五维TabBar改造 | 🚧 进行中 | ✅ 核心完成 |
| 家庭关系图谱 | 🚧 设计完成 | ✅ 广泛集成 |
| 成员详情维度区 | 🟡 设计完成 | ✅ 已完成 |

---

## 八、风险与注意事项

| 风险 | 影响 | 缓解措施 |
|------|------|---------|
| 辈分重构涉及删除旧表/列 | 可能影响线上数据 | 先备份，分步迁移，灰度验证 |
| shop_ 前缀表迁移可能与 danshop 冲突 | 电商功能异常 | 确认 danshop 是否仍使用，做兼容性设计 |
| LangGraph Phase 2 依赖 Python 环境 | 部署复杂度增加 | Docker Compose 统一部署 |
| Web端重构范围大 | 工期不可控 | 优先修复 E2E 测试，重构分批进行 |