# 教师端阅卷管理接口 所有接口统一使用前缀 `/exam/review`,并从请求头 `Authorization` 中解析当前登录教师。 客户端不能指定 `teacherId`;服务端仅允许考试字段 `chief_id` 为当前教师的任务被查询、评分或发布。 部署前请先执行 `src/main/resources/sql/exam_review.sql` 创建评分审计表。现有数据库还需包含项目原查询已经使用的 `exam.mark_flag` 与 `exam_student.mark_flag` 字段,其中 `0/null` 表示未发布,`1` 表示已发布。 ## 1. 阅卷任务列表 `POST /exam/review/tasks/page` ```json { "pageNum": 1, "pageSize": 10, "keyword": "期末考试", "status": "PENDING" } ``` `status` 支持 `ALL`、`PENDING`、`COMPLETED`。列表返回考试与班级 ID、考试名称、班级、已交卷份数、 已发布份数、截止时间及阅卷状态。只有至少一名考生已经交卷的考试会成为阅卷任务。 ## 2. 阅卷工作台考生列表 `POST /exam/review/students/page` ```json { "pageNum": 1, "pageSize": 20, "examId": 1001, "classId": 20, "keyword": "张三" } ``` `examId` 和 `classId` 都来自任务列表。服务端会校验二者关系;关键字可匹配姓名、身份证号或所属单位。 列表只返回已经交卷的考生。 ## 3. 获取考生试卷 `GET /exam/review/students/{examStudentId}/paper` 返回`examType`和考试类型对应的互斥明细。理论考试返回试卷元数据、题型汇总及`questions`; 实训考试返回第三方`practiceItems`,其中明细`id`用于后续保存评分,`questions`为空数组。 ## 4. 保存阅卷进度 `PUT /exam/review/students/{examStudentId}/scores` ```json { "scores": [ { "questionId": "19876543210001", "score": 6.5, "comment": "要点基本完整,缺少异常工况说明" } ] } ``` 理论考试可仅提交本次变化的主观题,并校验`0 <= score <= 题目满分`;实训考试可提交变化的项目, 校验单项非负且调整后汇总不超过考试总分。保存成功后写入审计日志, 但不会把暂存结果标记为正式发布。已发布的考生成绩不可再次修改。 ## 5. 发布成绩 `PUT /exam/review/tasks/{examId}/publish` 发布前会锁定本场考试及全部已交卷考生。理论考试校验试卷与主观题评分完整性;实训考试校验第三方明细存在并重新 汇总教师复核后的项目分数。随后更新`exam_student.score`并统一设置考生和考试的`mark_flag=1`,任一步失败都会回滚。 ## 6. 评分追溯记录 `GET /exam/review/students/{examStudentId}/history` 返回每次分数变化和最终发布操作,包括教师、题号、调整前后分数、评分说明及时间。教师只能查看本人阅卷任务中的记录。