# 管理员端理论题库管理接口 页面路径为“管理员 → 题库管理 → 理论题库”,接口统一使用 `/theoretical/library/admin` 前缀。所有请求必须携带 `Authorization`,服务端从 JWT 解析用户并校验“管理员”角色。部署前先执行: ```text practical-business/src/main/resources/sql/theoretical_library_management.sql ``` 该脚本可重复执行,除了为历史题目回填完整路径,还会迁移旧表中 `is_problem=false` 的章、节、目、点结构行,因此没有试题的空分支也会出现在树中。 题目历史字段缺级时会归入对应的“未分类章/节/目/知识点”节点。脚末的核查 SQL 应全部返回空结果,否则管理端树或分页接口会明确报告层级数据异常。 职级题库 `JOB` 固定为“工艺→职级→章→节→目→点”,竞赛题库 `COMP` 固定为 “竞赛类型→题目分类→题目方向”。节点编码在同题库、同父节点下唯一。 ## 1. 层级树与节点维护 - `GET /nodes/tree?bankType=JOB&keyword=污水`:返回嵌套树、完整路径及子树题量。 - `POST /nodes`:新增节点。根节点 `parentId` 传 `0` 或留空;`nodeType` 由服务端根据父节点计算。 - `PUT /nodes/{id}`:编辑名称、编码、排序、状态和备注,不允许改变父节点或题库。 - `PUT /nodes/{id}/move`:请求体 `{"direction":"UP"}` 或 `DOWN`。 - `PUT /nodes/{id}/status`:请求体 `{"status":0}` 或 `1`。 - `DELETE /nodes/{id}?cascade=true`:彻底删除子树及关联试题;未显式传 `true` 会拒绝。 节点新增示例: ```json { "bankType": "JOB", "parentId": "0", "name": "污水", "code": "CRAFT-WATER", "sortNo": 10, "status": 1, "remark": "污水处理工艺" } ``` ## 2. 试题查询与维护 题型代码为 `SINGLE`、`MULTI`、`JUDGE`、`FILL`、`SHORT`、`CALC`;难度代码为 `EASY`、`MEDIUM`、`HARD`。 `POST /questions/page` 使用项目统一 `TableDataInfo`: ```json { "pageNum": 1, "pageSize": 10, "bankType": "JOB", "nodeId": "末级或任意祖先节点ID", "type": "SINGLE", "keyword": "活性污泥", "status": 1, "createStart": "2026-08-01", "createEnd": "2026-08-31" } ``` 选择祖先节点时自动包含全部后代。列表和详情同时返回稳定代码、中文标签、完整层级路径、 结构化选项、`answerText`、关键词数组及 `noExam`。其中 `nodePath` 按根节点到末级节点 排列,并包含试题绑定的末级节点;它只返回级联回显所需的稳定节点字段: ```json { "fullPath": "污水 → 一级 → 第一章 → 第一节 → 第一目 → 知识点", "nodePath": [ {"id": "1", "parentId": "0", "nodeType": "CRAFT", "name": "污水", "code": "CRAFT-WATER"}, {"id": "2", "parentId": "1", "nodeType": "LEVEL", "name": "一级", "code": "LEVEL-1"}, {"id": "3", "parentId": "2", "nodeType": "CHAPTER", "name": "第一章", "code": "CH-1"}, {"id": "4", "parentId": "3", "nodeType": "SECTION", "name": "第一节", "code": "SEC-1"}, {"id": "5", "parentId": "4", "nodeType": "TOPIC", "name": "第一目", "code": "TOPIC-1"}, {"id": "6", "parentId": "5", "nodeType": "POINT", "name": "知识点", "code": "POINT-1"} ] } ``` 职级题库固定返回“工艺→职级→章→节→目→点”,竞赛题库固定返回 “竞赛类型→题目分类→题目方向”。节点不存在时 `nodePath` 返回空数组。 - `POST /questions/filter-ids`:同一筛选请求,返回页面“全选筛选结果”的 ID,最多 5000 条。 - `GET /questions/{id}`:预览和编辑回显。 - `POST /questions`、`PUT /questions/{id}`:新增或编辑。 - `POST /questions/{id}/copy`:复制为启用的新题,题干追加“(副本)”。 - `DELETE /questions/{id}`:彻底删除单题。 - `PUT /questions/batch/status`:`{"ids":["1"],"status":0}`。 - `PUT /questions/batch/transfer`:`{"ids":["1"],"targetNodeId":"末级节点ID"}`。 - `POST /questions/batch/delete`:`{"ids":["1","2"]}`。 新增单选题示例: ```json { "nodeId": "末级知识点ID", "type": "SINGLE", "score": 2, "difficulty": "MEDIUM", "status": 1, "noExam": false, "keywords": ["活性污泥", "重点"], "stem": "活性污泥法的核心处理单元是?", "options": [ {"text": "曝气池", "correct": true}, {"text": "消毒池", "correct": false} ], "analysis": "考查活性污泥法基本流程。" } ``` 选择题只允许 2–5 个选项;单选必须恰好一个正确答案,多选至少两个。判断、填空、简答、 计算题必须提交 `answer`。`noExam=true` 会保存为 `participate=false`,不会参与随机组卷。 ## 3. Excel 导入导出 - `GET /templates/{STRUCTURE|QUESTION}?bankType=JOB`:下载导入模板。 - `POST /imports`:`multipart/form-data`,字段为 `dataType`、`bankType`、`mode`、`file`。 `mode` 支持 `ADD` 和 `OVERWRITE`;仅允许 10MB 以内 `.xlsx`。 - 导入返回 `successCount`、`failureCount`、`errorFileId`;失败明细使用 `GET /imports/errors/{fileId}` 下载。 - `POST /exports`:导出层级或试题。 ```json { "dataType": "QUESTION", "bankType": "JOB", "scope": "FILTERED", "includeAnswer": false, "query": { "bankType": "JOB", "nodeId": "节点ID", "type": "SINGLE", "keyword": "污泥" } } ``` 结构覆盖按“题库+父节点编码路径+编码”匹配;试题覆盖按“题库+题号”匹配。结构文件必须 先放父节点、后放子节点。无答案导出会同时隐藏标准答案和解析。 ## 4. 旧接口兼容 原 `/theoretical/library` 分页、旧模板导入、编辑、删除和导出继续保留。旧格式导入完成后 服务端自动创建新节点并回填管理字段。随机组卷和模拟练习仍按原 `scope/章/节` 参数调用, 但只会抽取题目启用、允许组卷且所属节点整条祖先链均启用的数据。 其中 `POST /theoretical/library/import` 仍只接收原有的 `file` 表单字段,但必须携带管理员 `Authorization`。服务端从 JWT 获取当前管理员,并将其用户 ID 和可读名称同时记录到本次 导入的试题及新建层级节点;已存在节点的原创建人不会被覆盖。