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

实习生培训平台PM前置文件 第二步泳道图版本已完成

上级 b83eb034
......@@ -2,13 +2,14 @@
> 适用项目:0824studyweb_Prototype_v2.0(实习生培训平台)
> 用途:定义系统模块边界、功能点归属与跨端共享机制,供架构师/前后端开发划分模块、拆接口
> 版本:v4.1(2026-08-31 修订:学生端按“通用能力 + 差异入口”重组——学习/实操/提交/验收/答辩全阶段复用,仅任务获取方式与实操环境两处差异通过参数、配置区分;阶段二补“平台沙箱+AutoDL 真机”实操与答辩;阶段三~五统一为“同步提交+统一验收+答辩”;阶段六删除导师意向审核,改为企业主管直接审核 + AI 缺陷分析 + 进阶推荐闭环;答辩统一复用子流程 E,详见《06_答辩环节设计规范》)
> 阅读建议:先看第 1 节总览图,再看第 2 节功能清单表,最后看第 3 节跨端共享机制
---
## 1. 系统功能架构总览
> 分层方式:公共层(登录/注册/个人中心)→ 五端业务模块 → 支撑层(跨端共享数据、门禁、通知)
> 分层方式:公共层(登录/注册/个人中心)→ 五端业务模块 → 支撑层(跨端共享数据、门禁、通知、AI 服务)
```mermaid
flowchart TB
......@@ -20,24 +21,28 @@ flowchart TB
C3[个人中心<br>资料/密码/通知/统计]
end
subgraph STUDENT[学生端]
S1[简历与能力画像]
S2[衔接学习<br>预习+测验]
S3[模型部署<br>预习+小测+AutoDL+提交]
S4[项目实训<br>推荐+预习+小测+实操]
S5[报告与答辩]
S6[入项申请]
S7[成长档案]
S8[进阶匹配]
subgraph STUDENT[学生端<br>通用能力 + 差异入口]
S1[学习首页<br>当前阶段/下一步任务]
S2[简历与画像]
S3[学习中心(通用)<br>预习+小测+错题 全阶段复用]
S4[实操中心(通用)<br>环境开关:沙箱 ± AutoDL 真机]
S5[提交中心(通用)<br>产物+报告同步提交]
S6[任务大厅(阶段二)<br>管理员固定任务]
S7[项目大厅(阶段三~五)<br>AI 推荐+项目选择]
S8[待执行列表<br>进阶推荐逐个执行]
S9[验收结果(通用)]
S10[答辩中心(通用)<br>子流程E]
S11[入项申请<br>直接申请+企业主管审核]
S12[成长档案]
S13[进阶推荐闭环<br>推荐卡片+确认接受]
end
subgraph MENTOR[导师端]
M1[工作台/待办]
M2[学员管理]
M3[部署验收<br>验收台+API检测]
M4[实操评审]
M5[答辩评审]
M6[入项审核]
M4[实操+报告评审<br>统一验收]
M5[答辩评审<br>子流程E]
end
subgraph ADMIN[管理员端]
......@@ -46,7 +51,7 @@ flowchart TB
A3[难度校准]
A4[AI 配置]
A5[培训体系生成器]
A6[部署任务下发]
A6[部署任务下发<br>固定任务项目化+统一下发]
A7[用户/角色/权限]
A8[部门管理]
A9[日志审计]
......@@ -54,7 +59,7 @@ flowchart TB
subgraph ENTERPRISE[企业端]
E1[工作台/预警]
E2[入项终审]
E2[入项审核<br>全量历史记录+推荐项目选择]
E3[培训体系审批]
E4[入项记录]
E5[服务交付]
......@@ -75,6 +80,7 @@ flowchart TB
T2[阶段门禁引擎<br>switchPage 校验]
T3[通知分发]
T4[部署验收工具<br>Acceptance.html]
T5[AI 服务<br>简历解析/知识点题库生成/缺陷分析/推荐卡片]
end
P --> COMMON
......@@ -105,30 +111,41 @@ flowchart TB
### 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` | 辅助页 |
> 拆分原则:**通用能力模块与差异入口模块分离**。阶段二与阶段三~五的实训链路在"学习 → 实操 → 提交 → 验收 → 答辩"上完全一致,仅两点不同(任务获取方式、实操环境),因此通用模块全部复用同一套页面,通过参数区分阶段;差异只出现在入口页面与环境开关。
| 模块 | 通用/差异 | 功能点 | 对应页面 | 说明 |
| --- | --- | --- | --- | --- |
| 学习首页 | 通用 | 当前阶段、培养路径、下一步任务、学习建议 | `student-dashboard` | — |
| 简历与画像 | 通用 | 上传简历、生成能力画像/标签/建议 | `student-resume` | 阶段一入口 |
| 学习中心 | **通用** | 知识点预习、小测答题/判分、成绩与错题 | `student-preview` / `student-quiz` / `student-quiz-result` | 阶段二、阶段三~五、进阶项目复用同一组页面;预习知识点与小测题库由 AI 按任务/项目动态生成 |
| 实操中心 | **通用** | 任务详情、平台沙箱基础开发/脚本调试、SSH 连通性测试、AutoDL 真机部署 | `student-practice` | 页面复用,按阶段控制环境开关:阶段二 = 沙箱 + AutoDL 真机;阶段三~五 = 仅沙箱 |
| 提交中心 | **通用** | 实操产物 + 实操报告同步提交、草稿保存、提交状态 | `student-submit` | 阶段二与阶段三~五均"同步提交",无差异 |
| 验收结果 | **通用** | 导师验收/评审结论查看、整改意见 | `student-result` | 阶段二/阶段三~五/进阶项目复用 |
| 答辩中心 | **通用** | 答辩申请、材料提交、陈述演示、提问追问、结论(子流程 E) | `student-defense` | 统一入口,按所属阶段判定前置条件(验收通过);不通过默认重新实操 |
| 任务大厅 | **差异(仅阶段二)** | 管理员固定任务查看(全员一致) | `student-tasks` | 固定部署任务做成项目入库并统一下发 |
| 项目大厅 | **差异(仅阶段三~五)** | AI 推荐项目列表(推荐依据=阶段一衔接测验缺陷分析)、项目详情、选择项目 | `student-projects` / `student-project-detail` | 选择后 AI 基于所选项目生成知识点与小测题库;实操仅平台沙箱 |
| 待执行列表 | **差异(仅入项驳回后)** | 待执行状态推荐项目查看、逐个选择启动、项目完成状态 | `student-pending` | 一次只启动一个项目,全部完成后可再次申请入项 |
| 入项申请 | 通用 | 直接申请入项、审核状态、驳回原因、推荐项目确认 | `student-entry` | 无导师意向审核,企业主管直接审核 |
| 成长档案 | 通用 | 阶段记录、能力雷达图、历史汇总、答辩结果回流 | `student-archive` | — |
| 进阶推荐闭环 | 通用 | 能力短板、推荐项目卡片、确认接受 | `student-advance` | 入项驳回后 AI 缺陷分析 + 推荐卡片 |
#### 复用落地建议
1. **路由策略**:学习中心、实操中心、提交中心、验收结果、答辩中心使用同一套页面,通过 URL/参数 `stage`(`2` / `3` / `4` / `5`)或 `taskType` 区分;差异入口(任务大厅/项目大厅/待执行列表)页面独立,但复用相同组件(列表/卡片/筛选器)。
2. **环境开关**:实操中心通过 `stage === '2'` 控制是否渲染 AutoDL 真机环境入口;环境能力以配置驱动(如 `environments: ['sandbox','autodl']` 与 `['sandbox']`),前端不做两套实操页。
3. **数据模型统一**:固定任务与推荐项目使用同一数据结构(任务/项目表),以 `source` 区分来源(`admin_fixed` / `ai_recommended`);阶段二任务大厅从统一任务源读取。
4. **AI 服务复用**:预习知识点与小测题库生成走统一接口(按任务/项目 ID 生成);阶段三~五推荐走缺陷分析接口,结果在同一项目大厅/推荐卡片组件中渲染。
5. **答辩前置统一**:答辩中心按"所属阶段验收通过"这一条规则做门禁判定(子流程 E 的 E2 前置校验),阶段二/阶段三~五/进阶项目共用同一入口与流程。
### 2.3 导师端
| 模块 | 功能点 | 对应页面 | 说明 |
| --- | --- | --- | --- |
| 工作台 | 带教学员、待办、四阶段进度、日程、统计 | `mentor-dashboard` | — |
| 工作台 | 带教学员、待办、培养进度、日程、统计 | `mentor-dashboard` | — |
| 学员管理 | 学员列表、阶段进度、筛选、详情 | `mentor-students` | — |
| 部署验收 | 验收总览、独立验收台、API 检测、评分、结论 | `mentor-deploy-review` / `mentor-deploy-acceptance` | 验收台为辅助页 |
| 实操评审 | 提交信息查看、评审结论 | `mentor-practice-review` | — |
| 答辩评审 | 材料、安排、结论 | `mentor-defense-review` | — |
| 入项审核 | 综合评审、审批表单 | `mentor-entry-review` | — |
| 实操+报告评审 | 实操产物 + 实操报告统一查看评审、评审结论 | `mentor-practice-review` | 阶段三~五同步提交后统一验收 |
| 答辩评审 | 阶段二/阶段三~五/进阶项目答辩评审(子流程 E)、材料、安排、评分结论 | `mentor-defense-review` | 答辩不通过需区分实操问题/表达材料问题 |
### 2.4 管理员端
......@@ -139,7 +156,7 @@ flowchart TB
| 难度校准 | 难度维度、分级规则、AI 辅助评估 | `admin-difficulty` | — |
| AI 配置 | 匹配算法、模型参数、模型状态 | `admin-ai-config` | 辅助页,未入导航 |
| 体系生成器 | 创建/生成/预览/发布培训体系 | `admin-system-generator` | — |
| 任务下发 | 文本模型/图像任务配置、草稿、统一发布 | `admin-deploy-task` | 发布后覆盖学生任务 |
| 任务下发 | 固定部署任务做成项目入库、内容配置、草稿、统一发布 | `admin-deploy-task` | 项目入库后统一下发,发布后覆盖学生任务 |
| 用户管理 | 账号、角色、状态、查询 | `admin-users` | — |
| 角色权限 | 角色定义、权限项配置 | `admin-roles` / `admin-permissions` | — |
| 部门管理 | 部门、编码、成员、职责 | `admin-departments` | — |
......@@ -149,12 +166,13 @@ flowchart TB
| 模块 | 功能点 | 对应页面 | 说明 |
| --- | --- | --- | --- |
| 工作台 | 入项审批、训练中学员、预警、待办、统计 | `enterprise-dashboard` | — |
| 入项终审 | 学员入项申请处理 | `enterprise-review` | — |
| 工作台 | 入项审核待办、训练中学员、预警、统计 | `enterprise-dashboard` | — |
| 入项审核 | 查看学生全量历史记录(预习小测卷/实操产物+报告/验收/答辩结果)、入项审核、得出结论 | `enterprise-review` | 企业主管直接审核,无导师意向环节 |
| 推荐项目选择 | 查看 AI 生成的进阶推荐项目卡片、选择一个或多个推荐给学生 | `enterprise-review` / `enterprise-recommend` | 入项驳回后由企业主管人工选择 |
| 体系审批 | 培训体系审核、提出修改意见 | `enterprise-training-approve` | 辅助页 |
| 入项记录 | 已完成审批学员与培养记录 | `enterprise-records` | — |
| 服务交付 | 培训交付相关 | `enterprise-delivery` | 辅助页 |
| 统计报表 | 培养周期、通过率、评审耗时趋势 | `enterprise-stats` | — |
| 统计报表 | 培养周期、通过率、评审耗时、答辩结果回流 | `enterprise-stats` | — |
### 2.6 院校教务端
......@@ -175,8 +193,11 @@ flowchart TB
| --- | --- | --- |
| 共享状态 | 学生、导师、管理员端各自维护 `studentState` / `mentorState` / `adminDeployTask`,作为跨页面数据源 | 各端 `shared.js` |
| 阶段门禁 | `switchPage()` 统一拦截未解锁页面,页面内再按状态二次校验 | `index.html` + 页面 JS |
| 任务下发覆盖 | 管理员发布部署任务后覆盖学生端默认任务 `DEPLOY_TASK_INFO` | `admin/shared.js` → `student/shared.js` |
| 评审结果同步 | 导师提交结论后同步到学生结果页与通知 | `mentor/shared.js` → `student/shared.js` |
| 任务下发覆盖 | 管理员将阶段二固定任务做成项目入库并统一下发,发布后覆盖学生端默认任务 `DEPLOY_TASK_INFO` | `admin/shared.js` → `student/shared.js` |
| AI 能力服务 | 简历解析、基于固定/所选项目生成预习知识点与小测题库、入项驳回后全量缺陷分析、生成进阶推荐项目卡片 | 公共 AI 服务接口 |
| 评审结果同步 | 导师提交验收/评审结论后同步到学生结果页与通知 | `mentor/shared.js` → `student/shared.js` |
| 答辩结果回流 | 答辩评分结论回流成长档案、企业统计、后续阶段门禁、入项审核资料 | 各端 `shared.js` → 档案/统计 |
| 推荐项目与待执行列表 | 企业主管选定推荐项目 → 学生确认接受 → 置为待执行 → 学生逐个选择执行 → 全部完成后开放再次申请入项 | `enterprise/shared.js` ↔ `student/shared.js` |
| 验收工具 | `Acceptance.html` 独立用于 API 验收,与主平台解耦 | 独立页面 |
> 注意:当前原型为浏览器内存状态 + `localStorage`。若正式开发,上述共享机制应替换为后端 API + 数据库事务,建议按本套文档的状态机设计建表,按泳道图拆接口。
Markdown 格式
0% 或
您添加了 0 人 到此讨论。请谨慎行事。
请先完成此评论的编辑!
请 注册 或者 后发表评论