# 用户使用流程图 — 健康打卡体系

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

```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[📱 获取打卡列表 /list]:::portMiniApp
        A2 --> A3[📱 获取打卡详情 /detail]:::portMiniApp
        A3 --> A4{📱 打卡类型}:::portMiniApp
        A4 -->|综合打卡| B1[📱 创建打卡 /create]:::portMiniApp
        A4 -->|运动打卡| B2[📱 创建运动打卡 /create]:::portMiniApp
        A4 -->|饮食打卡| B3[📱 创建饮食打卡 /create]:::portMiniApp
        A4 -->|睡眠打卡| B4[📱 创建睡眠打卡 /create]:::portMiniApp
        A4 -->|喝水打卡| B5[📱 创建喝水打卡 /create]:::portMiniApp
        A4 -->|冥想打卡| B6[📱 创建冥想打卡 /create]:::portMiniApp
    end

    subgraph 打卡管理
        B1 --> C1[📱 更新打卡 /update]:::portMiniApp
        C1 --> C2[📱 删除打卡 /delete]:::portMiniApp
    end

    subgraph 连续打卡
        C2 --> D1[📱 获取打卡进度 /progress/:childId]:::portMiniApp
        D1 --> D2[📱 获取打卡统计 /stats]:::portMiniApp
        D2 --> D3{📱 打卡中断?}:::portMiniApp
        D3 -->|是| D4[📱 重置中断打卡 /reset]:::portMiniApp
        D3 -->|否| D5[📱 保持连续]:::portMiniApp
    end

    subgraph 健康积分
        D5 --> E1[📱 获取健康积分信息 /info]:::portMiniApp
        E1 --> E2[📱 获取连续打卡天数 /streak]:::portMiniApp
    end

    subgraph 健康时间线
        C2 --> F1[📱 获取健康时间线 /list]:::portMiniApp
        F1 --> F2[📱 查看历史故事]:::portMiniApp
    end

    subgraph 健康预警
        F2 --> G1[📱 获取活跃预警 /list]:::portMiniApp
        G1 --> G2[📱 关闭预警 /dismiss]:::portMiniApp
    end

    R1(("👤 家长/孩子")):::actor
    R2(("🔥 连续打卡系统")):::system

    A1 -.- R1
    D1 -.- R2
```

## 端点明细

| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/health/checkin/list` | 获取打卡列表 | 📱小程序 |
| `/api/health/checkin/create` | 创建打卡记录 | 📱小程序 |
| `/api/health/checkin/delete` | 删除打卡记录 | 📱小程序 |
| `/api/health/checkin/stats` | 打卡统计 | 📱小程序 |
| `/api/daily/checkin/list` | 获取打卡列表 | 📱小程序 |
| `/api/daily/checkin/detail` | 获取打卡详情 | 📱小程序 |
| `/api/daily/checkin/create` | 创建打卡 | 📱小程序 |
| `/api/daily/checkin/update` | 更新打卡 | 📱小程序 |
| `/api/daily/checkin/delete` | 删除打卡 | 📱小程序 |
| `/api/health/exercise/list` | 运动打卡列表 | 📱小程序 |
| `/api/health/exercise/create` | 创建运动打卡 | 📱小程序 |
| `/api/health/meal/list` | 饮食打卡列表 | 📱小程序 |
| `/api/health/meal/create` | 创建饮食打卡 | 📱小程序 |
| `/api/health/sleep/list` | 睡眠打卡列表 | 📱小程序 |
| `/api/health/sleep/create` | 创建睡眠打卡 | 📱小程序 |
| `/api/health/water/list` | 喝水打卡列表 | 📱小程序 |
| `/api/health/water/create` | 创建喝水打卡 | 📱小程序 |
| `/api/health/meditation/list` | 冥想打卡列表 | 📱小程序 |
| `/api/health/meditation/create` | 创建冥想打卡 | 📱小程序 |
| `/api/streak/progress/{childId}` | 打卡进度 | 📱小程序 |
| `/api/streak/reset` | 重置中断打卡 | 📱小程序 |
| `/api/health/score/info` | 健康积分信息 | 📱小程序 |
| `/api/health/score/streak` | 连续天数 | 📱小程序 |
| `/api/health/alert/list` | 活跃预警列表 | 📱小程序 |
| `/api/health/alert/dismiss` | 关闭预警 | 📱小程序 |
| `/api/health/timeline/list` | 健康时间线 | 📱小程序 |