# 浠艾福 项目全景 — 阶段性需求与设计汇总

**文档版本:** v1.4
**日期:** 2026-07-24
**状态:** 已确认（v1.4 Phase 5 全栈完成 + 文档审计）
**维护:** 所有需求变更需更新本文档

---

## 一、项目阶段总览

| 阶段 | 时间 | 主题 | 核心交付 | 状态 |
|:----:|------|------|----------|:----:|
| **Phase 0** | 2026-03~05 | 基础搭建 | 骨架、5 Tab页、能量系统萌芽 | ✅ 已上线 |
| **Phase 1** | 2026-06~07 | 五维平台核心 | 五维重构、家庭成员体系、文章中心、推广体系 | 🚧 进行中 |
| **Phase 2** | 2026-07~08 | 商业模式 & AI 落地 | LangGraph前端集成、家庭推广体系、AI健康管家 | 🚧 进行中 |
| **Phase 3** | 2026-Q3 | 五维增强 | 富维度子维度拆分、文章发布系统 | 🚧 进行中（文章系统已完成，富维度部分实施） |
| **Phase 4** | 2026-Q4 | 平台扩展 | 供应商体系、健康7维模型、成长档案 | 🚧 进行中（成长档案已完成） |
| **Phase 5** | 2026-Q3 | 主动健康六阶模型 | 微启动+即时反馈+智能预警+身份重塑+家庭互动+社区扩散 | ✅ 已完成（P0-P3 全栈交付） |

---

## 二、跨维度功能（所有阶段）

### 2.1 AI 架构升级 — LangGraph Sidecar ⭐ P0

**阶段:** Phase 2/3
**状态:** ✅ Phase 1 代码全量完成 + Docker 已部署运行（LLM healthy）；Phase 2-4 代码已写但前端未集成，已纳入 `plans/2026-07-22-comprehensive-implementation.md` Phase 2 Wave 1-2
**决策:** 2026-07-20 确定：Python LangGraph Sidecar 替换 Dify，Java 8 不升级

| 里程碑 | 内容 | 关联文档 |
|--------|------|---------|
| **Phase 1** (1-2周) | 基建 + RecommendAgent + AiGateway + Docker | `plans/2026-07-20-langgraph-phase1.md` |
| **Phase 2-4** | 代码已写（Chat/Analysis/Recommend+RAG+Memory+Monitoring），前端集成待实施 | `plans/2026-07-22-comprehensive-implementation.md` |

**核心设计:** `specs/2026-07-20-langgraph-migration-design.md`
**需求汇总:** `specs/2026-07-20-langgraph-requirements-summary.md` ⚠️ **文件缺失**

---

### 2.2 五维能量系统 ⭐ P0

**阶段:** Phase 0/1（核心已上线，持续完善）
**状态:** 🟢 已实施（核心 v2.1）

| 功能 | 状态 | 关联文档 |
|------|:----:|---------|
| 维度定义 + 能量流水 + 余额表 | ✅ 核心已上线 | `specs/2026-06-05-five-dimension-energy-design.md` |
| 五行相生算法 | ✅ 已上线 | `specs/2026-06-08-five-dimension-wuxing-philosophy.md` |
| 五行相克算法（v2.0 信号层） | ✅ 已上线 | `specs/2026-07-12-wuxing-ke-full-design.md` |
| 首页与能量转化算法 | ✅ 已上线 | `specs/2026-07-12-wuxing-homepage-and-conversion-algorithm.md` |
| 维度功能清单与能量映射 | 🟡 设计稿 | `specs/2026-07-12-dimension-features-energy-map.md` |
| 富维度子维度拆分 + 身克富杠杆 | 🚧 部分实施（前端 WealthSubScores.vue + BodyWealthAlert.vue 已存在，后端子维度体系待完善） | `plans/2026-07-12-wealth-dimension-redesign.md` + `plans/2026-07-22-comprehensive-implementation.md` |
| 维度权重滑块重设计 | ✅ 已实施 | `specs/2026-07-02-dimension-weight-picker-redesign.md` |

---

### 2.3 家庭成员体系 ⭐ P1

**阶段:** Phase 1
**状态:** 🚧 进行中

