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

实习生培训平台PM前置文件 细化版功能架构图

上级 85c78d78
...@@ -2,85 +2,120 @@ ...@@ -2,85 +2,120 @@
> 适用项目:0824studyweb_Prototype_v2.0(实习生培训平台) > 适用项目:0824studyweb_Prototype_v2.0(实习生培训平台)
> 用途:定义系统模块边界、功能点归属与跨端共享机制,供架构师/前后端开发划分模块、拆接口 > 用途:定义系统模块边界、功能点归属与跨端共享机制,供架构师/前后端开发划分模块、拆接口
> 版本:v4.1(2026-08-31 修订:学生端按“通用能力 + 差异入口”重组——学习/实操/提交/验收/答辩全阶段复用,仅任务获取方式与实操环境两处差异通过参数、配置区分;阶段二补“平台沙箱+AutoDL 真机”实操与答辩;阶段三~五统一为“同步提交+统一验收+答辩”;阶段六删除导师意向审核,改为企业主管直接审核 + AI 缺陷分析 + 进阶推荐闭环;答辩统一复用子流程 E,详见《06_答辩环节设计规范》) > 版本:v4.2(2026-09-01 修订:页面命名对齐《05_页面交互梳理表》——student-task-hall / student-project-hall / student-pending-projects / student-learning;进阶推荐闭环改为差异入口;新增第 1 节架构分层图(接入层 / 业务层 / AI 服务层 / 数据层 / 配置层);支撑层拆分为公共基础层 + 业务能力层,并新增企业级配置中心(答辩形式开关 / 录音录屏档位 / 留存策略 / 租户隔离);总览图瘦身为五端 + 支撑层骨架;关键数据实体占位;管理员端“项目管理”与“任务下发”整合为“项目管理(含任务下发)”)
> 阅读建议:先看第 1 节总览图,再看第 2 节功能清单表,最后看第 3 节跨端共享机制 > 阅读建议:先看第 1 节架构分层图建立全局分层认知,再看第 2 节总览图了解五端与支撑层骨架,第 3 节功能清单表逐模块对照,最后看第 4 节跨端共享机制
--- ---
## 1. 系统功能架构总览 ## 1. 系统功能架构分层图
> 分层方式:公共层(登录/注册/个人中心)→ 五端业务模块 → 支撑层(跨端共享数据、门禁、通知、AI 服务) > 分层方式:接入层 → 业务层 → AI 服务层 / 数据层 / 配置层。接入层对应五端页面;业务层承载各端业务能力与跨端业务引擎;AI 服务层提供简历解析、题库生成、缺陷分析、推荐卡片等智能能力;数据层沉淀业务实体;配置层承载企业级合规开关与规则配置。
> 用途:给架构师/后端按层拆服务、按数据实体建表,给前端确定依赖边界。端内模块明细见第 3 节功能清单表。
```mermaid
flowchart TB
subgraph L1[接入层]
A1[学生端 Web]
A2[导师端 Web]
A3[管理员端 Web]
A4[企业端 Web]
A5[院校教务端 Web]
end
subgraph L2[业务层 · 应用服务]
B1[公共能力<br>认证 / 个人中心 / 通知 / 成长档案]
B2[学生实训链路<br>学习 / 实操 / 提交 / 验收结果 / 答辩]
B3[导师评审<br>部署验收 / 实操+报告评审 / 答辩评审]
B4[管理配置<br>项目管理(含任务下发)/ 培训体系 / 用户权限]
B5[企业运营<br>入项审核 / 推荐项目选择 / 统计报表]
B6[教务协作<br>体系管理 / 教学管理 / 学生档案]
B7[阶段门禁引擎<br>switchPage 统一拦截 + 前置条件校验]
end
subgraph L3[AI 服务层]
C1[简历解析]
C2[知识点 / 小测题库生成]
C3[缺陷分析<br>阶段一衔接测验 / 入项驳回全量资料]
C4[进阶推荐项目卡片生成]
C5[难度校准辅助]
end
subgraph L4[数据层]
D1[用户与权限]
D2[任务 / 项目统一表<br>source: admin_fixed / ai_recommended]
D3[学习记录<br>预习 / 小测 / 错题]
D4[实操产物与报告]
D5[验收 / 评审记录]
D6[答辩记录]
D7[推荐卡片 / 待执行列表]
D8[成长档案]
end
subgraph L5[配置层]
CFG1[企业级配置中心<br>答辩形式开关 / 录音录屏档位 / 留存策略 / 租户隔离]
CFG2[阶段门禁规则配置]
CFG3[AI 参数与模型配置]
end
L1 --> L2
L2 --> L3
L2 --> L4
L2 --> L5
B7 -. 调用 AI 服务 .-> L3
B7 -. 读写数据实体 .-> L4
```
> 分层约定:
> - 接入层只做页面渲染与交互,不直接操作数据,统一走业务层接口;
> - 业务层按“端 + 通用引擎”组织:五端业务能力 + 阶段门禁引擎(跨端共享,答辩门禁与阶段门禁共用);
> - AI 服务层独立成层,供业务层按需调用(题库生成 / 缺陷分析 / 推荐卡片),结果回写数据层;
> - 数据层先列出关键实体占位,详细字段留给专门的数据设计文档;
> - 配置层承载企业级合规开关与规则配置,是 SaaS 化的前置能力。
## 2. 系统功能架构总览
> 骨架分层:公共层(登录/注册/个人中心)→ 五端业务模块 → 支撑层(公共基础层 + 业务能力层 + 企业级配置中心)
> 说明:本图为骨架图,端内模块与功能点明细见第 3 节功能清单表;服务/数据/配置分层见第 1 节架构分层图。
```mermaid ```mermaid
flowchart TB flowchart TB
P[实习生培训平台] P[实习生培训平台]
subgraph COMMON[公共层] subgraph COMMON[公共层]
C1[登录/认证] C1[登录 / 注册 / 个人中心]
C2[注册]
C3[个人中心<br>资料/密码/通知/统计]
end end
subgraph STUDENT[学生端<br>通用能力 + 差异入口] subgraph STUDENT[学生端<br>通用能力 + 差异入口]
S1[学习首页<br>当前阶段/下一步任务] S1[通用实训链路<br>学习 → 实操 → 提交 → 验收 → 答辩<br>(学习首页 / 简历与画像 / 入项申请 / 成长档案)]
S2[简历与画像] S2[差异入口<br>任务大厅(阶段二)<br>项目大厅(阶段三~五)<br>待执行列表(入项驳回后)]
S3[学习中心(通用)<br>预习+小测+错题 全阶段复用]
S4[实操中心(通用)<br>环境开关:沙箱 ± AutoDL 真机]
S5[提交中心(通用)<br>产物+报告同步提交]
S6[任务大厅(阶段二)<br>管理员固定任务]
S7[项目大厅(阶段三~五)<br>AI 推荐+项目选择]
S8[待执行列表<br>进阶推荐逐个执行]
S9[验收结果(通用)]
S10[答辩中心(通用)<br>子流程E]
S11[入项申请<br>直接申请+企业主管审核]
S12[成长档案]
S13[进阶推荐闭环<br>推荐卡片+确认接受]
end end
subgraph MENTOR[导师端] subgraph MENTOR[导师端]
M1[工作台/待办] M1[部署验收]
M2[学员管理] M2[实操 + 报告评审]
M3[部署验收<br>验收台+API检测] M3[答辩评审<br>子流程 E]
M4[实操+报告评审<br>统一验收]
M5[答辩评审<br>子流程E]
end end
subgraph ADMIN[管理员端] subgraph ADMIN[管理员端]
A1[控制台/监控] A1[项目管理<br>(含任务下发)]
A2[项目管理] A2[难度校准 / AI 配置 / 培训体系生成器]
A3[难度校准] A3[用户 / 角色 / 部门 / 日志审计]
A4[AI 配置]
A5[培训体系生成器]
A6[部署任务下发<br>固定任务项目化+统一下发]
A7[用户/角色/权限]
A8[部门管理]
A9[日志审计]
end end
subgraph ENTERPRISE[企业端] subgraph ENTERPRISE[企业端]
E1[工作台/预警] E1[入项审核<br>全量历史记录 + 推荐项目选择]
E2[入项审核<br>全量历史记录+推荐项目选择] E2[体系审批 / 入项记录 / 统计报表]
E3[培训体系审批]
E4[入项记录]
E5[服务交付]
E6[统计报表]
end end
subgraph SCHOOL[院校教务端] subgraph SCHOOL[院校教务端]
K1[工作台/教学概览] K1[体系管理 / 教学管理]
K2[培训体系管理] K2[学生档案 / 账户认证 / 商业服务]
K3[教学管理]
K4[学生档案]
K5[账户与认证]
K6[商业服务]
end end
subgraph SUPPORT[支撑层] subgraph SUPPORT[支撑层]
T1[跨端共享数据<br>studentState/mentorState/adminDeployTask] T1[公共基础层<br>共享状态 / 通知 / 验收工具]
T2[阶段门禁引擎<br>switchPage 校验] T2[业务能力层<br>阶段门禁引擎 / AI 服务 / 推荐闭环]
T3[通知分发] T3[企业级配置中心<br>答辩开关 / 录音档位 / 留存 / 租户隔离]
T4[部署验收工具<br>Acceptance.html]
T5[AI 服务<br>简历解析/知识点题库生成/缺陷分析/推荐卡片]
end end
P --> COMMON P --> COMMON
...@@ -99,9 +134,9 @@ flowchart TB ...@@ -99,9 +134,9 @@ flowchart TB
--- ---
## 2. 各端功能清单表 ## 3. 各端功能清单表
### 2.1 公共层 ### 3.1 公共层
| 模块 | 功能点 | 对应页面 | 说明 | | 模块 | 功能点 | 对应页面 | 说明 |
| --- | --- | --- | --- | | --- | --- | --- | --- |
...@@ -109,7 +144,7 @@ flowchart TB ...@@ -109,7 +144,7 @@ flowchart TB
| 注册 | 角色选择、账户创建 | `register` | — | | 注册 | 角色选择、账户创建 | `register` | — |
| 个人中心 | 基础资料、密码、通知设置、学习统计、最近登录 | `profile` | 全角色共用 | | 个人中心 | 基础资料、密码、通知设置、学习统计、最近登录 | `profile` | 全角色共用 |
### 2.2 学生端 ### 3.2 学生端
> 拆分原则:**通用能力模块与差异入口模块分离**。阶段二与阶段三~五的实训链路在"学习 → 实操 → 提交 → 验收 → 答辩"上完全一致,仅两点不同(任务获取方式、实操环境),因此通用模块全部复用同一套页面,通过参数区分阶段;差异只出现在入口页面与环境开关。 > 拆分原则:**通用能力模块与差异入口模块分离**。阶段二与阶段三~五的实训链路在"学习 → 实操 → 提交 → 验收 → 答辩"上完全一致,仅两点不同(任务获取方式、实操环境),因此通用模块全部复用同一套页面,通过参数区分阶段;差异只出现在入口页面与环境开关。
...@@ -117,17 +152,17 @@ flowchart TB ...@@ -117,17 +152,17 @@ flowchart TB
| --- | --- | --- | --- | --- | | --- | --- | --- | --- | --- |
| 学习首页 | 通用 | 当前阶段、培养路径、下一步任务、学习建议 | `student-dashboard` | — | | 学习首页 | 通用 | 当前阶段、培养路径、下一步任务、学习建议 | `student-dashboard` | — |
| 简历与画像 | 通用 | 上传简历、生成能力画像/标签/建议 | `student-resume` | 阶段一入口 | | 简历与画像 | 通用 | 上传简历、生成能力画像/标签/建议 | `student-resume` | 阶段一入口 |
| 学习中心 | **通用** | 知识点预习、小测答题/判分、成绩与错题 | `student-preview` / `student-quiz` / `student-quiz-result` | 阶段二、阶段三~五、进阶项目复用同一组页面;预习知识点与小测题库由 AI 按任务/项目动态生成 | | 学习中心 | **通用** | 知识点预习、小测答题/判分、成绩与错题 | `student-learning` / `student-quiz` / `student-quiz-result` | 阶段二、阶段三~五、进阶项目复用同一组页面;预习知识点与小测题库由 AI 按任务/项目动态生成 |
| 实操中心 | **通用** | 任务详情、平台沙箱基础开发/脚本调试、SSH 连通性测试、AutoDL 真机部署 | `student-practice` | 页面复用,按阶段控制环境开关:阶段二 = 沙箱 + AutoDL 真机;阶段三~五 = 仅沙箱 | | 实操中心 | **通用** | 任务详情、平台沙箱基础开发/脚本调试、SSH 连通性测试、AutoDL 真机部署 | `student-practice` | 页面复用,按阶段控制环境开关:阶段二 = 沙箱 + AutoDL 真机;阶段三~五 = 仅沙箱 |
| 提交中心 | **通用** | 实操产物 + 实操报告同步提交、草稿保存、提交状态 | `student-submit` | 阶段二与阶段三~五均"同步提交",无差异 | | 提交中心 | **通用** | 实操产物 + 实操报告同步提交、草稿保存、提交状态 | `student-submit` | 阶段二与阶段三~五均"同步提交",无差异 |
| 验收结果 | **通用** | 导师验收/评审结论查看、整改意见 | `student-result` | 阶段二/阶段三~五/进阶项目复用 | | 验收结果 | **通用** | 导师验收/评审结论查看、整改意见 | `student-result` | 阶段二/阶段三~五/进阶项目复用 |
| 答辩中心 | **通用** | 答辩申请、材料提交、陈述演示、提问追问、结论(子流程 E) | `student-defense` | 统一入口,按所属阶段判定前置条件(验收通过);不通过默认重新实操 | | 答辩中心 | **通用** | 答辩申请、材料提交、陈述演示、提问追问、评分结论(子流程 E) | `student-defense` / `student-defense-live`(答辩现场) | 统一入口,按所属阶段判定前置条件(验收通过);不通过默认重新实操 |
| 任务大厅 | **差异(仅阶段二)** | 管理员固定任务查看(全员一致) | `student-tasks` | 固定部署任务做成项目入库并统一下发 | | 任务大厅 | **差异(仅阶段二)** | 管理员固定任务查看(全员一致) | `student-task-hall` | 固定部署任务做成项目入库并统一下发 |
| 项目大厅 | **差异(仅阶段三~五)** | AI 推荐项目列表(推荐依据=阶段一衔接测验缺陷分析)、项目详情、选择项目 | `student-projects` / `student-project-detail` | 选择后 AI 基于所选项目生成知识点与小测题库;实操仅平台沙箱 | | 项目大厅 | **差异(仅阶段三~五)** | AI 推荐项目列表(推荐依据=阶段一衔接测验缺陷分析)、项目详情、选择项目 | `student-project-hall` / `student-project-detail` | 选择后 AI 基于所选项目生成知识点与小测题库;实操仅平台沙箱 |
| 待执行列表 | **差异(仅入项驳回后)** | 待执行状态推荐项目查看、逐个选择启动、项目完成状态 | `student-pending` | 一次只启动一个项目,全部完成后可再次申请入项 | | 待执行列表 | **差异(仅入项驳回后)** | 待执行状态推荐项目查看、逐个选择启动、项目完成状态 | `student-pending-projects` | 一次只启动一个项目,全部完成后可再次申请入项 |
| 入项申请 | 通用 | 直接申请入项、审核状态、驳回原因、推荐项目确认 | `student-entry` | 无导师意向审核,企业主管直接审核 | | 入项申请 | 通用 | 直接申请入项、审核状态、驳回原因查看 | `student-entry` | 无导师意向审核,企业主管直接审核;驳回后跳转进阶推荐闭环 |
| 成长档案 | 通用 | 阶段记录、能力雷达图、历史汇总、答辩结果回流 | `student-archive` | — | | 成长档案 | 通用 | 阶段记录、能力雷达图、历史汇总、答辩结果回流 | `student-archive` | — |
| 进阶推荐闭环 | 通用 | 能力短板、推荐项目卡片、确认接受 | `student-advance` | 入项驳回后 AI 缺陷分析 + 推荐卡片 | | 进阶推荐闭环 | **差异(仅入项驳回后)** | 能力短板、推荐项目卡片、确认接受 | `student-advance` | 入项驳回后 AI 缺陷分析 + 推荐卡片 |
#### 复用落地建议 #### 复用落地建议
...@@ -137,7 +172,7 @@ flowchart TB ...@@ -137,7 +172,7 @@ flowchart TB
4. **AI 服务复用**:预习知识点与小测题库生成走统一接口(按任务/项目 ID 生成);阶段三~五推荐走缺陷分析接口,结果在同一项目大厅/推荐卡片组件中渲染。 4. **AI 服务复用**:预习知识点与小测题库生成走统一接口(按任务/项目 ID 生成);阶段三~五推荐走缺陷分析接口,结果在同一项目大厅/推荐卡片组件中渲染。
5. **答辩前置统一**:答辩中心按"所属阶段验收通过"这一条规则做门禁判定(子流程 E 的 E2 前置校验),阶段二/阶段三~五/进阶项目共用同一入口与流程。 5. **答辩前置统一**:答辩中心按"所属阶段验收通过"这一条规则做门禁判定(子流程 E 的 E2 前置校验),阶段二/阶段三~五/进阶项目共用同一入口与流程。
### 2.3 导师端 ### 3.3 导师端
| 模块 | 功能点 | 对应页面 | 说明 | | 模块 | 功能点 | 对应页面 | 说明 |
| --- | --- | --- | --- | | --- | --- | --- | --- |
...@@ -147,22 +182,21 @@ flowchart TB ...@@ -147,22 +182,21 @@ flowchart TB
| 实操+报告评审 | 实操产物 + 实操报告统一查看评审、评审结论 | `mentor-practice-review` | 阶段三~五同步提交后统一验收 | | 实操+报告评审 | 实操产物 + 实操报告统一查看评审、评审结论 | `mentor-practice-review` | 阶段三~五同步提交后统一验收 |
| 答辩评审 | 阶段二/阶段三~五/进阶项目答辩评审(子流程 E)、材料、安排、评分结论 | `mentor-defense-review` | 答辩不通过需区分实操问题/表达材料问题 | | 答辩评审 | 阶段二/阶段三~五/进阶项目答辩评审(子流程 E)、材料、安排、评分结论 | `mentor-defense-review` | 答辩不通过需区分实操问题/表达材料问题 |
### 2.4 管理员端 ### 3.4 管理员端
| 模块 | 功能点 | 对应页面 | 说明 | | 模块 | 功能点 | 对应页面 | 说明 |
| --- | --- | --- | --- | | --- | --- | --- | --- |
| 控制台 | 用户/项目/匹配率/健康度统计、快捷操作 | `admin-dashboard` | — | | 控制台 | 用户/项目/匹配率/健康度统计、快捷操作 | `admin-dashboard` | — |
| 项目管理 | 项目搜索/筛选/编辑/新增 | `admin-projects` | — | | 项目管理(含任务下发) | 项目搜索/筛选/编辑/新增;项目类型(普通项目 / 部署任务);部署任务特有:环境配置(SSH/AutoDL)、草稿保存、统一发布 | `admin-projects` / `admin-deploy-task`(部署任务编辑子页) | 部署任务发布后覆盖学生端任务;发布动作在项目管理内完成,不再独立入口 |
| 难度校准 | 难度维度、分级规则、AI 辅助评估 | `admin-difficulty` | — | | 难度校准 | 难度维度、分级规则、AI 辅助评估 | `admin-difficulty` | — |
| AI 配置 | 匹配算法、模型参数、模型状态 | `admin-ai-config` | 辅助页,未入导航 | | AI 配置 | 匹配算法、模型参数、模型状态 | `admin-ai-config` | 辅助页,未入导航 |
| 体系生成器 | 创建/生成/预览/发布培训体系 | `admin-system-generator` | — | | 体系生成器 | 创建/生成/预览/发布培训体系 | `admin-system-generator` | — |
| 任务下发 | 固定部署任务做成项目入库、内容配置、草稿、统一发布 | `admin-deploy-task` | 项目入库后统一下发,发布后覆盖学生任务 |
| 用户管理 | 账号、角色、状态、查询 | `admin-users` | — | | 用户管理 | 账号、角色、状态、查询 | `admin-users` | — |
| 角色权限 | 角色定义、权限项配置 | `admin-roles` / `admin-permissions` | — | | 角色权限 | 角色定义、权限项配置 | `admin-roles` / `admin-permissions` | — |
| 部门管理 | 部门、编码、成员、职责 | `admin-departments` | — | | 部门管理 | 部门、编码、成员、职责 | `admin-departments` | — |
| 日志审计 | 登录日志、审计/访问记录 | `admin-logs` / `admin-monitoring` | — | | 日志审计 | 登录日志、审计/访问记录 | `admin-logs` / `admin-monitoring` | — |
### 2.5 企业端 ### 3.5 企业端
| 模块 | 功能点 | 对应页面 | 说明 | | 模块 | 功能点 | 对应页面 | 说明 |
| --- | --- | --- | --- | | --- | --- | --- | --- |
...@@ -174,7 +208,7 @@ flowchart TB ...@@ -174,7 +208,7 @@ flowchart TB
| 服务交付 | 培训交付相关 | `enterprise-delivery` | 辅助页 | | 服务交付 | 培训交付相关 | `enterprise-delivery` | 辅助页 |
| 统计报表 | 培养周期、通过率、评审耗时、答辩结果回流 | `enterprise-stats` | — | | 统计报表 | 培养周期、通过率、评审耗时、答辩结果回流 | `enterprise-stats` | — |
### 2.6 院校教务端 ### 3.6 院校教务端
| 模块 | 功能点 | 对应页面 | 说明 | | 模块 | 功能点 | 对应页面 | 说明 |
| --- | --- | --- | --- | | --- | --- | --- | --- |
...@@ -187,17 +221,20 @@ flowchart TB ...@@ -187,17 +221,20 @@ flowchart TB
--- ---
## 3. 跨端共享机制(支撑层) ## 4. 跨端共享机制(支撑层)
| 机制 | 说明 | 落地位置 | | 机制 | 说明 | 落地位置 |
| --- | --- | --- | | --- | --- | --- |
| 共享状态 | 学生、导师、管理员端各自维护 `studentState` / `mentorState` / `adminDeployTask`,作为跨页面数据源 | 各端 `shared.js` | | 共享状态 | 学生、导师、管理员端各自维护 `studentState` / `mentorState` / `adminDeployTask`,作为跨页面数据源 | 公共基础层(各端 `shared.js`) |
| 阶段门禁 | `switchPage()` 统一拦截未解锁页面,页面内再按状态二次校验 | `index.html` + 页面 JS | | 阶段门禁引擎 | `switchPage()` 统一拦截未解锁页面,页面内再按状态二次校验;答辩门禁与阶段门禁共用同一引擎 | 业务能力层 |
| 任务下发覆盖 | 管理员将阶段二固定任务做成项目入库并统一下发,发布后覆盖学生端默认任务 `DEPLOY_TASK_INFO` | `admin/shared.js` → `student/shared.js` | | 任务下发覆盖 | 管理员在项目管理中将部署任务统一发布,发布后覆盖学生端默认任务 `DEPLOY_TASK_INFO` | `admin/shared.js` → `student/shared.js` |
| AI 能力服务 | 简历解析、基于固定/所选项目生成预习知识点与小测题库、入项驳回后全量缺陷分析、生成进阶推荐项目卡片 | 公共 AI 服务接口 | | AI 能力服务 | 简历解析、基于固定/所选项目生成预习知识点与小测题库、入项驳回后全量缺陷分析、生成进阶推荐项目卡片 | AI 服务层公共接口 |
| 评审结果同步 | 导师提交验收/评审结论后同步到学生结果页与通知 | `mentor/shared.js` → `student/shared.js` | | 评审结果同步 | 导师提交验收/评审结论后同步到学生结果页与通知 | `mentor/shared.js` → `student/shared.js` |
| 答辩结果回流 | 答辩评分结论回流成长档案、企业统计、后续阶段门禁、入项审核资料 | 各端 `shared.js` → 档案/统计 | | 答辩结果回流 | 答辩评分结论回流成长档案、企业统计、后续阶段门禁、入项审核资料 | 各端 `shared.js` → 档案/统计 |
| 推荐项目与待执行列表 | 企业主管选定推荐项目 → 学生确认接受 → 置为待执行 → 学生逐个选择执行 → 全部完成后开放再次申请入项 | `enterprise/shared.js` ↔ `student/shared.js` | | 推荐项目与待执行列表 | 企业主管选定推荐项目 → 学生确认接受 → 置为待执行 → 学生逐个选择执行 → 全部完成后开放再次申请入项 | `enterprise/shared.js` ↔ `student/shared.js` |
| 企业级配置中心 | 答辩形式开关(实时在线 / 异步录播 / 文字)、录音录屏档位(三档)、数据留存策略、多租户隔离 | 配置层(SaaS 化前置能力) |
| 验收工具 | `Acceptance.html` 独立用于 API 验收,与主平台解耦 | 独立页面 | | 验收工具 | `Acceptance.html` 独立用于 API 验收,与主平台解耦 | 独立页面 |
> 关键数据实体已在第 1 节架构分层图「数据层」占位(任务 / 项目统一表、学习记录、实操产物与报告、验收 / 评审记录、答辩记录、推荐卡片 / 待执行列表、成长档案、用户与权限),详细字段留给专门的数据设计文档。
> 注意:当前原型为浏览器内存状态 + `localStorage`。若正式开发,上述共享机制应替换为后端 API + 数据库事务,建议按本套文档的状态机设计建表,按泳道图拆接口。 > 注意:当前原型为浏览器内存状态 + `localStorage`。若正式开发,上述共享机制应替换为后端 API + 数据库事务,建议按本套文档的状态机设计建表,按泳道图拆接口。
# 0901 交接文档
> 项目:`0831InternTrainingPlatform`
> 当前阶段:文档体系联动更新与口径收敛中
> 交接目的:把本轮已经完成的设计调整、已确认的规则、后续待办统一沉淀,方便继续推进后续原型、接口与开发实现
---
## 1. 任务背景和目标
### 1.1 背景
当前项目是一个面向实习生培养的内部培训平台,后续还要考虑 SaaS 化对外销售。前期已经完成了业务流程、泳道图、状态机、功能架构图、页面交互梳理表和答辩规范等核心设计文档,但随着业务逻辑不断细化,部分文档之间存在口径不一致、页面复用不清晰、状态建模不完整等问题。
本轮工作的目标,是把最近确认的业务逻辑统一反映到文档体系中,确保:
- 主流程、角色职责、状态迁移、页面交互、功能架构之间互相对得上;
- 阶段二与阶段三~五的共用能力尽量复用页面与组件;
- 入项驳回后的推荐项目闭环、待执行状态、逐个执行逻辑不再歧义;
- 答辩流程作为通用子流程 E,被各文档统一引用;
- 后续开发可以直接按文档落地,不再依赖口头解释。
### 1.2 本轮目标
1. 把最新业务逻辑反映到 `02_泳道图.md`;
2. 把最新业务逻辑反映到 `03_状态机.md`;
3. 把学生端模块按“通用能力 + 差异入口”重构到 `04_功能架构图.md`;
4. 把页面跳转、门禁、异常处理统一到 `05_页面交互梳理表.md`;
5. 把答辩规范与页面交互闭环打通,补齐 `06_答辩环节设计规范.md` 的页面映射;
6. 新增本交接文档,作为后续继续推进的总入口。
---
## 2. 已完成的修改
### 2.1 `docs/02_泳道图.md`
已完成内容:
- **学生培养主流程泳道图**重写:
- 补上阶段二任务答辩节点;
- 补上阶段三~五本阶段答辩节点;
- 阶段六从“导师意向审核 + 企业终审”改为“企业主管直接审核 + AI 缺陷分析 + 进阶推荐卡片 + 学生确认 + 待执行列表 + 逐个执行”;
- 新增 AI/系统 泳道,承接缺陷分析与推荐卡片生成;
- 交接点表同步更新。
- **模型部署泳道图**更新:
- 保留“管理员下发固定任务 → 学生沙箱 + AutoDL → 导师验收”的链路;
- 增加阶段二任务答辩,并明确答辩不通过返回阶段二实操;
- 补充答辩通用流程引用。
- **入项审核泳道图**重写:
- 删除导师端;
- 改为学生 | 企业 | AI/系统 三泳道;
- 新增“待执行状态”“逐个选择项目”“全部完成后才能再次申请入项”等逻辑;
- 明确每个推荐项目先判断所属阶段,再按对应阶段流程执行。
- **使用建议**补充:
- 答辩交接点统一口径,统一指向 `01_业务流程图细化版.md` 的子流程 E 和 `06_答辩环节设计规范.md`。
---
### 2.2 `docs/03_状态机.md`
已完成内容:
- **学生培养阶段状态机**重构:
- 将阶段二、阶段三~五拆成更清晰的阶段状态;
- 阶段二增加答辩后才进入阶段三;
- 阶段三~五各自保留“预习/小测/实操/验收/答辩”循环;
- 阶段六入项审核改为直接企业审核,不再包含导师意向审核;
- 新增推荐项目闭环的引用说明。
- **部署作业状态机**更新:
- 部署验收通过后新增答辩中 / 答辩不通过 / 已通过状态链;
- 明确答辩不通过分为“实操本身问题”和“表达/材料问题”两类处理。
- **实操/报告评审状态机**更新:
- 强调阶段三~五要求“产物 + 报告同步提交”;
- 导师统一验收后才进入答辩;
- 通过后解锁答辩入口。
- **答辩申请状态机**重构:
- 按子流程 E 统一建模为“未申请 → 校验中 → 已安排 → 材料待交 → 评审中 → 已通过 / 未通过待分类”;
- 不通过分类后,分别进入“重新实操”或“仅重新答辩”。
- **入项申请状态机**重写:
- 删除意向审核与正式终审两段;
- 改为“待提交 → 已提交 → 企业审核中 → 已入项 / 已驳回”;
- 驳回后本次申请终止,转入推荐项目闭环。
- **推荐项目状态机**新增:
- 完整表达“已推荐 → 待确认 → 已确认 → 待执行 → 执行中 → 已完成”;
- 强调待执行列表一次只能启动一个项目;
- 项目执行前先判断所属阶段(阶段二 / 阶段三~五)。
- **培训体系状态机、项目状态机、落地建议**顺延编号,并补充答辩状态独立建模、推荐项目必须有阶段属性、待执行状态不能直接进实操等约束。
---
### 2.3 `docs/04_功能架构图.md`
已完成内容:
- **总览图中的学生端**按“通用能力 + 差异入口”重构:
- 通用模块:学习首页、简历与画像、学习中心、实操中心、提交中心、验收结果、答辩中心、入项申请、成长档案、进阶推荐闭环;
- 差异入口:任务大厅(仅阶段二)、项目大厅(仅阶段三~五)、待执行列表(仅入项驳回后)。
- **学生端功能清单表**重写:
- 增加“通用/差异”列;
- 把学习中心、实操中心、提交中心、验收结果、答辩中心定义为全阶段复用页面;
- 明确阶段二与阶段三~五的差异只体现在任务来源与实操环境;
- 新增“复用落地建议”,强调路由参数、环境开关、统一数据模型、AI 服务复用、答辩门禁统一。
- **导师端、企业端功能清单**同步更新:
- 导师端删除入项审核入口;
- 企业端新增全量历史记录查看、推荐项目选择等能力。
- **跨端共享机制**补充:
- 新增 AI 能力服务;
- 新增答辩结果回流;
- 新增推荐项目与待执行列表同步;
- 更新任务下发、评审结果同步的说明。
---
### 2.4 `docs/05_页面交互梳理表.md`
已完成内容:
- **学生端交互表**按“通用页面 + 差异入口”重构:
- 新增 `student-learning`、`student-practice`、`student-submit`、`student-result`、`student-defense` 等通用页面;
- 新增 `student-task-hall`、`student-project-hall`、`student-pending-projects`、`student-advance` 等差异入口页面;
- 明确阶段二与阶段三~五共用同一套学习/实操/提交/验收/答辩页面,使用 `stage` / `taskId` / `projectId` / `environment` 做差异化控制。
- **导师端交互表**更新:
- 删除导师入项审核入口;
- 只保留部署验收、实操+报告评审、答辩评审等职责;
- 答辩评审按阶段统一承接。
- **企业端交互表**更新:
- 增加查看学生全量历史记录;
- 增加推荐项目选择;
- 明确入项审核已迁移到企业主管。
- **公共端说明**与维护建议更新:
- 强调门禁与业务文档同步;
- 强调学生端复用优先。
---
### 2.5 `docs/06_答辩环节设计规范.md`
已完成内容:
- **新增第 12 节「页面映射与交互闭环」**:
- 把答辩子流程 E 的各环节映射到 `student-defense`、`mentor-defense-review`、`student-defense-live`、`student-result`、`student-archive`、`enterprise-stats` 等页面;
- 明确推荐交互链路:验收通过 → 去答辩 → 生成安排 → 提交材料 → 答辩 → 评分与原因分类 → 结果回流;
- 明确失败后的回流规则:实操问题回 `student-practice`,表达/材料问题留在 `student-defense` 重新答辩;
- 明确与 `05_页面交互梳理表.md` 的对齐建议,避免学生端路径分裂。
- **章节编号顺延**:
- 原“推荐的产品默认值”顺延为第 13 节;
- 原“小结”顺延为第 14 节;
- 同时修复了插入过程中造成的分隔符与标题顺序问题。
- **文档头部**补充版本说明:
- 标明本轮修订已与 `05_页面交互梳理表.md` 联动,答辩统一为子流程 E。
---
### 2.6 `docs/0901HANDOFF.md`(新增)
已新增本交接文档,汇总当前阶段:
- 任务背景和目标;
- 已完成修改;
- 已确定的决策和约束;
- 未完成任务和下一步计划;
- 注意事项 / 踩过的坑。
---
## 3. 已确定的决策和约束
### 3.1 风格约定
1. **文档优先使用 Mermaid + 表格**,便于版本管理与多人协作;
2. **先流程,后状态,再交互**:
- 先用 `01` 把业务流程闭环说明清楚;
- 再用 `02` / `03` 提炼角色和状态;
- 再用 `04` / `05` 落到架构和页面;
- `06` 单独规范答辩细节与合规;
3. **编号必须可追溯**:
- 节点编号、状态编号、页面映射之间要能互相对应;
4. **跨阶段复用的环节要抽通用子流程**:
- 答辩统一抽成子流程 E;
- 学生端学习/实操/提交/验收页面也按通用能力抽象。
### 3.2 命名约定
- `A / B / C / D / E` 分别代表业务流程图中的五个子流程;
- 答辩环节统一写作“子流程 E”;
- 学生端模块优先使用“通用能力 + 差异入口”命名;
- `student-task-hall`、`student-project-hall`、`student-pending-projects`、`student-defense` 等页面名采用功能语义,不再受原型图旧命名限制;
- 入项驳回后的推荐项目,统一使用“进阶推荐项目卡片”“待执行状态”“待执行列表”“逐个执行”等术语。
### 3.3 方案取舍
1. **阶段二与阶段三~五的实操页面合并复用**,仅靠阶段参数与环境配置切换任务来源和实操环境;
2. **阶段二任务来源固定**,以管理员固定任务项目化下发;
3. **阶段三~五任务来源动态**,以 AI 缺陷分析推荐项目;
4. **阶段六不再固定死为“阶段三~五全流程”**,先识别推荐项目所属阶段,再执行对应阶段流程;
5. **企业主管驳回后保留人工选择权**,不是 AI 自动推荐完就直接发给学生;
6. **学生确认接受后,推荐项目先进入待执行状态**,然后一次只选一个项目执行;
7. **答辩不通过的后续动作做成可配置**,默认是重新进行本阶段实操,也可以配置成仅重新答辩;
8. **录音录屏不做死**,改为企业级三档开关,兼容内部使用与 SaaS 合规;
9. **答辩默认以实时在线为主**,异步录播和文字答辩作为可选能力保留;
10. **页面复用优先于页面分裂**,尤其是学生端,不再按阶段单独拆两套几乎相同的实操页。
### 3.4 约束和统一口径
- 阶段二实操:平台沙箱基础开发 / 脚本调试 + AutoDL 真机部署;
- 阶段三~五实操:仅平台沙箱;
- 阶段三~五的项目推荐依据:阶段一衔接测验的卷面缺陷分析;
- 企业主管入项审核时可查看学生全部历史记录;
- 学生入项驳回后的进阶项目可以有多个,由企业主管自主决定推荐数量;
- 学生需要先确认接受推荐项目,再从待执行列表中逐个选择项目;
- 进阶项目完成后才可以再次申请入项;
- 答辩统一走 `student-defense` / `mentor-defense-review` 闭环,不再分散成多个顶层页面;
- `05` 中涉及答辩的页面交互必须与 `06` 的页面映射保持一致。
---
## 4. 未完成的任务和下一步计划
### 4.1 当前明确的下一步
本轮最关键的文档更新已经完成,下一步可以从以下几个方向继续推进:
1. **把页面交互表进一步原型化**
- 如果后续要落原型,可以把 `05_页面交互梳理表.md` 对应页面的跳转关系做成低保真草图或路由表;
2. **把答辩页做成更细的产品规格**
- 例如补 `student-defense`、`mentor-defense-review`、`student-defense-live` 的页面层级关系、状态切换图、组件划分;
3. **把推荐项目闭环再落细到数据结构**
- 例如定义推荐卡片、待执行列表、项目所属阶段、确认状态、执行状态的数据字段;
4. **继续检查剩余规范文档是否还存在口径偏差**
- 如果后续还有页面规范、接口规范、数据库设计文档,需要继续与 `01~06` 对齐。
### 4.2 建议的实施顺序
1. 先围绕 `student-defense`、`mentor-defense-review` 做答辩页规格;
2. 再把推荐项目闭环转成数据模型与接口字段;
3. 如有原型页面补充需求,再回写 `05` 的页面映射;
4. 最后如果进入开发阶段,再把 `03` 和 `05` 的口径细化成接口与数据库设计。
---
## 5. 注意事项 / 踩过的坑
### 5.1 答辩流程的编号问题
- 之前答辩流程图中使用过 `S0 / S1 / ...` 之类的编号,虽然 Mermaid 可用,但会和业务状态混淆;
- 现在统一改为 `D1~D13` 语义编号,更适合图表与说明表互查。
### 5.2 “流程编号”与“状态编号”不要混用
- 流程图节点编号只是为了图表之间跳转方便;
- 状态机里的状态值才是开发落库和门禁判断的依据;
- 不要把节点编号直接当业务状态值使用。
### 5.3 “待执行状态”是新概念
入项驳回后的推荐项目不是直接开始,也不是一次性全部启动,而是:
1. 企业主管选推荐项目;
2. 学生确认接受;
3. 系统置为待执行;
4. 学生从待执行列表中一次选一个项目;
5. 每个项目先判断所属阶段,再进入对应阶段流程。
这个逻辑在 `02`、`03`、`04`、`05` 中都要统一表达,避免误读成“所有推荐项目同时启动”。
### 5.4 学生端页面要尽量复用
- 阶段二与阶段三~五的页面并不是两套系统,而是一套通用页面加不同参数;
- 如果把阶段二、阶段三~五拆成两套页面,后续维护成本会非常高;
- 所以 `04` 与 `05` 已经改成“学习/实操/提交/验收/答辩”通用化,差异仅在任务来源与环境配置。
### 5.5 答辩结果要回流
答辩不能只停留在“通过/不通过”,还要回流到:
- 成长档案;
- 企业统计;
- 后续阶段门禁;
- 入项审核资料。
这个逻辑已经在 `01`、`03`、`05`、`06` 中统一了,后续不要再拆成不同口径。
### 5.6 SaaS 化时要预留合规能力
- 答辩录音录屏内部使用可以接受,但如果后续卖 SaaS,必须预留企业级开关;
- 必须支持知情告知、同意机制、数据最小化、留存期限、访问权限、租户隔离;
- 不同客户可能会要求实时在线、异步录播、文字答辩不同组合,不能硬编码死。
---
## 6. 结论
截至当前,已经完成了:
- 业务流程主链路细化;
- 阶段二 / 阶段三~五 / 入项驳回后进阶项目的差异化设计;
- 答辩环节的独立规范;
- 答辩流程和业务主流程的统一口径;
- 学生端页面的通用化拆分;
- 页面的交互闭环与答辩规范联动。
下一步重点是:**继续把这些最新业务逻辑反映到具体原型、接口和数据结构中**,尤其是 `student-defense`、`student-pending-projects`、`enterprise-review` 这几个闭环页面。
# 0901 功能整合决策记录(原型图修改依据)
> 项目:0831InternTrainingPlatform
> 用途:记录"学生端任务大厅/项目大厅是否整合"与"管理员端项目管理/任务下发是否整合"两轮讨论的结论,作为后续修改原型图与页面交互表的依据
> 关联文档:《04_功能架构图》v4.2 已按本决策同步修改;《05_页面交互梳理表》后续需联动更新
---
## 1. 决策一:学生端「任务大厅」与「项目大厅」——不整合
### 1.1 差异对比
| 维度 | 任务大厅(阶段二) | 项目大厅(阶段三~五) |
| --- | --- | --- |
| 数据来源 | 管理员固定下发,全员一致 | AI 个性化推荐,每人不同 |
| 任务呈现 | 简单列表,无需推荐理由 | 需要展示缺陷分析、推荐理由、难度、匹配度 |
| 选择行为 | 不用"选",直接开始做 | 需要"挑选",涉及比较、查看详情、做决定 |
| 环境信息 | 需展示 AutoDL 真机部署信息 | 仅沙箱,无需额外环境说明 |
| 入口意义 | 通知型入口:告诉你"该做什么" | 决策型入口:帮你决定"做什么" |
### 1.2 结论:不整合
理由:
1. 数据源不同 → 合并后前端需要大量条件分支切换数据获取与渲染逻辑;
2. 选择行为不同 → 阶段二固定任务可直接进入学习,阶段三~五需要推荐卡片、缺陷依据、比较选择;
3. 业务心智不同 → 固定任务与个性化推荐是两种心智模型,混在一起反而让学生困惑。
### 1.3 替代方案
- 共享底层组件:卡片列表、筛选器、详情面板;
- 后台数据模型统一:任务/项目共用一张表,`source` 字段区分 `admin_fixed` / `ai_recommended`;
- 入口页面独立:`student-task-hall`、`student-project-hall` 保持独立。
### 1.4 对原型图的影响
- 保留两个独立入口页面;
- 原型中共享列表/卡片组件,前端复用组件而非复用页面;
- 阶段二任务大厅可直接用简单列表呈现(无需推荐卡片);
- 阶段三~五项目大厅需展示推荐理由、难度匹配度等信息。
---
## 2. 决策二:管理员端「项目管理」与「任务下发」——整合
### 2.1 差异对比
| 维度 | 项目管理 | 任务下发 |
| --- | --- | --- |
| 内容 | 全量项目库(所有阶段) | 阶段二固定部署任务 |
| 核心操作 | CRUD、难度校准 | 内容配置、草稿、统一发布/覆盖 |
| 特有行为 | 无发布行为 | "发布后覆盖学生端默认任务"广播动作 |
| 元数据 | 标准项目字段 | 额外 AutoDL 配置、SSH 信息、部署脚本路径 |
| 业务含义 | 管"项目"本身 | 管"下发到学生端"的分发动作 |
### 2.2 结论:整合
理由:管理员面对的是同一批内容(项目库),部署任务只是项目的一个特殊子类型;拆分两个页面增加管理员的切换成本,与"学生端两个入口源于不同心智模型"的情况不同。
### 2.3 整合方案
1. `admin-projects` 增加「项目类型」字段(`普通项目` / `部署任务`);
2. 类型为"部署任务"时展开额外字段(环境配置、SSH 信息、部署脚本路径);
3. 列表页对部署任务显示「发布」按钮与「已发布/未发布」状态;
4. 点击「发布」执行统一下发(覆盖学生端默认任务)。
### 2.4 保留点
- 若后续阶段二任务类型变复杂(多种固定任务类型)或发布需要审批流,再考虑拆回独立页面;
- 发布动作仍可复用 `admin-deploy-task` 编辑子页路由,但不再作为顶层独立入口。
### 2.5 对原型图的影响
- 管理员端顶层导航移除"任务下发"入口,合并到"项目管理";
- 项目列表页增加类型筛选与发布操作;
- 新建/编辑项目时按类型切换字段表单。
---
## 3. 关联文档联动清单
| 文档 | 联动内容 | 状态 |
| --- | --- | --- |
| 《04_功能架构图》 | 页面命名收口、进阶推荐闭环改差异入口、架构分层图、支撑层拆分、企业级配置中心、数据实体占位、总览图瘦身、管理员端整合 | 已同步(v4.2) |
| 《05_页面交互梳理表》 | 管理员端 `admin-deploy-task` 入口行需改为从 `admin-projects` 进入;学生端任务大厅/项目大厅入口行保留 | 待后续原型修改时同步 |
| 原型图 | 按决策一、决策二调整管理员端导航与学生端入口 | 待修改 |
---
## 4. 结论
- **学生端**:任务大厅与项目大厅保留独立页面,共享组件降低维护成本;
- **管理员端**:项目管理与任务下发合并为一个页面,以"项目类型"字段与"发布"动作区分能力层次。
\ No newline at end of file
Markdown 格式
0% 或
您添加了 0 人 到此讨论。请谨慎行事。
请先完成此评论的编辑!
请 注册 或者 后发表评论