docs: add implementation audit, tickler, phase1-remaining, and P0 tickets

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

@@ -0,0 +1,383 @@
+# 浠艾福项目 - 实施就绪审计与分阶段执行计划
+
+**文档版本:** 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）
+
+```mermaid
+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 编译验证
+
+```bash
+# 后端
+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
+
+---
+
+**文档结束**

docs/superpowers/implementation-tickler.md

@@ -0,0 +1,199 @@
+# 实施优先级 tickler — 快速参考指南
+
+**生成日期:** 2026-07-22  
+**基于:** 实施就绪审计 + 统一执行计划  
+**用途:** 快速查看所有任务的优先级和状态
+
+---
+
+## 图例
+
+| 符号 | 说明 |
+|------|------|
+| 🔴 **HIGH** | 立即执行，阻塞业务 |
+| 🟡 **MEDIUM** | 2 周内执行 |
+| 🟢 **LOW** | 3 周后或资源空闲时执行 |
+| ⏳ **WAITING** | 等待前置任务完成 |
+| 🚧 **IN PROGRESS** | 进行中 |
+
+---
+
+## HIGH 优先级（立即执行）
+
+### Phase 1 P0 核心（2个）
+
+| ID | 任务 | 工作量 | 状态 | 文档 |
+|----|------|--------|------|------|
+| T1-1 | 辈分重构 - Phase 1 基础设施 | 2d | ⏳ 待开始 | `phase1-remaining.md` |
+| T1-2 | 富维度子维度拆分 - EnergyService 重构 | 2d | ⏳ 待开始 | `phase1-remaining.md` |
+| T1-3 | 辈分重构 - Phase 2 后端逻辑重写 | 2d | ⏳ 待开始 | `phase1-remaining.md` |
+| T1-4 | 辈分重构 - Phase 3 清理 + 管理端 | 2d | ⏳ 待开始 | `phase1-remaining.md` |
+| T1-5 | 辈分重构 - Phase 4 小程序前端 | 2d | ⏳ 待开始 | `phase1-remaining.md` |
+| T1-6 | 富维度拆分 - 前端页面重写 | 2d | ⏳ 待开始 | `phase1-remaining.md` |
+
+**总工作量:** 12 人天（可 3 人并行，2 周完成）
+
+---
+
+### Phase 1 P1 核心（3个）
+
+| ID | 任务 | 工作量 | 状态 | 文档 |
+|----|------|--------|------|------|
+| T1-9 | CFC原生电商扩展 - 数据库迁移 | 2d | ⏳ 待开始 | `phase1-remaining.md` |
+| T1-10 | CFC原生电商扩展 - Service + Controller | 2d | ⏳ 待开始 | `phase1-remaining.md` |
+| T4 | 确定性缺口修复 | 2-3d | ⏳ 待开始 | `2026-07-10-determinism-gap-fix-plan.md` |
+
+**总工作量:** 6-7 人天（可 2 人并行，1 周完成）
+
+---
+
+### 技术债务 P1（2个）
+
+| ID | 任务 | 工作量 | 状态 | 文档 |
+|----|------|--------|------|------|
+| T5 | Web端E2E测试修复 | 2-3d | ⏳ 待开始 | `2026-06-20-cfc-web-e2e-test-fix.md` |
+| T5-1 | 综合差异修复 | 2d | ⏳ 待开始 | `2026-06-15-comprehensive-discrepancy-fix.md` |
+
+**总工作量:** 4-5 人天
+
+---
+
+## MEDIUM 优先级（2 周内执行）
+
+### Phase 1 P1 次要（2个）
+
+| ID | 任务 | 工作量 | 状态 | 文档 |
+|----|------|--------|------|------|
+| T1-7 | DAN测评题目录入优化 | 2-3d | ⏳ 待开始 | `2026-07-13-dan-assessment-phase2-5.md` |
+| T1-8 | 维度页面缺口修复 Phase 2 | 2-3d | ⏳ 待开始 | `2026-07-12-dimension-pages-gap-fix.md` |
+
+**总工作量:** 4-6 人天
+
+---
+
+### Phase 2 P2 核心（4个）
+
+| ID | 任务 | 工作量 | 状态 | 文档 |
+|----|------|--------|------|------|
+| 3.1 | 供应商销售体系 | 5-8d | 🟡 部分完成 | `2026-07-05-supply-distribution-system.md` |
+| 3.2 | AI健康管家（会员P1） | 5-8d | ⏳ 待开发 | `2026-07-09-family-membership-ai-butler.md` |
+| 3.3 | 身体健康7维子体系模型 | 5-8d | 🟡 设计稿 | `2026-06-26-health-dimensions-design-spec.md` |
+| 3.4 | 成长档案重建 | 5-8d | 🟡 设计稿 | `2026-06-22-growth-record-rebuild-design.md` |
+
+**总工作量:** 20-32 人天（需 3-4 人并行，4 周完成）
+
+---
+
+### 技术债务 P2（3个）
+
+| ID | 任务 | 工作量 | 状态 | 文档 |
+|----|------|--------|------|------|
+| T1 | 供应商订单修复 | 1-2d | 🟡 计划中 | `2026-06-20-danshop-order-fix.md` |
+| T2 | 供应商体系缺口修复 | 1-2d | 🟡 计划中 | `2026-07-13-supplier-system-gap-fix.md` |
+| T3 | 营养健康缺陷修复 | 1-2d | 🟡 计划中 | `2026-06-22-营养健康部分缺陷修复计划.md` |
+| T6 | Web端重构 | 3-5d | 🟡 计划中 | `2026-06-20-cfc-web-refactor.md` |
+
+**总工作量:** 6-11 人天
+
+---
+
+### 需补齐功能 P2（1个）
+
+| ID | 任务 | 工作量 | 状态 | 文档 |
+|----|------|--------|------|------|
+| B | 报告购买链接后端对接 | 1-2d | ⏳ 待开发 | `2026-07-19-report-upload-purchase-links.md` |
+
+---
+
+## LOW 优先级（3 周后或资源空闲）
+
+### Phase 2 P3（1个）
+
+| ID | 任务 | 工作量 | 状态 | 文档 |
+|----|------|--------|------|------|
+| C | 综合差异修复 | 2-3d | 🟡 计划中 | `2026-06-15-comprehensive-discrepancy-fix.md` |
+
+---
+
+### Phase 3-4 待开发（5个）⚠️ 不在本计划范围
+
+| ID | 任务 | Phase | 状态 | 文档 |
+|----|------|-------|------|------|
+| - | AnalysisAgent | 3 | ⏳ 待开发 | `2026-07-20-langgraph-phase3.md` |
+| - | MultiModalAgent | 3 | ⏳ 待开发 | `2026-07-20-langgraph-phase3.md` |
+| - | LangGraph Phase 3-4 | 3-4 | ⏳ 待开发 | `2026-07-20-langgraph-phase4.md` |
+| - | 文章发布系统 | 1/2 | 🟡 设计稿 | `2026-06-08-article-publishing-system-design.md` |
+| - | 维度知识库平台 | 1 | 🟡 待实施 | `2026-06-20-dimension-knowledge-base-design.md` |
+
+---
+
+## 快速决策矩阵
+
+### 本周（Week 1）启动任务
+
+```
+优先级排序:
+1. T1-1 (辈分基础设施) - P0
+2. T1-2 (富维度拆分) - P0
+3. T1-9 (电商表迁移) - P1
+4. T4 (确定性修复) - P1
+5. T5 (Web E2E修复) - P1
+```
+
+### 下周（Week 2）启动任务
+
+```
+优先级排序:
+1. T1-3 (辈分后端逻辑) - P0（依赖 T1-1）
+2. T1-6 (富维度前端) - P0（依赖 T1-2）
+3. T1-10 (电商 Service) - P1（依赖 T1-9）
+4. T1-7 (DAN优化) - P1
+5. T1-8 (维度缺口) - P1
+```
+
+### 第 3 周启动任务
+
+```
+优先级排序:
+1. T1-4 (辈分清理+管理端) - P0（依赖 T1-3）
+2. T1-5 (辈分小程序前端) - P0（依赖 T1-4）
+3. 3.1 (供应商体系) - P2（依赖 T1-10）
+4. T1/T2/T3 (供应商订单/缺口/营养修复) - P2
+```
+
+---
+
+## 资源分配建议
+
+### 团队配置（5人）
+
+| 角色 | 人数 | 负责任务 | 并行度 |
+|------|------|----------|--------|
+| BE Lead | 1 | T1-1, T1-3, T1-4, T1-9, T1-10, T4 | 高 |
+| FE-mini | 1 | T1-5, T1-6, T1-8, T5-2 | 高 |
+| BE | 1 | T1-2, T1-7, T5-1, T5-3 | 中 |
+| Web | 1 | T1-4 (Web部分), T5-2, T6 | 中 |
+| QA/DevOps | 1 | 所有任务测试 + 部署 | 支持 |
+
+---
+
+## 关键里程碑
+
+| 里程碑 | 日期 | 验收条件 | 任务 |
+|--------|------|----------|------|
+| M1: Phase 1 P0 完成 | Week 2 结束 | 辈分重构 + 富维度拆分全部完成 | T1-1~T1-6 |
+| M2: Phase 1 关闭 | Week 4 结束 | 所有 P0/P1 任务完成，电商扩展上线 | T1-7~T1-10 + 技术债务 |
+| M3: Phase 2 核心完成 | Week 8 结束 | 供应商体系 + 7维模型 + 成长档案 + Web重构 | 3.1~3.4 + T6 |
+| M4: Phase 2 收尾 + Phase 3 启动 | Week 12 结束 | AI管家 + LangGraph Phase 2 灰度 | 3.2 + LangGraph Phase 2 |
+
+---
+
+## 紧急联系
+
+- **技术阻塞:** 立即 @ BE Lead / FE Lead
+- **需求澄清:** 产品负责人（见 PROJECT-OVERVIEW.md）
+- **部署问题:** DevOps（见 cfc-backend/start.sh）
+
+---
+
+**文档结束**

