PROJECT-OVERVIEW.md 21 KB
浠艾?项目全景 ?阶段性需求与设计汇?
文档版本: v1.0 日期: 2026-07-21 状? 已确? 维护: 所有需求变更需更新本文?
一、项目阶段总览
| 阶段 | 时间 | 主题 | 核心交付 | 状? |
|---|---|---|---|---|
| Phase 0 | 2026-03~05 | 基础搭建 | 骨架? 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 / 土）?健康管理
核心功能: 精准营养推荐、健康报告解析、体质调理方?
| 功能 | 阶段 | 状? | 关联文档 |
|---|---|---|---|
| 菌群报告页面重构?00+菌属全覆盖） | Phase 1 | 🚧 实施中（gut-flora-detail.vue已修?026-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 状? 🚧 实施?
| 功能 | 状? | 关联文档 |
|---|---|---|
| 文章中心主页（发现页重建? | 🚧 实施中（已完?页面：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测试修复?4个测试） | 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 |
🟡 计划? | 报告购买链接 |