| 功能 | 状态 | 关联文档 |
|------|:----:|---------|
| 家庭成员辈分重构（generation模型） | ✅ 全栈完成（后端 GenerationLevel.java + FamilyMemberService generation-diff 标签体系；前端 GenerationPicker.vue + generationLevel.js 常量映射 + 删除旧 RelationshipPicker.vue 死代码） | `specs/2026-07-07-家庭成员关系视角转换设计.md` + `plans/2026-07-07-家庭成员辈分重构实施计划.md` |
| 家庭成员关系图谱（Canvas重设计） | ✅ 已实施，广泛集成（FamilyRelationGraph.vue 797行，10+页面使用） | `specs/2026-06-19-family-relation-graph-design.md` + `specs/2026-06-22-family-relation-graph-redesign.md` |
| 家庭成员卡片（跨页展示+可见性） | ✅ 已上线 | `specs/2026-06-15-family-member-cards-design.md` + `plans/2026-06-15-family-member-cards.md` |
| 成员详情页维度专属内容区 | ✅ 已实施（member-detail.vue 505行 + 4维度section组件 879行） | `specs/2026-07-14-member-detail-dimension-sections.md` |

---

### 2.4 用户体验优化

| 功能 | 阶段 | 状态 | 关联文档 |
|------|:----:|:----:|---------|
| 首次登录跳过身份选择+地址字段 | Phase 1 | ✅ 已实施（login.vue已修改，user-edit.vue已存在） | `specs/2026-07-16-first-login-auto-complete.md` + `plans/2026-07-16-first-login-auto-complete-plan.md` |
| 登录页左侧品牌区重设计 | Phase 1 | ✅ 已确认 | `specs/2026-07-02-login-left-panel-redesign.md` |
| 富沛（我的）页面重构 | Phase 1 | ✅ 已完成（profile/ 6组件 1338行，已移除富模块） | `specs/2026-06-19-profile-page-redesign.md` |
| 行远页重要关系维护（通讯录） | Phase 1 | ✅ 已完成（action/ 5页面 2116行，含OctopusGraph+问卷+互动日志） | `specs/2026-06-14-action-page-relationship-design.md` |
| 登录前浏览体验（未登录可见内容） | Phase 1 | ✅ 已完成（多页面游客态+wuxing-sandbox preview模式） | `specs/2026-06-04-pre-login-discovery-design.md` |

---

## 三、维度专属功能

### 3.1 🌏 身（Body / 土）— 健康管理

**核心功能:** 精准营养推荐、健康报告解析、体质调理方案、主动健康行为改进

| 功能 | 阶段 | 状态 | 关联文档 |
|------|:----:|:----:|---------|
| 菌群报告页面重构（200+菌属全覆盖） | Phase 1 | ✅ 已完成（4页面 1214行 + HealthKnowledgeBase后端） | `specs/2026-07-17-flora-microbiome-report-page-design.md` + `plans/2026-07-17-flora-microbiome-report-implementation.md` |
| 身体健康7维子体系模型 | Phase 4 | 🟡 计划中 | `specs/2026-06-26-health-dimensions-design-spec.md` |
| 成长档案重建 | Phase 4 | 🟡 计划中 | `specs/2026-06-22-growth-record-rebuild-design.md` |
| 营养健康部分缺陷修复 | Phase 1 | 🟡 计划中 | `plans/2026-06-22-营养健康部分缺陷修复计划.md` |
| 主动健康六阶模型改进（P0-P3） | Phase 5 | 🚧 设计稿 | `specs/2026-07-22-active-health-six-stage-design.md` (设计总纲) |

---

### 3.2 ⚔️ 智（Wisdom / 金）— 心智成长

**核心功能:** 专业心智测评、综合素质培养、成长档案追踪

| 功能 | 阶段 | 状态 | 关联文档 |
|------|:----:|:----:|---------|
| 五维 TabBar 页面统一改造 | Phase 1 | ✅ 核心完成（body 843行/mind 1367行/wisdom 783行/wealth 780行/action 755行，均有真实UI） | `specs/2026-06-13-five-dimension-pages-redesign.md` |
| DAN测评结果展示+六维雷达图 | Phase 1 | 🟡 已上线（双Tab） | — |
| DAN测评执行记录双角色模型（assessor/planner分离） | Phase 1 | ✅ 已实施（4 commits：实体+Service+Controller+前端） | — |
| 认知测评题目录入优化 | Phase 1 | 🟡 计划中 | `plans/2026-07-13-dan-assessment-phase2-5.md` |

---

### 3.3 💧 富（Wealth / 水）— 利他创富