docs/superpowers/plans/phase1-remaining.md

@@ -0,0 +1,429 @@
+# Phase 1 剩余任务 — 2天技术任务分解
+
+**文档版本:** v1.0  
+**生成日期:** 2026-07-22  
+**基于:** 统一执行计划 + 5个真正未完成项  
+**目标:** 将 Phase 1 剩余工作分解为 2 天可完成的技术任务
+
+---
+
+## 任务分解原则
+
+- 每个任务 ≤ 2 天（16 小时）
+- 明确输入/输出/验收标准
+- 独立可并行（标注依赖）
+- 包含测试验证步骤
+
+---
+
+## 任务清单（按优先级排序）
+
+### P0 任务（2个）
+
+#### T1-1: 辈分重构 - Phase 1 基础设施（2天）
+
+**目标:** 完成 GenerationLevel 枚举、实体变更、数据库列添加
+
+**输入:**
+- 现有 `FamilyMember.java` 实体
+- `DatabaseInitializer.java` 迁移框架
+
+**输出:**
+- `GenerationLevel.java` 枚举（7级）
+- 修改 `FamilyMember.java`（删除 relationshipType/roleOverride，新增 generation/isSpouse）
+- `AddFamilyMemberDTO.java`（新建）
+- DatabaseInitializer 迁移 1 & 2（添加列 + 旧数据填充）
+
+**验收标准:**
+- [ ] `mvn clean compile` 零错误
+- [ ] 数据库 `family_members` 表存在 `generation`、`is_spouse` 列
+- [ ] 旧数据 generation 按规则映射（spouse→0, parent→1, child→-1, sibling→0）
+- [ ] GenerationLevel 枚举包含 7 个级别，可通过单元测试
+
+**依赖:** 无
+
+**分配:** 后端开发 1 人
+
+---
+
+#### T1-2: 富维度子维度拆分 - EnergyService 重构（2天）
+
+**目标:** 重构 `calcChildWealth` / `calcParentWealth`，拆分为子维度，集成身克富杠杆
+
+**输入:**
+- `EnergyService.java` v2.1（已有核心算法）
+- `MemberEnergyDTO.java`
+
+**输出:**
+- `MemberEnergyDTO` 新增 8 个子维度字段 + 2 个身克富字段
+- `EnergyService.calcChildWealth()` 拆分为 3 个子方法（education/social/points）
+- `EnergyService.calcParentWealth()` 拆分为 3 个子方法（income/achievement/network）
+- `EnergyService.applyBodyWealthRestraint()` 新方法（身克富杠杆）
+- 在 `calcParentEnergy` / `calcChildEnergy` 末尾调用身克富检测
+
+**验收标准:**
+- [ ] 单元测试覆盖所有子维度计算逻辑（≥ 80%）
+- [ ] 身克富三种状态（normal/overdraw/penalty）可触发
+- [ ] 集成测试验证能量概览 API 返回子维度数据
+- [ ] 无编译错误，无 LSP 警告
+
+**依赖:** T1-1（可并行，不阻塞）
+
+**分配:** 后端开发 1 人
+
+---
+
+### P1 任务（5个）
+
+#### T1-3: 辈分重构 - Phase 2 后端逻辑重写（2天）
+
+**目标:** 重写 FamilyMemberService 核心方法，删除关系类型管理
+
+**输入:**
+- T1-1 完成的实体和 DTO
+- 现有 `FamilyMemberService.java`
+
+**输出:**
+- 重写 `computeEffectiveRole()`（基于 generation）
+- 重写 `computeRelativeLabel()`（纯 generation diff 计算）
+- 重写 `addMember()`（使用 relativeMemberId + generationLevel + peerType）
+- 修改 `listMembers()` 和 `toFamilyMemberVO()`（移除 relationshipType 相关字段）
+- 删除管理端关系类型管理方法
+- 修改 `FamilyMembersController` 请求/响应 DTO
+
+**验收标准:**
+- [ ] 单元测试覆盖 `computeRelativeLabel()` 所有辈分组合（≥ 90%）
+- [ ] API 测试：添加配偶（peer+spouse）成功，generation=0, is_spouse=1
+- [ ] API 测试：添加子侄辈（child）成功，generation=-1
+- [ ] 旧代码引用搜索：`grep -r "relationshipType" cfc-backend/src/main/java` 返回空
+
+**依赖:** T1-1
+
+**分配:** 后端开发 1 人
+
+---
+
+#### T1-4: 辈分重构 - Phase 3 清理 + 管理端（2天）
+
+**目标:** 删除废弃列和表，同步 schema.sql，更新 cfc-web 管理端
+
+**输入:**
+- T1-3 完成的后端逻辑
+- `cfc-backend/src/main/resources/schema.sql`
+
+**输出:**
+- DatabaseInitializer 迁移 3：删除 `relationship_type`、`role_override` 列
+- DatabaseInitializer 迁移 4：删除 `relationship_types` 表
+- 同步 `schema.sql` 表结构
+- 删除 `RelationshipType.java`、`RelationshipTypeMapper.java`、`RelationshipTypeService.java`（如存在）
+- 删除 cfc-web 管理端关系类型管理页面和路由
+- 更新 cfc-web 成员添加页面（替换为辈分选择器）
+
+**验收标准:**
+- [ ] `grep -r "relationship_type" cfc-backend/src/main/java` 返回空
+- [ ] `grep -r "RelationshipType" cfc-backend/src/main/java` 返回空
+- [ ] schema.sql 中 `family_members` 表无 relationship_type/role_override 列
+- [ ] cfc-web 路由无 `/admin/relationship-type` 路径
+- [ ] 管理端成员添加页面显示辈分选择器（GenerationPicker）
+
+**依赖:** T1-3
+
+**分配:** 后端开发 1 人 + Web前端 1 人
+
+---
+
+#### T1-5: 辈分重构 - Phase 4 小程序前端（2天）
+
+**目标:** 新建 GenerationPicker 组件，更新成员添加页面
+
+**输入:**
+- T1-4 完成的后端 API
+- 现有 `RelationshipPicker.vue`（如有）
+
+**输出:**
+- `generationLevel.js` 常量文件（7级辈分 + 同辈类型）
+- `GenerationPicker.vue` 组件（单选辈分 + 同辈配偶选项）
+- 修改成员添加页面（`pages/family/member-add.vue` 或类似）
+- 删除 `RelationshipPicker.vue`（如存在）
+- 更新 `utils/api.js` 调用参数（relationshipType → generationLevel + peerType）
+
+**验收标准:**
+- [ ] GenerationPicker 组件可正常选择辈分和配偶类型
+- [ ] 添加成员 API 调用成功（relativeMemberId + generationLevel + peerType）
+- [ ] 成员列表显示 generation 字段（调试模式）
+- [ ] 小程序编译无警告，LSP 诊断零错误
+
+**依赖:** T1-4（API 变更）
+
+**分配:** 小程序前端 1 人
+
+---
+
+#### T1-6: 富维度拆分 - 前端页面重写（2天）
+
+**目标:** 重写 `pages/wealth/index.vue`，角色感知的富展示
+
+**输入:**
+- T1-2 完成的 `GET /api/energy/wealth-detail` API
+- 现有 `pages/wealth/index.vue`
+
+**输出:**
+- 新页面布局：PageBanner → 身克富状态条 → 三子维度卡片 → 增值服务入口 → 底部菜单
+- `WealthSubScores.vue` 组件（成人版/孩子版）
+- `BodyWealthAlert.vue` 组件（三种状态：normal/overdraw/penalty）
+- `utils/api.js` 新增 `getWealthDetail()` 方法
+- 删除原页面"行动数据"区块（任务数/购买数/活动数/课程数）
+
+**验收标准:**
+- [ ] 家长端显示 3 个子维度（金钱收入/社会成就/资源网络）
+- [ ] 孩子端显示 3 个子维度（学业成绩/社交筹码/积分效率）
+- [ ] 身克富预警在条件触发时显示（身<40 且 富>60）
+- [ ] 页面加载时间 ≤ 1.5s（模拟数据）
+- [ ] 小程序编译零错误
+
+**依赖:** T1-2（API 就绪）
+
+**分配:** 小程序前端 1 人
+
+---
+
+#### T1-7: DAN测评题目录入优化（2天）
+
+**目标:** 优化认知测评题目录入流程
+
+**输入:**
+- 现有 `DanAssessmentController.java`
+- 设计文档 `assessment-market-plan.md`
+
+**输出:**
+- 确认具体优化点（批量导入？富文本编辑器？题目预览？）
+- 实现对应功能（根据设计文档）
+- 更新前端题目录入页面
+
+**验收标准:**
+- [ ] 题目录入效率提升 ≥ 30%（对比旧流程）
+- [ ] 支持批量导入（如需要）
+- [ ] 题目预览功能正常
+- [ ] 后端 API 响应时间 ≤ 500ms
+
+**依赖:** 无
+
+**分配:** 后端 1 人 + 前端 1 人
+
+---
+
+#### T1-8: 维度页面缺口修复 Phase 2（2天）
+
+**目标:** 补全五维页面的缺失功能（珍珠图/圈子系统 Phase 1）
+
+**输入:**
+- `plans/2026-07-12-dimension-pages-gap-fix.md`
+- 五维 TabBar 页面（已完成）
+
+**输出:**
+- **P1-1 身页:** `HealthCheckinCard.vue` 组件 + 插入到 `pages/body/index.vue`
+- **P1-2 智页:** 阅读时长展示卡片 + API 对接（确认或新增 `POST /api/article/reading-stats`）
+- **P1-3 心页:** 天盘相性卡片 + API 对接（`POST /api/tianpan/compatibility`）
+
+**验收标准:**
+- [ ] 身页健康打卡卡片显示今日状态 + 连续天数
+- [ ] 智页显示"本月阅读 X 小时"
+- [ ] 心页显示家庭天盘相性评分
+- [ ] 三个卡片均可点击跳转详情页
+- [ ] 无登录态不显示（或显示占位符）
+
+**依赖:** 五维 TabBar 完成（已完成）
+
+**分配:** 小程序前端 1-2 人
+
+---
+
+#### T1-9: CFC原生电商扩展 - 数据库迁移（2天）
+
+**目标:** 创建 shop_ 前缀表，完成 DatabaseInitializer 迁移
+
+**输入:**
+- `specs/2026-06-24-cfc-ecommerce-extension-design.md`
+- `DatabaseInitializer.java`
+
+**输出:**
+- 确认 shop_ 表完整 DDL（至少：shop_products, shop_orders, shop_categories）
+- DatabaseInitializer 新增建表迁移
+- 同步 `schema.sql`
+- 创建对应 Entity 类（ShopProduct.java, ShopOrder.java 等）
+
+**验收标准:**
+- [ ] `SHOW TABLES LIKE 'shop_%'` 返回预期表数量（≥ 3）
+- [ ] schema.sql 包含 shop_ 表定义
+- [ ] Entity 类字段与 DDL 完全一致
+- [ ] `mvn clean compile` 零错误
+
+**依赖:** 无
+
+**分配:** 后端开发 1 人
+
+---
+
+#### T1-10: CFC原生电商扩展 - Service + Controller（2天）
+
+**目标:** 实现电商 CRUD 逻辑，适配 ProductController
+
+**输入:**
+- T1-9 完成的 Entity 和 Mapper
+- 现有 `ProductController.java`（161行）
+
+**输出:**
+- `ShopProductMapper.java` + `ShopProductService.java` + `ShopProductController.java`
+- 或扩展现有 `ProductController` 支持 shop_ 表
+- 实现商品列表/详情/下单/订单查询基础 API
+- 更新 `utils/api.js` 新增电商相关方法
+
+**验收标准:**
+- [ ] 商品列表 API 返回正确数据（mock 数据可查询）
+- [ ] 商品详情 API 可查询单个商品
+- [ ] 下单 API 创建订单成功（订单状态 pending）
+- [ ] 前端小程序商城页面可浏览商品
+
+**依赖:** T1-9
+
+**分配:** 后端开发 1 人 + 小程序前端 1 人
+
+---
+
+### 技术债务任务（3个）
+
+#### T5-1: 确定性缺口修复（2天）
+
+**目标:** 修复系统确定性缺口（具体内容见 `plans/2026-07-10-determinism-gap-fix-plan.md`）
+
+**输入:**
+- 确定性缺口计划文档
+- 现有代码中随机数/时间戳依赖
+
+**输出:**
+- 识别所有 `Math.random()`、`new Date()`、`UUID.randomUUID()` 等非确定性调用
+- 替换为可 seed 的伪随机生成器或固定时间戳（测试环境）
+- 添加 `DeterministicTest` 基类，确保测试可重复
+
+**验收标准:**
+- [ ] 所有单元测试运行两次结果一致
+- [ ] 集成测试无 flaky 失败（连续运行 5 次 100% 通过）
+- [ ] 代码审查：无新增非确定性代码
+
+**依赖:** 无
+
+**分配:** 后端开发 1 人
+
+---
+
+#### T5-2: Web端E2E测试修复（2天）
+
+**目标:** 修复 14 个 E2E 测试失败用例
+
+**输入:**
+- `plans/2026-06-20-cfc-web-e2e-test-fix.md`
+- Web 端 E2E 测试报告
+
+**输出:**
+- 逐项修复失败测试（选择器过时、异步等待、数据依赖）
+- 更新测试数据 fixture
+- 增加测试稳定性（retry 机制、等待策略）
+
+**验收标准:**
+- [ ] E2E 测试通过率从当前提升至 ≥ 90%
+- [ ] 连续运行 3 次无 flaky 失败
+- [ ] 测试执行时间 ≤ 10 分钟
+
+**依赖:** 无
+
+**分配:** Web前端 1 人
+
+---
+
+#### T5-3: 综合差异修复（2天）
+
+**目标:** 系统性扫描和修复代码与设计差异
+
+**输入:**
+- 所有 specs/ 设计文档
+- 现有代码库
+
+**输出:**
+- 使用 `ast-grep` 扫描设计规范违反（如可选链、CSS Grid、GetMapping 等）
+- 批量修复 AI slop 模式
+- 更新文档与代码同步
+
+**验收标准:**
+- [ ] 扫描报告：0 个严重违反项
+- [ ] 所有页面符合设计 Token 体系
+- [ ] 代码审查：无设计文档已定义但未实现的功能
+
+**依赖:** 无
+
+**分配:** 全栈开发 1 人
+
+---
+
+## 任务分配汇总（Sprint 1）
+
+| 开发者 | 任务数 | 总工作量 | 并行任务 |
+|--------|--------|----------|----------|
+| Dev A（BE） | T1-1, T1-3, T1-4, T1-9 | 4 个 | 3 个并行（T1-1/T1-3/T1-9） |
+| Dev B（FE-mini） | T1-5, T1-6, T1-8, T1-10 | 4 个 | 3 个并行（T1-5/T1-6/T1-8） |
+| Dev C（BE） | T1-2, T1-7 | 2 个 | 1 个并行（T1-2） |
+| Dev D（Web） | T1-4 (Web部分), T5-2 | 2 个 | 1 个并行（T5-2） |
+| Dev E（BE） | T5-1, T5-3 | 2 个 | 1 个并行（T5-1） |
+
+**总工作量:** 13 个任务 × 2 天 = 26 人天  
+**并行度:** 4-5 人同时工作  
+**预计完成时间:** 2 周（考虑 50% 并行效率）
+
+---
+
+## 关键路径
+
+```
+T1-1 (2d) → T1-3 (2d) → T1-4 (2d) → T1-5 (2d)
+              ↓
+           T1-2 (2d) → T1-6 (2d)
+              ↓
+           T1-7 (2d)
+              ↓
+           T1-8 (2d)
+              ↓
+           T1-9 (2d) → T1-10 (2d)
+```
+
+**关键路径长度:** 10 天（不含技术债务）
+
+---
+
+## 风险与缓解
+
+| 风险 | 影响 | 缓解 |
+|------|------|------|
+| T1-1 数据库迁移失败 | 阻塞 T1-3/T1-4 | 预生产环境先演练，备份数据 |
+| T1-2 身克富算法争议 | 阻塞 T1-6 | 产品经理确认算法细节，提供 mock 数据 |
+| T1-9 shop_ 表设计与 danshop 冲突 | 阻塞 T1-10 | 与 danshop 团队确认表结构兼容性 |
+| T1-7 DAN 优化范围不明确 | 阻塞任务 | 启动前召开需求澄清会（≤ 1 小时） |
+
+---
+
+## 验证清单
+
+### 每日验证
+
+- [ ] 代码提交前运行 `mvn clean compile`（后端）或 `npm run build`（前端）
+- [ ] 单元测试通过率 100%
+- [ ] LSP 诊断零错误
+
+### Sprint 结束验证
+
+- [ ] 所有任务标记为 completed
+- [ ] 集成测试通过率 ≥ 95%
+- [ ] 无阻塞性 Bug（Blocker/Critical）
+- [ ] 文档更新（PLAN 文件 + PROJECT-OVERVIEW.md）
+
+---
+
+**文档结束**

