server/training-system
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

2026-05-12

Browse Source
This commit is contained in:
尹清林
2026-05-12 12:24:11 +08:00
parent db71245cbd
commit b20da3cd06
597 changed files with 24930 additions and 35355 deletions
Download Patch File Download Diff File Expand all files Collapse all files

881
training/workspace/specs/PRD.md Normal file
View File

@@ -0,0 +1,881 @@
# 道路救援企业培训系统 - 产品需求文档 (PRD)
> 版本：V1.0.1
> 更新日期：2026-01-13
> 状态：已确认
---
## 版本更新记录
### V1.0.1 (2026-01-13)
**【培训计划】多考试任务支持**
| 变更项 | 变更前 | 变更后 |
|-------|-------|-------|
| 考试任务数量 | 最多关联1个考试 | 支持关联多个考试 |
| 考试属性 | 无 | 支持设置必考/选考 |
| 考试排序 | 无 | 支持自定义排序 |
**功能说明：**
- 创建/编辑培训计划时，可添加多个考试任务
- 每个考试可设置为"必考"或"选考"
- 学员端展示所有关联考试及通过状态
- 列表页显示考试任务总数
**数据库变更：**
- 新增 `tr_plan_exam` 关联表
- 移除 `tr_plan` 表的 `exam_id` 字段
- ⚠️ 不兼容历史数据，需重新初始化数据库
---
### V1.0.0 (2026-01-08)
- 初始版本发布
- 包含：系统基础、人员管理、知识库、考题管理、试卷管理、考试管理、培训计划六大模块
---
## 一、核心目标 (Mission)
**为道路救援企业打造一站式内部培训平台，通过知识沉淀、在线考核、培训管理三大核心能力，提升500名员工的专业技能水平和服务标准化程度。**
---
## 二、用户画像 (Persona)
| 角色 | 人数估算 | 核心痛点 | 使用场景 |
|------|----------|----------|----------|
| **管理员** | 3-5人 | 人员管理分散，培训效果难追踪 | 配置系统、管理组织架构、分配权限 |
| **讲师（技师）** | 30-50人 | 知识传承依赖口口相传，出题组卷效率低 | 上传知识文档、创建题库、发布考试 |
| **学员** | 450人左右 | 学习资料分散、考试不便、进度不清晰 | 查阅知识库、完成培训任务、参加考试 |
---
## 三、版本规划
### V1：最小可行产品 (MVP)
#### 模块一：系统基础与人员管理
| 功能 | 说明 |
|----------|-----------------------------|
| 企业微信授权登录 | 企业微信授权登录 |
| 组织架构管理 | 中心 → 部门（≤8）→ 小组（≤10/部门）三级结构 |
| 员工管理 | 管理员手动录入员工信息，分配角色（管理员/讲师/学员） |
| 权限控制 | 基于角色的权限隔离，数据按部门隔离 |
#### 模块二：知识库（重点）
| 功能 | 说明 |
|------|------|
| 分类目录 | 支持多级分类（如：安全规范 > 高速救援 > 操作手册）|
| 文档管理 | 支持上传 PDF/Word/Excel/PPT 等常见文档格式 |
| 视频管理 | 支持上传视频文件，在线播放 |
| 在线预览 | 文档、视频无需下载即可在线查看 |
| 状态管理 | 草稿 → 已发布 → 已下架 |
| 部门隔离 | 各部门只能查看本部门的知识内容 |
#### 模块三：考题管理
| 功能 | 说明 |
|------|------|
| 题型支持 | 单选题、多选题、判断题 |
| 题目解析 | 每道题必须填写答案解析 |
| 题库分类 | 按分类/章节管理题目 |
| 状态管理 | 草稿 → 已发布 → 已下架 |
| 部门隔离 | 讲师只能管理本部门题库 |
#### 模块四：试卷管理
| 功能 | 说明 |
|------|------|
| 手动组卷 | 讲师手动从题库选题组成试卷 |
| 自动组卷 | 设置规则（单选X题+多选Y题+判断Z题），系统随机抽题 |
| 试卷配置 | 设置总分、题目分值、考试时长 |
| 试卷预览 | 组卷完成后可预览试卷效果 |
| 状态管理 | 草稿 → 已发布 → 已下架 |
#### 模块五：考试管理
| 功能 | 说明 |
|------|------|
| 发布考试 | 选择试卷，设置考试名称、时间窗口（开始~结束时间）|
| 指定对象 | 支持指定部门 / 小组 / 个人参加考试 |
| 考试规则 | 设置及格线、限制考试次数、考试时长 |
| 在线答题 | 学员在线作答，自动计时，超时自动交卷 |
| 成绩查看 | 交卷后立即显示成绩和答案解析 |
#### 模块六：培训计划
| 功能 | 说明 |
|------|------|
| 创建培训计划 | 设置计划名称、培训周期、培训目标 |
| 关联知识/考试 | 一个培训计划可包含多个知识文档 + 多场考试（V1.0.1+） |
| 考试属性设置 | 每个考试可设置必考/选考、自定义排序（V1.0.1+） |
| 分配学员 | 指定部门/小组/个人参加培训计划 |
| 进度跟踪 | 学员可查看自己的学习进度和考试状态 |
| 计划状态 | 未开始 / 进行中 / 已结束 |
### V2 及以后版本 (Future Releases)
| 版本 | 功能 | 价值 |
|------|------|------|
| **V2** | 统计报表中心 | 培训完成率、考试通过率、部门排名等数据看板 |
| **V2** | 线下培训签到 | 扫码签到/签退，记录实际培训时长 |
| **V2** | 错题本 | 学员自动收集错题，巩固薄弱知识点 |
| **V3** | 知识库增强 | 收藏、点赞、评论、全文搜索 |
| **V3** | 奖励体系 | 积分、勋章、学习排行榜 |
| **V3** | 证书管理 | 培训/考试
---
## 四、关键业务逻辑 (Business Rules)
### 4.1 权限规则
```
管理员：
├── 管理所有中心、部门、小组
├── 管理所有用户（增删改查、角色分配）
├── 查看全平台数据
└── 系统配置
讲师：
├── 管理本部门知识库（上传/编辑/删除）
├── 管理本部门题库（增删改查）
├── 创建/管理本部门试卷和考试
├── 创建/管理本部门培训计划
└── 查看本部门学员成绩
学员：
├── 查看本部门知识库（只读）
├── 参加分配给自己的培训计划
├── 参加分配给自己的考试
└── 查看个人学习记录和成绩
```
### 4.2 内容状态流转
```
┌─────────┐ 发布 ┌─────────┐ 下架 ┌─────────┐
│ 草稿 │ ───────────▶ │ 已发布 │ ───────────▶ │ 已下架 │
│ DRAFT │ │PUBLISHED │ │ OFFLINE │
└─────────┘ └─────────┘ └─────────┘
▲ │ │
│ │ 重新上架 │
│ ◀────────────────────────┘
│
└──────── 可继续编辑 ─────────────────────────────┘
```
| 状态 | 说明 | 学员可见 |
|------|------|----------|
| **草稿 (DRAFT)** | 讲师编辑中，未完成 | ❌ 不可见 |
| **已发布 (PUBLISHED)** | 正式生效，可被使用 | ✅ 可见 |
| **已下架 (OFFLINE)** | 临时隐藏，保留数据 | ❌ 不可见 |
### 4.3 考试规则
| 规则 | 说明 |
|------|------|
| 时间窗口 | 只有在考试开放时间内才能进入考试 |
| 限时作答 | 超过考试时长自动交卷 |
| 限制次数 | 达到最大次数后不可再考，取最高分 |
| 及格判定 | 分数 ≥ 及格线 为通过 |
| 答题顺序 | 自动组卷时题目顺序随机打乱 |
### 4.4 数据隔离规则
| 数据类型 | 隔离方式 |
|----------|----------|
| 知识库 | 按部门隔离，只能看本部门 |
| 题库 | 按部门隔离，讲师只能操作本部门 |
| 试卷/考试 | 按部门隔离 |
| 培训计划 | 按部门隔离 |
| 员工信息 | 管理员可见全部，讲师可见本部门 |
### 4.5 引用保护规则
| 场景 | 规则 |
|------|------|
| 题目下架 | 已被试卷引用的题目，下架前需确认警告 |
| 试卷下架 | 已被考试引用的试卷，下架前需确认警告 |
| 知识下架 | 已被培训计划引用的知识，下架前需确认警告 |
---
## 五、数据契约 (Data Contract)
### 5.1 核心实体
#### 用户 (sys_user)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 主键 |
| wx_userid | String | 企业微信用户ID |
| real_name | String | 姓名 |
| phone | String | 手机号 |
| role | Enum | 角色：ADMIN/LECTURER/STUDENT |
| department_id | Long | 所属部门 |
| group_id | Long | 所属小组（可空） |
| status | Enum | 状态：ENABLED/DISABLED |
| create_time | DateTime | 创建时间 |
#### 组织架构 (sys_center / sys_department / sys_group)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 主键 |
| name | String | 名称 |
| parent_id | Long | 上级ID（部门关联中心，小组关联部门） |
| sort_order | Integer | 排序 |
| create_time | DateTime | 创建时间 |
#### 知识分类 (km_category)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 主键 |
| name | String | 分类名称 |
| parent_id | Long | 父分类ID |
| department_id | Long | 所属部门 |
| sort_order | Integer | 排序 |
#### 知识 (km_knowledge)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 主键 |
| title | String | 标题 |
| category_id | Long | 所属分类 |
| type | Enum | 类型：DOCUMENT/VIDEO |
| file_url | String | 文件地址 |
| file_size | Long | 文件大小 |
| department_id | Long | 所属部门 |
| status | Enum | 状态：DRAFT/PUBLISHED/OFFLINE |
| creator_id | Long | 创建人 |
| create_time | DateTime | 创建时间 |
| publish_time | DateTime | 发布时间 |
#### 题目 (ex_question)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 主键 |
| type | Enum | 题型：SINGLE/MULTIPLE/JUDGE |
| content | String | 题干 |
| options | JSON | 选项列表（判断题为空） |
| answer | String | 正确答案 |
| analysis | String | 解析 |
| category_id | Long | 所属分类 |
| department_id | Long | 所属部门 |
| status | Enum | 状态：DRAFT/PUBLISHED/OFFLINE |
| creator_id | Long | 创建人 |
| create_time | DateTime | 创建时间 |
| publish_time | DateTime | 发布时间 |
#### 试卷 (ex_paper)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 主键 |
| title | String | 试卷名称 |
| total_score | Integer | 总分 |
| duration | Integer | 考试时长（分钟） |
| pass_score | Integer | 及格分 |
| department_id | Long | 所属部门 |
| status | Enum | 状态：DRAFT/PUBLISHED/OFFLINE |
| creator_id | Long | 创建人 |
| create_time | DateTime | 创建时间 |
| publish_time | DateTime | 发布时间 |
#### 试卷题目关联 (ex_paper_question)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 主键 |
| paper_id | Long | 试卷ID |
| question_id | Long | 题目ID |
| score | Integer | 该题分值 |
| sort_order | Integer | 排序 |
#### 考试 (ex_exam)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 主键 |
| title | String | 考试名称 |
| paper_id | Long | 关联试卷 |
| start_time | DateTime | 开始时间 |
| end_time | DateTime | 结束时间 |
| max_attempts | Integer | 最大考试次数 |
| department_id | Long | 所属部门 |
| status | Enum | 状态：NOT_STARTED/IN_PROGRESS/ENDED |
| creator_id | Long | 创建人 |
| create_time | DateTime | 创建时间 |
#### 考试对象 (ex_exam_target)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 主键 |
| exam_id | Long | 考试ID |
| target_type | Enum | 对象类型：DEPARTMENT/GROUP/USER |
| target_id | Long | 对象ID |
#### 考试记录 (ex_exam_record)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 主键 |
| exam_id | Long | 考试ID |
| user_id | Long | 学员ID |
| attempt_no | Integer | 第几次考试 |
| score | Integer | 得分 |
| passed | Boolean | 是否通过 |
| start_time | DateTime | 开始时间 |
| submit_time | DateTime | 提交时间 |
| answers | JSON | 答题详情 |
#### 培训计划 (tr_plan)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 主键 |
| title | String | 计划名称 |
| description | String | 计划描述 |
| start_date | Date | 开始日期 |
| end_date | Date | 结束日期 |
| department_id | Long | 所属部门 |
| exam_id | Long | 关联考试（可空） |
| status | Enum | 状态：NOT_STARTED/IN_PROGRESS/ENDED |
| creator_id | Long | 创建人 |
| create_time | DateTime | 创建时间 |
#### 培训计划-知识关联 (tr_plan_knowledge)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 主键 |
| plan_id | Long | 计划ID |
| knowledge_id | Long | 知识ID |
| required | Boolean | 是否必修 |
| sort_order | Integer | 排序 |
#### 培训计划-对象 (tr_plan_target)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 主键 |
| plan_id | Long | 计划ID |
| target_type | Enum | 对象类型：DEPARTMENT/GROUP/USER |
| target_id | Long | 对象ID |
#### 培训进度 (tr_plan_progress)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 主键 |
| plan_id | Long | 计划ID |
| user_id | Long | 学员ID |
| knowledge_id | Long | 知识ID |
| completed | Boolean | 是否完成 |
| complete_time | DateTime | 完成时间 |
---
## 六、原型设计（方案A - 经典管理后台风格）
### 6.1 设计理念
左侧固定导航 + 右侧内容区，层级分明，适合功能复杂的企业管理系统。学习成本低，用户容易上手。
### 6.2 布局结构
```
┌────────────────────────────────────────────────────────────────────────────┐
│ 🚗 道路救援培训系统 🔔 消息 👤 张三 ▼ │
├──────────────────┬─────────────────────────────────────────────────────────┤
│ │ │
│ 📊 工作台 │ 内容区域 │
│ │ │
│ 👥 人员管理 ▶ │ │
│ ├ 组织架构 │ │
│ ├ 员工管理 │ │
│ └ 讲师管理 │ │
│ │ │
│ 📚 知识库 ▶ │ │
│ ├ 知识分类 │ │
│ └ 知识列表 │ │
│ │ │
│ ✏️ 考题管理 ▶ │ │
│ ├ 题库分类 │ │
│ └ 题目列表 │ │
│ │ │
│ 📄 试卷管理 │ │
│ │ │
│ 📝 考试管理 │ │
│ │ │
│ 📅 培训计划 │ │
│ │ │
│ ────────────── │ │
│ ⚙️ 系统设置 │ │
│ │ │
└──────────────────┴─────────────────────────────────────────────────────────┘
```
### 6.3 核心页面原型
#### 工作台首页
```
┌────────────────────────────────────────────────────────────────────────────┐
│ 🚗 道路救援培训系统 🔔 消息 👤 张三 ▼ │
├──────────────────┬─────────────────────────────────────────────────────────┤
│ │ │
│ 📊 工作台 ● │ 欢迎回来，张三 2026年1月8日 │
│ │ │
│ 👥 人员管理 ▶ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ │ 待学习课程 │ │ 待完成考试 │ │ 培训进度 │ │
│ 📚 知识库 ▶ │ │ │ │ │ │ │ │
│ │ │ 12 │ │ 3 │ │ 75% │ │
│ ✏️ 考题管理 ▶ │ │ │ │ │ │ ████░░ │ │
│ │ └─────────────┘ └─────────────┘ └─────────────┘ │
│ 📄 试卷管理 │ │
│ │ ┌──────────────────────────────────────────────────┐ │
│ 📝 考试管理 │ │ 我的培训计划 │ │
│ │ ├──────────────────────────────────────────────────┤ │
│ 📅 培训计划 │ │ 📋 2026年Q1安全规范培训 进行中 60% │ │
│ │ │ 📋 新员工入职培训 进行中 30% │ │
│ │ │ 📋 高速救援操作规范 未开始 -- │ │
│ │ └──────────────────────────────────────────────────┘ │
│ │ │
│ │ ┌──────────────────────────────────────────────────┐ │
│ │ │ 待完成考试 │ │
│ │ ├──────────────────────────────────────────────────┤ │
│ │ │ 📝 安全规范考核 截止: 1月15日 [进入考试] │ │
│ │ │ 📝 月度技能测试 截止: 1月20日 [进入考试] │ │
│ │ └──────────────────────────────────────────────────┘ │
│ │ │
└──────────────────┴─────────────────────────────────────────────────────────┘
```
#### 知识库列表页
```
┌────────────────────────────────────────────────────────────────────────────┐
│ 🚗 道路救援培训系统 🔔 消息 👤 张三 ▼ │
├──────────────────┬─────────────────────────────────────────────────────────┤
│ │ │
│ 📊 工作台 │ 知识库 > 安全规范 │
│ │ ───────────────────────────────────────────────── │
│ 👥 人员管理 ▶ │ │
│ │ [+ 新增知识] [所有状态 ▼] [🔍 搜索知识...] │
│ 📚 知识库 ▼ │ │
│ ┌ 知识分类 │ ┌────────────────────────────────────────────────┐ │
│ └ 知识列表 ● │ │ 标题 类型 状态 更新时间 操作│ │
│ │ ├────────────────────────────────────────────────┤ │
│ ✏️ 考题管理 ▶ │ │ 高速救援SOP 📄文档 已发布 01-05 编辑│ │
│ │ │ 安全操作视频 🎬视频 已发布 01-03 编辑│ │
│ 📄 试卷管理 │ │ 应急处理流程 📄文档 草稿 01-02 编辑│ │
│ │ │ 设备使用手册 📄文档 已下架 12-28 编辑│ │
│ 📝 考试管理 │ └────────────────────────────────────────────────┘ │
│ │ │
│ 📅 培训计划 │ 共 24 条记录 < 1 2 3 4 5 > │
│ │ │
└──────────────────┴─────────────────────────────────────────────────────────┘
```
#### 在线考试页
```
┌────────────────────────────────────────────────────────────────────────────┐
│ 📝 2026年Q1安全规范考试 剩余时间: 45:23 │
├────────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ 第 3 题 / 共 20 题 [单选题] │ │
│ ├─────────────────────────────────────────────────────────────────────┤ │
│ │ │ │
│ │ 高速公路救援作业时，警示标志应放置在故障车辆后方多少米处？ │ │
│ │ │ │
│ │ ○ A. 50米 │ │
│ │ ● B. 150米 │ │
│ │ ○ C. 200米 │ │
│ │ ○ D. 100米 │ │
│ │ │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
│ 答题卡: │
│ ┌────────────────────────────────────────────────────────────────────┐ │
│ │ ✓1 ✓2 ●3 ○4 ○5 ○6 ○7 ○8 ○9 ○10 │ │
│ │ ○11 ○12 ○13 ○14 ○15 ○16 ○17 ○18 ○19 ○20 │ │
│ └────────────────────────────────────────────────────────────────────┘ │
│ │
│ [< 上一题] [下一题 >] [交卷] │
│ │
└────────────────────────────────────────────────────────────────────────────┘
```
#### 试卷组卷页
```
┌────────────────────────────────────────────────────────────────────────────┐
│ 🚗 道路救援培训系统 🔔 消息 👤 张三 ▼ │
├──────────────────┬─────────────────────────────────────────────────────────┤
│ │ │
│ 📊 工作台 │ 创建试卷 > 第2步：选择题目 │
│ │ ═══════════════════════════════════════════════════ │
│ 👥 人员管理 ▶ │ ① 基本信息 ────── ② 选择题目 ────── ③ 预览确认 │
│ │ ● │
│ 📚 知识库 ▶ │ │
│ │ ┌─────────────────────┐ ┌────────────────────────┐ │
│ ✏️ 考题管理 ▶ │ │ 📂 题库 │ │ 📋 已选题目 (15) │ │
│ │ │ ┌─────────────────┐ │ │ │ │
│ 📄 试卷管理 ● │ │ │ [全选] 安全(48) │ │ │ 单选题 x10 30分 │ │
│ │ │ │ ☑ 高速警示... │ │ │ 多选题 x3 15分 │ │
│ 📝 考试管理 │ │ │ ☑ 夜间灯光... │ │ │ 判断题 x2 5分 │ │
│ │ │ │ ☐ 拖车规范... │ │ │ ─────────────── │ │
│ 📅 培训计划 │ │ └─────────────────┘ │ │ 总分: 50分 │ │
│ │ │ │ │ │ │
│ │ │ ── 或自动组卷 ── │ │ [自动组卷] │ │
│ │ │ 单选: [10] 题 │ │ 单选: [10] 题 │ │
│ │ │ 多选: [ 5] 题 │ │ 多选: [ 5] 题 │ │
│ │ │ 判断: [ 5] 题 │ │ 判断: [ 5] 题 │ │
│ │ │ [随机抽题] │ │ [确认随机抽取] │ │
│ │ └─────────────────────┘ └────────────────────────┘ │
│ │ │
│ │ [上一步] [下一步:预览] │
└──────────────────┴─────────────────────────────────────────────────────────┘
```
---
## 七、架构设计蓝图
### 7.1 系统架构总览
```
┌─────────────────────────────────────────────────────────────────────────┐
│ 客户端层 │
│ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │
│ │ PC浏览器 │ │ 企业微信H5 │ │ 移动端浏览器 │ │
│ │ (管理员/讲师) │ │ (学员) │ │ (学员) │ │
│ └────────┬────────┘ └────────┬────────┘ └────────┬────────┘ │
└───────────┼─────────────────────┼─────────────────────┼─────────────────┘
│ │ │
└─────────────────────┼─────────────────────┘
▼
┌─────────────────────────────────────────────────────────────────────────┐
│ 网关层 │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ Spring Boot 应用 │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │
│ │ │ JWT认证 │ │ 权限拦截 │ │ 日志记录 │ │ 异常处理 │ │ │
│ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │ │
│ └─────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────────┐
│ 业务层 │
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
│ │ 认证模块 │ │ 组织模块 │ │ 知识库模块│ │ 考试模块 │ │ 培训模块 │ │
│ │ │ │ │ │ │ │ │ │ │ │
│ │ ·企微登录 │ │ ·组织架构 │ │ ·分类管理 │ │ ·题库管理 │ │ ·计划管理 │ │
│ │ ·Token管理│ │ ·员工管理 │ │ ·知识CRUD │ │ ·试卷管理 │ │ ·任务分配 │ │
│ │ ·权限校验 │ │ ·角色管理 │ │ ·文件上传 │ │ ·考试管理 │ │ ·进度跟踪 │ │
│ └───────────┘ └───────────┘ └───────────┘ └───────────┘ └───────────┘ │
└─────────────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────────┐
│ 数据层 │
│ ┌─────────────────────────┐ ┌─────────────────────────┐ │
│ │ MySQL 8.0 │ │ 文件存储服务 │ │
│ │ (MyBatis Plus ORM) │ │ (本地/OSS/MinIO) │ │
│ └─────────────────────────┘ └─────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────┘
```
### 7.2 核心流程图
#### 用户登录流程（企业微信OAuth）
```mermaid
sequenceDiagram
participant U as 用户
participant FE as 前端页面
participant BE as 后端服务
participant WX as 企业微信API
participant DB as 数据库
U->>FE: 点击"企业微信登录"
FE->>WX: 跳转企微授权页面
WX->>U: 显示授权确认
U->>WX: 确认授权
WX->>FE: 回调返回code
FE->>BE: 携带code请求登录
BE->>WX: 用code换取access_token
WX-->>BE: 返回access_token
BE->>WX: 获取用户信息(userid)
WX-->>BE: 返回用户信息
BE->>DB: 查询用户是否存在
alt 用户存在
DB-->>BE: 返回用户信息
BE->>BE: 生成JWT Token
BE-->>FE: 返回Token+用户信息
FE->>FE: 存储Token，跳转工作台
else 用户不存在
BE-->>FE: 返回错误:用户未录入
FE->>U: 提示联系管理员
end
```
#### 在线考试流程
```mermaid
sequenceDiagram
participant S as 学员
participant FE as 前端页面
participant BE as 后端服务
participant DB as 数据库
S->>FE: 进入考试列表
FE->>BE: 获取我的考试列表
BE->>DB: 查询分配给该学员的考试
DB-->>BE: 返回考试列表
BE-->>FE: 返回考试列表(含剩余次数)
S->>FE: 点击"开始考试"
FE->>BE: 请求开始考试
BE->>DB: 校验考试状态/次数/时间窗口
alt 校验通过
BE->>DB: 创建考试记录(开始时间)
BE->>DB: 获取试卷题目
DB-->>BE: 返回题目列表
BE-->>FE: 返回试卷内容+考试时长
FE->>FE: 启动倒计时
loop 答题过程
S->>FE: 选择/修改答案
FE->>FE: 本地暂存答案
FE->>BE: 定时自动保存(每30秒)
BE->>DB: 更新答题记录
end
alt 主动交卷
S->>FE: 点击"交卷"
else 时间到
FE->>FE: 倒计时结束
end
FE->>BE: 提交试卷
BE->>BE: 自动判分(客观题)
BE->>DB: 保存成绩+答案详情
BE-->>FE: 返回考试成绩
FE->>S: 显示成绩+答案解析
else 校验失败
BE-->>FE: 返回错误(次数用尽/不在时间窗口)
FE->>S: 提示无法参加考试
end
```
#### 培训计划执行流程
```mermaid
flowchart TB
subgraph 讲师操作
A[创建培训计划] --> B[设置基本信息]
B --> C[关联知识内容]
C --> D[关联考试-可选]
D --> E[指定培训对象]
E --> F[发布培训计划]
end
subgraph 学员学习
F --> G[学员收到培训通知]
G --> H[进入培训计划]
H --> I[学习知识内容]
I --> J{知识学完?}
J -->|否| I
J -->|是| K{有关联考试?}
K -->|否| L[培训完成]
K -->|是| M[参加考试]
M --> N{考试通过?}
N -->|是| L
N -->|否| O{还有考试次数?}
O -->|是| M
O -->|否| P[培训未通过]
end
subgraph 进度追踪
I --> Q[更新学习进度]
M --> R[记录考试成绩]
L --> S[标记培训完成]
end
```
### 7.3 技术选型
| 层次 | 技术 | 版本 | 说明 |
|------|------|------|------|
| **构建** | Maven | 3.8+ | 依赖管理 |
| **框架** | Spring Boot | 3.1.2 | 主框架 |
| **ORM** | MyBatis Plus | 3.5.3+ | 简化CRUD |
| **数据库** | MySQL | 8.0 | 主数据库 |
| **认证** | java-jwt | 4.4+ | JWT Token生成验证 |
| **加密** | Spring Security | 6.x | BCrypt密码加密 |
| **文档** | Springdoc OpenAPI | 2.2+ | API文档 |
| **工具** | Lombok | 1.18+ | 简化代码 |
| **JSON** | Jackson | 内置 | JSON序列化 |
| **文件** | 本地存储 / MinIO | - | V1先用本地，V2可扩展 |
| **前端** | HTML + CSS + JS | - | 原生技术栈 |
#### 关键依赖库
| 用途 | 库 | 说明 |
|------|-----|------|
| 企业微信SDK | weixin-java-cp | 企业微信Java SDK |
| 文件预览 | kkFileView / OnlyOffice | 文档在线预览（可选外部服务） |
| 视频播放 | video.js | 前端视频播放器 |
| Excel导入导出 | EasyExcel | 阿里开源，性能好 |
| 工具库 | Hutool | 常用工具集合 |
### 7.4 风险评估
| 风险点 | 等级 | 描述 | 应对策略 |
|--------|------|------|----------|
| **企业微信对接** | 🟡 中 | 需要企业微信管理员配置应用 | 提前准备配置文档，预留账号密码登录作为备选 |
| **文件预览** | 🟡 中 | 不同格式文档预览兼容性 | V1优先支持PDF+图片+视频，复杂格式提示下载 |
| **大文件上传** | 🟡 中 | 视频文件可能较大 | 限制单文件大小，支持分片上传 |
| **考试并发** | 🟢 低 | 500人规模并发压力不大 | 合理设计索引，必要时加缓存 |
| **数据隔离** | 🟢 低 | 部门数据隔离逻辑 | 统一在Service层实现隔离过滤 |
### 7.5 项目结构
```
training-system/
├── pom.xml
├── src/
│ └── main/
│ ├── java/com/sino/training/
│ │ ├── TrainingApplication.java # 启动类
│ │ │
│ │ ├── common/ # 通用模块
│ │ │ ├── config/ # 配置类
│ │ │ ├── exception/ # 异常处理
│ │ │ ├── result/ # 统一响应
│ │ │ ├── interceptor/ # 拦截器
│ │ │ └── utils/ # 工具类
│ │ │
│ │ ├── module/ # 业务模块
│ │ │ ├── auth/ # 认证模块
│ │ │ ├── system/ # 系统管理
│ │ │ ├── knowledge/ # 知识库模块
│ │ │ ├── exam/ # 考试模块
│ │ │ └── training/ # 培训模块
│ │ │
│ │ └── integration/ # 外部集成
│ │ └── wechat/ # 企业微信
│ │
│ └── resources/
│ ├── application.yml # 主配置
│ ├── application-dev.yml # 开发环境
│ ├── application-prod.yml # 生产环境
│ ├── mapper/ # MyBatis XML
│ ├── static/ # 静态资源
│ └── templates/ # 页面模板
│
├── docs/
│ └── PRD.md # 产品需求文档
│
└── sql/
└── init.sql # 数据库初始化脚本
```
---
## 八、附录
### 8.1 角色菜单权限对照表
| 菜单 | 管理员 | 讲师 | 学员 |
|------|--------|------|------|
| 工作台 | ✅ | ✅ | ✅ |
| 组织架构管理 | ✅ | ❌ | ❌ |
| 员工管理 | ✅ | 👁️ 本部门只读 | ❌ |
| 讲师管理 | ✅ | ❌ | ❌ |
| 知识库-分类管理 | ✅ | ✅ 本部门 | ❌ |
| 知识库-知识列表 | ✅ | ✅ 本部门 | 👁️ 本部门已发布 |
| 考题管理-题库分类 | ✅ | ✅ 本部门 | ❌ |
| 考题管理-题目列表 | ✅ | ✅ 本部门 | ❌ |
| 试卷管理 | ✅ | ✅ 本部门 | ❌ |
| 考试管理 | ✅ | ✅ 本部门 | 👁️ 我的考试 |
| 培训计划 | ✅ | ✅ 本部门 | 👁️ 我的培训 |
| 系统设置 | ✅ | ❌ | ❌ |
### 8.2 状态枚举定义
```java
// 内容状态
public enum ContentStatus {
DRAFT, // 草稿
PUBLISHED, // 已发布
OFFLINE // 已下架
}
// 用户角色
public enum UserRole {
ADMIN, // 管理员
LECTURER, // 讲师
STUDENT // 学员
}
// 用户状态
public enum UserStatus {
ENABLED, // 启用
DISABLED // 禁用
}
// 题目类型
public enum QuestionType {
SINGLE, // 单选题
MULTIPLE, // 多选题
JUDGE // 判断题
}
// 知识类型
public enum KnowledgeType {
DOCUMENT, // 文档
VIDEO // 视频
}
// 考试/培训目标类型
public enum TargetType {
DEPARTMENT, // 部门
GROUP, // 小组
USER // 个人
}
// 考试状态
public enum ExamStatus {
NOT_STARTED, // 未开始
IN_PROGRESS, // 进行中
ENDED // 已结束
}
// 培训计划状态
public enum PlanStatus {
NOT_STARTED, // 未开始
IN_PROGRESS, // 进行中
ENDED // 已结束
}
```
---
**文档状态：已确认，等待开发启动**