Skip to content
项目
群组
代码片段
帮助
当前项目
正在载入...
登录 / 注册
切换导航面板
S
studyweb_pmfile
项目
项目
详情
活动
周期分析
仓库
仓库
文件
提交
分支
标签
贡献者
图表
比较
统计图
议题
0
议题
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
CI / CD
CI / CD
流水线
作业
日程
统计图
Wiki
Wiki
代码片段
代码片段
成员
成员
折叠边栏
关闭边栏
活动
图像
聊天
创建新问题
作业
提交
问题看板
Open sidebar
yujiejie
studyweb_pmfile
Commits
c99bc79a
提交
c99bc79a
authored
9月 01, 2026
作者:
yujiejie
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
实习生培训平台PM前置文件 细化版功能架构图
上级
85c78d78
隐藏空白字符变更
内嵌
并排
正在显示
3 个修改的文件
包含
520 行增加
和
72 行删除
+520
-72
04_功能架构图.md
docs/04_功能架构图.md
+109
-72
0901HANDOFF.md
docs/0901HANDOFF.md
+323
-0
0901功能整合决策记录.md
docs/0901功能整合决策记录.md
+88
-0
没有找到文件。
docs/04_功能架构图.md
浏览文件 @
c99bc79a
...
@@ -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-task
s
`
| 固定部署任务做成项目入库并统一下发 |
| 任务大厅 |
**差异(仅阶段二)**
| 管理员固定任务查看(全员一致) |
`student-task
-hall
`
| 固定部署任务做成项目入库并统一下发 |
| 项目大厅 |
**差异(仅阶段三~五)**
| AI 推荐项目列表(推荐依据=阶段一衔接测验缺陷分析)、项目详情、选择项目 |
`student-project
s
`
/
`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 + 数据库事务,建议按本套文档的状态机设计建表,按泳道图拆接口。
docs/0901HANDOFF.md
0 → 100644
浏览文件 @
c99bc79a
# 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`
这几个闭环页面。
docs/0901功能整合决策记录.md
0 → 100644
浏览文件 @
c99bc79a
# 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
人
到此讨论。请谨慎行事。
请先完成此评论的编辑!
取消
请
注册
或者
登录
后发表评论