**核心功能:** 创客成长生态、积分奖励体系、服务套餐市场

| 功能 | 阶段 | 状态 | 关联文档 |
|------|:----:|:----:|---------|
| 富维度子维度拆分 + 身克富杠杆 | Phase 3 | 🚧 部分实施（前端组件已存在，后端待完善） | `plans/2026-07-12-wealth-dimension-redesign.md` + `plans/2026-07-22-comprehensive-implementation.md` |
| 积分价格整数化迁移 | Phase 1 | ✅ 已上线 | `plans/2026-06-15-integer-price-migration.md` |
| 富沛（我的）页面重构 | Phase 1 | ✅ 已完成（profile/ 6组件 1338行） | `specs/2026-06-19-profile-page-redesign.md` |

---

### 3.4 🌿 行（Action / 木）— 人际和谐

**核心功能:** 亲子关系建设、夫妻情感经营、社交与人脉拓展

| 功能 | 阶段 | 状态 | 关联文档 |
|------|:----:|:----:|---------|
| 家庭推广体系重构（wxacode+家庭账户） | Phase 2 | 🚧 P2-P4待实施（P1后端+前端基础页面已完成：invite/join.vue, parent/invite/index.vue, guide/invite/share.vue） | `specs/2026-07-14-family-promotion-redesign.md` + `plans/2026-07-14-family-promotion.md` |
| 行远页重要关系维护（通讯录导入） | Phase 1 | ✅ 已完成（action/ 5页面 2116行，含OctopusGraph+问卷+互动日志） | `specs/2026-06-14-action-page-relationship-design.md` |
| 家庭关系图谱（见跨维度） | — | ✅ 已实施（FamilyRelationGraph.vue 797行，10+页面使用） | 见 2.3 |

---

### 3.5 🔥 心（Mind / 火）— 大爱相随

**核心功能:** 情绪认知与疏导、家庭关系心理学、人格与性格探索

| 功能 | 阶段 | 状态 | 关联文档 |
|------|:----:|:----:|---------|
| 心·智双Tab结构（心智页面） | Phase 1 | ✅ 已上线 | — |
| 情绪打卡数据接入 | Phase 2 | ✅ 已完成（mind/ 6文件 4837行，含效价网格+Plutchik轮+趋势图+EMI报告） | — |

---

## 四、内容与商业化

### 4.1 文章与内容运营 ⭐ P1

**阶段:** Phase 1
**状态:** 🚧 实施中

| 功能 | 状态 | 关联文档 |
|------|:----:|---------|
| 文章中心主页（发现页重建） | ✅ 已完成（4页面 1429行 + ArticleController + DB表） | `specs/2026-07-03-article-center-design.md` + `plans/2026-07-03-article-center-implementation.md` |
| 文章发布系统（运营审核流程） | ✅ 已实施（AdminArticleController + ReviewCenterController + ArticleService.auditArticle） | `plans/2026-07-22-comprehensive-implementation.md` |
| 文章与活动发布系统（合并版） | ✅ 已实施（同上） | `specs/2026-06-09-article-activity-publishing-design.md` |
| 公众号内容发布（Dify工作流） | 🔄 已废弃（由LangGraph + Python发布脚本替代） | — |

---

### 4.2 电商与供应体系 ⭐ P1

**阶段:** Phase 1/2
**状态:** 🚧 进行中

| 功能 | 阶段 | 状态 | 关联文档 |
|------|:----:|:----:|---------|
| CFC原生电商扩展（shop_前缀表） | Phase 1 | ✅ 已结束（Product体系已完整可用，shop_前缀表无需迁移） | `specs/2026-06-24-cfc-ecommerce-extension-design.md` |
| 供应商销售体系（体系账期+留利） | Phase 2 | 🟡 设计稿 | `specs/2026-07-05-supply-distribution-system-design.md` + `plans/2026-07-05-supply-distribution-system.md` |
| 商品规格最小购买数限制 | Phase 4 | 🟡 计划中 | `plans/2026-07-13-supplier-system-gap-fix.md` |
| 供应商订单修复 | Phase 4 | 🟡 计划中 | `plans/2026-06-20-danshop-order-fix.md` |

---

### 4.3 家庭会员体系 ⭐ P2

**阶段:** Phase 2
**状态:** ✅ 后端完成（MemberSubscriptionService + MembershipController），前端已完成（membership/index.vue 685行 + 3子页面），AI管家 Phase 2 Wave 3 计划中

