cfc/docs/flows/health-checkin-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,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	健康时间线