中国 帮助

考试系统(exam)

装上下考试后怎么配题库与答题、考生从哪进、会员中心首页为什么只列公开考试安排。

考试系统(exam)
封面

> 本文整理自平台文档 docs/wujies/5.x/plugins/exam.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-cf42f6201d64-cover.svg)

应用编码 exam,本页对应应用版本 1.0.2(引擎要求 >=5.6.2 <6.0.0),许可 UNLICENSED 且需授权(licenseRequired),仓库 [wujies-exam-plugin](https://gitee.com/wujies/wujies-exam-plugin)。

exam 覆盖题库分类、题目、试卷、考试安排、考试记录与在线答题这条链路,dependencies 为空,可单独装。 答题动作要求登录,成绩与记录的读取归后台权限码,前台公开页由 cms 主题直出。 README 把这套前台口径写成「只公告、不考试」,site-styles/ 目前还没建,样式沿用主题的 .shop__*。

装它

任何部署可直接装。装成功后侧栏多一个「考试系统」,下面六项:

菜单路由需要的权限码
考试配置examSettingsexam:settings:list
题库分类categoryexam:category:list
题目管理questionexam:question:list
试卷管理paperexam:paper:list
考试安排planexam:plan:list
考试记录recordexam: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.practiceEnabledtrue是否放开练习模式
exam.showAnswerAfterSubmitfalse交卷后是否立刻显示答案,正式考试一般关
exam.defaultDurationMinutes60安排未填时长时的默认答题分钟数
exam.maxRetakeCount0允许重答次数,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 的平台消息能力,宿主侧不可用时返回空页
装完侧栏没有「考试系统」菜单树在登录时生成,重建入口见 [在部署里使用应用](/docs/wujies/5.x/platform/app-market/using-apps)

实现索引

项值
数据表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

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-cf42f6201d64-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容