| 功能 | 关联文档 |
|------|---------|
| 一生一世家庭会员（订阅制+推广返利） | `specs/2026-07-09-family-membership-design.md` |
| 订阅+推广核心实施（P0） | `plans/2026-07-09-family-membership-core.md` |
| AI健康管家+推荐引擎（P1） | `plans/2026-07-22-comprehensive-implementation.md`（Phase 2 Wave 3） |

---

## 五、管理端功能

### 5.1 Web 管理端 ⭐ P1

| 功能 | 阶段 | 状态 | 关联文档 |
|------|:----:|:----:|---------|
| 权限系统升级（多角色合并模式） | Phase 1 | 🟡 设计稿 | `specs/2026-06-20-web-permission-system-design.md` + `plans/2026-06-20-web-permission-system.md` |
| Web端E2E测试修复 | Phase 1 | ✅ 已结束 | `plans/2026-06-20-cfc-web-e2e-test-fix.md` |
| Web端重构（代码质量） | Phase 1 | ✅ 已结束 | `plans/2026-06-20-cfc-web-refactor.md` |
| 维度知识库动态管理平台 | Phase 1 | ✅ 已实施（KnowledgeBaseController + HealthKnowledgeBaseController + DifySyncService） | `specs/2026-06-20-dimension-knowledge-base-design.md` + `plans/2026-06-20-dimension-knowledge-base-plan.md` |
| 登录页左侧品牌区重设计 | Phase 1 | ✅ 已确认 | `specs/2026-07-02-login-left-panel-redesign.md` |

---

## 六、已完成功能（参考）

| 功能 | 完成时间 | 关联文档 |
|------|---------|---------|
| 五维能量系统核心（方案B：维度表+流水+余额） | 2026-06 | `specs/2026-06-05-five-dimension-energy-design.md` |
| 五行相生相克哲学体系 | 2026-06 | `specs/2026-06-08-five-dimension-wuxing-philosophy.md` |
| 5 Tab页基础结构 | 2026-06 | `plans/2026-06-11-5-tab-pages.md` |
| 访客模式 | 2026-06 | `plans/2026-06-13-guest-mode-implementation.md` |
| 综合差异修复 | 2026-06 | `plans/2026-06-15-comprehensive-discrepancy-fix.md` |
| 维度页面差距修复（Phase 1） | 2026-07 | `plans/2026-07-12-dimension-pages-gap-fix.md` |
| DAN测评执行记录双角色模型（assessor/planner分离） | 2026-07 | — |
| 家庭成员辈分重构（全栈） | 2026-07 | `plans/2026-07-07-家庭成员辈分重构实施计划.md` |

---

## 七、已废弃/归档文档

> 以下文档已被新设计取代或决策否决，已移至 `docs/backup/`

| 原路径 | 取代文档 | 决策日期 |
|--------|---------|---------|
| `docs/architecture/SpringBoot3升级+Dify替代实施计划.md` | LangGraph Sidecar | 2026-07-20 |
| `docs/architecture/Dify替代迁移可行性分析.md` | LangGraph Sidecar | 2026-07-20 |
| `docs/architecture/2026-07-20-SB3-upgrade-plan.md` | LangGraph Sidecar | 2026-07-20 |
| `docs/数据与AI结合技术方案.md` | LangGraph Sidecar | 2026-07-20 |
| `docs/实现计划.md` | LangGraph Sidecar | 2026-07-20 |
| `docs/superpowers/specs/精准营养推荐系统设计方案.md` | LangGraph RecommendAgent | 2026-07-20 |
| `docs/superpowers/specs/2026-07-19-knowledge-base-v3-data-refactor.md` | LangGraph Phase 3 | 2026-07-20 |
| `docs/superpowers/plans/2026-06-20-精准营养推荐系统实现计划.md` | LangGraph Phase 1 | 2026-07-20 |
| `docs/superpowers/plans/2026-06-22-食谱推荐系统实现计划.md` | LangGraph Phase 1 | 2026-07-20 |
| `docs/superpowers/plans/2026-06-22-菌群报告Schema补全计划.md` | LangGraph Phase 3 | 2026-07-20 |
| `docs/superpowers/specs/2026-06-23-P0营养师核心功能设计方案.md` | LangGraph Phase 3 | 2026-07-20 |
| `docs/superpowers/plans/2026-06-23-P0营养师核心功能实现计划.md` | LangGraph Phase 3 | 2026-07-20 |
| `docs/superpowers/specs/2026-06-22-食谱推荐系统设计方案.md` | LangGraph Phase 1 | 2026-07-20 |
| `docs/superpowers/plans/2026-06-24-P1营养师功能实现计划.md` | LangGraph Phase 3 | 2026-07-20 |
| `docs/superpowers/specs/2026-06-24-P1营养师功能设计方案.md` | LangGraph Phase 3 | 2026-07-20 |

