665 lines
26 KiB
Markdown
665 lines
26 KiB
Markdown
# 学员端功能需求文档
|
||
|
||
> 版本：V1.0.1
|
||
> 创建日期：2026-01-15
|
||
> 更新日期：2026-01-15
|
||
> 状态：✅ 已批准（Supervisor 复审通过）
|
||
|
||
---
|
||
|
||
## 版本更新记录
|
||
|
||
### V1.0.1 (2026-01-15)
|
||
|
||
**根据Supervisor审查意见修订：**
|
||
|
||
| 修订项 | 修订内容 |
|
||
|--------|----------|
|
||
| 知识学习入口 | 补充培训任务学习场景、返回逻辑、来源区分 |
|
||
| 断点续考机制 | 补充定时任务策略、超时判定规则、并发处理 |
|
||
| 排名计算规则 | 明确计算时机、统计范围、口径定义 |
|
||
| 学习时长防刷 | 新增活跃检测机制 |
|
||
| 数据表设计 | km_knowledge_progress 新增 department_id 字段 |
|
||
| 页面路径 | 调整为复用现有路径，按角色控制 |
|
||
| 解析显示策略 | 明确交卷后立即显示解析 |
|
||
| 非功能需求 | 补充可测试的性能指标 |
|
||
|
||
---
|
||
|
||
## 一、概述
|
||
|
||
### 1.1 目标用户
|
||
- **角色**：学员（STUDENT）
|
||
- **人数**：约450人
|
||
- **入口**：PC浏览器（与管理端共用系统，按角色显示不同菜单）
|
||
|
||
### 1.2 核心目标
|
||
为学员提供便捷的在线学习平台，支持知识学习、在线考试、培训计划跟踪，帮助学员提升专业技能。
|
||
|
||
---
|
||
|
||
## 二、功能模块总览
|
||
|
||
| 模块 | 功能点 | 优先级 |
|
||
|------|--------|--------|
|
||
| 工作台 | 学习概览、待办事项 | P0 |
|
||
| 知识学习 | 知识浏览、学习进度、时长统计 | P0 |
|
||
| 在线考试 | 考试列表、在线答题、断点续考、成绩排名 | P0 |
|
||
| 我的培训 | 培训计划、进度跟踪、完成判定 | P0 |
|
||
| 个人中心 | 学习记录、考试记录、证书（预留） | P1 |
|
||
|
||
---
|
||
|
||
## 三、详细功能需求
|
||
|
||
### 3.1 工作台（首页）
|
||
|
||
#### 用户故事
|
||
> 作为学员，我希望登录后看到学习概览和待办事项，以便快速了解学习状态和接下来要做的事。
|
||
|
||
#### 功能清单
|
||
|
||
| 功能项 | 说明 |
|
||
|--------|------|
|
||
| 学习统计卡片 | 显示：待学习课程数、待完成考试数、培训进度百分比 |
|
||
| 我的培训计划 | 列表展示分配给我的培训计划（最多显示5条），显示进度 |
|
||
| 待完成考试 | 列表展示待完成的考试（最多显示5条），显示截止时间 |
|
||
| 快捷入口 | 点击可直接进入对应详情页 |
|
||
|
||
#### 验收标准
|
||
- [ ] 登录后默认进入工作台页面
|
||
- [ ] 统计数据实时准确（待学习=未完成的必修知识数，待考试=未通过的必考考试数）
|
||
- [ ] 培训进度百分比 = 已完成必修项 / 总必修项 × 100%
|
||
- [ ] 点击培训计划可跳转到计划详情
|
||
- [ ] 点击考试可跳转到考试页面
|
||
- [ ] 只显示"进行中"状态的培训计划和处于"时间窗口内"的考试
|
||
|
||
---
|
||
|
||
### 3.2 知识学习
|
||
|
||
#### 用户故事
|
||
> 作为学员，我希望浏览本部门的知识库，学习文档和视频，并能看到自己的学习进度。
|
||
|
||
#### 功能清单
|
||
|
||
| 功能项 | 说明 |
|
||
|--------|------|
|
||
| 知识分类导航 | 左侧树形结构展示知识分类 |
|
||
| 知识列表 | 按分类筛选，显示知识标题、类型、学习状态 |
|
||
| 知识详情/预览 | 文档在线预览、视频在线播放 |
|
||
| 学习进度记录 | 记录学习完成状态、学习时长 |
|
||
| 强制学习机制 | 视频必须播放完成、文档必须阅读完成才记录为"已完成" |
|
||
|
||
#### 3.2.1 知识列表页
|
||
|
||
**页面元素**：
|
||
- 分类筛选（树形）
|
||
- 知识卡片列表：标题、类型图标（文档/视频）、学习状态标签、时长/大小
|
||
- 搜索框（按标题搜索）
|
||
|
||
**学习状态**：
|
||
| 状态 | 说明 | 显示样式 |
|
||
|------|------|----------|
|
||
| 未学习 | 从未打开过 | 灰色标签 |
|
||
| 学习中 | 已开始但未完成 | 蓝色标签 + 进度% |
|
||
| 已完成 | 满足完成条件 | 绿色标签 ✓ |
|
||
|
||
#### 3.2.2 知识详情页
|
||
|
||
**文档类型**：
|
||
- 在线预览（PDF直接显示，Word/Excel/PPT转换预览）
|
||
- 学习计时：进入页面开始计时，离开页面停止
|
||
- 完成条件：停留时间 ≥ 预估阅读时间（可配置，默认按页数计算）
|
||
|
||
**视频类型**：
|
||
- 在线播放（支持进度条、全屏）
|
||
- 播放进度记录：记录当前播放位置，下次打开从断点继续
|
||
- 完成条件：播放进度 ≥ 90%（可配置）
|
||
- 禁止拖动快进（强制学习模式下）
|
||
|
||
#### 3.2.3 学习入口场景（🔴 修订项1）
|
||
|
||
**场景一：自由学习（从知识库进入）**
|
||
- 入口：左侧菜单"知识库" → 知识列表 → 知识详情
|
||
- 学习完成后：停留在知识详情页，可点击"返回列表"
|
||
- 进度记录：标记来源为 `FREE`（自由学习）
|
||
|
||
**场景二：培训任务学习（从培训计划进入）**
|
||
- 入口：培训详情页 → 点击知识项 → 知识详情
|
||
- 页面顶部显示：返回培训计划入口（如："← 返回《2026年Q1安全规范培训》"）
|
||
- 学习完成后：
|
||
- 自动弹出提示："学习完成！是否返回培训计划？"
|
||
- 用户可选择【返回培训】或【继续浏览】
|
||
- 进度记录：标记来源为 `TRAINING`（培训任务），关联 `plan_id`
|
||
|
||
**进度记录来源区分**：
|
||
| 来源 | 场景 | 影响 |
|
||
|------|------|------|
|
||
| FREE | 自由学习 | 仅记录个人学习进度 |
|
||
| TRAINING | 培训任务学习 | 同时更新培训计划进度 |
|
||
|
||
> **说明**：无论从哪个入口学习，学习时长和完成状态都会记录。区分来源是为了后续统计分析（如：培训驱动的学习 vs 自主学习）。
|
||
|
||
#### 3.2.4 学习时长防刷机制（🟡 优化项1）
|
||
|
||
**文档类型防刷策略**：
|
||
- 每60秒检测一次用户活跃状态
|
||
- 活跃判定：60秒内有鼠标移动、点击、滚动任一事件
|
||
- 非活跃时：暂停计时，页面显示"检测到您暂时离开，学习计时已暂停"
|
||
- 恢复活跃后：继续计时
|
||
|
||
**视频类型防刷策略**：
|
||
- 依赖视频播放事件，暂停时不计时长
|
||
- 无需额外活跃检测
|
||
|
||
**多标签页处理**：
|
||
- 同一知识同时只能在一个标签页学习
|
||
- 检测到多标签页打开同一知识时，后打开的标签页提示"该知识已在其他窗口学习中"
|
||
|
||
#### 验收标准
|
||
- [ ] 只显示本部门、已发布状态的知识
|
||
- [ ] 分类树正确展示，点击分类筛选对应知识
|
||
- [ ] 文档能正常在线预览（至少支持PDF）
|
||
- [ ] 视频能正常播放，支持暂停、音量调节
|
||
- [ ] 视频播放进度自动保存，刷新页面后从断点继续
|
||
- [ ] 强制学习模式下，视频不能快进跳过
|
||
- [ ] 学习时长准确记录（精确到秒）
|
||
- [ ] 满足完成条件后自动标记为"已完成"
|
||
- [ ] 学习进度与培训计划进度联动
|
||
- [ ] 🔴 从培训计划进入的知识学习，顶部显示返回入口
|
||
- [ ] 🔴 学习完成后弹出返回培训计划提示（仅培训任务学习场景）
|
||
- [ ] 🟡 文档学习时，非活跃状态暂停计时
|
||
- [ ] 🟡 同一知识不能在多个标签页同时学习
|
||
|
||
---
|
||
|
||
### 3.3 在线考试
|
||
|
||
#### 用户故事
|
||
> 作为学员，我希望参加分配给我的考试，并能查看成绩和排名。
|
||
|
||
#### 功能清单
|
||
|
||
| 功能项 | 说明 |
|
||
|--------|------|
|
||
| 考试列表 | 展示分配给我的所有考试 |
|
||
| 考试详情 | 显示考试信息、我的考试记录 |
|
||
| 在线答题 | 单选/多选/判断题作答 |
|
||
| 断点续考 | 中途退出后可继续答题 |
|
||
| 自动交卷 | 时间到自动提交 |
|
||
| 成绩查看 | 显示得分、答案解析 |
|
||
| 成绩排名 | 显示我在本次考试中的排名 |
|
||
|
||
#### 3.3.1 考试列表页
|
||
|
||
**列表字段**：
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| 考试名称 | 点击进入考试详情 |
|
||
| 考试时间 | 开始时间 ~ 结束时间 |
|
||
| 考试状态 | 未开始/进行中/已结束 |
|
||
| 我的状态 | 未参加/考试中/已完成 |
|
||
| 最高成绩 | 多次考试取最高分 |
|
||
| 剩余次数 | 最大次数 - 已考次数 |
|
||
| 操作 | 进入考试/查看成绩 |
|
||
|
||
**筛选条件**：
|
||
- 考试状态：全部/进行中/已结束
|
||
- 我的状态：全部/未完成/已完成
|
||
|
||
#### 3.3.2 考试详情页（进入考试前）
|
||
|
||
**显示信息**：
|
||
- 考试名称、考试时间窗口
|
||
- 考试规则：时长、总分、及格线、最大次数
|
||
- 我的考试记录表格（第N次、得分、是否通过、时间）
|
||
- 【开始考试】/【继续考试】按钮
|
||
|
||
**按钮逻辑**：
|
||
| 场景 | 按钮状态 |
|
||
|------|----------|
|
||
| 不在时间窗口内 | 禁用，提示"考试未开始"或"考试已结束" |
|
||
| 次数已用完 | 禁用，提示"考试次数已用完" |
|
||
| 有进行中的考试记录 | 显示【继续考试】 |
|
||
| 可以开始新考试 | 显示【开始考试】 |
|
||
|
||
#### 3.3.3 在线答题页
|
||
|
||
**页面布局**：
|
||
```
|
||
┌─────────────────────────────────────────────────────────┐
|
||
│ 考试名称 剩余时间: 45:23 │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ 第 3 题 / 共 20 题 [单选题] │
|
||
│ ───────────────────────────────────────────────────── │
|
||
│ 题干内容... │
|
||
│ │
|
||
│ ○ A. 选项A │
|
||
│ ● B. 选项B（已选中） │
|
||
│ ○ C. 选项C │
|
||
│ ○ D. 选项D │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ 答题卡: [1✓] [2✓] [3●] [4○] [5○] ... │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ [上一题] [下一题] [交卷] │
|
||
└─────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
**功能说明**：
|
||
| 功能 | 说明 |
|
||
|------|------|
|
||
| 倒计时 | 显示剩余时间，最后5分钟变红色提醒 |
|
||
| 题目导航 | 点击答题卡数字可跳转到对应题目 |
|
||
| 答案自动保存 | 选择答案后自动保存到服务器（每30秒或切题时） |
|
||
| 上一题/下一题 | 切换题目 |
|
||
| 交卷 | 弹出确认框，确认后提交 |
|
||
| 自动交卷 | 时间结束自动提交当前答案 |
|
||
|
||
**断点续考机制**：
|
||
- 考试开始后创建考试记录，状态为"进行中"
|
||
- 答案实时保存到服务器
|
||
- 中途关闭浏览器/断网，考试记录保持"进行中"
|
||
- 重新打开考试，检测到进行中记录，恢复到上次状态
|
||
- 倒计时从剩余时间继续（服务端计算：考试时长 - 已用时间）
|
||
- 超时未提交的考试，由定时任务自动交卷
|
||
|
||
#### 3.3.5 超时自动交卷机制（🔴 修订项2）
|
||
|
||
**超时判定规则**：
|
||
```
|
||
超时时间点 = 考试记录开始时间 + 考试时长（分钟）
|
||
```
|
||
|
||
**示例**：
|
||
- 学员A在 10:00 开始考试，考试时长60分钟
|
||
- 超时时间点 = 10:00 + 60分钟 = 11:00
|
||
- 无论考试时间窗口是否结束，11:00后该考试记录即视为超时
|
||
|
||
**定时任务策略**：
|
||
| 配置项 | 值 | 说明 |
|
||
|--------|-----|------|
|
||
| 执行频率 | 每1分钟 | Cron: `0 */1 * * * ?` |
|
||
| 扫描范围 | 状态为IN_PROGRESS的考试记录 | 只处理进行中的记录 |
|
||
| 超时判定 | 当前时间 > 开始时间 + 考试时长 | 精确到秒 |
|
||
| 处理动作 | 自动提交当前已保存的答案，计算成绩 | 标记为系统自动交卷 |
|
||
|
||
**并发提交处理（乐观锁）**：
|
||
```
|
||
场景：学员在超时前1秒点击交卷，同时定时任务也在处理该记录
|
||
```
|
||
|
||
**处理策略**：
|
||
1. 考试记录表增加 `version` 字段（乐观锁）
|
||
2. 提交时检查 `status = IN_PROGRESS AND version = 当前版本`
|
||
3. 更新时 `version = version + 1`
|
||
4. 若更新失败（version已变），说明已被其他请求处理，直接返回已提交的结果
|
||
|
||
**状态流转**：
|
||
```
|
||
IN_PROGRESS ──用户主动交卷──▶ SUBMITTED（来源：USER）
|
||
│
|
||
└──────定时任务超时交卷──▶ SUBMITTED（来源：SYSTEM_TIMEOUT）
|
||
```
|
||
|
||
**交卷来源标记**：
|
||
| 来源 | 说明 |
|
||
|------|------|
|
||
| USER | 用户主动交卷 |
|
||
| SYSTEM_TIMEOUT | 系统超时自动交卷 |
|
||
|
||
> **注意**：即使考试时间窗口已结束，只要考试记录未超时，学员仍可继续答题（但无法开始新的考试）
|
||
|
||
#### 3.3.6 考试结果页
|
||
|
||
**显示内容**：
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 得分 | 大字显示，及格绿色/不及格红色 |
|
||
| 是否通过 | 通过✓ / 未通过✗ |
|
||
| 排名 | "您的成绩排名第 X 名（共 Y 人参加）" |
|
||
| 答题详情 | 每道题的正确答案、我的答案、解析 |
|
||
| 操作按钮 | 【再考一次】（有次数）/ 【返回列表】 |
|
||
|
||
**答案解析显示策略（🟡 优化项4）**：
|
||
- 交卷后立即显示所有题目的答案解析
|
||
- 无论考试是否通过，都显示解析
|
||
- 目的：培训学习为主，帮助学员理解错误原因
|
||
|
||
#### 3.3.7 排名计算规则（🔴 修订项3）
|
||
|
||
**计算时机**：
|
||
- 实时计算：每次交卷时计算排名
|
||
- 非定时计算：不采用批量定时计算方式
|
||
|
||
**统计范围**：
|
||
- 范围：当前考试的所有参与者（被分配且已交卷的学员）
|
||
- 跨部门：若考试分配给多个部门，排名为所有参与者的总排名
|
||
|
||
**排名规则**：
|
||
| 优先级 | 规则 | 说明 |
|
||
|--------|------|------|
|
||
| 1 | 最高成绩降序 | 成绩高的排名靠前 |
|
||
| 2 | 达到最高成绩的时间升序 | 成绩相同时，先达到该成绩的排名靠前 |
|
||
|
||
**"共Y人参加"统计口径**：
|
||
| 统计项 | 是否计入 |
|
||
|--------|----------|
|
||
| 已交卷学员 | ✅ 计入 |
|
||
| 正在考试中（未交卷） | ❌ 不计入 |
|
||
| 被分配但未参加 | ❌ 不计入 |
|
||
|
||
**排名示例**：
|
||
```
|
||
考试：安全规范考核
|
||
分配对象：部门A（30人）、部门B（20人）
|
||
|
||
参与情况：
|
||
- 部门A：25人已交卷，5人未参加
|
||
- 部门B：18人已交卷，2人正在考试中
|
||
|
||
排名统计：共 43 人参加（25 + 18 = 43）
|
||
|
||
排名结果：
|
||
第1名：张三（95分，首次达到时间 10:30）
|
||
第2名：李四（95分，首次达到时间 10:45）
|
||
第3名：王五（90分）
|
||
...
|
||
```
|
||
|
||
**实现建议**：
|
||
- 交卷时实时计算排名并返回
|
||
- 排名计算SQL示例思路：
|
||
```sql
|
||
SELECT user_id, MAX(score) as best_score, MIN(submit_time) as first_best_time
|
||
FROM ex_exam_record
|
||
WHERE exam_id = ? AND status = 'SUBMITTED'
|
||
GROUP BY user_id
|
||
ORDER BY best_score DESC, first_best_time ASC
|
||
```
|
||
|
||
#### 验收标准
|
||
- [ ] 只显示分配给当前学员的考试
|
||
- [ ] 考试状态、我的状态准确显示
|
||
- [ ] 不在时间窗口内无法进入考试
|
||
- [ ] 次数用完无法再次考试
|
||
- [ ] 答题过程中答案实时保存
|
||
- [ ] 刷新页面/重新进入可继续答题（断点续考）
|
||
- [ ] 倒计时准确，超时自动交卷
|
||
- [ ] 交卷后立即显示成绩和排名
|
||
- [ ] 答案解析正确显示
|
||
- [ ] 多次考试取最高分显示
|
||
- [ ] 🔴 定时任务每分钟执行，自动处理超时考试记录
|
||
- [ ] 🔴 并发交卷场景下数据一致（乐观锁机制）
|
||
- [ ] 🔴 排名实时计算，仅统计已交卷学员
|
||
- [ ] 🔴 排名规则：最高分优先，同分按首次达到时间排序
|
||
|
||
---
|
||
|
||
### 3.4 我的培训
|
||
|
||
#### 用户故事
|
||
> 作为学员，我希望查看分配给我的培训计划，跟踪学习进度，完成培训任务。
|
||
|
||
#### 功能清单
|
||
|
||
| 功能项 | 说明 |
|
||
|--------|------|
|
||
| 培训列表 | 展示分配给我的培训计划 |
|
||
| 培训详情 | 显示计划内容、学习进度 |
|
||
| 进度跟踪 | 实时显示知识学习、考试完成情况 |
|
||
| 完成判定 | 根据必修项判定培训是否完成 |
|
||
| 证书预留 | 培训完成后预留证书/徽章展示位置 |
|
||
|
||
#### 3.4.1 培训列表页
|
||
|
||
**列表字段**：
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| 培训名称 | 点击进入详情 |
|
||
| 培训周期 | 开始日期 ~ 结束日期 |
|
||
| 状态 | 未开始/进行中/已结束 |
|
||
| 我的进度 | 进度条 + 百分比 |
|
||
| 完成状态 | 未完成/已完成 |
|
||
|
||
#### 3.4.2 培训详情页
|
||
|
||
**页面结构**：
|
||
```
|
||
┌─────────────────────────────────────────────────────────┐
|
||
│ 2026年Q1安全规范培训 │
|
||
│ ───────────────────────────────────────────────────── │
|
||
│ 培训周期：2026-01-01 ~ 2026-03-31 │
|
||
│ 培训目标：掌握高速公路救援安全规范... │
|
||
│ 我的进度：████████░░░░ 75% │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ 📚 学习内容 (3/5) │
|
||
│ ├─ ✅ 高速救援SOP手册 [必修] [已完成] │
|
||
│ ├─ ✅ 安全操作视频 [必修] [已完成] │
|
||
│ ├─ 🔵 应急处理流程 [必修] [学习中 60%] │
|
||
│ ├─ ⚪ 设备使用指南 [选修] [未学习] │
|
||
│ └─ ✅ 案例分析 [选修] [已完成] │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ 📝 考试任务 (1/2) │
|
||
│ ├─ ✅ 安全规范考核 [必考] [已通过 85分] │
|
||
│ └─ ⚪ 操作技能测试 [必考] [未参加] │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ 🏆 完成奖励 │
|
||
│ └─ 完成培训后可获得【安全规范认证】徽章（敬请期待） │
|
||
└─────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
**进度计算规则**：
|
||
|
||
```
|
||
培训进度 = (已完成必修知识数 + 已通过必考考试数) / (必修知识总数 + 必考考试总数) × 100%
|
||
```
|
||
|
||
**完成判定规则**：
|
||
| 条件 | 说明 |
|
||
|------|------|
|
||
| 所有必修知识已完成 | ✓ |
|
||
| 所有必考考试已通过 | ✓ |
|
||
| 选修知识 | 不影响完成判定 |
|
||
| 选考考试 | 不影响完成判定 |
|
||
|
||
#### 验收标准
|
||
- [ ] 只显示分配给当前学员的培训计划
|
||
- [ ] 进度百分比计算准确（只计算必修项）
|
||
- [ ] 学习内容、考试任务分开展示
|
||
- [ ] 显示每项的必修/选修、必考/选考标签
|
||
- [ ] 点击知识内容可跳转到知识详情页
|
||
- [ ] 点击考试任务可跳转到考试页面
|
||
- [ ] 所有必修项完成后，培训状态变为"已完成"
|
||
- [ ] 证书/徽章区域预留（V1显示"敬请期待"）
|
||
|
||
---
|
||
|
||
### 3.5 个人中心
|
||
|
||
#### 用户故事
|
||
> 作为学员，我希望查看自己的学习记录、考试历史和获得的证书。
|
||
|
||
#### 功能清单
|
||
|
||
| 功能项 | 说明 |
|
||
|--------|------|
|
||
| 个人信息 | 显示姓名、部门、角色 |
|
||
| 学习统计 | 总学习时长、完成课程数 |
|
||
| 学习记录 | 知识学习历史列表 |
|
||
| 考试记录 | 考试历史列表 |
|
||
| 我的证书 | 证书/徽章展示（预留） |
|
||
|
||
#### 验收标准
|
||
- [ ] 正确显示当前用户信息
|
||
- [ ] 学习时长统计准确（累计所有知识学习时长）
|
||
- [ ] 学习记录按时间倒序展示
|
||
- [ ] 考试记录显示每次考试的详情
|
||
- [ ] 证书模块预留（V1显示"暂无证书"）
|
||
|
||
---
|
||
|
||
## 四、数据契约补充
|
||
|
||
### 4.1 新增/修改实体
|
||
|
||
#### 知识学习进度表 (km_knowledge_progress) - 新增
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| id | Long | 主键 |
|
||
| user_id | Long | 学员ID |
|
||
| knowledge_id | Long | 知识ID |
|
||
| department_id | Long | **🟡 新增** 所属部门（冗余字段，便于按部门统计） |
|
||
| status | Enum | 状态：NOT_STARTED/IN_PROGRESS/COMPLETED |
|
||
| progress | Integer | 进度百分比（0-100） |
|
||
| duration | Long | 学习时长（秒） |
|
||
| video_position | Long | 视频播放位置（秒），仅视频类型 |
|
||
| source | Enum | **🔴 新增** 学习来源：FREE/TRAINING |
|
||
| plan_id | Long | **🔴 新增** 关联培训计划ID（来源为TRAINING时有值） |
|
||
| start_time | DateTime | 首次学习时间 |
|
||
| complete_time | DateTime | 完成时间 |
|
||
| update_time | DateTime | 最后更新时间 |
|
||
|
||
#### 考试记录表 (ex_exam_record) - 补充字段
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| status | Enum | **新增** 状态：IN_PROGRESS/SUBMITTED |
|
||
| last_save_time | DateTime | **新增** 最后保存时间（断点续考用） |
|
||
| version | Integer | **🔴 新增** 乐观锁版本号 |
|
||
| submit_source | Enum | **🔴 新增** 交卷来源：USER/SYSTEM_TIMEOUT |
|
||
|
||
### 4.2 新增枚举
|
||
|
||
```java
|
||
// 学习状态
|
||
public enum LearningStatus {
|
||
NOT_STARTED, // 未学习
|
||
IN_PROGRESS, // 学习中
|
||
COMPLETED // 已完成
|
||
}
|
||
|
||
// 🔴 学习来源
|
||
public enum LearningSource {
|
||
FREE, // 自由学习（从知识库直接进入）
|
||
TRAINING // 培训任务学习（从培训计划进入）
|
||
}
|
||
|
||
// 考试记录状态
|
||
public enum ExamRecordStatus {
|
||
IN_PROGRESS, // 考试中（用于断点续考）
|
||
SUBMITTED // 已提交
|
||
}
|
||
|
||
// 🔴 交卷来源
|
||
public enum SubmitSource {
|
||
USER, // 用户主动交卷
|
||
SYSTEM_TIMEOUT // 系统超时自动交卷
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 五、接口预留（V2/V3功能）
|
||
|
||
### 5.1 证书/徽章接口（预留）
|
||
|
||
```
|
||
POST /api/certificate/generate # 生成证书
|
||
GET /api/certificate/my # 我的证书列表
|
||
GET /api/certificate/{id} # 证书详情
|
||
GET /api/badge/my # 我的徽章列表
|
||
```
|
||
|
||
### 5.2 错题本接口（V2预留）
|
||
|
||
```
|
||
GET /api/wrong-questions # 错题列表
|
||
POST /api/wrong-questions/review # 标记已复习
|
||
```
|
||
|
||
---
|
||
|
||
## 六、非功能需求
|
||
|
||
| 项目 | 要求 | 测试指标（🟡 优化项5） |
|
||
|------|------|------------------------|
|
||
| 页面加载 | 页面加载 < 2秒 | 95%请求 < 2秒 |
|
||
| 考试提交 | 考试提交 < 1秒 | 99%请求 < 1秒 |
|
||
| 并发支持 | 支持100人同时在线考试 | 100并发答题，响应时间 < 500ms，成功率 > 99.9% |
|
||
| 答案保存 | 答案自动保存 | 保存成功率 > 99.99%，保存延迟 < 300ms |
|
||
| 数据安全 | 考试答案定时自动保存，防止数据丢失 | 断网重连后数据无丢失 |
|
||
| 兼容性 | 支持主流浏览器 | Chrome 90+、Edge 90+、Firefox 90+ |
|
||
|
||
---
|
||
|
||
## 七、不做什么（Out of Scope）
|
||
|
||
| 功能 | 原因 |
|
||
|------|------|
|
||
| 移动端适配 | V1仅支持PC浏览器 |
|
||
| 防作弊功能 | 产品确认不需要 |
|
||
| 学习日历 | 产品确认不需要 |
|
||
| 错题本 | V2规划 |
|
||
| 社交功能（评论、点赞） | V3规划 |
|
||
|
||
---
|
||
|
||
## 八、页面清单（🟡 优化项3）
|
||
|
||
> **说明**：采用与管理端复用同一套系统的方案，按角色控制菜单和功能显示，不使用独立的 `/student/` 路径前缀。
|
||
|
||
| 页面 | 路径 | 角色可见 | 说明 |
|
||
|------|------|----------|------|
|
||
| 工作台 | /index.html | 全角色 | 根据角色显示不同内容 |
|
||
| 知识列表 | /knowledge/list.html | 全角色 | 学员只读，讲师可管理 |
|
||
| 知识详情 | /knowledge/view.html?id={id} | 全角色 | 学员增加学习进度记录 |
|
||
| 考试列表 | /exam/my-exams.html | 学员 | 我的考试列表 |
|
||
| 考试详情 | /exam/detail.html?id={id} | 学员 | 考试信息页 |
|
||
| 在线答题 | /exam/answer.html?id={id} | 学员 | 答题页面 |
|
||
| 考试结果 | /exam/result.html?recordId={id} | 学员 | 成绩结果页 |
|
||
| 培训列表 | /training/my-training.html | 学员 | 我的培训列表 |
|
||
| 培训详情 | /training/detail.html?id={id} | 学员 | 培训计划详情 |
|
||
| 个人中心 | /profile/index.html | 全角色 | 个人信息页 |
|
||
| 学习记录 | /profile/learning.html | 学员 | 学习记录列表 |
|
||
| 考试记录 | /profile/exam-history.html | 学员 | 考试记录列表 |
|
||
| 我的证书 | /profile/certificate.html | 学员 | 证书展示（预留） |
|
||
|
||
**菜单权限控制**：
|
||
| 菜单项 | 管理员 | 讲师 | 学员 |
|
||
|--------|--------|------|------|
|
||
| 工作台 | ✅ | ✅ | ✅ |
|
||
| 知识库 | ✅ 管理 | ✅ 管理 | ✅ 只读学习 |
|
||
| 考题管理 | ✅ | ✅ | ❌ |
|
||
| 试卷管理 | ✅ | ✅ | ❌ |
|
||
| 考试管理 | ✅ | ✅ | ❌ |
|
||
| 我的考试 | ❌ | ❌ | ✅ |
|
||
| 培训计划 | ✅ | ✅ | ❌ |
|
||
| 我的培训 | ❌ | ❌ | ✅ |
|
||
| 个人中心 | ✅ | ✅ | ✅ |
|
||
| 系统设置 | ✅ | ❌ | ❌ |
|
||
|
||
---
|
||
|
||
## 九、修订项对照表
|
||
|
||
| 修订项 | 类型 | 章节位置 | 状态 |
|
||
|--------|------|----------|------|
|
||
| 知识学习入口场景 | 🔴 必须修正 | 3.2.3 | ✅ 已补充 |
|
||
| 断点续考超时机制 | 🔴 必须修正 | 3.3.5 | ✅ 已补充 |
|
||
| 排名计算规则 | 🔴 必须修正 | 3.3.7 | ✅ 已补充 |
|
||
| 学习时长防刷机制 | 🟡 建议优化 | 3.2.4 | ✅ 已采纳 |
|
||
| 数据表department_id | 🟡 建议优化 | 4.1 | ✅ 已采纳 |
|
||
| 页面路径设计 | 🟡 建议优化 | 8 | ✅ 已调整 |
|
||
| 答案解析显示策略 | 🟡 建议优化 | 3.3.6 | ✅ 已明确 |
|
||
| 非功能需求测试指标 | 🟡 建议优化 | 6 | ✅ 已补充 |
|
||
|
||
---
|
||
|
||
**文档状态：✅ 已批准**
|
||
|
||
> **Supervisor 复审结论**：通过
|
||
> **复审日期**：2026-01-15
|
||
> **下一阶段**：技术评审 → 开发
|