# 用户使用流程图 — 成长规划师体系

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

```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(("📋 成长规划师")):::portGuide --> A2{已有账号?}
        A2 -->|否| A3[📋 注册 /register]:::portGuide
        A3 --> A4[📋 提交入驻申请 /application/submit]:::portGuide
        A2 -->|是| A5[📋 登录 → 查看状态 /applications]:::portGuide
        A4 --> A6[🖥 管理员审批]:::portAdmin
        A6 --> A7{审批结果}
        A7 -->|通过| A8[📋 规划师激活<br/>查看激活记录 /application/:id/records]:::portGuide
        A7 -->|驳回| A9[📋 撤回 /withdraw · 重新提交 /resubmit]:::portGuide
        A9 --> A4
        A8 --> A10[📋 查看我的申请 /applications/my]:::portGuide
    end

    subgraph 个人信息
        A10 --> B1[📋 我的信息 /my]:::portGuide
        B1 --> B2[📋 我的套餐 /my/packages]:::portGuide
        B2 --> B3[📋 上级规划师 /parent-guide]:::portGuide
        B3 --> B4[📋 下级列表 /child-guides<br/>全部下级 /all-child-guides]:::portGuide
    end

    subgraph 团队管理
        B4 --> C1[📋 我的团队 /team/my-team]:::portGuide
        C1 --> C2[📋 获取邀请码 /team/invite-code]:::portGuide
        C2 --> C3[📋 生成新邀请码 /team/invite-code/generate]:::portGuide
        C3 --> C4[📋 成员列表 /team/members]:::portGuide
        C4 --> C5[📋 检查邀请 /team/check-status]:::portGuide
        C5 --> C6[📋 通过码加入 /team/join-by-invite]:::portGuide
        C6 --> C7[📋 离开团队 /team/leave]:::portGuide
        C7 --> C8[📋 团队统计 /team/stats]:::portGuide
    end

    subgraph 邀请与绑定家庭
        C8 --> D1[📋 生成家长邀请 /parent-invite/generate]:::portGuide
        D1 --> D2[📱 家长接受邀请 /parent-invite/accept]:::portMiniApp
        D2 --> D3[📋 生成绑定邀请 /bind/invite]:::portGuide
        D3 --> D4[📋 校验邀请 /bind/validate]:::portGuide
        D4 --> D5[📋 获取绑定家庭 /families/bound-families]:::portGuide
        D5 --> D6[📋 家庭列表 /family/list]:::portGuide
    end

    subgraph 家庭管理与任务
        D6 --> E1[📋 家庭概览 /families/:familyId/overview]:::portGuide
        E1 --> E2[📋 仪表盘统计 /families/dashboard-stats]:::portGuide
        E2 --> E3[📋 查看孩子任务 /families/:familyId/children/:childId/tasks]:::portGuide
        E3 --> E4[📋 待审核 /children/:childId/pending-review]:::portGuide
        E4 --> E5[📋 任务审核 /families/:familyId/tasks/:taskId/review]:::portGuide
        E5 --> E6[📋 批量审核 /tasks/batch-review]:::portGuide
        E6 --> E7[📋 任务详情 /tasks/:taskId<br/>删除 /tasks/:taskId/delete]:::portGuide
    end

    subgraph 任务模板管理
        E7 --> F1[📋 我的模板 /packages/my]:::portGuide
        F1 --> F2[📋 创建模板 /packages/create]:::portGuide
        F2 --> F3[📋 更新模板 /packages/update]:::portGuide
        F3 --> F4[📋 更新状态 /packages/update-status]:::portGuide
        F4 --> F5[📋 模板列表 /packages/list]:::portGuide
        F5 --> F6[📋 模板详情 /packages/detail<br/>模板定价 /packages/template-detail]:::portGuide
        F6 --> F7[📋 增加销量 /packages/increment-sales]:::portGuide
        F7 --> F8[📋 等级筛选 /packages/level/:level]:::portGuide
        F8 --> F9[📋 套餐包列表 /guide-packages /package/templates]:::portGuide
        F9 --> F10[📋 添加套餐 /package/add · 查看 /package/:packageId<br/>更新 /package/:packageId/update · 删除 /package/:packageId/delete]:::portGuide
    end

    subgraph 活动管理
        F10 --> G1[📋 创建活动 /activities/create]:::portGuide
        G1 --> G2[📋 活动列表 /activities/list]:::portGuide
        G2 --> G3[📋 活动详情 /activities/detail]:::portGuide
        G3 --> G4[📋 更新 /activities/update]:::portGuide
        G4 --> G5[📋 发布 /activities/publish]:::portGuide
        G5 --> G6[📋 下架 /activities/cancel · 删除 /activities/delete]:::portGuide
    end

    subgraph 训练方案
        G6 --> H1[📋 方案列表 /training-plans/list]:::portGuide
        H1 --> H2[📋 创建方案 /training-plans/create]:::portGuide
        H2 --> H3[📋 添加项目 /training-plans/items/add]:::portGuide
        H3 --> H4[📋 更新项目 /training-plans/items/update · 删除 /items/delete]:::portGuide
        H4 --> H5[📋 从推荐生成 /training-plans/generate-from-recommendations]:::portGuide
        H5 --> H6[📋 下发方案 /training-plans/deploy]:::portGuide
        H6 --> H7[📋 执行看板 /training-plans/execution-board]:::portGuide
        H7 --> H8[📋 方案详情 /training-plans/detail]:::portGuide
        H8 --> H9[📋 更新 /training-plans/update · 删除 /training-plans/delete]:::portGuide
    end

    subgraph 评估管理
        H9 --> I1[📋 可用测评资料 /assessment/materials]:::portGuide
        I1 --> I2[📋 家庭测评列表 /assessment/families]:::portGuide
        I2 --> I3[📋 启用 /assessment/family/enable]:::portGuide
        I3 --> I4[📋 查看 /assessment/family/:familyId]:::portGuide
        I4 --> I5[📋 禁用 /assessment/family/:familyId/disable]:::portGuide
    end

    subgraph 成长计划
        I5 --> J1[📋 计划列表 /plans/family-list]:::portGuide
        J1 --> J2[📋 计划详情 /plans/detail]:::portGuide
        J2 --> J3[📋 激活 /plans/activate]:::portGuide
        J3 --> J4[📋 审核 /plans/review]:::portGuide
    end

    subgraph 成长记录
        J4 --> K1[📋 创建记录 /record/create]:::portGuide
        K1 --> K2[📋 我的记录 /record/my-records]:::portGuide
        K2 --> K3[📋 记录详情 /record/detail/:id]:::portGuide
    end

    subgraph 咨询消息
        K3 --> L1[📋 发送咨询 /messages/send]:::portGuide
        L1 --> L2[📋 我的咨询 /messages/my]:::portGuide
        L2 --> L3[📋 回复 /messages/:messageId/reply]:::portGuide
        L3 --> L4[📋 咨询列表 /messages/list]:::portGuide
        L4 --> L5[📋 未读消息 /messages/unread-count]:::portGuide
    end

    subgraph 订单与佣金
        L5 --> M1[📋 订单列表 /orders/list]:::portGuide
        M1 --> M2[📋 订单统计 /orders/stats]:::portGuide
        M2 --> M3[📋 订单详情 /orders/detail]:::portGuide
    end

    subgraph 升迁与新申请
        M3 --> N1[📋 新入驻申请 /apply/new]:::portGuide
        N1 --> N2[📋 升级申请 /apply/upgrade]:::portGuide
        N2 --> A2
    end

    subgraph 教师班级管理
        N2 --> O1[📋 教师信息 /api/teacher/info]:::portGuide
        O1 --> O2[📋 班级列表 /api/teacher/classes/list]:::portGuide
        O2 --> O3[📋 班级详情 /api/teacher/classes]:::portGuide
        O3 --> O4{📋 操作}:::portGuide
        O4 -->|学生管理| O5[📋 查看学生 /api/teacher/classes/:classId/students]:::portGuide
        O5 --> O6[📋 添加学生 /api/teacher/classes/:classId/students/add]:::portGuide
        O6 --> O7[📋 学生详情 /api/teacher/classes/:classId/students/:studentId]:::portGuide
        O4 -->|报告| O8[📋 生成报告 /api/teacher/classes/:classId/report]:::portGuide
        O4 -->|进度| O9[📋 学生进度 /api/teacher/students/:studentId/progress]:::portGuide
        O3 --> OA[📋 教师任务 /api/teacher/tasks]:::portGuide
        OA --> OB[📋 任务列表 /api/teacher/tasks/list]:::portGuide
    end

    %% 角色标注
    RP(("📋 成长规划师")):::actor
    RP2(("👤 家长")):::role
    RADM(("🔧 管理员")):::role

    A1 -.- RP
    D2 -.- RP2
    A6 -.- RADM
```

