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

```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,shape:box

    subgraph 每日健康打卡
        A1(("家长/孩子")) --> A2[获取打卡列表 /list]
        A2 --> A3[获取打卡详情 /detail]
        A3 --> A4{打卡类型}
        A4 -->|综合打卡| B1[创建打卡 /create]
        A4 -->|运动打卡| B2[创建运动打卡 /create]
        A4 -->|饮食打卡| B3[创建饮食打卡 /create]
        A4 -->|睡眠打卡| B4[创建睡眠打卡 /create]
        A4 -->|喝水打卡| B5[创建喝水打卡 /create]
        A4 -->|冥想打卡| B6[创建冥想打卡 /create]
    end

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

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

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

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

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

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

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

## 端点明细

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