---

## 八、技术债务与待办

| 类别 | 项 | 优先级 | 关联 |
|------|-------|:------:|------|
| **安全** | 确定性缺口修复 | P1 | `plans/2026-07-10-determinism-gap-fix-plan.md` — 部分被Phase 5 / LangGraph覆盖 |
| **Bug** | 维度页面差距修复（Phase 2） | P1 | `plans/2026-07-12-dimension-pages-gap-fix.md` |
| **Bug** | 供应商体系缺口修复 | P2 | `plans/2026-07-13-supplier-system-gap-fix.md` |
| **Bug** | 家庭关系图修复 | P2 | ✅ 已修复（FamilyRelationGraph.vue 797行，10+页面使用） |
| **Bug** | 营养健康部分缺陷修复 | P2 | `plans/2026-06-22-营养健康部分缺陷修复计划.md` — 部分被Phase 5覆盖 |

---

## 九、关键约束

| 约束 | 说明 |
|------|------|
| **JDK** | Java 8 不升级（LangGraph sidecar 方案决定） |
| **框架** | Spring Boot 2.7.18 不升级 |
| **数据库** | MySQL 8.0（无向量检索能力，RAG 使用 ChromaDB 文件模式） |
| **AI** | Dify 迁移至 Python LangGraph sidecar（Phase 3 前保留 fallback） |
| **前端** | uni-app Vue 2（禁用可选链、禁用 CSS Grid） |
| **部署** | Docker Compose 或 systemd（按实际环境选择） |
| **中间件** | 不引入额外中间件（Phase 1-2 不使用 PostgreSQL） |

---

## 十、文档索引

### 规范文档（specs/）

