# 管理员端实操试卷规则接口 页面位置为“管理员 → 智能考评 → 试卷管理 → 实操试卷规则”。部署时先执行 `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`,页面应直接依据这三个布尔值显示操作按钮。 ## 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读取,不会随新增规则或学员职级变化。