Browse Source

Merge remote-tracking branch 'origin/cfclub' into cfclub

jiapu 3 months ago
parent
commit
c42219e185

+ 1 - 1
.gitignore

@@ -44,9 +44,9 @@ coverage/
 worktrees/
 worktrees/
 
 
 # Screenshots
 # Screenshots
-!cfc-frontend/static/*.png
 *.png
 *.png
 !docs/**/*.png
 !docs/**/*.png
+!cfc-frontend/static/*.png
 !cfc-web/public/logo.png
 !cfc-web/public/logo.png
 !web/img/*.png
 !web/img/*.png
 
 

BIN
cfc-frontend/static/default-activity.png


BIN
cfc-frontend/static/default-product.png


BIN
cfc-frontend/static/tab-body.png


+ 1 - 1
cfc-web/.last_build_commit

@@ -1 +1 @@
-faedcc3354260dc538895e3607261202d8893c0b
+fb66b06cbb4045108ca96b2d670e1d7cefb05989

+ 2 - 2
cfc-web/package-lock.json

@@ -1,12 +1,12 @@
 {
 {
   "name": "cfc-web",
   "name": "cfc-web",
-  "version": "1.0.448",
+  "version": "1.0.451",
   "lockfileVersion": 3,
   "lockfileVersion": 3,
   "requires": true,
   "requires": true,
   "packages": {
   "packages": {
     "": {
     "": {
       "name": "cfc-web",
       "name": "cfc-web",
-      "version": "1.0.448",
+      "version": "1.0.451",
       "dependencies": {
       "dependencies": {
         "@wangeditor/editor": "^5.1.23",
         "@wangeditor/editor": "^5.1.23",
         "@wangeditor/editor-for-vue": "^1.0.2",
         "@wangeditor/editor-for-vue": "^1.0.2",

+ 1 - 1
cfc-web/package.json

@@ -1,6 +1,6 @@
 {
 {
   "name": "cfc-web",
   "name": "cfc-web",
-  "version": "1.0.449",
+  "version": "1.0.452",
   "private": true,
   "private": true,
   "scripts": {
   "scripts": {
     "dev": "vue-cli-service serve",
     "dev": "vue-cli-service serve",

+ 49 - 0
cfc-web/public/CHANGELOG-v1.0.md

@@ -4,6 +4,55 @@
 
 
 ---
 ---
 
 
+## v1.0.452 (2026-07-21)
+
+### 文档
+- sync PROJECT-OVERVIEW.md Phase 1 statuses with git-history verification (encoding fix)
+
+### 其他
+- - AI Sidecar: 🟡->🚧 (AiGateway+5% done, sidecar dir ready)
+- - Generation model: 🟡->🚧 (GenerationLevel.java introduced)
+- - Wealth dimension: 🟡->🚧 (EnergyService v2.1 done)
+- - First login: 🟡->🚧 (login.vue modified)
+- - Flora report: 🟡->🚧 (gut-flora-detail.vue modified)
+- - Article center: 🟡->🚧 (4 pages: index/detail/edit/my-posts)
+- - Family membership: 🟡->🚧 (MemberSubscriptionService done)
+- - Section 10 spec/plan index: 8 entries synced accordingly
+- 
+
+### Bug 修复
+- restore file encoding to UTF-8 (was corrupted by PowerShell ANSI default)
+
+
+## v1.0.451 (2026-07-21)
+
+### 文档
+- sync PROJECT-OVERVIEW.md Phase 1 statuses with git-history verification
+
+### 其他
+- - AI Sidecar: 🟡→🚧 (AiGateway+5% done, sidecar dir ready)
+- - Generation model: 🟡→🚧 (GenerationLevel.java introduced)
+- - Wealth dimension: 🟡→🚧 (EnergyService v2.1 done)
+- - First login: 🟡→🚧 (login.vue modified)
+- - Flora report: 🟡→🚧 (gut-flora-detail.vue modified)
+- - Article center: 🟡→🚧 (4 pages: index/detail/edit/my-posts)
+- - Family membership: 🟡→🚧 (MemberSubscriptionService done)
+- - Section 10 spec/plan index: 8 entries synced accordingly
+- 
+
+
+## v1.0.450 (2026-07-21)
+
+### Bug 修复
+- 添加 tab-wisdom 图标文件,修复 gitignore 顺序
+
+### 其他
+-   使静态图标 PNG 能被正确追踪
+- - Add tab-wisdom.png / tab-wisdom-active.png (placeholder from tab-mind)
+-   Fix TabBar compile error: 'tab-wisdom.png' not found
+- 
+
+
 ## v1.0.448 (2026-07-20)
 ## v1.0.448 (2026-07-20)
 
 
 ### Bug 修复
 ### Bug 修复

+ 50 - 1
cfc-web/public/CHANGELOG.md

@@ -1,6 +1,6 @@
 # 更新日志
 # 更新日志
 
 
-> 当前版本: v1.0.448
+> 当前版本: v1.0.452
 
 
 ## 历史版本
 ## 历史版本
 
 
@@ -8,6 +8,55 @@
 
 
 ---
 ---
 
 
+## v1.0.452 (2026-07-21)
+
+### 文档
+- sync PROJECT-OVERVIEW.md Phase 1 statuses with git-history verification (encoding fix)
+
+### 其他
+- - AI Sidecar: 🟡->🚧 (AiGateway+5% done, sidecar dir ready)
+- - Generation model: 🟡->🚧 (GenerationLevel.java introduced)
+- - Wealth dimension: 🟡->🚧 (EnergyService v2.1 done)
+- - First login: 🟡->🚧 (login.vue modified)
+- - Flora report: 🟡->🚧 (gut-flora-detail.vue modified)
+- - Article center: 🟡->🚧 (4 pages: index/detail/edit/my-posts)
+- - Family membership: 🟡->🚧 (MemberSubscriptionService done)
+- - Section 10 spec/plan index: 8 entries synced accordingly
+- 
+
+### Bug 修复
+- restore file encoding to UTF-8 (was corrupted by PowerShell ANSI default)
+
+
+## v1.0.451 (2026-07-21)
+
+### 文档
+- sync PROJECT-OVERVIEW.md Phase 1 statuses with git-history verification
+
+### 其他
+- - AI Sidecar: 🟡→🚧 (AiGateway+5% done, sidecar dir ready)
+- - Generation model: 🟡→🚧 (GenerationLevel.java introduced)
+- - Wealth dimension: 🟡→🚧 (EnergyService v2.1 done)
+- - First login: 🟡→🚧 (login.vue modified)
+- - Flora report: 🟡→🚧 (gut-flora-detail.vue modified)
+- - Article center: 🟡→🚧 (4 pages: index/detail/edit/my-posts)
+- - Family membership: 🟡→🚧 (MemberSubscriptionService done)
+- - Section 10 spec/plan index: 8 entries synced accordingly
+- 
+
+
+## v1.0.450 (2026-07-21)
+
+### Bug 修复
+- 添加 tab-wisdom 图标文件,修复 gitignore 顺序
+
+### 其他
+-   使静态图标 PNG 能被正确追踪
+- - Add tab-wisdom.png / tab-wisdom-active.png (placeholder from tab-mind)
+-   Fix TabBar compile error: 'tab-wisdom.png' not found
+- 
+
+
 ## v1.0.448 (2026-07-20)
 ## v1.0.448 (2026-07-20)
 
 
 ### Bug 修复
 ### Bug 修复

+ 358 - 0
docs/superpowers/PROJECT-OVERVIEW.md

@@ -0,0 +1,358 @@
+# 浠艾福 项目全景 — 阶段性需求与设计汇总
+
+**文档版本:** v1.0
+**日期:** 2026-07-21
+**状态:** 已确认
+**维护:** 所有需求变更需更新本文档
+
+---
+
+## 一、项目阶段总览
+
+| 阶段 | 时间 | 主题 | 核心交付 | 状态 |
+|:----:|------|------|----------|:----:|
+| **Phase 0** | 2026-03~05 | 基础搭建 | 骨架、5 Tab页、能量系统萌芽 | ✅ 已上线 |
+| **Phase 1** | 2026-06~07 | 五维平台核心 | 五维重构、家庭成员体系、文章中心、推广体系 | 🚧 进行中 |
+| **Phase 2** | 2026-07~08 | 商业模式 | 家庭会员订阅、供应商体系、AI管家 | ⏳ 待开发 |
+| **Phase 3** | 2026-Q3 | AI 能力升级 | LangGraph Sidecar、RAG知识库自动化、报告解读Agent | ⏳ 待开发 |
+| **Phase 4** | 2026-Q4 | 运维与扩展 | 性能优化、监控、国际化 | ⏳ 规划中 |
+
+---
+
+## 二、跨维度功能(所有阶段)
+
+### 2.1 AI 架构升级 — LangGraph Sidecar ⭐ P0
+
+**阶段:** Phase 3
+**状态:** 🚧 Phase 1 部分实施(AiGateway + 5%灰度已上线,sidecar 目录就绪)
+**决策:** 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** (3-4周) | ChatAgent + 3层记忆 + RAG混合检索 | `plans/2026-07-20-langgraph-phase2.md` |
+| **Phase 3** (5-6周) | AnalysisAgent + MultiModalAgent + 知识库自动化 | `plans/2026-07-20-langgraph-phase3.md` |
+| **Phase 4** (7-8周) | 性能调优 + Prometheus监控 + Dify清理 | `plans/2026-07-20-langgraph-phase4.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` |
+| 富维度子维度拆分 + 身克富杠杆 | 🚧 部分实施(EnergyService v2.1 完成) | `plans/2026-07-12-wealth-dimension-redesign.md` |
+| 维度权重滑块重设计 | ✅ 已实施 | `specs/2026-07-02-dimension-weight-picker-redesign.md` |
+
+---
+
+### 2.3 家庭成员体系 ⭐ P1
+
+**阶段:** Phase 1
+**状态:** 🚧 进行中
+
+| 功能 | 状态 | 关联文档 |
+|------|:----:|---------|
+| 家庭成员辈分重构(generation模型) | 🚧 部分实施(GenerationLevel.java 已引入) | `specs/2026-07-07-家庭成员关系视角转换设计.md` + `plans/2026-07-07-家庭成员辈分重构实施计划.md` |
+| 家庭成员关系图谱(Canvas重设计) | 🚧 设计完成,实施中 | `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` |
+| 成员详情页维度专属内容区 | 🟡 设计完成 | `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 | 🟡 设计稿 | `specs/2026-06-19-profile-page-redesign.md` |
+| 行远页重要关系维护(通讯录) | Phase 1 | 🟡 设计稿 | `specs/2026-06-14-action-page-relationship-design.md` |
+| 登录前浏览体验(未登录可见内容) | Phase 1 | 🟡 设计稿 | `specs/2026-06-04-pre-login-discovery-design.md` |
+
+---
+
+## 三、维度专属功能
+
+### 3.1 🌏 身(Body / 土)— 健康管理
+
+**核心功能:** 精准营养推荐、健康报告解析、体质调理方案
+
+| 功能 | 阶段 | 状态 | 关联文档 |
+|------|:----:|:----:|---------|
+| 菌群报告页面重构(200+菌属全覆盖) | Phase 1 | 🚧 实施中(gut-flora-detail.vue已修改2026-07-20) | `specs/2026-07-17-flora-microbiome-report-page-design.md` + `plans/2026-07-17-flora-microbiome-report-implementation.md` |
+| 身体健康7维子体系模型 | Phase 2 | 🟡 设计稿 | `specs/2026-06-26-health-dimensions-design-spec.md` |
+| 成长档案重建 | Phase 2 | 🟡 设计稿,待评审 | `specs/2026-06-22-growth-record-rebuild-design.md` |
+| 营养健康部分缺陷修复 | Phase 1 | 🟡 计划中 | `plans/2026-06-22-营养健康部分缺陷修复计划.md` |
+
+---
+
+### 3.2 ⚔️ 智(Wisdom / 金)— 心智成长
+
+**核心功能:** 专业心智测评、综合素质培养、成长档案追踪
+
+| 功能 | 阶段 | 状态 | 关联文档 |
+|------|:----:|:----:|---------|
+| 五维 TabBar 页面统一改造 | Phase 1 | 🚧 进行中 | `specs/2026-06-13-five-dimension-pages-redesign.md` |
+| DAN测评结果展示+六维雷达图 | Phase 1 | 🟡 已上线(双Tab) | — |
+| 认知测评题目录入优化 | Phase 1 | 🟡 计划中 | `plans/2026-07-13-dan-assessment-phase2-5.md` |
+
+---
+
+### 3.3 💧 富(Wealth / 水)— 利他创富
+
+**核心功能:** 创客成长生态、积分奖励体系、服务套餐市场
+
+| 功能 | 阶段 | 状态 | 关联文档 |
+|------|:----:|:----:|---------|
+| 富维度子维度拆分 + 身克富杠杆 | Phase 1 | 🚧 部分实施(EnergyService v2.1 完成) | `plans/2026-07-12-wealth-dimension-redesign.md` |
+| 积分价格整数化迁移 | Phase 1 | ✅ 已上线 | `plans/2026-06-15-integer-price-migration.md` |
+| 富沛(我的)页面重构 | Phase 1 | 🟡 设计稿 | `specs/2026-06-19-profile-page-redesign.md` |
+
+---
+
+### 3.4 🌿 行(Action / 木)— 人际和谐
+
+**核心功能:** 亲子关系建设、夫妻情感经营、社交与人脉拓展
+
+| 功能 | 阶段 | 状态 | 关联文档 |
+|------|:----:|:----:|---------|
+| 家庭推广体系重构(wxacode+家庭账户) | Phase 1 | 🚧 P1完成,P2-P4待实施 | `specs/2026-07-14-family-promotion-redesign.md` + `plans/2026-07-14-family-promotion.md` |
+| 行远页重要关系维护(通讯录导入) | Phase 1 | 🟡 设计稿 | `specs/2026-06-14-action-page-relationship-design.md` |
+| 家庭关系图谱(见跨维度) | — | 🚧 进行中 | 见 2.3 |
+
+---
+
+### 3.5 🔥 心(Mind / 火)— 大爱相随
+
+**核心功能:** 情绪认知与疏导、家庭关系心理学、人格与性格探索
+
+| 功能 | 阶段 | 状态 | 关联文档 |
+|------|:----:|:----:|---------|
+| 心·智双Tab结构(心智页面) | Phase 1 | ✅ 已上线 | — |
+| 情绪打卡数据接入 | Phase 2 | 🟡 设计稿 | — |
+
+---
+
+## 四、内容与商业化
+
+### 4.1 文章与内容运营 ⭐ P1
+
+**阶段:** Phase 1
+**状态:** 🚧 实施中
+
+| 功能 | 状态 | 关联文档 |
+|------|:----:|---------|
+| 文章中心主页(发现页重建) | 🚧 实施中(已完成4页面:index/article-detail/article-edit/my-posts) | `specs/2026-07-03-article-center-design.md` + `plans/2026-07-03-article-center-implementation.md` |
+| 文章发布系统(运营审核流程) | 🟡 设计稿 | `specs/2026-06-08-article-publishing-system-design.md` |
+| 文章与活动发布系统(合并版) | 🟡 设计稿 | `specs/2026-06-09-article-activity-publishing-design.md` |
+| 公众号内容发布(Dify工作流) | 🟡 草稿 | — |
+
+---
+
+### 4.2 电商与供应体系 ⭐ P1
+
+**阶段:** Phase 1/2
+**状态:** 🚧 进行中
+
+| 功能 | 阶段 | 状态 | 关联文档 |
+|------|:----:|:----:|---------|
+| CFC原生电商扩展(shop_前缀表) | Phase 1 | 🟡 实施中 | `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 1 | 🟡 计划中 | `plans/2026-07-13-supplier-system-gap-fix.md` |
+| 供应商订单修复 | Phase 1 | 🟡 计划中 | `plans/2026-06-20-danshop-order-fix.md` |
+
+---
+
+### 4.3 家庭会员体系 ⭐ P2
+
+**阶段:** Phase 2
+**状态:** 🚧 部分实施(MemberSubscriptionService 已完成,Controller 待实现)
+
+| 功能 | 关联文档 |
+|------|---------|
+| 一生一世家庭会员(订阅制+推广返利) | `specs/2026-07-09-family-membership-design.md` |
+| 订阅+推广核心实施(P0) | `plans/2026-07-09-family-membership-core.md` |
+| AI健康管家+推荐引擎(P1) | `plans/2026-07-09-family-membership-ai-butler.md` |
+
+---
+
+## 五、管理端功能
+
+### 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 | 🟡 设计完成,待实施 | `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` |
+
+---
+
+## 七、已废弃/归档文档
+
+> 以下文档已被新设计取代或决策否决,已移至 `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 |
+
+---
+
+## 八、技术债务与待办
+
+| 类别 | 项 | 优先级 | 关联 |
+|------|-------|:------:|------|
+| **测试** | Web端E2E测试修复(14个测试) | P1 | `plans/2026-06-20-cfc-web-e2e-test-fix.md` |
+| **安全** | 确定性缺口修复 | P1 | `plans/2026-07-10-determinism-gap-fix-plan.md` |
+| **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 | `plans/2026-06-22-family-relation-graph-redesign.md` |
+| **Bug** | 营养健康部分缺陷修复 | P2 | `plans/2026-06-22-营养健康部分缺陷修复计划.md` |
+| **代码质量** | Web端重构 | P2 | `plans/2026-06-20-cfc-web-refactor.md` |
+| **代码质量** | 综合差异修复 | P2 | `plans/2026-06-15-comprehensive-discrepancy-fix.md` |
+| **代码质量** | 代码与设计差异修复 | P3 | `plans/2026-06-15-code-design-discrepancy-fix.md` |
+
+---
+
+## 九、关键约束
+
+| 约束 | 说明 |
+|------|------|
+| **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-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` | 🚧 进行中 | 家庭关系图谱 |
+| `2026-06-22-family-relation-graph-redesign.md` | 🚧 进行中 | FamilyRelationGraph重构 |
+| `2026-07-07-家庭成员关系视角转换设计.md` | 🚧 部分实施 | 辈分重构设计(GenerationLevel.java已引入) |
+| `2026-07-03-article-center-design.md` | 🚧 进行中 | 文章中心设计 |
+| `2026-07-09-family-membership-design.md` | 🚧 部分实施 | 家庭会员体系(MemberSubscriptionService已完成) |
+| `2026-07-14-family-promotion-redesign.md` | 🚧 进行中 | 家庭推广体系 |
+| `2026-07-17-flora-microbiome-report-page-design.md` | 🚧 实施中 | 菌群报告页面(gut-flora-detail.vue已修改) |
+| `2026-06-24-cfc-ecommerce-extension-design.md` | 🚧 进行中 | 电商原生扩展 |
+| `2026-07-05-supply-distribution-system-design.md` | 🟡 待实施 | 供应商销售体系 |
+| `2026-06-20-dimension-knowledge-base-design.md` | 🟡 待实施 | 维度知识库平台 |
+| `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` | 🟡 待评审 | 成长档案重建 |
+| `2026-07-16-first-login-auto-complete.md` | 🚧 部分实施(login.vue已改,user-edit.vue待实施) | 首次登录优化 |
+| `2026-07-14-member-detail-dimension-sections.md` | 🟡 待实施 | 成员详情维度区 |
+| `2026-07-02-login-left-panel-redesign.md` | ✅ 已确认 | 登录页重设计 |
+| `2026-07-02-dimension-weight-picker-redesign.md` | ✅ 已实施 | 维度权重重设计 |
+| `2026-06-19-profile-page-redesign.md` | 🟡 设计稿 | 富沛页面重构 |
+| `2026-06-15-family-member-cards-design.md` | ✅ 已上线 | 家庭成员卡片 |
+| `2026-06-14-action-page-relationship-design.md` | 🟡 设计稿 | 行远页关系维护 |
+| `2026-06-09-article-activity-publishing-design.md` | 🟡 设计稿 | 文章活动发布 |
+| `2026-06-08-article-publishing-system-design.md` | 🟡 设计稿 | 文章发布系统 |
+| `2026-06-04-pre-login-discovery-design.md` | 🟡 设计稿 | 登录前浏览 |
+| `2026-06-02-care-family-club-design.md` | 🟡 设计稿 | 平台升级总纲 |
+| `2026-07-12-dimension-features-energy-map.md` | 🟡 设计稿 | 维度功能能量映射 |
+| `2026-07-10-certainty-ppt-design.md` | 🟡 设计稿 | 确定性叙事PPT |
+
+### 实施计划(plans/)
+
+| 文件 | 状态 | 说明 |
+|------|:----:|------|
+| `2026-07-20-langgraph-phase1.md` | 🚧 部分执行(AiGateway+5%灰度已上线,sidecar目录就绪) | LangGraph Phase 1 |
+| `2026-07-20-langgraph-phase2.md` | ⏳ 待执行 | LangGraph Phase 2 |
+| `2026-07-20-langgraph-phase3.md` | ⏳ 待执行 | LangGraph Phase 3 |
+| `2026-07-20-langgraph-phase4.md` | ⏳ 待执行 | LangGraph Phase 4 |
+| `2026-07-17-flora-microbiome-report-implementation.md` | 🚧 实施中(gut-flora-detail.vue已修改) | 菌群报告重构 |
+| `2026-07-16-first-login-auto-complete-plan.md` | 🚧 部分实施(login.vue已改,user-edit.vue待实施) | 首次登录优化 |
+| `2026-07-14-family-promotion.md` | 🚧 P1完成 | 家庭推广体系 |
+| `2026-07-13-dan-assessment-phase2-5.md` | 🟡 计划中 | DAN测评优化 |
+| `2026-07-12-wealth-dimension-redesign.md` | 🚧 部分实施(EnergyService v2.1完成) | 富维度重构 |
+| `2026-07-12-dimension-pages-gap-fix.md` | 🟡 实施中 | 维度页面缺口修复 |
+| `2026-07-09-family-membership-core.md` | 🚧 部分实施(MemberSubscriptionService已完成,Controller待实现) | 家庭会员P0 |
+| `2026-07-09-family-membership-ai-butler.md` | ⏳ 待开发 | AI管家P1 |
+| `2026-07-07-家庭成员辈分重构实施计划.md` | 🚧 部分实施(GenerationLevel.java已引入) | 辈分重构 |
+| `2026-07-05-supply-distribution-system.md` | 🟡 待实施 | 供应商体系 |
+| `2026-07-03-article-center-implementation.md` | 🚧 实施中 | 文章中心 |
+| `2026-07-02-login-left-panel-redesign.md` | ✅ 已确认 | 登录页重设计 |
+| `2026-07-02-dimension-weight-picker-redesign.md` | ✅ 已实施 | 权重滑块重设计 |
+| `2026-06-27-health-dimensions-incremental-plan.md` | 🟡 计划中 | 健康维度增量 |
+| `2026-06-26-health-dimensions-refactor.md` | 🟡 计划中 | 健康维度重构 |
+| `2026-06-22-family-relation-graph-redesign.md` | 🚧 实施中 | 关系图谱重构 |
+| `2026-06-22-营养健康部分缺陷修复计划.md` | 🟡 计划中 | 营养健康修复 |
+| `2026-06-20-dimension-knowledge-base-plan.md` | 🟡 待实施 | 知识库平台 |
+| `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` | 🟡 计划中 | 供应商订单修复 |
+| `2026-06-19-profile-page-redesign.md` | 🟡 设计稿 | 富沛页面重构 |
+| `2026-06-19-mind-page-dual-tab.md` | 🟡 设计稿 | 心智双Tab |
+| `2026-06-19-family-relation-graph.md` | 🟡 计划中 | 关系图谱 |
+| `2026-06-19-homepage-risk-fix.md` | 🟡 计划中 | 首页风险修复 |
+| `2026-06-15-parent-homepage-overhaul.md` | 🟡 计划中 | 家长首页改造 |
+| `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` | 🟡 设计稿 | 行动页关系 |
+| `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` | 🟡 计划中 | 确定性缺口修复 |
+| `2026-07-13-supplier-system-gap-fix.md` | 🟡 计划中 | 供应商体系修复 |
+| `2026-07-06-test-fix-and-enhance-plan.md` | 🟡 计划中 | 测试修复增强 |
+| `2026-07-19-report-upload-purchase-links.md` | 🟡 计划中 | 报告购买链接 |