| 文件 | 状态 | 说明 |
|------|:----:|------|
| `2026-07-22-comprehensive-implementation.md` | ✅ 当前 | 全面实施计划（Phase 2-4） |
| `2026-07-20-langgraph-migration-design.md` | ✅ 当前 | LangGraph 架构设计 |
| `2026-07-20-langgraph-requirements-summary.md` | ⚠️ 文件缺失 | 需求与决策汇总 |
| `2026-06-05-five-dimension-energy-design.md` | ✅ 已实施 | 五维能量系统（核心） |
| `2026-06-08-five-dimension-wuxing-philosophy.md` | ✅ 已实施 | 五行哲学体系 |
| `2026-07-12-wuxing-ke-full-design.md` | ✅ 已实施 | 五维相克完整设计 |
| `2026-07-12-wuxing-homepage-and-conversion-algorithm.md` | ✅ 已实施 | 首页与转化算法 |
| `2026-06-13-five-dimension-pages-redesign.md` | ✅ 核心完成 | 五维TabBar统一改造 |
| `2026-06-19-family-relation-graph-design.md` | ✅ 已实施（FamilyRelationGraph.vue 797行） | 家庭关系图谱 |
| `2026-06-22-family-relation-graph-redesign.md` | ✅ 已实施（10+页面集成） | FamilyRelationGraph重构 |
| `2026-07-07-家庭成员关系视角转换设计.md` | ✅ 全栈完成 | 辈分重构设计（GenerationLevel.java + FamilyMemberService + GenerationPicker.vue + generationLevel.js） |
| `2026-07-03-article-center-design.md` | ✅ 已实施（4页面 1429行 + ArticleController） | 文章中心设计 |
| `2026-07-09-family-membership-design.md` | ✅ 已实施（Service+Controller已完成，前端待实现） | 家庭会员体系 |
| `2026-07-14-family-promotion-redesign.md` | 🚧 后端完成，前端基础就绪 | 家庭推广体系 |
| `2026-07-17-flora-microbiome-report-page-design.md` | ✅ 已实施（4页面 1214行 + HealthKnowledgeBase） | 菌群报告页面 |
| `2026-06-24-cfc-ecommerce-extension-design.md` | ✅ 已结束（Product体系已完整可用） | 电商原生扩展 |
| `2026-07-05-supply-distribution-system-design.md` | 🟡 待实施 | 供应商销售体系 |
| `2026-06-20-dimension-knowledge-base-design.md` | ✅ 已实施（KnowledgeBaseController + DifySyncService） | 维度知识库平台 |
| `2026-06-20-web-permission-system-design.md` | 🔄 已暂停（未实现，待重新规划） | Web权限系统 |
| `2026-06-26-health-dimensions-design-spec.md` | 🟡 设计稿 | 身体健康7维模型 |
| `2026-06-22-growth-record-rebuild-design.md` | ✅ 已实施（GrowthRecordController 15.3K + growth/ 4页面） | 成长档案重建 |
| `2026-07-16-first-login-auto-complete.md` | ✅ 已实施（login.vue + user-edit.vue均已完成） | 首次登录优化 |
| `2026-07-14-member-detail-dimension-sections.md` | ✅ 已实施（member-detail.vue + 4维度section组件） | 成员详情维度区 |
| `2026-07-02-login-left-panel-redesign.md` | ✅ 已确认 | 登录页重设计 |
| `2026-07-02-dimension-weight-picker-redesign.md` | ✅ 已实施 | 维度权重重设计 |
| `2026-06-19-profile-page-redesign.md` | ✅ 已完成（profile/ 6组件 1338行） | 富沛页面重构 |
| `2026-06-15-family-member-cards-design.md` | ✅ 已上线 | 家庭成员卡片 |
| `2026-06-14-action-page-relationship-design.md` | ✅ 已完成（action/ 5页面 2116行） | 行远页关系维护 |
| `2026-06-09-article-activity-publishing-design.md` | ✅ 已实施（与文章发布系统合并交付） | 文章活动发布 |
| `2026-06-08-article-publishing-system-design.md` | ✅ 已实施（ArticleController + AdminArticleController） | 文章发布系统 |
| `2026-06-04-pre-login-discovery-design.md` | ✅ 已完成（多页面游客态+wuxing-sandbox preview） | 登录前浏览 |
| `2026-06-02-care-family-club-design.md` | ✅ 已实施（MembershipController + 家庭会员体系全功能） | 平台升级总纲 |
| `2026-07-12-dimension-features-energy-map.md` | ✅ 已实施（设计参考，能量映射由EnergySourceConfig配置驱动） | 维度功能能量映射 |
| `2026-07-22-active-health-six-stage-design.md` | ✅ 已实施（P0-P3 全栈完成） | 主动健康六阶模型改进总设计 |
| `2026-07-10-certainty-ppt-design.md` | 🔄 已废弃（一次性PPT设计，无代码实现） | 确定性叙事PPT |

### 实施计划（plans/）

