guxz/my-springboot-project
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
f3543f41886f94c7db14864d372cbe7ac934c8bf
my-springboot-project/docs/openapi.json
guxz f3543f4188 1.修复创建多个向量库
2026-06-09 13:34:21 +08:00

14358 lines
1.5 MiB
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{
"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"
}
}
}
}
Reference in New Issue View Git Blame Copy Permalink