cfc/docs/flows/health-detection-flow.md

用户使用流程图 — 身体健康检测

端口说明: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动

flowchart TD
    %% ============ 颜色定义 ============
    classDef actor fill:#e1f5fe,stroke:#0288d1,stroke-width:2px
    classDef action fill:#fff3e0,stroke:#f57c00,stroke-width:1px
    classDef system fill:#e8f5e9,stroke:#388e3c,stroke-width:1px
    classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
    classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
    classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2

    subgraph 注册与家庭
        A1(("👤 家长<br/>开始")):::portMiniApp --> A2[📱 微信授权登录]:::portMiniApp
        A2 --> A3[📱 创建/加入家庭]:::portMiniApp
        A3 --> A4[📱 添加家庭成员<br/>（孩子/老人等）]:::portMiniApp
    end

    subgraph 数据采集入口
        A4 --> B0{📱 选择检测方式}:::portMiniApp
        B0 --> B1[📱 上传肠道菌群PDF报告]:::portMiniApp
        B0 --> B2[📱 上传体检报告/化验单]:::portMiniApp
        B0 --> B3[📱 舌诊拍照上传]:::portMiniApp
        B0 --> B4[📱 填写健康问卷]:::portMiniApp
        B0 --> B5[📱 手动录入维度评分]:::portMiniApp
    end

    subgraph AI解析层
        B1 --> C1[⚙️ PDF解析引擎<br/>PdfParseService]:::portSystem
        C1 --> C2{⚙️ 是否匹配到<br/>家庭成员?}:::portSystem
        C2 -->|自动匹配<br/>姓名+性别+年龄| C3[⚙️ 标记到对应成员]:::portSystem
        C2 -->|匹配失败| C4[📱 提示家长手动绑定]:::portMiniApp

        B2 --> C5[⚙️ OCR/结构化解析]:::portSystem
        C5 --> C6[⚙️ 提取指标: 身高/体重/<br/>血常规/视力等]:::portSystem

        B3 --> C7[⚙️ 舌诊AI分析<br/>TongueDiagnosisService]:::portSystem
        C7 --> C8[⚙️ 舌苔/舌色/齿痕分析]:::portSystem

        B4 --> C9[⚙️ 问卷评分计算]:::portSystem
        B5 --> C10[⚙️ 直接录入评分]:::portSystem
    end

    subgraph 报告预览与确认
        C3 --> D1[📱 生成解析预览<br/>Phase 1 /parse-preview]:::portMiniApp
        D1 --> D2{📱 家长确认<br/>数据是否正确?}:::portMiniApp
        D2 -->|修改| D3[📱 家长在线编辑指标]:::portMiniApp
        D3 --> D2
        D2 -->|确认| D4[📱 正式入库<br/>Phase 2 /confirm]:::portMiniApp
        C6 --> D1
        C8 --> D1
    end

    subgraph 7维健康评分
        D4 --> E1[⚙️ 维度评分引擎]:::portSystem
        E1 --> E2[⚙️ 刷新7维健康评分]:::portSystem
        E2 --> E3[⚙️ 营养缺乏分析]:::portSystem
        E3 --> E4[⚙️ 食材推荐指数]:::portSystem
        E4 --> E5[⚙️ 健康分析报告]:::portSystem
    end

    subgraph AI教练解读
        E5 --> F1[📱 家长查看健康报告]:::portMiniApp
        F1 --> F2{📱 是否需要<br/>AI解读?}:::portMiniApp
        F2 -->|是| F3[📱 AI聊天解读报告]:::portMiniApp
        F3 --> F4[📱 AI解析报告指标<br/>生成改善建议]:::portMiniApp
        F4 --> F5[📱 AI生成任务计划]:::portMiniApp
        F5 --> F6[📱 家长查看解读结果]:::portMiniApp
        F2 -->|否| G1
    end

    subgraph 专业身份介入
        F6 --> G1{📱 是否需要<br/>深度介入?}:::portMiniApp
        G1 -->|健康问题咨询| G2[📱 申请营养师服务]:::portMiniApp
        G1 -->|全方位服务| G3[📱 申请管家服务]:::portMiniApp
        G1 -->|成长规划| G4[📱 规划师查看报告]:::portMiniApp
        G1 -->|自行跟进| G5[📱 结束]:::portMiniApp

        G2 --> G2a[📋 营养师审核需求]:::portGuide
        G2a --> G2b[📋 开具营养方案]:::portGuide

        G3 --> G3a[📋 管家审核]:::portGuide
        G3a --> G3b[📋 管家建档]:::portGuide
        G3b --> G3c[📋 定期跟进]:::portGuide

        G4 --> G4a[📋 规划师查看报告]:::portGuide
        G4a --> G4b[📋 规划师下发改善任务]:::portGuide
    end

    subgraph 持续跟踪
        G5 --> H1[📱 家长定期上传新报告]:::portMiniApp
        H1 --> H2[⚙️ 系统对比历史趋势]:::portSystem
        H2 --> H3[📱 提示改善进展/异常]:::portMiniApp
        H3 --> F1
    end

    R1(("👤 家长")):::actor
    R2(("🤖 AI教练")):::role
    R3(("🥗 营养师")):::role
    R4(("🏠 管家")):::role
    R5(("📋 规划师")):::role

端点明细

端点	说明	端口
/api/health/report/create	创建健康报告	📱小程序
/api/health/report/latest	获取最新报告	📱小程序
/api/health/report/list	报告列表	📱小程序
/api/health/report/detail	报告完整详情	📱小程序
/api/health/report/edit	编辑报告	📱小程序
/api/health/report/upload	上传PDF报告	📱小程序
/api/health/report/parse-preview	解析预览	📱小程序
/api/health/report/confirm	确认入库	📱小程序
/api/health/report/discard	放弃草稿	📱小程序
/api/health/report/bind	绑定到成员	📱小程序
/api/health/report/admin-list	管理端报告列表	🖥管理后台
/api/health/report/unlinked	未绑定报告
/api/health/report/permission/add	添加查看权限
/api/health/report/permission/remove	移除权限
/api/health/report/permission/check	检查权限
/api/health/indicator/list	指标明细
/api/health/body/detail	身体维度数据
/api/health/nutrition/deficiency	营养缺乏分析
/api/health/nutrition/profile	孩子营养档案
/api/health/survey/create	创建调研问卷
/api/health/survey/submit	提交问卷
/api/health/survey/status	问卷状态
/api/dan-report/upload	DAN报告上传
/api/dan-report/{id}/confirm	确认DAN报告
/api/dan-report/list	DAN报告列表