exam-platform ｜ 「砚考」在线考试系统
友情提示
项目介绍
「砚考」是一款开箱即用的在线考试系统，覆盖 出题 → 组卷 → 考试 → 监考 → 阅卷 → 统计 → 发证 → 错题巩固 的完整闭环，支持学生、教师、管理员三种角色。
本仓库采用**单仓多模块（monorepo）**结构，同时保留两套代码：
old-exam/—— 旧版单体应用（Spring Boot 2.x），功能完整、已上线，体验地址见顶部exam-back/+exam-front/—— 新版微服务，当前主力开发方向，下文的「功能介绍」均指新版
新版基于 RuoYi-Cloud-Plus 2.6.2 重构，把考试业务拆成 10 个可独立部署的微服务（考试、题库、试卷、答题、阅卷、统计、证书、练习、监考、AI），服务间经 Nacos 注册发现、Dubbo 调用，网关统一鉴权限流。
它把考试里几件麻烦事做实了
- 组卷不用一道道挑 —— 除手工选题外，可按「题库 + 题型 + 难度 + 分值」配一条规则随机抽题，规则能保存复用，候选不足时提前提示
- 防作弊不是摆设 —— 切屏离屏、窗口失焦、复制剪切粘贴、右键、退出全屏、多标签页、开发者工具等 13 类行为全程记录并计数，摄像头定时抓拍留证；达到上限时由服务端判定强制交卷，改前端绕不过去，同时对考生透明展示规则与已用次数
- 判分不用干等 —— 客观题交卷即自动出分（正确 / 半对 / 错误三态），主观题按「考试 → 答卷 → 逐题」三级人工阅卷，每次改分留审计日志
- 考完立刻有数 —— 分数段分布、逐题正确率 / 难度 / 区分度、选项分布与易错项、知识点掌握度与薄弱分级；汇总表每 10 分钟定时重算兜底，也可手动重算
- 结果能沉淀 —— 及格自动颁发证书（模板支持占位符、印章、背景图、横竖版与有效期），答错和半对的题自动进入错题本，可反复重练、记笔记、标记掌握
- 答题不怕掉线 —— 逐题自动保存、中途退出可断点续答、倒计时归零自动交卷（前端主动提交 + 后端定时兜底双保险），重复交卷幂等
关于 AI
AI 能力正在接入中：Python Agent（ruoyi-exam-agent）已完成出题、阅卷、推荐、试卷分析四类能力，Java 侧网关与模型配置表已就绪，接线工作进行中，当前 AI 阅卷会返回「未接入」。
功能介绍
| 功能 | 功能描述 |
|---|---|
| 题库管理 | 题库的增删改查与导出，支持分类树归类、可见性（私有 / 公开）与草稿 / 正常 / 归档三态，可在题库内直接挂载和管理试题 |
| 试题管理 | 支持单选、多选、判断、填空、简答、论述、代码、文件上传、匹配共 9 种题型，含富文本题干与解析、难度、默认分值；提供 Excel 模板导入（整批校验，失败整批回滚并逐行提示）与导出 |
| 试卷管理 | 手工选题与按规则随机抽题两种组卷方式，规则可保存复用、候选不足时给出提示；可配总分与及格分、题目 / 选项乱序、自动判分与人工阅卷开关、部分得分与答错扣分 |
| 考试管理 | 正式 / 练习两类考试，可配时间窗、限时、迟到入场、重考次数、答案展示时机；考生准入支持白名单（按部门选人） 与公开链接（加入码 + 密码 + 有效期） 两种方式；含 9 项防作弊规则与证书模板绑定，支持保存并一键发布，并提供考试情况看板与导出 |
| 阅卷管理 | 客观题交卷即自动判分（区分正确 / 半对 / 错误三态），主观题按「考试 → 答卷 → 逐题」三级人工阅卷并记录改分日志；双评仲裁与 AI 预评已预留接口但尚未接入 |
| 考试统计 | 基于预计算汇总表并提供每 10 分钟定时重算兜底，输出大盘概览、分数段分布、考生明细与排名、逐题正确率 / 难度 / 区分度、选项分布与易错项、知识点掌握度与薄弱分级，支持手动重算与作废答卷不入统 |
| 考试记录 | 考生查看自己参加过的每一场考试与答卷，可按考试、类型、状态、是否及格筛选，并逐题回看自己的作答、正确答案、解析与得分 |
| 错题本 | 交卷后答错与半对的题目自动进入错题本，支持按来源分组查看、重练并即时判分看解析、记笔记、标记已掌握、移出与恢复，并保留每次重做的历史 |
| 错题管理 | 管理端错题维护页面尚未实现，当前错题能力集中在考生端错题本；基于题库 / 章节的刷题练习仍在规划中 |
| 我的证书 | 考试及格后自动颁发（含主观题的卷子待阅卷完成后再发，避免分数不一致），证书墙展示有效性标识（有效 / 已过期 / 已吊销）并支持打印；模板由管理端配置占位符、印章、背景、横竖版与有效期 |
| 监考中心 | 准实时监控（10 秒静默轮询）查看自己考试的监考会话、风险概览、事件流水与摄像头抓拍，考生进入答题页后自动产生记录 |
| 防作弊服务 | 检测切屏离屏、窗口失焦、复制 / 剪切 / 粘贴、右键、进出全屏、摄像头抓拍与拒权、开发者工具、多标签页等 13 类行为；规则由考试单独配置，达到上限时由服务端判定强制交卷（前端无法绕过），并向考生透明展示规则与计数 |
| AI服务 | 开发中：Java 网关与 AI 模型配置已就绪，Python Agent 已实现出题、阅卷、推荐、试卷分析四类能力，但尚未与 Java 侧接线，AI 阅卷目前返回「未接入」 |
项目展示
仓库结构
exam-platform/
├── old-exam/ # 旧版：单体 Spring Boot 考试系统后端（已上线）
├── exam-back/ # 新版：微服务后端（RuoYi-Cloud-Plus，开发中）
├── exam-front/ # 新版：前端（Vue3 + TS + Element Plus，开发中）
├── .gitignore
├── LICENSE
└── README.md
开发环境
| 工具 | 旧版 | 新版 | 下载 |
|---|---|---|---|
| JDK | 17 | 17 / 21 | https://www.oracle.com/cn/java/technologies/downloads/ |
| MySQL | 8 | 8 | https://dev.mysql.com/downloads/mysql/ |
| Redis | 7 | 7 | https://redis.io/download |
| Nacos | - | 2.x | https://nacos.io/ |
| Node | - | 18+ | https://nodejs.org/ |
软件架构图
版本说明 / 项目升级情况
本项目经历了一次架构升级，目前仓库中同时保留了新旧两个版本：
| 版本 | 目录 | 状态 | 架构 | 技术栈 |
|---|---|---|---|---|
| 旧版 | old-exam/ |
已上线，功能完整 | 单体应用（Spring Boot） | Spring Boot 2.x + MyBatis-Plus + Druid + Fastjson + EasyExcel |
| 新版 | exam-back/ + exam-front/ |
🚧 开发中 | 微服务（RuoYi-Cloud-Plus） | 后端：Spring Boot 3.x + Spring Cloud + Nacos + Dubbo + Sa-Token + MyBatis-Plus前端：Vue3 + TypeScript + Element Plus + Vite + Pinia |
升级背景：旧版基于 Spring Boot 单体架构开发，随着业务增长，在扩展性、可维护性方面遇到瓶颈。新版基于开源框架 RuoYi-Cloud-Plus 进行重构，采用微服务架构，将考试、试卷、题库、阅卷、统计等业务拆分为独立服务，便于独立部署与水平扩展。
旧版（old-exam）
- 路径：
old-exam/ - 单体 Spring Boot 应用，功能完整，已上线运行
- 包含：用户/班级/试卷/题库/考试/阅卷/证书/统计/公告/讨论/AI 阅卷等模块
新版（exam-back + exam-front）
- 后端：
exam-back/—— 基于 RuoYi-Cloud-Plus2.6.2的微服务后端 - 前端：
exam-front/—— 基于 Vue3 + TypeScript + Element Plus + Vite 的前端 - 微服务模块划分：考试管理（exam-manage）、试卷服务（exam-paper）、答题服务（exam-answer）、阅卷服务（exam-mark）、统计服务（exam-stat）、证书服务（exam-cert）、AI 服务（exam-ai）等
- 基础设施：Nacos（注册/配置中心）、Spring Cloud Gateway（网关）、Dubbo（RPC）、Sentinel（限流熔断）、Seata（分布式事务）、Redis、MySQL
- ⚠️ 注意：新版仍在开发中，部分功能尚未完善
联系方式
QQ群：群1:1034380536、群2:1098802068
微信公众号：程序员阿祥
最后
本项目还在开发当中，存在着 bug 还请谅解，也希望你加入到我们一起开发该项目
新版正在基于 RuoYi-Cloud-Plus 微服务框架进行重构升级
参与贡献
- Fork 本仓库
- 新建 Feat_xxx 分支
- 提交代码
- 新建 Pull Request
许可证
Copyright (c) 2018-2024 macrozheng