Skip to content

考试微服务总览 ​

砚考把考试业务拆成 10 个微服务,每个服务对应考试全链路上的一个环节。这一页讲清楚它们的边界和谁调谁。

领域地图 ​

text
  题库 question ──┐
                  ├──▶ 试卷 paper ──▶ 考试管理 manage ──▶ 答题 answer
                  │                                          │
                  │                        ┌─────────────────┼──────────────┐
                  │                        ▼                 ▼              ▼
                  │                   阅卷 mark        防作弊 proctor   证书 cert
                  │                        │                               │
                  └────────────────────────┼───────────────────────────────┘
                                           ▼
                                      错题本 practice
                                           │
                                     统计 stat(旁路只读)

依赖方向严格单向

question ← paper ← manage ← answer ← mark,stat 只做旁路只读。 禁止反向调用(例如 question 不能去调 answer),这是这套微服务能单独扩容的前提。

各服务职责 ​

题库服务 ruoyi-exam-question : 9211 ​

项内容
包名org.dromara.exam.question
前缀/question
主表question、question_option、question_bank、question_bank_category
源码规模42 个类

负责题库的分类树归类、题目 CRUD、选项维护、标签打标、Excel 模板导入导出,以及组卷时的随机抽题接口。

  • 支持 9 种题型:单选、多选、判断、填空、简答、论述、代码、文件上传、匹配
  • 难度分 easy / medium / hard 三档
  • 导入采用「整批校验,失败整批回滚」策略
  • RemoteQuestionServiceImpl 以 Dubbo 暴露 RemoteQuestionService

试卷服务 ruoyi-exam-paper : 9212 ​

项内容
包名org.dromara.exam.paper
前缀/paper
主表paper、paper_question
源码规模18 个类

支持两种组卷方式:手工选题与按规则随机抽题(题库 + 题型 + 难度 + 数量 + 单题分值)。 组卷保存时,试题明细按传入顺序全量覆盖 paper_question——即每次保存是一次整体替换,不是增量追加。

考试管理服务 ruoyi-exam-manage : 9213 ​

项内容
包名org.dromara.exam.manage
前缀/exam、/invite
主表exam、exam_user、exam_invite
源码规模33 个类

考试计划的中枢,配置项最多:

  • 考试类型:正式(1)/ 练习(2)
  • 状态流:not_start 未开始 → ongoing 进行中 → finished 已结束 → archived 已归档
  • 参加方式:白名单(按部门选人)/ 公开链接(加入码 + 密码 + 有效期)
  • 时间控制:起止时间窗、限时、是否允许迟到与迟到分钟数、重考次数
  • 判分策略:答案展示时机、客观题部分得分开关与比例、答错扣分
  • 绑定:9 项防作弊规则、及格证书模板

加入码长度为 10,字符集刻意剔除了 0/1/I/O/l 等肉眼易混淆字符。

答题服务 ruoyi-exam-answer : 9214 ​

项内容
包名org.dromara.exam.answer
前缀/answer(内部 /record)
主表exam_record、exam_answer(独立库)
源码规模22 个类,含 7 个 @DubboReference