## 端点明细

### 入驻与认证
| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/guide/register` | 规划师注册 | 📋规划师端 |
| `/api/guide/application/submit` | 提交入驻申请 | 📋规划师端 |
| `/api/guide/application/withdraw` | 撤回申请 | 📋规划师端 |
| `/api/guide/application/resubmit` | 重新提交申请 | 📋规划师端 |
| `/api/guide/application/{id}/records` | 申请审批记录 | 📋规划师端 |
| `/api/guide/applications` | 申请列表 | 📋规划师端 |
| `/api/guide/applications/my` | 我的申请 | 📋规划师端 |
| `/api/guide/apply/new` | 新入驻申请 | 📋规划师端 |
| `/api/guide/apply/upgrade` | 升级申请 | 📋规划师端 |

### 个人信息
| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/guide/my` | 我的信息 | 📋规划师端 |
| `/api/guide/my/packages` | 我的套餐 | 📋规划师端 |
| `/api/guide/parent-guide` | 上级规划师 | 📋规划师端 |
| `/api/guide/child-guides` | 下级规划师列表 | 📋规划师端 |
| `/api/guide/all-child-guides` | 全部下级规划师 | 📋规划师端 |

### 团队管理
| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/guide/team/my-team` | 获取我的团队 | 📋规划师端 |
| `/api/guide/team/invite-code` | 获取团队邀请码 | 📋规划师端 |
| `/api/guide/team/invite-code/generate` | 生成团队邀请码 | 📋规划师端 |
| `/api/guide/team/members` | 团队成员列表 | 📋规划师端 |
| `/api/guide/team/check-status` | 检查邀请状态 | 📋规划师端 |
| `/api/guide/team/join-by-invite` | 通过邀请码加入 | 📋规划师端 |
| `/api/guide/team/leave` | 离开团队 | 📋规划师端 |
| `/api/guide/team/stats` | 团队统计 | 📋规划师端 |

### 邀请与绑定家庭
| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/guide/parent-invite/generate` | 生成家长邀请 | 📋规划师端 |
| `/api/guide/parent-invite/accept` | 家长接受邀请 | 📱小程序 |
| `/api/guide/bind/invite` | 生成绑定邀请 | 📋规划师端 |
| `/api/guide/bind/validate` | 校验邀请 | 📋规划师端 |
| `/api/guide/families/bound-families` | 绑定家庭列表 | 📋规划师端 |
| `/api/guide/family/list` | 家庭列表 | 📋规划师端 |

