# 管理员端考试管理接口 接口统一使用 `/exam/admin` 前缀。所有请求必须携带 `Authorization`,服务端从JWT解析 当前用户并校验 `phone_role.role_name=管理员`,不接受客户端提交管理员用户ID。 部署前依次执行: 1. `src/main/resources/sql/class_management.sql` 2. `src/main/resources/sql/exam_management.sql` 考试状态不写入数据库:开始前为 `UPCOMING`,开始后至“开始时间+时长”为 `ONGOING`, 之后为 `ENDED`。考试计划页只返回尚未结束的场次,历史成绩继续由成绩管理模块查询。 ## 1. 班级导航树 `GET /exam/admin/tree?keyword=污水` 返回 `OCCUPATION → YEAR → LEVEL → CLASS` 四层节点,结构与班级管理接口一致。班级叶节点 的 `classId` 用于后续计划、选项和新增请求。 ## 2. 班级考试计划 `GET /exam/admin/classes/{classId}` 返回班级名称、工种、年度、等级、培训日期、学期、学员人数和未结束考试数组。每场考试包括 开始时间、时长、总分/合格分、考评员、监考教师、试卷、考场、状态以及服务端计算的 `editable/deletable`,页面不能仅按本地时间决定是否允许操作。 ## 3. 表单选项 `GET /exam/admin/classes/{classId}/options` - `teachers`:未删除且具有教师角色的用户,首席考评员和监考教师共用。 - `papers`:`theoretical_paper.lev` 与班级等级名称完全一致的试卷;理论、实训考试共用。 - `students`:当前班级有效学员,包含身份证号、性别、手机号、单位和个人出勤率。 出勤率按 `NORMAL/LATE` 占 `NORMAL/LATE/ABSENT/LEAVE` 的百分比计算;没有有效记录时为 `null`,由页面展示为“—”。 ## 4. 考试详情 `GET /exam/admin/{examId}` 返回列表字段以及 `studentIds`。总分是创建时从试卷复制的快照,只读,不因试卷后续修改而 变化。 ## 5. 新增考试 `POST /exam/admin` ```json { "classId": 10, "name": "污水一级·2026秋·第一次理论考试", "type": "理论", "examTime": "2026-09-18 09:00:00", "duration": 90, "forbid": 30, "chiefExaminerId": "1900000000000000001", "invigilatorId": "1900000000000000002", "paperId": "1900000000000000100", "location": "教学楼A-301", "passScore": 60, "studentIds": ["1900000000000000201", "1900000000000000202"] } ``` - 类型只支持“理论”“实训”;考试日期必须位于班级培训起止日期内。 - 时长为15~600分钟;`forbid` 为0~考试时长。 - 试卷必须与班级等级一致,总分从试卷复制;`passScore` 不传时默认为总分的60%。 - 至少选择1名、最多500名班级学员,ID不得重复。 - 同班级、首席考评员、监考教师或任一应考学员的考试时间不能重叠。 - 同一班级内考试名称不能重复。 成功后返回完整考试详情。考试与应考关系在同一事务内保存,任一步失败都会回滚。 ## 6. 编辑考试 `PUT /exam/admin/{examId}` ```json { "name": "污水一级·2026秋·理论考试(一)", "type": "理论", "examTime": "2026-09-18 09:30:00", "duration": 90, "chiefExaminerId": "1900000000000000001", "location": "教学楼A-302", "passScore": 60 } ``` 编辑不改变试卷、总分快照、监考教师、禁止交卷时间或应考学员。考试已到开始时间,或任一 考生已开始、交卷、产生分数后禁止编辑。新的时间和教师安排仍会执行完整冲突校验。 ## 7. 删除考试 `DELETE /exam/admin/{examId}` 仅允许删除未到开始时间且无人开始/交卷/产生分数的考试。服务端在事务中先删除 `exam_student` 应考关系,再删除 `exam` 主记录;历史成绩和进行中考试不会被删除。