中国 帮助

考试系统

官方 付费 应用

Wujies 无界平台(wujies.cn)的考试应用,一个插件一个仓库:后端 Maven 模块在仓库根,

v1.0.4 1 次安装 本季度 1 次

<p> <a href="https://wujies.cn" target="_blank" rel="nofollow"> <img width="100" src="https://wujies.cn/brand/logo-stacked.svg" alt="Wujies 无界 logo"> </a> </p>

<p><b>考试系统</b>,题库分类、题目、试卷、考试安排、考试记录与在线答题,另带前台公告页与开放接口。</p> <p> <a rel="nofollow"><img alt="应用版本" src="https://img.shields.io/badge/app-1.0.4-111111?style=flat-square"></a> <a rel="nofollow"><img alt="应用编码" src="https://img.shields.io/badge/code-exam-0057FE?style=flat-square"></a> <a rel="nofollow"><img alt="License" src="https://img.shields.io/badge/license-commercial-orange?style=flat-square"></a> <br> <a rel="nofollow">功能特性</a> <a rel="nofollow">预览</a> <a rel="nofollow">安装</a> <a rel="nofollow">设置</a> <a rel="nofollow">常见问题</a> <a href="https://docs.wujies.cn/docs/wujies/5.x/platform/plugin" rel="nofollow">插件开发</a> <a href="https://gitee.com/wujies" rel="nofollow">Gitee</a> </p>


Wujies 无界平台(wujies.cn)的考试应用,一个插件一个仓库:后端 Maven 模块在仓库根, 前端远程应用在 frontend/。

  • 后台:应用市场装上后多一个「考试系统」菜单,下挂考试配置 / 题库分类 / 题目管理 / 试卷管理 / 考试安排 / 考试记录六屏(exam:*:list 等按钮权限),前端是远程应用(frontend/,42 个文件)。 后端路由 /exam/plan、/exam/question、/exam/category、/exam/paper、/exam/record、/exam/online。
  • 前台:两个由 CMS 主题直出的公开页 —— /site/exam(安排列表)、/site/exam/{id}(单场考试详情), 模板在本仓库 src/main/resources/site-templates/(见「公开页与自带样式」)。公开页只公告、不考试: 答题那三屏由本插件提供,路由挂在后台会员中心(/member/exam/online/{planId})。
  • 对外开放接口:/open/exam/plan/list、/open/exam/plan/{planId}、/open/exam/notice/list,给 C 端列表用。

应用编码 exam | 应用版本 1.0.4 | 后端构件 wujies-exam-plugin | 清单 type = app | 引擎 &gt;=5.6.2 &lt;6.0.0