| 文件 | 状态 | 说明 |
|------|:----:|------|
| `2026-07-22-comprehensive-implementation.md` | ✅ 当前 | 全面实施计划（Phase 2-4） |
| `2026-07-20-langgraph-phase1.md` | ✅ 已部署（AiGateway+Docker+LLM 运行中） | LangGraph Phase 1 |
| `2026-07-20-langgraph-phase2.md` | 🔄 合并至 comprehensive plan | LangGraph Phase 2 |
| `2026-07-20-langgraph-phase3.md` | 🔄 合并至 comprehensive plan | LangGraph Phase 3 |
| `2026-07-20-langgraph-phase4.md` | 🔄 合并至 comprehensive plan | LangGraph Phase 4 |
| `2026-07-17-flora-microbiome-report-implementation.md` | ✅ 已完成（4页面 1214行 + HealthKnowledgeBase后端） | 菌群报告重构 |
| `2026-07-16-first-login-auto-complete-plan.md` | ✅ 已实施（login.vue + user-edit.vue均已完成） | 首次登录优化 |
| `2026-07-14-family-promotion.md` | 🚧 P1后端完成，P2-P4待实施（前端基础页面已存在） | 家庭推广体系 |
| `2026-07-13-dan-assessment-phase2-5.md` | 🟡 计划中 | DAN测评优化 |
| `2026-07-12-wealth-dimension-redesign.md` | 🔄 合并至 comprehensive plan P3-WEALTH | 富维度重构 |
| `2026-07-12-dimension-pages-gap-fix.md` | 🟡 实施中 | 维度页面缺口修复 |
| `2026-07-09-family-membership-core.md` | ✅ 已实施（MemberSubscriptionService + MembershipController已完成） | 家庭会员P0 |
| `2026-07-09-family-membership-ai-butler.md` | ⏳ 待开发（Phase 2 Wave 3） | AI管家P1 |
| `2026-07-07-家庭成员辈分重构实施计划.md` | ✅ 全栈完成（GenerationLevel.java + FamilyMemberService + GenerationPicker.vue + generationLevel.js） | 辈分重构 |
| `2026-07-05-supply-distribution-system.md` | 🟡 计划中（Phase 4） | 供应商体系 |
| `2026-07-03-article-center-implementation.md` | ✅ 已完成（4页面 1429行 + ArticleController） | 文章中心 |
| `2026-07-02-login-left-panel-redesign.md` | ✅ 已确认 | 登录页重设计 |
| `2026-07-02-dimension-weight-picker-redesign.md` | ✅ 已实施 | 权重滑块重设计 |
| `2026-06-27-health-dimensions-incremental-plan.md` | 🟡 计划中（Phase 4） | 健康维度增量 |
| `2026-06-26-health-dimensions-refactor.md` | 🟡 计划中（Phase 4） | 健康维度重构 |
| `2026-06-22-family-relation-graph-redesign.md` | ✅ 已完成（FamilyRelationGraph.vue 797行，10+页面使用） | 关系图谱重构 |
| `2026-06-22-营养健康部分缺陷修复计划.md` | 🟡 计划中（Phase 2） | 营养健康修复 |
| `2026-06-20-dimension-knowledge-base-plan.md` | ✅ 已实施（KnowledgeBaseController + DifySyncService） | 知识库平台 |
| `2026-06-20-web-permission-system.md` | ✅ 已结束 | 权限系统 |
| `2026-06-20-cfc-web-e2e-test-fix.md` | ✅ 已结束 | Web端E2E测试 |
| `2026-06-20-cfc-web-refactor.md` | ✅ 已结束 | Web端重构 |
| `2026-06-20-danshop-order-fix.md` | 🟡 计划中（Phase 4） | 供应商订单修复 |
| `2026-06-19-profile-page-redesign.md` | ✅ 已完成（profile/ 6组件 1338行） | 富沛页面重构 |
| `2026-06-19-mind-page-dual-tab.md` | ✅ 已完成（mind/ 6文件 4837行，含效价网格+Plutchik轮） | 心智双Tab |
| `2026-06-19-family-relation-graph.md` | ✅ 已完成（FamilyRelationGraph.vue 797行） | 关系图谱 |
| `2026-06-19-homepage-risk-fix.md` | ✅ 已结束 | 首页风险修复 |
| `2026-06-15-parent-homepage-overhaul.md` | ✅ 已完成（parent-index.vue 1460行，已修复10个问题） | 家长首页改造 |
| `2026-06-15-family-member-cards.md` | ✅ 已上线 | 家庭成员卡片 |
| `2026-06-15-comprehensive-discrepancy-fix.md` | ✅ 已结束 | 综合差异修复 |
| `2026-06-15-code-design-discrepancy-fix.md` | ✅ 已结束 | 代码设计差异 |
| `2026-06-15-integer-price-migration.md` | ✅ 已上线 | 整数价格迁移 |
| `2026-06-14-action-page-relationship.md` | ✅ 已完成（action/ 5页面 2116行） | 行动页关系 |
| `2026-06-13-five-dimension-pages-redesign.md` | ✅ 核心完成 | 五维页面改造 |
| `2026-06-13-guest-mode-implementation.md` | ✅ 已上线 | 访客模式 |
| `2026-06-12-danshop-integration-design.md` | 🟡 计划中 | DanShop集成 |
| `2026-06-11-5-tab-pages.md` | ✅ 已上线 | 5 Tab页 |
| `2026-07-10-determinism-gap-fix-plan.md` | 🟡 部分被Phase 5 / LangGraph覆盖 | 确定性缺口修复 |
| `2026-07-13-supplier-system-gap-fix.md` | 🟡 计划中（Phase 4） | 供应商体系修复 |
| `2026-07-06-test-fix-and-enhance-plan.md` | ✅ 已结束 | 测试修复增强 |
| `2026-07-19-report-upload-purchase-links.md` | 🟡 计划中 | 报告购买链接 |

### 计划与设计文档（specs/）

