{ "openapi": "3.0.1", "info": { "title": "知识管理系统 API 文档", "description": "基于 Spring Boot 3 + MyBatis-Plus 的企业级知识管理系统，提供文件管理、考试管理、错题管理、知识库检索、AI流式问答等功能。新增特性：题目批改功能优化，支持字段å\u0085¼å®¹æ€§å¤„理（is_correct/correct）、自动生成feedback反馈、完善五种题型（单选/多选/判断/填空/主观）的批改逻辑", "contact": { "name": "开发团队", "email": "dev@example.com" }, "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.html" }, "version": "2.11.0" }, "servers": [ { "url": "http://localhost:8080/api", "description": "本地开发服务器" } ], "security": [ { "Bearer Authentication": [ ] } ], "tags": [ { "name": "部门管理", "description": "部门的增删改查操作" }, { "name": "数据同步验证", "description": "验证错题与批é˜\u0085系统之间的数据同步机制" }, { "name": "错题管理", "description": "错题查看、收藏、重练、导出接口" }, { "name": "FAQ管理", "description": "常见问题及建议管理接口" }, { "name": "角色管理", "description": "角色和权限的管理接口" }, { "name": "认证管理", "description": "用户登录、登出、获取用户信息" }, { "name": "知识库路由", "description": "知识库路由调试接口" }, { "name": "图片管理", "description": "知识库图片相å\u0085³æŽ¥å£" }, { "name": "AI数据接口", "description": "专门为AI端提供的数据查询接口" }, { "name": "用户管理", "description": "用户的增删改查操作" }, { "name": "文件权限管理", "description": "文件权限的授权和撤销" }, { "name": "AI对话", "description": "AI智能对话接口" }, { "name": "题目管理", "description": "题目的增删改查管理接口" }, { "name": "正式考试", "description": "正式考试相å\u0085³æŽ¥å£ï¼Œä»\u0085供被分é\u0085äº†æ­£å¼è¯•å·çš„用户使用" }, { "name": "正式考管理", "description": "正式考管理接口，供管理员预览、保存、发布正式考试试卷" }, { "name": "反馈管理", "description": "用户反馈相å\u0085³æŽ¥å£" }, { "name": "知识检索", "description": "知识库检索相å\u0085³æŽ¥å£" }, { "name": "文件管理", "description": "文件的上传、下载、删除等操作" }, { "name": "知识库管理", "description": "向量库和文档的CRUD操作，与AI端同步" }, { "name": "报告管理", "description": "反馈统计报告相å\u0085³æŽ¥å£" }, { "name": "知识库访问控制", "description": "查询collection表中的记录，获取用户可访问的知识库列表" }, { "name": "日志管理", "description": "操作日志的查询" }, { "name": "考试管理", "description": "题目生成与答案批改接口" } ], "paths": { "/user": { "put": { "tags": [ "用户管理" ], "summary": "更新用户", "description": "更新用户基本信息", "operationId": "updateUser", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserUpdateRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "用户管理" ], "summary": "创建用户", "description": "创建新用户，默认密码为123456", "operationId": "createUser", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserCreateRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/user/{id}/status": { "put": { "tags": [ "用户管理" ], "summary": "更新用户状态", "description": "启用或禁用用户", "operationId": "updateStatus", "parameters": [ { "name": "id", "in": "path", "description": "用户ID", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "status", "in": "query", "description": "状态：1启用 0禁用", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/user/{id}/roles": { "put": { "tags": [ "用户管理" ], "summary": "分é\u0085ç”¨æˆ·è§’色", "description": "为用户分é\u0085è§’色", "operationId": "assignRoles", "parameters": [ { "name": "id", "in": "path", "description": "用户ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "array", "description": "角色ID列表", "items": { "type": "integer", "format": "int64" } } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/user/{id}/reset-password": { "put": { "tags": [ "用户管理" ], "summary": "重置密码", "description": "重置用户密码为默认密码123456", "operationId": "resetPassword", "parameters": [ { "name": "id", "in": "path", "description": "用户ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/role/{id}": { "put": { "tags": [ "角色管理" ], "summary": "更新角色", "description": "更新角色信息", "operationId": "updateRole", "parameters": [ { "name": "id", "in": "path", "description": "角色ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RoleUpdateRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "角色管理" ], "summary": "删除角色", "description": "根据ID删除角色", "operationId": "deleteRole", "parameters": [ { "name": "id", "in": "path", "description": "角色ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/role/{id}/permissions": { "get": { "tags": [ "角色管理" ], "summary": "查询角色权限", "description": "获取角色的所有权限", "operationId": "getRolePermissions", "parameters": [ { "name": "id", "in": "path", "description": "角色ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListPermissionVO" } } } } } }, "put": { "tags": [ "角色管理" ], "summary": "分é\u0085æƒé™", "description": "为角色分é\u0085æƒé™", "operationId": "assignPermissions", "parameters": [ { "name": "id", "in": "path", "description": "角色ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "array", "items": { "type": "integer", "format": "int64" } } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/question/{id}": { "get": { "tags": [ "题目管理" ], "summary": "获取题目详æƒ\u0085", "description": "根据题目ID获取题目详细信息", "operationId": "getQuestionById", "parameters": [ { "name": "id", "in": "path", "description": "题目ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultQuestion" } } } } } }, "put": { "tags": [ "题目管理" ], "summary": "更新题目", "description": "更新题目信息，支持部分字段更新", "operationId": "updateQuestion", "parameters": [ { "name": "id", "in": "path", "description": "题目ID（支持Long类型的id或UUID格式的questionId）", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuestionUpdateRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultQuestion" } } } } } }, "delete": { "tags": [ "题目管理" ], "summary": "删除题目", "description": "根据ID删除题目", "operationId": "deleteQuestion", "parameters": [ { "name": "id", "in": "path", "description": "题目ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/question/review/{questionId}": { "put": { "tags": [ "题目管理" ], "summary": "审核题目", "description": "审核通过或拒绝题目", "operationId": "reviewQuestion", "parameters": [ { "name": "questionId", "in": "path", "description": "题目UUID", "required": true, "schema": { "type": "string" } }, { "name": "status", "in": "query", "description": "审核状态：approved/rejected", "required": true, "schema": { "type": "string" } }, { "name": "reviewerComment", "in": "query", "description": "审核评论", "required": false, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/image/{id}": { "get": { "tags": [ "图片管理" ], "summary": "获取图片详æƒ\u0085", "description": "根据图片ID获取图片详细信息", "operationId": "getImageById", "parameters": [ { "name": "id", "in": "path", "description": "图片ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultImage" } } } } } }, "put": { "tags": [ "图片管理" ], "summary": "更新图片记录", "description": "更新图片记录信息，支持部分字段更新", "operationId": "updateImage", "parameters": [ { "name": "id", "in": "path", "description": "图片ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImageUpdateRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultImage" } } } } } }, "delete": { "tags": [ "图片管理" ], "summary": "删除图片", "description": "根据ID删除图片记录", "operationId": "deleteImage", "parameters": [ { "name": "id", "in": "path", "description": "图片ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/file/{id}": { "get": { "tags": [ "文件管理" ], "summary": "查询文件详æƒ\u0085", "description": "根据ID查询文件详细信息", "operationId": "getFileById", "parameters": [ { "name": "id", "in": "path", "description": "文件ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultFileVO" } } } } } }, "put": { "tags": [ "文件管理" ], "summary": "更新文件信息", "description": "更新文件的å\u0085¬å¼€çŠ¶æ€ã€æè¿°ç­‰ä¿¡æ¯", "operationId": "updateFileInfo", "parameters": [ { "name": "id", "in": "path", "description": "文件ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileUpdateRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultFileVO" } } } } } }, "delete": { "tags": [ "文件管理" ], "summary": "删除文件", "description": "软删除文件，同时级联软删除该文件对应的所有题目", "operationId": "deleteFile", "parameters": [ { "name": "id", "in": "path", "description": "文件ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } } } } }, "/file/permission/{id}/expire": { "put": { "tags": [ "文件权限管理" ], "summary": "更新权限过期时间", "description": "修改权限的过期时间", "operationId": "updateExpireTime", "parameters": [ { "name": "id", "in": "path", "description": "权限ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExpireTimeRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/faq/{id}": { "get": { "tags": [ "FAQ管理" ], "summary": "获取FAQ详æƒ\u0085", "description": "根据ID获取FAQ详细信息", "operationId": "getFAQById", "parameters": [ { "name": "id", "in": "path", "description": "FAQ ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultFAQ" } } } } } }, "put": { "tags": [ "FAQ管理" ], "summary": "更新FAQ", "description": "更新FAQ信息，支持部分字段更新", "operationId": "updateFAQ", "parameters": [ { "name": "id", "in": "path", "description": "FAQ ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FAQUpdateRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultFAQ" } } } } } }, "delete": { "tags": [ "FAQ管理" ], "summary": "删除FAQ", "description": "根据ID删除FAQ", "operationId": "deleteFAQ", "parameters": [ { "name": "id", "in": "path", "description": "FAQ ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/department/{id}": { "put": { "tags": [ "部门管理" ], "summary": "更新部门", "description": "更新部门信息", "operationId": "updateDepartment", "parameters": [ { "name": "id", "in": "path", "description": "部门ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DepartmentUpdateRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "部门管理" ], "summary": "删除部门", "description": "根据ID删除部门", "operationId": "deleteDepartment", "parameters": [ { "name": "id", "in": "path", "description": "部门ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/department/{id}/manager": { "put": { "tags": [ "部门管理" ], "summary": "设置部门管理员", "description": "为部门设置管理员", "operationId": "setDepartmentManager", "parameters": [ { "name": "id", "in": "path", "description": "部门ID", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "managerId", "in": "query", "description": "管理员用户ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/collection/{name}": { "put": { "tags": [ "知识库管理" ], "summary": "修改向量库", "description": "更新AI端向量库信息并同步到knowledge_base_path表", "operationId": "updateCollection", "parameters": [ { "name": "name", "in": "path", "description": "向量库名称", "required": true, "schema": { "type": "string" } }, { "name": "displayName", "in": "query", "description": "显示名称", "required": false, "schema": { "type": "string" } }, { "name": "department", "in": "query", "description": "所属部门", "required": false, "schema": { "type": "string" } }, { "name": "description", "in": "query", "description": "描述", "required": false, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultCollectionVO" } } } } } }, "delete": { "tags": [ "知识库管理" ], "summary": "删除向量库", "description": "删除AI端向量库并从knowledge_base_path表移除", "operationId": "deleteCollection", "parameters": [ { "name": "name", "in": "path", "description": "向量库名称", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/collection/{name}/chunks/{chunkId}": { "put": { "tags": [ "知识库管理" ], "summary": "修改切片", "description": "更新指定切片的å†\u0085容或å\u0085ƒæ•°æ®", "operationId": "updateChunk", "parameters": [ { "name": "name", "in": "path", "description": "向量库名称", "required": true, "schema": { "type": "string" } }, { "name": "chunkId", "in": "path", "description": "切片ID", "required": true, "schema": { "type": "string" } }, { "name": "content", "in": "query", "description": "新å†\u0085容", "required": false, "schema": { "type": "string" } }, { "name": "section", "in": "query", "description": "章节信息", "required": false, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } } } }, "delete": { "tags": [ "知识库管理" ], "summary": "删除切片", "description": "从向量库中删除指定切片", "operationId": "deleteChunk", "parameters": [ { "name": "name", "in": "path", "description": "向量库名称", "required": true, "schema": { "type": "string" } }, { "name": "chunkId", "in": "path", "description": "切片ID", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/wrong-questions/redo": { "post": { "tags": [ "错题管理" ], "summary": "生成错题重练试卷", "description": "根据错题生成重练试卷，支持按题型、收藏状态筛选", "operationId": "redoWrongQuestions", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WrongQuestionRedoRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultExamPaperGenerateResponse" } } } } } } }, "/wrong-questions/list": { "post": { "tags": [ "错题管理" ], "summary": "获取错题列表", "description": "分页获取用户错题列表，支持按题型、收藏状态、时间范围、知识库筛选", "operationId": "getWrongQuestions", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WrongQuestionListRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultWrongQuestionListResponse" } } } } } } }, "/wrong-questions/export": { "post": { "tags": [ "错题管理" ], "summary": "导出错题", "description": "导出用户错题为CSV格式", "operationId": "exportWrongQuestions", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WrongQuestionListRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK" } } } }, "/wrong-questions/collection/toggle": { "post": { "tags": [ "错题管理" ], "summary": "收藏/取消收藏错题", "description": "收藏或取消收藏指定的错题，支持添加备注", "operationId": "toggleCollection", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WrongQuestionCollectRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/wrong-questions/collection/list": { "post": { "tags": [ "错题管理" ], "summary": "获取收藏的错题列表", "description": "获取用户收藏的所有错题，支持分页", "operationId": "getCollectedWrongQuestions", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WrongQuestionListRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultWrongQuestionListResponse" } } } } } } }, "/search": { "post": { "tags": [ "知识检索" ], "summary": "混合检索", "description": "在知识库中进行混合检索（向量+å\u0085³é”®è¯ï¼‰", "operationId": "search", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SearchRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } } } } }, "/role": { "get": { "tags": [ "角色管理" ], "summary": "查询角色列表", "description": "获取所有角色信息", "operationId": "listRoles", "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListRoleVO" } } } } } }, "post": { "tags": [ "角色管理" ], "summary": "创建角色", "description": "创建新角色", "operationId": "createRole", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RoleCreateRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/question": { "post": { "tags": [ "题目管理" ], "summary": "创建题目", "description": "创建新的题目记录", "operationId": "createQuestion", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuestionCreateRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultQuestion" } } } } } } }, "/question/stats": { "post": { "tags": [ "题目管理" ], "summary": "题目数量统计", "description": "按不同维度统计题目数量", "operationId": "getQuestionStats", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuestionStatsRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultQuestionStatsResponse" } } } } } } }, "/kb-route": { "post": { "tags": [ "知识库路由" ], "summary": "测试知识库路由", "description": "测试知识库路由逻辑，用于调试路由策略", "operationId": "route", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KBRouteRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } } } } }, "/image": { "post": { "tags": [ "图片管理" ], "summary": "创建图片记录", "description": "创建新的图片记录", "operationId": "createImage", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImageCreateRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultImage" } } } } } } }, "/formal-exam/paper/{paperId}/start": { "post": { "tags": [ "正式考试" ], "summary": "开始正式考试", "description": "通过试卷ID开始正式考试，系统自动查找或创建考试记录，返回试卷题目å†\u0085容", "operationId": "startExamByPaperId", "parameters": [ { "name": "paperId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultExamRecordResponse" } } } } } } }, "/file/upload": { "post": { "tags": [ "文件管理" ], "summary": "上传文件", "description": "上传文件到服务器，支持个人文件和部门制度文件", "operationId": "uploadFile", "parameters": [ { "name": "deptId", "in": "query", "description": "部门ID（管理员上传制度文件时指定）", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "isPublic", "in": "query", "description": "是否å\u0085¬å¼€", "required": false, "schema": { "type": "boolean", "default": true }, "example": true }, { "name": "description", "in": "query", "description": "文件描述", "required": false, "schema": { "type": "string" } }, { "name": "autoVectorize", "in": "query", "description": "是否自动向量化", "required": false, "schema": { "type": "boolean", "default": false }, "example": false } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "file" ], "type": "object", "properties": { "file": { "type": "string", "description": "文件对象", "format": "binary" } } } } } }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultFileVO" } } } } } } }, "/file/rag/stream": { "post": { "tags": [ "文件管理" ], "summary": "RAG流式问答", "description": "向RAG服务发起流式问答请求，实时返回处理过程，完成后自动保存到数据库", "operationId": "ragStream", "parameters": [ { "name": "message", "in": "query", "description": "用户问题", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "text/event-stream": { "schema": { "$ref": "#/components/schemas/SseEmitter" } } } } } } }, "/file/permission": { "post": { "tags": [ "文件权限管理" ], "summary": "授权文件权限", "description": "为用户或部门授予文件访问权限", "operationId": "grantPermission", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FilePermissionRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/file/audit/reject/{id}": { "post": { "tags": [ "文件管理" ], "summary": "审核拒绝文件", "description": "管理员拒绝用户上传的å\u0085¬å¼€æ–‡ä»¶", "operationId": "rejectFile", "parameters": [ { "name": "id", "in": "path", "description": "文件ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/file/audit/approve/{id}": { "post": { "tags": [ "文件管理" ], "summary": "审核通过文件", "description": "管理员审核通过用户上传的å\u0085¬å¼€æ–‡ä»¶", "operationId": "approveFile", "parameters": [ { "name": "id", "in": "path", "description": "文件ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/feedback": { "post": { "tags": [ "反馈管理" ], "summary": "提交反馈", "description": "用户提交对AI回答的反馈", "operationId": "submitFeedback", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FeedbackCreateRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } } } } }, "/faq": { "get": { "tags": [ "FAQ管理" ], "summary": "获取FAQ列表", "description": "分页获取常见问题列表", "operationId": "getFAQList", "parameters": [ { "name": "page", "in": "query", "description": "页码，默认1", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "description": "每页大小，默认20", "required": false, "schema": { "type": "integer", "format": "int32", "default": 20 } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultFAQListResponse" } } } } } }, "post": { "tags": [ "FAQ管理" ], "summary": "创建FAQ", "description": "创建新的常见问题", "operationId": "createFAQ", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FAQCreateRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultFAQ" } } } } } } }, "/faq/suggestions/{id}/reject": { "post": { "tags": [ "FAQ管理" ], "summary": "拒绝FAQ建议", "description": "拒绝某个FAQ建议", "operationId": "rejectSuggestion", "parameters": [ { "name": "id", "in": "path", "description": "建议ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/faq/suggestions/{id}/approve": { "post": { "tags": [ "FAQ管理" ], "summary": "批准FAQ建议", "description": "将FAQ建议批准为正式FAQ，可修改答案", "operationId": "approveSuggestion", "parameters": [ { "name": "id", "in": "path", "description": "建议ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/exam/record/{recordId}/grade": { "post": { "tags": [ "考试管理" ], "summary": "提交考试并批改（正式考试专用）", "description": "通过考试记录ID提交正式考试答案并批改", "operationId": "gradeExamRecord", "parameters": [ { "name": "recordId", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExamSaveRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultExamRecordResponse" } } } } } } }, "/exam/paper/{paperId}/start": { "post": { "tags": [ "考试管理" ], "summary": "开始考试（获取题目）", "description": "通过试卷ID开始模拟考试，同时返回试卷题目å†\u0085容", "operationId": "startExamByPaperId_1", "parameters": [ { "name": "paperId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultExamRecordResponse" } } } } } } }, "/exam/paper/generate": { "post": { "tags": [ "考试管理" ], "summary": "生成试卷", "description": "根据权限范围从题库中动态生成试卷", "operationId": "generatePaper", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExamPaperGenerateRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultExamPaperGenerateResponse" } } } } } } }, "/exam/grade": { "post": { "tags": [ "考试管理" ], "summary": "批改答案（日常练习/模拟考/正式考试通用）", "description": "对学生提交的答案进行批改，支持客观题本地批改和主观题LLM评分", "operationId": "gradeAnswers", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExamGradeRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultObject" } } } } } } }, "/exam/generate": { "post": { "tags": [ "考试管理" ], "summary": "生成题目（异步）", "description": "根据知识库å†\u0085容生成考试题目，支持单选题、多选题、判断题、填空题、简答题。支持两种模式：1. 智能生成模式（推荐）：不提供 question_types 参数，系统会调用 AI 智能出题接口 /exam/generate-smart，AI 会根据文档å†\u0085容自动判断题型和数量；2. 指定题型模式：提供 question_types 参数，系统会调用传统出题接口 /exam/generate，按ç\u0085§æŒ‡å®šçš„题型和数量生成题目。支持两种方式指定文件：通过 file_id 指定（推荐）或通过 file_path 指定。此接口为异步接口，请求后立即返回任务提交状态，实é™\u0085生成在后台执行，需通过 GET /api/file/{fileId} 接口轮询查询生成进度和结果。", "operationId": "generateQuestions", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExamGenerateRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } } } } }, "/exam/answers/query": { "post": { "tags": [ "考试管理" ], "summary": "查询用户答题记录", "description": "根据试卷ID或会话ID查询用户答题记录，支持按试卷/练习维度分组展示", "operationId": "queryUserAnswers", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserAnswerQueryRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultUserAnswerQueryResponse" } } } } } } }, "/department": { "get": { "tags": [ "部门管理" ], "summary": "查询部门列表", "description": "获取所有部门信息", "operationId": "listDepartments", "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListDepartmentVO" } } } } } }, "post": { "tags": [ "部门管理" ], "summary": "创建部门", "description": "创建新部门", "operationId": "createDepartment", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DepartmentCreateRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/collection": { "get": { "tags": [ "知识库管理" ], "summary": "获取向量库列表", "description": "从本地数据库获取所有向量库列表", "operationId": "getCollections", "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListCollectionVO" } } } } } }, "post": { "tags": [ "知识库管理" ], "summary": "创建向量库", "description": "在AI端创建向量库并同步到knowledge_base_path表", "operationId": "createCollection", "parameters": [ { "name": "name", "in": "query", "description": "向量库名称", "required": true, "schema": { "type": "string" } }, { "name": "displayName", "in": "query", "description": "显示名称", "required": false, "schema": { "type": "string" } }, { "name": "departmentId", "in": "query", "description": "所属部门ID", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "description", "in": "query", "description": "描述", "required": false, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultCollectionVO" } } } } } } }, "/collection/{name}/vectorize": { "post": { "tags": [ "知识库管理" ], "summary": "文件向量化", "description": "将已上传的文件解析并存储到向量库", "operationId": "vectorizeFile", "parameters": [ { "name": "name", "in": "path", "description": "向量库名称", "required": true, "schema": { "type": "string" } }, { "name": "fileId", "in": "query", "description": "文件ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } } } } }, "/collection/{name}/generate-exam": { "post": { "tags": [ "知识库管理" ], "summary": "文件生成题目", "description": "对已向量化完成的文件生成考试题目", "operationId": "generateExamFromFile", "parameters": [ { "name": "name", "in": "path", "description": "向量库名称", "required": true, "schema": { "type": "string" } }, { "name": "fileId", "in": "query", "description": "文件ID", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "questionTypes", "in": "query", "description": "题目类型（逗号分隔）", "required": false, "schema": { "type": "string" }, "example": "single,multiple" }, { "name": "difficulty", "in": "query", "description": "难度等级（1-5）", "required": false, "schema": { "type": "integer", "format": "int32" }, "example": 3 }, { "name": "questionCount", "in": "query", "description": "题目数量", "required": false, "schema": { "type": "integer", "format": "int32" }, "example": 10 } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } } } } }, "/collection/{name}/documents/{filename}/restore": { "post": { "tags": [ "知识库管理" ], "summary": "恢复已废止文档", "description": "将已废止的文档恢复为正常状态，同步更新本地数据库", "operationId": "restoreDocument", "parameters": [ { "name": "name", "in": "path", "description": "向量库名称", "required": true, "schema": { "type": "string" } }, { "name": "filename", "in": "path", "description": "文档文件名", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } } } } }, "/collection/{name}/documents/{filename}/deprecate": { "post": { "tags": [ "知识库管理" ], "summary": "废止文档", "description": "将文档标记为废止状态，同步更新本地数据库", "operationId": "deprecateDocument", "parameters": [ { "name": "name", "in": "path", "description": "向量库名称", "required": true, "schema": { "type": "string" } }, { "name": "filename", "in": "path", "description": "文档文件名", "required": true, "schema": { "type": "string" } }, { "name": "reason", "in": "query", "description": "废止原因", "required": false, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } } } } }, "/collection/{name}/devectorize": { "post": { "tags": [ "知识库管理" ], "summary": "删除文件向量化数据", "description": "删除文件的向量化数据，如果存在å\u0085³è”题目则å\u0085ˆè½¯åˆ é™¤é¢˜ç›®", "operationId": "devectorizeFile", "parameters": [ { "name": "name", "in": "path", "description": "向量库名称", "required": true, "schema": { "type": "string" } }, { "name": "fileId", "in": "query", "description": "文件ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } } } } }, "/collection/{name}/chunks": { "get": { "tags": [ "知识库管理" ], "summary": "获取向量库切片列表", "description": "获取指定向量库的所有文档切片", "operationId": "getCollectionChunks", "parameters": [ { "name": "name", "in": "path", "description": "向量库名称", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "每页数量", "required": false, "schema": { "type": "integer", "format": "int32", "default": 100 } }, { "name": "offset", "in": "query", "description": "偏移量", "required": false, "schema": { "type": "integer", "format": "int32", "default": 0 } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } } } }, "post": { "tags": [ "知识库管理" ], "summary": "新增切片", "description": "在指定向量库中创建新的切片", "operationId": "createChunk", "parameters": [ { "name": "name", "in": "path", "description": "向量库名称", "required": true, "schema": { "type": "string" } }, { "name": "content", "in": "query", "description": "切片å†\u0085容", "required": true, "schema": { "type": "string" } }, { "name": "section", "in": "query", "description": "章节信息", "required": false, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } } } } }, "/collection/vectorize/smart": { "post": { "tags": [ "知识库管理" ], "summary": "智能文件向量化", "description": "自动判断部门向量库并执行向量化，无需指定向量库名称", "operationId": "smartVectorizeFile", "parameters": [ { "name": "fileId", "in": "query", "description": "文件ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } } } } }, "/collection/vectorize/batch/smart": { "post": { "tags": [ "知识库管理" ], "summary": "批量智能文件向量化", "description": "批量自动判断部门向量库并执行向量化", "operationId": "batchSmartVectorizeFiles", "parameters": [ { "name": "fileIds", "in": "query", "description": "文件ID列表", "required": true, "schema": { "type": "array", "items": { "type": "integer", "format": "int64" } } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } } } } }, "/collection/cascade-delete/{fileId}": { "post": { "tags": [ "知识库管理" ], "summary": "级联软删除文件及题目", "description": "软删除文件并自动软删除该文件对应的所有题目", "operationId": "cascadeSoftDeleteFile", "parameters": [ { "name": "fileId", "in": "path", "description": "文件ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } } } } }, "/auth/logout": { "post": { "tags": [ "认证管理" ], "summary": "用户登出", "description": "退出登录，æ¸\u0085除Token", "operationId": "logout", "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/auth/login": { "post": { "tags": [ "认证管理" ], "summary": "用户登录", "description": "使用用户名和密码登录系统", "operationId": "login", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LoginRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultLoginResponse" } } } } } } }, "/ai/chat/stream": { "post": { "tags": [ "AI对话" ], "summary": "AI流式问答", "description": "向AI服务发起流式问答请求，实时返回处理过程，完成后自动保存到数据库", "operationId": "chatStream", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "text/event-stream": { "schema": { "$ref": "#/components/schemas/SseEmitter" } } } } } } }, "/ai/chat/stop": { "post": { "tags": [ "AI对话" ], "summary": "中断AI流式问答", "description": "中断指定会话的AI流式问答进程", "operationId": "stopChatStream", "parameters": [ { "name": "sessionId", "in": "query", "description": "会话ID", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } } } } }, "/admin/exam/record/{recordId}/submit": { "post": { "tags": [ "正式考管理" ], "summary": "提交试卷", "description": "管理员代用户提交试卷并批改", "operationId": "submitExam", "parameters": [ { "name": "recordId", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExamSaveRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultExamRecordResponse" } } } } } } }, "/admin/exam/paper/{paperId}/revoke": { "post": { "tags": [ "正式考管理" ], "summary": "撤销试卷", "description": "管理员撤销已发布的试卷", "operationId": "revokePaper", "parameters": [ { "name": "paperId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/admin/exam/paper/{paperId}/publish": { "post": { "tags": [ "正式考管理" ], "summary": "发布试卷", "description": "管理员发布试卷给指定部门或用户", "operationId": "publishPaper", "parameters": [ { "name": "paperId", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExamPublishRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/admin/exam/paper/save": { "post": { "tags": [ "正式考管理" ], "summary": "保存试卷", "description": "管理员保存试卷到数据库", "operationId": "savePaper", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExamPaperSaveRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultExamPaperResponse" } } } } } } }, "/admin/exam/paper/preview": { "post": { "tags": [ "正式考管理" ], "summary": "预览试卷", "description": "管理员预览生成的试卷å†\u0085容", "operationId": "previewPaper", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExamPaperGenerateRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultExamPaperGenerateResponse" } } } } } } }, "/admin/exam/paper/preview/detail": { "post": { "tags": [ "正式考管理" ], "summary": "预览试卷详æƒ\u0085", "description": "管理员预览生成的试卷详细å†\u0085容，åŒ\u0085含完整的题目å†\u0085容和选项", "operationId": "previewPaperWithDetails", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExamPaperGenerateRequest" } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultExamPaperPreviewResponse" } } } } } } }, "/wrong-questions/collection/check": { "get": { "tags": [ "错题管理" ], "summary": "检查题目是否已收藏", "description": "检查指定题目是否已被当前用户收藏", "operationId": "checkCollectionStatus", "parameters": [ { "name": "question_id", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultBoolean" } } } } } } }, "/user/{id}": { "get": { "tags": [ "用户管理" ], "summary": "查询用户详æƒ\u0085", "description": "根据ID查询用户详细信息", "operationId": "getUserById", "parameters": [ { "name": "id", "in": "path", "description": "用户ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultUserVO" } } } } } }, "delete": { "tags": [ "用户管理" ], "summary": "删除用户", "description": "根据ID删除用户", "operationId": "deleteUser", "parameters": [ { "name": "id", "in": "path", "description": "用户ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/user/page": { "get": { "tags": [ "用户管理" ], "summary": "分页查询用户", "description": "根据条件分页查询用户列表", "operationId": "pageUsers", "parameters": [ { "name": "pageNum", "in": "query", "description": "页码", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 }, "example": 1 }, { "name": "pageSize", "in": "query", "description": "每页大小", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 }, "example": 10 }, { "name": "username", "in": "query", "description": "用户名", "required": false, "schema": { "type": "string" } }, { "name": "deptId", "in": "query", "description": "部门ID", "required": false, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultUserVO" } } } } } } }, "/report/weekly": { "get": { "tags": [ "报告管理" ], "summary": "获取周报", "description": "获取最近一周的反馈统计报告", "operationId": "getWeeklyReport", "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } } } } }, "/report/monthly": { "get": { "tags": [ "报告管理" ], "summary": "获取月报", "description": "获取最近一个月的反馈统计报告", "operationId": "getMonthlyReport", "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } } } } }, "/question/pending": { "get": { "tags": [ "题目管理" ], "summary": "获取å¾\u0085审核题目列表", "description": "获取所有å¾\u0085审核的题目", "operationId": "getPendingQuestions", "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListQuestion" } } } } } } }, "/question/page": { "get": { "tags": [ "题目管理" ], "summary": "分页查询题目", "description": "根据条件分页查询题目列表", "operationId": "pageQuestions", "parameters": [ { "name": "pageNum", "in": "query", "description": "页码", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 }, "example": 1 }, { "name": "pageSize", "in": "query", "description": "每页大小", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 }, "example": 10 }, { "name": "questionType", "in": "query", "description": "题目类型", "required": false, "schema": { "type": "string" } }, { "name": "difficulty", "in": "query", "description": "难度等级", "required": false, "schema": { "type": "integer", "format": "int32" } }, { "name": "status", "in": "query", "description": "审核状态", "required": false, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultQuestion" } } } } } } }, "/question/list": { "get": { "tags": [ "题目管理" ], "summary": "条件查询题目列表", "description": "根据多种条件查询题目，支持按用户权限过滤（本人库、本部门库、å\u0085¬å\u0085±åº“）", "operationId": "listQuestions", "parameters": [ { "name": "questionType", "in": "query", "description": "题目类型", "required": false, "schema": { "type": "string" } }, { "name": "difficulty", "in": "query", "description": "难度等级", "required": false, "schema": { "type": "integer", "format": "int32" } }, { "name": "status", "in": "query", "description": "审核状态", "required": false, "schema": { "type": "string" } }, { "name": "documentName", "in": "query", "description": "文档名称", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "返回数量限制", "required": false, "schema": { "type": "integer", "format": "int32", "default": 100 } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListQuestion" } } } } } } }, "/log/page": { "get": { "tags": [ "日志管理" ], "summary": "分页查询日志", "description": "根据条件分页查询操作日志", "operationId": "pageLogs", "parameters": [ { "name": "pageNum", "in": "query", "description": "页码", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 }, "example": 1 }, { "name": "pageSize", "in": "query", "description": "每页大小", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 }, "example": 10 }, { "name": "username", "in": "query", "description": "用户名", "required": false, "schema": { "type": "string" } }, { "name": "operationType", "in": "query", "description": "操作类型", "required": false, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultOperationLogVO" } } } } } } }, "/image/{id}/data": { "get": { "tags": [ "图片管理" ], "summary": "获取单张图片", "description": "通过图片ID获取图片文件", "operationId": "getImageData", "parameters": [ { "name": "id", "in": "path", "description": "图片ID", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "image/jpeg": { "schema": { "type": "array", "items": { "type": "string", "format": "byte" } } }, "image/png": { "schema": { "type": "array", "items": { "type": "string", "format": "byte" } } }, "image/gif": { "schema": { "type": "array", "items": { "type": "string", "format": "byte" } } } } } } } }, "/image/stats": { "get": { "tags": [ "图片管理" ], "summary": "获取图片统计", "description": "获取图片统计信息，åŒ\u0085括总数量、总大小、格式分布等", "operationId": "getImageStats", "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultImageStatsResponse" } } } } } } }, "/image/images/list": { "get": { "tags": [ "图片管理" ], "summary": "获取图片列表", "description": "分页获取知识库中的图片列表", "operationId": "getImageList", "parameters": [ { "name": "limit", "in": "query", "description": "返回数量，默认50", "required": false, "schema": { "type": "integer", "format": "int32", "default": 50 } }, { "name": "offset", "in": "query", "description": "偏移量，默认0", "required": false, "schema": { "type": "integer", "format": "int32", "default": 0 } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultImageListResponse" } } } } } } }, "/image/list": { "get": { "tags": [ "图片管理" ], "summary": "获取图片列表", "description": "分页获取知识库中的图片列表", "operationId": "getImageList_1", "parameters": [ { "name": "limit", "in": "query", "description": "返回数量，默认50", "required": false, "schema": { "type": "integer", "format": "int32", "default": 50 } }, { "name": "offset", "in": "query", "description": "偏移量，默认0", "required": false, "schema": { "type": "integer", "format": "int32", "default": 0 } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultImageListResponse" } } } } } } }, "/formal-exam/record/{recordId}/result": { "get": { "tags": [ "正式考试" ], "summary": "获取正式考试结果", "description": "获取正式考试的完整结果，åŒ\u0085含每题得分和反馈", "operationId": "getExamResult", "parameters": [ { "name": "recordId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultExamRecordResponse" } } } } } } }, "/file/text/{id}": { "get": { "tags": [ "文件管理" ], "summary": "获取文本文件å†\u0085容", "description": "获取文本类文件的字符串å†\u0085容，适用于txt、json、xml、csv等格式", "operationId": "getTextFileContent", "parameters": [ { "name": "id", "in": "path", "description": "文件ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultString" } } } } } } }, "/file/preview/{id}": { "get": { "tags": [ "文件管理" ], "summary": "预览文件", "description": "获取文件二进制å†\u0085容用于前端预览，支持PDF、图片、文本等格式", "operationId": "previewFile", "parameters": [ { "name": "id", "in": "path", "description": "文件ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "array", "items": { "type": "string", "format": "byte" } } } } } } } }, "/file/permission/file/{fileId}": { "get": { "tags": [ "文件权限管理" ], "summary": "查询文件权限列表", "description": "获取文件的所有权限信息", "operationId": "getFilePermissions", "parameters": [ { "name": "fileId", "in": "path", "description": "文件ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListFilePermission" } } } } } } }, "/file/page": { "get": { "tags": [ "文件管理" ], "summary": "分页查询文件", "description": "根据条件分页查询文件列表", "operationId": "pageFiles", "parameters": [ { "name": "pageNum", "in": "query", "description": "页码", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 }, "example": 1 }, { "name": "pageSize", "in": "query", "description": "每页大小", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 }, "example": 10 }, { "name": "fileName", "in": "query", "description": "文件名", "required": false, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultFileVO" } } } } } } }, "/file/info/{id}": { "get": { "tags": [ "文件管理" ], "summary": "获取文件详细信息", "description": "获取文件的所有信息åŒ\u0085括å†\u0085容，供后端服务使用", "operationId": "getFileInfo", "parameters": [ { "name": "id", "in": "path", "description": "文件ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultFileVO" } } } } } } }, "/file/download/{id}": { "get": { "tags": [ "文件管理" ], "summary": "下载文件", "description": "根据ID下载文件", "operationId": "downloadFile", "parameters": [ { "name": "id", "in": "path", "description": "文件ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "string", "format": "binary" } } } } } } }, "/file/content/{id}": { "get": { "tags": [ "文件管理" ], "summary": "获取文件å†\u0085容", "description": "根据ID获取文件二进制å†\u0085容，供后端服务使用", "operationId": "getFileContent", "parameters": [ { "name": "id", "in": "path", "description": "文件ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultByte[]" } } } } } } }, "/file/audit/pending": { "get": { "tags": [ "文件管理" ], "summary": "查询å¾\u0085审核文件列表", "description": "管理员查询所有å¾\u0085审核的文件", "operationId": "getPendingFiles", "parameters": [ { "name": "pageNum", "in": "query", "description": "页码", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 }, "example": 1 }, { "name": "pageSize", "in": "query", "description": "每页大小", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 }, "example": 10 } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultFileVO" } } } } } } }, "/feedback/stats": { "get": { "tags": [ "反馈管理" ], "summary": "获取反馈统计", "description": "获取反馈统计信息，åŒ\u0085括总数量、好评差评数量、满意度等", "operationId": "getFeedbackStats", "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } } } } }, "/feedback/list": { "get": { "tags": [ "反馈管理" ], "summary": "获取反馈列表", "description": "分页获取所有反馈记录", "operationId": "getFeedbackList", "parameters": [ { "name": "page", "in": "query", "description": "页码，默认1", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "description": "每页大小，默认20", "required": false, "schema": { "type": "integer", "format": "int32", "default": 20 } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } } } } }, "/feedback/bad-cases": { "get": { "tags": [ "反馈管理" ], "summary": "获取差评案例", "description": "获取所有差评反馈记录", "operationId": "getBadCases", "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } } } } }, "/faq/suggestions": { "get": { "tags": [ "FAQ管理" ], "summary": "获取FAQ建议列表", "description": "分页获取用户反馈中产生的FAQ建议", "operationId": "getFAQSuggestions", "parameters": [ { "name": "page", "in": "query", "description": "页码，默认1", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "description": "每页大小，默认20", "required": false, "schema": { "type": "integer", "format": "int32", "default": 20 } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultFAQSuggestionListResponse" } } } } } } }, "/faq/list": { "get": { "tags": [ "FAQ管理" ], "summary": "条件查询FAQ列表", "description": "根据状态查询FAQ列表", "operationId": "listFAQs", "parameters": [ { "name": "status", "in": "query", "description": "状态：pending/approved/rejected", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "返回数量限制", "required": false, "schema": { "type": "integer", "format": "int32", "default": 100 } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListFAQ" } } } } } } }, "/exam/records": { "get": { "tags": [ "考试管理" ], "summary": "获取考试记录列表", "description": "根据类型获取用户的考试/练习记录，支持日常练习(practice)、模拟考(mock_exam)、正式考(formal_exam)", "operationId": "getExamRecords", "parameters": [ { "name": "type", "in": "query", "description": "记录类型：practice(日常练习), mock_exam(模拟考), formal_exam(正式考)", "required": false, "schema": { "type": "string", "default": "practice" }, "example": "practice" } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultObject" } } } } } } }, "/exam/record/{recordId}/result": { "get": { "tags": [ "考试管理" ], "summary": "获取考试结果", "description": "获取模拟考试的完整结果，åŒ\u0085括题目、答案、分数等信息", "operationId": "getExamResult_1", "parameters": [ { "name": "recordId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultExamRecordResponse" } } } } } } }, "/department/{id}/users": { "get": { "tags": [ "部门管理" ], "summary": "查询部门用户", "description": "获取部门下的所有用户", "operationId": "getDepartmentUsers", "parameters": [ { "name": "id", "in": "path", "description": "部门ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListUserVO" } } } } } } }, "/data-sync/validate/user/{userId}": { "get": { "tags": [ "数据同步验证" ], "summary": "验证指定用户的数据同步", "description": "验证指定用户的错题数据与批é˜\u0085数据是否一致", "operationId": "validateUserSync", "parameters": [ { "name": "userId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "paperId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sessionId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultValidationResult" } } } } } } }, "/data-sync/validate/recent": { "get": { "tags": [ "数据同步验证" ], "summary": "验证最近答题记录", "description": "验证指定时间之后的答题记录是否完整", "operationId": "validateRecentAnswers", "parameters": [ { "name": "hoursAgo", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 24 } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultValidationResult" } } } } } } }, "/data-sync/validate/me": { "get": { "tags": [ "数据同步验证" ], "summary": "验证当前用户的数据同步", "description": "验证当前登录用户的错题数据与批é˜\u0085数据是否一致", "operationId": "validateCurrentUserSync", "parameters": [ { "name": "paperId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sessionId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultValidationResult" } } } } } } }, "/data-sync/validate/all": { "get": { "tags": [ "数据同步验证" ], "summary": "å\u0085¨é‡éªŒè¯æ‰€æœ‰ç”¨æˆ·æ•°æ®åŒæ­¥", "description": "验证系统中所有用户的错题数据与批é˜\u0085数据是否一致", "operationId": "validateAllUsersSync", "parameters": [ { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 100 } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultValidationResult" } } } } } } }, "/collection/{name}/documents": { "get": { "tags": [ "知识库管理" ], "summary": "获取文档列表", "description": "从本地数据库获取指定向量库中的文档列表", "operationId": "getDocuments", "parameters": [ { "name": "name", "in": "path", "description": "向量库名称", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListMapStringObject" } } } } } } }, "/collection/{name}/documents/{filename}/versions": { "get": { "tags": [ "知识库管理" ], "summary": "获取文档版本历史", "description": "获取文档的版本历史记录", "operationId": "getDocumentVersions", "parameters": [ { "name": "name", "in": "path", "description": "向量库名称", "required": true, "schema": { "type": "string" } }, { "name": "filename", "in": "path", "description": "文档文件名", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "返回数量限制", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } } } } }, "/collection/{name}/documents/{filename}/chunks": { "get": { "tags": [ "知识库管理" ], "summary": "获取文档切片列表", "description": "获取指定文档的所有切片å†\u0085容", "operationId": "getDocumentChunks", "parameters": [ { "name": "name", "in": "path", "description": "向量库名称", "required": true, "schema": { "type": "string" } }, { "name": "filename", "in": "path", "description": "文档文件名", "required": true, "schema": { "type": "string" } }, { "name": "page", "in": "query", "description": "页码", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "description": "每页数量", "required": false, "schema": { "type": "integer", "format": "int32", "default": 20 } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } } } } }, "/collection-access/{id}": { "get": { "tags": [ "知识库访问控制" ], "summary": "获取知识库详æƒ\u0085", "description": "根据ID获取知识库详细信息", "operationId": "getCollectionById", "parameters": [ { "name": "id", "in": "path", "description": "知识库ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultKnowledgeBasePath" } } } } } } }, "/collection-access/page": { "get": { "tags": [ "知识库访问控制" ], "summary": "分页查询知识库列表", "description": "分页获取知识库列表，支持条件过滤", "operationId": "pageCollections", "parameters": [ { "name": "pageNum", "in": "query", "description": "页码", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 }, "example": 1 }, { "name": "pageSize", "in": "query", "description": "每页大小", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 }, "example": 10 }, { "name": "name", "in": "query", "description": "知识库名称", "required": false, "schema": { "type": "string" } }, { "name": "department", "in": "query", "description": "部门", "required": false, "schema": { "type": "string" } }, { "name": "ownerType", "in": "query", "description": "所有è€\u0085类型", "required": false, "schema": { "type": "string" } }, { "name": "visibility", "in": "query", "description": "可见性", "required": false, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultKnowledgeBasePath" } } } } } } }, "/collection-access/accessible": { "get": { "tags": [ "知识库访问控制" ], "summary": "获取用户可访问的知识库列表", "description": "获取当前用户可访问的所有知识库", "operationId": "getAccessibleCollections", "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } } } } }, "/auth/user/roles": { "get": { "tags": [ "认证管理" ], "summary": "获取用户角色", "description": "获取当前用户的所有角色名称", "operationId": "getUserRoles", "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListString" } } } } } } }, "/auth/user/main-role": { "get": { "tags": [ "认证管理" ], "summary": "获取主要角色", "description": "获取当前用户的主要角色名称", "operationId": "getUserMainRole", "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringString" } } } } } } }, "/auth/user/info": { "get": { "tags": [ "认证管理" ], "summary": "获取用户信息", "description": "获取当前登录用户的详细信息", "operationId": "getUserInfo", "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultUserInfoVO" } } } } } } }, "/ai/sessions": { "get": { "tags": [ "AI对话" ], "summary": "获取用户会话列表", "description": "获取当前登录用户的所有会话列表，按创建时间倒序排列", "operationId": "getUserSessions", "parameters": [ { "name": "page", "in": "query", "description": "页码，默认1", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "description": "每页大小，默认10", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } } } }, "delete": { "tags": [ "AI对话" ], "summary": "批量删除会话", "description": "批量删除多个会话及å\u0085¶æ‰€æœ‰ç›¸å\u0085³æ¶ˆæ¯å’Œå¼•ç”¨ä¿¡æ¯", "operationId": "deleteSessions", "requestBody": { "content": { "application/json": { "schema": { "type": "array", "description": "会话ID列表", "items": { "type": "string" } } } }, "required": true }, "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } } } } }, "/ai/session/{sessionId}": { "get": { "tags": [ "AI对话" ], "summary": "获取会话详æƒ\u0085", "description": "获取指定会话的完整交互记录，åŒ\u0085括用户提问与AI回答", "operationId": "getSessionDetail", "parameters": [ { "name": "sessionId", "in": "path", "description": "会话ID", "required": true, "schema": { "type": "string" } }, { "name": "page", "in": "query", "description": "页码，默认1", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "description": "每页大小，默认20", "required": false, "schema": { "type": "integer", "format": "int32", "default": 20 } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } } } }, "delete": { "tags": [ "AI对话" ], "summary": "删除单个会话", "description": "删除指定的会话及å\u0085¶æ‰€æœ‰ç›¸å\u0085³æ¶ˆæ¯å’Œå¼•ç”¨ä¿¡æ¯", "operationId": "deleteSession", "parameters": [ { "name": "sessionId", "in": "path", "description": "会话ID", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } } } } }, "/ai/session/{sessionId}/references": { "get": { "tags": [ "AI对话" ], "summary": "获取会话引用信息", "description": "获取指定会话的所有引用信息，åŒ\u0085括文档来源、页码、片段å†\u0085容等", "operationId": "getSessionReferences", "parameters": [ { "name": "sessionId", "in": "path", "description": "会话ID", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } } } } }, "/ai/message/{messageId}/sources": { "get": { "tags": [ "AI对话" ], "summary": "获取消息文件来源列表", "description": "获取指定消息引用的文件来源列表（去重），åŒ\u0085含文件名称、类型、引用数量和页码范围", "operationId": "getMessageSources", "parameters": [ { "name": "messageId", "in": "path", "description": "消息ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } } } } }, "/ai/message/{messageId}/references": { "get": { "tags": [ "AI对话" ], "summary": "获取消息引用信息", "description": "获取指定消息的引用信息，åŒ\u0085括文档来源、页码、片段å†\u0085容等，支持按文档名称过滤", "operationId": "getMessageReferences", "parameters": [ { "name": "messageId", "in": "path", "description": "消息ID", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "docName", "in": "query", "description": "文档名称（可选，用于过滤）", "required": false, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } } } } }, "/ai/data/session/{sessionId}/messages": { "get": { "tags": [ "AI数据接口" ], "summary": "获取会话历史消息", "description": "AI端通过session_id获取完整的对话历史", "operationId": "getSessionMessages", "parameters": [ { "name": "sessionId", "in": "path", "description": "会话ID", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListChatMessage" } } } } } } }, "/ai/data/feedbacks": { "get": { "tags": [ "AI数据接口" ], "summary": "获取用户反馈列表", "description": "AI端获取所有反馈数据用于分析", "operationId": "getFeedbacks", "parameters": [ { "name": "rating", "in": "query", "description": "评分筛选：1=好评，-1=差评", "required": false, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListFeedback" } } } } } } }, "/ai/data/feedbacks/bad-cases": { "get": { "tags": [ "AI数据接口" ], "summary": "获取差评案例", "description": "AI端获取差评案例用于分析改进", "operationId": "getBadCases_1", "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListFeedback" } } } } } } }, "/admin/exam/records/{paperId}": { "get": { "tags": [ "正式考管理" ], "summary": "获取考试记录列表", "description": "管理员获取指定试卷的答题记录列表", "operationId": "listRecords", "parameters": [ { "name": "paperId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 20 } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResponseExamRecordResponse" } } } } } } }, "/admin/exam/record/{recordId}": { "get": { "tags": [ "正式考管理" ], "summary": "获取考试记录详æƒ\u0085", "description": "管理员获取指定答题记录的详细信息", "operationId": "getRecordById", "parameters": [ { "name": "recordId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultExamRecordResponse" } } } } } } }, "/admin/exam/paper/{paperId}": { "get": { "tags": [ "正式考管理" ], "summary": "获取试卷详æƒ\u0085", "description": "管理员获取试卷详细信息", "operationId": "getPaperById", "parameters": [ { "name": "paperId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultExamPaperResponse" } } } } } }, "delete": { "tags": [ "正式考管理" ], "summary": "删除试卷", "description": "管理员删除试卷", "operationId": "deletePaper", "parameters": [ { "name": "paperId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/admin/exam/paper/{paperId}/assignment": { "get": { "tags": [ "正式考管理" ], "summary": "获取试卷分é\u0085è¯¦æƒ\u0085", "description": "获取试卷的部门分é\u0085å’Œç”¨æˆ·åˆ†é\u0085ä¿¡æ¯", "operationId": "getPaperAssignment", "parameters": [ { "name": "paperId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } } } } }, "/admin/exam/paper/list": { "get": { "tags": [ "正式考管理" ], "summary": "获取试卷列表", "description": "管理员获取试卷列表，支持按状态筛选", "operationId": "listPapers", "parameters": [ { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 20 } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResponseExamPaperResponse" } } } } } } }, "/question/batch": { "delete": { "tags": [ "题目管理" ], "summary": "批量删除题目", "description": "根据ID列表批量删除题目", "operationId": "batchDeleteQuestions", "parameters": [ { "name": "ids", "in": "query", "description": "题目ID列表", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultInteger" } } } } } } }, "/image/batch": { "delete": { "tags": [ "图片管理" ], "summary": "批量删除图片", "description": "根据ID列表批量删除图片", "operationId": "batchDeleteImages", "parameters": [ { "name": "ids", "in": "query", "description": "图片ID列表", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultInteger" } } } } } } }, "/file/permission/{id}": { "delete": { "tags": [ "文件权限管理" ], "summary": "撤销文件权限", "description": "撤销用户或部门的文件访问权限", "operationId": "revokePermission", "parameters": [ { "name": "id", "in": "path", "description": "权限ID", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/faq/batch": { "delete": { "tags": [ "FAQ管理" ], "summary": "批量删除FAQ", "description": "根据ID列表批量删除FAQ", "operationId": "batchDeleteFAQs", "parameters": [ { "name": "ids", "in": "query", "description": "FAQ ID列表", "required": true, "schema": { "type": "string" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultInteger" } } } } } } }, "/collection/{name}/documents/{filename}": { "delete": { "tags": [ "知识库管理" ], "summary": "删除文档", "description": "从向量库中删除指定文档，同步更新本地数据库", "operationId": "deleteDocument", "parameters": [ { "name": "name", "in": "path", "description": "向量库名称", "required": true, "schema": { "type": "string" } }, { "name": "filename", "in": "path", "description": "文档文件名", "required": true, "schema": { "type": "string" } }, { "name": "fileId", "in": "query", "description": "文件ID（优å\u0085ˆä½¿ç”¨ï¼Œé¿å\u0085åŒåæ–‡ä»¶åˆ é™¤é”™è¯¯ï¼‰", "required": false, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "410": { "description": "Gone" }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } } }, "components": { "schemas": { "ResultVoid": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "object" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "UserUpdateRequest": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "realName": { "type": "string" }, "email": { "type": "string" }, "phone": { "type": "string" }, "deptId": { "type": "integer", "format": "int64" }, "status": { "type": "integer", "format": "int32" }, "roleIds": { "type": "array", "items": { "type": "integer", "format": "int64" } } } }, "RoleUpdateRequest": { "type": "object", "properties": { "roleName": { "type": "string" }, "roleCode": { "type": "string" }, "roleType": { "type": "integer", "format": "int32" }, "description": { "type": "string" }, "status": { "type": "integer", "format": "int32" } } }, "QuestionUpdateRequest": { "type": "object", "properties": { "question_type": { "type": "string" }, "difficulty": { "type": "integer", "format": "int32" }, "content": { "type": "object", "additionalProperties": { "type": "object" } }, "tags": { "type": "array", "items": { "type": "string" } }, "score": { "type": "number" }, "status": { "type": "string" }, "reviewer_comment": { "type": "string" }, "document_id": { "type": "string" }, "document_name": { "type": "string" }, "knowledge_base_path": { "type": "string" }, "source_context": { "type": "string" }, "chunk_ids": { "type": "array", "items": { "type": "string" } }, "source_chunks_used": { "type": "integer", "format": "int32" }, "page_numbers": { "type": "array", "items": { "type": "integer", "format": "int32" } } } }, "JsonNode": { "type": "object" }, "Question": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "questionId": { "type": "string" }, "questionType": { "type": "string" }, "difficulty": { "type": "integer", "format": "int32" }, "tags": { "$ref": "#/components/schemas/JsonNode" }, "score": { "type": "number" }, "version": { "type": "string" }, "documentId": { "type": "string" }, "excludeStems": { "type": "string" }, "knowledgeBasePath": { "type": "string" }, "sourceContext": { "type": "string" }, "chunkIds": { "$ref": "#/components/schemas/JsonNode" }, "sourceChunksUsed": { "type": "integer", "format": "int32" }, "examCount": { "type": "integer", "format": "int32" }, "correctCount": { "type": "integer", "format": "int32" }, "lastExamTime": { "type": "string", "format": "date-time" }, "pageNumbers": { "$ref": "#/components/schemas/JsonNode" }, "content": { "$ref": "#/components/schemas/JsonNode" }, "status": { "type": "string" }, "reviewerComment": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "isDeleted": { "type": "integer", "format": "int32" } } }, "ResultQuestion": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/Question" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ImageUpdateRequest": { "type": "object", "properties": { "path": { "type": "string" }, "source": { "type": "string" }, "page": { "type": "integer", "format": "int32" }, "collection": { "type": "string" } } }, "Image": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "imageId": { "type": "string" }, "path": { "type": "string" }, "source": { "type": "string" }, "page": { "type": "integer", "format": "int32" }, "section": { "type": "string" }, "chunkType": { "type": "string" }, "description": { "type": "string" }, "score": { "type": "number" }, "collection": { "type": "string" }, "createTime": { "type": "string", "format": "date-time" } } }, "ResultImage": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/Image" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "FileUpdateRequest": { "type": "object", "properties": { "fileName": { "type": "string" }, "description": { "type": "string" }, "isPublic": { "type": "integer", "format": "int32" }, "auditStatus": { "type": "integer", "format": "int32" }, "tags": { "type": "object", "additionalProperties": { "type": "object" } } } }, "FileVO": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "fileName": { "type": "string" }, "filePath": { "type": "string" }, "fileSize": { "type": "integer", "format": "int64" }, "fileType": { "type": "string" }, "extension": { "type": "string" }, "fileMd5": { "type": "string" }, "uploadUserId": { "type": "integer", "format": "int64" }, "uploadUserName": { "type": "string" }, "deptId": { "type": "integer", "format": "int64" }, "deptName": { "type": "string" }, "isPublic": { "type": "integer", "format": "int32" }, "fileCategory": { "type": "string" }, "description": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "auditStatus": { "type": "integer", "format": "int32" }, "vectorDbAddress": { "type": "string" }, "createTime": { "type": "string", "format": "date-time" }, "updateTime": { "type": "string", "format": "date-time" }, "processStatus": { "type": "string" }, "examStatus": { "type": "string" }, "processMessage": { "type": "string" }, "processStepStatus": { "type": "string" }, "processStepMessage": { "type": "string" }, "tags": { "$ref": "#/components/schemas/JsonNode" } } }, "ResultFileVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/FileVO" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ExpireTimeRequest": { "type": "object", "properties": { "expireTime": { "type": "string", "format": "date-time" } } }, "FAQUpdateRequest": { "type": "object", "properties": { "question": { "type": "string" }, "answer": { "type": "string" }, "avg_rating": { "type": "number" }, "frequency": { "type": "integer", "format": "int32" }, "status": { "type": "string" }, "source_documents": { "type": "array", "items": { "type": "string" } } } }, "FAQ": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "question": { "type": "string" }, "answer": { "type": "string" }, "avgRating": { "type": "number" }, "frequency": { "type": "integer", "format": "int32" }, "status": { "type": "string" }, "sourceDocuments": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } } }, "ResultFAQ": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/FAQ" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "DepartmentUpdateRequest": { "type": "object", "properties": { "deptName": { "type": "string" }, "parentId": { "type": "integer", "format": "int64" }, "orderNum": { "type": "integer", "format": "int32" }, "status": { "type": "integer", "format": "int32" } } }, "CollectionVO": { "type": "object", "properties": { "name": { "type": "string" }, "displayName": { "type": "string" }, "documentCount": { "type": "integer", "format": "int32" }, "department": { "type": "string" }, "description": { "type": "string" }, "ownerType": { "type": "string" }, "visibility": { "type": "string" }, "uploader": { "type": "string" }, "fileSize": { "type": "integer", "format": "int64" }, "createTime": { "type": "string", "format": "date-time" }, "updateTime": { "type": "string", "format": "date-time" } } }, "ResultCollectionVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/CollectionVO" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ResultMapStringObject": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "object", "additionalProperties": { "type": "object" } }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "WrongQuestionRedoRequest": { "type": "object", "properties": { "answer_ids": { "type": "array", "items": { "type": "integer", "format": "int64" } }, "question_type": { "type": "string" }, "question_count": { "type": "integer", "format": "int32" }, "is_collected": { "type": "boolean" } } }, "ExamPaperGenerateResponse": { "type": "object", "properties": { "success": { "type": "boolean" }, "questions": { "type": "array", "items": { "$ref": "#/components/schemas/ExamPaperQuestion" } }, "paper_id": { "type": "string" }, "paper_title": { "type": "string" }, "total_score": { "type": "number" }, "question_count": { "type": "integer", "format": "int32" }, "generated_at": { "type": "string", "format": "date-time" }, "permission_scope": { "type": "string" }, "warnings": { "type": "object", "additionalProperties": { "type": "string" } } } }, "ExamPaperQuestion": { "type": "object", "properties": { "difficulty": { "type": "integer", "format": "int32" }, "score": { "type": "number" }, "question_id": { "type": "string" }, "question_type": { "type": "string" }, "question_type_name": { "type": "string" }, "content": { "type": "object" }, "document_name": { "type": "string" }, "knowledge_base_path": { "type": "string" } } }, "ResultExamPaperGenerateResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/ExamPaperGenerateResponse" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "WrongQuestionListRequest": { "type": "object", "properties": { "question_type": { "type": "string" }, "is_collected": { "type": "boolean" }, "start_time": { "type": "string", "format": "date-time" }, "end_time": { "type": "string", "format": "date-time" }, "knowledge_base_path": { "type": "string" }, "page": { "type": "integer", "format": "int32" }, "page_size": { "type": "integer", "format": "int32" } } }, "PageResultWrongQuestionItem": { "type": "object", "properties": { "records": { "type": "array", "items": { "$ref": "#/components/schemas/WrongQuestionItem" } }, "total": { "type": "integer", "format": "int64" }, "size": { "type": "integer", "format": "int64" }, "current": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultWrongQuestionListResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/WrongQuestionListResponse" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "WrongQuestionItem": { "type": "object", "properties": { "answer_id": { "type": "integer", "format": "int64" }, "question_id": { "type": "string" }, "question_type": { "type": "string" }, "question_type_name": { "type": "string" }, "question_content": { "type": "object" }, "user_answer": { "type": "object" }, "correct_answer": { "type": "object" }, "score": { "type": "number" }, "max_score": { "type": "number" }, "difficulty": { "type": "integer", "format": "int32" }, "feedback": { "type": "string" }, "document_name": { "type": "string" }, "knowledge_base_path": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "is_collected": { "type": "boolean" }, "wrong_count": { "type": "integer", "format": "int32" }, "answered_at": { "type": "string", "format": "date-time" } } }, "WrongQuestionListResponse": { "type": "object", "properties": { "page": { "$ref": "#/components/schemas/PageResultWrongQuestionItem" }, "stats": { "$ref": "#/components/schemas/WrongQuestionStats" } } }, "WrongQuestionStats": { "type": "object", "properties": { "total_wrong_count": { "type": "integer", "format": "int32" }, "single_choice_count": { "type": "integer", "format": "int32" }, "multiple_choice_count": { "type": "integer", "format": "int32" }, "true_false_count": { "type": "integer", "format": "int32" }, "fill_blank_count": { "type": "integer", "format": "int32" }, "subjective_count": { "type": "integer", "format": "int32" }, "collected_count": { "type": "integer", "format": "int32" } } }, "WrongQuestionCollectRequest": { "type": "object", "properties": { "answer_id": { "type": "integer", "format": "int64" }, "question_id": { "type": "string" }, "is_collected": { "type": "boolean" }, "note": { "type": "string" } } }, "UserCreateRequest": { "type": "object", "properties": { "username": { "type": "string" }, "password": { "type": "string" }, "realName": { "type": "string" }, "email": { "type": "string" }, "phone": { "type": "string" }, "deptId": { "type": "integer", "format": "int64" }, "roleIds": { "type": "array", "items": { "type": "integer", "format": "int64" } } } }, "SearchRequest": { "type": "object", "properties": { "query": { "type": "string" }, "top_k": { "type": "integer", "format": "int32" }, "collections": { "type": "array", "items": { "type": "string" } } } }, "RoleCreateRequest": { "type": "object", "properties": { "roleName": { "type": "string" }, "roleCode": { "type": "string" }, "description": { "type": "string" } } }, "QuestionCreateRequest": { "type": "object", "properties": { "question_type": { "type": "string" }, "difficulty": { "type": "integer", "format": "int32" }, "content": { "type": "object", "additionalProperties": { "type": "object" } }, "tags": { "type": "array", "items": { "type": "string" } }, "score": { "type": "number" }, "document_id": { "type": "string" }, "document_name": { "type": "string" }, "knowledge_base_path": { "type": "string" }, "source_context": { "type": "string" }, "chunk_ids": { "type": "array", "items": { "type": "string" } }, "source_chunks_used": { "type": "integer", "format": "int32" }, "page_numbers": { "type": "array", "items": { "type": "integer", "format": "int32" } } } }, "QuestionStatsRequest": { "type": "object", "properties": { "dept_id": { "type": "integer", "format": "int64" }, "file_ids": { "type": "array", "items": { "type": "integer", "format": "int64" } }, "collection": { "type": "string" }, "question_types": { "type": "array", "items": { "type": "string" } }, "status": { "type": "string" } } }, "QuestionStatsResponse": { "type": "object", "properties": { "success": { "type": "boolean" }, "total_count": { "type": "integer", "format": "int64" }, "single_choice_count": { "type": "integer", "format": "int64" }, "multiple_choice_count": { "type": "integer", "format": "int64" }, "true_false_count": { "type": "integer", "format": "int64" }, "fill_blank_count": { "type": "integer", "format": "int64" }, "subjective_count": { "type": "integer", "format": "int64" }, "single_choice_score": { "type": "number" }, "multiple_choice_score": { "type": "number" }, "true_false_score": { "type": "number" }, "fill_blank_score": { "type": "number" }, "subjective_score": { "type": "number" }, "total_score": { "type": "number" } } }, "ResultQuestionStatsResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/QuestionStatsResponse" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "KBRouteRequest": { "type": "object", "properties": { "query": { "type": "string" } } }, "ImageCreateRequest": { "type": "object", "properties": { "image_id": { "type": "string" }, "path": { "type": "string" }, "source": { "type": "string" }, "page": { "type": "integer", "format": "int32" }, "section": { "type": "string" }, "chunk_type": { "type": "string" }, "description": { "type": "string" }, "score": { "type": "number" }, "collection": { "type": "string" } } }, "AnswerDetail": { "type": "object", "properties": { "questionId": { "type": "string" }, "userAnswer": { "type": "object" }, "score": { "type": "number" }, "isCorrect": { "type": "boolean" }, "feedback": { "type": "string" } } }, "ExamRecordResponse": { "type": "object", "properties": { "recordId": { "type": "string" }, "paperId": { "type": "string" }, "answerType": { "type": "string" }, "paperTitle": { "type": "string" }, "userId": { "type": "integer", "format": "int64" }, "status": { "type": "string" }, "totalScore": { "type": "number" }, "timeSpent": { "type": "integer", "format": "int32" }, "startTime": { "type": "string", "format": "date-time" }, "submitTime": { "type": "string", "format": "date-time" }, "gradedTime": { "type": "string", "format": "date-time" }, "questions": { "type": "array", "items": { "$ref": "#/components/schemas/ExamPaperQuestion" } }, "answers": { "type": "array", "items": { "$ref": "#/components/schemas/AnswerDetail" } } } }, "ResultExamRecordResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/ExamRecordResponse" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "SseEmitter": { "type": "object", "properties": { "timeout": { "type": "integer", "format": "int64" } } }, "FilePermissionRequest": { "type": "object", "properties": { "fileId": { "type": "integer", "format": "int64" }, "userId": { "type": "integer", "format": "int64" }, "deptId": { "type": "integer", "format": "int64" }, "deptIds": { "type": "array", "items": { "type": "integer", "format": "int64" } }, "permissionType": { "type": "integer", "format": "int32" }, "expireTime": { "type": "string", "format": "date-time" }, "grantUserId": { "type": "integer", "format": "int64" } } }, "FeedbackCreateRequest": { "type": "object", "properties": { "session_id": { "type": "string" }, "query": { "type": "string" }, "answer": { "type": "string" }, "rating": { "type": "integer", "format": "int32" }, "reason": { "type": "string" }, "sources": { "type": "array", "items": { "type": "string" } } } }, "FAQCreateRequest": { "type": "object", "properties": { "question": { "type": "string" }, "answer": { "type": "string" }, "source_documents": { "type": "array", "items": { "type": "string" } } } }, "AnswerItem": { "type": "object", "properties": { "questionId": { "type": "string" }, "questionType": { "type": "string" }, "answer": { "type": "object" } } }, "ExamSaveRequest": { "type": "object", "properties": { "answers": { "type": "array", "items": { "$ref": "#/components/schemas/AnswerItem" } } } }, "ExamPaperGenerateRequest": { "type": "object", "properties": { "single_choice_count": { "type": "integer", "format": "int32" }, "multiple_choice_count": { "type": "integer", "format": "int32" }, "true_false_count": { "type": "integer", "format": "int32" }, "fill_blank_count": { "type": "integer", "format": "int32" }, "subjective_count": { "type": "integer", "format": "int32" }, "include_personal": { "type": "boolean" }, "difficulty": { "type": "integer", "format": "int32" }, "file_ids": { "type": "array", "items": { "type": "integer", "format": "int64" } }, "collection": { "type": "string" }, "collection_name": { "type": "string" } } }, "ExamGradeRequest": { "type": "object", "properties": { "request_id": { "type": "string" }, "paper_id": { "type": "string" }, "session_id": { "type": "string" }, "record_id": { "type": "string" }, "answer_type": { "type": "string" }, "answers": { "type": "array", "items": { "$ref": "#/components/schemas/AnswerItem" } } } }, "QuestionContent": { "type": "object", "properties": { "stem": { "type": "string" }, "data": { "type": "object", "additionalProperties": { "type": "object" } }, "answer": { "type": "object" } } }, "ResultObject": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "object" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ExamGenerateRequest": { "type": "object", "properties": { "request_id": { "type": "string", "description": "请求ID，用于幂等性" }, "question_count": { "type": "integer", "description": "题目数量", "format": "int32" }, "question_types": { "type": "object", "description": "题型及数量é\u0085ç½®ï¼ˆä¸æä¾›åˆ™ä½¿ç”¨æ™ºèƒ½ç”Ÿæˆæ¨¡å¼ï¼ŒAI自动判断题型和数量），支持 List\u003cString\u003e 或 Map\u003cString, Integer\u003e" }, "difficulty": { "type": "integer", "description": "难度等级（1-5），默认3", "format": "int32" }, "collection_name": { "type": "string", "description": "向量库名称" }, "collection": { "type": "object", "description": "向量库，支持单个字符串或字符串数组" }, "file_path": { "type": "string", "description": "文件路径（file_id 和 file_path 二选一）" }, "file_id": { "type": "integer", "description": "文件ID（file_id 和 file_path 二选一，推荐使用）", "format": "int64" }, "tags": { "type": "array", "description": "标签列表", "items": { "type": "string", "description": "标签列表" } }, "question_scores": { "type": "object", "additionalProperties": { "type": "number", "description": "自定义题型分数é\u0085ç½®ï¼Œä»\u0085在指定题型模式下有效" }, "description": "自定义题型分数é\u0085ç½®ï¼Œä»\u0085在指定题型模式下有效" }, "exclude_stems": { "type": "array", "description": "已有题目的题干列表，用于去重，最多100条", "items": { "type": "string", "description": "已有题目的题干列表，用于去重，最多100条" } } }, "description": "题目生成请求" }, "UserAnswerQueryRequest": { "type": "object", "properties": { "paper_id": { "type": "string" }, "session_id": { "type": "string" }, "user_id": { "type": "integer", "format": "int64" } } }, "AnswerGroup": { "type": "object", "properties": { "group_type": { "type": "string" }, "group_id": { "type": "string" }, "group_name": { "type": "string" }, "total_score": { "type": "number" }, "total_max_score": { "type": "number" }, "score_rate": { "type": "number" }, "answer_count": { "type": "integer", "format": "int32" }, "correct_count": { "type": "integer", "format": "int32" }, "created_at": { "type": "string", "format": "date-time" }, "answers": { "type": "array", "items": { "$ref": "#/components/schemas/AnswerDetail" } } } }, "ResultUserAnswerQueryResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/UserAnswerQueryResponse" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "UserAnswerQueryResponse": { "type": "object", "properties": { "success": { "type": "boolean" }, "groups": { "type": "array", "items": { "$ref": "#/components/schemas/AnswerGroup" } }, "total_count": { "type": "integer", "format": "int32" } } }, "DepartmentCreateRequest": { "type": "object", "properties": { "deptName": { "type": "string" }, "parentId": { "type": "integer", "format": "int64" }, "deptType": { "type": "string" }, "orderNum": { "type": "integer", "format": "int32" } } }, "LoginRequest": { "type": "object", "properties": { "username": { "type": "string" }, "password": { "type": "string" } } }, "LoginResponse": { "type": "object", "properties": { "token": { "type": "string" }, "refreshToken": { "type": "string" }, "expiresIn": { "type": "integer", "format": "int64" }, "userInfo": { "$ref": "#/components/schemas/UserInfoVO" } } }, "ResultLoginResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/LoginResponse" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "UserInfoVO": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "username": { "type": "string" }, "realName": { "type": "string" }, "email": { "type": "string" }, "phone": { "type": "string" }, "avatar": { "type": "string" }, "userType": { "type": "integer", "format": "int32" }, "lastLoginTime": { "type": "string", "format": "date-time" } } }, "ExamPublishRequest": { "type": "object", "properties": { "deptId": { "type": "integer", "format": "int64" }, "deptIds": { "type": "array", "items": { "type": "integer", "format": "int64" } }, "userIds": { "type": "array", "items": { "type": "integer", "format": "int64" } }, "excludeUserIds": { "type": "array", "items": { "type": "integer", "format": "int64" } }, "publishTime": { "type": "string", "format": "date-time" }, "deadline": { "type": "string", "format": "date-time" } } }, "ExamPaperSaveRequest": { "type": "object", "properties": { "title": { "type": "string" }, "description": { "type": "string" }, "totalScore": { "type": "number" }, "duration": { "type": "integer", "format": "int32" }, "permissionScope": { "type": "string" }, "questionIds": { "type": "array", "items": { "type": "string" } } } }, "ExamPaperResponse": { "type": "object", "properties": { "paperId": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "totalScore": { "type": "number" }, "duration": { "type": "integer", "format": "int32" }, "questionCount": { "type": "integer", "format": "int32" }, "status": { "type": "string" }, "permissionScope": { "type": "string" }, "deptId": { "type": "integer", "format": "int64" }, "deptIds": { "type": "array", "items": { "type": "integer", "format": "int64" } }, "userIds": { "type": "array", "items": { "type": "integer", "format": "int64" } }, "excludeUserIds": { "type": "array", "items": { "type": "integer", "format": "int64" } }, "questions": { "type": "array", "items": { "$ref": "#/components/schemas/ExamPaperQuestion" } }, "createdBy": { "type": "integer", "format": "int64" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "publishTime": { "type": "string", "format": "date-time" }, "deadline": { "type": "string", "format": "date-time" } } }, "ResultExamPaperResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/ExamPaperResponse" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ExamPaperPreviewResponse": { "type": "object", "properties": { "questions": { "type": "array", "items": { "$ref": "#/components/schemas/ExamPaperQuestionDetail" } }, "paper_id": { "type": "string" }, "paper_title": { "type": "string" }, "description": { "type": "string" }, "total_score": { "type": "number" }, "question_count": { "type": "integer", "format": "int32" }, "duration": { "type": "integer", "format": "int32" }, "generated_at": { "type": "string", "format": "date-time" }, "permission_scope": { "type": "string" }, "warnings": { "type": "object", "additionalProperties": { "type": "string" } } } }, "ExamPaperQuestionDetail": { "type": "object", "properties": { "difficulty": { "type": "integer", "format": "int32" }, "score": { "type": "number" }, "content": { "$ref": "#/components/schemas/QuestionContent" }, "question_id": { "type": "string" }, "question_type": { "type": "string" }, "question_type_name": { "type": "string" }, "difficulty_name": { "type": "string" }, "document_name": { "type": "string" }, "knowledge_base_path": { "type": "string" }, "source_context": { "type": "string" }, "page_numbers": { "type": "array", "items": { "type": "integer", "format": "int32" } } } }, "ResultExamPaperPreviewResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/ExamPaperPreviewResponse" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ResultBoolean": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "boolean" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ResultUserVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/UserVO" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "UserVO": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "username": { "type": "string" }, "realName": { "type": "string" }, "email": { "type": "string" }, "phone": { "type": "string" }, "deptId": { "type": "integer", "format": "int64" }, "deptName": { "type": "string" }, "userType": { "type": "integer", "format": "int32" }, "status": { "type": "string" }, "roles": { "type": "array", "items": { "type": "string" } }, "createTime": { "type": "string", "format": "date-time" } } }, "PageResultUserVO": { "type": "object", "properties": { "records": { "type": "array", "items": { "$ref": "#/components/schemas/UserVO" } }, "total": { "type": "integer", "format": "int64" }, "size": { "type": "integer", "format": "int64" }, "current": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultUserVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultUserVO" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ResultListRoleVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/RoleVO" } }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "RoleVO": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "roleName": { "type": "string" }, "roleCode": { "type": "string" }, "uuid": { "type": "string" }, "roleType": { "type": "integer", "format": "int32" }, "sortOrder": { "type": "integer", "format": "int32" }, "description": { "type": "string" }, "createTime": { "type": "string", "format": "date-time" }, "updateTime": { "type": "string", "format": "date-time" } } }, "PermissionVO": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "permissionName": { "type": "string" }, "permissionCode": { "type": "string" }, "parentId": { "type": "integer", "format": "int64" }, "type": { "type": "integer", "format": "int32" }, "path": { "type": "string" }, "icon": { "type": "string" }, "sortOrder": { "type": "integer", "format": "int32" }, "createTime": { "type": "string", "format": "date-time" } } }, "ResultListPermissionVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/PermissionVO" } }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ResultListQuestion": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Question" } }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "PageResultQuestion": { "type": "object", "properties": { "records": { "type": "array", "items": { "$ref": "#/components/schemas/Question" } }, "total": { "type": "integer", "format": "int64" }, "size": { "type": "integer", "format": "int64" }, "current": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultQuestion": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultQuestion" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "OperationLogVO": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "userId": { "type": "integer", "format": "int64" }, "userName": { "type": "string" }, "operation": { "type": "string" }, "content": { "type": "string" }, "ip": { "type": "string" }, "createTime": { "type": "string", "format": "date-time" } } }, "PageResultOperationLogVO": { "type": "object", "properties": { "records": { "type": "array", "items": { "$ref": "#/components/schemas/OperationLogVO" } }, "total": { "type": "integer", "format": "int64" }, "size": { "type": "integer", "format": "int64" }, "current": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultOperationLogVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultOperationLogVO" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ImageStatsResponse": { "type": "object", "properties": { "success": { "type": "boolean" }, "total": { "type": "integer", "format": "int32" }, "total_size": { "type": "integer", "format": "int64" }, "total_size_bytes": { "type": "integer", "format": "int64" }, "total_size_mb": { "type": "number", "format": "double" } } }, "ResultImageStatsResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/ImageStatsResponse" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ImageItem": { "type": "object", "properties": { "image_id": { "type": "string" }, "filename": { "type": "string" }, "url": { "type": "string" }, "size": { "type": "integer", "format": "int64" }, "size_bytes": { "type": "integer", "format": "int64" }, "format": { "type": "string" }, "collection": { "type": "string" }, "page": { "type": "integer", "format": "int32" }, "created_at": { "type": "string" } } }, "ImageListResponse": { "type": "object", "properties": { "success": { "type": "boolean" }, "images": { "type": "array", "items": { "$ref": "#/components/schemas/ImageItem" } }, "total": { "type": "integer", "format": "int32" }, "limit": { "type": "integer", "format": "int32" }, "offset": { "type": "integer", "format": "int32" } } }, "ResultImageListResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/ImageListResponse" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ResultString": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "string" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "FilePermission": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "fileId": { "type": "integer", "format": "int64" }, "userId": { "type": "integer", "format": "int64" }, "deptId": { "type": "integer", "format": "int64" }, "permissionType": { "type": "integer", "format": "int32" }, "grantUserId": { "type": "integer", "format": "int64" }, "expireTime": { "type": "string", "format": "date-time" }, "createTime": { "type": "string", "format": "date-time" } } }, "ResultListFilePermission": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/FilePermission" } }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "PageResultFileVO": { "type": "object", "properties": { "records": { "type": "array", "items": { "$ref": "#/components/schemas/FileVO" } }, "total": { "type": "integer", "format": "int64" }, "size": { "type": "integer", "format": "int64" }, "current": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultFileVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultFileVO" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ResultByte[]": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "type": "string", "format": "byte" } }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "FAQItem": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "question": { "type": "string" }, "answer": { "type": "string" }, "source_documents": { "type": "string" }, "avg_rating": { "type": "number" }, "avg_rating_dbl": { "type": "number", "format": "double" }, "frequency": { "type": "integer", "format": "int32" }, "status": { "type": "string" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } } }, "FAQListResponse": { "type": "object", "properties": { "success": { "type": "boolean" }, "faqs": { "type": "array", "items": { "$ref": "#/components/schemas/FAQItem" } }, "total": { "type": "integer", "format": "int32" } } }, "ResultFAQListResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/FAQListResponse" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "FAQSuggestionItem": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "query": { "type": "string" }, "answer": { "type": "string" }, "avg_rating": { "type": "number" }, "avg_rating_dbl": { "type": "number", "format": "double" }, "frequency": { "type": "integer", "format": "int32" }, "status": { "type": "string" }, "faq_id": { "type": "integer", "format": "int64" }, "created_at": { "type": "string" } } }, "FAQSuggestionListResponse": { "type": "object", "properties": { "success": { "type": "boolean" }, "suggestions": { "type": "array", "items": { "$ref": "#/components/schemas/FAQSuggestionItem" } }, "total": { "type": "integer", "format": "int32" } } }, "ResultFAQSuggestionListResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/FAQSuggestionListResponse" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ResultListFAQ": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/FAQ" } }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "DepartmentVO": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "deptName": { "type": "string" }, "parentId": { "type": "integer", "format": "int64" }, "parentName": { "type": "string" }, "deptType": { "type": "string" }, "deptTypeName": { "type": "string" }, "deptLevel": { "type": "integer", "format": "int32" }, "sortOrder": { "type": "integer", "format": "int32" }, "remark": { "type": "string" }, "status": { "type": "string" }, "createTime": { "type": "string", "format": "date-time" }, "updateTime": { "type": "string", "format": "date-time" } } }, "ResultListDepartmentVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/DepartmentVO" } }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ResultListUserVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/UserVO" } }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ResultValidationResult": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/ValidationResult" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ValidationIssue": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "severity": { "type": "string" } } }, "ValidationResult": { "type": "object", "properties": { "userId": { "type": "integer", "format": "int64" }, "paperId": { "type": "string" }, "sessionId": { "type": "string" }, "validationTime": { "type": "string", "format": "date-time" }, "totalAnswers": { "type": "integer", "format": "int32" }, "correctCount": { "type": "integer", "format": "int32" }, "wrongCount": { "type": "integer", "format": "int32" }, "partialCount": { "type": "integer", "format": "int32" }, "unknownCount": { "type": "integer", "format": "int32" }, "collectedCount": { "type": "integer", "format": "int32" }, "uniquePaperCount": { "type": "integer", "format": "int32" }, "uniqueSessionCount": { "type": "integer", "format": "int32" }, "uniqueQuestionCount": { "type": "integer", "format": "int32" }, "success": { "type": "boolean" }, "message": { "type": "string" }, "issues": { "type": "array", "items": { "$ref": "#/components/schemas/ValidationIssue" } } } }, "ResultListCollectionVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/CollectionVO" } }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ResultListMapStringObject": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "type": "object", "additionalProperties": { "type": "object" } } }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "KnowledgeBasePath": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "name": { "type": "string" }, "path": { "type": "string" }, "uploader": { "type": "string" }, "department": { "type": "string" }, "ownerType": { "type": "string" }, "visibility": { "type": "string" }, "fileSize": { "type": "integer", "format": "int64" }, "displayName": { "type": "string" }, "description": { "type": "string" }, "createTime": { "type": "string", "format": "date-time" }, "updateTime": { "type": "string", "format": "date-time" }, "syncStatus": { "type": "string" }, "lastSyncTime": { "type": "string", "format": "date-time" }, "syncMessage": { "type": "string" } } }, "ResultKnowledgeBasePath": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/KnowledgeBasePath" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "PageResultKnowledgeBasePath": { "type": "object", "properties": { "records": { "type": "array", "items": { "$ref": "#/components/schemas/KnowledgeBasePath" } }, "total": { "type": "integer", "format": "int64" }, "size": { "type": "integer", "format": "int64" }, "current": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultKnowledgeBasePath": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultKnowledgeBasePath" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ResultListString": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "type": "string" } }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ResultMapStringString": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "object", "additionalProperties": { "type": "string" } }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ResultUserInfoVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/UserInfoVO" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ChatMessage": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "conversationId": { "type": "integer", "format": "int64" }, "role": { "type": "string" }, "content": { "type": "string" }, "messageType": { "type": "string" }, "isFinished": { "type": "integer", "format": "int32" }, "summary": { "type": "string" }, "kbPaths": { "type": "string" }, "answer": { "type": "string" }, "mode": { "type": "string" }, "durationMs": { "type": "integer", "format": "int64" }, "images": { "type": "string" }, "createTime": { "type": "string", "format": "date-time" } } }, "ResultListChatMessage": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ChatMessage" } }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "Feedback": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "feedbackId": { "type": "string" }, "sessionId": { "type": "string" }, "userId": { "type": "integer", "format": "int64" }, "query": { "type": "string" }, "answer": { "type": "string" }, "rating": { "type": "integer", "format": "int32" }, "reason": { "type": "string" }, "sources": { "type": "string" }, "faqSuggested": { "type": "integer", "format": "int32" }, "suggestionId": { "type": "integer", "format": "int64" }, "createdAt": { "type": "string", "format": "date-time" } } }, "ResultListFeedback": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Feedback" } }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "PageResponseExamRecordResponse": { "type": "object", "properties": { "records": { "type": "array", "items": { "$ref": "#/components/schemas/ExamRecordResponse" } }, "total": { "type": "integer", "format": "int64" }, "page": { "type": "integer", "format": "int32" }, "pageSize": { "type": "integer", "format": "int32" } } }, "ResultPageResponseExamRecordResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResponseExamRecordResponse" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "PageResponseExamPaperResponse": { "type": "object", "properties": { "records": { "type": "array", "items": { "$ref": "#/components/schemas/ExamPaperResponse" } }, "total": { "type": "integer", "format": "int64" }, "page": { "type": "integer", "format": "int32" }, "pageSize": { "type": "integer", "format": "int32" } } }, "ResultPageResponseExamPaperResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResponseExamPaperResponse" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } }, "ResultInteger": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "integer", "format": "int32" }, "timestamp": { "type": "string" }, "success": { "type": "boolean" } } } }, "securitySchemes": { "Bearer Authentication": { "type": "http", "description": "JWT Token，格式：Bearer {token}", "scheme": "bearer", "bearerFormat": "JWT" } } } }