提交 e586d226 authored 作者: yujiejie's avatar yujiejie

实习生培训平台PM前置文件 第一步业务流程图细化版本已完成

上级
差异被折叠。
# 00 · 关键设计文档导读(学习方法篇)
> 适用对象:AIPM 实习生(本人学习复盘用)
> 配套项目:0824studyweb_Prototype_v2.0(实习生培训平台)
> 配套阅读:根目录 `0827原型图平台架构与页面说明.md`
---
## 一、为什么 PRD 和原型图还不够?
PRD 回答"**要做什么**",原型图回答"**长什么样**"。但技术开发、测试验收时,还需要 4 类信息:
| 技术团队的问题 | 需要的文档 |
| --- | --- |
| 流程到底怎么一步一步走?有分支、有异常吗? | 业务流程图(细化) |
| 每个环节归谁负责?角色之间在哪儿交接? | 泳道图 |
| 入项申请、部署任务这类数据对象,状态是怎么变的? | 状态机 |
| 系统由哪些模块组成?怎么分层? | 功能架构图 |
| 页面之间怎么跳?什么条件下能跳?不满足怎么办? | 页面交互梳理表 |
下面这张表是五类文档的定位速查:
| 文档 | 回答的核心问题 | 主要读者 | 产出形态 |
| --- | --- | --- | --- |
| 业务流程图(细化) | 业务是怎么一步步完成的?有哪些判断分支和异常? | 产品、开发、测试 | 流程图 |
| 泳道图 | 每个角色在流程里负责哪一段?交接点在哪? | 产品、开发、测试 | 分泳道的流程图 |
| 状态机 | 一个业务对象有哪些状态?什么事件触发状态迁移? | 后端开发、测试 | 状态图 + 状态表 |
| 功能架构图 | 系统分哪些模块/功能?如何分层? | 架构师、前后端开发 | 树状/分层结构图 |
| 页面交互梳理表 | 每个页面的入口/出口在哪?跳转条件?失败怎么处理? | 前端开发、测试 | 表格 |
---
## 二、每种文档怎么读、怎么写(方法论)
### 1. 业务流程图(细化版)
**基本要素:**
| 图形 | 含义 |
| --- | --- |
| 圆角矩形 / 胶囊 | 流程起止点 |
| 矩形 | 活动/任务 |
| 菱形 | 判断分支 |
| 箭头 | 流转方向(箭头旁标注条件) |
| 带波浪线矩形 / 文档形 | 数据、文档、交付物 |
**写法顺序(重要):**
1. 先画**主干**:正常情况下的主路径(从登录到毕业全链路);
2. 再补**分支**:每个菱形判断的"不通过"路径;
3. 最后补**异常**:失败、驳回、重新提交、流程终止等。
**新手常见坑:**
- 只画理想路径,不画"不通过"分支;
- 忘记给箭头标注判定条件(开发无法落库/落页面);
- 环节粒度不一致(有的画到页面级,有的画到按钮级)。
### 2. 泳道图
**核心思想:泳道 = 参与者。** 每个泳道里放这个角色"自己做的事",跨泳道的箭头就是**交接点**,交接点必须伴随"交付物"(数据/文档/通知)。
**写法顺序:**
1. 列出参与者(本项目的角色:学生/导师/管理员/企业/院校/系统);
2. 把细化流程图中的每个环节归到对应泳道;
3. 检查每个跨泳道箭头:它传递了什么交付物?数据字段是否有人负责生成、有人负责消费?
### 3. 状态机
**核心四要素:**
- **对象(Entity)**:要管理生命周期的数据,如"入项申请""部署任务""实操报告";
- **状态(State)**:对象所处阶段,如"待审核""已通过";
- **事件(Event)**:触发迁移的动作,如"学生提交""导师通过";
- **迁移(Transition)**:`状态A --事件--> 状态B`,迁移要写明条件。
**写法顺序:**
1. 先定对象(一个流程通常有 1 个核心对象,如入项申请);
2. 列出该对象的**状态全集**(含初始态、终态);
3. 画状态迁移图;
4. 对每个迁移补上:触发事件、条件、系统副作用(发通知/改门禁/写日志)。
### 4. 功能架构图
**思路:系统 → 模块 → 子功能 → 页面/接口。** 自上而下分层,先按"角色+业务域"分模块,再往下拆功能点。注意不要按页面机械堆叠,要按业务能力归类。
### 5. 页面交互梳理表
**本质:把"原型图上每个按钮的跳转关系"转成表格。** 字段建议:
| 来源页面 | 触发操作 | 目标页面 | 前置条件/门禁 | 数据/参数 | 异常/拒绝处理 | 备注 |
| --- | --- | --- | --- | --- | --- | --- |
开发拿着这张表 + 原型,就可以直接做路由和门禁开发。
---
## 三、工具选择
| 用途 | 工具 |
| --- | --- |
| 快速产出、可放进 Git 版本化、支持多人协作 | Mermaid(本套文档全部使用,GitHub/GitLab/语雀/Obsidian 均原生渲染) |
| 正式交付、需要标准泳道/跨页大图 | draw.io / ProcessOn / FigJam |
| 会议演示 | Figma 演示模式 |
> 说明:Mermaid 原生不支持"横向泳道"的画法,本套文档用 `subgraph` 按角色分块近似表达泳道,结构清晰且可直接进 Git。如果公司评审需要更正式的效果,可把每张 Mermaid 图在 draw.io 里手动转成标准泳道图。
---
## 四、建议的产出顺序(和开发实施顺序一致)
1. 先细化**业务流程图**(主流程 + 子流程)→ 明确业务环节;
2. 再画**泳道图** → 明确角色分工与交接;
3. 然后抽**状态机** → 后端据此建表、做状态流转;
4. 画**功能架构图** → 前后端据此划模块、拆接口;
5. 最后做**页面交互梳理表** → 前端据此做路由与门禁。
对应本目录文件编号 01 → 05,请按顺序阅读与修改。
差异被折叠。
# 02 · 泳道图(角色职责与协作)
> 适用项目:0824studyweb_Prototype_v2.0(实习生培训平台)
> 用途:明确每个角色在流程中的职责边界与交接点,供开发确定"哪个端做哪个动作、何时联动其他端"
> 阅读建议:先看每张图的泳道划分,再重点关注"跨泳道箭头"(即交接点),最后对照交接点表核对交付物
---
## 0. 怎么读泳道图
- 每个 **横向分块**(本套文档用 `subgraph` 表达)代表一个参与者:角色或系统;
- 块内的环节 = 该角色**自己执行**的动作;
- **跨块的箭头 = 交接点**,交接点必须伴随交付物(数据/文档/通知);
- 读图时按箭头方向串联,重点回答三个问题:
1. 谁发起了流程?
2. 交付物由谁生成、谁消费?
3. 谁做最终判定?
---
## 1. 学生培养主流程泳道图
> 泳道:学生 | 导师 | 管理员 | 企业 | 院校
> 覆盖:登录 → 阶段一~六 → 成长档案
```mermaid
flowchart TB
subgraph ADMIN[管理员端]
direction TB
AD1[下发阶段二模型部署任务]
end
subgraph ST[学生端]
direction TB
S1[登录/上传简历<br>生成能力画像]
S2[阶段一 预习+测验<br>>=70 分解锁]
S3[阶段二 预习+小测<br>>=80 分解锁]
S4[AutoDL 实操<br>提交部署产物]
S5[项目推荐/预习/小测]
S6[项目实操/报告]
S7[答辩申请]
S8[入项意向申请<br>正式入项申请]
end
subgraph MT[导师端]
direction TB
M1[部署验收<br>API检测/评分/结论]
M2[实操评审]
M3[报告评审]
M4[答辩评审]
M5[入项意向审核]
end
subgraph EN[企业端]
direction TB
E1[入项主管终审]
end
subgraph SC[院校教务端]
direction TB
SC1[成长档案归档<br>能力雷达图]
end
S1 --> S2
S2 --> S3
S3 --> S4
AD1 -->|部署任务| S4
S4 -->|提交日志/产物/API/报告| M1
M1 -->|验收结论+通知| S4
M1 -->|验收通过| S5
S5 --> S6
S6 -->|提交实操产物/报告| M2
M2 -->|评审结论+通知| S6
M2 -->|通过| S7
S7 -->|答辩申请| M3
M3 -->|评审结论| S7
M3 -->|通过| M4
M4 -->|答辩结论| S7
M4 -->|通过| S8
S8 -->|入项意向/正式申请| M5
M5 -->|意向审核结论| S8
M5 -->|意向通过| E1
E1 -->|终审结论| S8
E1 -->|通过| SC1
```
**交接点表:**
| 编号 | 交接动作 | 交付物 | 源角色 | 目标角色 |
| --- | --- | --- | --- | --- |
| 1 | 下发部署任务 | 文本模型/图像生成任务 | 管理员 | 学生 |
| 2 | 提交部署产物 | 日志、产物、API 地址、实操报告 | 学生 | 导师 |
| 3 | 同步验收结论 | 验收结论 + 通知 | 导师 | 学生 |
| 4 | 提交实操产物/报告 | 实操产物、报告 | 学生 | 导师 |
| 5 | 同步评审结论 | 评审结论 + 通知 | 导师 | 学生 |
| 6 | 提交答辩申请 | 答辩材料 | 学生 | 导师 |
| 7 | 同步答辩结论 | 答辩结论 + 通知 | 导师 | 学生 |
| 8 | 提交入项申请 | 意向申请/正式申请 | 学生 | 导师 |
| 9 | 入项意向审核 | 意向审核结论 | 导师 | 学生 |
| 10 | 正式申请流转 | 正式入项申请 | 导师 | 企业 |
| 11 | 企业终审 | 终审结论 | 企业 | 学生 |
| 12 | 归档 | 成长档案/雷达图 | 企业 | 院校 |
---
## 2. 模型部署流程泳道图(阶段二局部)
> 泳道:管理员 | 学生 | 导师
```mermaid
flowchart TB
subgraph ADMIN[管理员端]
direction TB
A1[配置部署任务<br>文本模型/图像生成]
A2[预览/保存草稿]
A3{确认发布?}
A3 -->|否| A1
A3 -->|是| A4[统一发布任务]
end
subgraph ST[学生端]
direction TB
S1[部署预习+小测]
S2{成绩>=80?}
S2 -->|否| S1
S2 -->|是| S3[AutoDL 租赁实例]
S3 --> S4[SSH 连接/连通性测试]
S4 --> S5[Web IDE 完成部署]
S5 --> S6[整理日志/产物/API地址/报告]
S6 --> S7[提交部署产物]
end
subgraph MT[导师端]
direction TB
M1[部署验收总览<br>选择学生/查看提交物]
M2[独立验收台<br>API 检测/评分/结论草稿]
M3{提交结论?}
M3 -->|否| M2
M3 -->|是| M4[同步验收结论与通知]
end
A4 -->|任务数据| S1
A4 -->|任务数据| S6
S7 -->|提交物| M1
M4 -->|通过| S7
M4 -->|驳回/整改意见| S7
```
**交接点表:**
| 编号 | 交接动作 | 交付物 | 源角色 | 目标角色 |
| --- | --- | --- | --- | --- |
| 1 | 发布部署任务 | 任务内容(覆盖默认任务) | 管理员 | 学生 |
| 2 | 提交部署产物 | 日志、产物、API 地址、报告 | 学生 | 导师 |
| 3 | 同步验收结论 | 通过结论/驳回+整改意见 | 导师 | 学生 |
> 注意:原型中导师验收页支持"结论草稿",即 M2 → M3 之间导师可多次保存草稿再提交;学生侧以最终提交的结论为准。
---
## 3. 入项审核流程泳道图(阶段六局部)
> 泳道:学生 | 导师 | 企业
```mermaid
flowchart TB
subgraph ST[学生端]
direction TB
S1[填写入项意向<br>岗位/方向/理由]
S2[提交意向申请]
S3[接收意向审核结果]
S4{意向通过?}
S4 -->|否| S5[查看驳回原因<br>流程终止]
S4 -->|是| S6[填写正式入项申请<br>补齐材料]
S6 --> S7[提交正式申请]
S8[接收终审结果]
S9{终审通过?}
S9 -->|否| S10[查看驳回原因<br>流程终止]
S9 -->|是| S11[入项成功<br>进入成长档案]
end
subgraph MT[导师端]
direction TB
M1[查看入项申请<br>学员培养记录]
M2[入项意向审核]
M3[同步意向审核结论]
end
subgraph EN[企业端]
direction TB
E1[企业主管查看正式申请<br>培养记录与统计]
E2[主管终审]
E3[同步终审结论]
end
S2 -->|意向申请| M1
M1 --> M2
M2 --> M3
M3 -->|意向结论+原因| S3
S7 -->|正式申请| E1
E1 --> E2
E2 --> E3
E3 -->|终审结论+原因| S8
```
**交接点表:**
| 编号 | 交接动作 | 交付物 | 源角色 | 目标角色 |
| --- | --- | --- | --- | --- |
| 1 | 提交意向申请 | 意向表单 | 学生 | 导师 |
| 2 | 同步意向结论 | 通过/驳回 + 原因 | 导师 | 学生 |
| 3 | 提交正式申请 | 正式申请材料 | 学生 | 企业 |
| 4 | 同步终审结论 | 通过/驳回 + 原因 | 企业 | 学生 |
> 补充:企业端入项审批通过后,该记录进入企业端"入项记录"页面,同时写入学生端成长档案;导师端不再参与正式申请环节。
---
## 4. 培训体系协作流程泳道图
> 泳道:管理员 | 企业 | 院校
> 覆盖:体系生成 → 企业审批 → 院校确认 → 发布生效 → 版本迭代
```mermaid
flowchart TB
subgraph ADMIN[管理员端]
direction TB
A1[创建/编辑培训体系]
A2[AI 生成/预览]
A3{内容确认?}
A3 -->|否| A1
A3 -->|是| A4[发布提审]
A6[接收修改意见<br>修订体系]
A7[生成新版本]
end
subgraph EN[企业端]
direction TB
E1[查看培训体系]
E2{审批通过?}
E2 -->|否| E3[提出修改意见]
E2 -->|是| E4[体系流转院校]
end
subgraph SC[院校教务端]
direction TB
C1[确认接收体系]
C2{确认?}
C2 -->|否| C3[反馈修改建议]
C2 -->|是| C4[体系生效<br>记录版本]
C5[组织教学<br>任务分配/进度监控]
C6[跟踪实施效果<br>档案/统计]
C7{需版本迭代?}
C7 -->|是| C8[发起迭代请求]
end
A4 -->|体系内容| E1
E3 -->|修改意见| A6
A6 --> A1
E4 -->|已审批体系| C1
C3 -->|修改建议| A6
C4 --> C5
C5 --> C6
C6 --> C7
C8 -->|迭代需求| A7
A7 --> A1
```
**交接点表:**
| 编号 | 交接动作 | 交付物 | 源角色 | 目标角色 |
| --- | --- | --- | --- | --- |
| 1 | 发布提审 | 培训体系内容 | 管理员 | 企业 |
| 2 | 提出修改意见 | 修改意见 | 企业 | 管理员 |
| 3 | 流转已审批体系 | 已审批体系 | 企业 | 院校 |
| 4 | 反馈修改建议 | 修改建议 | 院校 | 管理员 |
| 5 | 发起迭代请求 | 迭代需求 | 院校 | 管理员 |
---
## 5. 泳道图使用建议
1. **给开发**:泳道图决定了"前后端如何分工"。例如"模型部署"链路上,学生提交产物后要立即同步到导师端,开发需在 `student/shared.js` 与 `mentor/shared.js` 之间建立共享数据或接口。
2. **给测试**:每个交接点都是用例设计的重点——重点测试"交付物是否完整、状态是否一致、通知是否到达"。
3. **画正式交付图**:把每张 Mermaid 图在 draw.io / ProcessOn 中按"横向泳道"重画,可读性更佳。
差异被折叠。
# 04 · 功能架构图(系统模块与分层)
> 适用项目:0824studyweb_Prototype_v2.0(实习生培训平台)
> 用途:定义系统模块边界、功能点归属与跨端共享机制,供架构师/前后端开发划分模块、拆接口
> 阅读建议:先看第 1 节总览图,再看第 2 节功能清单表,最后看第 3 节跨端共享机制
---
## 1. 系统功能架构总览
> 分层方式:公共层(登录/注册/个人中心)→ 五端业务模块 → 支撑层(跨端共享数据、门禁、通知)
```mermaid
flowchart TB
P[实习生培训平台]
subgraph COMMON[公共层]
C1[登录/认证]
C2[注册]
C3[个人中心<br>资料/密码/通知/统计]
end
subgraph STUDENT[学生端]
S1[简历与能力画像]
S2[衔接学习<br>预习+测验]
S3[模型部署<br>预习+小测+AutoDL+提交]
S4[项目实训<br>推荐+预习+小测+实操]
S5[报告与答辩]
S6[入项申请]
S7[成长档案]
S8[进阶匹配]
end
subgraph MENTOR[导师端]
M1[工作台/待办]
M2[学员管理]
M3[部署验收<br>验收台+API检测]
M4[实操评审]
M5[答辩评审]
M6[入项审核]
end
subgraph ADMIN[管理员端]
A1[控制台/监控]
A2[项目管理]
A3[难度校准]
A4[AI 配置]
A5[培训体系生成器]
A6[部署任务下发]
A7[用户/角色/权限]
A8[部门管理]
A9[日志审计]
end
subgraph ENTERPRISE[企业端]
E1[工作台/预警]
E2[入项终审]
E3[培训体系审批]
E4[入项记录]
E5[服务交付]
E6[统计报表]
end
subgraph SCHOOL[院校教务端]
K1[工作台/教学概览]
K2[培训体系管理]
K3[教学管理]
K4[学生档案]
K5[账户与认证]
K6[商业服务]
end
subgraph SUPPORT[支撑层]
T1[跨端共享数据<br>studentState/mentorState/adminDeployTask]
T2[阶段门禁引擎<br>switchPage 校验]
T3[通知分发]
T4[部署验收工具<br>Acceptance.html]
end
P --> COMMON
P --> STUDENT
P --> MENTOR
P --> ADMIN
P --> ENTERPRISE
P --> SCHOOL
STUDENT --> SUPPORT
MENTOR --> SUPPORT
ADMIN --> SUPPORT
ENTERPRISE --> SUPPORT
SCHOOL --> SUPPORT
```
---
## 2. 各端功能清单表
### 2.1 公共层
| 模块 | 功能点 | 对应页面 | 说明 |
| --- | --- | --- | --- |
| 登录认证 | 账号密码登录、角色快速体验 | `login` | 演示用五类角色入口 |
| 注册 | 角色选择、账户创建 | `register` | — |
| 个人中心 | 基础资料、密码、通知设置、学习统计、最近登录 | `profile` | 全角色共用 |
### 2.2 学生端
| 模块 | 功能点 | 对应页面 | 说明 |
| --- | --- | --- | --- |
| 学习首页 | 当前阶段、培养路径、下一步任务、学习建议 | `student-dashboard` | — |
| 简历与画像 | 上传简历、生成能力画像/标签/建议 | `student-resume` | 阶段一入口 |
| 衔接学习 | 知识点预习、衔接测验(70 分)、成绩与错题 | `student-bridge-preview` / `student-bridge-quiz` / `student-bridge-quiz-result` | — |
| 模型部署 | 部署预习、部署小测(80 分)、成绩与错题 | `student-deploy-preview` / `student-deploy-quiz` / `student-deploy-quiz-result` | — |
| AutoDL 实操 | 租赁信息、SSH、连通性测试、Code Server/Web IDE | `student-autodl` | — |
| 部署提交 | 提交产物/报告、保存状态、验收结果、AI 分析 | `student-deploy-submit` / `student-deploy-result` | — |
| 项目实训 | 推荐大厅、项目详情、预习、小测、实操 | `student-projects` / `student-preview` / `student-quiz` / `student-quiz-result` / `student-practice` | — |
| 报告与答辩 | 报告撰写评审、答辩申请与评审 | `student-report` / `student-defense` | — |
| 入项申请 | 意向申请、审核状态、正式申请、终审状态 | `student-entry` | — |
| 成长档案 | 阶段记录、能力雷达图、历史汇总 | `student-archive` | — |
| 进阶匹配 | 能力短板、进阶推荐 | `student-advance` | 辅助页 |
### 2.3 导师端
| 模块 | 功能点 | 对应页面 | 说明 |
| --- | --- | --- | --- |
| 工作台 | 带教学员、待办、四阶段进度、日程、统计 | `mentor-dashboard` | — |
| 学员管理 | 学员列表、阶段进度、筛选、详情 | `mentor-students` | — |
| 部署验收 | 验收总览、独立验收台、API 检测、评分、结论 | `mentor-deploy-review` / `mentor-deploy-acceptance` | 验收台为辅助页 |
| 实操评审 | 提交信息查看、评审结论 | `mentor-practice-review` | — |
| 答辩评审 | 材料、安排、结论 | `mentor-defense-review` | — |
| 入项审核 | 综合评审、审批表单 | `mentor-entry-review` | — |
### 2.4 管理员端
| 模块 | 功能点 | 对应页面 | 说明 |
| --- | --- | --- | --- |
| 控制台 | 用户/项目/匹配率/健康度统计、快捷操作 | `admin-dashboard` | — |
| 项目管理 | 项目搜索/筛选/编辑/新增 | `admin-projects` | — |
| 难度校准 | 难度维度、分级规则、AI 辅助评估 | `admin-difficulty` | — |
| AI 配置 | 匹配算法、模型参数、模型状态 | `admin-ai-config` | 辅助页,未入导航 |
| 体系生成器 | 创建/生成/预览/发布培训体系 | `admin-system-generator` | — |
| 任务下发 | 文本模型/图像任务配置、草稿、统一发布 | `admin-deploy-task` | 发布后覆盖学生任务 |
| 用户管理 | 账号、角色、状态、查询 | `admin-users` | — |
| 角色权限 | 角色定义、权限项配置 | `admin-roles` / `admin-permissions` | — |
| 部门管理 | 部门、编码、成员、职责 | `admin-departments` | — |
| 日志审计 | 登录日志、审计/访问记录 | `admin-logs` / `admin-monitoring` | — |
### 2.5 企业端
| 模块 | 功能点 | 对应页面 | 说明 |
| --- | --- | --- | --- |
| 工作台 | 入项审批、训练中学员、预警、待办、统计 | `enterprise-dashboard` | — |
| 入项终审 | 学员入项申请处理 | `enterprise-review` | — |
| 体系审批 | 培训体系审核、提出修改意见 | `enterprise-training-approve` | 辅助页 |
| 入项记录 | 已完成审批学员与培养记录 | `enterprise-records` | — |
| 服务交付 | 培训交付相关 | `enterprise-delivery` | 辅助页 |
| 统计报表 | 培养周期、通过率、评审耗时趋势 | `enterprise-stats` | — |
### 2.6 院校教务端
| 模块 | 功能点 | 对应页面 | 说明 |
| --- | --- | --- | --- |
| 工作台 | 活跃学生、待确认体系、完成率、到期提醒 | `school-dashboard` | — |
| 体系管理 | 体系筛选、AI 生成器、确认接收、修改建议、版本历史 | `school-systems` | — |
| 教学管理 | 实训任务分配、进度监控、教学活动 | `school-teaching` | — |
| 学生档案 | 能力画像、历次实训记录、学生详情 | `school-students` | — |
| 账户认证 | 学校信息、账号概览、授权、认证状态 | `school-accounts` | — |
| 商业服务 | 订阅套餐、服务权益、商务信息 | `school-business` | — |
---
## 3. 跨端共享机制(支撑层)
| 机制 | 说明 | 落地位置 |
| --- | --- | --- |
| 共享状态 | 学生、导师、管理员端各自维护 `studentState` / `mentorState` / `adminDeployTask`,作为跨页面数据源 | 各端 `shared.js` |
| 阶段门禁 | `switchPage()` 统一拦截未解锁页面,页面内再按状态二次校验 | `index.html` + 页面 JS |
| 任务下发覆盖 | 管理员发布部署任务后覆盖学生端默认任务 `DEPLOY_TASK_INFO` | `admin/shared.js` → `student/shared.js` |
| 评审结果同步 | 导师提交结论后同步到学生结果页与通知 | `mentor/shared.js` → `student/shared.js` |
| 验收工具 | `Acceptance.html` 独立用于 API 验收,与主平台解耦 | 独立页面 |
> 注意:当前原型为浏览器内存状态 + `localStorage`。若正式开发,上述共享机制应替换为后端 API + 数据库事务,建议按本套文档的状态机设计建表,按泳道图拆接口。
差异被折叠。
差异被折叠。
差异被折叠。
Markdown 格式
0% 或
您添加了 0 人 到此讨论。请谨慎行事。
请先完成此评论的编辑!
请 注册 或者 后发表评论