✨ 功能特性

  • 🗂️ 题库分类 — 树形分类(/exam/category/list、/options),题目按分类归集。
  • 📝 题目管理 — 题干、题型、难度、选项 JSON、答案 JSON、解析、知识点、分值;Excel 导入(含模板下载, 兼容两种导入格式 ExamQuestionImportVo / ExamQuestionLegacyImportVo)与导出。
  • 📄 试卷管理 — 试卷名 / 编码 / 时长 / 总分 / 及格分 / 题量 / 组卷规则 / 题目清单(questionIds), 支持发布与撤回(/publish/{id}、/revoke/{id})。
  • 📅 考试安排 — 绑定试卷、起止时间、时长、应考人数、参与范围(joinScope:全员 / 指定用户 / 指定部门), 支持发布、结束与 POST /scope-count 预演范围人数。
  • 🧾 考试记录 — 记录分页、详情、统计(/stats)、排名(/ranking)与导出。
  • 🖊️ 在线答题 — 开考、取卷、存草稿、交卷判分(/exam/online/{start,paper,save-draft,submit,record}); 前端三屏 exam/online/exam(作答)、exam/online/practice(练习)、exam/online/result(结果)。
  • ⏱️ 状态自动推进 — ExamPlanStatusTask 每分钟(cron = "0 */1 * * * ?")把到点的安排推进到下一个状态。
  • ⚙️ 考试配置 — 「考试配置」两页(业务设置 / 站点设置),菜单 exam-settings。
  • 🔎 前台公告两屏 — 安排列表按状态(未开始 / 进行中 / 已结束)与关键词筛选,详情页整页 noindex。
  • 🌐 开放接口 — /open/exam/** 三个端点,匿名可读,租户口径与宿主 /open/** 一致。
  • 🔐 多租户 — exam_plan 等业务表是租户表,过滤由宿主拦截器统一收口。

📸 预览

考试系统主界面

![考试系统主界面](docs/screenshots/exam.png)

🚀 安装

环境要求

| 项 | 要求 | |---|---| | 平台版本 | &gt;=5.6.2 &lt;6.0.0(app.json 的 engine) | | 后端构建 | JDK 17+(父 POM 的 java.version 为 17) | | 前端构建 | Node.js 18+(建议 20 LTS 及以上),npm | | 安装方式 | 管理端「应用市场 → 本地安装」上传 zip,或由上架中心(wujies-market)发布后拉取 |

从应用市场安装

  1. 打开管理端「应用市场 → 本地安装」,上传打包好的 zip;或经上架中心发布后由平台拉取。
  2. 安装时按文件名顺序执行 migrations/ 下 4 个脚本:建表(5 张)→ 字典 → 站点配置 → 种子数据。
  3. 装完刷新菜单,出现「考试系统」六屏即成功。

包里两个产物的路径由 app.json 的 assets 决定: frontend → frontend/index.js | backend → backend/wujies-exam-plugin-1.0.4.jar。

从源码构建

在本仓库根打包(三条命令各管一段,都在本仓库根执行):

powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 -CheckOnly   # ① 打包前检查:清单/产物/迁移/菜单/密钥,几秒返回
powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 -Dev         # ② 开发包:不签名,落 ..\.plugin-dist\exam\dev
powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1              # ③ 正式包:构建 + 用 keys\private.pem 签名

关于上面三条命令的取值口径:

  • 判据是「脚本所在仓库根有没有 app.json」,所以在本仓库里不要传 -Plugin(它按子目录找清单, 会报「找不到插件目录」);-FrontendProject / -FrontendDist 也不用传 —— 独立布局的前端工程固定就是 本仓库 frontend/、产物 frontend/dist,脚本自己跑 npm run build(首次先 cd frontend &amp;&amp; npm install, 缺依赖时脚本会把这条命令直接报给你)。只想复用现成产物就加 -SkipBuild。
  • -SkipFrontend 只用于没有前端的纯后端应用:带前端时它会连「复制前端产物」一起跳过, 出的包只有 app.json,装上去没有界面。本应用前后端都有,任何时候都别加它。
  • -CheckOnly 打出的 CHECK|级别|项|说明 行就是管理端「开发工具 → 插件开发 → 打包」抽屉里那份体检清单, 两边跑的是同一套检查;有 ERROR 时正式打包会被直接拦下。签名密钥在本仓库 keys/ (private.pem + public.pem,已在 .gitignore 里),生成或更换用 -Keygen (覆盖已有密钥要显式加 -KeygenForce,旧钥先整份备份进 keys\backup\&lt;时间戳&gt;\)。 参数全表与产物结构见文档站「打包应用」与「密钥与签名」两页。

手工构建(不用打包脚本时):

mvn -B -o package -DskipTests                # 后端(前提见「常见问题」里的父 pom 一条)
cd frontend &amp;&amp; npm install &amp;&amp; npm run build  # 前端,产物 dist/index.js + assets/exam-app.css

最快的开发路子不用打包、不用重启宿主:启动平台宿主,打开管理端「开发工具 → 插件开发」, 找到 exam 这一行点「启动后端」(自动编译并加载 target/classes,同时开启监听)与「启动前端」 (常驻 vite build --watch,保存源码即重建,刷新页面生效,没有 HMR)。全流程见 文档站「插件开发」。

升级与卸载

  • 升级:换 app.json 的 version 后重新打包上传;已执行过的迁移脚本不可改内容(账本按 (app_code, script) 记 checksum,换行 CRLF/LF 差异已豁免),加表结构就新增脚本。
  • 卸载:管理端「应用市场」里卸载。表名清单同时是卸载删表的唯一依据(平台从 migrations/ 里解析 CREATE TABLE),所以新加表要新增脚本,别往里写 sys_* / app_* 平台表。
  • ⚠️ 迁移脚本是目录扫描执行的(按文件名排序),app.json 的 migrations 数组留空是正确写法, 不是漏写;脚本平铺在 migrations/ 根下,子目录里的 .sql 后端扫不到。

⚙️ 设置

运行期配置分两处:

  • 后台「考试系统 → 考试配置」(菜单 exam-settings,组件 remote:exam/exam/settings): 两页 —— 业务设置(settings/business)与站点设置(settings/website),走宿主的系统参数能力。
  • 站点配置种子:migrations/03-create-exam-website-config.sql 写 sys_config(config_category = exam), 供公开接口 GET /open/<code>/config 一类的站点读取路径使用。
  • 字典:migrations/02-create-exam-dictionaries.sql 写题型等字典(sys_dict_type / sys_dict_data)。

菜单入口

| 菜单 | 路径 | 组件键 | 权限前缀 | |---|---|---|---| | 考试配置 | exam/examSettings | remote:exam/exam/settings | exam:settings:list | | 题库分类 | exam/category | remote:exam/exam/category | exam:category:list | | 题目管理 | exam/question | remote:exam/exam/question | exam:question:list | | 试卷管理 | exam/paper | remote:exam/exam/paper | exam:paper:list | | 考试安排 | exam/plan | remote:exam/exam/plan | exam:plan:list | | 考试记录 | exam/record | remote:exam/exam/record | exam:record:list |

按钮(type=F)在五屏下各 5 个:query / add / edit / remove / export,逐字对应 exam:&lt;模块&gt;:&lt;动作&gt;(「考试配置」没有 F 行)。合计 1 个 M + 6 个 C + 25 个 F。

前端还注册了一组不在菜单里的视图键(由宿主静态路由指过来):exam/questionEdit、exam/paperEdit、 exam/planEdit、exam/recordDetail、exam/recordStats、exam/settings/business、exam/settings/website、 exam/online/{exam,practice,result}。

后端接口:/exam/{category,question,paper,plan,record,online}/** 共 45 条、/open/exam/** 3 条、 /site/exam 两屏 —— 合计 50 条映射。

🧩 依赖与插件支持

| 项 | 说明 | |---|---| | 依赖插件 | 无(app.json 的 dependencies 为空数组);但公开页的壳与在线答题的宿主路由分别来自 cms 与会员中心 | | CMS 主题 | 两个公开页由 CMS 主题渲染,壳(头 / 尾 / 导航)经 SDK 的 SiteRenderApi 借用 | | 平台存储 | 不涉及上传存储;Excel 导出直接写响应流 | | 服务定位器 | fallback/ExamServiceLocator 配 META-INF/spring/...AutoConfiguration.imports(宿主侧按类型取插件服务的标准写法,缺这个文件宿主启动会报 No qualifying bean) | | 公共 API | 前端走打进包内的 @wujies/api-client,运行期由宿主 import map 提供 vue / element-plus / @wujies/ui-shared 单例 |

公开页与自带样式

site-templates/ 里那两个模板由 CMS 主题渲染:本插件的 ExamSiteRender 经 SDK 的 SiteRenderApi 向内容中心(cms)借头/尾/导航的壳,ExamSiteController(类级 @RequestMapping(ExamSiteLinks.PUBLIC_BASE), PUBLIC_BASE = /site)只负责 @SaIgnore + produces=text/html;charset=UTF-8 出整页。

这一屏还没有自己的样式文件:src/main/resources/site-styles/ 在本仓库不存在,列表那一列整屏沿用主题的 .shop__* 类与 data-cms-shop 钩子(版式照 wujies-mall-plugin 的 shop.html)。样式与静态资源端点下沉进 插件这一步只在图床跑通了,口径见 wujies-gallery-plugin README 的同名小节。

页面上钉死的几条口径(都在 ExamSiteController / ExamSiteLinks / ExamSiteCard 的类注释里):

  • 筛选与分页走 query 而不是路径段:state(闭集三档 upcoming / ongoing / ended)、q(搜索词)、page; 空值整段不拼,第一页不带 page,带条件或翻页一律 noindex。
  • 左栏只有状态这一组,是写死的枚举:这一档不在库里,是拿开始与结束时间跟此刻算出来的(ExamPublicState), 没有可现查的那一列;第二组(试卷、题量档)刻意没有。
  • 状态按时间重算,不信 plan_status:前台列表卡的状态胶囊由 ExamSiteCard 给类名 —— 还能考的两档描黑(filter__chip filter__chip--on),已结束的退回灰边(filter__chip),不让人误读成「点得动」。
  • 每屏条数钉死 LIST_LIMIT = 10:PageQuery 不带参数时 pageSize = Integer.MAX_VALUE,不钉住就是一次全表扫描。
  • 答题、保存草稿、交卷、判分一律出站到后台会员中心 /member/exam/online/{planId}:那五个接口 全带 @SaCheckLogin,匿名 SSR 请求没有可写的身份。所以 ExamSiteLinks.JOIN_BASE 只交路径, 绝对地址由主题的 cms.consoleUrl 拼。
  • 公开口径与 /open/exam/plan/list 不是一条:这一页还要求「面向全员」(指定用户/部门的安排不公开, 见 ExamPlanServiceImpl#buildPublicWrapper)。租户口径沿用宿主拦截器:exam_plan 是租户表。

开发环境

git clone git@gitee.com:wujies/wujies-exam-plugin.git
cd wujies-exam-plugin

打包脚本:本仓库自带完整的 package.ps1(母本在 wujies-plugins 仓库根,各仓用 node scripts/sync-package-script.mjs 同步过来),clone 下来就能在本仓库根直接体检、构建、签名、出包、 生成密钥,不需要回到单体仓库,也不需要手工传产物路径。

前端 SDK:已迁到已发布的 @wujies/* SDK(ui-shared / components / api-client / ui-plugin-bundler-kit)。frontend/vite.config.ts 只声明 defineRemoteApp({ appCode, root }), 共享依赖一律 external、运行期由宿主 import map 兜到同一份实例;宿主独有工具与业务模块 (@/utils/wujies、@/api/system/*、UserSelect/MemberSelect 等)按原样复制进了 frontend/src/, proxy?.$modal / useDict / download 与 ImageUpload/UserDetail/Module*Settings 由宿主运行时提供。 本仓库前端可独立构建;要直接落位到宿主,构建前设 WUJIES_FRONTEND_DIST=/app-market-dist/remote-apps。

仓库布局

| 位置 | 内容 | |---|---| | pom.xml | Maven 模块(父 pom = cn.wujies.plugins:wujies-plugins-parent,` 已置空,父版本 1.0.0;本模块未写自己的 version`) | | app.json | 应用清单,打包器读的唯一事实来源(code / version / menus / assets) | | src/ | Java 源码(67 个文件):6 个后台 controller + open/ + site/、5 个 service + 2 个 impl、5 个 Mapper、domain/bo/vo、task/、fallback/ | | src/main/resources/mapper/exam/*.xml | 5 份 MyBatis 映射,随插件 jar 走 | | migrations/ | 4 个脚本:01 建表(exam_paper / exam_plan / exam_question / exam_question_category / exam_record)、02 字典、03 站点配置、04 种子数据 | | exam-dict.sql | 仓库根单放的一份字典脚本(先 DELETE 再 INSERT sys_dict_type / sys_dict_data,tenant_id='000000'),与 migrations/02 是两个文件、写的表相同 —— 仓库里没写明以哪份为准,跑之前自己核一遍 | | src/main/resources/site-templates/ | 公开页直出的模板 exam-list.html、exam-detail.html(见上一节) | | frontend/ | 远程应用源码(src/ 42 个文件),入口 frontend/src/index.ts,15 个视图键 | | docs/screenshots/exam.png | 「预览」那一张 | | package.ps1、package.cmd、keys/ | 打包脚本与包签名密钥(keys/ 已 gitignore,不入库) |

❓ 常见问题

Q:陌生人 clone 后 mvn package 报找不到 wujies-plugins-parent? 父 pom、wujies-common-* 与兄弟插件构件目前只有本地 mvn install 出来的版本,还没发布到 Maven 仓库。本机装过就能通,本机实测 mvn -B -o package -DskipTests 通过。

Q:pom.xml 落出来的 jar 是 wujies-exam-plugin-1.0.0.jar,清单却写 1.0.4? 打包脚本按 artifactId 前缀找 target 里的 jar,再按清单改成 backend/wujies-exam-plugin-1.0.4.jar, 出包不受影响。但清单版本与 pom 版本该对齐:version、assets.backend、frontend/src/index.ts 的 manifest.version 三处一起改,脚本不会替你对账。

Q:exam-dict.sql 和 migrations/02-create-exam-dictionaries.sql 都写字典,跑哪个? 两个文件写的表相同、来源不同(前者是仓库根的历史单文件,后者进包按迁移执行)。全新安装走 migrations/ 那一份即可;真要手工补字典,先核对两份的键值再执行,别两个都跑一遍。

Q:公开页上看得到安排,点「参加考试」跳到后台登录页? 公开页只公告。答题接口(/exam/online/** 五个)都带 @SaCheckLogin,匿名 SSR 没有身份;跳转地址由主题的 cms.consoleUrl + /member/exam/online/{planId} 拼出,会员中心没装这一屏就打不开。

Q:公开页状态跟后台 plan_status 不一致? 公开页按时间重算(ExamPublicState),不信库里的 plan_status;后台那个状态由 ExamPlanStatusTask 每分钟推进一次,两处口径本来就不是同一个来源。

Q:打包时提示「找不到插件目录」? 在本仓库根不要传 -Plugin —— 脚本按「仓库根有没有 app.json」判定布局,传了它就去找子目录清单。

Q:前端构建产物里有裸 vue 之类的 import,会不会找不到? 正常。vue / element-plus / @wujies/ui-shared 由宿主 import map 提供单例,属于刻意 external。

Q:宿主启动报 No qualifying bean 指向 ExamServiceLocator? 本仓 src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 必须存在且写全限定名;只有 @AutoConfiguration 注解不够。

🔒 隐私与外部资源

  • 不收集、不上报任何遥测;题库、试卷、安排与考试记录都存本平台数据库。
  • 公开页只展示「面向全员」的安排,指定用户/部门的安排不进公开列表;联系方式类字段不在公开页出现。
  • 前端不引第三方统计脚本;远程应用只经宿主 import map 取共享依赖。
  • README 与仓库中不包含任何真实口令、token 或私钥;包签名密钥只在本机 keys/(已 gitignore)。

📄 许可证与致谢

商业授权:需要一枚覆盖本应用的有效授权凭证才允许安装与加载(条文见仓库根目录 LICENSE)。 清单 app.json 里 license 为 UNLICENSED、licenseRequired 为 true;三档口径(社区版 / 专业版 / 企业版) 见官网文档「授权与版本」。

💬 反馈与建议

参考

wujies-hello-plugin(已按新布局跑通前端独立构建的样板)、 wujies-ui(npm 上 @wujies/* 四件套的源码仓)、 wujies-gallery-plugin(公开页样式已下沉进插件的那一版)、 文档站「插件开发」章节。 </code>

v1.0.4 2026-11-08 平台 >=5.6.2 <6.0.0 320 KB

修复

  • 题库批量导入改逐行 insert,修复插件 Mapper 反查失败
  • 同步公钥检查——开源仓 yml 只有环境变量占位符时改比部署仓 keys/package-public.pem

其他

  • exam 1.0.3 —— 版本号与包内 jar 名同步
  • 注释瘦身(保留 ≤3 行 why 与文档指针)
v1.0.3 2026-11-08 平台 >=5.6.2 <6.0.0 320 KB

patch 升级 1.0.3

v1.0.1 2026-10-01 平台 >=5.6.2 <6.0.0 278 KB

这个版本没有写更新日志。

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