|
|
@@ -0,0 +1,256 @@
|
|
|
+# 统一实施计划 — 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 测试,重构分批进行 |
|