全链路并发最高的服务。对外只暴露 /answer/record/**,内部 Controller 路径是 /record/**。

关键设计:

能力实现
断点续答逐题自动保存;中途退出可从断点继续
自动判分客观题交卷即出分,三态:正确 / 半对 / 错误
超时兜底ExamTimeoutTask 定时任务,倒计时归零由服务端强制提交
重复交卷幂等设计,重复提交不产生多份成绩
时钟校准前端 useServerClock 对齐服务端时间,避免改本机系统时间作弊

成绩只有一处写入口

主观题得分由 mark 服务通过 writeBackMark 回写到 answer,其它服务不允许直接改 exam_record 的成绩字段。 排查成绩异常时只需盯这一条链路。

阅卷服务 ruoyi-exam-mark : 9215 ​

项内容
包名org.dromara.exam.mark
前缀/mark
主表exam_mark_task、exam_mark_item、exam_mark_log
源码规模23 个类

按「考试 → 答卷 → 逐题」三级组织人工阅卷。每次改分写 exam_mark_log,动作区分 create / score / rescore / ai / finish,可完整追溯谁在什么时候把哪道题从几分改到几分。

AI 预评接口已预留,当前实现为 DefaultMarkAiServiceImpl 本地兜底——调用会返回「未接入」。

统计服务 ruoyi-exam-stat : 9216 ​

项内容
包名org.dromara.exam.stat
前缀/stat
主表stat_exam_*(7 张预聚合表)
源码规模55 个类

最大的服务,也是唯一「重查询」服务。它不写业务数据,靠跨服务的影子实体(如 QuestionRef、ExamRef)在本地做映射,避免跨库 JOIN。

输出说明
大盘概览考试场次、参考人次、平均分、及格率
分数段分布分段直方图
考生明细与排名支持排除作废答卷
逐题分析正确率、难度、区分度
选项分布易错项识别
知识点掌握度薄弱分级

双重兜底的重算机制

汇总表每 10 分钟由 StatCalcScheduler 定时重算,同时提供手动重算接口。 数据不对时直接手动触发重算即可,不用等下一个周期。

错题本服务 ruoyi-exam-practice : 9217 ​

项内容
包名org.dromara.exam.practice
前缀/practice(内部 /wrong)
主表wrong_question、wrong_review_record
源码规模19 个类

交卷后,答错和半对的题目自动进错题本。支持按来源分组查看、重练(即时判分看解析)、记笔记、标记掌握、移出与恢复,并保留每次重做的历史。

证书服务 ruoyi-exam-cert : 9218 ​

项内容
包名org.dromara.exam.cert
前缀/cert
主表exam_certificate(模板)、exam_certificate_record(颁发记录)
源码规模19 个类

考试及格后自动颁发。模板支持占位符:

text
{nickName} {account} {examName} {score} {totalScore}
{passScore} {certNo} {issueDate} {expireDate}

支持印章、背景图、横竖版与有效期。证书墙区分「有效 / 已过期 / 已吊销」。

含主观题的卷子要等阅卷完才发证

这是为了避免先发证后改分导致证书成绩与实际不一致。cert 会等 mark 完成后再触发颁发。

防作弊服务 ruoyi-exam-proctor : 9219 ​

项内容
包名org.dromara.exam.proctor
前缀/proctor(StripPrefix=1)
主表exam_proctor_session、exam_proctor_event、exam_proctor_snapshot
源码规模27 个类

监控 13 类行为:切屏离屏、窗口失焦、复制/剪切/粘贴、右键、进出全屏、摄像头抓拍与拒权、开发者工具、多标签页等。

判定在服务端

前端的 useProctor 只负责把可疑动作报上去,计数、风险分级、是否强制交卷全部由后端算。 改前端 JS 绕不过去,这是设计上的取舍。

默认规则偏向「只记录、不强制」:

ts
{ switchScreen: 0, copyPaste: 1, camera: 0, fullScreen: 0,
  cameraInterval: 60, maxPaste: 0, maxExitFullscreen: 0, devtool: 1, multitab: 1 }

值为 0 表示不设上限(仅记录),需由考试管理员在配置里显式开启。

AI 服务 ruoyi-exam-ai : 9220 ​

Java 侧网关层,目前只有启动类 1 个 java 文件,无业务代码;ruoyi-api-exam-ai 也只有 package-info.java。

Python Agent (ruoyi-agent/ruoyi-exam-agent, :9221) 已完成四类能力:

text
POST /api/ai/question/generate   AI 出题
POST /api/ai/grade/auto          AI 阅卷
POST /api/ai/recommend/wrong     错题推荐
POST /api/ai/paper/analyze       试卷分析
GET  /health

Java 与 Python 之间走服务发现(ai.agent.service-name: ruoyi-exam-agent)+ REST,异步批量预留了 RocketMQ topic ai-agent-task(当前关闭)。

AI 尚未接线

AI 阅卷目前会返回「未接入」。这是已知的进行中工作,不是 bug。

边界外的东西 ​

有些能力没有独立成服务,别到处找:

能力归属
用户、角色、菜单、字典、租户ruoyi-system :9201
AI 模型配置表 ai_model_configruoyi-system :9201
文件上传、OSS、短信、邮件、SSEruoyi-resource :9204
定时任务执行端ruoyi-job :9203

下一步 ​

服务之间具体怎么调,见 服务间调用。

砚考 · 让每一次考试都经得起检验