# 教师端理论试卷管理接口 页面路径为“教师 → 智能考评 → 理论试卷管理”,接口统一使用 `/theoretical/paper` 前缀。所有请求必须携带 `Authorization`。服务端从JWT解析当前用户、 校验“教师”角色,并只允许访问 `creator_id` 等于当前教师ID的试卷;请求体中的用户字段 不会参与权限判断。 部署或升级前执行以下幂等脚本: ```text practical-business/src/main/resources/sql/theoretical_paper_management.sql ``` 脚本会增加教师归属字段和查询索引,并仅把 `create_user` 唯一匹配用户手机号的历史试卷 安全认领给对应用户。未匹配数据仍可由管理员维护,不会出现在任何教师的列表中。 状态代码为 `DRAFT`(草稿)、`PUBLISHED`(已发布)、`ARCHIVED`(已归档)。教师可以 直接发布本人试卷;试卷被考试计划引用后不能改题、删除或退回草稿,但仍可复制和归档。 ## 1. 本人试卷分页 `POST /theoretical/paper/page` ```json { "pageNum": 1, "pageSize": 10, "search": "污水一级", "lev": "污水一级", "createType": "自动组卷", "status": "PUBLISHED" } ``` 返回项目统一 `TableDataInfo`。每行包含题型汇总 `questionTypes`、考试引用次数 `usageCount`、状态中文名 `statusLabel`、可编辑标记 `editable`、可删除标记 `deletable` 和稳定归属字段 `creatorId`。分页总数只统计当前教师数据。 ## 2. 自动组卷 规则预览: `GET /theoretical/paper/auto-configuration?lev=污水三级` 确认创建: `POST /theoretical/paper/auto` ```json { "lev": "污水三级", "name": "污水三级·教师练习卷", "passScore": 60, "sequence": "乱序", "status": "DRAFT" } ``` 题量、抽题分布和配分只读取提交瞬间的数据库配置。题库不足、抽到重复题或规则不完整时 整个事务回滚,不会留下空试卷。状态为空时默认草稿,及格分为空时按总分60%计算。 ## 3. 手动组卷 `POST /theoretical/paper/manual` ```json { "lev": "污水一级", "name": "污水一级·课堂测验 A", "passScore": 60, "sequence": "顺序", "status": "DRAFT", "questions": [ { "type": "单选题", "problem": "示例题干", "optionA": "选项A", "optionB": "选项B", "optionC": "选项C", "optionD": "选项D", "answer": "A", "score": 2 } ] } ``` 支持判断题、单选题、多选题和主观题。服务端丢弃题目中的 `id`、`paperId` 和题号, 按数组顺序重新编号,并重新计算题量、总分和及格分;同一试卷不允许重复题目。 ## 4. 详情、编辑、复制和状态 - `GET /theoretical/paper/{paperId}`:本人试卷预览或编辑回显。 - `PUT /theoretical/paper/{paperId}`:请求体同手动组卷;已被考试引用时禁止编辑。 - `POST /theoretical/paper/{paperId}/copy`:深复制为当前教师的新草稿,名称自动追加副本。 - `PUT /theoretical/paper/{paperId}/status`:请求体为 `{"status":"ARCHIVED"}`。 详情和所有写操作对“不存在”和“非本人试卷”统一返回“试卷不存在或无权访问”,避免通过 试卷ID探测其他教师数据。复制只允许复制本人试卷,新副本固定归属于当前教师。 ## 5. 删除和导出 - `DELETE /theoretical/paper/{paperId}`:仅允许删除本人未发布且未被考试使用的试卷。 - `GET /theoretical/paper/{paperId}/export`:导出无答案Word。 - `GET /theoretical/paper/{paperId}/export/answer`:导出带答案Word。 导出前同样执行教师归属校验。Word继续使用项目现有职级模板;当前模板覆盖判断题、单选题 和多选题,包含主观题的试卷应以前端预览为准。 ## 6. 旧页面兼容路径 - `GET /theoretical/paper/auto` 复用当前正式组卷配置校验与汇总,并保留给已登录学员的模拟考场兼容调用;教师端优先使用 `/auto-configuration`。 - `POST /theoretical/paper/create` 接收旧 `CombinationDTO`,但忽略客户端 `num`、`sum`、 `createUser`、抽题分布和配分规则,服务端重新读取数据库规则;为保持历史行为固定创建 `PUBLISHED` 试卷,并继续返回布尔型 `data`。 - `GET /theoretical/paper/detail/{paperId}` 为详情别名。 - `GET /theoretical/paper/export/{paperId}` 和 `GET /theoretical/paper/export/answer/{paperId}` 为导出别名。 所有兼容路径都执行与新接口完全相同的JWT教师鉴权和数据归属校验。