cfc/docs/superpowers/implementation-readiness-audit-and-execution-plan.md

浠艾福项目 - 实施就绪审计与分阶段执行计划

文档版本: v1.0
生成日期: 2026-07-22
基于: PROJECT-OVERVIEW.md v1.1 + 统一执行计划 v1.0
状态: 待审批

---

执行摘要

本次审计覆盖 PROJECT-OVERVIEW.md 中所有设计组件，通过 4 个并行 explore 代理扫描前后端代码库，核实 50+ 个 plans/ 文档的实际完成状态。

关键发现:

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

建议执行策略:

• Sprint 1 (Week 1-2): Phase 1 收尾（5项真正未完成 + 技术债务）
• Sprint 2 (Week 3-4): Phase 1 关闭 + Phase 2 启动（电商扩展 + 推广前端 + 供应商修复）
• Sprint 3 (Week 5-8): Phase 2 核心（供应商体系 + 7维模型 + 成长档案 + Web重构）
• Sprint 4 (Week 9-12): Phase 2 收尾 + Phase 3 启动（AI管家 + LangGraph Phase 2）

---

一、设计组件就绪审计总表

设计组件	Spec Doc	Current Status	Phase	Priority	Implemented	Files Modified	Notes
AI 架构升级
RecommendAgent	specs/2026-07-20-langgraph-migration-design.md	✅ 已上线	3	P0	Yes	AiGateway.java, MealRecommendController.java	Phase 1 已完成
ChatAgent	specs/2026-07-20-langgraph-migration-design.md	🟡 部分完成	3	P0	Partial	AiGateway.java, chat.vue	后端完成，前端需接入
AnalysisAgent	specs/2026-07-20-langgraph-migration-design.md	🚧 未开始	3	P0	No	-	Phase 3 待开发
MultiModalAgent	specs/2026-07-20-langgraph-migration-design.md	⏳ 待开发	3	P0	No	-	Phase 3 待开发
五维能量系统
维度定义+能量流水+余额	specs/2026-06-05-five-dimension-energy-design.md	✅ 已上线	0/1	P0	Yes	EnergyService, EnergyController, 5+ tables	核心 v2.1
五行相生算法	specs/2026-06-08-five-dimension-wuxing-philosophy.md	✅ 已上线	0	P0	Yes	EnergyService.wuxingSheng	已集成
五行相克算法 v2.0	specs/2026-07-12-wuxing-ke-full-design.md	✅ 已上线	1	P0	Yes	EnergyService.wuxingKe	信号层
首页与转化算法	specs/2026-07-12-wuxing-homepage-and-conversion-algorithm.md	✅ 已上线	1	P0	Yes	EnergySandboxDTO, index pages	已集成
维度功能清单映射	specs/2026-07-12-dimension-features-energy-map.md	🟡 设计稿	1	P1	Partial	-	文档未完成
富维度子维度拆分	plans/2026-07-12-wealth-dimension-redesign.md	🚧 部分实施	1	P0	Partial	EnergyService.v2.1	需前端适配
维度权重滑块重设计	specs/2026-07-02-dimension-weight-picker-redesign.md	✅ 已实施	1	P1	Yes	DimensionWeightController, picker UI	已完成
家庭成员体系
家庭成员辈分重构	specs/2026-07-07-家庭成员关系视角转换设计.md + plans/2026-07-07-家庭成员辈分重构实施计划.md	🚧 部分实施	1	P0	Partial	GenerationLevel.java	generation/is_spouse 列未迁移
家庭成员关系图谱	specs/2026-06-19-family-relation-graph-design.md + specs/2026-06-22-family-relation-graph-redesign.md	✅ 已广泛集成	1	P1	Yes	FamilyRelationGraph.vue (797行)	10+页面使用
家庭成员卡片	specs/2026-06-15-family-member-cards-design.md + plans/2026-06-15-family-member-cards.md	✅ 已上线	1	P1	Yes	FamilyMemberCard.vue	跨页展示+可见性
成员详情维度区	specs/2026-07-14-member-detail-dimension-sections.md	✅ 已完成	1	P1	Yes	member-detail.vue + 4 sections	505 + 879 行
用户体验优化
首次登录跳过身份选择+地址	specs/2026-07-16-first-login-auto-complete.md + plans/2026-07-16-first-login-auto-complete-plan.md	✅ 已实施	1	P1	Yes	login.vue, user-edit.vue	已完成
登录页左侧品牌区重设计	specs/2026-07-02-login-left-panel-redesign.md	✅ 已确认	1	P1	Yes	login.vue (brand zone)	设计确认
富沛（我的）页面重构	specs/2026-06-19-profile-page-redesign.md	✅ 已完成	1	P1	Yes	profile/ 6组件 1338行	已移除富模块
行远页重要关系维护	specs/2026-06-14-action-page-relationship-design.md	✅ 已完成	1	P1	Yes	action/ 5页面 2116行	OctopusGraph+问卷
登录前浏览体验	specs/2026-06-04-pre-login-discovery-design.md	✅ 已完成	1	P1	Yes	index.vue 1147行	游客态+preview
维度专属功能
菌群报告页面重构	specs/2026-07-17-flora-microbiome-report-page-design.md + plans/2026-07-17-flora-microbiome-report-implementation.md	✅ 已完成	1	P1	Yes	4页面 1214行 + HealthKnowledgeBase	200+菌属全覆盖
五维TabBar统一改造	specs/2026-06-13-five-dimension-pages-redesign.md	✅ 核心完成	1	P1	Yes	5页面 4548行	body/mind/wisdom/wealth/action
心·智双Tab结构	-	✅ 已上线	1	P1	Yes	mind/ 6文件 4837行	效价网格+Plutchik轮
情绪打卡数据接入	-	✅ 已完成	2	P1	Yes	mind/ 6文件 4837行	EMI报告+趋势图
身体健康7维子体系	specs/2026-06-26-health-dimensions-design-spec.md	🟡 设计稿	2	P2	No	-	待评审
成长档案重建	specs/2026-06-22-growth-record-rebuild-design.md	🟡 设计稿	2	P2	No	-	待评审
内容与商业化
文章中心主页	specs/2026-07-03-article-center-design.md + plans/2026-07-03-article-center-implementation.md	✅ 已完成	1	P1	Yes	4页面 1429行 + ArticleController	DB表已建
文章发布系统	specs/2026-06-08-article-publishing-system-design.md	🟡 设计稿	1/2	P1	No	-	待实施
CFC原生电商扩展	specs/2026-06-24-cfc-ecommerce-extension-design.md	🚧 部分实施	1	P1	Partial	ProductController (161行)	shop_前缀表未迁移
家庭会员体系 P0	specs/2026-07-09-family-membership-design.md + plans/2026-07-09-family-membership-core.md	✅ 后端完成	2	P2	Partial	MembershipService (275行) + Controller	前端已完成
会员体系前端	-	✅ 已完成	2	P2	Yes	membership/ 4页面 685行	已实现
AI健康管家 P1	plans/2026-07-09-family-membership-ai-butler.md	⏳ 待开发	2	P2	No	-	待开发
供应商销售体系	specs/2026-07-05-supply-distribution-system-design.md + plans/2026-07-05-supply-distribution-system.md	🟡 设计稿	2	P2	Partial	SupplySystemService等	后端Service存在，缺Controller
管理端功能
权限系统升级	specs/2026-06-20-web-permission-system-design.md + plans/2026-06-20-web-permission-system.md	🟡 设计稿	1	P1	No	-	待实施
Web端E2E测试修复	plans/2026-06-20-cfc-web-e2e-test-fix.md	🟡 计划中	1	P1	No	-	14个测试待修复
Web端重构	plans/2026-06-20-cfc-web-refactor.md	🟡 计划中	1	P2	No	-	代码质量提升
维度知识库平台	specs/2026-06-20-dimension-knowledge-base-design.md + plans/2026-06-20-dimension-knowledge-base-plan.md	🟡 待实施	1	P1	No	-	设计完成，待实施

