# 管理员端理论试卷管理接口 页面路径为“管理员 → 智能考评 → 理论试卷管理”,接口统一使用 `/theoretical/paper/admin` 前缀。所有请求都必须携带 `Authorization`;服务端从JWT解析 用户并校验“管理员”角色,创建人、题量和总分不接受客户端指定。 部署前执行: ```text practical-business/src/main/resources/sql/theoretical_paper_management.sql ``` 状态代码为 `DRAFT`(草稿)、`PUBLISHED`(已发布)、`ARCHIVED`(已归档)。升级前的 历史试卷会回填为 `PUBLISHED`,只有已发布试卷会出现在新增考试的试卷下拉框中。 ## 1. 试卷库分页 `POST /theoretical/paper/admin/page` ```json { "pageNum": 1, "pageSize": 10, "search": "污水一级", "lev": "污水一级", "createType": "自动组卷", "status": "PUBLISHED" } ``` 返回项目统一 `TableDataInfo`。每行除主表字段外还包含: - `questionTypes`:按“判断题/单选题/多选题/主观题”顺序汇总; - `usageCount`:被考试计划引用的次数; - `statusLabel`:状态中文名称; - `editable`:没有考试引用时为 `true`; - `deletable`:没有考试引用且不是已发布状态时为 `true`。 ## 2. 预览和编辑回显 `GET /theoretical/paper/admin/{paperId}` 返回列表字段及 `theoreticalPaperDetailList` 完整题目。题目按题型和题号稳定排序。 ## 3. 自动组卷 规则预览: `GET /theoretical/paper/admin/auto-configuration?lev=污水三级` 返回 `paper_distribution` 抽题分布、`paper_rule` 每题配分、服务端计算的题量和总分。 确认创建: `POST /theoretical/paper/admin/auto` ```json { "lev": "污水三级", "name": "污水三级·理论大考卷", "passScore": 60, "sequence": "乱序", "status": "DRAFT" } ``` 抽题分布和配分只读取提交瞬间的数据库配置。若任一章/节可用题量不足、规则重叠抽到 重复题、总题量超过500或配分不完整,整个事务回滚,不会留下空试卷。 ## 4. 手动组卷 `POST /theoretical/paper/admin/manual` ```json { "lev": "污水一级", "name": "污水一级·理论摸底卷 A", "passScore": 60, "sequence": "顺序", "status": "PUBLISHED", "questions": [ { "type": "单选题", "problem": "示例题干", "optionA": "选项A", "optionB": "选项B", "optionC": "选项C", "optionD": "选项D", "answer": "A", "score": 2 } ] } ``` 支持判断题、单选题、多选题、主观题。服务端忽略题目中的 `id`、`paperId`、`sequence`, 按数组顺序重新编号,并根据每题 `score` 计算 `num` 和 `sum`。及格分为空时默认为总分的 60%。同一张试卷不允许重复题目。 ## 5. 编辑、复制与状态 - `PUT /theoretical/paper/admin/{paperId}`:请求体同手动组卷;未传 `status` 时保持原状态。 已被考试引用时禁止改题,页面应使用返回的 `editable` 控制按钮。 - `POST /theoretical/paper/admin/{paperId}/copy`:深复制主表和全部题目,名称自动追加 “(副本)”,新试卷固定为草稿且使用次数为0。 - `PUT /theoretical/paper/admin/{paperId}/status`:请求体为 `{"status":"ARCHIVED"}`。空试卷不能发布;已被使用的试卷不能退回草稿,但可以归档, 从而停止被新考试选择。 ## 6. 删除和导出 - `DELETE /theoretical/paper/admin/{paperId}`:仅可删除未发布且未被考试使用的试卷; 主表与题目明细在同一事务中删除。 - `GET /theoretical/paper/admin/{paperId}/export`:导出无答案Word。 - `GET /theoretical/paper/admin/{paperId}/export/answer`:导出带答案Word。 导出继续复用项目现有职级Word模板。当前模板覆盖判断题、单选题和多选题;包含主观题的 试卷应以前端预览为准,若需要主观题Word版需另外补充对应职级模板占位区。