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

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

上级
# 实习生培训平台原型:平台架构与页面说明
> 适用项目:`0824studyweb_Prototype_v2.0`
> 文档用途:用于介绍原型、定位页面代码、评估跨端影响,并指导后续动态需求修改。
> 基准:按当前已拆分的页面结构整理,页面以浏览器端原型数据和交互为主,不连接生产后端。
## 1. 项目定位
这是一个多角色的“实习生训练平台”产品原型。平台围绕 AI 实习生培养闭环设计,涵盖学生学习、导师评审、管理员配置、企业审批和院校教务协作。
当前原型采用原生 HTML + JavaScript + Tailwind CDN 的方式实现。所有页面均由 JavaScript 函数生成 HTML,并注入同一个单页入口,因此浏览器地址不会随页面切换而变化。
### 1.1 六个角色端
| 端 | 主要使用者 | 核心职责 |
| --- | --- | --- |
| 学生端 | 实习生/学员 | 完成简历分析、学习、测验、模型部署、实操、报告、答辩、入项申请 |
| 导师端 | 培训导师 | 管理学员并完成实操、部署、答辩、入项审核 |
| 管理员端 | 平台管理员 | 管理项目、任务、用户、权限、部门、日志、监控与体系配置 |
| 企业端 | 企业主管/业务方 | 审核入项、查看培养记录与统计,并参与培训体系审批/交付 |
| 院校教务端 | 学校教务人员 | 管理培训体系、教学任务、学生档案、账号与商业服务 |
| 公共端 | 未登录用户/所有角色 | 登录、注册、个人中心 |
### 1.2 核心培养闭环
```mermaid
flowchart LR
L[登录/角色选择] --> S[学生端]
S --> R[上传简历与能力画像]
R --> B[阶段一:衔接预习与测验]
B --> D[阶段二:模型部署]
D --> A[AutoDL 实操与提交产物]
A --> M[导师部署验收]
M --> P[项目实操、报告与答辩]
P --> E[入项申请]
E --> MR[导师审核]
MR --> ER[企业主管终审]
ER --> AR[成长档案]
```
其中,阶段三至阶段五使用“项目推荐 -> 知识点预习 -> 小测 -> 实操 -> 报告 -> 答辩”的同一类流程;阶段六为导师审核和企业主管终审。
### 1.3 跨端协作关系
```mermaid
flowchart TB
Admin[管理员端]
Student[学生端]
Mentor[导师端]
Enterprise[企业端]
School[院校教务端]
Admin -->|下发阶段二模型部署任务| Student
Student -->|提交部署产物、报告、答辩、入项申请| Mentor
Mentor -->|评审结果、通知、部署验收结论| Student
Mentor -->|入项审核结果| Enterprise
Enterprise -->|主管终审、培养统计| Student
Enterprise -->|培训体系审批/交付信息| School
School -->|教学管理、学生档案、体系反馈| Enterprise
```
## 2. 顶层目录与入口
```text
0824studyweb_Prototype_v2.0/
├─ index.html # 平台主入口、全局样式、布局、路由和脚本加载顺序
├─ Acceptance.html # 独立的 AutoDL 模型/API 验收工具原型
├─ pages/ # 六端的共享逻辑和页面渲染器
├─ tools/
│ └─ split-page-renderers.js # 将旧的大页面文件按 renderer 拆分的工具
├─ pages.js.bak # 拆分前的历史备份,不参与运行
├─ upgrade-ui.js # 旧版批量 UI 替换脚本,当前路径已过期
└─ docs/ # 项目说明、交接和需求文档
```
| 文件/目录 | 当前职责 | 修改建议 |
| --- | --- | --- |
| `index.html` | 运行入口;全局 CSS;学生/非学生布局;`pageRenderers` 容器;角色导航;登录、退出和页面切换 | 仅在新增端、改全局布局、改导航规则、改脚本加载顺序时修改 |
| `pages/` | 业务页面和各端共享状态/函数 | 日常需求优先在对应端目录内完成 |
| `Acceptance.html` | 用于手动配置 API 地址、测试聊天/图像接口、轮询图像任务的独立验收页 | 与主平台页面解耦;改验收工具时单独修改 |
| `tools/split-page-renderers.js` | 从旧大文件抽取 `pageRenderers[...]` 函数为单文件 | 用于结构维护,不参与浏览器运行;执行 `--write` 前必须先备份源文件 |
| `pages.js.bak` | 拆分时保存的旧文件快照 | 仅供历史对照,不能当作当前运行源码覆盖回去 |
| `upgrade-ui.js` | 旧版针对 `pages-*.js` 文件名的批量样式替换脚本 | **当前不应直接执行**。这些旧路径已拆分为 `pages/<端>/...`,如需批量 UI 升级,应先改造脚本或按文件逐步修改 |
## 3. 页面加载与运行机制
### 3.1 页面如何被渲染
1. `index.html` 先创建全局对象 `pageRenderers`。
2. 按固定顺序加载各端的 `shared.js` 和页面 JS 文件。
3. 每个页面文件把自己的渲染函数注册为 `pageRenderers["页面ID"]`。
4. `switchPage("页面ID")` 修改当前页面,并调用 `renderContent()`。
5. `renderContent()` 将 HTML 注入:
- 学生端:`#studentContent`
- 其他端:`#otherContent`
6. 注入后重新初始化 Lucide 图标;成长档案页存在雷达图时,初始化 ECharts。
页面文件的共同形式如下:
```js
pageRenderers["student-example"] = function () {
return `<div>页面 HTML</div>`;
};
```
### 3.2 角色与导航配置
`index.html` 中的 `ROLES` 是顶层导航的唯一配置来源。每个角色都有:
- `name`:角色名称;
- `pages`:顶层导航中显示的页面 ID 与名称;
- 第一个页面:该角色登录后的默认首页。
学生端采用沉浸式顶部栏;导师、管理员、企业和院校端共用顶部横向导航。部分业务页不放在 `ROLES` 中,而是由卡片或按钮进入,例如导师部署验收台、企业培训体系审批、学生进阶匹配页。
### 3.3 页面切换限制
`switchPage()` 中包含学生端的主流程门禁:
| 目标页面 | 进入条件 | 未满足时的行为 |
| --- | --- | --- |
| 项目推荐、项目预习、小测、实操、报告、答辩 | 阶段一衔接测验已通过 | 回到学生首页,展示衔接阶段锁定提示 |
| AutoDL、提交部署产物 | 阶段一已通过,且阶段二部署小测已通过 | 回到学生首页,提示先完成部署小测 |
页面内还会根据 `studentState` 进行更细的判断,例如未上传简历时展示“先上传简历”、未完成知识点预习时展示“先完成预习”。
### 3.4 重要约束
- `shared.js` 必须在该端所有页面文件之前加载。
- 页面 ID、`pageRenderers["..."]` 的 ID、跳转按钮中的 `switchPage("...")` 必须一致。
- 新增 JS 文件后,必须在 `index.html` 中增加对应的 `<script src="..."></script>`。
- 不要把多端共用的数据简单复制到多个页面文件;应放入负责该业务域的 `shared.js`。
- 目前是浏览器内存状态原型。刷新页面后除页面自行写入 `localStorage` 的内容外,状态会回到初始值。
## 4. 各端目录与文件说明
### 4.1 `pages/common`:公共页面
| 文件 | 页面 ID / 类型 | 简要内容 | 后续修改入口 |
| --- | --- | --- | --- |
| `pages/common/shared.js` | 公共共享文件 | 当前主要保留公共页面分组说明,没有承载复杂业务状态 | 若未来登录态、当前用户资料、统一通知需要跨端共享,可在此集中维护 |
| `pages/common/login.js` | `login` | 登录页、账号密码输入、演示用的五类角色快速体验入口 | 改登录文案、角色体验按钮、登录表单布局 |
| `pages/common/register.js` | `register` | 注册页、角色选择、基本账户创建表单 | 改注册字段、协议、注册后的跳转 |
| `pages/common/profile.js` | `profile` | 个人中心:基础资料、密码、通知设置、学习统计、最近登录 | 改全角色共用个人中心展示;如需真正按角色显示,需同步改用户状态与入口 |
### 4.2 `pages/student`:学生端
学生端文件数最多,分为“阶段流程页”和“后续项目实训页”。核心共享数据是 `studentState`,集中管理简历、当前阶段、测验、部署产物、实操、报告、答辩、入项和通知状态。
| 文件 | 页面 ID / 类型 | 简要内容 | 后续修改入口 |
| --- | --- | --- | --- |
| `pages/student/shared.js` | 学生端共享逻辑 | 六阶段培养路径;简历解析模拟;知识点阅读和测验;AutoDL 租赁/SSH/连通性/Web IDE;部署产物和报告;项目实训、答辩、入项、通知等状态与函数 | 改学生流程规则、门禁、状态字段、跨页面数据、模拟提交和通知时优先改这里 |
| `pages/student/dashboard.js` | `student-dashboard` | 学习首页;展示当前阶段、培养路径、下一步任务、快速入口和学习建议 | 改首页卡片、阶段提示、快捷入口和数据摘要 |
| `pages/student/resume.js` | `student-resume` | 上传简历并生成能力画像、能力标签、提升建议,作为阶段一入口 | 改简历上传样式、解析结果展示、能力画像字段 |
| `pages/student/bridge-preview.js` | `student-bridge-preview` | 阶段一衔接知识点预习;未上传简历时显示引导 | 改衔接知识内容布局;实际题库与阅读状态在 `student/shared.js` |
| `pages/student/bridge-quiz.js` | `student-bridge-quiz` | 阶段一衔接测验,及格线 70 分 | 改题目页面结构;题库、计分和提交规则在 `student/shared.js` |
| `pages/student/bridge-quiz-result.js` | `student-bridge-quiz-result` | 展示衔接测验成绩、错题和进入阶段二入口 | 改成绩展示、错题回看、通过后行动按钮 |
| `pages/student/deploy-preview.js` | `student-deploy-preview` | 阶段二模型部署知识点预习;依赖阶段一通过 | 改部署预习页面布局;知识内容和阅读逻辑在 `student/shared.js` |
| `pages/student/deploy-quiz.js` | `student-deploy-quiz` | 阶段二部署章节小测,及格线 80 分 | 改试题页面布局;题库、计分与通过门槛在 `student/shared.js` |
| `pages/student/deploy-quiz-result.js` | `student-deploy-quiz-result` | 展示部署小测成绩,提供进入 AutoDL 的入口 | 改成绩反馈、纠错和下一步引导 |
| `pages/student/autodl.js` | `student-autodl` | AutoDL 实操环境:任务说明、租赁信息、SSH、连通性测试、Code Server/Web IDE | 改 AutoDL 页面结构;租赁表单、连通性、SSH 与状态逻辑在 `student/shared.js` |
| `pages/student/deploy-submit.js` | `student-deploy-submit` | 提交部署产物和实操报告;未通过部署小测时回退到 AutoDL 引导 | 改产物/报告的表单页面;校验、保存、提交与同步逻辑在 `student/shared.js` |
| `pages/student/deploy-result.js` | `student-deploy-result` | 部署作业详情:保存状态、导师验收结果、AI 分析、提交信息和通知 | 改验收结果展示;导师端同步和状态判断在 `student/shared.js` 与 `mentor/shared.js` |
| `pages/student/projects.js` | `student-projects` | AI 推荐项目大厅;支持普通项目阶段和进阶推荐展示 | 改项目卡片、筛选、项目详情弹层;项目目录和推荐数据在 `student/shared.js` |
| `pages/student/preview.js` | `student-preview` | 选择项目后的知识点预习 | 改项目预习页面外观;知识包、阅读状态在 `student/shared.js` |
| `pages/student/quiz.js` | `student-quiz` | 项目知识点小测;未选项目或未完成预习时展示门禁说明 | 改项目测验页面;题库和计分在 `student/shared.js` |
| `pages/student/quiz-result.js` | `student-quiz-result` | 项目预习小测成绩与错题回看 | 改结果卡、复习入口和实操入口 |
| `pages/student/practice.js` | `student-practice` | 项目实操工作台:任务说明、仓库/产物提交、草稿与提交成功状态 | 改实操表单;提交校验和状态变更在 `student/shared.js` |
| `pages/student/report.js` | `student-report` | 实操报告撰写、提交、模拟导师评审;部署阶段会检查部署验收 | 改报告字段、评审展示;状态流转在 `student/shared.js` |
| `pages/student/defense.js` | `student-defense` | 答辩申请、答辩安排、模拟导师评审与重新申请 | 改答辩材料、状态提示、评审展示;申请/审核逻辑在 `student/shared.js` |
| `pages/student/entry.js` | `student-entry` | 入项意向、导师审核、正式申请、企业主管终审和入项成功状态 | 改入项字段和各审核状态;跨端审批数据需同步检查导师/企业相关文件 |
| `pages/student/advance.js` | `student-advance`,辅助页 | 进阶匹配与能力画像、推荐进阶项目 | 改能力短板和进阶推荐展示;通常由阶段推进逻辑进入,不是顶层导航项 |
| `pages/student/archive.js` | `student-archive` | 成长档案、阶段记录、能力雷达图、学习/项目/评审历史 | 改档案区块和统计呈现;雷达图初始化在 `index.html` 的 `initRadarChart()` |
#### 学生端的关键数据与流程
| 业务域 | 主要代码位置 | 说明 |
| --- | --- | --- |
| 当前培养阶段、简历、测验、项目、报告、答辩、入项 | `index.html` 中的 `studentState` 与 `pages/student/shared.js` | 页面读取同一份内存状态,修改字段名称时必须同步所有引用 |
| 阶段一门禁 | `isBridgePassed()`、`switchPage()` | 衔接测验通过后才允许进入项目实训域 |
| 阶段二门禁 | `studentState.deployQuizPassed`、`goStudentPrdPage()`、`switchPage()` | 部署小测通过后才允许进 AutoDL 和部署提交页 |
| AutoDL | `pages/student/shared.js` | 租赁记录、SSH、连接测试、Web IDE 展示均在此;目前为演示模拟,非真实租赁平台集成 |
| 部署任务 | `DEPLOY_TASK_INFO` 与 `adminDeployTask` | 学生端读取默认任务;管理员端发布后会覆盖为管理员下发的任务数据 |
| 通知 | `buildStudentNotificationListHtml()` 等 | 部署审核结果等会转成学生端通知 |
### 4.3 `pages/mentor`:导师端
| 文件 | 页面 ID / 类型 | 简要内容 | 后续修改入口 |
| --- | --- | --- | --- |
| `pages/mentor/shared.js` | 导师端共享逻辑 | `mentorState` 学员与评审数据;部署验收学生选择、提交物查看、模拟/真实 API 测试、评分、草稿、结论、轮询与结果同步 | 改导师数据、实操/答辩/入项审核规则;部署验收逻辑优先修改这里 |
| `pages/mentor/dashboard.js` | `mentor-dashboard` | 导师工作台:带教学员、待办、四阶段进度、日程和统计 | 改导师首页指标、任务优先级、快捷入口 |
| `pages/mentor/students.js` | `mentor-students` | 学员管理:学生列表、阶段进度、筛选和学员详情 | 改学员卡片/表格、筛选维度、详情展示 |
| `pages/mentor/practice-review.js` | `mentor-practice-review` | 实操报告评审台:查看提交信息并给出评审结论 | 改报告审核表单和反馈文案;审批状态写入逻辑在共享文件 |
| `pages/mentor/defense-review.js` | `mentor-defense-review` | 答辩评审台:查看答辩材料、安排和结论 | 改答辩评审字段、评分/结论展示 |
| `pages/mentor/entry-review.js` | `mentor-entry-review` | 入项申请审核:对学生提交的申请进行综合评审 | 改导师审核标准、审批表单与结果展示 |
| `pages/mentor/deploy-review.js` | `mentor-deploy-review` | 部署验收总览:选择学生、查看产物、日志、报告、完成度与验收入口 | 改验收总览布局、学生选择和提交物展示 |
| `pages/mentor/deploy-acceptance.js` | `mentor-deploy-acceptance`,辅助页 | 独立部署验收台:对所选学生完成 API 检测、评分和提交验收结论 | 改独立验收台布局;测试、评分和结果同步逻辑在 `mentor/shared.js` |
### 4.4 `pages/admin`:管理员端
| 文件 | 页面 ID / 类型 | 简要内容 | 后续修改入口 |
| --- | --- | --- | --- |
| `pages/admin/shared.js` | 管理员端共享逻辑 | 阶段二文本模型/图像生成任务的草稿、编辑、预览、保存和统一下发 | 改管理员下发任务字段、默认值、发布规则;会影响学生 AutoDL/部署任务展示 |
| `pages/admin/dashboard.js` | `admin-dashboard` | 管理控制台:用户、项目、匹配率、健康度、动态和快捷操作 | 改管理员首页统计与快捷入口 |
| `pages/admin/projects.js` | `admin-projects` | 项目库管理:项目查看、搜索、筛选、编辑/新增入口 | 改项目字段、项目列表和审核展示 |
| `pages/admin/difficulty.js` | `admin-difficulty` | 难度校准:项目难度与 AI 辅助评估结果 | 改难度维度、分级规则和校准交互 |
| `pages/admin/ai-config.js` | `admin-ai-config`,辅助页 | AI 配置:匹配算法、模型参数、模型状态 | 当前未放入顶层导航;改 AI 相关配置展示或需要新增导航入口时修改 |
| `pages/admin/system-generator.js` | `admin-system-generator` | 培训体系生成器:创建、生成、预览、发布体系 | 改体系表单、生成步骤、发布/版本流程 |
| `pages/admin/monitoring.js` | `admin-monitoring` | 系统监控:资源、服务状态、审计/访问记录 | 改监控指标、异常规则、日志展示 |
| `pages/admin/deploy-task.js` | `admin-deploy-task` | 阶段二任务下发页:配置文本模型与图像生成任务、预览、保存草稿、统一发布 | 任务内容变更的首选入口;提交/发布函数在 `admin/shared.js` |
| `pages/admin/users.js` | `admin-users` | 用户列表:账号、角色、状态、查询和操作入口 | 改用户字段、筛选、状态和角色展示 |
| `pages/admin/roles.js` | `admin-roles` | 角色管理:角色及其权限概览 | 改角色定义、职责说明、权限摘要 |
| `pages/admin/permissions.js` | `admin-permissions` | 权限配置:按模块展示和编辑权限项 | 改权限点、模块分类、权限编辑交互 |
| `pages/admin/departments.js` | `admin-departments` | 部门管理:技术部、标注部、平台运营等部门信息 | 改部门、编码、成员数和职责 |
| `pages/admin/logs.js` | `admin-logs` | 登录日志:登录时间、IP、设备、地点与结果 | 改日志字段、筛选和分页展示 |
### 4.5 `pages/enterprise`:企业端
| 文件 | 页面 ID / 类型 | 简要内容 | 后续修改入口 |
| --- | --- | --- | --- |
| `pages/enterprise/shared.js` | 企业端共享文件 | 当前主要保留企业端页面分组说明 | 企业侧出现跨页面状态、审批缓存时应在此集中维护 |
| `pages/enterprise/dashboard.js` | `enterprise-dashboard` | 企业端工作台:入项审批、训练中学员、预警、待办和统计 | 改企业首页指标、预警和快捷操作 |
| `pages/enterprise/review.js` | `enterprise-review` | 学员审核台:企业主管查看入项申请并处理 | 改企业终审表单、审批说明和结果页 |
| `pages/enterprise/training-approve.js` | `enterprise-training-approve`,辅助页 | 培训体系审批:企业审核培训体系、提出修改意见 | 当前不在顶层导航;由业务入口进入,改企业对体系的审批流程时使用 |
| `pages/enterprise/records.js` | `enterprise-records` | 入项记录:查看已完成审批的学员与培养记录 | 改记录字段、查询和详情展示 |
| `pages/enterprise/delivery.js` | `enterprise-delivery`,辅助页 | 服务交付/培训交付相关页面 | 当前不在顶层导航;改企业服务交付、交接或交付状态时使用 |
| `pages/enterprise/stats.js` | `enterprise-stats` | 统计报表:培养周期、通过率、导师评审耗时及趋势 | 改企业数据看板、指标口径和导出入口 |
### 4.6 `pages/school`:院校教务端
| 文件 | 页面 ID / 类型 | 简要内容 | 后续修改入口 |
| --- | --- | --- | --- |
| `pages/school/shared.js` | 院校端共享文件 | 当前主要保留院校端页面分组说明 | 院校侧需要共享的体系、账号或教学状态应放在这里 |
| `pages/school/dashboard.js` | `school-dashboard` | 院校教务工作台:活跃学生、待确认体系、完成率、到期提醒、教学概览 | 改院校首页指标、待办、教学告警和快捷操作 |
| `pages/school/systems.js` | `school-systems` | 培训体系管理:筛选体系、AI 生成器、确认接收、修改建议与版本历史 | 改体系协作、反馈、版本、行业模板展示 |
| `pages/school/teaching.js` | `school-teaching` | 教学管理:实训任务分配、进度监控、教学活动 | 改任务分配、班级/课程维度、监控指标 |
| `pages/school/students.js` | `school-students` | 学生档案:能力画像、历次实训记录、学生详情 | 改学生档案字段、能力模型、成绩/记录展示 |
| `pages/school/accounts.js` | `school-accounts` | 账户与认证管理:学校信息、账号概览、快捷操作 | 改学校资料、授权账号、认证状态 |
| `pages/school/business.js` | `school-business` | 商业服务:订阅、服务权益、商务信息 | 改订阅套餐、续费/咨询入口、服务状态 |
## 5. 主要业务流程与涉及文件
### 5.1 学生培养流程
| 步骤 | 学生页面 | 关键状态/规则 | 对应审核方 |
| --- | --- | --- | --- |
| 1. 上传简历 | `student-resume` | 生成能力画像和阶段一建议 | 无 |
| 2. 衔接预习 | `student-bridge-preview` | 知识点阅读状态 | 无 |
| 3. 衔接测验 | `student-bridge-quiz`、`student-bridge-quiz-result` | 70 分通过,解锁后续培养 | 无 |
| 4. 部署预习和小测 | `student-deploy-preview`、`student-deploy-quiz`、`student-deploy-quiz-result` | 80 分通过,解锁 AutoDL 和部署提交 | 无 |
| 5. 模型部署实操 | `student-autodl` | 租赁实例、SSH、连通性、Web IDE | 管理员下发任务 |
| 6. 提交部署成果 | `student-deploy-submit`、`student-deploy-result` | 产物、日志、API 地址、报告与验收状态 | 导师部署验收 |
| 7. 项目实训 | `student-projects`、`student-preview`、`student-quiz`、`student-practice` | 选择项目、预习、小测、产物提交 | 导师实操评审 |
| 8. 报告与答辩 | `student-report`、`student-defense` | 报告通过后才可申请答辩 | 导师报告/答辩评审 |
| 9. 入项 | `student-entry` | 意向申请、导师审核、正式申请、企业终审 | 导师 + 企业主管 |
| 10. 归档 | `student-archive` | 汇总成长记录和能力雷达图 | 无 |
### 5.2 模型部署跨端流程
```mermaid
sequenceDiagram
participant A as 管理员
participant S as 学生
participant M as 导师
A->>S: 发布文本模型/图像生成部署任务
S->>S: 部署预习和 80 分小测
S->>S: 登记 AutoDL、SSH、完成部署
S->>M: 提交日志、产物、API 地址和报告
M->>M: 在独立验收台测试 API、评分、填写结论
M->>S: 同步验收结论和通知
S->>S: 通过后进入后续报告/答辩流程
```
涉及的主要文件:
- 管理员下发:`pages/admin/deploy-task.js`、`pages/admin/shared.js`
- 学生执行:`pages/student/deploy-preview.js`、`deploy-quiz.js`、`autodl.js`、`deploy-submit.js`、`deploy-result.js`、`pages/student/shared.js`
- 导师验收:`pages/mentor/deploy-review.js`、`deploy-acceptance.js`、`pages/mentor/shared.js`
- 独立 API 工具:`Acceptance.html`
### 5.3 体系协作流程
```text
管理员端生成/维护培训体系
↓
企业端审核或提出业务修改意见
↓
院校端查看、确认、反馈修改建议并组织教学
↓
院校端在教学管理和学生档案中跟踪实施效果
```
如果需求涉及“企业和院校的同一培训体系数据真实同步”,当前原型需要新增共享数据模型或后端 API。当前页面中展示的数据大多是各页的演示数据,不能自动形成生产级同步。
## 6. 后续动态需求修改指南
### 6.1 先判断需求属于哪一类
| 需求类型 | 优先修改位置 | 是否需要连带检查 |
| --- | --- | --- |
| 单页文字、颜色、卡片、表格布局 | 对应的页面 JS 文件 | 该页面的按钮、移动端显示和图标 |
| 单页表单字段、校验、提交提示 | 页面 JS + 本端 `shared.js` | 表单状态字段、保存/提交函数、结果页 |
| 学生培养顺序、解锁条件、及格线 | `pages/student/shared.js` + `index.html` 的 `switchPage()` | 首页步骤、目标页面的锁定提示、导师侧待办 |
| 模型部署任务内容 | `pages/admin/deploy-task.js` + `pages/admin/shared.js` | 学生 AutoDL/部署页、导师验收标准 |
| 导师部署验收方式、评分、API 检测 | `pages/mentor/shared.js` + 两个部署验收页面 | 学生部署结果页和通知 |
| 顶部导航中的页面名称、顺序、默认页 | `index.html` 的 `ROLES` | 角色快速登录、页面 ID、脚本引用 |
| 新增独立业务页面 | 新增 `pages/<端>/<页面>.js` + `index.html` 脚本引用 | 是否加入 `ROLES`、跳转入口、共享状态、测试 |
| 跨端审批或真实数据同步 | 各端 `shared.js` 的临时状态设计,或新增后端接口层 | 所有读写该状态的页面 |
### 6.2 新增一个页面的标准步骤
以“新增学生端学习提醒页”为例:
1. 新建 `pages/student/reminders.js`。
2. 在文件中注册唯一页面 ID,例如 `pageRenderers["student-reminders"]`。
3. 需要读取或修改学生状态时,使用 `pages/student/shared.js` 中已有状态和函数;不要重新创建第二份 `studentState`。
4. 在 `index.html` 的学生端脚本块中增加:
```html
<script src="pages/student/reminders.js"></script>
```
5. 若需要在学生端顶部导航或角色页面列表显示,在 `ROLES.student.pages` 中新增:
```js
{ id: 'student-reminders', label: '学习提醒' }
```
6. 从已有页面用 `switchPage('student-reminders')` 添加入口。
7. 检查该页面是否应受阶段门禁控制;若是,更新 `switchPage()` 中相应的受限页面列表。
8. 完成验证清单中的语法、引用、页面显示和跳转检查。
### 6.3 修改时最容易遗漏的点
| 场景 | 必查项 |
| --- | --- |
| 改页面 ID | 页面注册 ID、`ROLES`、所有 `switchPage()`、所有直接调用 `pageRenderers[...]` 的位置 |
| 改学生状态字段 | `studentState` 初始值、读写函数、首页摘要、结果页、通知、导师同步逻辑 |
| 改部署任务字段 | 管理员表单、学生任务展示、学生表单校验、导师验收表、模拟 API 结果 |
| 改审核状态名称 | 学生结果页徽标、导师列表、审批按钮可用状态、通知文案 |
| 改顶部布局 | 学生 `#studentContent` 与非学生 `#otherContent` 的差异;不要只测一个角色 |
| 改 ECharts 雷达图 | `student-archive.js` 的容器 ID 和 `index.html` 的 `initRadarChart()` 配置必须匹配 |
| 增加异步定时器/轮询 | 页面离开时停止定时器,避免重复执行和状态串页 |
### 6.4 适合交给 Agent 的修改提示词模板
```text
请在 D:\codexfile\InternTrainingPlatform\0824studyweb_Prototype_v2.0 中修改原型。
目标:<用一句话说明用户想完成的业务效果>。
涉及端:<学生端/导师端/管理员端/企业端/院校端>。
优先修改文件:<例如 pages/student/report.js>。
关联共享逻辑:<例如 pages/student/shared.js;若不确定先检索确认>。
约束:
1. 先阅读 index.html、目标页面和对应端的 shared.js,只修改与本需求有关的文件。
2. 保持现有 pageRenderers、switchPage、ROLES 和脚本加载顺序兼容。
3. 不删除已有页面、状态字段或其他端功能;发现跨端影响时先列出影响范围。
4. 改完后执行 JS 语法检查、脚本引用检查,并在浏览器验证目标端及关联端的页面显示和关键跳转。
5. 报告修改文件、行为变化、验证结果和残余风险。
```
对于跨端需求,可在“关联共享逻辑”中直接列出涉及文件。例如“管理员变更模型部署任务后,学生和导师页面均显示新字段”至少应检查:
```text
pages/admin/deploy-task.js
pages/admin/shared.js
pages/student/shared.js
pages/student/autodl.js
pages/student/deploy-submit.js
pages/mentor/shared.js
pages/mentor/deploy-review.js
pages/mentor/deploy-acceptance.js
```
## 7. 修改后的验证清单
### 7.1 静态检查
```powershell
# 在 0824studyweb_Prototype_v2.0 目录执行
Get-ChildItem pages -Recurse -Filter *.js | ForEach-Object {
node --check $_.FullName
}
```
还应检查:
- 新增页面 JS 是否被 `index.html` 的 `<script src>` 引用;
- 引用路径是否存在;
- 页面 ID 是否重复;
- `shared.js` 是否排在该端页面文件之前;
- `git diff --check` 是否存在空白符或补丁格式问题。
### 7.2 浏览器检查
启动静态预览:
```powershell
python -m http.server 4173
```
打开 `http://127.0.0.1:4173/index.html`,按本次修改范围检查:
1. 登录页是否正常显示,角色快速体验是否可进入目标端。
2. 目标页面是否不是空白页,且不显示“页面加载中”。
3. 修改页面的主按钮、返回按钮、提交按钮是否仍能跳转。
4. 受影响角色的顶部导航是否仍高亮当前页面。
5. 若改学生流程,检查未解锁时的提示与解锁后的下一步入口。
6. 若改部署流程,检查学生提交页、导师验收页、学生结果页三处是否一致。
7. 检查浏览器控制台,除 Tailwind CDN 的生产环境提示外,不应有页面脚本错误或本地 JS 404。
### 7.3 已完成的拆分基线检查
页面拆分完成后已验证:
- `pages/` 下 61 个 JS 文件均通过语法检查;
- `index.html` 的 61 个本地页面脚本引用均存在,无缺失引用;
- 55 个页面渲染器 ID 无重复;
- 登录页、学生端流程入口、导师端 6 个导航页、管理员端 11 个导航页、企业端和院校端代表页面均能显示;
- 已移除拆分后失效的 `pages.js` 脚本引用;
- 浏览器控制台未发现页面脚本错误。
## 8. 对外介绍时可使用的简版说明
“实习生培训平台原型覆盖学生、导师、管理员、企业和院校五类业务角色,并提供公共登录与个人中心。学生从简历能力画像出发,完成衔接学习、模型部署、项目实训、报告、答辩和入项申请;导师承担过程评审和部署验收;管理员配置项目、任务和权限;企业负责入项终审和培养统计;院校负责培训体系与教学管理。前端已按角色和页面拆为独立 JS 文件,单页改动通常只需要定位对应端目录下的页面文件;跨流程改动则集中在各端的 `shared.js` 和入口文件的导航/门禁逻辑。”
## 9. 当前结构维护原则
1. 页面外观优先在页面文件改,业务状态优先在所属端的 `shared.js` 改。
2. 只有全局导航、角色配置、页面装载和全局布局才改 `index.html`。
3. 一次需求尽量控制在一个端或一个业务链路内,避免无关重构。
4. 对学生部署、导师验收、管理员下发这类跨端链路,先列出影响文件再修改。
5. 每次变更完成后都执行静态检查和浏览器检查;界面异常时先停止扩展修改,定位后再继续。
# 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,请按顺序阅读与修改。
# 01 · 业务流程图(细化版)
> 适用项目:0824studyweb_Prototype_v2.0(实习生培训平台)
> 用途:细化每个业务环节、判断分支与异常处理,供开发/测试落地使用
> 版本:v4.0(2026-08-31 修订:新增子流程 E「答辩环节通用流程」,阶段二 / 阶段三~五 / 进阶项目答辩统一按此执行,详细设计规范见《06_答辩环节设计规范》)
> 阅读建议:先看第 1 节总览,再按子流程 A/B/C/D 逐个细读;答辩为跨阶段通用环节,详见子流程 E;每个子流程附逐环节说明表
---
## 0. 图例与节点编号规则
### 0.1 图例
| 图形 | 含义 |
| ----------- | ----------- |
| `([ ... ])` | 流程起止点 |
| `[ ... ]` | 活动/任务(角色执行) |
| `{ ... }` | 判断分支(菱形) |
| `--> | 条件 |
### 0.2 节点编号规则
- 主流程图:阶段块内节点以 `P1 / P2 / P3 / P6` 为前缀,仅作总览,不直接对应子流程表。
- 子流程 A/B/C/D/E:节点分别以 `A / B / C / D / E` 为前缀,**编号与对应逐环节说明表的行号一一对应**。
- 五个子流程分别为:
- 子流程 A = 阶段一 + 阶段二(衔接学习与模型部署)
- 子流程 B = 阶段三~五(项目实训通用链路)
- 子流程 C = 阶段六(入项申请与进阶闭环)
- 子流程 D = 培训体系协作
- 子流程 E = 答辩环节通用流程
约定:每个菱形判断都必须有“是/否”两个出口,且“否”的出口必须写明处理方式,不允许悬空。
---
## 1. 学生培养主流程(总览)
> 覆盖:登录 → 阶段一(衔接学习)→ 阶段二(模型部署)→ 阶段三~五(项目实训通用链路)→ 阶段六(入项申请与进阶闭环)→ 成长档案
```mermaid
flowchart TD
P0([登录 / 角色选择]) --> P1{选择学生端?}
P1 -->|否| P2[进入对应角色端首页]
P1 -->|是| P3[学生端首页<br/>展示当前阶段 / 下一步任务]
P3 --> P4{是否已上传简历?}
P4 -->|否| P5[上传简历]
P5 --> P6[系统解析生成能力画像<br/>能力标签 / 提升建议]
P6 --> A1
P4 -->|是| A1
subgraph P1_STAGE[阶段一 衔接学习]
A1[衔接知识点预习] --> A2[衔接测验]
A2 --> A3{成绩 >= 70?}
A3 -->|否| A4[错题回看 / 重新学习]
A4 --> A1
end
A3 -->|是| B1
subgraph P2_STAGE[阶段二 模型部署]
B1[管理员将固定部署任务做成项目入库并统一下发] --> B2[AI 基于固定项目生成<br/>预习知识点与小测题库]
B2 --> B3[部署知识点预习]
B3 --> B4[部署小测]
B4 --> B5{成绩 >= 80?}
B5 -->|否| B6[重新学习 / 重测]
B6 --> B3
B5 -->|是| B7[AutoDL 实操<br/>平台沙箱基础开发 / 脚本调试<br/>SSH 连接 AutoDL 真机部署]
B7 --> B8[同步提交部署产物 + 实操报告]
B8 --> B9[导师部署验收]
B9 --> B10{验收通过?}
B10 -->|否| B11[按结论整改]
B11 --> B7
B10 -->|是| B12[阶段二任务答辩]
B12 --> B13{答辩通过?}
B13 -->|否| B14[重新进行阶段二实操]
B14 --> B7
end
B13 -->|是| C1
subgraph P3_STAGE[阶段三~五 项目实训通用链路]
C1[AI 基于阶段一衔接测验卷面缺陷分析<br/>推荐项目] --> C2[学生从推荐项目中选择项目]
C2 --> C3[AI 基于所选项目生成<br/>预习知识点与小测题库]
C3 --> C4[项目知识点预习]
C4 --> C5[项目小测]
C5 --> C6{小测通过?}
C6 -->|否| C7[重新预习 / 重测]
C7 --> C4
C6 -->|是| C8[项目实操<br/>仅平台沙箱]
C8 --> C9[同步提交实操产物 + 实操报告]
C9 --> C10[导师验收]
C10 --> C11{验收通过?}
C11 -->|否| C12[按结论修改产物 / 报告]
C12 --> C8
C11 -->|是| C13[本阶段答辩]
C13 --> C14{答辩通过?}
C14 -->|否| C15[重新进行本阶段实操]
C15 --> C8
end
C14 -->|是| D1
subgraph P6_STAGE[阶段六 入项申请与进阶闭环]
D1[直接申请入项<br/>填写入项信息] --> D2[企业主管查看学生全量历史记录<br/>预习小测卷 / 实操产物 + 报告 / 导师验收结果 / 答辩结果]
D2 --> D3[企业主管入项审核]
D3 --> D4{入项审核通过?}
D4 -->|是| D5[入项成功]
D4 -->|否| D6[AI 基于全量资料缺陷分析<br/>生成进阶推荐项目卡片]
D6 --> D7[企业主管驳回<br/>从 AI 推荐卡片中选择一个或多个项目]
D7 --> D8[学生确认接受推荐项目]
D8 --> D9[推荐项目进入待执行状态]
D9 --> D10[学生从待执行列表中选择一个项目]
D10 --> D11{判断该项目所属阶段}
D11 -->|阶段二| D12[按阶段二流程执行<br/>预习 → 小测 → 沙箱开发 / SSH 真机部署 → 同步提交 → 验收 → 答辩]
D11 -->|阶段三~五| D13[按对应阶段三~五流程执行<br/>预习 → 小测 → 沙箱实操 → 同步提交 → 验收 → 答辩]
D12 --> D14{当前项目是否通过?}
D13 --> D14
D14 -->|否| D15[返回该项目当前阶段继续整改 / 重做]
D15 --> D12
D14 -->|是| D16[该项目标记已完成]
D16 --> D17{待执行列表是否还有未完成项目?}
D17 -->|是| D10
D17 -->|否| D18[全部推荐项目完成]
D18 --> D1
end
D5 --> E1[成长档案归档<br/>能力雷达图 / 历史汇总]
D18 --> E1
E1 --> E2([培养结束 / 后续进阶培养])
```
### 1.1 主流程要点
| 阶段 | 环节 | 判定规则 | 不通过处理 |
| ----- | ------------- | ------ | --------------------------------------------------------- |
| 阶段一 | 衔接测验 | ≥ 70 分 | 错题回看 → 重新学习 → 重测 |
| 阶段二 | 部署小测 | ≥ 80 分 | 重新学习 → 重测 |
| 阶段二 | 导师部署验收 | 验收通过 | 按结论整改 → 重新提交 |
| 阶段二 | 阶段二任务答辩 | 答辩通过 | 重新进行阶段二实操 |
| 阶段三~五 | 项目小测 | 通过 | 重新预习 → 重测 |
| 阶段三~五 | 导师验收(产物 + 报告) | 通过 | 修改产物 / 报告 → 重新提交 |
| 阶段三~五 | 本阶段答辩 | 通过 | 重新进行本阶段实操 |
| 阶段六 | 企业主管入项审核 | 通过 | AI 缺陷分析 → 推荐卡片 → 主管选择 → 学生确认 → 待执行 → 选项目 → 按所属阶段实操 → 再次申请 |
---
## 2. 子流程 A:阶段一 + 阶段二(衔接学习与模型部署)
> 说明:阶段二是全流程中唯一涉及“管理员下发固定任务”的环节;实操在平台沙箱做基础开发与脚本调试,并 SSH 连接 AutoDL 真机完成大模型服务部署;验收通过后增加阶段二任务答辩,答辩环节详细流程见**子流程 E**。
```mermaid
flowchart TD
A0([进入学生端])
subgraph A_STAGE1[阶段一 衔接学习]
A1{已上传简历?}
A1 -->|否| A2[上传简历]
A2 --> A3[系统解析简历<br/>生成能力画像 / 标签 / 建议]
A3 --> A4[衔接知识点预习]
A1 -->|是| A4
A4 --> A5[衔接测验 答题交卷]
A5 --> A6{成绩 >= 70?}
A6 -->|否| A7[展示错题 / 薄弱知识点]
A7 --> A4
end
A6 -->|是| A8[解锁项目实训域<br/>写入阶段一门禁通过]
subgraph A_STAGE2[阶段二 模型部署]
A9[管理员将固定部署任务做成项目入库并统一下发]
A10[AI 基于固定项目生成<br/>预习知识点与小测题库]
A10 --> A11[部署知识点预习]
A11 --> A12[部署小测 答题交卷]
A12 --> A13{成绩 >= 80?}
A13 -->|否| A14[展示错题 / 重新学习]
A14 --> A11
A13 -->|是| A15[解锁 AutoDL 与部署提交<br/>写入部署小测通过]
A15 --> A16[AutoDL 实操<br/>平台沙箱基础开发 / 脚本调试<br/>SSH 连接 AutoDL 真机部署]
A16 --> A17[同步提交部署产物 + 实操报告<br/>日志 / 产物 / API 地址 / 报告]
A17 --> A18[导师查看提交物<br/>API 检测 / 评分 / 填写结论]
A18 --> A19{验收通过?}
A19 -->|否| A20[同步驳回结论与整改意见]
A20 --> A16
A19 -->|是| A21[同步验收通过结论<br/>生成学生端通知]
A21 --> A22[阶段二任务答辩]
A22 --> A23{答辩通过?}
A23 -->|否| A24[重新进行阶段二实操]
A24 --> A16
end
A9 -.-> A10
A23 -->|是| A25([进入阶段三])
```
### 表 A-1:阶段一(衔接学习)
| 编号 | 环节 | 执行者 | 输入 | 处理动作 | 输出/交付物 | 判定规则 | 异常 / 拒绝处理 |
| --- | ------- | -------- | ---- | ----------- | ---------------- | ---------- | ---------- |
| A1 | 检查简历 | 学生端 / 系统 | 学生档案 | 查询是否已上传简历 | — | 无 | 未上传时引导到上传页 |
| A2 | 上传简历 | 学生 | 简历文件 | 上传 | 简历数据 | 无 | 格式校验失败则提示 |
| A3 | 简历解析 | 系统 | 简历 | 解析并生成能力画像 | 能力画像 / 标签 / 提升建议 | 模拟解析 | 解析失败可重传 |
| A4 | 衔接预习 | 学生 | 知识点包 | 阅读并记录阅读状态 | 预习完成状态 | 无 | 可中断续读 |
| A5 | 衔接测验 | 学生 / 系统 | 题库 | 答题、交卷、判分 | 成绩 / 错题集 | 无 | 交卷前可保存 |
| A6 | 成绩判定 | 系统 | 成绩 | 与 70 分比较 | 通过 / 不通过 | 成绩 ≥ 70 通过 | — |
| A7 | 错题回看 | 学生 | 错题集 | 展示错题与薄弱点 | 学习建议 | 无 | — |
| A8 | 解锁项目实训域 | 系统 | 门禁状态 | 写入“阶段一门禁通过” | 解锁后续页面 | 必须 A6 通过 | 未解锁时提示锁定 |
### 表 A-2:阶段二(模型部署)
| 编号 | 环节 | 执行者 | 输入 | 处理动作 | 输出 / 交付物 | 判定规则 | 异常 / 拒绝处理 |
| --- | ----------- | ------- | ------- | ---------------------------------------- | ---------------- | ---------- | ---------------- |
| A9 | 固定任务入库并下发 | 管理员 | 阶段二固定任务 | 做成项目加入项目库并统一下发 | 阶段二项目 / 任务 | 无 | 可在任务下发页保存草稿 |
| A10 | 生成预习知识与题库 | AI / 系统 | 固定项目 | 基于固定项目生成预习知识点与小测题库 | 预习知识包 / 题库 | 无 | 生成失败可重试 |
| A11 | 部署预习 | 学生 | 知识包 | 阅读并记录状态 | 预习完成状态 | 依赖 A8 通过 | 未过阶段一不可进入 |
| A12 | 部署小测 | 学生 / 系统 | 题库 | 答题、判分 | 成绩 / 错题集 | 无 | 交卷前可保存 |
| A13 | 小测判定 | 系统 | 成绩 | 与 80 分比较 | 通过 / 不通过 | 成绩 ≥ 80 通过 | — |
| A14 | 错题重学 | 学生 | 错题集 | 展示错题、重新学习 | 学习建议 | 无 | — |
| A15 | 解锁 AutoDL | 系统 | 门禁状态 | 写入“部署小测通过” | 解锁 AutoDL / 部署提交 | 必须 A13 通过 | 未解锁时提示 |
| A16 | AutoDL 实操 | 学生 | 任务说明 | 平台沙箱做基础开发与脚本调试,SSH 连接 AutoDL 真机完成大模型服务部署 | 部署完成状态 | 无 | 连接 / 部署失败可重试 |
| A17 | 同步提交产物 + 报告 | 学生 | 提交材料 | 同步提交日志、产物、API 地址、实操报告 | 部署作业记录 | 需 A15 通过 | 未过小测回退 AutoDL 引导 |
| A18 | 部署验收 | 导师 | 学生提交物 | 查看 → API 检测 → 评分 → 填写结论 | 验收结论(草稿 / 提交) | 无 | 结论可存草稿 |
| A19 | 验收判定 | 导师 | 验收结论 | 判断是否通过 | 通过 / 驳回 | 导师评分与结论 | — |
| A20 | 驳回整改 | 系统 | 驳回结论 | 同步结论、整改意见、通知 | 学生端通知 | 无 | — |
| A21 | 通过同步 | 系统 | 通过结论 | 同步结论、生成通知 | 验收通过状态 + 通知 | 无 | — |
| A22 | 阶段二任务答辩 | 学生 + 导师 | 部署作业 | 就本阶段任务发起答辩并完成(答辩通用流程见子流程 E) | 答辩结论 | 需 A19 通过 | 验收未通过不可答辩 |
| A23 | 答辩判定 | 导师 | 答辩结论 | 判断是否通过 | 通过 / 驳回 | 导师评审 | — |
| A24 | 驳回重新实操 | 学生 | 驳回结论 | 重新进行阶段二实操 | 新的提交 | 必须 A23 驳回 | 同步驳回通知与反馈 |
---
## 3. 子流程 B:阶段三~五(项目实训通用链路)
> 说明:阶段三(RAG)、阶段四(Agent)、阶段五(小模型微调)重复此链路,实操仅平台沙箱;提交动作是“实操产物 + 实操报告同步提交”,导师统一验收,通过后答辩(答辩通用流程见**子流程 E**),答辩通过进入下一阶段。
```mermaid
flowchart TD
B0([进入项目实训域])
B1[AI 基于衔接测验卷面缺陷分析<br/>生成项目推荐] --> B2[项目推荐大厅<br/>展示推荐项目]
B2 --> B3[查看项目详情]
B3 --> B4{选择项目?}
B4 -->|否| B2
B4 -->|是| B5[AI 基于所选项目生成<br/>预习知识点与小测题库]
B5 --> B6[项目知识点预习<br/>记录阅读状态]
B6 --> B7{已完成预习?}
B7 -->|否| B6
B7 -->|是| B8[项目小测 答题交卷]
B8 --> B9{小测通过?}
B9 -->|否| B10[展示错题 / 重新预习]
B10 --> B6
B9 -->|是| B11[项目实操<br/>仅平台沙箱]
B11 --> B12[同步提交实操产物 + 实操报告]
B12 --> B13[导师验收<br/>查看产物与报告]
B13 --> B14{验收通过?}
B14 -->|否| B15[按结论修改产物 / 报告]
B15 --> B11
B14 -->|是| B16[本阶段答辩]
B16 --> B17{答辩通过?}
B17 -->|否| B18[重新进行本阶段实操]
B18 --> B11
B17 -->|是| B19([进入下一阶段<br/>阶段四 / 阶段五 / 入项申请])
```
> 说明:阶段三 / 四 / 五的项目推荐统一基于**阶段一衔接测验的卷面缺陷分析**;阶段三通过进入阶段四,阶段四通过进入阶段五,阶段五通过进入阶段六入项申请。
### 表 B:阶段三~五(项目实训通用链路)
| 编号 | 环节 | 执行者 | 输入 | 处理动作 | 输出 / 交付物 | 判定规则 | 异常 / 拒绝处理 |
| --- | ----------- | ------- | --------- | ------------------ | ------------- | ---------- | ------------ |
| B1 | AI 生成项目推荐 | AI / 系统 | 阶段一衔接测验卷面 | 卷面缺陷分析并生成推荐 | 推荐项目列表 | 需 A8 门禁通过 | 未解锁提示锁定 |
| B2 | 推荐大厅 | 学生 | 推荐项目 | 展示推荐项目 / 进阶推荐 | — | 无 | — |
| B3 | 查看详情 | 学生 | 项目库 | 查看项目详情 | — | 无 | — |
| B4 | 选择项目 | 学生 | 项目 | 判定是否选择 | 选定项目 | 无 | 可返回重选 |
| B5 | 生成知识点与题库 | AI / 系统 | 所选项目 | 基于所选项目生成预习知识点与小测题库 | 知识包 / 题库 | 无 | 生成失败可重试 |
| B6 | 项目预习 | 学生 | 知识包 | 阅读并记录状态 | 预习完成状态 | 无 | 可中断续读 |
| B7 | 预习完成判断 | 系统 | 阅读状态 | 校验是否完成 | 完成 / 未完成 | 全部阅读完成 | 未完成提示“先完成预习” |
| B8 | 项目小测 | 学生 / 系统 | 题库 | 答题、判分 | 成绩 / 错题 | 无 | 交卷前可保存 |
| B9 | 小测判定 | 系统 | 成绩 | 是否通过 | 通过 / 不通过 | 通过线(原型内可配) | — |
| B10 | 错题重学 | 学生 | 错题集 | 展示错题、重新预习 | 学习建议 | 无 | — |
| B11 | 沙箱实操 | 学生 | 任务说明 | 仅平台沙箱完成项目实操 | 实操产物 | 需 B9 通过 | 可存草稿 |
| B12 | 同步提交产物 + 报告 | 学生 | 实操产物、报告 | 实操产物与实操报告同步提交 | 提交记录 | 需 B9 通过 | 表单校验失败提示 |
| B13 | 导师验收 | 导师 | 产物 + 报告 | 查看产物与报告并给出结论 | 验收结论(草稿 / 提交) | 无 | 结论可存草稿 |
| B14 | 验收判定 | 导师 | 结论 | 是否通过 | 通过 / 驳回 | 导师结论 | — |
| B15 | 修改重交 | 学生 | 驳回结论 | 按结论修改产物 / 报告后重新提交 | 新的提交 | 必须 B14 驳回 | 同步驳回通知 |
| B16 | 本阶段答辩 | 学生 + 导师 | 提交记录 | 就本阶段任务发起答辩并完成(答辩通用流程见子流程 E) | 答辩结论 | 需 B14 通过 | 验收未通过不可答辩 |
| B17 | 答辩判定 | 导师 | 答辩结论 | 是否通过 | 通过 / 驳回 | 导师评审 | — |
| B18 | 驳回重新实操 | 学生 | 驳回结论 | 重新进行本阶段实操 | 新的提交 | 必须 B17 驳回 | 同步驳回通知与反馈 |
---
## 4. 子流程 C:入项申请与进阶闭环(阶段六)
> 说明:完成阶段一~五全部流程后**直接申请入项**(无导师意向审核)。企业主管审核时查看学生**全量历史记录**(各阶段预习小测卷、实操产物 + 报告、导师验收结果、答辩结果);不通过则 AI 做全量缺陷分析并生成进阶推荐项目卡片,企业主管从卡片中选择一个或多个推荐给学生;学生确认接受后,推荐项目进入**待执行状态**,学生再从待执行列表中**逐个选择项目执行**。每个推荐项目都会先判断所属阶段,再按对应阶段流程执行(阶段流程内的答辩环节统一见**子流程 E**);所有推荐项目全部通过后,学生才能再次申请入项。
```mermaid
flowchart TD
C0([完成阶段一~五全部流程])
C1[直接申请入项<br/>填写入项信息] --> C2[提交入项申请]
C2 --> C3[企业主管查看学生全量历史记录<br/>预习小测卷 / 实操产物 + 报告 / 导师验收结果 / 答辩结果]
C3 --> C4[企业主管入项审核]
C4 --> C5{入项审核通过?}
C5 -->|是| C6[入项成功<br/>写入成长档案]
C5 -->|否| C7[AI 基于全量资料缺陷分析<br/>生成进阶推荐项目卡片]
C7 --> C8[企业主管驳回<br/>从 AI 推荐卡片中选择一个或多个项目]
C8 --> C9[学生确认接受推荐项目]
C9 --> C10[推荐项目进入待执行状态]
C10 --> C11[学生从待执行列表中选择一个项目]
C11 --> C12{判断该项目所属阶段}
C12 -->|阶段二| C13[按阶段二流程执行<br/>预习 → 小测 → 沙箱开发 / SSH 真机部署 → 同步提交 → 验收 → 答辩]
C12 -->|阶段三~五| C14[按对应阶段三~五流程执行<br/>预习 → 小测 → 沙箱实操 → 同步提交 → 验收 → 答辩]
C13 --> C15{当前项目是否通过?}
C14 --> C15
C15 -->|否| C16[返回该项目当前阶段继续整改 / 重做]
C16 --> C13
C15 -->|是| C17[该项目标记已完成]
C17 --> C18{待执行列表是否还有未完成项目?}
C18 -->|是| C11
C18 -->|否| C19[全部推荐项目完成]
C19 --> C1
C6 --> C20([入项成功 → 成长档案 / 后续培养])
C19 --> C20
```
### 表 C:阶段六(入项申请与进阶闭环)
| 编号 | 环节 | 执行者 | 输入 | 处理动作 | 输出 / 交付物 | 判定规则 | 异常 / 拒绝处理 |
| --- | ------------- | ------------ | --------- | -------------------------------- | ------------- | ---------- | ----------- |
| C1 | 直接申请入项 | 学生 | 入项信息 | 填写入项信息并申请 | 入项申请 | 需阶段一~五全部完成 | 未完成前置阶段不可申请 |
| C2 | 提交入项申请 | 学生 | 入项信息 | 正式提交 | 待企业审核申请 | 无 | 可保存草稿 |
| C3 | 查看全量记录 | 企业主管 | 学生全量资料 | 查看各阶段预习小测卷、实操产物 + 报告、导师验收结果、答辩结果 | 审核依据 | 无 | — |
| C4 | 入项审核 | 企业主管 | 申请 + 全量记录 | 综合评估是否入项 | 审核结论(草稿 / 提交) | 无 | 结论可存草稿 |
| C5 | 审核判定 | 企业主管 | 结论 | 是否通过 | 通过 / 驳回 | 企业主管结论 | — |
| C6 | 入项成功 | 系统 | 通过结论 | 写入成长档案、通知 | 入项成功状态 | 需 C5 通过 | — |
| C7 | AI 缺陷分析与进阶推荐 | AI / 系统 | 学生全量资料 | 全量缺陷分析并生成进阶推荐项目卡片 | 进阶推荐项目卡片 | 必须 C5 驳回 | 生成失败可重试 |
| C8 | 企业主管驳回并选择推荐 | 企业主管 | 推荐卡片 | 从 AI 推荐卡片中选择一个或多个项目,并驳回申请 | 驳回结论 + 选定推荐项目 | 无 | 同步驳回原因 |
| C9 | 学生确认接受 | 学生 | 选定推荐项目 | 确认接受主管指定的推荐项目 | 确认状态 | 无 | 可查看项目详情 |
| C10 | 推荐项目进入待执行状态 | 系统 | 确认状态 | 将推荐项目标记为待执行 | 待执行项目列表 | 需 C9 通过 | 未确认不可进入待执行 |
| C11 | 从待执行列表选择一个项目 | 学生 | 待执行项目列表 | 每次只选择一个项目开始执行 | 当前执行项目 | 无 | 未选项目不可开始 |
| C12 | 判断项目所属阶段 | 系统 | 项目阶段属性 | 识别该项目应走的实训流程 | 阶段二 / 阶段三~五 | 无 | 项目必须有阶段属性 |
| C13 | 按阶段二流程执行 | 学生 / 导师 / AI | 进阶项目 | 走阶段二完整流程(答辩见子流程 E) | 项目完成记录 | 需项目属于阶段二 | — |
| C14 | 按阶段三~五流程执行 | 学生 / 导师 / AI | 进阶项目 | 走对应阶段三~五完整流程(答辩见子流程 E) | 项目完成记录 | 需项目属于阶段三~五 | — |
| C15 | 当前项目是否通过 | 系统 | 当前项目记录 | 判断当前项目是否通过全部环节 | 通过 / 未通过 | 全流程环节通过 | 未通过则留在当前项目 |
| C16 | 返回当前阶段整改 / 重做 | 学生 | 当前项目结果 | 按阶段内规则整改后继续 | 新的提交 | 必须 C15 未通过 | 环节内按对应子流程处理 |
| C17 | 标记项目已完成 | 系统 | 当前项目结果 | 该项目完成归档 | 完成状态 | 需 C15 通过 | — |
| C18 | 判断待执行列表是否还有项目 | 系统 | 待执行列表 | 检查是否还有未完成项目 | 是 / 否 | 无 | — |
| C19 | 全部推荐项目完成 | 系统 | 完成列表 | 所有推荐项目都完成后,允许再次申请入项 | 可再次申请入项状态 | 需 C18 否 | — |
---
## 5. 子流程 D:培训体系协作流程
> 说明:这是管理员 / 企业 / 院校三方协作流程,涉及“生成-审批-确认-发布-版本迭代”,是跨端数据协作最复杂的一段。本流程未受本次修订影响,保留原状。
```mermaid
flowchart TD
D0([管理员进入体系生成器])
D1[创建 / 编辑培训体系<br/>配置体系内容] --> D2[AI 生成 / 预览]
D2 --> D3{内容确认?}
D3 -->|否| D1
D3 -->|是| D4[发布体系<br/>提交企业审批]
D4 --> D5[企业端培训体系审批]
D5 --> D6{企业审核通过?}
D6 -->|否| D7[企业提出修改意见]
D7 --> D1
D6 -->|是| D8[体系流转到院校端]
D8 --> D9[院校确认接收<br/>可反馈修改建议]
D9 --> D10{院校确认?}
D10 -->|否| D11[院校反馈建议<br/>回到管理员修订]
D11 --> D1
D10 -->|是| D12[体系正式生效<br/>记录版本]
D12 --> D13[院校组织教学<br/>教学任务分配 / 进度监控]
D13 --> D14[跟踪实施效果<br/>学生档案 / 统计反馈]
D14 --> D15{需要新版本迭代?}
D15 -->|否| D16([体系稳定运行])
D15 -->|是| D17[生成新版本]
D17 --> D1
```
### 表 D:培训体系协作流程
| 编号 | 环节 | 执行者 | 输入 | 处理动作 | 输出 / 交付物 | 判定规则 | 异常 / 拒绝处理 |
| --- | --------- | --- | --------- | ------------- | ----------- | -------- | ----------- |
| D1 | 创建 / 编辑体系 | 管理员 | 体系模板 / 内容 | 创建或编辑 | 体系草稿 | 无 | 可存草稿 |
| D2 | 生成 / 预览 | 系统 | 草稿 | AI 生成、预览 | 体系预览 | 无 | 生成失败可重试 |
| D3 | 内容确认 | 管理员 | 预览 | 确认或继续编辑 | 确认状态 | 无 | 未确认回编辑 |
| D4 | 发布提审 | 管理员 | 体系内容 | 发布并提交企业 | 待企业审批状态 | 需 D3 确认 | — |
| D5 | 企业审批 | 企业 | 体系内容 | 查看并审批 | 审批结论 | 无 | 结论可存草稿 |
| D6 | 企业判定 | 企业 | 结论 | 通过或提意见 | 通过 / 需修改 | 企业结论 | 需修改 → 管理员修订 |
| D7 | 提出修改意见 | 企业 | 意见 | 填写修改意见 | 意见记录 | 无 | — |
| D8 | 流转院校 | 系统 | 通过体系 | 推送到院校端 | 待院校确认状态 | 需 D6 通过 | — |
| D9 | 院校确认 | 院校 | 体系 | 确认或反馈建议 | 确认 / 建议 | 无 | — |
| D10 | 院校判定 | 院校 | 确认结果 | 是否确认 | 确认 / 需修订 | 院校结论 | 需修订 → 管理员修订 |
| D11 | 反馈建议 | 院校 | 建议 | 填写修改建议 | 建议记录 | 无 | — |
| D12 | 体系生效 | 系统 | 确认 | 记录版本、生效 | 已发布体系 + 版本号 | 需 D10 确认 | — |
| D13 | 组织教学 | 院校 | 体系 | 教学任务分配 / 进度监控 | 教学任务 | 需 D12 | — |
| D14 | 效果跟踪 | 院校 | 教学数据 | 学生档案 / 统计 | 实施效果数据 | 无 | — |
| D15 | 版本迭代判断 | 三方 | 效果数据 | 判断是否需要迭代 | 是 / 否 | 业务需要 | — |
| D16 | 稳定运行 | — | — | 体系保持生效 | — | 无 | — |
| D17 | 生成新版本 | 管理员 | 旧版本 | 基于旧版本生成新版本 | 新版本草稿 | 无 | 保留版本历史 |
---
## 6. 子流程 E:答辩环节通用流程
> 说明:阶段二任务答辩、阶段三~五本阶段答辩、进阶项目答辩**共用**本子流程。答辩形式(实时在线 / 异步录播 / 文字)、评分维度与权重、录音录屏策略、不通过处理配置等设计规范详见《06_答辩环节设计规范》。本节只描述答辩的业务流程细节。
```mermaid
flowchart TD
E1([发起答辩申请]) --> E2[系统校验前置条件<br/>已通过当前阶段验收 / 满足答辩入口]
E2 --> E3[生成答辩安排<br/>时间 / 评审人 / 答辩主题]
E3 --> E4[学生提交答辩材料<br/>PPT / 讲稿 / 演示说明 / 可选视频]
E4 --> E5[答辩开始<br/>实时连线 / 录播查看 / 文字评审]
E5 --> E6[学生陈述与演示]
E6 --> E7[导师提问与追问]
E7 --> E8[导师评分与结论]
E8 --> E9{答辩通过?}
E9 -->|是| E10[结果回流<br/>成长档案 / 统计 / 后续阶段门禁]
E9 -->|否| E11{不通过原因分类?}
E11 -->|实操本身问题| E12[重新进行本阶段实操<br/>完成后重新申请答辩]
E11 -->|表达 / 材料 / 演示组织问题| E13[仅重新答辩<br/>按配置允许重试]
E13 --> E4
```
### 6.1 子流程 E 的入口与出口
| 场景 | 进入子流程 E 的位置 | 通过后的去向 |
| --- | --- | --- |
| 阶段二任务答辩 | 子流程 A 的 A22(导师部署验收通过后) | 进入阶段三 |
| 阶段三~五本阶段答辩 | 子流程 B 的 B16(导师验收通过后) | 阶段三 → 阶段四;阶段四 → 阶段五;阶段五 → 入项申请 |
| 进阶项目答辩 | 子流程 C 的 C13 / C14(进阶项目验收通过后) | 该项目标记已完成 → 执行待执行列表剩余项目 / 全部完成后再次申请入项 |
### 表 E:答辩环节(通用)
| 编号 | 环节 | 执行者 | 输入 | 处理动作 | 输出 / 交付物 | 判定规则 | 异常 / 拒绝处理 |
| --- | --- | --- | --- | --- | --- | --- | --- |
| E1 | 发起答辩申请 | 学生 | 当前阶段任务 | 在对应阶段入口发起答辩申请 | 答辩申请 | 需已通过当前阶段导师验收 | 验收未通过不可申请(对应 A22 / B16 前置) |
| E2 | 校验前置条件 | 系统 | 答辩申请 | 校验是否满足答辩入口条件 | 校验结果 | 需 E1 通过 | 不满足时提示先完成前置环节 |
| E3 | 生成答辩安排 | 系统 | 答辩申请 | 生成时间 / 评审人 / 答辩主题 | 答辩安排 | 需 E2 通过 | 安排冲突可调整 |
| E4 | 学生提交答辩材料 | 学生 | 答辩材料 | 上传 PPT / 讲稿 / 演示说明 / 可选视频 | 答辩材料 | 需 E3 通过 | 材料可编辑至答辩开始前 |
| E5 | 答辩开始 | 学生 + 导师 | 答辩安排 | 按所选形式开始(实时连线 / 录播查看 / 文字评审) | 答辩过程 | 需 E4 通过 | 未按时开始可重排 |
| E6 | 学生陈述与演示 | 学生 | 产物 / 报告 | 陈述项目目标、方案、结果并现场演示 | 陈述记录 | 无 | — |
| E7 | 导师提问与追问 | 导师 | 陈述记录 | 围绕设计、实现、边界、异常提问 | 问答记录 | 无 | — |
| E8 | 导师评分与结论 | 导师 | 问答记录 | 按评分卡评分并给出结论 | 评分明细 + 结论 | 无 | 结论可存草稿 |
| E9 | 答辩判定 | 系统 | 结论 | 判断是否通过 | 通过 / 不通过 | 导师结论 | — |
| E10 | 结果回流 | 系统 | 通过结论 | 写入成长档案 / 统计 / 后续阶段门禁 | 答辩记录 | 需 E9 通过 | — |
| E11 | 不通过原因分类 | 导师 / 系统 | 不通过结论 | 区分“实操本身问题”与“表达 / 材料 / 演示组织问题” | 原因分类 | 必须 E9 不通过 | — |
| E12 | 重新进行本阶段实操 | 学生 | 原因分类 | 实操本身问题 → 返回对应阶段实操环节重新执行 | 新的实操提交 | 需 E11 分类为实操问题 | 阶段二返回 AutoDL 实操(A16);阶段三~五返回沙箱实操(B11) |
| E13 | 仅重新答辩 | 学生 | 原因分类 | 表达 / 材料问题 → 重新提交材料再次答辩 | 新的答辩 | 需 E11 分类为表达问题 | 重试次数按配置限制 |
---
## 7. 这版流程图里最重要的变化
1. **阶段六不再固定走“阶段三~五全流程”**,而是:
- 先判断推荐项目属于哪个阶段;
- 再按该阶段对应的实训流程执行。
2. **企业主管驳回后不再自动推荐**,而是:
- AI 先出推荐卡片;
- 企业主管自行选择推荐给学生的项目;
- 学生确认后,项目进入“待执行状态”。
3. **学生不是同时开做所有推荐项目**,而是:
- 从待执行列表中**一次选择一个项目**;
- 该项目完成后,再去选下一个;
- 直到推荐项目全部完成,才可再次申请入项。
4. **阶段二与阶段三~五的实操方式仍然区分**:
- 阶段二 = 沙箱基础开发 / 脚本调试 + AutoDL 真机部署;
- 阶段三~五 = 仅平台沙箱实操。
5. **答辩环节统一为通用子流程 E**:
- 阶段二任务答辩、阶段三~五本阶段答辩、进阶项目答辩共用同一流程(申请 → 校验 → 安排 → 提交材料 → 答辩 → 评分 → 通过 / 不通过分类处理);
- 答辩形式、评分维度与权重、录音录屏三档策略、不通过处理配置等细节见《06_答辩环节设计规范》。
# 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 中按"横向泳道"重画,可读性更佳。
# 03 · 状态机(对象生命周期梳理)
> 适用项目:0824studyweb_Prototype_v2.0(实习生培训平台)
> 用途:定义核心业务对象的状态全集、触发事件与迁移规则,供后端建表、前端门禁与测试用例设计
> 阅读建议:先看每个状态机图,再看对应"状态表",重点核对"系统副作用"列(发通知/改门禁/写日志)
---
## 0. 怎么读状态机
- **对象(Entity)**:被管理生命周期的数据,例如"入项申请";
- **状态(State)**:对象所处阶段,图中小圆点是"初始态"、`[*]` 是终态;
- **事件(Event)**:箭头上标注的触发动作;
- **迁移(Transition)**:`状态A --事件--> 状态B`,每个迁移都要写清触发条件。
> 通用约定:下文状态名是建议的**枚举/字典值**,开发落库时可直接使用;所有"驳回"类状态必须伴随 `驳回原因` 字段。
---
## 1. 学生培养阶段状态机(对象:学生培养档案)
> 覆盖 0~6 阶段。注意:阶段内"不通过"不代表离开当前阶段,而是停留在本阶段循环(对应错题回看/整改),因此只画出阶段级迁移。
```mermaid
stateDiagram-v2
[*] --> P0_未开始: 注册/进入学生端
P0_未开始 --> P1_衔接学习: 上传简历
P1_衔接学习 --> P1_衔接学习: 测验<70分<br>错题回看/重学/重测
P1_衔接学习 --> P2_模型部署: 衔接测验>=70分
P2_模型部署 --> P2_模型部署: 部署小测<80分<br>重学重测
P2_模型部署 --> P2_模型部署: 验收驳回<br>按结论整改
P2_模型部署 --> P3_项目实训: 部署验收通过
P3_项目实训 --> P3_项目实训: 小测/实操评审不通过<br>重新预习/修改重交
P3_项目实训 --> P4_报告答辩: 实操评审通过
P4_报告答辩 --> P4_报告答辩: 报告/答辩不通过<br>修改重交/重新申请
P4_报告答辩 --> P5_入项审核: 答辩通过
P5_入项审核 --> P5_入项审核: 意向/终审驳回<br>反馈原因
P5_入项审核 --> P6_完成归档: 企业终审通过
P6_完成归档 --> [*]
```
**状态表:**
| 状态 | 含义 | 触发进入事件 | 离开条件 | 系统副作用 |
| --- | --- | --- | --- | --- |
| P0 未开始 | 已注册但未开始培养 | 注册/进入学生端 | 上传简历 | 展示"上传简历"引导 |
| P1 衔接学习 | 进行简历画像与衔接学习 | 上传简历 | 衔接测验 ≥ 70 | 未通过时锁定项目实训域 |
| P2 模型部署 | 部署预习/小测/实操/验收 | 衔接测验通过 | 部署验收通过 | 小测<80 锁定 AutoDL;验收驳回需整改 |
| P3 项目实训 | 推荐/预习/小测/实操 | 部署验收通过 | 实操评审通过 | 小测/实操不通过时提示先完成前置 |
| P4 报告答辩 | 撰写报告与答辩 | 实操评审通过 | 答辩通过 | 报告未通过不可申请答辩 |
| P5 入项审核 | 意向+正式+终审 | 答辩通过 | 企业终审通过 | 驳回则流程终止(或按产品策略重提) |
| P6 完成归档 | 成长档案生成 | 企业终审通过 | — | 生成雷达图/历史汇总 |
---
## 2. 部署任务状态机(对象:部署任务,管理员侧)
> 管理员在 `admin-deploy-task` 配置任务,核心动作是"草稿→发布";发布后学生侧以最新版本为准,可覆盖。
```mermaid
stateDiagram-v2
[*] --> 草稿: 新建任务
草稿 --> 草稿: 编辑/预览/保存草稿
草稿 --> 已发布: 统一发布
已发布 --> 已发布: 管理员再次发布<br>生成新版本覆盖
已发布 --> 草稿: 管理员下架/编辑
已发布 --> [*]
```
**状态表:**
| 状态 | 含义 | 触发进入事件 | 离开条件 | 系统副作用 |
| --- | --- | --- | --- | --- |
| 草稿 | 任务配置中,未生效 | 新建任务 | 统一发布 | 学生端仍显示默认任务 `DEPLOY_TASK_INFO` |
| 已发布 | 任务已生效 | 统一发布 | 下架/编辑 | 覆盖学生端 AutoDL/部署提交页展示 |
---
## 3. 部署作业状态机(对象:单个学生的部署作业)
> 注意与"部署任务"区分:任务是管理员全局下发;作业是**每个学生各自的提交-验收链路**。
```mermaid
stateDiagram-v2
[*] --> 待学习: 任务发布
待学习 --> 学习中: 学生开始部署预习/实操
学习中 --> 已提交: 学生提交日志/产物/API/报告
已提交 --> 验收中: 导师开始验收
验收中 --> 已通过: 导师提交通过结论
验收中 --> 已驳回: 导师提交驳回结论
已驳回 --> 已提交: 学生整改后重新提交
已通过 --> [*]
```
**状态表:**
| 状态 | 含义 | 触发进入事件 | 离开条件 | 系统副作用 |
| --- | --- | --- | --- | --- |
| 待学习 | 未开始 | 任务发布 | 开始学习 | — |
| 学习中 | 已解锁 AutoDL | 部署小测通过 | 提交产物 | 未提交前可反复实操 |
| 已提交 | 已提交产物 | 学生提交 | 导师开始验收 | 生成导师端待办 |
| 验收中 | 导师验收中 | 导师受理 | 提交结论 | 结论可存草稿(仍为验收中) |
| 已通过 | 验收通过 | 导师通过结论 | — | 生成学生端通知,解锁报告环节 |
| 已驳回 | 验收不通过 | 导师驳回结论 | 重新提交 | 生成学生端通知+整改意见 |
---
## 4. 实操/报告评审状态机(对象:实操交付物 / 实操报告)
> 项目实操产物与实操报告共用同一评审状态机(文档 5.1 中实操与报告均由导师评审)。
```mermaid
stateDiagram-v2
[*] --> 草稿: 学生开始撰写
草稿 --> 已提交: 学生正式提交
已提交 --> 评审中: 导师开始评审
评审中 --> 已通过: 导师提交通过结论
评审中 --> 已驳回: 导师提交驳回结论
已驳回 --> 已提交: 学生修改后重新提交
已通过 --> [*]
```
**状态表:**
| 状态 | 含义 | 触发进入事件 | 离开条件 | 系统副作用 |
| --- | --- | --- | --- | --- |
| 草稿 | 学生编辑中 | 开始撰写 | 正式提交 | 可保存多次草稿 |
| 已提交 | 等待导师评审 | 学生提交 | 导师受理 | 生成导师端待办 |
| 评审中 | 导师评审中 | 导师受理 | 提交结论 | 结论可存草稿 |
| 已通过 | 评审通过 | 导师通过 | — | 实操通过→解锁报告;报告通过→解锁答辩 |
| 已驳回 | 评审不通过 | 导师驳回 | 重新提交 | 通知学生+修改意见 |
---
## 5. 答辩申请状态机(对象:答辩申请)
```mermaid
stateDiagram-v2
[*] --> 未申请: 报告评审未通过前
未申请 --> 已申请: 学生提交答辩申请
已申请 --> 已安排: 导师安排答辩
已安排 --> 评审中: 答辩开始评审
评审中 --> 已通过: 答辩通过
评审中 --> 未通过: 答辩不通过
未通过 --> 已申请: 学生重新申请
已通过 --> [*]
```
**状态表:**
| 状态 | 含义 | 触发进入事件 | 离开条件 | 系统副作用 |
| --- | --- | --- | --- | --- |
| 未申请 | 初始态 | 报告未通过 | 提交申请 | 报告未通过时入口锁定 |
| 已申请 | 等待安排 | 学生提交 | 导师安排 | 生成导师端待办 |
| 已安排 | 已排期 | 导师安排 | 开始评审 | 展示答辩时间/安排 |
| 评审中 | 评审进行 | 开始评审 | 提交结论 | — |
| 已通过 | 答辩通过 | 导师通过 | — | 解锁入项申请 |
| 未通过 | 答辩不通过 | 导师驳回 | 重新申请 | 通知学生+反馈 |
---
## 6. 入项申请状态机(对象:入项申请)
> 本项目最复杂的审批对象,分"意向审核"与"正式终审"两段,两段状态需分开存储。
```mermaid
stateDiagram-v2
[*] --> 意向已提交: 学生提交入项意向
意向已提交 --> 导师审核中: 导师受理意向
导师审核中 --> 意向已通过: 导师通过
导师审核中 --> 意向已驳回: 导师驳回
意向已驳回 --> 已终止: 反馈原因
意向已通过 --> 正式已提交: 学生提交正式申请
正式已提交 --> 企业终审中: 企业主管受理
企业终审中 --> 已入项: 企业主管通过
企业终审中 --> 已驳回: 企业主管驳回
已驳回 --> 已终止: 反馈原因
已入项 --> [*]
已终止 --> [*]
```
**状态表:**
| 状态 | 含义 | 触发进入事件 | 离开条件 | 系统副作用 |
| --- | --- | --- | --- | --- |
| 意向已提交 | 学生已提交意向 | 学生提交 | 导师受理 | 生成导师端待办 |
| 导师审核中 | 导师审核意向 | 导师受理 | 提交结论 | 结论可存草稿 |
| 意向已通过 | 意向通过 | 导师通过 | 提交正式申请 | 解锁正式申请入口 |
| 意向已驳回 | 意向驳回 | 导师驳回 | 已终止 | 通知学生+驳回原因 |
| 正式已提交 | 学生已提交正式申请 | 学生提交 | 企业受理 | 生成企业端待办 |
| 企业终审中 | 企业主管终审 | 企业受理 | 提交结论 | 结论可存草稿 |
| 已入项 | 入项成功 | 企业通过 | — | 写入成长档案+通知 |
| 已驳回 | 终审驳回 | 企业驳回 | 已终止 | 通知学生+驳回原因 |
| 已终止 | 流程结束 | 任一驳回 | — | 记录终止原因 |
---
## 7. 培训体系状态机(对象:培训体系)
> 覆盖"管理员生成 → 企业审批 → 院校确认 → 生效 → 版本迭代"全链路。
```mermaid
stateDiagram-v2
[*] --> 草稿: 管理员创建
草稿 --> 草稿: 编辑/预览/AI生成
草稿 --> 待企业审批: 发布提审
待企业审批 --> 企业需修改: 企业提出修改意见
企业需修改 --> 草稿: 管理员修订
待企业审批 --> 企业已通过: 企业审批通过
企业已通过 --> 待院校确认: 流转院校
待院校确认 --> 院校需修改: 院校反馈建议
院校需修改 --> 草稿: 管理员修订
待院校确认 --> 已生效: 院校确认接收
已生效 --> 草稿: 版本迭代生成新版本
已生效 --> [*]
```
**状态表:**
| 状态 | 含义 | 触发进入事件 | 离开条件 | 系统副作用 |
| --- | --- | --- | --- | --- |
| 草稿 | 配置中 | 管理员创建 | 发布提审 | 记录版本历史起点 |
| 待企业审批 | 已提审 | 发布提审 | 企业结论 | 生成企业端待办 |
| 企业需修改 | 企业有意见 | 企业驳回 | 管理员修订 | 记录意见内容 |
| 企业已通过 | 企业通过 | 企业通过 | 流转院校 | — |
| 待院校确认 | 等待院校 | 流转院校 | 院校结论 | 生成院校端待办 |
| 院校需修改 | 院校有建议 | 院校反馈 | 管理员修订 | 记录建议内容 |
| 已生效 | 正式生效 | 院校确认 | 版本迭代 | 写入版本号,供教学使用 |
---
## 8. 项目状态机(对象:项目,简化)
> 项目由管理员维护,作为学生实训的载体。
```mermaid
stateDiagram-v2
[*] --> 草稿: 管理员新增项目
草稿 --> 已发布: 管理员上架
已发布 --> 实训中: 学生绑定实训
实训中 --> 已归档: 管理员归档
已归档 --> 已发布: 重新上架
实训中 --> [*]
```
**状态表:**
| 状态 | 含义 | 触发进入事件 | 离开条件 | 系统副作用 |
| --- | --- | --- | --- | --- |
| 草稿 | 编辑中 | 新增项目 | 上架 | 学生端不可见 |
| 已发布 | 可被推荐 | 上架 | 学生绑定 | 进入推荐大厅 |
| 实训中 | 有学生实训 | 绑定 | 归档 | 计入实施数据 |
| 已归档 | 停用 | 归档 | 重新上架 | 学生端不可见 |
---
## 9. 状态机落地建议
1. **字段建议**:每个对象增加 `status` 字段,取值与上文状态名一致;驳回类状态必须有 `reject_reason`、`reviewed_by`、`reviewed_at`。
2. **时间戳**:`created_at` / `updated_at` / `submitted_at` / `reviewed_at` 按迁移事件分别落库,便于统计评审耗时(企业端统计报表需要)。
3. **校验规则**:非法迁移(如"草稿直接到已通过")必须被后端拦截,前端按钮与后端接口双重校验。
4. **与原型的对应**:原型 `studentState`、`mentorState`、`adminDeployTask` 中的布尔/枚举字段,建议按上文状态迁移统一重构,避免多个布尔字段叠加造成状态爆炸。
# 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 + 数据库事务,建议按本套文档的状态机设计建表,按泳道图拆接口。
# 05 · 页面交互梳理表
> 适用项目:0824studyweb_Prototype_v2.0(实习生培训平台)
> 用途:穷举页面跳转关系、触发操作、门禁条件与异常处理,前端据此实现路由与门禁
> 阅读建议:按端查看,与原型逐页对照;门禁列是测试重点
**表字段说明:**
| 字段 | 含义 |
| --- | --- |
| 来源页面 | 触发操作所在的页面(原型页面 ID) |
| 触发操作 | 按钮/入口动作 |
| 目标页面 | 跳转目标(原型页面 ID) |
| 前置条件/门禁 | 跳转前必须满足的条件(取自 `switchPage()` 与页面内校验) |
| 数据/参数 | 跳转需携带或传递的数据 |
| 异常/拒绝处理 | 条件不满足时的行为 |
| 备注 | 补充说明 |
> 页面 ID 与原型一致,如 `student-bridge-quiz`;"返回"类跳转通常回到上一级页面,不再重复列出。
---
## 1. 学生端
| 来源页面 | 触发操作 | 目标页面 | 前置条件/门禁 | 数据/参数 | 异常/拒绝处理 | 备注 |
| --- | --- | --- | --- | --- | --- | --- |
| 登录页 `login` | 学生角色登录 | `student-dashboard` | 账号校验通过 | 角色身份 | 校验失败提示 | 登录页有角色快速体验入口 |
| `student-dashboard` | 进入"上传简历" | `student-resume` | 无 | — | — | 未上传简历时首页展示引导 |
| `student-resume` | 简历解析完成 | `student-bridge-preview` | 简历已上传 | 能力画像 | 未上传提示先上传 | — |
| `student-bridge-preview` | 完成预习 | `student-bridge-quiz` | 预习阅读状态完成 | 预习状态 | 未完成提示"先完成预习" | — |
| `student-bridge-quiz` | 交卷 | `student-bridge-quiz-result` | 已答题 | 成绩/错题 | 交卷前可保存 | — |
| `student-bridge-quiz-result` | 成绩 ≥70 进入阶段二 | `student-deploy-preview` | 成绩≥70 | 门禁通过状态 | <70 展示错题回看,回到预习 | 门禁写入 `isBridgePassed()` |
| `student-deploy-preview` | 完成预习 | `student-deploy-quiz` | 阶段一门禁通过 | 预习状态 | 未完成提示 | — |
| `student-deploy-quiz` | 交卷 | `student-deploy-quiz-result` | 已答题 | 成绩/错题 | 交卷前可保存 | — |
| `student-deploy-quiz-result` | 成绩 ≥80 进入 AutoDL | `student-autodl` | 成绩≥80 且阶段一通过 | 门禁通过状态 | <80 展示错题回看 | 门禁写入 `deployQuizPassed` |
| `student-autodl` | 完成实操进入提交 | `student-deploy-submit` | 部署小测通过 | 部署产物数据 | 未过小测回退 AutoDL 引导 | — |
| `student-deploy-submit` | 提交 | `student-deploy-result` | 产物/报告已填写 | 提交记录 | 校验失败提示 | 可保存草稿 |
| `student-deploy-result` | 查看验收结果 | 保持本页 | 已提交 | 验收结论 | 未验收展示"待验收" | 导师验收后同步刷新 |
| `student-dashboard` | 进入项目推荐 | `student-projects` | 衔接测验通过 | — | 未解锁回首页展示锁定提示 | 门禁在 `switchPage()` |
| `student-projects` | 选择项目 | `student-preview` | 阶段一门禁通过 | 项目 ID | 未过门禁提示锁定 | 支持进阶推荐项目 |
| `student-preview` | 完成预习 | `student-quiz` | 已完成预习 | 项目上下文 | 未完成提示 | — |
| `student-quiz` | 交卷 | `student-quiz-result` | 已答题 | 成绩/错题 | 交卷前可保存 | — |
| `student-quiz-result` | 通过进入实操 | `student-practice` | 小测通过 | 门禁状态 | 未通过重新预习/重测 | — |
| `student-practice` | 提交实操产物 | 保持本页 | 产物已填 | 提交记录 | 可存草稿 | 待导师评审 |
| `student-practice` | 进入报告 | `student-report` | 实操评审通过 | 评审结论 | 未通过提示修改重交 | — |
| `student-report` | 提交报告 | 保持本页 | 报告字段完整 | 报告记录 | 可存草稿 | 报告前校验部署验收是否通过 |
| `student-report` | 进入答辩 | `student-defense` | 报告评审通过 | 评审结论 | 未通过提示修改重交 | — |
| `student-defense` | 提交答辩申请 | 保持本页 | 材料完整 | 答辩申请 | 可重新申请 | 报告未通过不可申请 |
| `student-defense` | 答辩通过进入入项 | `student-entry` | 答辩通过 | 答辩结论 | 未通过重新申请 | — |
| `student-entry` | 提交入项意向 | 保持本页 | 答辩通过 | 意向申请 | 提示先完成答辩 | — |
| `student-entry` | 意向通过后提交正式申请 | 保持本页 | 意向已通过 | 正式申请 | 未通过提示 | — |
| `student-entry` | 终审通过进入档案 | `student-archive` | 企业终审通过 | 档案数据 | 未通过展示驳回原因 | — |
| 推进逻辑 | 进阶匹配 | `student-advance` | 阶段推进触发 | 能力画像 | 仅由阶段逻辑进入 | 非顶层导航项 |
| 各阶段页面 | 查看成长档案 | `student-archive` | 无 | — | — | 雷达图由 `initRadarChart()` 初始化 |
---
## 2. 导师端
| 来源页面 | 触发操作 | 目标页面 | 前置条件/门禁 | 数据/参数 | 异常/拒绝处理 | 备注 |
| --- | --- | --- | --- | --- | --- | --- |
| `mentor-dashboard` | 查看学员 | `mentor-students` | 无 | — | — | — |
| `mentor-students` | 查看学员详情 | 弹层/详情 | 选择学员 | 学员 ID | 无 | — |
| `mentor-dashboard` | 进入部署验收 | `mentor-deploy-review` | 有部署提交待验收 | — | 空列表提示 | — |
| `mentor-deploy-review` | 选择学员验收 | `mentor-deploy-acceptance` | 所选学员已提交 | 学员 ID | 未提交提示 | 验收台为辅助页 |
| `mentor-deploy-acceptance` | 提交验收结论 | 返回/同步 | 已评分 | 结论+评分 | 结论可存草稿 | 同步学生结果页与通知 |
| `mentor-dashboard` | 实操评审 | `mentor-practice-review` | 有实操提交 | — | 空列表提示 | — |
| `mentor-practice-review` | 提交评审结论 | 保持本页/同步 | 已填写结论 | 结论+意见 | 可存草稿 | 同步学生端 |
| `mentor-dashboard` | 答辩评审 | `mentor-defense-review` | 有答辩申请 | — | 空列表提示 | — |
| `mentor-defense-review` | 提交答辩结论 | 保持本页/同步 | 已填写结论 | 结论 | 可存草稿 | — |
| `mentor-dashboard` | 入项审核 | `mentor-entry-review` | 有入项意向 | — | 空列表提示 | — |
| `mentor-entry-review` | 提交意向审核 | 保持本页/同步 | 已填写结论 | 结论+原因 | 可存草稿 | 通过后解锁正式申请 |
---
## 3. 管理员端
| 来源页面 | 触发操作 | 目标页面 | 前置条件/门禁 | 数据/参数 | 异常/拒绝处理 | 备注 |
| --- | --- | --- | --- | --- | --- | --- |
| `admin-dashboard` | 快捷入口 | 各管理页 | 无 | — | — | — |
| `admin-dashboard` | 进入项目管理 | `admin-projects` | 无 | — | — | — |
| `admin-projects` | 新增/编辑项目 | 弹层/编辑 | 无 | 项目数据 | 表单校验失败提示 | — |
| `admin-projects` | 难度校准 | `admin-difficulty` | 无 | 项目数据 | — | — |
| `admin-dashboard` | 任务下发 | `admin-deploy-task` | 无 | — | — | 配置入口 |
| `admin-deploy-task` | 保存草稿 | 保持本页 | 字段完整 | 草稿数据 | 校验失败提示 | — |
| `admin-deploy-task` | 统一发布 | 保持本页 | 字段完整 | 任务数据 | 校验失败提示 | 发布后覆盖学生端任务 |
| `admin-dashboard` | 体系生成器 | `admin-system-generator` | 无 | — | — | — |
| `admin-system-generator` | 生成/预览/发布 | 保持本页 | 内容确认 | 体系数据 | 未确认不可发布 | 发布后流转企业审批 |
| `admin-dashboard` | 用户/角色/权限/部门/日志/监控 | `admin-users` 等 | 无 | — | — | — |
| 各管理页 | 系统监控 | `admin-monitoring` | 无 | — | — | 审计/访问记录 |
| 各管理页 | AI 配置 | `admin-ai-config` | 无 | — | — | 辅助页,未入顶层导航 |
---
## 4. 企业端
| 来源页面 | 触发操作 | 目标页面 | 前置条件/门禁 | 数据/参数 | 异常/拒绝处理 | 备注 |
| --- | --- | --- | --- | --- | --- | --- |
| `enterprise-dashboard` | 入项审批 | `enterprise-review` | 有待审批申请 | — | 空列表提示 | — |
| `enterprise-review` | 提交终审结论 | 保持本页/同步 | 已填写结论 | 结论+原因 | 可存草稿 | 通过后写入学生成长档案 |
| `enterprise-dashboard` | 入项记录 | `enterprise-records` | 无 | — | — | 已完成审批的记录 |
| `enterprise-dashboard` | 统计报表 | `enterprise-stats` | 无 | — | — | 培养周期/通过率/评审耗时 |
| 业务入口 | 培训体系审批 | `enterprise-training-approve` | 有体系提审 | 体系数据 | 可提修改意见 | 辅助页,非顶层导航 |
| 业务入口 | 服务交付 | `enterprise-delivery` | 无 | — | — | 辅助页 |
---
## 5. 院校教务端
| 来源页面 | 触发操作 | 目标页面 | 前置条件/门禁 | 数据/参数 | 异常/拒绝处理 | 备注 |
| --- | --- | --- | --- | --- | --- | --- |
| `school-dashboard` | 体系管理 | `school-systems` | 无 | — | — | — |
| `school-systems` | 确认接收体系 | 保持本页 | 有待确认体系 | 体系 ID | 可反馈修改建议 | 确认后体系生效 |
| `school-dashboard` | 教学管理 | `school-teaching` | 无 | — | — | 任务分配/进度监控 |
| `school-dashboard` | 学生档案 | `school-students` | 无 | — | — | 能力画像/实训记录 |
| `school-dashboard` | 账户认证 | `school-accounts` | 无 | — | — | — |
| `school-dashboard` | 商业服务 | `school-business` | 无 | — | — | 订阅/权益 |
---
## 6. 公共端
| 来源页面 | 触发操作 | 目标页面 | 前置条件/门禁 | 数据/参数 | 异常/拒绝处理 | 备注 |
| --- | --- | --- | --- | --- | --- | --- |
| `login` | 角色登录 | 对应端首页 | 账号校验 | 角色身份 | 校验失败提示 | — |
| `login` | 去注册 | `register` | 无 | — | — | — |
| `register` | 提交注册 | `login` | 字段校验 | 账户信息 | 校验失败提示 | 注册后跳回登录 |
| 各端 | 个人中心 | `profile` | 已登录 | 用户信息 | 未登录拦截 | 全角色共用 |
---
## 7. 使用与维护建议
1. **以本表为门禁开发依据**:`switchPage()` 的拦截逻辑、页面内的二次校验都应能从本表逐行推导。
2. **与原型同步维护**:每次调整页面或新增页面(见原型文档 6.2 节标准步骤),同步更新本表对应行。
3. **测试对照**:每条记录的"前置条件/门禁"+"异常/拒绝处理"即一条测试用例;建议按端组织成测试清单。
# 06 · 答辩环节设计规范
> 适用项目:0824studyweb_Prototype_v2.0(实习生培训平台)
> 适用范围:阶段二任务答辩、阶段三~五本阶段答辩、进阶项目答辩、入项前答辩相关扩展场景
> 文档目标:统一答辩的形式、内容、评分标准、录音录屏策略、结果回流与合规要求,支持内部使用与未来 SaaS 化交付
---
## 1. 答辩在平台中的定位
答辩不是单纯的“再考一次”,而是培养闭环中的**能力验证与争议兜底环节**。它的核心作用有三点:
1. **验证真实性**:确认学生是否真的理解并掌握了产物和方案,而不是只完成了表面交付;
2. **验证完整性**:确认学生是否能够把“预习、小测、实操、提交、验收”串成完整闭环;
3. **验证表达与迁移能力**:确认学生是否能够讲清楚“为什么这么做、遇到什么问题、如何解决、还有哪些边界”。
对当前项目而言,答辩承担的是“**最终确认**”的角色;对未来 SaaS 产品而言,答辩还承担“**可配置的评审能力模块**”角色。
---
## 2. 答辩适用的业务场景
| 场景 | 说明 | 答辩目标 |
| --- | --- | --- |
| 阶段二任务答辩 | 学生完成模型部署相关实操后,对阶段二任务进行答辩 | 验证学生是否真正掌握部署思路、脚本调试、真机部署与问题排查 |
| 阶段三~五本阶段答辩 | 学生完成当前阶段的项目实训后进行答辩 | 验证学生是否真正理解本阶段项目、产物与方法论 |
| 进阶项目答辩 | 入项驳回后,根据企业主管选定的进阶项目重新实操并答辩 | 验证学生是否补齐了缺陷并达到重新入项的能力要求 |
| 入项前答辩扩展场景 | 若未来客户要求在入项前增加额外答辩,平台可配置开启 | 验证学生是否具备最终入项条件 |
> 说明:当前默认流程中,答辩主要发生在阶段二与阶段三~五,进阶项目沿用同一答辩框架。
---
## 3. 答辩形式设计
### 3.1 默认推荐形式
**实时在线答辩为主。**
答辩形式建议包含:
- 视频连线
- 语音交流
- 屏幕共享
- 在线演示
- 导师实时提问
该形式最适合内部使用,也最适合后续作为 SaaS 的标准能力。
### 3.2 可配置形式
为了适配不同企业客户,答辩形式应支持三种模式:
| 模式 | 说明 | 适用场景 | 优点 | 代价 |
| --- | --- | --- | --- | --- |
| 实时在线答辩 | 学生与导师实时连线,边讲边演示,导师即时提问 | 内部正式场景、标准 SaaS 场景 | 交互强、真实性高、便于追问 | 占用导师时间 |
| 异步录播答辩 | 学生先录制讲解视频并上传,导师异步查看后评分 | 导师少、学生多、异地协作 | 时间灵活、降低调度成本 | 交互弱、容易背稿 |
| 文字答辩 | 学生提交文字讲解稿和问答记录,导师根据文字评分 | 低成本兜底、轻量场景 | 成本最低、部署简单 | 考察维度最少 |
### 3.3 推荐策略
- **内部公司使用**:默认“实时在线答辩”
- **SaaS 产品交付**:答辩形式做成租户级配置项,允许客户按阶段分别选择
- **默认优先级**:实时在线答辩 > 异步录播答辩 > 文字答辩
---
## 4. 答辩流程设计
### 4.1 标准流程
```mermaid
flowchart TD
D1([发起答辩申请]) --> D2[系统校验前置条件<br>已通过当前阶段验收 / 满足答辩入口]
D2 --> D3[生成答辩安排<br>时间 / 评审人 / 答辩主题]
D3 --> D4[学生提交答辩材料<br>PPT / 讲稿 / 演示说明 / 可选视频]
D4 --> D5[答辩开始<br>实时连线 / 录播查看 / 文字评审]
D5 --> D6[学生陈述与演示]
D6 --> D7[导师提问与追问]
D7 --> D8[导师评分与结论]
D8 --> D9{答辩通过?}
D9 -->|是| D10[结果回流<br>成长档案 / 统计 / 后续阶段门禁]
D9 -->|否| D11{不通过原因分类?}
D11 -->|实操本身问题| D12[重新进行本阶段实操<br>完成后重新申请答辩]
D11 -->|表达 / 材料 / 演示组织问题| D13[仅重新答辩<br>按配置允许重试]
D13 --> D4
```
**节点编号说明表:**
| 节点 | 含义 |
| --- | --- |
| D1 | 发起答辩申请 |
| D2 | 系统校验前置条件(已通过当前阶段验收 / 满足答辩入口) |
| D3 | 生成答辩安排(时间 / 评审人 / 答辩主题) |
| D4 | 学生提交答辩材料(PPT / 讲稿 / 演示说明 / 可选视频) |
| D5 | 答辩开始(实时连线 / 录播查看 / 文字评审) |
| D6 | 学生陈述与演示 |
| D7 | 导师提问与追问 |
| D8 | 导师评分与结论 |
| D9 | 判断答辩是否通过 |
| D10 | 答辩通过后结果回流(成长档案 / 统计 / 后续阶段门禁) |
| D11 | 不通过原因分类:区分“实操本身问题”与“表达 / 材料 / 演示组织问题” |
| D12 | 属于实操本身问题 → 重新进行本阶段实操,完成后重新申请答辩 |
| D13 | 仅表达 / 材料问题 → 按配置允许仅重新答辩,重新提交材料后再次答辩 |
### 4.2 标准节奏建议
| 环节 | 内容 | 建议时长 |
| --- | --- | --- |
| 开场陈述 | 学生说明项目背景、目标和阶段成果 | 2~5 分钟 |
| 成果讲解 | 讲技术方案、实现路径、关键结果 | 5~10 分钟 |
| 现场演示 | 打开沙箱 / 真机环境进行演示 | 3~8 分钟 |
| 导师提问 | 深挖设计、实现、边界、异常处理 | 5~15 分钟 |
| 收尾总结 | 学生总结不足与下一步计划 | 1~3 分钟 |
> 说明:不同阶段时长可配置。阶段二一般更偏重部署链路与排障能力,阶段三~五更偏重项目理解、方案表达和迁移能力。
---
## 5. 答辩内容设计
答辩内容建议分为五个固定部分,便于统一培训、统一评分和后续 AI 分析。
### 5.1 必答内容
| 模块 | 核心问题 | 作用 |
| --- | --- | --- |
| 项目目标 | 你做的是什么?要解决什么问题? | 检查目标理解 |
| 技术方案 | 你为什么这么设计?方案有哪些关键点? | 检查方案逻辑 |
| 实操过程 | 你具体怎么做的?遇到什么问题? | 检查真实参与度 |
| 结果与验证 | 最终结果如何?如何证明有效? | 检查产出真实性 |
| 复盘与迁移 | 如果换一个场景,你会怎么调整? | 检查迁移能力 |
### 5.2 阶段二答辩重点
阶段二是“模型部署”类答辩,重点要看:
- 平台沙箱中的基础开发和脚本调试过程;
- SSH 连接 AutoDL 真机的过程;
- 模型/服务部署是否成功;
- 连通性、日志、API 可用性;
- 报错定位与修复思路。
### 5.3 阶段三~五答辩重点
阶段三~五答辩更偏向“项目实训”类,重点要看:
- 是否真的理解所选项目;
- 预习知识点和小测与项目目标是否一致;
- 沙箱实操过程是否完整;
- 实操产物与实操报告是否一致;
- 是否能说明自己的方法选择与局限。
### 5.4 进阶项目答辩重点
进阶项目是企业主管驳回后的补强路径,因此答辩重点应额外关注:
- 是否针对上一次缺陷做了改进;
- 是否真正补齐短板;
- 新项目与缺陷分析是否匹配;
- 是否具备再次进入入项审核的条件。
---
## 6. 答辩评分标准
### 6.1 评分方式
建议采用**多维度评分卡**,而不是只给一个总分。原因是:
- 导师更容易打分;
- 学生更容易理解自己的不足;
- 后续 AI 更容易做能力分析;
- 入项审核时可直接读取答辩质量。
### 6.2 推荐评分维度
| 维度 | 说明 | 权重建议 |
| --- | --- | --- |
| 技术正确性 | 产物是否正确、流程是否跑通、结果是否有效 | 30% |
| 方案逻辑性 | 设计思路是否清晰、是否能自洽 | 25% |
| 深度理解 | 是否能回答“为什么这样做” | 25% |
| 表达沟通 | 讲解是否清楚、有条理、能被理解 | 15% |
| 准备完整度 | 材料是否齐全、演示是否顺畅、是否按时 | 5% |
### 6.3 评分结果建议
评分结果建议分为:
- **通过**
- **不通过**
如果希望更细,可以在内部评分卡上扩展为:
- 优秀
- 通过
- 待改进
- 不通过
但对流程控制而言,最终建议仍然收敛成“通过 / 不通过”。
### 6.4 评分结论示例
| 评分项 | 分数 | 备注 |
| --- | --- | --- |
| 技术正确性 | 4/5 | 部署过程完整,API 可用 |
| 方案逻辑性 | 3/5 | 方案说明基本清晰,但缺少边界说明 |
| 深度理解 | 3/5 | 能回答主要问题,但追问时略卡顿 |
| 表达沟通 | 4/5 | 讲解结构清楚 |
| 准备完整度 | 5/5 | 材料齐全 |
---
## 7. 答辩不通过后的处理策略
答辩不通过后的处理策略建议做成**可配置项**,不能写死。
### 7.1 推荐配置
| 配置项 | 含义 | 推荐默认值 |
| --- | --- | --- |
| 不通过后处理方式 | 不通过后是重新实操还是重新答辩 | 重新进行本阶段实操 |
| 允许仅重新答辩 | 若问题主要是表达或材料问题,是否允许只重新答辩 | 可配置开启 |
| 最大重复次数 | 某阶段答辩最多允许重试几次 | 可配置 |
### 7.2 推荐规则
- 若问题出在**实操本身**,建议回到本阶段实操重新做;
- 若问题只是**表达、材料或演示组织**,可以允许仅重新答辩;
- SaaS 场景下,企业客户可按自身规范配置规则。
---
## 8. 录音录屏与纪要策略
### 8.1 结论
**建议做录音录屏,但必须做成企业级三档开关。**
这是因为:
- 内部使用需要证据留痕;
- SaaS 客户对合规和隐私要求不同;
- 不能一刀切地强制所有客户录音录屏。
### 8.2 三档策略
| 档位 | 策略 | 适用场景 |
| --- | --- | --- |
| A 档 | 强制录音录屏 | 内部正式评审、强留痕客户 |
| B 档 | 默认录制,可申请关闭,关闭后降级为文字纪要 | 大多数 SaaS 客户 |
| C 档 | 不录音,只保留文字纪要与导师评分 | 轻量场景、隐私要求高的客户 |
### 8.3 录制内容建议
录制内容建议包括:
- 音频
- 视频画面
- 屏幕共享内容
- 导师提问与学生回答
- 最终评分与结论
### 8.4 录制后的数据用途
- 争议仲裁
- 学生复盘
- AI 生成纪要
- 入项审核材料补充
- 企业培养统计分析
---
## 9. 合规与数据安全要求
答辩录音录像一旦外售到 SaaS 场景,就涉及较强的数据合规要求,建议在产品设计阶段就预留能力。
### 9.1 必须考虑的合规点
| 合规点 | 建议措施 |
| --- | --- |
| 知情告知 | 答辩开始前明确告知“本次将录音/录屏” |
| 同意机制 | 参与人必须确认同意;不同意时应支持降级方案 |
| 数据最小化 | 只采集答辩必要内容,不额外采集无关信息 |
| 留存期限 | 设定可配置的保存周期,过期自动删除或脱敏 |
| 访问权限 | 仅答辩相关人员可访问,严格授权 |
| 租户隔离 | 不同 SaaS 客户的数据严格隔离 |
| 未成年人场景 | 若存在未成年人,需额外合规配置 |
### 9.2 推荐产品机制
- 答辩开始时弹出知情提示;
- 提供同意勾选;
- 若不同意,自动切换到文字纪要模式;
- 录音录像地址与答辩记录绑定;
- 过期自动删除或脱敏;
- 审计日志可追踪访问行为。
---
## 10. 答辩结果的回流设计
答辩结果不应孤立存在,应同步回流到三处:
### 10.1 成长档案
记录每次答辩的:
- 阶段
- 题目/主题
- 评分
- 结论
- 导师评语
- 录音录像或纪要链接
### 10.2 企业统计报表
用于统计:
- 答辩通过率
- 平均答辩时长
- 导师评审时长
- 各阶段答辩驳回原因分布
### 10.3 入项审核资料
入项阶段企业主管可查看:
- 所有阶段预习小测卷
- 实操产物与报告
- 导师验收结果
- 答辩结果
- 答辩纪要 / 录音录像(若启用)
这会让你前面设计的“企业主管查看学生全量历史记录”真正落地。
---
## 11. 答辩模块建议的字段设计
| 字段名 | 说明 |
| --- | --- |
| `defense_id` | 答辩唯一标识 |
| `student_id` | 学生标识 |
| `phase` | 所属阶段(阶段二 / 阶段三 / 阶段四 / 阶段五 / 进阶项目) |
| `defense_type` | 答辩类型(实时 / 录播 / 文字) |
| `topic` | 答辩主题 |
| `status` | 状态(待安排 / 进行中 / 已通过 / 未通过 / 需重答) |
| `score_total` | 总分 |
| `score_detail` | 评分明细 |
| `review_comment` | 导师评语 |
| `recording_url` | 录音录像地址 |
| `transcript_url` | 转写纪要地址 |
| `created_at` | 创建时间 |
| `reviewed_at` | 评审完成时间 |
| `reviewer_id` | 导师标识 |
| `retry_policy` | 不通过后的处理策略 |
---
## 12. 推荐的产品默认值
如果你要先内部落地,我建议默认采用以下配置:
- 答辩形式:**实时在线答辩**
- 录音录屏:**三档配置中的 A/B 默认开启**
- 评审人:**单导师评审**
- 结果:**通过 / 不通过**
- 不通过处理:**默认重新进行本阶段实操,可配置仅重新答辩**
- 结果回流:**成长档案 + 企业统计 + 入项审核材料**
---
## 13. 小结
这套答辩设计的核心原则是:
1. **标准化**:每个阶段都可复用同一套答辩框架;
2. **可配置**:形式、录音、评分、失败处理都能按企业调整;
3. **可留痕**:能支撑争议处理和结果回看;
4. **可 SaaS 化**:内部好用,外部可卖;
5. **可回流**:答辩结果能进入成长档案、统计和入项审核。
如果你确认这份设计无误,下一步我可以把这份答辩规范再进一步“映射”到:
- `01_业务流程图细化版.md`
- `03_状态机.md`
- `05_页面交互梳理表.md`
也就是把答辩状态、答辩页面跳转和失败回流逻辑全部补齐。
Markdown 格式
0% 或
您添加了 0 人 到此讨论。请谨慎行事。
请先完成此评论的编辑!
请 注册 或者 后发表评论