cfc/docs/flows/guide-system-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(("📋 成长规划师")):::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	任务列表	教师