### 家庭管理与任务审核
| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/guide/families/{familyId}/overview` | 家庭概览 | 📋规划师端 |
| `/api/guide/families/dashboard-stats` | 仪表盘统计 | 📋规划师端 |
| `/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}` | 查看任务详情 | 📋规划师端 |
| `/api/guide/families/{familyId}/tasks/{taskId}/delete` | 删除任务 | 📋规划师端 |

### 任务模板/套餐包管理
| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/guide/packages/my` | 我的模板 | 📋规划师端 |
| `/api/guide/packages/create` | 创建模板 | 📋规划师端 |
| `/api/guide/packages/update` | 更新模板 | 📋规划师端 |
| `/api/guide/packages/update-status` | 更新模板状态 | 📋规划师端 |
| `/api/guide/packages/delete` | 删除模板 | 📋规划师端 |
| `/api/guide/packages/list` | 模板列表 | 📋规划师端 |
| `/api/guide/packages/detail` | 模板详情 | 📋规划师端 |
| `/api/guide/packages/template-detail` | 模板定价详情 | 📋规划师端 |
| `/api/guide/packages/increment-sales` | 增加销量 | 📋规划师端 |
| `/api/guide/packages/level/{level}` | 按等级筛选 | 📋规划师端 |
| `/api/guide/packages/templates` | 获取模板库 | 📋规划师端 |
| `/api/guide/guide-packages` | 套餐包列表 | 📋规划师端 |
| `/api/guide/package/add` | 添加套餐包 | 📋规划师端 |
| `/api/guide/package/{packageId}` | 查看套餐包详情 | 📋规划师端 |
| `/api/guide/package/{packageId}/update` | 更新套餐包 | 📋规划师端 |
| `/api/guide/package/{packageId}/delete` | 删除套餐包 | 📋规划师端 |
| `/api/guide/package/templates` | 套餐模板列表 | 📋规划师端 |

