云帆培训考试系统新手指南：从本地运行到组织第一场考试，一篇就够了
【免费下载链接】yftrain学习系统-在线考试系统 企业培训内训系统-企教培系统平台软件项目地址: https://gitcode.com/gh_mirrors/yf/yftrain
云帆培训考试系统（yftrain）是一款开源的多角色在线培训考试系统，集题库管理、在线考试、错题训练、用户与权限管理于一体，基于 SpringBoot + Shiro + Vue + MySQL 打造，特别适合企业内训、教培机构和个人快速搭建自己的在线考试平台。🎓
无论你是想部署一个内部培训考试平台，还是想学习考试系统的完整流程，这篇文章都能带你从"零"开始：先完成本地运行，再亲手组织出第一场考试。
一、云帆考试系统能做什么？功能全景一图看懂
先建立整体认知：本系统的角色和功能分为三大块 👇
- 系统功能：考生/教师/管理员多角色登录、用户管理、角色管理、部门管理、系统日志
- 教师功能（管理端）：题库管理、试题管理（单选/多选/判断/简答，支持题目与选项图片）、考试规则设置（总分、及格线、时长）、从题库便捷组卷、在线阅卷
- 学员功能：在线考试、错题训练、考试记录与试卷详情
- 手机端：扫码考试、试卷预览、查看成绩
💡 防作弊设计：组卷时可指定题库、题量与分值，题目和选项随机排序，让每份试卷都不同。
相关功能说明可参考 exam-vue/src/assets/ 目录下的资料与 docs/源码说明.pdf。
二、五步完成本地运行（最快配置方法）
1. 克隆仓库并准备环境
先获取源码：
git clone https://gitcode.com/gh_mirrors/yf/yftrain环境要求很简单：
- JDK 1.8+
- MySQL 5.7+（官方运行包已提供 docs/运行包/ 中的可执行 jar，无需自己编译）
2. 导入数据库脚本
用任意数据库工具（如 SQLyog、Navicat、DBeaver）新建数据库，然后导入项目自带的初始化脚本：docs/安装资源/数据库脚本.sql。
该脚本会创建完整的表结构，包括考试主表、试卷表、题库表、试题表、用户/部门/角色表等 20 余张表，并预置了演示数据，导入即可用。
3. 修改外置配置文件
打开 docs/运行包/application-local.yml，只需改两处：
| 配置项 | 说明 |
|---|---|
spring.datasource.url / username / password | 改成你自己的 MySQL 连接信息 |
conf.upload.dir | 改成你电脑上真实存在的上传目录，如d:/exam-upload/ |
这是"jar 包 + 外置配置"的部署方式，配置与程序分离，升级时只需替换 jar 包，非常方便。
4. 一键启动
- Windows：双击运行 docs/运行包/start.bat
- Linux：执行 docs/运行包/start.sh
启动脚本本质上就是一行命令：以指定配置启动exam-api.jar。
5. 验证成功，记住两套账号
浏览器访问http://localhost:8101，看到登录页即部署成功 🎉
| 角色 | 账号 | 密码 | 用途 |
|---|---|---|---|
| 管理员 | admin | admin | 题库、考试、用户管理 |
| 学员 | person | person | 在线考试、错题训练 |
📌 详细步骤见 docs/运行包/运行说明.txt；Windows 用户还可用 docs/注册Windows服务/ 中的
yf-exam.exe install把它注册成系统服务，开机自启，告别"黑窗口"。
三、组织第一场考试：完整操作流程
系统跑起来后，作为管理员只需三步就能发起一场考试。
第一步：建题库，录入试题
- 在题库管理中新建题库（如"新员工入职题库"）
- 在试题管理中录入题目，支持单选、多选、判断、简答题型，题目和选项都可以上传图片
对应前端页面在 exam-vue/src/views/qu/，后端试题模块位于 exam-api/src/main/java/com/yf/exam/modules/qu/。
第二步：新建考试，从题库便捷组卷
在考试管理中创建考试，核心配置项包括：
- 开放范围：完全公开 / 指定部门可见（定员考试）
- 时间规则：是否限时、开始与结束时间
- 考试规则：总分、及格分数、考试时长
- 组卷方式：引用题库，指定题量与每题分值，系统自动随机抽题、题目与选项随机排序
- 保密设置：可设置私密考试/口令，只有输入口令的学员才能参加
第三步：学员作答、自动评分与错题训练
学员用person/person登录后即可看到考试列表：
- 进入考试后系统自动倒计时，交卷即自动批改客观题
- 试卷状态流转清晰：考试中 → 待阅卷（主观题）→ 已完成，甚至包括弃考状态，枚举定义见 exam-api/src/main/java/com/yf/exam/modules/paper/enums/PaperState.java
- 考完后学员可以查看试卷详情，并通过错题训练反复巩固薄弱点
四、常见问题与进阶路线
Q1：启动后访问 8101 端口无反应？检查application-local.yml中数据库连接是否正确、conf.upload.dir目录是否存在。
Q2：如何把系统装到服务器长期运行？阅读 docs/部署手册.pdf，Windows 下可注册为系统服务，Linux 下建议配合 systemd 管理。
Q3：想深入了解数据库设计？查阅 docs/数据表结构.pdf，核心业务表前缀为el_（exam 考试、qu 试题、repo 题库、paper 试卷）。
Q4：如何扩展功能？前后端分离结构清晰：exam-api为 SpringBoot 后端，exam-vue为 Vue 前端，模块按exam（考试）、qu（试题）、paper（试卷）、sys（系统）、user（学员）划分，可参考 docs/源码说明.pdf 上手二次开发。
🚀小结：云帆培训考试系统用"运行包 + 外置配置"的方式把部署门槛降到了最低——导入脚本、改两个配置、双击启动，几分钟即可在本地跑起一套完整的企业培训内训系统。建好题库、组好卷，你的第一场在线考试就可以开始了！
【免费下载链接】yftrain学习系统-在线考试系统 企业培训内训系统-企教培系统平台软件项目地址: https://gitcode.com/gh_mirrors/yf/yftrain
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