---

二、待实现功能清单（按优先级排序）

2.1 Phase 1 真正未完成（5项）⭐ P0/P1

#	功能	Phase	Priority	工作量	依赖	状态
1	家庭成员辈分重构	1	P0	3-5天	无	🚧 GenerationLevel.java 已引入，列未迁移
2	富维度子维度拆分 + 身克富杠杆	1	P0	2-3天	EnergyService.v2.1	🚧 算法完成，前端未适配
3	CFC原生电商扩展（shop_前缀表）	1	P1	3-5天	无	🚧 ProductController存在，表未建
4	DAN测评题目录入优化	1	P1	2-3天	无	🟡 计划中
5	维度页面缺口修复 Phase 2	1	P1	2-3天	五维TabBar完成	🟡 实施中

2.2 Phase 2 待开发（4项）⭐ P2

#	功能	Phase	Priority	工作量	依赖	状态
6	供应商销售体系	2	P2	5-8天	shop_表（#3）	🟡 Service存在，缺Controller
7	AI健康管家（会员P1）	2	P2	5-8天	LangGraph Phase 2	⏳ 待开发
8	身体健康7维子体系模型	2	P2	5-8天	五维核心完成	🟡 设计稿
9	成长档案重建	2	P2	5-8天	无	🟡 设计稿待评审