docs/superpowers/tickets/TASK-P0-001-generation-refactor.md

@@ -0,0 +1,220 @@
+# P0 任务工作票 — 家庭成员辈分重构
+
+**任务 ID:** TASK-P0-001  
+**优先级:** P0（阻塞性）  
+**预计工时:** 3-5 天（后端 3d + 前端 2d）  
+**状态:** 待开始  
+**负责人:** 待分配  
+**关联文档:** `plans/2026-07-07-家庭成员辈分重构实施计划.md`
+
+---
+
+## 业务背景
+
+当前家庭成员关系使用 `relationship_types` 表定义关系类型（spouse/parent/child/sibling），存在以下问题：
+
+1. **关系类型与辈分耦合**——spouse/parent/child/sibling 混合了辈分和关系性质
+2. **无法表达多代关系**——缺少祖辈/孙辈等辈分定义
+3. **视角转换复杂**——需要遍历关系树计算相对标签
+
+辈分重构用 `generation`（辈分值）模型替代关系类型，简化视角转换逻辑。
+
+---
+
+## 范围
+
+### 包含
+
+- 数据库迁移：添加 `generation`、`is_spouse` 列，迁移旧数据，删除废弃列和表
+- 后端实体/DTO/Service 重写
+- 管理端（cfc-web）关系类型管理页面删除，成员添加页面改为辈分选择器
+- 小程序前端 `GenerationPicker` 组件，替换 `RelationshipPicker`
+
+### 不包含
+
+- 家庭关系图谱 UI 重设计（已独立完成）
+- 成员卡片样式变更（仅数据模型变更）
+- 其他维度功能
+
+---
+
+## 技术方案
+
+### 数据库变更
+
+```sql
+-- 迁移 1: 添加新列
+ALTER TABLE family_members
+  ADD COLUMN generation INT COMMENT '辈分值（0=家庭创建者，+n=向上，-n=向下）',
+  ADD COLUMN is_spouse TINYINT(1) DEFAULT 0 COMMENT '是否配偶（同辈）';
+
+-- 迁移 2: 旧数据映射
+UPDATE family_members SET generation = 0, is_spouse = 1 WHERE relationship_type = 'spouse';
+UPDATE family_members SET generation = 1  WHERE relationship_type = 'parent';
+UPDATE family_members SET generation = -1 WHERE relationship_type = 'child';
+UPDATE family_members SET generation = 0  WHERE relationship_type = 'sibling';
+UPDATE family_members SET generation = 0  WHERE generation IS NULL;
+
+-- 迁移 3: 删除废弃列（确认无引用后）
+ALTER TABLE family_members DROP COLUMN relationship_type;
+ALTER TABLE family_members DROP COLUMN role_override;
+
+-- 迁移 4: 删除关系类型表
+DROP TABLE IF EXISTS relationship_types;
+```
+
+### 后端改动
+
+| 文件 | 改动类型 | 说明 |
+|------|----------|------|
+| `enums/GenerationLevel.java` | 新建 | 7级辈分枚举 |
+| `entity/FamilyMember.java` | 修改 | 删除 relationshipType/roleOverride，新增 generation/isSpouse |
+| `dto/FamilyMemberVO.java` | 修改 | 删除 relationshipType/relationshipTypeName，新增 generation |
+| `dto/AddFamilyMemberDTO.java` | 新建 | relativeMemberId + generationLevel + peerType |
+| `service/FamilyMemberService.java` | 重写 | computeEffectiveRole, computeRelativeLabel, addMember, listMembers, toFamilyMemberVO |
+| `controller/family/FamilyMembersController.java` | 修改 | 更新请求/响应 DTO |
+| `config/DatabaseInitializer.java` | 修改 | 新增 4 个迁移 |
+| `mapper/FamilyMemberMapper.java` | 无改动 | - |
+| `schema.sql` | 同步 | 更新表结构 |
+
+### 前端改动
+
+| 文件 | 改动类型 | 说明 |
+|------|----------|------|
+| `utils/generationLevel.js` | 新建 | 辈分选项常量（7级 + 同辈类型） |
+| `components/GenerationPicker.vue` | 新建 | 辈分选择器组件 |
+| `components/RelationshipPicker.vue` | 删除 | 旧关系类型选择器 |
+| `pages/family/member-add.vue` | 修改 | 替换关系类型选择为辈分选择 |
+| `pages/family/member-edit.vue` | 修改 | 同上 |
+| `cfc-web/src/views/family/member-add.vue` | 修改 | 管理端成员添加页面 |
+| `cfc-web/src/router/family.js` | 无改动 | - |
+
+---
+
+## API 变更
+
+### 废弃端点
+
+| 端点 | 操作 | 替代方案 |
+|------|------|----------|
+| `GET /api/family/member/types` | 获取关系类型列表 | 删除（前端使用 generationLevel.js 常量） |
+| `POST /api/admin/relationship-type/save` | 保存关系类型 | 删除（关系类型不再可配置） |
+| `POST /api/admin/relationship-type/list` | 查询关系类型 | 删除 |
+
+### 修改端点
+
+| 端点 | 请求体变更 | 响应体变更 |
+|------|-----------|-----------|
+| `POST /api/family/member/add` | `{relativeMemberId, generationLevel, peerType?, ...}` | `{..., generation}` |
+| `POST /api/family/member/list` | 无 | 移除 `relationshipType`、`relationshipTypeName`，新增 `generation` |
+| `POST /api/family/member/update` | 同上 | 同上 |
+
+---
+
+## 验收标准
+
+### 功能验收
+
+- [ ] 添加成员时可选择辈分（7级）和同辈类型（亲兄弟姐妹/配偶）
+- [ ] 添加配偶后，`is_spouse=1`，`generation=0`
+- [ ] 添加子侄辈后，`generation=-1`
+- [ ] 成员列表显示正确的相对标签（"我"、"爸爸"、"妈妈"、"儿子"、"女儿"等）
+- [ ] 家长切换视角后，相对标签自动更新
+- [ ] 管理端成员添加页面无关系类型字段
+
+### 数据迁移验收
+
+- [ ] 旧数据 `relationship_type='spouse'` → `generation=0, is_spouse=1`
+- [ ] 旧数据 `relationship_type='parent'` → `generation=1`
+- [ ] 旧数据 `relationship_type='child'` → `generation=-1`
+- [ ] 旧数据 `relationship_type='sibling'` → `generation=0, is_spouse=0`
+- [ ] 迁移后 `SELECT relationship_type FROM family_members` 返回空
+
+### 代码质量验收
+
+- [ ] `mvn clean compile` 零错误
+- [ ] 单元测试覆盖率 ≥ 80%（核心方法）
+- [ ] LSP 诊断零错误
+- [ ] `grep -r "relationshipType" cfc-backend/src/main/java` 返回空
+- [ ] `grep -r "RelationshipType" cfc-backend/src/main/java` 返回空
+- [ ] 前端小程序编译零警告
+
+### 性能验收
+
+- [ ] 成员列表 API 响应时间 ≤ 200ms（100 个成员以内）
+- [ ] 相对标签计算性能：1000 次调用 ≤ 50ms
+
+---
+
+## 测试策略
+
+### 单元测试（后端）
+
+```java
+@Test
+void computeRelativeLabel_shouldReturnCorrectLabel() {
+    // 测试所有辈分组合
+    // case: 我 vs 爸爸 (genDiff=1) → "爸爸"
+    // case: 我 vs 儿子 (genDiff=-1) → "儿子"
+    // case: 我 vs 配偶 (genDiff=0, isSpouse=true) → "配偶"
+    // case: 我 vs 兄弟 (genDiff=0, isSpouse=false) → "哥哥"/"弟弟"（按年龄）
+}
+```
+
+### 集成测试（后端）
+
+```java
+@Test
+void addMember_withGenerationLevel_shouldPersistGeneration() {
+    // 添加配偶
+    // 验证 generation=0, is_spouse=1
+    // 添加子侄辈
+    // 验证 generation=-1
+}
+```
+
+### E2E 测试（前端）
+
+- 添加成员流程：选择参照成员 → 选择辈分 → 填写信息 → 提交成功
+- 成员列表：显示正确的相对标签
+- 视角切换：切换角色后标签自动更新
+
+---
+
+## 部署检查清单
+
+- [ ] 数据库迁移脚本在预生产环境演练通过
+- [ ] 生产环境数据库备份完成
+- [ ] 回滚方案准备（恢复 relationship_type 列和表）
+- [ ] 管理端关系类型管理页面已下线
+- [ ] 小程序前端新版本已提交审核
+- [ ] 监控指标：`family_member_add_duration`、`relative_label_compute_duration`
+
+---
+
+## 回滚计划
+
+### 触发条件
+
+- 数据迁移失败且无法恢复
+- 核心功能（添加成员、成员列表）严重故障
+- 性能下降 ≥ 50%
+
+### 回滚步骤
+
+1. 数据库回滚：恢复 `relationship_type`、`role_override` 列，恢复 `relationship_types` 表
+2. 代码回滚：切换至上一版本分支
+3. 前端回滚：小程序回滚至旧版本
+4. 验证：核心功能恢复，数据无丢失
+
+---
+
+## 联系信息
+
+- **技术负责人:** 见 Git 仓库 MAINTAINERS.md  
+- **产品负责人:** 见 PROJECT-OVERVIEW.md 维护字段  
+- **DevOps 支持:** 见 cfc-backend/start.sh
+
+---
+
+**文档结束**