| 文件 | 状态 | 说明 |
|------|:----:|------|
| `2026-07-22-active-health-six-stage-design.md` | 🟡 当前 | 主动健康六阶模型改进总设计 |

---

## 十一、主动健康六阶模型改进（Phase 5）

**基准:** 健康界 2026/06/17《主动健康的六阶模型及其神经生理机制》
**设计总纲:** `specs/2026-07-22-active-health-six-stage-design.md`
**状态:** ✅ P0-P3 全栈交付完成

### 改进矩阵

| 优先级 | 改进项 | 覆盖六阶 | 核心目标 | 状态 |
|:-------|:-------|:---------|:---------|:----:|
| **P0** | 微行动系统（最小行为单元） | ① 有效启动 | 将1秒完成的门槛降至极低，解决首次启动流失 | ✅ |
| **P1-1** | 即时多巴胺反馈 | ② 持续坚持 | 动画/声音/AI鼓励提供即时爽点，闭环多巴胺回路 | ✅ |
| **P1-2** | 健康行为智能预警 | ② 持续坚持 | 趋势解读+触发建议，让死数据变活提醒 | ✅ |
| **P2-1** | 身份重塑系统 | ④ 身份重塑 | 5级称号+健康积分+时间线叙事，从执行者到健康达人 | ✅ |
| **P2-2** | 家庭健康互动 | ⑤ 意见领袖化 | 排行榜+点赞+挑战，家庭内部互促 | ✅ |
| **P3** | 健康社区扩散 | ⑥ 社会扩散 | 健康圈+分享页，家庭→社区扩散 | ✅ |

### 新增文件总览

**后端（Java）：** 约 25 个新建文件（Controller/Service/Entity/Mapper）

| 优先级 | 新建 Controller | 新建 Service | 新建 Entity |
|:-------|:----------------|:-------------|:------------|
| P0 | MicroActionController | MicroActionService | MicroAction, MicroActionRecord |
| P1-1 | DailyFeedbackController | DailyFeedbackService | DailyFeedback |
| P1-2 | HealthAlertController | HealthAlertEngine, HealthAlertService | HealthAlert |
| P2-1 | HealthScoreController, HealthTimelineController | HealthScoreService, HealthLevelService, HealthTimelineService | HealthLevel, HealthTimelineEvent |
| P2-2 | FamilyHealthController, HealthInteractionController, FamilyChallengeController | FamilyHealthScoreService, HealthInteractionService, FamilyChallengeService | FamilyChallenge, FamilyChallengeProgress, HealthInteraction |
| P3 | HealthCircleController, CircleChallengeController, ShareController | HealthCircleService, CircleChallengeService, ShareService | HealthCircle, HealthCircleMember, CircleChallenge |

**前端（Vue）：** 约 15 个新建组件/页面

| 优先级 | 新建文件 |
|:-------|:---------|
| P0 | MicroActionCard.vue |
| P1-1 | FeedbackToast.vue, MilestoneCelebration.vue, DailySummary.vue, feedback-presets.js, feedback-engine.js, store/feedback.js |
| P1-2 | HealthAlertBanner.vue, store/health-alert.js |
| P2-1 | HealthBadge.vue, HealthTimeline.vue, store/health-score.js |
| P2-2 | FamilyHealthRanking.vue, FamilyChallengeCard.vue, HealthLikeButton.vue |
| P3 | CircleRanking.vue, pages/share/index.vue |

### 新数据表

| 优先级 | 表名 |
|:-------|:------|
| P0 | micro_action, micro_action_record |
| P1-1 | daily_feedback |
| P1-2 | health_alerts |
| P2-1 | health_level, health_timeline_event |
| P2-2 | family_challenge, family_challenge_progress, health_interaction |
| P3 | health_circle, health_circle_member, circle_challenge |

### 实现顺序依赖

```
P0 微启动 ─── 无依赖
P1-1 即时反馈 ─── 无依赖（独立，可并行于P0）
P1-2 智能预警 ─── 需要历史行为数据（可独立开发，数据积累后生效）
P2-1 身份重塑 ─── 依赖积分计算引擎
P2-2 家庭互动 ─── 依赖积分系统（与P2-1共享积分基础）
P3 社区扩散 ─── 依赖P2-2的家庭概念完整
```

**关键原则:** 四个阶段之间无阻塞依赖，可逐阶段实施，也可并行开发互不影响的模块。