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

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

```mermaid
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报告列表 |