# 道路救援企业培训系统 - 产品需求文档 (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 // 已结束 } ``` --- **文档状态：已确认，等待开发启动**