考试系统(exam)
装上下考试后怎么配题库与答题、考生从哪进、会员中心首页为什么只列公开考试安排。
应用编码 exam,本页对应应用版本 1.0.2(引擎要求 >=5.6.2 <6.0.0),许可 UNLICENSED 且需授权(licenseRequired),仓库 wujies-exam-plugin。
exam 覆盖题库分类、题目、试卷、考试安排、考试记录与在线答题这条链路,dependencies 为空,可单独装。
答题动作要求登录,成绩与记录的读取归后台权限码,前台公开页由 cms 主题直出。
README 把这套前台口径写成「只公告、不考试」,site-styles/ 目前还没建,样式沿用主题的 .shop__*。
装它
任何部署可直接装。装成功后侧栏多一个「考试系统」,下面六项:
| 菜单 | 路由 | 需要的权限码 |
|---|---|---|
| 考试配置 | examSettings | exam:settings:list |
| 题库分类 | category | exam:category:list |
| 题目管理 | question | exam:question:list |
| 试卷管理 | paper | exam:paper:list |
| 考试安排 | plan | exam:plan:list |
| 考试记录 | record | exam:record:list |
使用顺序固定:先建分类、录题目,把题组成试卷并 publish,再排考试安排(选试卷、定起止时间、设时长与参与范围)并 publish,考生在安排里答题,/exam/record/** 汇总成绩、统计与排行。
配它
「考试配置」页写的是 sys_config 里 config_category = 'exam' 的那批行,保存即生效,公开读取走宿主 GET /open/exam/config。题目字典与题库分类种子随迁移脚本发。
| 键 | 默认值 | 什么时候要改 |
|---|---|---|
exam.name / exam.nameEn / exam.description | 无界考试系统 / Wujie Examination System / 无界考试系统 | 对外品牌文案 |
exam.copyright / exam.icp | 见种子脚本 | 对外服务填自己主体的备案号 |
exam.logo / exam.favicon / exam.backgroundImage | 空 | 存的是 OSS 行 id,换部署后成死引用,需重传 |
exam.practiceEnabled | true | 是否放开练习模式 |
exam.showAnswerAfterSubmit | false | 交卷后是否立刻显示答案,正式考试一般关 |
exam.defaultDurationMinutes | 60 | 安排未填时长时的默认答题分钟数 |
exam.maxRetakeCount | 0 | 允许重答次数,0 表示只能交一次 |
用它
管理员在六张管理页维护题库、试卷与安排。「题目管理」支持 exam:question:import 的批量导入与模板下载,「考试记录」按 exam:record:list 查询、导出、看统计与排行。接口前缀 /exam/category、/exam/question、/exam/paper、/exam/plan、/exam/record,每条都挂 exam:* 权限码。
考生的答题入口在会员中心:/exam/online/** 一组接口(start 开始、paper 取卷、save-draft 存草稿、submit 交卷、record 看回放)全部只要求登录(@SaCheckLogin),不校验 exam:* 权限码,服务端按当前用户归属记录。
exam 没有给会员读的 /portal/exam/** 端点,成绩明细又落在 exam:record:list 权限之后,因此会员中心首页只能列出公开考试安排(GET /open/exam/plan/list,匿名可读,返回 { total, rows } 分页信封)。
首页取到 rows 后按状态与时间做本地筛选,这一屏说明的是「有哪些公开可报的考试」,个人成绩与答卷明细不在这屏。
这个降级是刻意设计,介绍时别把它说成个人考试数据。
公开端与前台直出页的过滤口径略有差异:/open/exam/plan/list 默认只按 plan_status 在 published/finished 内筛;前台 /site/exam 由 ExamPlanServiceImpl 的 buildPublicWrapper 额外要求 join_scope 为空或含 "type":"all",也就是「对所有人开放」的安排才进公告页,报名链接一律指向 /member/exam/online,绝对地址由主题的 cms.consoleUrl 拼。
前台的三档(未开始、进行中、已结束)是按 start_time / end_time 现算出来的,跟 plan_status 是两回事:后者是后台的发布状态,只用来把草稿与已撤回的安排挡在公网之外。收口任务只是尽力而为,一场三天前就截止的考试在库里可能仍是「已发布」,而这一屏是给人判断「现在还能不能考」的。库里「已结束」就是已结束,「已发布」再看一次结束时间,然后按开始时间分未开始与进行中(ExamSiteCard#stateOf)。
判法只准写一份。SQL 侧的 applyPublicState 与卡片侧的 stateOf 必须逐字对应,两处一旦分叉就是「筛『进行中』却筛出一行印着已结束」,看着像这一页坏了;同一次查询里所有条件共用同一个「此刻」,各自 new Date() 的话跨过整点的那一场能同时满足两档。详情页不在控制器里重判一次状态,走 queryPublicById 与列表同一个条件;不存在、草稿、指定人员三种情况出同一份 404。
ExamSiteCard 是前台两屏唯一的取数出口:列表行取 summaryFacts 那三条,详情取 detailFacts 加 description。joinScope(用户 ID 与部门 ID 的清单)、candidateCount、remark 与继承来的审计字段都不进这一层,这一屏匿名可看、链接可分享、会被搜索引擎收。卡片是 JavaBean:模板表达式按 getter 取值,record 的访问器读不出来。
报名范围用 LIKE 判 join_scope 里那段 JSON,没有另建布尔列:这一屏是十条量级,加一列要动表、动后台表单、回填历史数据,而 LIKE 判错的代价是少出一场考试。翻页参数 page 与搜索词 q 在控制器签名里收 String 再自己解析,写成 Integer 的话访客手滑改成字母就先撞上 Spring 的类型转换,浏览器收到的是一段 JSON 错误响应;这一页有主题版式、有空态、有 404 页,没有理由给出那种答案,所以 page=abc 按第一页处理。
出问题查什么
| 现象 | 先看 |
|---|---|
| 会员中心首页列不出考试 | /open/exam/plan/list 是否可达、有没有 published/finished 状态的安排,空数组多半是安排还没发布 |
前台 /site/exam 打不开 | 是否装了 cms;没有主题时这几屏本就不存在 |
| 某个安排前台公告页看不到但首页能拉到 | join_scope 是否设成「所有人」;/site/exam 比 /open/exam/plan/list 多这一道过滤 |
| 考生点了报名却进不去答题 | 答题要求登录,/exam/online/** 未登录会被挡,确认会员已登录 |
| 交卷后看不到答案 | exam.showAnswerAfterSubmit 是否为 false |
| 记录页 403 | /exam/record/** 需要 exam:record:list,给角色补权限码 |
| 导入题目报错 | 用「题目管理」的模板下载对照列头,导入需要 exam:question:import |
| 公告页没通知栏 | /open/exam/notice/list 走 SDK 的平台消息能力,宿主侧不可用时返回空页 |
| 装完侧栏没有「考试系统」 | 菜单树在登录时生成,重建入口见 在部署里使用应用 |
实现索引
| 项 | 值 |
|---|---|
| 数据表 | exam_question_category、exam_question、exam_paper、exam_plan、exam_record |
| 后台接口前缀 | /exam/category、/exam/question、/exam/paper、/exam/plan、/exam/record |
| 答题端 | /exam/online/**(@SaCheckLogin,无 exam:* 权限码,按当前用户归属记录) |
| 会员端 | 无 /portal/exam/**;会员中心首页读公开端 /open/exam/plan/list |
| 公开端 | /open/exam/plan/list、/open/exam/plan/{id}、/open/exam/notice/list(@SaIgnore) |
| 前台页 | /site/exam、/site/exam/{id},由 cms 主题直出,报名链接指向 /member/exam/online |
| 迁移脚本 | migrations/01-create-exam-tables.sql 到 04-create-exam-seed-data.sql |
| 源码 | cn/wujies/exam |
那五张表也是卸载时的删除依据:AppPurgeService 从迁移脚本解析 CREATE TABLE 得到「本应用声明的表」。迁移脚本一经执行内容不可改(摘要记账见 数据库迁移)。仓库根另有一个独立的 exam-dict.sql,建的字典与 migrations/02 相同(先 DELETE 再 INSERT),跑之前自己核一遍,别与迁移脚本重复执行。