2.3 需补齐的功能（4项）⚠️

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

2.4 技术债务（6项）

#	项	Priority	工作量	关联
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

---

三、风险登记册

风险	影响	概率	缓解措施	负责人
辈分重构涉及删除旧表/列	可能影响线上数据	中	先备份，分步迁移，灰度验证	BE Lead
shop_ 前缀表迁移可能与 danshop 冲突	电商功能异常	中	确认 danshop 是否仍使用，做兼容性设计	BE Lead
LangGraph Phase 2 依赖 Python 环境	部署复杂度增加	高	Docker Compose 统一部署	DevOps
Web端重构范围大	工期不可控	中	优先修复 E2E 测试，重构分批进行	FE Lead
供应商体系数据迁移	历史订单丢失	低	双写迁移，回滚方案	BE Lead
富维度子维度拆分影响现有能量计算	用户能量值波动	中	并行计算对比，灰度发布	BE Lead

---

四、分阶段执行计划

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

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

并行任务（4人团队可压缩至1周）:

任务	Priority	工作量	并行度	依赖	分配
T4 确定性缺口修复	P1	2-3天	可并行	无	Dev A
T5 Web端E2E测试修复	P1	2-3天	可并行	无	Dev B
2.4 DAN测评优化	P1	2-3天	可并行	无	Dev C
2.5 维度页面缺口 Phase 2	P1	2-3天	可并行	五维TabBar	Dev D
2.1 家庭成员辈分重构	P0	3-5天	可并行	无	Dev E + Dev F
2.2 富维度子维度拆分	P0	2-3天	可并行	EnergyService.v2.1	Dev G

Sprint 1 里程碑:

• 所有 P0 任务完成（辈分重构、富维度拆分）
• 所有 P1 任务完成（DAN优化、维度缺口、技术债务T4-T5）
• mvn clean compile 零错误
• 后端集成测试通过率 ≥ 95%
• 前端小程序构建无警告

---

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

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

任务	Priority	工作量	并行度	依赖	分配
2.3 电商 shop_ 前缀表迁移	P1	3-5天	可并行	无	Dev A + Dev B
T1 供应商订单修复	P2	1-2天	可并行	shop_表	Dev C
T2 供应商体系缺口修复	P2	1-2天	可并行	shop_表	Dev D
T3 营养健康缺陷修复	P2	1-2天	可并行	无	Dev E
A 家庭推广体系 P2-P4	P1	3-5天	可并行	P1后端完成	Dev F + Dev G
B 报告购买链接后端对接	P2	1-2天	可并行	无	Dev H

Sprint 2 里程碑:

• shop_ 前缀表 100% 覆盖，schema.sql 同步
• 家庭推广体系 P2 前端页面完成
• 供应商订单修复验证通过
• Phase 1 所有未完成任务标记为 ✅

---

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

目标: Phase 2 主要功能上线

