# 管理员端实操试卷规则接口 页面位置为“管理员 → 智能考评 → 试卷管理 → 实操试卷规则”。部署时先执行 `sql/exam_management.sql`,再执行 `sql/practice_paper_rule.sql`。后者会创建规则主表、 明细表和考试教师关系表,并把原一级至五级规则迁移为污水、污泥完整职级规则。 状态仅有 `DRAFT`(草稿)和 `PUBLISHED`(已发布)。草稿可编辑、发布和删除;已发布 规则不可编辑或退回草稿,但未被考试使用时仍可删除。任何被考试引用的规则均不可删除。 ## 1. 规则列表 `POST /theoretical/paper/admin/practice/page` ```json {"pageNum":1,"pageSize":10,"name":"默认","lev":"污水一级","status":"PUBLISHED"} ``` `lev` 使用系统中启用的完整职级,污水一级与污泥一级分别查询各自独立的规则。列表返回 `id/name/lev/grade/totalQuestionCount/totalDuration/totalScore/status/statusLabel/usageCount` 以及 `publishable/editable/deletable`;其中 `lev` 是完整职级,`grade` 是用于复用标准类目的 一级至五级后缀,页面应直接依据这三个布尔值显示操作按钮。 ## 2. 新建、详情和编辑 - `GET /theoretical/paper/admin/practice/catalog?lev=污水一级`:返回该标准等级的全部类目、 `catalogId`和默认数值,供新建表单初始化。 - `POST /theoretical/paper/admin/practice`:创建草稿。 - `GET /theoretical/paper/admin/practice/{ruleId}`:返回主表和全部标准类目明细。 - `PUT /theoretical/paper/admin/practice/{ruleId}`:仅允许编辑草稿。 新建和编辑请求示例: ```json { "name": "一级实操规则A", "lev": "污水一级", "ruleList": [ {"catalogId": 1, "assessmentDuration": 20, "score": 20, "questionCount": 1}, {"catalogId": 2, "assessmentDuration": 20, "score": 20, "questionCount": 0} ] } ``` 必须回传详情中该等级的全部标准类目,不能跨等级混用 `catalogId`。裸的“一级~五级”、 不存在或已停用的完整职级均会被拒绝。每项时间为1~600 分钟、配分大于0且不超过99999.99,所有类目的题量合计必须为1~5。题量、总时间和总分 由服务端计算,客户端提交同名字段不会作为事实来源。同一完整职级内规则名称不能重复, 污水与污泥同等级可以分别使用相同规则名称。 ## 3. 发布与删除 - `PUT /theoretical/paper/admin/practice/{ruleId}/status`,请求体固定为 `{"status":"PUBLISHED"}`;只有草稿可以发布。 - `DELETE /theoretical/paper/admin/practice/{ruleId}`;草稿和已发布规则均可调用,但使用次数 必须为0。 旧版 `/practice/auto-configuration` GET/PUT 已移除,不再按职级覆盖唯一配置。 ## 4. 考试使用 `GET /exam/admin/classes/{classId}/options` 的 `practiceRules` 只包含与班级完整职级匹配的 已发布规则。实训考试提交 `practiceRuleId`,服务端从规则复制总分到考试快照。学员最近 考试的 `practiceRule` 也按考试保存的规则ID读取,不会随新增规则或学员职级变化。