2026-07-21-unified-execution-plan.md 11 KB
统一实施计划 — 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 列未迁移
- 需要做:
- DatabaseInitializer 新增迁移：添加 generation + is_spouse 列
- 旧数据 mapping（spouse→0, parent→1, child→-1, sibling→0）
- 删除 relationship_type/role_override 列（确认无引用后）
- 删除 relationship_types 表 + RelationshipType 实体/Mapper/Service
- 重写 FamilyMemberService.addMember()/toFamilyMemberVO()
- 前端 GenerationPicker.vue 组件
- 删除 RelationshipPicker.vue
- 更新 FamilyMembersController DTO
- 工作量估计: 3-5天
- 依赖: 无前置依赖
2.2 富维度子维度拆分 + 身克富杠杆 ⭐ P0
- 计划文档:
plans/2026-07-12-wealth-dimension-redesign.md - 当前状态: EnergyService v2.1 已完成核心算法
- 需要做:
- 确认子维度拆分是否需要新增 DB 列或表
- 前端财富维度页面适配子维度展示
- 身克富杠杆算法集成到 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_ 前缀表
- 需要做:
- 确认 shop_ 前缀表的完整 DDL（参考设计文档）
- DatabaseInitializer 新增 shop_ 表迁移
- 创建对应 Entity/Mapper/Service
- 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
- 需要做:
- 确认后端 Service 是否完整（有 Mapper 无 Controller？）
- 前端供应商管理页面
- 账期 + 留利逻辑
- 工作量估计: 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 测试，重构分批进行 |