任务	Priority	工作量	并行度	依赖	分配
3.1 供应商销售体系	P2	5-8天	可并行	shop_表（Sprint 2）	Dev A + Dev B + Dev C
3.3 身体健康7维子体系	P2	5-8天	可并行	五维核心	Dev D + Dev E
3.4 成长档案重建	P2	5-8天	可并行	无	Dev F + Dev G
T6 Web端重构	P2	3-5天	可并行	无	Dev H
3.2 AI健康管家（会员P1）	P2	5-8天	可并行	LangGraph Phase 2	Dev I + Dev J

Sprint 3 里程碑:

• 供应商体系账期+留利逻辑上线
• 7维子体系模型数据接入完成
• 成长档案重建页面可用
• Web端重构 E2E 测试通过率 ≥ 90%

---

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

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

任务	Priority	工作量	依赖	分配
3.2 AI健康管家（收尾）	P2	5-8天	LangGraph Phase 2	Dev A + Dev B
LangGraph Phase 2（ChatAgent + 记忆）	P0	3-4周	Phase 1完成	AI Team
C 综合差异修复	P3	2-3天	无	Dev C
8.1 营养健康缺陷修复	P2	1-2天	无	Dev D
8.2 家庭关系图修复	P2	1-2天	无	Dev E

Sprint 4 里程碑:

• AI健康管家推荐引擎上线
• LangGraph Phase 2 灰度发布（5%流量）
• Phase 2 所有 P2 任务完成
• Phase 3 启动会议召开

---

五、里程碑时间线（Gantt）

gantt
    title 浠艾福项目 - 分阶段执行计划（2026-07-22 起）
    dateFormat  YYYY-MM-DD
    section Phase 1 收尾
    辈分重构 (P0)           :p1-gen, 2026-07-22, 5d
    富维度拆分 (P0)          :p1-wealth, 2026-07-22, 3d
    DAN测评优化 (P1)         :p1-dan, 2026-07-22, 3d
    维度缺口 Phase 2 (P1)    :p1-dim, 2026-07-22, 3d
    确定性修复 (P1)          :p1-det, 2026-07-22, 3d
    Web E2E修复 (P1)        :p1-e2e, 2026-07-22, 3d
    section Sprint 1 完成
    里程碑: 所有P0/P1完成   :milestone1, after p1-gen, 1d
    section Phase 1 关闭
    shop_表迁移 (P1)         :p2-shop, 2026-08-04, 5d
    家庭推广 P2-P4 (P1)      :p2-promo, 2026-08-04, 5d
    供应商订单修复 (P2)      :p2-order, after p2-shop, 2d
    供应商缺口修复 (P2)      :p2-gap, after p2-shop, 2d
    营养健康修复 (P2)        :p2-nutri, 2026-08-04, 2d
    购买链接对接 (P2)        :p2-link, 2026-08-04, 2d
    section Sprint 2 完成
    里程碑: Phase 1关闭      :milestone2, after p2-promo, 1d
    section Phase 2 核心
    供应商销售体系 (P2)      :p3-supply, 2026-08-18, 8d
    7维子体系模型 (P2)       :p3-health, 2026-08-18, 8d
    成长档案重建 (P2)        :p3-growth, 2026-08-18, 8d
    Web端重构 (P2)           :p3-web, 2026-08-18, 5d
    AI健康管家 (P2)          :p3-ai, 2026-09-01, 8d
    section Sprint 3 完成
    里程碑: Phase 2核心完成   :milestone3, after p3-supply, 1d
    section Phase 2 收尾 + Phase 3 启动
    AI健康管家收尾 (P2)      :p4-ai, 2026-09-15, 8d
    LangGraph Phase 2       :p4-langgraph, 2026-09-15, 28d
    综合差异修复 (P3)        :p4-fix, 2026-09-15, 3d
    section Sprint 4 完成
    里程碑: Phase 2关闭/Phase 3启动 :milestone4, after p4-langgraph, 1d

---

六、依赖关系矩阵

