cfc/docs/flows/task-management-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
    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	规划师首页统计	📋规划师端