# 用户使用流程图 — 成长档案

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

```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(("👤 家长")):::portMiniApp --> A2{📱 创建方式}:::portMiniApp
        A2 -->|手动创建| A3[📱 创建成长档案 /record/create]:::portMiniApp
        A2 -->|上传PDF报告| A4[📱 上传测评报告PDF /upload-and-parse]:::portMiniApp
        A2 -->|创建并购买测评| A5[📱 创建档案+购买 /create-with-order]:::portMiniApp
        A4 --> A6["⚙️ PDF解析引擎 (Stage 1)"]:::portSystem
        A6 --> A7{⚙️ 是否重复?}:::portSystem
        A7 -->|重复| A8[⚙️ 检查哈希去重 /check-duplicate]:::portSystem
        A7 -->|新记录| A9["📱 创建成长档案 (Stage 2) /create-from-upload"]:::portMiniApp
        A3 --> A10[📱 录入基础信息]:::portMiniApp
        A9 --> A10
    end

    subgraph 补充材料
        A10 --> B1[📱 创建补充记录 /supplement]:::portMiniApp
        B1 --> B2[📱 获取补充记录列表 /:id/supplements]:::portMiniApp
    end

    subgraph 外部数据同步
        A10 --> C1[📱 外部系统测评同步 /external/sync]:::portMiniApp
        C1 --> C2[⚙️ 数据融合]:::portSystem
    end

    subgraph 查询与管理
        C2 --> D1[📱 获取家长的成长档案列表 /list]:::portMiniApp
        D1 --> D2[📱 获取指定孩子的档案 /child/:childId]:::portMiniApp
        D2 --> D3[📱 获取孩子的档案 /child-records]:::portMiniApp
        D3 --> D4[📱 获取档案详情 /:id]:::portMiniApp
        D4 --> D5[📱 删除成长档案 /:id/delete]:::portMiniApp
    end

    subgraph 生长记录
        D1 --> E1[📱 获取生长记录列表 /list]:::portMiniApp
        E1 --> E2[📱 获取生长记录详情 /detail]:::portMiniApp
        E2 --> E3[📱 创建生长记录 /create]:::portMiniApp
        E3 --> E4[📱 更新生长记录 /update]:::portMiniApp
        E4 --> E5[📱 删除生长记录 /delete]:::portMiniApp
    end

    subgraph 成长计划
        E5 --> F1[📱 创建计划 /growth/plan/create]:::portMiniApp
        F1 --> F2[📱 更新计划 /growth/plan/update]:::portMiniApp
        F2 --> F3[📱 查看孩子计划 /growth/plan/child/:childId]:::portMiniApp
        F3 --> F4[📱 激活计划 /growth/plan/child/:childId/active]:::portMiniApp
        F4 --> F5[📱 计划详情 /growth/plan/:id]:::portMiniApp
        F5 --> F6[📱 审核计划 /growth/plan/:id/review]:::portMiniApp
    end

    R1(("👤 家长")):::actor
    R2(("👶 孩子")):::role
    R3(("📄 PDF解析引擎")):::system

    A1 -.- R1
    D2 -.- R2
    A6 -.- R3
```

## 端点明细

| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/growth/record/create` | 创建成长档案 | 📱小程序 |
| `/api/growth/record/create-with-order` | 创建档案并购买测评 | 📱小程序 |
| `/api/growth/record/list` | 获取家长的档案列表 | 📱小程序 |
| `/api/growth/record/child/{childId}` | 获取指定孩子档案 | 📱小程序 |
| `/api/growth/record/child-records` | 获取孩子的成长档案 | 📱小程序 |
| `/api/growth/record/{id}` | 获取档案详情 | 📱小程序 |
| `/api/growth/record/{id}/delete` | 删除成长档案 | 📱小程序 |
| `/api/growth/external/sync` | 外部系统同步 | 📱小程序 |
| `/api/growth/record/upload-and-parse` | 上传并解析PDF | 📱小程序 |
| `/api/growth/record/create-from-upload` | 创建成长档案（从上传） | 📱小程序 |
| `/api/growth/record/supplement` | 创建补充记录 | 📱小程序 |
| `/api/growth/record/check-duplicate` | 检查重复记录 | ⚙️系统自动 |
| `/api/growth/record/{id}/supplements` | 获取补充记录 | 📱小程序 |
| `/api/health/growth/list` | 获取生长记录列表 | 📱小程序 |
| `/api/health/growth/detail` | 获取生长记录详情 | 📱小程序 |
| `/api/health/growth/create` | 创建生长记录 | 📱小程序 |
| `/api/health/growth/update` | 更新生长记录 | 📱小程序 |
| `/api/health/growth/delete` | 删除生长记录 | 📱小程序 |
| `/api/growth/plan/create` | 创建成长计划 | 📱小程序 |
| `/api/growth/plan/update` | 更新成长计划 | 📱小程序 |
| `/api/growth/plan/child/{childId}` | 查看孩子成长计划 | 📱小程序 |
| `/api/growth/plan/child/{childId}/active` | 激活孩子成长计划 | 📱小程序 |
| `/api/growth/plan/{id}` | 查看计划详情 | 📱小程序 |
| `/api/growth/plan/{id}/review` | 审核成长计划 | 📱小程序 |