任务	依赖	被依赖	阻塞关系
辈分重构	无	家庭推广体系	推广体系需要 generation 字段
富维度拆分	EnergyService.v2.1	无	-
shop_表迁移	无	供应商销售体系、供应商订单修复	电商基础
供应商销售体系	shop_表	无	-
AI健康管家	LangGraph Phase 2	无	AI能力依赖
LangGraph Phase 2	Phase 1 完成	AI健康管家	基础架构依赖
Web端重构	无	无	可并行

---

七、PROJECT-OVERVIEW.md 待更新项（12项）

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

功能	当前标记	应更正为	证据
富沛页面重构	🟡 设计稿	✅ 已完成	profile/ 6组件 1338行，git d6a99332
行远页重要关系维护	🟡 设计稿	✅ 已完成	action/ 5页面 2116行
登录前浏览体验	🟡 设计稿	✅ 已完成	index.vue 1147行
情绪打卡数据接入	🟡 设计稿	✅ 已完成	mind/ 6文件 4837行
家长首页改造	🟡 计划中	✅ 已完成	parent-index.vue 1460行
文章中心主页	🚧 实施中	✅ 已完成	4页面 1429行 + ArticleController
菌群报告页面	🚧 实施中	✅ 已完成	4页面 1214行 + KnowledgeBase
家庭会员 P0	🚧 部分实施	✅ 后端完成	MembershipService 275行 + Controller
会员体系前端	—	✅ 已完成	membership/ 4页面 685行
五维TabBar改造	🚧 进行中	✅ 核心完成	5页面 4548行
家庭关系图谱	✅ 已实施	✅ 已广泛集成	FamilyRelationGraph.vue 797行
成员详情维度区	🟡 设计完成	✅ 已完成	member-detail.vue 505行 + 4维度section

---

八、验收标准（全局）

8.1 编译验证

# 后端
cd cfc-backend && mvn clean compile

# 前端小程序
cd cfc-frontend && npm run build:mp-weixin

# Web管理端
cd cfc-web && npm run build

8.2 测试覆盖率

模块	单元测试覆盖率	集成测试	E2E测试
后端 Service	≥ 80%	≥ 70%	-
后端 Controller	≥ 60%	≥ 60%	≥ 40%
前端组件	-	-	≥ 50%

8.3 数据库迁移

• 所有 DDL 迁移必须通过 DatabaseInitializer.runMigrations()
• 使用 ensureColumn() 保证幂等性
• schema.sql 必须同步更新
• 迁移编号递增，注释清晰

8.4 代码质量

• LSP 诊断零错误（lsp_diagnostics 检查）
• 无 AI slop 模式（可选链、CSS Grid 等）
• 遵循项目规范（PostMapping、Resource 注入等）
• Git 提交信息规范（feat/fix/docs 前缀）

---

九、沟通与协调

9.1 每日站会（15分钟）

• 昨日完成
• 今日计划
• 阻塞问题

9.2 周评审（1小时）

• Sprint 进度回顾
• 演示已完成功能
• 调整下周计划

9.3 里程碑评审（2小时）

• Phase 1 关闭评审（Week 2 结束）
• Phase 2 启动评审（Week 4 结束）
• Phase 2 关闭评审（Week 8 结束）
• Phase 3 启动评审（Week 12 结束）

---

十、附录

10.1 关键文档索引

文档	路径	状态
PROJECT-OVERVIEW.md	docs/superpowers/PROJECT-OVERVIEW.md	v1.1
统一执行计划	docs/superpowers/plans/2026-07-21-unified-execution-plan.md	v1.0
辈分重构实施计划	docs/superpowers/plans/2026-07-07-家庭成员辈分重构实施计划.md	v2.0
富维度重构计划	docs/superpowers/plans/2026-07-12-wealth-dimension-redesign.md	v1.0
DAN测评 Phase 2-5	docs/superpowers/plans/2026-07-13-dan-assessment-phase2-5.md	v1.0
维度页面缺口修复	docs/superpowers/plans/2026-07-12-dimension-pages-gap-fix.md	v1.0

10.2 联系信息

• 技术负责人: 见 Git 仓库 MAINTAINERS.md
• 产品负责人: 见 PROJECT-OVERVIEW.md 维护字段
• DevOps 支持: 见 cfc-backend/start.sh

---

文档结束