# 用户使用流程图 — 任务管理

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

```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[📱 创建任务 /create]:::portMiniApp
        A2 -->|从模板| A4[📱 市场购买模板 → 应用]:::portMiniApp
        A2 -->|AI推荐| A5[📱 AI生成任务建议 → 一键添加]:::portMiniApp
        A2 -->|训练方案| A6[📱 训练方案下发 /deploy]:::portMiniApp
        A3 --> A7[📱 获取可选小游戏 /minigame-options]:::portMiniApp
    end

    subgraph 任务执行
        A7 --> B1[📱 获取今日任务 /today]:::portMiniApp
        B1 --> B2{📱 任务类型}:::portMiniApp
        B2 -->|普通任务| B3[📱 完成任务 /:id/complete]:::portMiniApp
        B2 -->|小游戏| B4[📱 完成小游戏 /:id/complete-minigame]:::portMiniApp
        B2 -->|家长任务| B5[📱 家长完成任务 /:id/complete-parent]:::portMiniApp
        B3 --> B6{📱 需要审核?}:::portMiniApp
        B6 -->|是| B7[📱 进入待审核 /pending-review]:::portMiniApp
        B6 -->|否| B8[📱 任务完成]:::portMiniApp
        B4 --> B8
        B5 --> B8
    end

    subgraph 任务审核
        B7 --> C1[📱 获取待审核列表 /pending-review]:::portMiniApp
        C1 --> C2[📱 审核任务 /:id/review]:::portMiniApp
        C2 --> C3{📱 审核结果}:::portMiniApp
        C3 -->|通过| C4[📱 任务完成 发放能量]:::portMiniApp
        C3 -->|驳回| C5[📱 任务退回]:::portMiniApp
    end

    subgraph 规划师批量管理
        A1 --> D1[📋 获取关联家庭 /bound-families]:::portGuide
        D1 --> D2[📋 获取家庭任务概览 /:familyId/overview]:::portGuide
        D2 --> D3[📋 获取孩子任务 /:familyId/children/:childId/tasks]:::portGuide
        D3 --> D4[📋 批量审核 /batch-review]:::portGuide
        D4 --> D5[📋 修改任务 /:taskId]:::portGuide
        D5 --> D6[📋 删除任务 /:taskId/delete]:::portGuide
    end

    subgraph 任务历史与统计
        B8 --> E1[📱 获取任务历史 /history]:::portMiniApp
        E1 --> E2[📱 批量完成任务 /batch-complete]:::portMiniApp
        E2 --> E3[📱 批量删除任务 /batch-delete]:::portMiniApp
    end

    subgraph 任务提醒
        E3 --> F1[📱 即将到期 /api/task-reminders/upcoming/:childId]:::portMiniApp
        F1 --> F2[📱 逾期任务 /api/task-reminders/overdue/:childId]:::portMiniApp
        F2 --> F3[📱 提醒设置 /api/task-reminders/reminder/:childId]:::portMiniApp
        F3 --> F4{📱 统计分析}:::portMiniApp
        F4 -->|任务统计| F5[📱 /api/task-reminders/statistics/:childId]:::portMiniApp
        F4 -->|分类统计| F6[📱 /api/task-reminders/statistics/category/:childId]:::portMiniApp
        F4 -->|日期统计| F7[📱 /api/task-reminders/statistics/date/:childId]:::portMiniApp
        F4 -->|家庭统计| F8[📱 /api/task-reminders/statistics/family/:familyId]:::portMiniApp
        F3 --> F9[📱 历史过滤 /api/task-reminders/history/filter/:childId]:::portMiniApp
    end

    R1(("👤 家长/规划师")):::actor
    R2(("👶 孩子")):::actor
    R3(("📋 规划师")):::role

    A1 -.- R1
    B3 -.- R2
    D1 -.- R3
```

## 端点明细

| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/tasks/create` | 创建任务 | 📱小程序 |
| `/api/tasks/today` | 获取今日任务 | 📱小程序 |
| `/api/tasks/{id}/complete` | 完成任务 | 📱小程序 |
| `/api/tasks/{id}/review` | 审核任务 | 📱小程序 |
| `/api/tasks/history` | 获取任务历史 | 📱小程序 |
| `/api/tasks/pending-review` | 获取待审核任务 | 📱小程序 |
| `/api/tasks/today-parent` | 获取家长今日任务 | 📱小程序 |
| `/api/tasks/{id}/complete-parent` | 家长完成任务 | 📱小程序 |
| `/api/tasks/{id}/complete-minigame` | 完成小游戏任务 | 📱小程序 |
| `/api/tasks/batch-complete` | 批量完成任务 | 📱小程序 |
| `/api/tasks/batch-delete` | 批量删除任务 | 📱小程序 |
| `/api/tasks/minigame-options` | 获取可选小游戏 | 📱小程序 |
| `/api/task-reminders/upcoming/{childId}` | 即将到期任务 | 📱小程序 |
| `/api/task-reminders/overdue/{childId}` | 逾期任务 | 📱小程序 |
| `/api/task-reminders/reminder/{childId}` | 提醒设置 | 📱小程序 |
| `/api/task-reminders/statistics/{childId}` | 任务统计 | 📱小程序 |
| `/api/task-reminders/statistics/category/{childId}` | 分类统计 | 📱小程序 |
| `/api/task-reminders/statistics/date/{childId}` | 日期统计 | 📱小程序 |
| `/api/task-reminders/statistics/family/{familyId}` | 家庭统计 | 📱小程序 |
| `/api/task-reminders/history/filter/{childId}` | 历史过滤 | 📱小程序 |
| `/api/guide/families/bound-families` | 获取关联家庭 | 📋规划师端 |
| `/api/guide/families/{familyId}/overview` | 家庭任务概览 | 📋规划师端 |
| `/api/guide/families/{familyId}/children/{childId}/tasks` | 孩子任务列表 | 📋规划师端 |
| `/api/guide/families/{familyId}/children/{childId}/pending-review` | 待审核列表 | 📋规划师端 |
| `/api/guide/families/{familyId}/tasks/{taskId}/review` | 审核任务 | 📋规划师端 |
| `/api/guide/families/{familyId}/tasks/batch-review` | 批量审核 | 📋规划师端 |
| `/api/guide/families/{familyId}/tasks/{taskId}/delete` | 删除任务 | 📋规划师端 |
| `/api/guide/families/dashboard-stats` | 规划师首页统计 | 📋规划师端 |