docs/superpowers/tickets/TASK-P0-002-wealth-dimension-split.md

@@ -0,0 +1,246 @@
+# P0 任务工作票 — 富维度子维度拆分 + 身克富杠杆
+
+**任务 ID:** TASK-P0-002  
+**优先级:** P0（阻塞性）  
+**预计工时:** 2-3 天（后端 2d + 前端 1d）  
+**状态:** 待开始  
+**负责人:** 待分配  
+**关联文档:** `plans/2026-07-12-wealth-dimension-redesign.md`
+
+---
+
+## 业务背景
+
+当前"富"维度的问题：
+
+1. **成人和孩子的"富"混为一谈**——成人=积分总量/500，孩子=积分获取效率，没有差异化的"富"定义
+2. **缺少身克富的系统体现**——相克关系只有文档，没有在能量计算和前端落地
+3. **小程序富页面是大杂烢**——显示的是"行动数据"和"成长报告"，与"富"无关
+
+本任务重构 `EnergyService` 中 `calcChildWealth` / `calcParentWealth`，拆为子维度，实现身克富杠杆，并重写富页面。
+
+---
+
+## 范围
+
+### 包含
+
+- 后端 `MemberEnergyDTO` 新增子维度字段和身克富字段
+- `EnergyService.calcChildWealth` / `calcParentWealth` 重构为子维度加权
+- 新增 `applyBodyWealthRestraint()` 身克富杠杆算法
+- 新增 `POST /api/energy/wealth-detail` API
+- 小程序 `pages/wealth/index.vue` 完全重写（角色感知）
+- 新建 `WealthSubScores.vue`、`BodyWealthAlert.vue` 组件
+
+### 不包含
+
+- 成就/网络录入接口（第一阶段占位返回 0）
+- 新数据库表（不改变 schema）
+- 章鱼图（FamilyRelationGraph）集成（Phase 3）
+- 圈子系统（Phase 2）
+
+---
+
+## 技术方案
+
+### 数据模型
+
+#### MemberEnergyDTO 新增字段
+
+```java
+// 富的子维度（parent）
+private Integer wealthIncome;       // 金钱/收入（现有积分算法）
+private Integer wealthAchievement;  // 社会成就（User.achievements JSON，第一阶段 0）
+private Integer wealthNetwork;      // 资源网络（推荐团队人数，第一阶段 0）
+
+// 富的子维度（child）
+private Integer wealthEducation;    // 学业成绩（DanAssessmentResult 最近3次综合分+趋势）
+private Integer wealthSocial;       // 社交筹码（活动参与次数，第一阶段 0）
+private Integer wealthPoints;       // 规则博弈（现有积分效率逻辑）
+
+// 身克富标记
+private String bodyWealthStatus;    // normal / overdraw / penalty
+private String bodyWealthMessage;   // 用户可见的消息
+```
+
+### 算法设计
+
+#### 孩子富计算（权重：教育 30% + 社交 20% + 积分 50%）
+
+```java
+calcChildWealth(child, dto) {
+    dto.wealthEducation = calcChildWealthEducation(child);  // DanAssessmentResult
+    dto.wealthSocial = calcChildWealthSocial(child);        // 活动参与次数
+    dto.wealthPoints = calcChildWealthPoints(child);        // 现有积分效率
+    return weightedSum(education*0.3, social*0.2, points*0.5);
+}
+```
+
+#### 成人富计算（权重：收入 50% + 成就 30% + 网络 20%）
+
+```java
+calcParentWealth(parent, dto) {
+    dto.wealthIncome = calcParentWealthIncome(parent);      // 现有积分算法
+    dto.wealthAchievement = calcParentWealthAchievement(parent);  // User.achievements
+    dto.wealthNetwork = calcParentWealthNetwork(parent);    // 推荐团队人数
+    return weightedSum(income*0.5, achievement*0.3, network*0.2);
+}
+```
+
+#### 身克富杠杆
+
+```java
+applyBodyWealthRestraint(bodyScore, wealthScore, dto) {
+    if (bodyScore < 40) {
+        dto.bodyWealthStatus = "penalty";
+        dto.bodyWealthMessage = "健康基础薄弱，财富能量被稀释";
+        return wealthScore * (0.5 + 0.5 * bodyScore / 100);  // 打 5-9 折
+    } else if (bodyScore < 50 && wealthScore > bodyScore + 20) {
+        dto.bodyWealthStatus = "overdraw";
+        dto.bodyWealthMessage = "身体健康与财富能量不匹配，注意透支风险";
+        return wealthScore;  // 不下调，仅预警
+    } else {
+        dto.bodyWealthStatus = "normal";
+        dto.bodyWealthMessage = bodyScore >= 70 ? "身体底盘稳固，财富能量健康" : null;
+        return wealthScore;
+    }
+}
+```
+
+### 前端页面布局
+
+```
+[PageBanner] "利他创富 · 价值共享"
+[身克富状态条]  身体分解 + 财力素养 + 消息行
+[三子维度卡片]  根据 role 显示成人/孩子子维度
+[增值服务入口]  记账打卡 / 保单管理 / 创客中心 / 成就系统 / 成长报告
+[底部菜单]      精简后的操作入口
+```
+
+---
+
+## API 设计
+
+### 新增端点
+
+```
+POST /api/energy/wealth-detail
+请求: { memberId: Long, memberType: "parent" | "child" }
+响应: MemberEnergyDTO（包含所有子维度 + 身克富字段）
+```
+
+### 修改端点
+
+| 端点 | 改动 | 说明 |
+|------|------|------|
+| `POST /api/energy/overview` | 响应 `energy.wealth` 字段改为总分（不变） | 保持向后兼容 |
+| `POST /api/energy/detail` | 响应增加子维度字段（可选） | 可选扩展 |
+
+---
+
+## 验收标准
+
+### 功能验收
+
+- [ ] 家长端富页面显示 3 个子维度卡片：金钱/收入、社会成就、资源网络
+- [ ] 孩子端富页面显示 3 个子维度卡片：学业成绩、社交筹码、规则博弈
+- [ ] 身克富状态条正确显示身体和财富进度条 + 状态消息
+- [ ] 身克富三种状态可触发（normal/overdraw/penalty）
+- [ ] 点击子维度卡片可跳转详情页（占位即可）
+- [ ] 原"行动数据"区块已移除
+
+### 数据验收
+
+- [ ] `wealthEducation` 从 DanAssessmentResult 计算（最近 3 次测评）
+- [ ] `wealthPoints` 从现有积分效率逻辑计算
+- [ ] `wealthIncome` 从现有积分总量计算
+- [ ] 未实现子维度（achievement/network/social）返回 0
+
+### 性能验收
+
+- [ ] 财富详情 API 响应时间 ≤ 300ms
+- [ ] 富页面首屏加载时间 ≤ 1.5s
+- [ ] 无内存泄漏（连续切换角色 10 次）
+
+### 代码质量验收
+
+- [ ] 后端单元测试覆盖率 ≥ 80%（EnergyService 新增方法）
+- [ ] 前端组件单元测试（可选，≥ 50%）
+- [ ] LSP 诊断零错误
+- [ ] 无 AI slop 模式（可选链、CSS Grid）
+
+---
+
+## 测试策略
+
+### 后端单元测试
+
+```java
+@Test
+void calcChildWealth_shouldWeightCorrectly() {
+    // 教育 30% + 社交 20% + 积分 50%
+    // 验证加权计算精度（保留整数）
+}
+
+@Test
+void applyBodyWealthRestraint_penaltyTriggered() {
+    // bodyScore=35, wealthScore=80
+    // 预期: status=penalty, wealth=80*(0.5+0.5*35/100)=67
+}
+
+@Test
+void applyBodyWealthRestraint_overdrawTriggered() {
+    // bodyScore=45, wealthScore=80
+    // 预期: status=overdraw, wealth=80（不下调）
+}
+```
+
+### 集成测试
+
+```java
+@Test
+void wealthDetailApi_shouldReturnSubScores() {
+    // 调用 POST /api/energy/wealth-detail
+    // 验证响应包含所有子维度字段
+    // 验证 bodyWealthStatus 为三者之一
+}
+```
+
+### 前端 E2E 测试
+
+- 访问富页面，验证子维度卡片数量（家长 3 个，孩子 3 个）
+- 触发身克富条件（修改 mock 数据），验证预警条显示
+- 点击子维度卡片，验证跳转（或占位提示）
+
+---
+
+## 部署检查清单
+
+- [ ] 后端 `MemberEnergyDTO` 序列化兼容性测试（旧客户端不崩溃）
+- [ ] 小程序富页面灰度发布（10% 用户）
+- [ ] 监控指标：`wealth_detail_duration`、`body_wealth_restraint_count`
+- [ ] 回滚方案：旧富页面代码保留在 `pages/wealth/index.legacy.vue`
+
+---
+
+## 风险与缓解
+
+| 风险 | 影响 | 缓解 |
+|------|------|------|
+| 子维度权重争议 | 用户感知不公平 | 产品经理确认权重，提供 A/B 测试开关 |
+| 身克富算法引发用户不满 | 用户体验下降 | 消息文案温和化，提供"了解更多"说明页 |
+| 成就/网络数据缺失导致显示 0 | 用户困惑 | 显示"暂无数据"占位符，不显示 0 |
+| 富页面重写引入回归 | 功能缺失 | 逐项对照旧页面功能清单，确保无遗漏 |
+
+---
+
+## 后续迭代（Phase 3）
+
+- [ ] 成就录入接口（家长填写成就，系统评分）
+- [ ] 资源网络可视化（章鱼图嵌入富页面）
+- [ ] 圈子系统集成（显示参与中的圈子）
+- [ ] 身克富正向激励（身体优秀时财富加成）
+
+---
+
+**文档结束**