### 活动管理
| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/guide/activities/create` | 创建活动 | 📋规划师端 |
| `/api/guide/activities/list` | 活动列表 | 📋规划师端 |
| `/api/guide/activities/detail` | 活动详情 | 📋规划师端 |
| `/api/guide/activities/update` | 更新活动 | 📋规划师端 |
| `/api/guide/activities/publish` | 发布活动 | 📋规划师端 |
| `/api/guide/activities/cancel` | 下架活动 | 📋规划师端 |
| `/api/guide/activities/delete` | 删除活动 | 📋规划师端 |

### 训练方案
| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/guide/training-plans/list` | 方案列表 | 📋规划师端 |
| `/api/guide/training-plans/create` | 创建方案 | 📋规划师端 |
| `/api/guide/training-plans/items/add` | 添加项目 | 📋规划师端 |
| `/api/guide/training-plans/items/update` | 更新项目 | 📋规划师端 |
| `/api/guide/training-plans/items/delete` | 删除项目 | 📋规划师端 |
| `/api/guide/training-plans/generate-from-recommendations` | 从推荐生成 | 📋规划师端 |
| `/api/guide/training-plans/deploy` | 下发方案 | 📋规划师端 |
| `/api/guide/training-plans/execution-board` | 执行看板 | 📋规划师端 |
| `/api/guide/training-plans/detail` | 方案详情 | 📋规划师端 |
| `/api/guide/training-plans/update` | 更新方案 | 📋规划师端 |
| `/api/guide/training-plans/delete` | 删除方案 | 📋规划师端 |

### 评估管理
| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/guide/assessment/materials` | 可用测评资料 | 📋规划师端 |
| `/api/guide/assessment/families` | 家庭测评列表 | 📋规划师端 |
| `/api/guide/assessment/family/enable` | 启用家庭测评 | 📋规划师端 |
| `/api/guide/assessment/family/{familyId}` | 家庭测评详情 | 📋规划师端 |
| `/api/guide/assessment/family/{familyId}/disable` | 禁用家庭测评 | 📋规划师端 |

### 成长计划
| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/guide/plans/family-list` | 家庭计划列表 | 📋规划师端 |
| `/api/guide/plans/detail` | 计划详情 | 📋规划师端 |
| `/api/guide/plans/activate` | 激活计划 | 📋规划师端 |
| `/api/guide/plans/review` | 审核计划 | 📋规划师端 |

### 成长记录
| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/guide/record/create` | 创建成长记录 | 📋规划师端 |
| `/api/guide/record/my-records` | 我的记录列表 | 📋规划师端 |
| `/api/guide/record/detail/{id}` | 记录详情 | 📋规划师端 |

### 咨询消息
| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/guide/messages/send` | 发送咨询 | 📋规划师端 |
| `/api/guide/messages/my` | 我的咨询 | 📋规划师端 |
| `/api/guide/messages/list` | 咨询列表 | 📋规划师端 |
| `/api/guide/messages/{messageId}/reply` | 回复咨询 | 📋规划师端 |
| `/api/guide/messages/unread-count` | 未读消息数 | 📋规划师端 |

### 订单与佣金
| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/guide/orders/list` | 订单列表 | 📋规划师端 |
| `/api/guide/orders/stats` | 订单统计 | 📋规划师端 |
| `/api/guide/orders/detail` | 订单详情 | 📋规划师端 |

### 教师班级管理
| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/teacher/info` | 教师信息 | 📋规划师端 |
| `/api/teacher/classes/list` | 班级列表 | 📋规划师端 |
| `/api/teacher/classes` | 班级详情 | 📋规划师端 |
| `/api/teacher/classes/{classId}/students` | 查看学生 | 📋规划师端 |
| `/api/teacher/classes/{classId}/students/add` | 添加学生 | 📋规划师端 |
| `/api/teacher/classes/{classId}/students/{studentId}` | 学生详情 | 📋规划师端 |
| `/api/teacher/classes/{classId}/report` | 生成报告 | 📋规划师端 |
| `/api/teacher/students/{studentId}/progress` | 学生进度 | 📋规划师端 |
| `/api/teacher/tasks` | 教师任务 | 📋规划师端 |
| `/api/teacher/tasks/list` | 任务列表 | 📋规划师端 |

### 教师班级管理
| 端点 | 说明 | 角色 |
|------|------|------|
| `/api/teacher/info` | 教师信息 | 教师 |
| `/api/teacher/classes/list` | 班级列表 | 教师 |
| `/api/teacher/classes` | 班级详情 | 教师 |
| `/api/teacher/classes/{classId}/students` | 查看学生 | 教师 |
| `/api/teacher/classes/{classId}/students/add` | 添加学生 | 教师 |
| `/api/teacher/classes/{classId}/students/{studentId}` | 学生详情 | 教师 |
| `/api/teacher/classes/{classId}/report` | 生成报告 | 教师 |
| `/api/teacher/students/{studentId}/progress` | 学生进度 | 教师 |
| `/api/teacher/tasks` | 教师任务 | 教师 |
| `/api/teacher/tasks/list` | 任务列表 | 教师 |