{ "openapi": "3.0.1", "info": { "title": "Reading Platform API", "description": "Reading Platform Backend Service API Documentation", "contact": { "name": "Reading Platform Team", "email": "support@reading-platform.com" }, "version": "1.0.0" }, "servers": [ { "url": "http://localhost:8480", "description": "Generated server url" } ], "security": [ { "Bearer": [] } ], "tags": [ { "name": "教师端 - 课时管理", "description": "教师端课时 API" }, { "name": "学校端 - 阅读任务(只读)", "description": "学校端阅读任务查看 API" }, { "name": "超管 - 系统设置", "description": "Admin Settings APIs" }, { "name": "学校端 - 操作日志", "description": "School Operation Log APIs" }, { "name": "教师端 - 反馈管理", "description": "教师端反馈 API" }, { "name": "Parent - Growth Record", "description": "Growth Record APIs for Parent (read-only)" }, { "name": "School - Parent", "description": "Parent Management APIs for School" }, { "name": "Parent - Child", "description": "Child Information APIs for Parent" }, { "name": "学校端 - 排课管理", "description": "School Schedule APIs" }, { "name": "教师端 - 任务模板", "description": "教师端任务模板 API" }, { "name": "教师端 - 任务管理", "description": "教师端任务 API" }, { "name": "阿里云 IMM 服务", "description": "WebOffice 文档预览和编辑相关接口" }, { "name": "学校端 - 反馈管理", "description": "School Feedback APIs" }, { "name": "教师端 - 排课管理", "description": "教师端排课 API" }, { "name": "教师端 - 课程管理", "description": "教师端课程 API" }, { "name": "School - Student", "description": "Student Management APIs for School" }, { "name": "School - Class", "description": "Class Management APIs for School" }, { "name": "教师端 - 成长记录", "description": "教师端成长记录 API" }, { "name": "教师端 - 通知管理", "description": "教师端通知 API" }, { "name": "学校端 - 数据报告", "description": "School Report APIs" }, { "name": "学校端 - 数据导出", "description": "School Export APIs" }, { "name": "家长端 - 任务管理", "description": "家长端任务 API" }, { "name": "教师端 - 统计数据", "description": "教师端统计数据 API" }, { "name": "School - Teacher", "description": "Teacher Management APIs for School" }, { "name": "认证管理", "description": "Authentication APIs" }, { "name": "超管端 - 租户管理", "description": "Tenant Management APIs for Admin" }, { "name": "学校端 - 任务模板", "description": "School Task Template APIs" }, { "name": "学校端 - 系统设置", "description": "School Settings APIs" }, { "name": "School - Growth Record", "description": "Growth Record Management APIs for School" }, { "name": "Parent - Notification", "description": "Notification APIs for Parent" } ], "paths": { "/api/v1/teacher/tasks/{id}": { "get": { "tags": [ "教师端 - 任务管理" ], "summary": "根据 ID 获取任务", "operationId": "getTask", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTaskResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "教师端 - 任务管理" ], "summary": "更新任务", "operationId": "updateTask", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTaskResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "教师端 - 任务管理" ], "summary": "删除任务", "operationId": "deleteTask", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/tasks/completions/{completionId}/feedback": { "put": { "tags": [ "教师端 - 任务管理" ], "summary": "修改评价", "operationId": "updateFeedback", "parameters": [ { "name": "completionId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskFeedbackRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTaskFeedbackResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "教师端 - 任务管理" ], "summary": "提交评价", "operationId": "submitFeedback", "parameters": [ { "name": "completionId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskFeedbackRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTaskFeedbackResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/task-templates/{id}": { "get": { "tags": [ "教师端 - 任务模板" ], "summary": "获取模板详情", "operationId": "getTemplate", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTaskTemplateResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "教师端 - 任务模板" ], "summary": "更新模板", "operationId": "updateTemplate", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskTemplateCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTaskTemplateResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "教师端 - 任务模板" ], "summary": "删除模板", "operationId": "deleteTemplate", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/schedules/{id}": { "get": { "tags": [ "教师端 - 排课管理" ], "summary": "获取排课详情", "operationId": "getSchedule", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultSchedulePlanResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "教师端 - 排课管理" ], "summary": "更新排课", "operationId": "updateSchedule", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SchedulePlanUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultSchedulePlanResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "教师端 - 排课管理" ], "summary": "取消排课", "operationId": "cancelSchedule", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/lessons/{id}": { "get": { "tags": [ "教师端 - 课时管理" ], "summary": "根据 ID 获取课时(含课程、班级,供上课页面使用)", "operationId": "getLesson", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultLessonDetailResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "教师端 - 课时管理" ], "summary": "更新课时", "operationId": "updateLesson", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LessonUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultLessonResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/lessons/{id}/progress": { "get": { "tags": [ "教师端 - 课时管理" ], "summary": "获取课时进度", "operationId": "getLessonProgress", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultLessonResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "教师端 - 课时管理" ], "summary": "保存课时进度", "operationId": "saveLessonProgress", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LessonProgressRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/growth-records/{id}": { "get": { "tags": [ "教师端 - 成长记录" ], "summary": "根据 ID 获取成长记录", "operationId": "getGrowthRecord", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultGrowthRecord" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "教师端 - 成长记录" ], "summary": "更新成长记录", "operationId": "updateGrowthRecord", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GrowthRecordUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultGrowthRecord" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "教师端 - 成长记录" ], "summary": "删除成长记录", "operationId": "deleteGrowthRecord", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/teachers/{id}": { "get": { "tags": [ "School - Teacher" ], "summary": "Get teacher by ID", "operationId": "getTeacher", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTeacherResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "School - Teacher" ], "summary": "Update teacher", "operationId": "updateTeacher", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TeacherUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTeacherResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "School - Teacher" ], "summary": "Delete teacher", "operationId": "deleteTeacher", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/task-templates/{id}": { "get": { "tags": [ "学校端 - 任务模板" ], "summary": "获取模板详情", "operationId": "getTemplate_1", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTaskTemplateResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "学校端 - 任务模板" ], "summary": "更新模板", "operationId": "updateTemplate_1", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskTemplateCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTaskTemplateResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "学校端 - 任务模板" ], "summary": "删除模板", "operationId": "deleteTemplate_1", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/students/{id}": { "get": { "tags": [ "School - Student" ], "summary": "Get student by ID", "operationId": "getStudent", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultStudentResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "School - Student" ], "summary": "Update student", "operationId": "updateStudent", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StudentUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultStudentResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "School - Student" ], "summary": "Delete student", "operationId": "deleteStudent", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/settings": { "get": { "tags": [ "学校端 - 系统设置" ], "summary": "获取系统设置", "operationId": "getSettings", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultSchoolSettingsResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "学校端 - 系统设置" ], "summary": "更新系统设置", "operationId": "updateSettings", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SchoolSettingsUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultSchoolSettingsResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/settings/security": { "get": { "tags": [ "学校端 - 系统设置" ], "summary": "获取安全设置", "operationId": "getSecuritySettings", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultSecuritySettingsResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "学校端 - 系统设置" ], "summary": "更新安全设置", "operationId": "updateSecuritySettings", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecuritySettingsUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultSecuritySettingsResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/settings/notification": { "get": { "tags": [ "学校端 - 系统设置" ], "summary": "获取通知设置", "operationId": "getNotificationSettings", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultNotificationSettingsResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "学校端 - 系统设置" ], "summary": "更新通知设置", "operationId": "updateNotificationSettings", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotificationSettingsUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultNotificationSettingsResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/settings/basic": { "get": { "tags": [ "学校端 - 系统设置" ], "summary": "获取基础设置", "operationId": "getBasicSettings", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultBasicSettingsResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "学校端 - 系统设置" ], "summary": "更新基础设置", "operationId": "updateBasicSettings", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BasicSettingsUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultBasicSettingsResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/schedules/{id}": { "get": { "tags": [ "学校端 - 排课管理" ], "summary": "获取排课详情", "operationId": "getSchedule_1", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultSchedulePlanResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "学校端 - 排课管理" ], "summary": "更新排课", "operationId": "updateSchedule_1", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SchedulePlanUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultSchedulePlanResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "学校端 - 排课管理" ], "summary": "取消排课", "operationId": "cancelSchedule_1", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/parents/{id}": { "get": { "tags": [ "School - Parent" ], "summary": "Get parent by ID", "operationId": "getParent", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultParentResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "School - Parent" ], "summary": "Update parent", "operationId": "updateParent", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ParentUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultParentResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "School - Parent" ], "summary": "Delete parent", "operationId": "deleteParent", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/growth-records/{id}": { "get": { "tags": [ "School - Growth Record" ], "summary": "Get growth record by ID", "operationId": "getGrowthRecord_1", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultGrowthRecordResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "School - Growth Record" ], "summary": "Update growth record", "operationId": "updateGrowthRecord_1", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GrowthRecordUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultGrowthRecordResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "School - Growth Record" ], "summary": "Delete growth record", "operationId": "deleteGrowthRecord_1", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/classes/{id}": { "get": { "tags": [ "School - Class" ], "summary": "Get class by ID", "operationId": "getClass", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultClassResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "School - Class" ], "summary": "Update class", "operationId": "updateClass", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClassUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultClassResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "School - Class" ], "summary": "Delete class", "operationId": "deleteClass", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/classes/{id}/teachers/{teacherId}": { "put": { "tags": [ "School - Class" ], "summary": "Update class teacher role", "operationId": "updateClassTeacher", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "teacherId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "School - Class" ], "summary": "Remove teacher from class", "operationId": "removeClassTeacher", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "teacherId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/parent/tasks/{taskId}/submit": { "put": { "tags": [ "家长端 - 任务管理" ], "summary": "修改任务提交", "operationId": "updateSubmission", "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskSubmitRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTaskCompletionDetailResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "家长端 - 任务管理" ], "summary": "提交任务完成", "operationId": "submitTask", "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskSubmitRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTaskCompletionDetailResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/themes/{id}": { "get": { "tags": [ "超管端 - 主题字典" ], "summary": "查询主题详情", "operationId": "findOne", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultThemeResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "超管端 - 主题字典" ], "summary": "更新主题", "operationId": "update", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThemeCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultThemeResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "超管端 - 主题字典" ], "summary": "删除主题", "operationId": "delete", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/themes/reorder": { "put": { "tags": [ "超管端 - 主题字典" ], "summary": "重新排序主题", "operationId": "reorder", "requestBody": { "content": { "application/json": { "schema": { "type": "array", "items": { "type": "integer", "format": "int64" } } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/tenants/{id}": { "get": { "tags": [ "超管端 - 租户管理" ], "summary": "Get tenant by ID", "operationId": "getTenant", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTenantResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "超管端 - 租户管理" ], "summary": "Update tenant", "operationId": "updateTenant", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TenantUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTenantResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "超管端 - 租户管理" ], "summary": "Delete tenant", "operationId": "deleteTenant", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/tenants/{id}/status": { "put": { "tags": [ "超管端 - 租户管理" ], "summary": "更新租户状态", "operationId": "updateTenantStatus", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTenantResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/tenants/{id}/quota": { "put": { "tags": [ "超管端 - 租户管理" ], "summary": "更新租户配额", "operationId": "updateTenantQuota", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTenantResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/settings": { "get": { "tags": [ "超管 - 系统设置" ], "summary": "获取所有系统设置", "operationId": "getAllSettings", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "超管 - 系统设置" ], "summary": "更新系统设置", "operationId": "updateSettings_1", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/settings/storage": { "get": { "tags": [ "超管 - 系统设置" ], "summary": "获取存储设置", "operationId": "getStorageSettings", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "超管 - 系统设置" ], "summary": "更新存储设置", "operationId": "updateStorageSettings", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/settings/security": { "get": { "tags": [ "超管 - 系统设置" ], "summary": "获取安全设置", "operationId": "getSecuritySettings_1", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "超管 - 系统设置" ], "summary": "更新安全设置", "operationId": "updateSecuritySettings_1", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/settings/notification": { "get": { "tags": [ "超管 - 系统设置" ], "summary": "获取通知设置", "operationId": "getNotificationSettings_1", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "超管 - 系统设置" ], "summary": "更新通知设置", "operationId": "updateNotificationSettings_1", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/settings/basic": { "get": { "tags": [ "超管 - 系统设置" ], "summary": "获取基础设置", "operationId": "getBasicSettings_1", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "超管 - 系统设置" ], "summary": "更新基础设置", "operationId": "updateBasicSettings_1", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/resources/libraries/{id}": { "get": { "tags": [ "超管端 - 资源库" ], "summary": "查询资源库详情", "operationId": "findLibrary", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultResourceLibraryResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "超管端 - 资源库" ], "summary": "更新资源库", "operationId": "updateLibrary", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceLibraryUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultResourceLibraryResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "超管端 - 资源库" ], "summary": "删除资源库", "operationId": "deleteLibrary", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/resources/items/{id}": { "get": { "tags": [ "超管端 - 资源库" ], "summary": "查询资源项目详情", "operationId": "findItem", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultResourceItemResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "超管端 - 资源库" ], "summary": "更新资源项目", "operationId": "updateItem", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceItemUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultResourceItemResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "超管端 - 资源库" ], "summary": "删除资源项目", "operationId": "deleteItem", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/packages/{id}": { "get": { "tags": [ "超管端 - 课程包管理" ], "summary": "查询课程包详情", "operationId": "getCourse_1", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultCourseResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "超管端 - 课程包管理" ], "summary": "更新课程包", "operationId": "updateCourse", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CourseUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultCourseResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "超管端 - 课程包管理" ], "summary": "删除课程包", "operationId": "deleteCourse", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/courses/{courseId}/lessons/{lessonId}/steps/reorder": { "put": { "tags": [ "超管端 - 课程环节" ], "summary": "重新排序教学环节", "operationId": "reorderSteps", "parameters": [ { "name": "courseId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "lessonId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "array", "items": { "type": "integer", "format": "int64" } } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/courses/{courseId}/lessons/{id}": { "get": { "tags": [ "超管端 - 课程环节" ], "summary": "获取课程环节详情", "operationId": "findOne_1", "parameters": [ { "name": "courseId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultCourseLessonResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "超管端 - 课程环节" ], "summary": "更新课程环节", "operationId": "update_1", "parameters": [ { "name": "courseId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CourseLessonCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultCourseLessonResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "超管端 - 课程环节" ], "summary": "删除课程环节", "operationId": "delete_1", "parameters": [ { "name": "courseId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/courses/{courseId}/lessons/steps/{stepId}": { "put": { "tags": [ "超管端 - 课程环节" ], "summary": "更新教学环节", "operationId": "updateStep", "parameters": [ { "name": "courseId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "stepId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LessonStepCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultLessonStepResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "超管端 - 课程环节" ], "summary": "删除教学环节", "operationId": "removeStep", "parameters": [ { "name": "courseId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "stepId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/courses/{courseId}/lessons/reorder": { "put": { "tags": [ "超管端 - 课程环节" ], "summary": "重新排序课程环节", "operationId": "reorder_1", "parameters": [ { "name": "courseId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "array", "items": { "type": "integer", "format": "int64" } } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/collections/{id}": { "get": { "tags": [ "超管端 - 课程套餐管理" ], "summary": "查询课程套餐详情", "operationId": "findOne_2", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultCourseCollectionResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "put": { "tags": [ "超管端 - 课程套餐管理" ], "summary": "更新课程套餐", "operationId": "update_2", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateCollectionRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultCourseCollectionResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "超管端 - 课程套餐管理" ], "summary": "删除课程套餐", "operationId": "delete_2", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/collections/{id}/packages": { "put": { "tags": [ "超管端 - 课程套餐管理" ], "summary": "设置套餐课程包", "operationId": "setPackages", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "array", "items": { "type": "integer", "format": "int64" } } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/tasks": { "get": { "tags": [ "教师端 - 任务管理" ], "summary": "获取任务分页列表", "operationId": "getTaskPage", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "taskType", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultTaskResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "教师端 - 任务管理" ], "summary": "创建任务", "operationId": "createTask", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTaskResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/task-templates": { "get": { "tags": [ "教师端 - 任务模板" ], "summary": "获取模板列表", "operationId": "getTemplates", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultTaskTemplateResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "教师端 - 任务模板" ], "summary": "创建模板", "operationId": "createTemplate", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskTemplateCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTaskTemplateResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/task-templates/from-template": { "post": { "tags": [ "教师端 - 任务模板" ], "summary": "从模板创建任务", "operationId": "createFromTemplate", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateTaskFromTemplateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTask" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/schedules": { "get": { "tags": [ "教师端 - 排课管理" ], "summary": "获取教师排课列表", "operationId": "getSchedules", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "startDate", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "endDate", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultSchedulePlanResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "教师端 - 排课管理" ], "summary": "创建排课", "operationId": "createSchedule", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SchedulePlanCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultSchedulePlanResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/notifications/{id}/read": { "post": { "tags": [ "教师端 - 通知管理" ], "summary": "标记通知为已读", "operationId": "markAsRead", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/notifications/read-all": { "post": { "tags": [ "教师端 - 通知管理" ], "summary": "标记所有通知为已读", "operationId": "markAllAsRead", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/lessons": { "get": { "tags": [ "教师端 - 课时管理" ], "summary": "获取我的课时列表", "operationId": "getMyLessons", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "startDate", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "endDate", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultLessonResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "教师端 - 课时管理" ], "summary": "创建课时", "operationId": "createLesson", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LessonCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultLessonResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/lessons/{id}/students/{studentId}/record": { "post": { "tags": [ "教师端 - 课时管理" ], "summary": "保存学生记录", "operationId": "saveStudentRecord", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "studentId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StudentRecordRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultStudentRecordResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/lessons/{id}/students/batch-records": { "post": { "tags": [ "教师端 - 课时管理" ], "summary": "批量保存学生记录", "operationId": "batchSaveStudentRecords", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BatchStudentRecordsRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListStudentRecordResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/lessons/{id}/start": { "post": { "tags": [ "教师端 - 课时管理" ], "summary": "开始上课", "operationId": "startLesson", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/lessons/{id}/feedback": { "get": { "tags": [ "教师端 - 课时管理" ], "summary": "获取课时反馈", "operationId": "getLessonFeedback", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultLessonFeedback" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "教师端 - 课时管理" ], "summary": "提交课时反馈", "operationId": "submitFeedback_1", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LessonFeedbackRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultLessonFeedback" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/lessons/{id}/complete": { "post": { "tags": [ "教师端 - 课时管理" ], "summary": "完成课时", "operationId": "completeLesson", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/lessons/{id}/cancel": { "post": { "tags": [ "教师端 - 课时管理" ], "summary": "取消课时", "operationId": "cancelLesson", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/lessons/from-schedule/{schedulePlanId}": { "post": { "tags": [ "教师端 - 课时管理" ], "summary": "从排课创建课时", "operationId": "createLessonFromSchedule", "parameters": [ { "name": "schedulePlanId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultLessonResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/lessons/from-schedule/{schedulePlanId}/start": { "post": { "tags": [ "教师端 - 课时管理" ], "summary": "从排课开始上课", "operationId": "startLessonFromSchedule", "parameters": [ { "name": "schedulePlanId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultLessonResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/growth-records": { "get": { "tags": [ "教师端 - 成长记录" ], "summary": "获取成长记录分页列表", "operationId": "getGrowthRecordPage", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "studentId", "in": "query", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultGrowthRecord" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "教师端 - 成长记录" ], "summary": "创建成长记录", "operationId": "createGrowthRecord", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GrowthRecordCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultGrowthRecord" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/teachers": { "get": { "tags": [ "School - Teacher" ], "summary": "Get teacher page", "operationId": "getTeacherPage", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultTeacherResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "School - Teacher" ], "summary": "Create teacher", "operationId": "createTeacher", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TeacherCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTeacherResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/teachers/{id}/reset-password": { "post": { "tags": [ "School - Teacher" ], "summary": "Reset teacher password", "operationId": "resetPassword", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringString" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/task-templates": { "get": { "tags": [ "学校端 - 任务模板" ], "summary": "获取模板列表", "operationId": "getTemplates_1", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "taskType", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultTaskTemplateResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "学校端 - 任务模板" ], "summary": "创建模板", "operationId": "createTemplate_1", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskTemplateCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTaskTemplateResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/students": { "get": { "tags": [ "School - Student" ], "summary": "Get student page", "operationId": "getStudentPage", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "grade", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultStudentResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "School - Student" ], "summary": "Create student", "operationId": "createStudent", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StudentCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultStudentResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/schedules": { "get": { "tags": [ "学校端 - 排课管理" ], "summary": "获取排课列表", "operationId": "getSchedules_1", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "startDate", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "endDate", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "classId", "in": "query", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "teacherId", "in": "query", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultSchedulePlanResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "学校端 - 排课管理" ], "summary": "创建排课", "operationId": "createSchedule_1", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SchedulePlanCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListSchedulePlanResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/schedules/check-conflict": { "post": { "tags": [ "学校端 - 排课管理" ], "summary": "检测排课冲突", "operationId": "checkConflict", "parameters": [ { "name": "classId", "in": "query", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "teacherId", "in": "query", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "scheduledDate", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "scheduledTime", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultConflictCheckResult" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/schedules/batch": { "post": { "tags": [ "学校端 - 排课管理" ], "summary": "批量创建排课", "operationId": "batchCreateSchedules", "requestBody": { "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/SchedulePlanCreateRequest" } } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListSchedulePlanResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/schedules/batch-by-classes": { "post": { "tags": [ "学校端 - 排课管理" ], "summary": "批量创建排课(按班级)", "operationId": "createSchedulesByClasses", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScheduleCreateByClassesRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListSchedulePlanResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/parents": { "get": { "tags": [ "School - Parent" ], "summary": "Get parent page", "operationId": "getParentPage", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultParentResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "School - Parent" ], "summary": "Create parent", "operationId": "createParent", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ParentCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultParentResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/parents/{parentId}/students/{studentId}": { "post": { "tags": [ "School - Parent" ], "summary": "Bind student to parent", "operationId": "bindStudent", "parameters": [ { "name": "parentId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "studentId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "relationship", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "isPrimary", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "delete": { "tags": [ "School - Parent" ], "summary": "Unbind student from parent", "operationId": "unbindStudent", "parameters": [ { "name": "parentId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "studentId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/parents/{id}/reset-password": { "post": { "tags": [ "School - Parent" ], "summary": "Reset parent password", "operationId": "resetPassword_1", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "newPassword", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/packages/{collectionId}/renew": { "post": { "tags": [ "学校端 - 课程套餐" ], "summary": "续费课程套餐", "operationId": "renewCollection", "parameters": [ { "name": "collectionId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RenewRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/growth-records": { "get": { "tags": [ "School - Growth Record" ], "summary": "Get growth record page", "operationId": "getGrowthRecordPage_1", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "studentId", "in": "query", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultGrowthRecordResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "School - Growth Record" ], "summary": "Create growth record", "operationId": "createGrowthRecord_1", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GrowthRecordCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultGrowthRecordResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/classes": { "get": { "tags": [ "School - Class" ], "summary": "Get class page", "operationId": "getClassPage", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "grade", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultClassResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "School - Class" ], "summary": "Create class", "operationId": "createClass", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClassCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultClassResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/classes/{id}/teachers": { "get": { "tags": [ "School - Class" ], "summary": "Get teachers of class", "operationId": "getClassTeachers_1", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListClassTeacherResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "School - Class" ], "summary": "Assign teachers to class", "operationId": "assignTeachers", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "array", "items": { "type": "integer", "format": "int64" } } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/classes/{id}/students": { "get": { "tags": [ "School - Class" ], "summary": "Get students of class", "operationId": "getClassStudents_1", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultClassResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "School - Class" ], "summary": "Assign students to class", "operationId": "assignStudents", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "array", "items": { "type": "integer", "format": "int64" } } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/parent/tasks/{id}/complete": { "post": { "tags": [ "家长端 - 任务管理" ], "summary": "完成任务(旧接口,兼容使用,支持 JSON body)", "operationId": "completeTask", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "studentId", "in": "query", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "attachments", "in": "query", "required": false, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskCompleteRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/parent/notifications/{id}/read": { "post": { "tags": [ "Parent - Notification" ], "summary": "Mark notification as read", "operationId": "markAsRead_1", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/parent/notifications/read-all": { "post": { "tags": [ "Parent - Notification" ], "summary": "Mark all notifications as read", "operationId": "markAllAsRead_1", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/imm/token/refresh": { "post": { "tags": [ "阿里云 IMM 服务" ], "summary": "刷新 WebOffice Token", "description": "当 Token 即将过期时刷新", "operationId": "refreshToken", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RefreshTokenRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultImmTokenVo" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/files/upload": { "post": { "tags": [ "文件上传" ], "summary": "上传文件", "operationId": "uploadFile", "parameters": [ { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "default": "other" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "file" ], "type": "object", "properties": { "file": { "type": "string", "format": "binary" } } } } } }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/auth/refresh": { "post": { "tags": [ "认证管理" ], "summary": "刷新 Token", "operationId": "refreshToken_1", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTokenResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/auth/logout": { "post": { "tags": [ "认证管理" ], "summary": "用户登出", "operationId": "logout", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/auth/login": { "post": { "tags": [ "认证管理" ], "summary": "用户登录", "operationId": "login", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LoginRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultLoginResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/auth/change-password": { "post": { "tags": [ "认证管理" ], "summary": "修改密码", "operationId": "changePassword", "parameters": [ { "name": "oldPassword", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "newPassword", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/themes": { "get": { "tags": [ "超管端 - 主题字典" ], "summary": "查询所有主题", "operationId": "findAll", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListThemeResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "超管端 - 主题字典" ], "summary": "创建主题", "operationId": "create", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThemeCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultThemeResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/tenants": { "get": { "tags": [ "超管端 - 租户管理" ], "summary": "Get tenant page", "operationId": "getTenantPage", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultTenantResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "超管端 - 租户管理" ], "summary": "Create tenant", "operationId": "createTenant", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TenantCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTenantResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/tenants/{id}/reset-password": { "post": { "tags": [ "超管端 - 租户管理" ], "summary": "重置租户密码", "operationId": "resetTenantPassword", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/resources/libraries": { "get": { "tags": [ "超管端 - 资源库" ], "summary": "分页查询资源库", "operationId": "findAllLibraries", "parameters": [ { "name": "libraryType", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultResourceLibraryResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "超管端 - 资源库" ], "summary": "创建资源库", "operationId": "createLibrary", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceLibraryCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultResourceLibraryResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/resources/items": { "get": { "tags": [ "超管端 - 资源库" ], "summary": "分页查询资源项目", "operationId": "findAllItems", "parameters": [ { "name": "libraryId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fileType", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pageNum", "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": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultResourceItemResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "超管端 - 资源库" ], "summary": "创建资源项目", "operationId": "createItem", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceItemCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultResourceItemResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/resources/items/batch-delete": { "post": { "tags": [ "超管端 - 资源库" ], "summary": "批量删除资源项目", "operationId": "batchDeleteItems", "requestBody": { "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" } } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/packages": { "get": { "tags": [ "超管端 - 课程包管理" ], "summary": "分页查询课程包", "operationId": "getCoursePage_1", "parameters": [ { "name": "request", "in": "query", "required": true, "schema": { "$ref": "#/components/schemas/CoursePageQueryRequest" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultCourseResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "超管端 - 课程包管理" ], "summary": "创建课程包", "operationId": "createCourse", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CourseCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultCourseResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/packages/{id}/submit": { "post": { "tags": [ "超管端 - 课程包管理" ], "summary": "提交课程包审核", "operationId": "submitCourse", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/packages/{id}/reject": { "post": { "tags": [ "超管端 - 课程包管理" ], "summary": "驳回课程包审核", "operationId": "rejectCourse", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CourseRejectRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/packages/{id}/publish": { "post": { "tags": [ "超管端 - 课程包管理" ], "summary": "发布课程包", "operationId": "publishCourse", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/packages/{id}/archive": { "post": { "tags": [ "超管端 - 课程包管理" ], "summary": "归档课程包", "operationId": "archiveCourse", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/courses/{courseId}/lessons": { "get": { "tags": [ "超管端 - 课程环节" ], "summary": "获取课程的所有环节", "operationId": "findAll_1", "parameters": [ { "name": "courseId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListCourseLessonResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "超管端 - 课程环节" ], "summary": "创建课程环节", "operationId": "create_1", "parameters": [ { "name": "courseId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CourseLessonCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultCourseLessonResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/courses/{courseId}/lessons/{lessonId}/steps": { "get": { "tags": [ "超管端 - 课程环节" ], "summary": "获取课时的教学环节", "operationId": "findSteps", "parameters": [ { "name": "courseId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "lessonId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListLessonStepResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "超管端 - 课程环节" ], "summary": "创建教学环节", "operationId": "createStep", "parameters": [ { "name": "courseId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "lessonId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LessonStepCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultLessonStepResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/collections": { "get": { "tags": [ "超管端 - 课程套餐管理" ], "summary": "分页查询课程套餐", "operationId": "page", "parameters": [ { "name": "request", "in": "query", "required": true, "schema": { "$ref": "#/components/schemas/CourseCollectionPageQueryRequest" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultCourseCollectionResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } }, "post": { "tags": [ "超管端 - 课程套餐管理" ], "summary": "创建课程套餐", "operationId": "create_2", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateCollectionRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultCourseCollectionResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/collections/{id}/withdraw": { "post": { "tags": [ "超管端 - 课程套餐管理" ], "summary": "撤销审核", "operationId": "withdraw", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/collections/{id}/submit": { "post": { "tags": [ "超管端 - 课程套餐管理" ], "summary": "提交审核", "operationId": "submit", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/collections/{id}/republish": { "post": { "tags": [ "超管端 - 课程套餐管理" ], "summary": "重新发布套餐", "operationId": "republish", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/collections/{id}/reject": { "post": { "tags": [ "超管端 - 课程套餐管理" ], "summary": "审核驳回", "operationId": "reject", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CourseCollectionRejectRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/collections/{id}/publish": { "post": { "tags": [ "超管端 - 课程套餐管理" ], "summary": "发布套餐", "operationId": "publish", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/collections/{id}/archive": { "post": { "tags": [ "超管端 - 课程套餐管理" ], "summary": "下架套餐", "operationId": "archive", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/weekly-stats": { "get": { "tags": [ "教师端 - 统计数据" ], "summary": "获取本周统计", "operationId": "getWeeklyStats", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/today-lessons": { "get": { "tags": [ "教师端 - 统计数据" ], "summary": "获取今日课程", "operationId": "getTodayLessons", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListLesson" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/tasks/{taskId}/completions": { "get": { "tags": [ "教师端 - 任务管理" ], "summary": "获取任务完成情况列表", "operationId": "getTaskCompletions", "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultTaskCompletionDetailResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/tasks/completions/{completionId}": { "get": { "tags": [ "教师端 - 任务管理" ], "summary": "获取提交详情", "operationId": "getCompletionDetail", "parameters": [ { "name": "completionId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTaskCompletionDetailResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/task-templates/default/{type}": { "get": { "tags": [ "教师端 - 任务模板" ], "summary": "获取默认模板", "operationId": "getDefaultTemplate", "parameters": [ { "name": "type", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTaskTemplateResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/students": { "get": { "tags": [ "教师端 - 课程管理" ], "summary": "获取教师教授的所有学生", "operationId": "getAllStudents", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultStudentResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/schedules/today": { "get": { "tags": [ "教师端 - 排课管理" ], "summary": "获取今日排课", "operationId": "getTodaySchedules", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListSchedulePlanResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/schedules/timetable": { "get": { "tags": [ "教师端 - 排课管理" ], "summary": "获取教师课程表", "operationId": "getTimetable", "parameters": [ { "name": "startDate", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "endDate", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListTimetableResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/recommended-courses": { "get": { "tags": [ "教师端 - 统计数据" ], "summary": "获取推荐课程", "operationId": "getRecommendedCourses", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListCoursePackage" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/notifications": { "get": { "tags": [ "教师端 - 通知管理" ], "summary": "获取我的通知列表", "operationId": "getMyNotifications", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "isRead", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultNotification" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/notifications/{id}": { "get": { "tags": [ "教师端 - 通知管理" ], "summary": "根据 ID 获取通知", "operationId": "getNotification", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultNotification" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/notifications/unread-count": { "get": { "tags": [ "教师端 - 通知管理" ], "summary": "获取未读数量", "operationId": "getUnreadCount", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultLong" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/lessons/{id}/students/records": { "get": { "tags": [ "教师端 - 课时管理" ], "summary": "获取学生记录", "operationId": "getStudentRecords", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultStudentRecordsResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/lessons/today": { "get": { "tags": [ "教师端 - 课时管理" ], "summary": "获取今日课程", "operationId": "getTodayLessons_1", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListLessonResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/lesson-trend": { "get": { "tags": [ "教师端 - 统计数据" ], "summary": "获取授课趋势", "operationId": "getLessonTrend", "parameters": [ { "name": "months", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 6 } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/feedbacks": { "get": { "tags": [ "教师端 - 反馈管理" ], "summary": "获取反馈列表", "operationId": "getFeedbacks", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultLessonFeedbackResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/feedbacks/stats": { "get": { "tags": [ "教师端 - 反馈管理" ], "summary": "获取反馈统计", "operationId": "getFeedbackStats", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/dashboard": { "get": { "tags": [ "教师端 - 统计数据" ], "summary": "获取教师端首页统计数据", "operationId": "getDashboard", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/courses": { "get": { "tags": [ "教师端 - 课程管理" ], "summary": "获取课程分页列表", "operationId": "getCoursePage", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "grade", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "domain", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lessonType", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultCourseResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/courses/{id}": { "get": { "tags": [ "教师端 - 课程管理" ], "summary": "根据 ID 获取课程", "operationId": "getCourse", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultCourseResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/courses/all": { "get": { "tags": [ "教师端 - 课程管理" ], "summary": "获取所有课程", "operationId": "getAllCourses", "parameters": [ { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "grade", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "domain", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListCourseResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/course-usage": { "get": { "tags": [ "教师端 - 统计数据" ], "summary": "获取课程使用统计", "operationId": "getCourseUsage", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/classes": { "get": { "tags": [ "教师端 - 课程管理" ], "summary": "获取教师的班级列表", "operationId": "getClasses", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListClassResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/classes/{id}/teachers": { "get": { "tags": [ "教师端 - 课程管理" ], "summary": "获取班级教师列表", "operationId": "getClassTeachers", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListTeacherResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/teacher/classes/{id}/students": { "get": { "tags": [ "教师端 - 课程管理" ], "summary": "获取班级学生列表", "operationId": "getClassStudents", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultStudentResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/task-templates/default/{type}": { "get": { "tags": [ "学校端 - 任务模板" ], "summary": "获取默认模板", "operationId": "getDefaultTemplate_1", "parameters": [ { "name": "type", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTaskTemplateResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/stats": { "get": { "tags": [ "学校端 - 统计数据" ], "summary": "获取学校统计数据", "operationId": "getSchoolStats", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/stats/teachers": { "get": { "tags": [ "学校端 - 统计数据" ], "summary": "获取活跃教师排行", "operationId": "getActiveTeachers", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 5 } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/stats/lesson-trend": { "get": { "tags": [ "学校端 - 统计数据" ], "summary": "获取授课趋势", "operationId": "getLessonTrend_1", "parameters": [ { "name": "months", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 6 } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/stats/courses": { "get": { "tags": [ "学校端 - 统计数据" ], "summary": "获取课程使用统计", "operationId": "getCourseUsageStats", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/stats/course-distribution": { "get": { "tags": [ "学校端 - 统计数据" ], "summary": "获取课程分布", "operationId": "getCourseDistribution", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/stats/activities": { "get": { "tags": [ "学校端 - 统计数据" ], "summary": "获取近期活动", "operationId": "getRecentActivities", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/schedules/timetable": { "get": { "tags": [ "学校端 - 排课管理" ], "summary": "获取课程表", "operationId": "getTimetable_1", "parameters": [ { "name": "classId", "in": "query", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "startDate", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "endDate", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/schedules/course-packages/{id}/lesson-types": { "get": { "tags": [ "学校端 - 排课管理" ], "summary": "获取课程包的课程类型列表", "operationId": "getCoursePackageLessonTypes", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListLessonTypeInfo" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/schedules/calendar": { "get": { "tags": [ "学校端 - 排课管理" ], "summary": "获取日历视图数据", "operationId": "getCalendarViewData", "parameters": [ { "name": "startDate", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "endDate", "in": "query", "required": false, "schema": { "type": "string", "format": "date" } }, { "name": "classId", "in": "query", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "teacherId", "in": "query", "required": false, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultCalendarViewResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/reports/teachers": { "get": { "tags": [ "学校端 - 数据报告" ], "summary": "获取教师报告", "operationId": "getTeacherReports", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListTeacherReportResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/reports/students": { "get": { "tags": [ "学校端 - 数据报告" ], "summary": "获取学生报告", "operationId": "getStudentReports", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListStudentReportResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/reports/overview": { "get": { "tags": [ "学校端 - 数据报告" ], "summary": "获取报告概览", "operationId": "getOverview", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultReportOverviewResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/reports/courses": { "get": { "tags": [ "学校端 - 数据报告" ], "summary": "获取课程报告", "operationId": "getCourseReports", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListCourseReportResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/reading-tasks": { "get": { "tags": [ "学校端 - 阅读任务(只读)" ], "summary": "获取任务列表(支持多维度筛选)", "operationId": "getTaskList", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "classIds", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "integer", "format": "int64" } } }, { "name": "teacherIds", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "integer", "format": "int64" } } }, { "name": "dateType", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "startDate", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "endDate", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "completionRate", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sortBy", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sortOrder", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultTaskResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/reading-tasks/{taskId}": { "get": { "tags": [ "学校端 - 阅读任务(只读)" ], "summary": "获取任务详情", "operationId": "getTaskDetail", "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTaskResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/reading-tasks/{taskId}/completions": { "get": { "tags": [ "学校端 - 阅读任务(只读)" ], "summary": "获取任务完成情况列表", "operationId": "getTaskCompletions_1", "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultTaskCompletionDetailResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/reading-tasks/statistics": { "get": { "tags": [ "学校端 - 阅读任务(只读)" ], "summary": "获取统计数据", "operationId": "getStatistics", "parameters": [ { "name": "dateType", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "startDate", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "endDate", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/reading-tasks/completions/{completionId}": { "get": { "tags": [ "学校端 - 阅读任务(只读)" ], "summary": "获取学生提交详情", "operationId": "getCompletionDetail_1", "parameters": [ { "name": "completionId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTaskCompletionDetailResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/parents/{id}/children": { "get": { "tags": [ "School - Parent" ], "summary": "Get children of parent", "operationId": "getParentChildren", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListParentStudentResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/packages": { "get": { "tags": [ "学校端 - 课程套餐" ], "summary": "查询租户课程套餐(两层结构-最上层)", "operationId": "findTenantCollections", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListCourseCollectionResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/packages/{collectionId}/packages": { "get": { "tags": [ "学校端 - 课程套餐" ], "summary": "获取课程套餐下的课程包列表", "operationId": "getPackagesByCollection", "parameters": [ { "name": "collectionId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListCoursePackageResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/packages/packages/{packageId}/courses": { "get": { "tags": [ "学校端 - 课程套餐" ], "summary": "获取课程包下的课程列表(包含排课计划参考)", "operationId": "getPackageCourses", "parameters": [ { "name": "packageId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultCourseResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/packages/package": { "get": { "tags": [ "学校端 - 课程套餐" ], "summary": "获取套餐信息", "operationId": "getPackageInfo", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPackageInfoResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/packages/package/usage": { "get": { "tags": [ "学校端 - 课程套餐" ], "summary": "获取套餐使用情况", "operationId": "getPackageUsage", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPackageUsageResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/operation-logs": { "get": { "tags": [ "学校端 - 操作日志" ], "summary": "获取日志列表", "operationId": "getLogList", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "module", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operator", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultOperationLogResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/operation-logs/{id}": { "get": { "tags": [ "学校端 - 操作日志" ], "summary": "获取日志详情", "operationId": "getLogDetail", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultOperationLogResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/operation-logs/stats": { "get": { "tags": [ "学校端 - 操作日志" ], "summary": "获取日志统计", "operationId": "getLogStats", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/feedbacks": { "get": { "tags": [ "学校端 - 反馈管理" ], "summary": "获取反馈列表", "operationId": "getFeedbacks_1", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "teacherId", "in": "query", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "courseId", "in": "query", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultLessonFeedbackResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/feedbacks/stats": { "get": { "tags": [ "学校端 - 反馈管理" ], "summary": "获取反馈统计", "operationId": "getFeedbackStats_1", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/export/teacher-stats": { "get": { "tags": [ "学校端 - 数据导出" ], "summary": "导出教师统计", "operationId": "exportTeacherStats", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/export/student-stats": { "get": { "tags": [ "学校端 - 数据导出" ], "summary": "导出学生统计", "operationId": "exportStudentStats", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/export/lessons": { "get": { "tags": [ "学校端 - 数据导出" ], "summary": "导出授课记录", "operationId": "exportLessons", "parameters": [ { "name": "startDate", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "endDate", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/export/growth-records": { "get": { "tags": [ "学校端 - 数据导出" ], "summary": "导出成长记录", "operationId": "exportGrowthRecords", "parameters": [ { "name": "studentId", "in": "query", "required": false, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/courses": { "get": { "tags": [ "学校端 - 课程管理" ], "summary": "获取学校课程包列表(分页)", "operationId": "getSchoolCourses", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "grade", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "domain", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lessonType", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultSchoolCourseResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/school/courses/{id}": { "get": { "tags": [ "学校端 - 课程管理" ], "summary": "获取课程详情", "operationId": "getSchoolCourse", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultSchoolCourseResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/parent/tasks": { "get": { "tags": [ "家长端 - 任务管理" ], "summary": "获取我的任务列表(聚合多孩子任务)", "operationId": "getMyTasks", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultTaskWithCompletionResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/parent/tasks/{id}": { "get": { "tags": [ "家长端 - 任务管理" ], "summary": "获取任务详情", "operationId": "getTask_1", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTaskResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/parent/tasks/student/{studentId}": { "get": { "tags": [ "家长端 - 任务管理" ], "summary": "获取孩子的任务列表(含完成信息与教师评价)", "operationId": "getTasksByStudent", "parameters": [ { "name": "studentId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultTaskWithCompletionResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/parent/tasks/completions/{completionId}": { "get": { "tags": [ "家长端 - 任务管理" ], "summary": "获取提交详情", "operationId": "getCompletionDetail_2", "parameters": [ { "name": "completionId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTaskCompletionDetailResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/parent/tasks/completions/{completionId}/feedback": { "get": { "tags": [ "家长端 - 任务管理" ], "summary": "获取教师评价", "operationId": "getFeedback", "parameters": [ { "name": "completionId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultTaskFeedbackResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/parent/notifications": { "get": { "tags": [ "Parent - Notification" ], "summary": "Get my notifications", "operationId": "getMyNotifications_1", "parameters": [ { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "isRead", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32" } }, { "name": "notificationType", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultNotificationForParentResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/parent/notifications/{id}": { "get": { "tags": [ "Parent - Notification" ], "summary": "Get notification by ID", "operationId": "getNotification_1", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultNotificationForParentResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/parent/notifications/unread-count": { "get": { "tags": [ "Parent - Notification" ], "summary": "Get unread count", "operationId": "getUnreadCount_1", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultLong" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/parent/growth-records/{id}": { "get": { "tags": [ "Parent - Growth Record" ], "summary": "Get growth record by ID", "operationId": "getGrowthRecord_2", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultGrowthRecordForParentResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/parent/growth-records/student/{studentId}": { "get": { "tags": [ "Parent - Growth Record" ], "summary": "Get growth records by student ID", "operationId": "getGrowthRecordsByStudent", "parameters": [ { "name": "studentId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultGrowthRecordForParentResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/parent/growth-records/student/{studentId}/recent": { "get": { "tags": [ "Parent - Growth Record" ], "summary": "Get recent growth records", "operationId": "getRecentGrowthRecords", "parameters": [ { "name": "studentId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListGrowthRecordForParentResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/parent/children": { "get": { "tags": [ "Parent - Child" ], "summary": "Get my children", "operationId": "getMyChildren", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListChildInfoResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/parent/children/{id}": { "get": { "tags": [ "Parent - Child" ], "summary": "Get child by ID", "operationId": "getChild", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultChildProfileResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/parent/children/{id}/lessons": { "get": { "tags": [ "Parent - Child" ], "summary": "Get child lesson records (reading history)", "operationId": "getChildLessons", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "pageNum", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultLessonRecordResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/parent/children/{id}/growth": { "get": { "tags": [ "Parent - Child" ], "summary": "Get child growth records", "operationId": "getChildGrowth", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/imm/token": { "get": { "tags": [ "阿里云 IMM 服务" ], "summary": "生成编辑 WebOffice Token", "description": "用于文档编辑,支持查看和修改", "operationId": "generateEditToken", "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "name", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultImmTokenVo" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/imm/token/readonly": { "get": { "tags": [ "阿里云 IMM 服务" ], "summary": "生成只读 WebOffice Token", "description": "用于文档预览,仅支持查看", "operationId": "generateReadOnlyToken", "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "name", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultImmTokenVo" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/files/oss/token": { "get": { "tags": [ "文件上传" ], "summary": "获取阿里云 OSS 直传 Token", "operationId": "getOssToken", "parameters": [ { "name": "fileName", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "dir", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultOssTokenVo" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/auth/profile": { "get": { "tags": [ "认证管理" ], "summary": "获取当前用户信息", "operationId": "getCurrentUser", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultUserInfoResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/tenants/stats": { "get": { "tags": [ "超管端 - 租户管理" ], "summary": "获取租户统计信息", "operationId": "getTenantStats", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/tenants/active": { "get": { "tags": [ "超管端 - 租户管理" ], "summary": "Get all active tenants", "operationId": "getAllActiveTenants", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListTenantResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/stats": { "get": { "tags": [ "超管端 - 统计管理" ], "summary": "获取统计数据", "operationId": "getStats", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultStatsResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/stats/trend": { "get": { "tags": [ "超管端 - 统计管理" ], "summary": "获取趋势数据", "operationId": "getTrendData", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultStatsTrendResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/stats/tenants/active": { "get": { "tags": [ "超管端 - 统计管理" ], "summary": "获取活跃租户", "operationId": "getActiveTenants", "parameters": [ { "name": "request", "in": "query", "required": true, "schema": { "$ref": "#/components/schemas/ActiveTenantsQueryRequest" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListActiveTenantItemResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/stats/courses/popular": { "get": { "tags": [ "超管端 - 统计管理" ], "summary": "获取热门课程", "operationId": "getPopularCourses", "parameters": [ { "name": "request", "in": "query", "required": true, "schema": { "$ref": "#/components/schemas/PopularCoursesQueryRequest" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListPopularCourseItemResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/stats/activities": { "get": { "tags": [ "超管端 - 统计管理" ], "summary": "获取最近活动", "operationId": "getRecentActivities_1", "parameters": [ { "name": "request", "in": "query", "required": true, "schema": { "$ref": "#/components/schemas/RecentActivitiesQueryRequest" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListRecentActivityItemResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/settings/tenant-defaults": { "get": { "tags": [ "超管 - 系统设置" ], "summary": "获取租户默认设置", "operationId": "getTenantDefaults", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/resources/stats": { "get": { "tags": [ "超管端 - 资源库" ], "summary": "获取统计数据", "operationId": "getStats_1", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/packages/all": { "get": { "tags": [ "超管端 - 课程包管理" ], "summary": "获取所有已发布的课程包", "operationId": "getAllPublishedCourses", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListCourseResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/courses/{courseId}/lessons/type/{lessonType}": { "get": { "tags": [ "超管端 - 课程环节" ], "summary": "按类型获取课程环节", "operationId": "findByType", "parameters": [ { "name": "courseId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "lessonType", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultCourseLessonResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/admin/collections/all": { "get": { "tags": [ "超管端 - 课程套餐管理" ], "summary": "获取所有已发布的课程套餐", "operationId": "getAllPublishedCollections", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListCourseCollectionResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } }, "/api/v1/files/delete": { "delete": { "tags": [ "文件上传" ], "summary": "删除文件", "operationId": "deleteFile", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "string" } } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultMapStringObject" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "405": { "description": "Method Not Allowed", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } } } } } }, "components": { "schemas": { "ResultVoid": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "object" } } }, "TaskUpdateRequest": { "type": "object", "properties": { "title": { "type": "string", "description": "任务标题" }, "description": { "type": "string", "description": "描述" }, "type": { "type": "string", "description": "任务类型" }, "taskType": { "type": "string", "description": "任务类型(前端兼容 taskType)" }, "relatedBookName": { "type": "string", "description": "关联绘本名称" }, "courseId": { "type": "integer", "description": "课程 ID", "format": "int64" }, "relatedCourseId": { "type": "integer", "description": "课程 ID(前端兼容 relatedCourseId)", "format": "int64" }, "startDate": { "type": "string", "description": "开始日期", "format": "date" }, "dueDate": { "type": "string", "description": "截止日期", "format": "date" }, "status": { "type": "string", "description": "状态" }, "attachments": { "type": "string", "description": "附件(JSON 数组)" }, "targetType": { "type": "string", "description": "目标类型:CLASS-班级,STUDENT-学生" }, "targetIds": { "type": "array", "description": "目标 IDs", "items": { "type": "integer", "description": "目标 IDs", "format": "int64" } } }, "description": "任务更新请求" }, "ResultTaskResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/TaskResponse" } } }, "TaskResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "tenantId": { "type": "integer", "description": "租户 ID", "format": "int64" }, "title": { "type": "string", "description": "任务标题" }, "description": { "type": "string", "description": "任务描述" }, "type": { "type": "string", "description": "任务类型" }, "relatedBookName": { "type": "string", "description": "关联绘本名称" }, "courseId": { "type": "integer", "description": "课程 ID", "format": "int64" }, "creatorId": { "type": "integer", "description": "创建人 ID", "format": "int64" }, "creatorRole": { "type": "string", "description": "创建人角色" }, "startDate": { "type": "string", "description": "开始日期", "format": "date" }, "dueDate": { "type": "string", "description": "截止日期", "format": "date" }, "status": { "type": "string", "description": "状态" }, "attachments": { "type": "string", "description": "附件" }, "targetType": { "type": "string", "description": "目标类型:CLASS-班级,STUDENT-学生" }, "targetIds": { "type": "array", "description": "目标 IDs(班级或学生)", "items": { "type": "integer", "description": "目标 IDs(班级或学生)", "format": "int64" } }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" } }, "description": "任务响应" }, "TaskFeedbackRequest": { "required": [ "result" ], "type": "object", "properties": { "result": { "type": "string", "description": "评价结果:EXCELLENT-优秀/PASSED-通过/NEEDS_WORK-需改进" }, "rating": { "maximum": 5, "minimum": 1, "type": "integer", "description": "评分 1-5(可选)", "format": "int32" }, "comment": { "maxLength": 500, "minLength": 0, "type": "string", "description": "评语" } }, "description": "任务评价请求" }, "ResultTaskFeedbackResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/TaskFeedbackResponse" } } }, "TaskFeedbackResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "评价ID", "format": "int64" }, "completionId": { "type": "integer", "description": "完成记录ID", "format": "int64" }, "result": { "type": "string", "description": "评价结果:EXCELLENT/PASSED/NEEDS_WORK" }, "resultText": { "type": "string", "description": "评价结果文本:优秀/通过/需改进" }, "rating": { "type": "integer", "description": "评分 1-5", "format": "int32" }, "comment": { "type": "string", "description": "评语" }, "teacherId": { "type": "integer", "description": "教师ID", "format": "int64" }, "teacherName": { "type": "string", "description": "教师姓名" }, "teacherAvatar": { "type": "string", "description": "教师头像" }, "createdAt": { "type": "string", "description": "评价时间", "format": "date-time" } }, "description": "任务评价响应" }, "TaskTemplateCreateRequest": { "required": [ "name" ], "type": "object", "properties": { "name": { "type": "string", "description": "模板名称" }, "description": { "type": "string", "description": "模板描述" }, "type": { "type": "string", "description": "模板类型" }, "taskType": { "type": "string", "description": "任务类型" }, "relatedCourseId": { "type": "integer", "description": "关联课程 ID", "format": "int64" }, "defaultDuration": { "type": "integer", "description": "默认持续时间 (天)", "format": "int32" }, "isDefault": { "type": "boolean", "description": "是否默认模板" }, "content": { "type": "string", "description": "模板内容" }, "isPublic": { "type": "boolean", "description": "是否公开" } }, "description": "任务模板创建请求" }, "ResultTaskTemplateResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/TaskTemplateResponse" } } }, "TaskTemplateResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "tenantId": { "type": "integer", "description": "租户 ID", "format": "int64" }, "name": { "type": "string", "description": "模板名称" }, "description": { "type": "string", "description": "模板描述" }, "type": { "type": "string", "description": "模板类型" }, "taskType": { "type": "string", "description": "任务类型" }, "relatedCourseId": { "type": "integer", "description": "关联课程 ID", "format": "int64" }, "defaultDuration": { "type": "integer", "description": "默认持续时间 (天)", "format": "int32" }, "isDefault": { "type": "integer", "description": "是否默认模板", "format": "int32" }, "status": { "type": "string", "description": "状态" }, "createdBy": { "type": "integer", "description": "创建人 ID", "format": "int64" }, "content": { "type": "string", "description": "模板内容" }, "isPublic": { "type": "integer", "description": "是否公开", "format": "int32" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" } }, "description": "任务模板响应" }, "SchedulePlanUpdateRequest": { "type": "object", "properties": { "name": { "type": "string", "description": "计划名称" }, "courseId": { "type": "integer", "description": "课程 ID", "format": "int64" }, "coursePackageId": { "type": "integer", "description": "课程包 ID", "format": "int64" }, "lessonType": { "type": "string", "description": "课程类型 (INTRODUCTION/COLLECTIVE/LANGUAGE/SOCIETY/SCIENCE/ART/HEALTH)" }, "teacherId": { "type": "integer", "description": "教师 ID", "format": "int64" }, "scheduledDate": { "type": "string", "description": "排课日期", "format": "date" }, "scheduledTime": { "type": "string", "description": "时间段 (如:09:00-10:00)" }, "weekDay": { "type": "integer", "description": "星期几 (1-7)", "format": "int32" }, "repeatType": { "type": "string", "description": "重复方式 (NONE/WEEKLY)" }, "repeatEndDate": { "type": "string", "description": "重复截止日期", "format": "date" }, "note": { "type": "string", "description": "备注" }, "status": { "type": "string", "description": "状态" } }, "description": "日程计划更新请求" }, "ResultSchedulePlanResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/SchedulePlanResponse" } } }, "SchedulePlanResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "tenantId": { "type": "integer", "description": "租户 ID", "format": "int64" }, "name": { "type": "string", "description": "计划名称" }, "classId": { "type": "integer", "description": "班级 ID", "format": "int64" }, "className": { "type": "string", "description": "班级名称" }, "courseId": { "type": "integer", "description": "课程 ID", "format": "int64" }, "courseName": { "type": "string", "description": "课程名称" }, "coursePackageId": { "type": "integer", "description": "课程包 ID", "format": "int64" }, "coursePackageName": { "type": "string", "description": "课程包名称" }, "lessonType": { "type": "string", "description": "课程类型" }, "lessonTypeName": { "type": "string", "description": "课程类型名称" }, "teacherId": { "type": "integer", "description": "教师 ID", "format": "int64" }, "teacherName": { "type": "string", "description": "教师姓名" }, "scheduledDate": { "type": "string", "description": "排课日期", "format": "date" }, "scheduledTime": { "type": "string", "description": "时间段 (如:09:00-10:00)" }, "weekDay": { "type": "integer", "description": "星期几 (1-7)", "format": "int32" }, "repeatType": { "type": "string", "description": "重复方式 (NONE/WEEKLY)" }, "repeatEndDate": { "type": "string", "description": "重复截止日期", "format": "date" }, "source": { "type": "string", "description": "来源 (SCHOOL/TEACHER)" }, "note": { "type": "string", "description": "备注" }, "status": { "type": "string", "description": "状态" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" } }, "description": "日程计划响应" }, "LessonUpdateRequest": { "type": "object", "properties": { "title": { "type": "string", "description": "课时标题" }, "lessonDate": { "type": "string", "description": "课时日期", "format": "date" }, "startTime": { "$ref": "#/components/schemas/LocalTime" }, "endTime": { "$ref": "#/components/schemas/LocalTime" }, "location": { "type": "string", "description": "地点" }, "status": { "type": "string", "description": "状态" }, "notes": { "type": "string", "description": "备注" } }, "description": "课时更新请求" }, "LocalTime": { "type": "object", "properties": { "hour": { "type": "integer", "format": "int32" }, "minute": { "type": "integer", "format": "int32" }, "second": { "type": "integer", "format": "int32" }, "nano": { "type": "integer", "format": "int32" } }, "description": "结束时间" }, "LessonResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "tenantId": { "type": "integer", "description": "租户 ID", "format": "int64" }, "courseId": { "type": "integer", "description": "课程 ID", "format": "int64" }, "classId": { "type": "integer", "description": "班级 ID", "format": "int64" }, "courseName": { "type": "string", "description": "课程名称(用于列表展示)" }, "className": { "type": "string", "description": "班级名称(用于列表展示)" }, "teacherId": { "type": "integer", "description": "教师 ID", "format": "int64" }, "title": { "type": "string", "description": "标题" }, "lessonDate": { "type": "string", "description": "课时日期", "format": "date" }, "startTime": { "$ref": "#/components/schemas/LocalTime" }, "endTime": { "$ref": "#/components/schemas/LocalTime" }, "location": { "type": "string", "description": "地点" }, "status": { "type": "string", "description": "状态" }, "notes": { "type": "string", "description": "备注" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" } }, "description": "课时响应" }, "ResultLessonResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/LessonResponse" } } }, "LessonProgressRequest": { "type": "object", "properties": { "currentLessonId": { "type": "integer", "description": "当前课程 ID", "format": "int32" }, "currentStepId": { "type": "integer", "description": "当前步骤 ID", "format": "int32" }, "lessonIds": { "type": "array", "description": "课程 ID 列表", "items": { "type": "integer", "description": "课程 ID 列表", "format": "int64" } }, "completedLessonIds": { "type": "array", "description": "已完成课程 ID 列表", "items": { "type": "integer", "description": "已完成课程 ID 列表", "format": "int64" } }, "progressData": { "type": "object", "description": "进度数据 (JSON 对象)" } }, "description": "课程进度保存请求" }, "GrowthRecordUpdateRequest": { "type": "object", "properties": { "type": { "type": "string", "description": "类型" }, "title": { "type": "string", "description": "标题" }, "content": { "type": "string", "description": "内容" }, "images": { "type": "string", "description": "图片(JSON 数组)" }, "recordDate": { "type": "string", "description": "记录日期", "format": "date" }, "tags": { "type": "array", "description": "标签", "items": { "type": "string", "description": "标签" } } }, "description": "成长记录更新请求" }, "GrowthRecord": { "type": "object", "properties": { "id": { "type": "integer", "description": "主键 ID", "format": "int64" }, "createBy": { "type": "string", "description": "创建人" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updateBy": { "type": "string", "description": "更新人" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" }, "tenantId": { "type": "integer", "description": "租户 ID", "format": "int64" }, "studentId": { "type": "integer", "description": "学生 ID", "format": "int64" }, "type": { "type": "string", "description": "记录类型" }, "title": { "type": "string", "description": "记录标题" }, "content": { "type": "string", "description": "记录内容" }, "images": { "type": "string", "description": "图片(JSON 数组)" }, "recordedBy": { "type": "integer", "description": "记录人 ID", "format": "int64" }, "recorderRole": { "type": "string", "description": "记录人角色" }, "recordDate": { "type": "string", "description": "记录日期", "format": "date" }, "tags": { "type": "string", "description": "标签(JSON 数组)" } }, "description": "成长记录实体" }, "ResultGrowthRecord": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/GrowthRecord" } } }, "TeacherUpdateRequest": { "type": "object", "properties": { "name": { "type": "string", "description": "姓名" }, "phone": { "type": "string", "description": "电话" }, "email": { "type": "string", "description": "邮箱" }, "avatarUrl": { "type": "string", "description": "头像 URL" }, "gender": { "type": "string", "description": "性别" }, "bio": { "type": "string", "description": "简介" }, "status": { "type": "string", "description": "状态" }, "classIds": { "type": "array", "description": "负责班级ID列表", "items": { "type": "integer", "description": "负责班级ID列表", "format": "int64" } } }, "description": "教师更新请求" }, "ResultTeacherResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/TeacherResponse" } } }, "TeacherResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "tenantId": { "type": "integer", "description": "租户 ID", "format": "int64" }, "name": { "type": "string", "description": "姓名" }, "phone": { "type": "string", "description": "电话" }, "email": { "type": "string", "description": "邮箱" }, "avatarUrl": { "type": "string", "description": "头像 URL" }, "gender": { "type": "string", "description": "性别" }, "bio": { "type": "string", "description": "个人简介" }, "status": { "type": "string", "description": "状态" }, "classIds": { "type": "array", "description": "负责班级ID列表", "items": { "type": "integer", "description": "负责班级ID列表", "format": "int64" } }, "classNames": { "type": "object", "description": "负责班级名称" }, "lessonCount": { "type": "integer", "description": "授课次数", "format": "int32" }, "lastLoginAt": { "type": "string", "description": "最后登录时间", "format": "date-time" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" }, "loginAccount": { "type": "string", "description": "登录账号" } }, "description": "教师响应" }, "StudentUpdateRequest": { "type": "object", "properties": { "name": { "type": "string", "description": "姓名" }, "gender": { "type": "string", "description": "性别" }, "birthDate": { "type": "string", "description": "出生日期", "format": "date" }, "avatarUrl": { "type": "string", "description": "头像 URL" }, "grade": { "type": "string", "description": "年级" }, "studentNo": { "type": "string", "description": "学号" }, "readingLevel": { "type": "string", "description": "阅读水平" }, "interests": { "type": "string", "description": "兴趣爱好" }, "notes": { "type": "string", "description": "备注" }, "status": { "type": "string", "description": "状态" } }, "description": "学生更新请求" }, "ResultStudentResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/StudentResponse" } } }, "StudentResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "tenantId": { "type": "integer", "description": "租户 ID", "format": "int64" }, "name": { "type": "string", "description": "姓名" }, "gender": { "type": "string", "description": "性别" }, "birthDate": { "type": "string", "description": "出生日期", "format": "date" }, "avatarUrl": { "type": "string", "description": "头像 URL" }, "grade": { "type": "string", "description": "年级" }, "studentNo": { "type": "string", "description": "学号" }, "readingLevel": { "type": "string", "description": "阅读水平" }, "interests": { "type": "string", "description": "兴趣爱好" }, "notes": { "type": "string", "description": "备注" }, "status": { "type": "string", "description": "状态" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" } }, "description": "学生响应" }, "BasicSettingsUpdateRequest": { "type": "object", "properties": { "schoolName": { "type": "string", "description": "学校名称" }, "logoUrl": { "type": "string", "description": "学校Logo" }, "contactPhone": { "type": "string", "description": "联系电话" }, "contactEmail": { "type": "string", "description": "联系邮箱" }, "address": { "type": "string", "description": "学校地址" }, "description": { "type": "string", "description": "学校简介" } }, "description": "基础设置更新请求" }, "NotificationSettingsUpdateRequest": { "type": "object", "properties": { "emailEnabled": { "type": "boolean", "description": "启用邮件通知" }, "smsEnabled": { "type": "boolean", "description": "启用短信通知" }, "inAppEnabled": { "type": "boolean", "description": "启用站内通知" }, "taskCompletionNotify": { "type": "boolean", "description": "任务完成通知" }, "courseReminderNotify": { "type": "boolean", "description": "课程提醒通知" } }, "description": "通知设置更新请求" }, "SchoolSettingsUpdateRequest": { "type": "object", "properties": { "basic": { "$ref": "#/components/schemas/BasicSettingsUpdateRequest" }, "notification": { "$ref": "#/components/schemas/NotificationSettingsUpdateRequest" }, "security": { "$ref": "#/components/schemas/SecuritySettingsUpdateRequest" } }, "description": "系统设置更新请求" }, "SecuritySettingsUpdateRequest": { "type": "object", "properties": { "passwordMinLength": { "type": "integer", "description": "密码最小长度", "format": "int32" }, "passwordRequireSpecialChar": { "type": "boolean", "description": "密码是否需要特殊字符" }, "loginFailLockCount": { "type": "integer", "description": "登录失败锁定次数", "format": "int32" }, "sessionTimeout": { "type": "integer", "description": "会话超时时间(分钟)", "format": "int32" }, "twoFactorEnabled": { "type": "boolean", "description": "启用双因素认证" } }, "description": "安全设置更新请求" }, "BasicSettingsResponse": { "type": "object", "properties": { "schoolName": { "type": "string", "description": "学校名称" }, "logoUrl": { "type": "string", "description": "学校Logo" }, "contactPhone": { "type": "string", "description": "联系电话" }, "contactEmail": { "type": "string", "description": "联系邮箱" }, "address": { "type": "string", "description": "学校地址" }, "description": { "type": "string", "description": "学校简介" } }, "description": "基础设置响应" }, "NotificationSettingsResponse": { "type": "object", "properties": { "emailEnabled": { "type": "boolean", "description": "启用邮件通知" }, "smsEnabled": { "type": "boolean", "description": "启用短信通知" }, "inAppEnabled": { "type": "boolean", "description": "启用站内通知" }, "taskCompletionNotify": { "type": "boolean", "description": "任务完成通知" }, "courseReminderNotify": { "type": "boolean", "description": "课程提醒通知" } }, "description": "通知设置响应" }, "ResultSchoolSettingsResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/SchoolSettingsResponse" } } }, "SchoolSettingsResponse": { "type": "object", "properties": { "basic": { "$ref": "#/components/schemas/BasicSettingsResponse" }, "notification": { "$ref": "#/components/schemas/NotificationSettingsResponse" }, "security": { "$ref": "#/components/schemas/SecuritySettingsResponse" } }, "description": "学校系统设置响应" }, "SecuritySettingsResponse": { "type": "object", "properties": { "passwordMinLength": { "type": "integer", "description": "密码最小长度", "format": "int32" }, "passwordRequireSpecialChar": { "type": "boolean", "description": "密码是否需要特殊字符" }, "loginFailLockCount": { "type": "integer", "description": "登录失败锁定次数", "format": "int32" }, "sessionTimeout": { "type": "integer", "description": "会话超时时间(分钟)", "format": "int32" }, "twoFactorEnabled": { "type": "boolean", "description": "启用双因素认证" } }, "description": "安全设置响应" }, "ResultSecuritySettingsResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/SecuritySettingsResponse" } } }, "ResultNotificationSettingsResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/NotificationSettingsResponse" } } }, "ResultBasicSettingsResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/BasicSettingsResponse" } } }, "ParentUpdateRequest": { "type": "object", "properties": { "name": { "type": "string", "description": "姓名" }, "phone": { "type": "string", "description": "电话" }, "email": { "type": "string", "description": "邮箱" }, "avatarUrl": { "type": "string", "description": "头像 URL" }, "gender": { "type": "string", "description": "性别" }, "status": { "type": "string", "description": "状态" } }, "description": "家长更新请求" }, "ParentResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "tenantId": { "type": "integer", "description": "租户 ID", "format": "int64" }, "username": { "type": "string", "description": "用户名" }, "name": { "type": "string", "description": "姓名" }, "phone": { "type": "string", "description": "电话" }, "email": { "type": "string", "description": "邮箱" }, "avatarUrl": { "type": "string", "description": "头像 URL" }, "gender": { "type": "string", "description": "性别" }, "status": { "type": "string", "description": "状态" }, "lastLoginAt": { "type": "string", "description": "最后登录时间", "format": "date-time" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" } }, "description": "家长响应" }, "ResultParentResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/ParentResponse" } } }, "GrowthRecordResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "tenantId": { "type": "integer", "description": "租户 ID", "format": "int64" }, "studentId": { "type": "integer", "description": "学生 ID", "format": "int64" }, "type": { "type": "string", "description": "类型" }, "title": { "type": "string", "description": "标题" }, "content": { "type": "string", "description": "内容" }, "images": { "type": "string", "description": "图片" }, "recordedBy": { "type": "integer", "description": "记录人 ID", "format": "int64" }, "recorderRole": { "type": "string", "description": "记录人角色" }, "recordDate": { "type": "string", "description": "记录日期", "format": "date" }, "tags": { "type": "string", "description": "标签" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" } }, "description": "成长记录响应" }, "ResultGrowthRecordResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/GrowthRecordResponse" } } }, "ClassUpdateRequest": { "type": "object", "properties": { "name": { "type": "string", "description": "班级名称" }, "grade": { "type": "string", "description": "年级" }, "description": { "type": "string", "description": "描述" }, "capacity": { "type": "integer", "description": "容量", "format": "int32" }, "status": { "type": "string", "description": "状态" } }, "description": "班级更新请求" }, "ClassResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "tenantId": { "type": "integer", "description": "租户 ID", "format": "int64" }, "name": { "type": "string", "description": "班级名称" }, "grade": { "type": "string", "description": "年级" }, "description": { "type": "string", "description": "描述" }, "capacity": { "type": "integer", "description": "容量", "format": "int32" }, "status": { "type": "string", "description": "状态" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" } }, "description": "班级响应" }, "ResultClassResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/ClassResponse" } } }, "TaskSubmitRequest": { "type": "object", "properties": { "studentId": { "type": "integer", "description": "学生ID", "format": "int64" }, "photos": { "maxItems": 9, "minItems": 0, "type": "array", "description": "照片URL数组(最多9张)", "items": { "type": "string", "description": "照片URL数组(最多9张)" } }, "videoUrl": { "type": "string", "description": "视频URL" }, "audioUrl": { "type": "string", "description": "语音URL" }, "content": { "maxLength": 1000, "minLength": 0, "type": "string", "description": "阅读心得/完成内容" } }, "description": "任务提交请求" }, "ClassInfo": { "type": "object", "properties": { "id": { "type": "integer", "description": "班级ID", "format": "int64" }, "name": { "type": "string", "description": "班级名称" }, "grade": { "type": "string", "description": "年级" } }, "description": "班级信息" }, "ResultTaskCompletionDetailResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/TaskCompletionDetailResponse" } } }, "StudentInfo": { "type": "object", "properties": { "id": { "type": "integer", "description": "学生ID", "format": "int64" }, "name": { "type": "string", "description": "学生姓名" }, "avatar": { "type": "string", "description": "学生头像" }, "gender": { "type": "string", "description": "性别:MALE/FEMALE" }, "classInfo": { "$ref": "#/components/schemas/ClassInfo" } }, "description": "学生信息" }, "TaskCompletionDetailResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "完成记录ID", "format": "int64" }, "taskId": { "type": "integer", "description": "任务ID", "format": "int64" }, "taskTitle": { "type": "string", "description": "任务标题" }, "student": { "$ref": "#/components/schemas/StudentInfo" }, "status": { "type": "string", "description": "状态:PENDING/SUBMITTED/REVIEWED" }, "statusText": { "type": "string", "description": "状态文本:待完成/已提交/已评价" }, "photos": { "type": "array", "description": "照片URL数组", "items": { "type": "string", "description": "照片URL数组" } }, "videoUrl": { "type": "string", "description": "视频URL" }, "audioUrl": { "type": "string", "description": "语音URL" }, "content": { "type": "string", "description": "完成内容/阅读心得" }, "submittedAt": { "type": "string", "description": "提交时间", "format": "date-time" }, "reviewedAt": { "type": "string", "description": "评价时间", "format": "date-time" }, "feedback": { "$ref": "#/components/schemas/TaskFeedbackResponse" } }, "description": "任务完成详情响应" }, "ThemeCreateRequest": { "required": [ "name" ], "type": "object", "properties": { "name": { "type": "string", "description": "主题名称" }, "description": { "type": "string", "description": "主题描述" }, "sortOrder": { "type": "integer", "description": "排序号", "format": "int32" } }, "description": "创建主题请求" }, "ResultThemeResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/ThemeResponse" } } }, "ThemeResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "name": { "type": "string", "description": "主题名称" }, "description": { "type": "string", "description": "主题描述" }, "sortOrder": { "type": "integer", "description": "排序号", "format": "int32" }, "status": { "type": "string", "description": "状态" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" } }, "description": "主题响应" }, "TenantUpdateRequest": { "type": "object", "properties": { "name": { "type": "string", "description": "租户名称" }, "contactName": { "type": "string", "description": "联系人" }, "contactPhone": { "type": "string", "description": "联系电话" }, "contactEmail": { "type": "string", "description": "联系邮箱" }, "address": { "type": "string", "description": "地址" }, "logoUrl": { "type": "string", "description": "Logo URL" }, "status": { "type": "string", "description": "状态" }, "collectionIds": { "type": "array", "description": "课程套餐ID(用于三层架构)", "items": { "type": "integer", "description": "课程套餐ID(用于三层架构)", "format": "int64" } }, "teacherQuota": { "type": "integer", "description": "教师配额", "format": "int32" }, "studentQuota": { "type": "integer", "description": "学生配额", "format": "int32" }, "startDate": { "type": "string", "description": "开始日期", "format": "date" }, "expireDate": { "type": "string", "description": "结束日期", "format": "date" } }, "description": "租户更新请求" }, "ResultTenantResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/TenantResponse" } } }, "TenantResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "name": { "type": "string", "description": "租户名称" }, "code": { "type": "string", "description": "租户编码/登录账号" }, "username": { "type": "string", "description": "用户名" }, "contactName": { "type": "string", "description": "联系人姓名" }, "contactPhone": { "type": "string", "description": "联系人电话" }, "contactEmail": { "type": "string", "description": "联系人邮箱" }, "address": { "type": "string", "description": "地址" }, "logoUrl": { "type": "string", "description": "Logo URL" }, "status": { "type": "string", "description": "状态" }, "expireAt": { "type": "string", "description": "过期时间", "format": "date-time" }, "maxStudents": { "type": "integer", "description": "最大学生数", "format": "int32" }, "maxTeachers": { "type": "integer", "description": "最大教师数", "format": "int32" }, "packageNames": { "type": "array", "description": "套餐名称列表", "items": { "type": "string", "description": "套餐名称列表" } }, "teacherQuota": { "type": "integer", "description": "教师配额", "format": "int32" }, "studentQuota": { "type": "integer", "description": "学生配额", "format": "int32" }, "storageQuota": { "type": "integer", "description": "存储配额", "format": "int64" }, "storageUsed": { "type": "integer", "description": "已用存储", "format": "int64" }, "teacherCount": { "type": "integer", "description": "教师数量(已使用)", "format": "int32" }, "studentCount": { "type": "integer", "description": "学生数量(已使用)", "format": "int32" }, "startDate": { "type": "string", "description": "开始日期", "format": "date" }, "expireDate": { "type": "string", "description": "结束日期", "format": "date" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" } }, "description": "租户响应" }, "ResultMapStringObject": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "object", "additionalProperties": { "type": "object" } } } }, "ResourceLibraryUpdateRequest": { "type": "object", "properties": { "name": { "type": "string", "description": "资源库名称" }, "description": { "type": "string", "description": "资源库描述" } }, "description": "资源库更新请求" }, "ResourceLibraryResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "tenantId": { "type": "string", "description": "租户 ID" }, "name": { "type": "string", "description": "资源库名称" }, "description": { "type": "string", "description": "资源库描述" }, "createdBy": { "type": "string", "description": "创建人" }, "updatedBy": { "type": "string", "description": "更新人" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" }, "libraryType": { "type": "string", "description": "资源库类型" } }, "description": "资源库响应" }, "ResultResourceLibraryResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/ResourceLibraryResponse" } } }, "ResourceItemUpdateRequest": { "type": "object", "properties": { "title": { "type": "string", "description": "资源标题" }, "description": { "type": "string", "description": "资源描述" }, "tags": { "type": "array", "description": "标签(字符串数组)", "items": { "type": "string", "description": "标签(字符串数组)" } } }, "description": "资源项目更新请求" }, "LibrarySummary": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "name": { "type": "string" }, "libraryType": { "type": "string" } }, "description": "所属资源库信息" }, "ResourceItemResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "libraryId": { "type": "string", "description": "资源库 ID" }, "tenantId": { "type": "string", "description": "租户 ID" }, "title": { "type": "string", "description": "资源标题" }, "fileType": { "type": "string", "description": "文件类型 (IMAGE/PDF/VIDEO/AUDIO/PPT/OTHER)" }, "filePath": { "type": "string", "description": "文件路径" }, "fileSize": { "type": "integer", "description": "文件大小(字节)", "format": "int64" }, "tags": { "type": "array", "description": "资源标签", "items": { "type": "string", "description": "资源标签" } }, "library": { "$ref": "#/components/schemas/LibrarySummary" }, "description": { "type": "string", "description": "资源描述" }, "status": { "type": "string", "description": "状态" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" } }, "description": "资源项响应" }, "ResultResourceItemResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/ResourceItemResponse" } } }, "CourseUpdateRequest": { "type": "object", "properties": { "name": { "type": "string", "description": "课程名称" }, "code": { "type": "string", "description": "课程编码" }, "description": { "type": "string", "description": "描述" }, "coverUrl": { "type": "string", "description": "封面 URL" }, "coverImagePath": { "type": "string", "description": "封面图片路径" }, "category": { "type": "string", "description": "分类" }, "ageRange": { "type": "string", "description": "年龄范围" }, "difficultyLevel": { "type": "string", "description": "难度等级" }, "durationMinutes": { "type": "integer", "description": "时长(分钟)", "format": "int32" }, "objectives": { "type": "string", "description": "教学目标" }, "status": { "type": "string", "description": "状态" }, "coreContent": { "type": "string", "description": "核心内容" }, "introSummary": { "type": "string", "description": "课程摘要" }, "introHighlights": { "type": "string", "description": "课程亮点" }, "introGoals": { "type": "string", "description": "课程目标" }, "introSchedule": { "type": "string", "description": "内容安排" }, "introKeyPoints": { "type": "string", "description": "重点难点" }, "introMethods": { "type": "string", "description": "教学方法" }, "introEvaluation": { "type": "string", "description": "评估方法" }, "introNotes": { "type": "string", "description": "注意事项" }, "scheduleRefData": { "type": "string", "description": "进度安排参考数据(JSON)" }, "environmentConstruction": { "type": "string", "description": "环境创设内容" }, "themeId": { "type": "integer", "description": "主题 ID", "format": "int64" }, "pictureBookName": { "type": "string", "description": "绘本名称" }, "ebookPaths": { "type": "string", "description": "电子书路径(JSON 数组)" }, "audioPaths": { "type": "string", "description": "音频路径(JSON 数组)" }, "videoPaths": { "type": "string", "description": "视频路径(JSON 数组)" }, "otherResources": { "type": "string", "description": "其他资源(JSON 数组)" }, "pptPath": { "type": "string", "description": "PPT 文件路径" }, "pptName": { "type": "string", "description": "PPT 文件名称" }, "posterPaths": { "type": "string", "description": "海报路径(JSON 数组)" }, "tools": { "type": "string", "description": "教学工具(JSON 数组)" }, "studentMaterials": { "type": "string", "description": "学生材料" }, "lessonPlanData": { "type": "string", "description": "教案数据(JSON)" }, "activitiesData": { "type": "string", "description": "活动数据(JSON)" }, "assessmentData": { "type": "string", "description": "评估数据(JSON)" }, "gradeTags": { "type": "string", "description": "年级标签(JSON 数组)" }, "domainTags": { "type": "string", "description": "领域标签(JSON 数组)" }, "hasCollectiveLesson": { "type": "boolean", "description": "是否有集体课" } }, "description": "课程更新请求" }, "CourseLessonResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "courseId": { "type": "integer", "description": "课程 ID", "format": "int64" }, "lessonType": { "type": "string", "description": "课程类型" }, "name": { "type": "string", "description": "名称" }, "description": { "type": "string", "description": "描述" }, "duration": { "type": "integer", "description": "时长(分钟)", "format": "int32" }, "videoPath": { "type": "string", "description": "视频路径" }, "videoName": { "type": "string", "description": "视频名称" }, "pptPath": { "type": "string", "description": "PPT 路径" }, "pptName": { "type": "string", "description": "PPT 名称" }, "pdfPath": { "type": "string", "description": "PDF 路径" }, "pdfName": { "type": "string", "description": "PDF 名称" }, "objectives": { "type": "string", "description": "教学目标" }, "preparation": { "type": "string", "description": "教学准备" }, "extension": { "type": "string", "description": "教学延伸" }, "reflection": { "type": "string", "description": "教学反思" }, "assessmentData": { "type": "string", "description": "评估数据" }, "useTemplate": { "type": "boolean", "description": "是否使用模板" }, "sortOrder": { "type": "integer", "description": "排序号", "format": "int32" }, "steps": { "type": "array", "description": "教学环节列表", "items": { "$ref": "#/components/schemas/LessonStepResponse" } }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" } }, "description": "课程环节响应" }, "CourseResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "tenantId": { "type": "integer", "description": "租户 ID", "format": "int64" }, "name": { "type": "string", "description": "课程名称" }, "code": { "type": "string", "description": "课程编码" }, "description": { "type": "string", "description": "描述" }, "coverUrl": { "type": "string", "description": "封面 URL" }, "category": { "type": "string", "description": "分类" }, "ageRange": { "type": "string", "description": "年龄范围" }, "difficultyLevel": { "type": "string", "description": "难度等级" }, "durationMinutes": { "type": "integer", "description": "时长(分钟)", "format": "int32" }, "objectives": { "type": "string", "description": "教学目标" }, "status": { "type": "string", "description": "状态" }, "isSystem": { "type": "integer", "description": "是否系统课程", "format": "int32" }, "coreContent": { "type": "string", "description": "核心内容" }, "introSummary": { "type": "string", "description": "课程摘要" }, "introHighlights": { "type": "string", "description": "课程亮点" }, "introGoals": { "type": "string", "description": "课程目标" }, "introSchedule": { "type": "string", "description": "内容安排" }, "introKeyPoints": { "type": "string", "description": "重点难点" }, "introMethods": { "type": "string", "description": "教学方法" }, "introEvaluation": { "type": "string", "description": "评估方法" }, "introNotes": { "type": "string", "description": "注意事项" }, "scheduleRefData": { "type": "string", "description": "进度安排参考数据" }, "environmentConstruction": { "type": "string", "description": "环境创设内容" }, "themeId": { "type": "integer", "description": "主题 ID", "format": "int64" }, "pictureBookName": { "type": "string", "description": "绘本名称" }, "coverImagePath": { "type": "string", "description": "封面图片路径" }, "ebookPaths": { "type": "string", "description": "电子书路径" }, "audioPaths": { "type": "string", "description": "音频路径" }, "videoPaths": { "type": "string", "description": "视频路径" }, "otherResources": { "type": "string", "description": "其他资源" }, "pptPath": { "type": "string", "description": "PPT 文件路径" }, "pptName": { "type": "string", "description": "PPT 文件名称" }, "posterPaths": { "type": "string", "description": "海报路径" }, "tools": { "type": "string", "description": "教学工具" }, "studentMaterials": { "type": "string", "description": "学生材料" }, "lessonPlanData": { "type": "string", "description": "教案数据" }, "activitiesData": { "type": "string", "description": "活动数据" }, "assessmentData": { "type": "string", "description": "评估数据" }, "gradeTags": { "type": "array", "description": "年级标签(规范为数组,与套餐管理适用年级对齐)", "items": { "type": "string", "description": "年级标签(规范为数组,与套餐管理适用年级对齐)" } }, "domainTags": { "type": "array", "description": "领域标签(规范为数组)", "items": { "type": "string", "description": "领域标签(规范为数组)" } }, "hasCollectiveLesson": { "type": "integer", "description": "是否有集体课", "format": "int32" }, "version": { "type": "string", "description": "版本号" }, "parentId": { "type": "integer", "description": "父课程 ID", "format": "int64" }, "isLatest": { "type": "integer", "description": "是否最新版本", "format": "int32" }, "submittedAt": { "type": "string", "description": "提交时间", "format": "date-time" }, "submittedBy": { "type": "integer", "description": "提交人 ID", "format": "int64" }, "reviewedAt": { "type": "string", "description": "审核时间", "format": "date-time" }, "reviewedBy": { "type": "integer", "description": "审核人 ID", "format": "int64" }, "reviewComment": { "type": "string", "description": "审核意见" }, "reviewChecklist": { "type": "string", "description": "审核清单" }, "publishedAt": { "type": "string", "description": "发布时间", "format": "date-time" }, "usageCount": { "type": "integer", "description": "使用次数", "format": "int32" }, "teacherCount": { "type": "integer", "description": "教师数量", "format": "int32" }, "avgRating": { "type": "number", "description": "平均评分" }, "createdBy": { "type": "integer", "description": "创建人 ID", "format": "int64" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" }, "courseLessons": { "type": "array", "description": "关联的课程环节", "items": { "$ref": "#/components/schemas/CourseLessonResponse" } }, "lessonTags": { "type": "array", "description": "课程环节标签(列表展示用,仅 name 和 lessonType)", "items": { "$ref": "#/components/schemas/LessonTagResponse" } } }, "description": "课程响应" }, "LessonStepResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "lessonId": { "type": "integer", "description": "课时 ID", "format": "int64" }, "name": { "type": "string", "description": "名称" }, "content": { "type": "string", "description": "内容" }, "duration": { "type": "integer", "description": "时长", "format": "int32" }, "objective": { "type": "string", "description": "目标" }, "resourceIds": { "type": "string", "description": "资源 IDs" }, "sortOrder": { "type": "integer", "description": "排序号", "format": "int32" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" } }, "description": "教学环节响应" }, "LessonTagResponse": { "type": "object", "properties": { "name": { "type": "string", "description": "环节名称" }, "lessonType": { "type": "string", "description": "环节类型:INTRODUCTION、COLLECTIVE、LANGUAGE、HEALTH、SCIENCE、SOCIAL、ART" } }, "description": "课程环节标签" }, "ResultCourseResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/CourseResponse" } } }, "CourseLessonCreateRequest": { "required": [ "lessonType", "name" ], "type": "object", "properties": { "lessonType": { "type": "string", "description": "课程类型" }, "name": { "type": "string", "description": "课程名称" }, "description": { "type": "string", "description": "课程描述" }, "duration": { "type": "integer", "description": "时长(分钟)", "format": "int32" }, "videoPath": { "type": "string", "description": "视频路径" }, "videoName": { "type": "string", "description": "视频名称" }, "pptPath": { "type": "string", "description": "PPT 路径" }, "pptName": { "type": "string", "description": "PPT 名称" }, "pdfPath": { "type": "string", "description": "PDF 路径" }, "pdfName": { "type": "string", "description": "PDF 名称" }, "objectives": { "type": "string", "description": "教学目标" }, "preparation": { "type": "string", "description": "教学准备" }, "extension": { "type": "string", "description": "教学延伸" }, "reflection": { "type": "string", "description": "教学反思" }, "assessmentData": { "type": "string", "description": "评测数据" }, "useTemplate": { "type": "boolean", "description": "是否使用模板" } }, "description": "创建课程环节请求" }, "ResultCourseLessonResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/CourseLessonResponse" } } }, "LessonStepCreateRequest": { "type": "object", "properties": { "name": { "type": "string", "description": "环节名称" }, "content": { "type": "string", "description": "环节内容" }, "duration": { "type": "integer", "description": "时长(分钟)", "format": "int32" }, "objective": { "type": "string", "description": "教学目标" }, "resourceIds": { "type": "array", "description": "关联资源 ID 列表", "items": { "type": "integer", "description": "关联资源 ID 列表", "format": "int64" } } }, "description": "教学环节创建请求" }, "ResultLessonStepResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/LessonStepResponse" } } }, "CreateCollectionRequest": { "type": "object", "properties": { "name": { "type": "string", "description": "名称" }, "description": { "type": "string", "description": "描述" }, "price": { "type": "integer", "description": "价格(分)", "format": "int64" }, "discountPrice": { "type": "integer", "description": "折扣价格(分)", "format": "int64" }, "discountType": { "type": "string", "description": "折扣类型" }, "gradeLevels": { "type": "array", "description": "年级标签", "items": { "type": "string", "description": "年级标签" } } } }, "CourseCollectionResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "name": { "type": "string", "description": "名称" }, "description": { "type": "string", "description": "描述" }, "price": { "type": "integer", "description": "价格(分)", "format": "int64" }, "discountPrice": { "type": "integer", "description": "折后价格(分)", "format": "int64" }, "discountType": { "type": "string", "description": "折扣类型" }, "gradeLevels": { "type": "array", "description": "年级水平(数组)", "items": { "type": "string", "description": "年级水平(数组)" } }, "packageCount": { "type": "integer", "description": "课程包数量", "format": "int32" }, "status": { "type": "string", "description": "状态" }, "submittedAt": { "type": "string", "description": "提交时间", "format": "date-time" }, "submittedBy": { "type": "integer", "description": "提交人ID", "format": "int64" }, "reviewedAt": { "type": "string", "description": "审核时间", "format": "date-time" }, "reviewedBy": { "type": "integer", "description": "审核人ID", "format": "int64" }, "reviewComment": { "type": "string", "description": "审核意见" }, "publishedAt": { "type": "string", "description": "发布时间", "format": "date-time" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" }, "startDate": { "type": "string", "description": "开始日期(租户套餐)", "format": "date" }, "endDate": { "type": "string", "description": "结束日期(租户套餐)", "format": "date" }, "packages": { "type": "array", "description": "包含的课程包列表", "items": { "$ref": "#/components/schemas/CoursePackageItem" } } }, "description": "课程套餐响应" }, "CoursePackageItem": { "type": "object", "properties": { "id": { "type": "integer", "description": "课程包ID", "format": "int64" }, "name": { "type": "string", "description": "课程包名称" }, "description": { "type": "string", "description": "课程包描述" }, "gradeLevels": { "type": "array", "description": "适用年级", "items": { "type": "string", "description": "适用年级" } }, "courseCount": { "type": "integer", "description": "课程数量", "format": "int32" }, "sortOrder": { "type": "integer", "description": "排序号", "format": "int32" } }, "description": "课程包项" }, "ResultCourseCollectionResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/CourseCollectionResponse" } } }, "TaskCreateRequest": { "required": [ "title" ], "type": "object", "properties": { "title": { "type": "string", "description": "任务标题" }, "description": { "type": "string", "description": "描述" }, "type": { "type": "string", "description": "任务类型:reading-阅读,homework-作业,activity-活动" }, "taskType": { "type": "string", "description": "任务类型(前端兼容 taskType)" }, "relatedBookName": { "type": "string", "description": "关联绘本名称(手动填写)" }, "courseId": { "type": "integer", "description": "课程 ID", "format": "int64" }, "relatedCourseId": { "type": "integer", "description": "课程 ID(前端兼容 relatedCourseId)", "format": "int64" }, "startDate": { "type": "string", "description": "开始日期", "format": "date" }, "dueDate": { "type": "string", "description": "截止日期", "format": "date" }, "endDate": { "type": "string", "description": "截止日期(前端兼容 endDate)", "format": "date" }, "attachments": { "type": "string", "description": "附件(JSON 数组)" }, "targetType": { "type": "string", "description": "目标类型:class-班级,student-学生" }, "targetIds": { "type": "array", "description": "目标 IDs", "items": { "type": "integer", "description": "目标 IDs", "format": "int64" } } }, "description": "任务创建请求" }, "CreateTaskFromTemplateRequest": { "required": [ "title" ], "type": "object", "properties": { "templateId": { "type": "integer", "description": "模板 ID", "format": "int64" }, "title": { "type": "string", "description": "任务标题" }, "description": { "type": "string", "description": "任务描述" }, "startDate": { "type": "string", "description": "开始日期" }, "endDate": { "type": "string", "description": "截止日期" }, "targetType": { "type": "string", "description": "目标类型:class-班级,student-学生" }, "targetIds": { "type": "array", "description": "目标 IDs", "items": { "type": "integer", "description": "目标 IDs", "format": "int64" } } }, "description": "从模板创建任务请求" }, "ResultTask": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/Task" } } }, "Task": { "type": "object", "properties": { "id": { "type": "integer", "description": "主键 ID", "format": "int64" }, "createBy": { "type": "string", "description": "创建人" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updateBy": { "type": "string", "description": "更新人" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" }, "tenantId": { "type": "integer", "description": "租户 ID", "format": "int64" }, "title": { "type": "string", "description": "任务标题" }, "description": { "type": "string", "description": "任务描述" }, "type": { "type": "string", "description": "任务类型" }, "relatedBookName": { "type": "string", "description": "关联绘本名称" }, "courseId": { "type": "integer", "description": "课程 ID", "format": "int64" }, "creatorId": { "type": "integer", "description": "创建人 ID", "format": "int64" }, "creatorRole": { "type": "string", "description": "创建人角色" }, "startDate": { "type": "string", "description": "开始日期", "format": "date" }, "dueDate": { "type": "string", "description": "截止日期", "format": "date" }, "status": { "type": "string", "description": "状态" }, "attachments": { "type": "string", "description": "附件(JSON 数组)" } }, "description": "任务实体" }, "SchedulePlanCreateRequest": { "required": [ "classId", "name" ], "type": "object", "properties": { "name": { "type": "string", "description": "计划名称" }, "classId": { "type": "integer", "description": "班级 ID", "format": "int64" }, "courseId": { "type": "integer", "description": "课程 ID", "format": "int64" }, "coursePackageId": { "type": "integer", "description": "课程包 ID", "format": "int64" }, "lessonType": { "type": "string", "description": "课程类型 (INTRODUCTION/COLLECTIVE/LANGUAGE/SOCIETY/SCIENCE/ART/HEALTH)" }, "teacherId": { "type": "integer", "description": "教师 ID", "format": "int64" }, "scheduledDate": { "type": "string", "description": "排课日期", "format": "date" }, "scheduledTime": { "type": "string", "description": "时间段 (如:09:00-10:00)" }, "weekDay": { "type": "integer", "description": "星期几 (1-7)", "format": "int32" }, "repeatType": { "type": "string", "description": "重复方式 (NONE/WEEKLY)" }, "repeatEndDate": { "type": "string", "description": "重复截止日期", "format": "date" }, "source": { "type": "string", "description": "来源 (SCHOOL/TEACHER)" }, "note": { "type": "string", "description": "备注" } }, "description": "日程计划创建请求" }, "LessonCreateRequest": { "required": [ "courseId", "lessonDate", "teacherId", "title" ], "type": "object", "properties": { "courseId": { "type": "integer", "description": "课程 ID", "format": "int64" }, "classId": { "type": "integer", "description": "班级 ID", "format": "int64" }, "teacherId": { "type": "integer", "description": "教师 ID", "format": "int64" }, "title": { "type": "string", "description": "课时标题" }, "lessonDate": { "type": "string", "description": "课时日期", "format": "date" }, "startTime": { "$ref": "#/components/schemas/LocalTime" }, "endTime": { "$ref": "#/components/schemas/LocalTime" }, "location": { "type": "string", "description": "地点" }, "notes": { "type": "string", "description": "备注" } }, "description": "课时创建请求" }, "StudentRecordRequest": { "required": [ "studentId" ], "type": "object", "properties": { "studentId": { "type": "integer", "description": "学生 ID", "format": "int64" }, "attendance": { "type": "string", "description": "出勤状态" }, "focus": { "type": "integer", "description": "专注度评分 (1-5)", "format": "int32" }, "participation": { "type": "integer", "description": "参与度评分 (1-5)", "format": "int32" }, "interest": { "type": "integer", "description": "兴趣度评分 (1-5)", "format": "int32" }, "understanding": { "type": "integer", "description": "理解度评分 (1-5)", "format": "int32" }, "domainAchievements": { "type": "string", "description": "领域达成 (JSON 数组)" }, "performance": { "type": "string", "description": "表现评价" }, "notes": { "type": "string", "description": "备注" } }, "description": "学生记录保存请求" }, "ResultStudentRecordResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/StudentRecordResponse" } } }, "StudentRecordResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "lessonId": { "type": "integer", "description": "课程 ID", "format": "int64" }, "studentId": { "type": "integer", "description": "学生 ID", "format": "int64" }, "studentName": { "type": "string", "description": "学生姓名" }, "attendance": { "type": "string", "description": "出勤状态" }, "performance": { "type": "string", "description": "表现评价" }, "notes": { "type": "string", "description": "备注" }, "focus": { "type": "integer", "description": "专注度评分 (1-5)", "format": "int32" }, "participation": { "type": "integer", "description": "参与度评分 (1-5)", "format": "int32" }, "interest": { "type": "integer", "description": "兴趣度评分 (1-5)", "format": "int32" }, "understanding": { "type": "integer", "description": "理解度评分 (1-5)", "format": "int32" }, "domainAchievements": { "type": "string", "description": "领域达成 (JSON 数组)" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" } }, "description": "学生记录响应" }, "BatchStudentRecordsRequest": { "required": [ "records" ], "type": "object", "properties": { "records": { "type": "array", "description": "记录列表", "items": { "$ref": "#/components/schemas/StudentRecordRequest" } } }, "description": "批量保存学生记录请求" }, "ResultListStudentRecordResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/StudentRecordResponse" } } } }, "LessonFeedbackRequest": { "type": "object", "properties": { "content": { "type": "string", "description": "反馈内容" }, "rating": { "maximum": 5, "minimum": 1, "type": "integer", "description": "总体评分 (1-5)", "format": "int32" }, "designQuality": { "maximum": 5, "minimum": 1, "type": "integer", "description": "教学设计评分 (1-5)", "format": "int32" }, "participation": { "maximum": 5, "minimum": 1, "type": "integer", "description": "学生参与度评分 (1-5)", "format": "int32" }, "goalAchievement": { "maximum": 5, "minimum": 1, "type": "integer", "description": "目标达成度评分 (1-5)", "format": "int32" }, "stepFeedbacks": { "type": "string", "description": "各步骤反馈 (JSON 数组)" }, "pros": { "type": "string", "description": "优点" }, "suggestions": { "type": "string", "description": "建议" }, "activitiesDone": { "type": "string", "description": "已完成的活动" } }, "description": "课程反馈提交请求" }, "LessonFeedback": { "type": "object", "properties": { "id": { "type": "integer", "description": "主键 ID", "format": "int64" }, "createBy": { "type": "string", "description": "创建人" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updateBy": { "type": "string", "description": "更新人" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" }, "lessonId": { "type": "integer", "description": "课程 ID", "format": "int64" }, "teacherId": { "type": "integer", "description": "教师 ID", "format": "int64" }, "content": { "type": "string", "description": "反馈内容" }, "rating": { "type": "integer", "description": "评分", "format": "int32" }, "designQuality": { "type": "integer", "description": "教学设计评分 (1-5)", "format": "int32" }, "participation": { "type": "integer", "description": "学生参与度评分 (1-5)", "format": "int32" }, "goalAchievement": { "type": "integer", "description": "目标达成度评分 (1-5)", "format": "int32" }, "stepFeedbacks": { "type": "string", "description": "各步骤反馈 (JSON 数组)" }, "pros": { "type": "string", "description": "优点" }, "suggestions": { "type": "string", "description": "建议" }, "activitiesDone": { "type": "string", "description": "已完成的活动" } }, "description": "课程反馈实体" }, "ResultLessonFeedback": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/LessonFeedback" } } }, "GrowthRecordCreateRequest": { "required": [ "studentId", "title", "type" ], "type": "object", "properties": { "studentId": { "type": "integer", "description": "学生 ID", "format": "int64" }, "type": { "type": "string", "description": "类型:reading-阅读,behavior-行为,achievement-成就,milestone-里程碑" }, "title": { "type": "string", "description": "标题" }, "content": { "type": "string", "description": "内容" }, "images": { "type": "string", "description": "图片(JSON 数组)" }, "recordDate": { "type": "string", "description": "记录日期", "format": "date" }, "tags": { "type": "array", "description": "标签", "items": { "type": "string", "description": "标签" } } }, "description": "成长记录创建请求" }, "TeacherCreateRequest": { "required": [ "name", "password", "phone", "username" ], "type": "object", "properties": { "username": { "type": "string", "description": "用户名/登录账号" }, "password": { "type": "string", "description": "密码" }, "name": { "type": "string", "description": "姓名" }, "phone": { "type": "string", "description": "电话" }, "email": { "type": "string", "description": "邮箱" }, "gender": { "type": "string", "description": "性别" }, "bio": { "type": "string", "description": "简介" }, "classIds": { "type": "array", "description": "负责班级ID列表", "items": { "type": "integer", "description": "负责班级ID列表", "format": "int64" } } }, "description": "教师创建请求" }, "ResultMapStringString": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "object", "additionalProperties": { "type": "string" } } } }, "StudentCreateRequest": { "required": [ "name" ], "type": "object", "properties": { "name": { "type": "string", "description": "姓名" }, "gender": { "type": "string", "description": "性别" }, "birthDate": { "type": "string", "description": "出生日期", "format": "date" }, "grade": { "type": "string", "description": "年级" }, "studentNo": { "type": "string", "description": "学号" }, "readingLevel": { "type": "string", "description": "阅读水平" }, "interests": { "type": "string", "description": "兴趣爱好" }, "notes": { "type": "string", "description": "备注" } }, "description": "学生创建请求" }, "ResultListSchedulePlanResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/SchedulePlanResponse" } } } }, "ConflictCheckResult": { "type": "object", "properties": { "hasConflict": { "type": "boolean", "description": "是否有冲突" }, "conflicts": { "type": "array", "description": "冲突信息列表", "items": { "$ref": "#/components/schemas/ConflictInfo" } } }, "description": "冲突检测结果" }, "ConflictInfo": { "type": "object", "properties": { "type": { "type": "string", "description": "冲突类型:CLASS-班级冲突,TEACHER-教师冲突" }, "message": { "type": "string", "description": "冲突描述" }, "conflictScheduleId": { "type": "integer", "description": "冲突的排课 ID", "format": "int64" }, "className": { "type": "string", "description": "冲突的班级名称" }, "teacherName": { "type": "string", "description": "冲突的教师名称" }, "conflictTime": { "type": "string", "description": "冲突时间" } }, "description": "冲突信息" }, "ResultConflictCheckResult": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/ConflictCheckResult" } } }, "ScheduleCreateByClassesRequest": { "type": "object", "properties": { "classIds": { "type": "array", "description": "班级 ID 列表", "items": { "type": "integer", "description": "班级 ID 列表", "format": "int64" } }, "courseId": { "type": "integer", "description": "课程 ID", "format": "int64" }, "coursePackageId": { "type": "integer", "description": "课程包 ID", "format": "int64" }, "lessonType": { "type": "string", "description": "课程类型" }, "teacherId": { "type": "integer", "description": "教师 ID", "format": "int64" }, "scheduledDate": { "type": "string", "description": "排课日期", "format": "date" }, "scheduledTime": { "type": "string", "description": "时间段,如 '09:00-10:00'" }, "repeatType": { "type": "string", "description": "重复类型:NONE-单次,WEEKLY-每周,BIWEEKLY-双周,DAILY-每日" }, "repeatEndDate": { "type": "string", "description": "重复截止日期", "format": "date" }, "note": { "type": "string", "description": "备注" } }, "description": "按班级批量创建排课请求" }, "ParentCreateRequest": { "required": [ "name", "password", "username" ], "type": "object", "properties": { "username": { "type": "string", "description": "用户名" }, "password": { "type": "string", "description": "密码" }, "name": { "type": "string", "description": "姓名" }, "phone": { "type": "string", "description": "电话" }, "email": { "type": "string", "description": "邮箱" }, "gender": { "type": "string", "description": "性别" } }, "description": "家长创建请求" }, "RenewRequest": { "type": "object", "properties": { "endDate": { "type": "string", "description": "到期日期", "format": "date" }, "pricePaid": { "type": "integer", "description": "支付金额", "format": "int64" } }, "description": "套餐续费请求" }, "ClassCreateRequest": { "required": [ "name" ], "type": "object", "properties": { "name": { "type": "string", "description": "班级名称" }, "grade": { "type": "string", "description": "年级" }, "description": { "type": "string", "description": "描述" }, "capacity": { "type": "integer", "description": "容量", "format": "int32" } }, "description": "班级创建请求" }, "TaskCompleteRequest": { "required": [ "studentId" ], "type": "object", "properties": { "studentId": { "type": "integer", "description": "学生ID", "format": "int64" }, "content": { "type": "string", "description": "完成内容/反馈" }, "attachments": { "type": "string", "description": "附件" } }, "description": "任务完成请求" }, "RefreshTokenRequest": { "type": "object", "properties": { "accessToken": { "type": "string" }, "refreshToken": { "type": "string" } } }, "ImmTokenVo": { "type": "object", "properties": { "webofficeURL": { "type": "string" }, "accessToken": { "type": "string" }, "refreshToken": { "type": "string" }, "expireTime": { "type": "integer", "format": "int64" } } }, "ResultImmTokenVo": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/ImmTokenVo" } } }, "ResultTokenResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/TokenResponse" } } }, "TokenResponse": { "type": "object", "properties": { "token": { "type": "string", "description": "JWT Token" } }, "description": "Token 响应" }, "LoginRequest": { "required": [ "password", "username" ], "type": "object", "properties": { "username": { "type": "string", "description": "用户名", "example": "admin" }, "password": { "type": "string", "description": "密码", "example": "123456" }, "role": { "type": "string", "description": "登录角色", "example": "admin" } }, "description": "登录请求" }, "LoginResponse": { "type": "object", "properties": { "token": { "type": "string", "description": "JWT Token" }, "userId": { "type": "integer", "description": "用户 ID", "format": "int64" }, "username": { "type": "string", "description": "用户名" }, "name": { "type": "string", "description": "姓名" }, "role": { "type": "string", "description": "用户角色" }, "tenantId": { "type": "integer", "description": "租户 ID", "format": "int64" } }, "description": "登录响应" }, "ResultLoginResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/LoginResponse" } } }, "TenantCreateRequest": { "required": [ "code", "name" ], "type": "object", "properties": { "name": { "type": "string", "description": "租户名称" }, "code": { "type": "string", "description": "租户编码/登录账号" }, "password": { "type": "string", "description": "初始密码(留空默认 123456)" }, "contactName": { "type": "string", "description": "联系人" }, "contactPhone": { "type": "string", "description": "联系电话" }, "contactEmail": { "type": "string", "description": "联系邮箱" }, "address": { "type": "string", "description": "地址" }, "logoUrl": { "type": "string", "description": "Logo URL" }, "teacherQuota": { "type": "integer", "description": "教师配额", "format": "int32" }, "studentQuota": { "type": "integer", "description": "学生配额", "format": "int32" }, "startDate": { "type": "string", "description": "开始日期", "format": "date" }, "expireDate": { "type": "string", "description": "结束日期", "format": "date" }, "collectionIds": { "type": "array", "description": "课程套餐 ID 列表(可选,支持多选)", "items": { "type": "integer", "description": "课程套餐 ID 列表(可选,支持多选)", "format": "int64" } } }, "description": "租户创建请求" }, "ResourceLibraryCreateRequest": { "type": "object", "properties": { "name": { "type": "string", "description": "资源库名称" }, "type": { "type": "string", "description": "资源库类型" }, "description": { "type": "string", "description": "资源库描述" }, "tenantId": { "type": "string", "description": "租户 ID" } }, "description": "资源库创建请求" }, "ResourceItemCreateRequest": { "type": "object", "properties": { "libraryId": { "type": "string", "description": "资源库 ID" }, "title": { "type": "string", "description": "资源标题" }, "fileType": { "type": "string", "description": "文件类型" }, "filePath": { "type": "string", "description": "文件路径" }, "fileSize": { "type": "integer", "description": "文件大小(字节)", "format": "int64" }, "description": { "type": "string", "description": "资源描述" }, "tags": { "type": "array", "description": "标签(字符串数组)", "items": { "type": "string", "description": "标签(字符串数组)" } }, "tenantId": { "type": "string", "description": "租户 ID" } }, "description": "资源项目创建请求" }, "CourseCreateRequest": { "required": [ "name" ], "type": "object", "properties": { "name": { "type": "string", "description": "课程名称" }, "code": { "type": "string", "description": "课程编码" }, "description": { "type": "string", "description": "描述" }, "coverUrl": { "type": "string", "description": "封面 URL" }, "coverImagePath": { "type": "string", "description": "封面图片路径" }, "category": { "type": "string", "description": "分类" }, "ageRange": { "type": "string", "description": "年龄范围" }, "difficultyLevel": { "type": "string", "description": "难度等级" }, "durationMinutes": { "type": "integer", "description": "时长(分钟)", "format": "int32" }, "objectives": { "type": "string", "description": "教学目标" }, "coreContent": { "type": "string", "description": "核心内容" }, "introSummary": { "type": "string", "description": "课程摘要" }, "introHighlights": { "type": "string", "description": "课程亮点" }, "introGoals": { "type": "string", "description": "课程目标" }, "introSchedule": { "type": "string", "description": "内容安排" }, "introKeyPoints": { "type": "string", "description": "重点难点" }, "introMethods": { "type": "string", "description": "教学方法" }, "introEvaluation": { "type": "string", "description": "评估方法" }, "introNotes": { "type": "string", "description": "注意事项" }, "scheduleRefData": { "type": "string", "description": "进度安排参考数据(JSON)" }, "environmentConstruction": { "type": "string", "description": "环境创设内容" }, "themeId": { "type": "integer", "description": "主题 ID", "format": "int64" }, "pictureBookName": { "type": "string", "description": "绘本名称" }, "ebookPaths": { "type": "string", "description": "电子书路径(JSON 数组)" }, "audioPaths": { "type": "string", "description": "音频路径(JSON 数组)" }, "videoPaths": { "type": "string", "description": "视频路径(JSON 数组)" }, "otherResources": { "type": "string", "description": "其他资源(JSON 数组)" }, "pptPath": { "type": "string", "description": "PPT 文件路径" }, "pptName": { "type": "string", "description": "PPT 文件名称" }, "posterPaths": { "type": "string", "description": "海报路径(JSON 数组)" }, "tools": { "type": "string", "description": "教学工具(JSON 数组)" }, "studentMaterials": { "type": "string", "description": "学生材料" }, "lessonPlanData": { "type": "string", "description": "教案数据(JSON)" }, "activitiesData": { "type": "string", "description": "活动数据(JSON)" }, "assessmentData": { "type": "string", "description": "评估数据(JSON)" }, "gradeTags": { "type": "string", "description": "年级标签(JSON 数组)" }, "domainTags": { "type": "string", "description": "领域标签(JSON 数组)" }, "hasCollectiveLesson": { "type": "boolean", "description": "是否有集体课" } }, "description": "课程创建请求" }, "CourseRejectRequest": { "required": [ "comment" ], "type": "object", "properties": { "comment": { "type": "string", "description": "驳回意见" } }, "description": "课程包审核驳回请求" }, "CourseCollectionRejectRequest": { "type": "object", "properties": { "comment": { "type": "string", "description": "驳回意见" } }, "description": "课程套餐审核驳回请求" }, "Lesson": { "type": "object", "properties": { "id": { "type": "integer", "description": "主键 ID", "format": "int64" }, "createBy": { "type": "string", "description": "创建人" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updateBy": { "type": "string", "description": "更新人" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" }, "tenantId": { "type": "integer", "description": "租户 ID", "format": "int64" }, "courseId": { "type": "integer", "description": "课程 ID", "format": "int64" }, "classId": { "type": "integer", "description": "班级 ID", "format": "int64" }, "teacherId": { "type": "integer", "description": "教师 ID", "format": "int64" }, "schedulePlanId": { "type": "integer", "description": "排课计划 ID", "format": "int64" }, "title": { "type": "string", "description": "课程标题" }, "lessonDate": { "type": "string", "description": "上课日期", "format": "date" }, "startTime": { "$ref": "#/components/schemas/LocalTime" }, "endTime": { "$ref": "#/components/schemas/LocalTime" }, "plannedDatetime": { "type": "string", "description": "计划上课时间", "format": "date-time" }, "startDatetime": { "type": "string", "description": "实际上课开始时间", "format": "date-time" }, "endDatetime": { "type": "string", "description": "实际上课结束时间", "format": "date-time" }, "actualDuration": { "type": "integer", "description": "实际时长 (分钟)", "format": "int32" }, "location": { "type": "string", "description": "上课地点" }, "status": { "type": "string", "description": "状态" }, "overallRating": { "type": "string", "description": "整体评价" }, "participationRating": { "type": "string", "description": "参与度评价" }, "completionNote": { "type": "string", "description": "完成说明" }, "progressData": { "type": "string", "description": "进度数据 (JSON)" }, "currentLessonId": { "type": "integer", "description": "当前课程 ID", "format": "int32" }, "currentStepId": { "type": "integer", "description": "当前步骤 ID", "format": "int32" }, "lessonIds": { "type": "string", "description": "课程 ID 列表 (JSON)" }, "completedLessonIds": { "type": "string", "description": "已完成课程 ID 列表 (JSON)" }, "notes": { "type": "string", "description": "备注" } }, "description": "课程实体" }, "ResultListLesson": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Lesson" } } } }, "PageResultTaskResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/TaskResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultTaskResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultTaskResponse" } } }, "PageResultTaskCompletionDetailResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/TaskCompletionDetailResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultTaskCompletionDetailResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultTaskCompletionDetailResponse" } } }, "PageResultTaskTemplateResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/TaskTemplateResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultTaskTemplateResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultTaskTemplateResponse" } } }, "PageResultStudentResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/StudentResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultStudentResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultStudentResponse" } } }, "PageResultSchedulePlanResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/SchedulePlanResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultSchedulePlanResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultSchedulePlanResponse" } } }, "ResultListTimetableResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/TimetableResponse" } } } }, "TimetableResponse": { "type": "object", "properties": { "date": { "type": "string", "description": "日期", "format": "date" }, "weekDay": { "type": "integer", "description": "星期几 (1-7)", "format": "int32" }, "schedules": { "type": "array", "description": "排课列表", "items": { "$ref": "#/components/schemas/SchedulePlanResponse" } } }, "description": "课表响应" }, "CoursePackage": { "type": "object", "properties": { "id": { "type": "integer", "description": "主键 ID", "format": "int64" }, "createBy": { "type": "string", "description": "创建人" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updateBy": { "type": "string", "description": "更新人" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" }, "tenantId": { "type": "integer", "description": "租户 ID", "format": "int64" }, "name": { "type": "string", "description": "课程名称" }, "code": { "type": "string", "description": "课程编码" }, "description": { "type": "string", "description": "课程描述" }, "coverUrl": { "type": "string", "description": "封面 URL" }, "category": { "type": "string", "description": "课程类别" }, "ageRange": { "type": "string", "description": "适用年龄范围" }, "difficultyLevel": { "type": "string", "description": "难度等级" }, "durationMinutes": { "type": "integer", "description": "课程时长(分钟)", "format": "int32" }, "objectives": { "type": "string", "description": "课程目标" }, "status": { "type": "string", "description": "状态" }, "isSystem": { "type": "integer", "description": "是否系统课程", "format": "int32" }, "coreContent": { "type": "string", "description": "核心内容" }, "introSummary": { "type": "string", "description": "课程介绍 - 概要" }, "introHighlights": { "type": "string", "description": "课程介绍 - 亮点" }, "introGoals": { "type": "string", "description": "课程介绍 - 目标" }, "introSchedule": { "type": "string", "description": "课程介绍 - 进度安排" }, "introKeyPoints": { "type": "string", "description": "课程介绍 - 重点" }, "introMethods": { "type": "string", "description": "课程介绍 - 方法" }, "introEvaluation": { "type": "string", "description": "课程介绍 - 评估" }, "introNotes": { "type": "string", "description": "课程介绍 - 注意事项" }, "scheduleRefData": { "type": "string", "description": "进度计划参考数据(JSON)" }, "environmentConstruction": { "type": "string", "description": "环境创设(步骤 7)" }, "themeId": { "type": "integer", "description": "主题 ID", "format": "int64" }, "pictureBookName": { "type": "string", "description": "绘本名称" }, "coverImagePath": { "type": "string", "description": "封面图片路径" }, "ebookPaths": { "type": "string", "description": "电子绘本路径(JSON 数组)" }, "audioPaths": { "type": "string", "description": "音频资源路径(JSON 数组)" }, "videoPaths": { "type": "string", "description": "视频资源路径(JSON 数组)" }, "otherResources": { "type": "string", "description": "其他资源(JSON 数组)" }, "pptPath": { "type": "string", "description": "PPT 课件路径" }, "pptName": { "type": "string", "description": "PPT 课件名称" }, "posterPaths": { "type": "string", "description": "海报图片路径" }, "tools": { "type": "string", "description": "教学工具" }, "studentMaterials": { "type": "string", "description": "学生材料" }, "lessonPlanData": { "type": "string", "description": "教案数据(JSON)" }, "activitiesData": { "type": "string", "description": "活动数据(JSON)" }, "assessmentData": { "type": "string", "description": "评估数据(JSON)" }, "gradeTags": { "type": "string", "description": "年级标签(JSON 数组)" }, "domainTags": { "type": "string", "description": "领域标签(JSON 数组)" }, "hasCollectiveLesson": { "type": "integer", "description": "是否有集体课", "format": "int32" }, "version": { "type": "string", "description": "版本号" }, "parentId": { "type": "integer", "description": "父版本 ID", "format": "int64" }, "isLatest": { "type": "integer", "description": "是否最新版本", "format": "int32" }, "submittedAt": { "type": "string", "description": "提交时间", "format": "date-time" }, "submittedBy": { "type": "integer", "description": "提交人 ID", "format": "int64" }, "reviewedAt": { "type": "string", "description": "审核时间", "format": "date-time" }, "reviewedBy": { "type": "integer", "description": "审核人 ID", "format": "int64" }, "reviewComment": { "type": "string", "description": "审核意见" }, "reviewChecklist": { "type": "string", "description": "审核检查清单" }, "publishedAt": { "type": "string", "description": "发布时间", "format": "date-time" }, "usageCount": { "type": "integer", "description": "使用次数", "format": "int32" }, "teacherCount": { "type": "integer", "description": "教师数量", "format": "int32" }, "avgRating": { "type": "number", "description": "平均评分" } }, "description": "课程包实体(通过7步创建流程创建)" }, "ResultListCoursePackage": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/CoursePackage" } } } }, "Notification": { "type": "object", "properties": { "id": { "type": "integer", "description": "主键 ID", "format": "int64" }, "createBy": { "type": "string", "description": "创建人" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updateBy": { "type": "string", "description": "更新人" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" }, "tenantId": { "type": "integer", "description": "租户 ID", "format": "int64" }, "title": { "type": "string", "description": "通知标题" }, "content": { "type": "string", "description": "通知内容" }, "type": { "type": "string", "description": "通知类型" }, "senderId": { "type": "integer", "description": "发送人 ID", "format": "int64" }, "senderRole": { "type": "string", "description": "发送人角色" }, "recipientType": { "type": "string", "description": "接收人类型" }, "recipientId": { "type": "integer", "description": "接收人 ID", "format": "int64" }, "isRead": { "type": "integer", "description": "是否已读", "format": "int32" }, "readAt": { "type": "string", "description": "阅读时间", "format": "date-time" } }, "description": "通知实体" }, "PageResultNotification": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/Notification" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultNotification": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultNotification" } } }, "ResultNotification": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/Notification" } } }, "ResultLong": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "integer", "format": "int64" } } }, "PageResultLessonResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/LessonResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultLessonResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultLessonResponse" } } }, "LessonDetailResponse": { "type": "object", "properties": { "lesson": { "$ref": "#/components/schemas/LessonResponse" }, "course": { "$ref": "#/components/schemas/CourseResponse" }, "lessonType": { "type": "string", "description": "排课选择的课程类型(子课程模式时用于直接进入对应子课程)" }, "class": { "$ref": "#/components/schemas/ClassResponse" } }, "description": "授课记录详情响应" }, "ResultLessonDetailResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/LessonDetailResponse" } } }, "LessonInfo": { "type": "object", "properties": { "id": { "type": "integer", "description": "课时 ID", "format": "int64" }, "status": { "type": "string", "description": "状态" }, "className": { "type": "string", "description": "班级名称" } }, "description": "课时简要信息" }, "ResultStudentRecordsResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/StudentRecordsResponse" } } }, "StudentRecordsResponse": { "type": "object", "properties": { "lesson": { "$ref": "#/components/schemas/LessonInfo" }, "students": { "type": "array", "description": "学生列表(含记录)", "items": { "$ref": "#/components/schemas/StudentWithRecordResponse" } } }, "description": "课后记录列表响应" }, "StudentWithRecordResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "学生 ID", "format": "int64" }, "name": { "type": "string", "description": "学生姓名" }, "gender": { "type": "string", "description": "性别" }, "record": { "$ref": "#/components/schemas/StudentRecordResponse" } }, "description": "学生及其课后记录" }, "ResultListLessonResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/LessonResponse" } } } }, "ResultListMapStringObject": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "PageResultGrowthRecord": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/GrowthRecord" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultGrowthRecord": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultGrowthRecord" } } }, "LessonFeedbackResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "lessonId": { "type": "integer", "description": "课程 ID", "format": "int64" }, "teacherId": { "type": "integer", "description": "教师 ID", "format": "int64" }, "teacherName": { "type": "string", "description": "教师姓名" }, "content": { "type": "string", "description": "反馈内容" }, "rating": { "type": "integer", "description": "评分", "format": "int32" }, "designQuality": { "type": "integer", "description": "教学设计评分 (1-5)", "format": "int32" }, "participation": { "type": "integer", "description": "学生参与度评分 (1-5)", "format": "int32" }, "goalAchievement": { "type": "integer", "description": "目标达成度评分 (1-5)", "format": "int32" }, "stepFeedbacks": { "type": "string", "description": "各步骤反馈 (JSON 数组)" }, "pros": { "type": "string", "description": "优点" }, "suggestions": { "type": "string", "description": "建议" }, "activitiesDone": { "type": "string", "description": "已完成的活动" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" } }, "description": "课时反馈响应" }, "PageResultLessonFeedbackResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/LessonFeedbackResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultLessonFeedbackResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultLessonFeedbackResponse" } } }, "PageResultCourseResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/CourseResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultCourseResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultCourseResponse" } } }, "ResultListCourseResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/CourseResponse" } } } }, "ResultListClassResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ClassResponse" } } } }, "ResultListTeacherResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/TeacherResponse" } } } }, "PageResultTeacherResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/TeacherResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultTeacherResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultTeacherResponse" } } }, "LessonTypeInfo": { "type": "object", "properties": { "lessonType": { "type": "string", "description": "课程类型代码" }, "lessonTypeName": { "type": "string", "description": "课程类型名称" }, "count": { "type": "integer", "description": "该类型的课程数量", "format": "int64" } }, "description": "课程类型信息" }, "ResultListLessonTypeInfo": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/LessonTypeInfo" } } } }, "CalendarViewResponse": { "type": "object", "properties": { "startDate": { "type": "string", "description": "开始日期", "format": "date" }, "endDate": { "type": "string", "description": "结束日期", "format": "date" }, "schedules": { "type": "object", "additionalProperties": { "type": "array", "description": "按日期分组的排课数据", "items": { "$ref": "#/components/schemas/DayScheduleItem" } }, "description": "按日期分组的排课数据" } }, "description": "日历视图响应" }, "DayScheduleItem": { "type": "object", "properties": { "id": { "type": "integer", "description": "排课 ID", "format": "int64" }, "className": { "type": "string", "description": "班级名称" }, "coursePackageName": { "type": "string", "description": "课程包名称" }, "lessonType": { "type": "string", "description": "课程类型代码 (如 DOMAIN_HEALTH)" }, "lessonTypeName": { "type": "string", "description": "课程类型名称" }, "teacherName": { "type": "string", "description": "教师名称" }, "scheduledTime": { "type": "string", "description": "时间段" }, "status": { "type": "string", "description": "状态" } }, "description": "日历项" }, "ResultCalendarViewResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/CalendarViewResponse" } } }, "ResultListTeacherReportResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/TeacherReportResponse" } } } }, "TeacherReportResponse": { "type": "object", "properties": { "teacherId": { "type": "integer", "description": "教师ID", "format": "int64" }, "teacherName": { "type": "string", "description": "教师姓名" }, "lessonCount": { "type": "integer", "description": "授课次数", "format": "int32" }, "taskCount": { "type": "integer", "description": "完成任务数", "format": "int32" }, "averageRating": { "type": "number", "description": "学生评价平均分", "format": "double" }, "lastLessonTime": { "type": "string", "description": "最后授课时间", "format": "date-time" } }, "description": "教师报告响应" }, "ResultListStudentReportResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/StudentReportResponse" } } } }, "StudentReportResponse": { "type": "object", "properties": { "studentId": { "type": "integer", "description": "学生ID", "format": "int64" }, "studentName": { "type": "string", "description": "学生姓名" }, "className": { "type": "string", "description": "班级名称" }, "taskCount": { "type": "integer", "description": "完成任务数", "format": "int32" }, "readingCount": { "type": "integer", "description": "阅读记录数", "format": "int32" }, "growthRecordCount": { "type": "integer", "description": "成长记录数", "format": "int32" }, "attendanceRate": { "type": "number", "description": "出勤率", "format": "double" } }, "description": "学生报告响应" }, "ReportOverviewResponse": { "type": "object", "properties": { "reportDate": { "type": "string", "description": "报告日期", "format": "date" }, "totalTeachers": { "type": "integer", "description": "教师总数", "format": "int32" }, "totalStudents": { "type": "integer", "description": "学生总数", "format": "int32" }, "totalClasses": { "type": "integer", "description": "班级总数", "format": "int32" }, "monthlyLessons": { "type": "integer", "description": "本月授课次数", "format": "int32" }, "monthlyTasksCompleted": { "type": "integer", "description": "本月任务完成数", "format": "int32" }, "courseStats": { "type": "object", "additionalProperties": { "type": "object", "description": "课程使用统计" }, "description": "课程使用统计" } }, "description": "报告概览响应" }, "ResultReportOverviewResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/ReportOverviewResponse" } } }, "CourseReportResponse": { "type": "object", "properties": { "courseId": { "type": "integer", "description": "课程ID", "format": "int64" }, "courseName": { "type": "string", "description": "课程名称" }, "lessonCount": { "type": "integer", "description": "授课次数", "format": "int32" }, "studentCount": { "type": "integer", "description": "参与学生数", "format": "int32" }, "averageRating": { "type": "number", "description": "平均评分", "format": "double" }, "completionRate": { "type": "number", "description": "完成率", "format": "double" } }, "description": "课程报告响应" }, "ResultListCourseReportResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/CourseReportResponse" } } } }, "ResultObject": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "object" } } }, "PageResultParentResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/ParentResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultParentResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultParentResponse" } } }, "ParentStudentResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "parentId": { "type": "integer", "description": "家长 ID", "format": "int64" }, "studentId": { "type": "integer", "description": "学生 ID", "format": "int64" }, "relationship": { "type": "string", "description": "关系" }, "isPrimary": { "type": "integer", "description": "是否主要监护人", "format": "int32" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "家长学生关系响应" }, "ResultListParentStudentResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ParentStudentResponse" } } } }, "ResultListCourseCollectionResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/CourseCollectionResponse" } } } }, "CoursePackageCourseItem": { "type": "object", "properties": { "id": { "type": "integer", "description": "课程 ID", "format": "int64" }, "name": { "type": "string", "description": "课程名称" }, "gradeLevel": { "type": "string", "description": "适用年级" }, "sortOrder": { "type": "integer", "description": "排序号", "format": "int32" }, "scheduleRefData": { "type": "string", "description": "排课计划参考数据(JSON)" }, "lessonType": { "type": "string", "description": "课程类型" } }, "description": "课程包中的课程项" }, "CoursePackageResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "name": { "type": "string", "description": "名称" }, "description": { "type": "string", "description": "描述" }, "price": { "type": "integer", "description": "价格(分)", "format": "int64" }, "discountPrice": { "type": "integer", "description": "折后价格(分)", "format": "int64" }, "discountType": { "type": "string", "description": "折扣类型" }, "gradeLevels": { "type": "array", "description": "年级水平(数组)", "items": { "type": "string", "description": "年级水平(数组)" } }, "courseCount": { "type": "integer", "description": "课程数量", "format": "int32" }, "tenantCount": { "type": "integer", "description": "使用学校数", "format": "int32" }, "status": { "type": "string", "description": "状态" }, "submittedAt": { "type": "string", "description": "提交时间", "format": "date-time" }, "submittedBy": { "type": "integer", "description": "提交人 ID", "format": "int64" }, "reviewedAt": { "type": "string", "description": "审核时间", "format": "date-time" }, "reviewedBy": { "type": "integer", "description": "审核人 ID", "format": "int64" }, "reviewComment": { "type": "string", "description": "审核意见" }, "publishedAt": { "type": "string", "description": "发布时间", "format": "date-time" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" }, "courses": { "type": "array", "description": "包含的课程", "items": { "$ref": "#/components/schemas/CoursePackageCourseItem" } }, "startDate": { "type": "string", "description": "开始日期(租户套餐)", "format": "date" }, "endDate": { "type": "string", "description": "结束日期(租户套餐)", "format": "date" }, "sortOrder": { "type": "integer", "description": "排序号(在课程套餐中的顺序)", "format": "int32" } }, "description": "课程套餐响应" }, "ResultListCoursePackageResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/CoursePackageResponse" } } } }, "PackageInfoResponse": { "type": "object", "properties": { "name": { "type": "string", "description": "学校名称" }, "code": { "type": "string", "description": "学校编码" }, "status": { "type": "string", "description": "状态" }, "expireDate": { "type": "string", "description": "到期时间", "format": "date-time" }, "maxTeachers": { "type": "integer", "description": "最大教师数", "format": "int32" }, "maxStudents": { "type": "integer", "description": "最大学生数", "format": "int32" } }, "description": "套餐信息响应" }, "ResultPackageInfoResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PackageInfoResponse" } } }, "PackageUsageResponse": { "type": "object", "properties": { "teacher": { "$ref": "#/components/schemas/UsageInfo" }, "student": { "$ref": "#/components/schemas/UsageInfo" } }, "description": "套餐使用情况响应" }, "ResultPackageUsageResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PackageUsageResponse" } } }, "UsageInfo": { "type": "object", "properties": { "used": { "type": "integer", "description": "已使用数量", "format": "int32" }, "quota": { "type": "integer", "description": "配额", "format": "int32" }, "percentage": { "type": "integer", "description": "使用百分比", "format": "int32" } }, "description": "使用情况详情" }, "OperationLogResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "tenantId": { "type": "integer", "description": "租户 ID", "format": "int64" }, "userId": { "type": "integer", "description": "用户 ID", "format": "int64" }, "userRole": { "type": "string", "description": "用户角色" }, "action": { "type": "string", "description": "操作" }, "module": { "type": "string", "description": "模块" }, "targetType": { "type": "string", "description": "目标类型" }, "targetId": { "type": "integer", "description": "目标 ID", "format": "int64" }, "details": { "type": "string", "description": "详情" }, "ipAddress": { "type": "string", "description": "IP 地址" }, "userAgent": { "type": "string", "description": "用户代理" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "操作日志响应" }, "PageResultOperationLogResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/OperationLogResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultOperationLogResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultOperationLogResponse" } } }, "ResultOperationLogResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/OperationLogResponse" } } }, "PageResultGrowthRecordResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/GrowthRecordResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultGrowthRecordResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultGrowthRecordResponse" } } }, "PageResultSchoolCourseResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/SchoolCourseResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultSchoolCourseResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultSchoolCourseResponse" } } }, "SchoolCourseResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "tenantId": { "type": "integer", "description": "租户 ID", "format": "int64" }, "name": { "type": "string", "description": "课程名称" }, "code": { "type": "string", "description": "课程编码" }, "description": { "type": "string", "description": "描述" }, "pictureBookName": { "type": "string", "description": "绘本名称" }, "coverImagePath": { "type": "string", "description": "封面图片路径" }, "coverUrl": { "type": "string", "description": "封面 URL" }, "gradeTags": { "type": "array", "description": "年级标签(规范为数组)", "items": { "type": "string", "description": "年级标签(规范为数组)" } }, "domainTags": { "type": "array", "description": "领域标签(规范为数组)", "items": { "type": "string", "description": "领域标签(规范为数组)" } }, "duration": { "type": "integer", "description": "课程时长(分钟)", "format": "int32" }, "usageCount": { "type": "integer", "description": "使用次数", "format": "int32" }, "teacherCount": { "type": "integer", "description": "教师数量", "format": "int32" }, "avgRating": { "type": "number", "description": "平均评分" }, "status": { "type": "string", "description": "状态" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "updatedAt": { "type": "string", "description": "更新时间", "format": "date-time" }, "lessonTags": { "type": "array", "description": "课程环节标签(列表展示用,仅 name 和 lessonType)", "items": { "$ref": "#/components/schemas/LessonTagResponse" } } }, "description": "学校端课程响应" }, "ResultSchoolCourseResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/SchoolCourseResponse" } } }, "PageResultClassResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/ClassResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultClassResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultClassResponse" } } }, "ClassTeacherResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "classId": { "type": "integer", "description": "班级 ID", "format": "int64" }, "teacherId": { "type": "integer", "description": "教师 ID", "format": "int64" }, "role": { "type": "string", "description": "角色" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "班级教师关系响应" }, "ResultListClassTeacherResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ClassTeacherResponse" } } } }, "CourseInfo": { "type": "object", "properties": { "id": { "type": "integer", "description": "课程ID", "format": "int64" }, "name": { "type": "string", "description": "课程名称" } }, "description": "关联课程信息" }, "PageResultTaskWithCompletionResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/TaskWithCompletionResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultTaskWithCompletionResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultTaskWithCompletionResponse" } } }, "TaskInfo": { "type": "object", "properties": { "id": { "type": "integer", "description": "任务ID", "format": "int64" }, "title": { "type": "string", "description": "任务标题" }, "description": { "type": "string", "description": "任务描述" }, "taskType": { "type": "string", "description": "任务类型" }, "startDate": { "type": "string", "description": "开始日期", "format": "date" }, "endDate": { "type": "string", "description": "截止日期", "format": "date" }, "relatedBookName": { "type": "string", "description": "关联绘本名称" }, "course": { "$ref": "#/components/schemas/CourseInfo" } }, "description": "任务基本信息" }, "TaskWithCompletionResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "任务ID", "format": "int64" }, "status": { "type": "string", "description": "完成状态:PENDING-待提交/SUBMITTED-已提交/REVIEWED-已评价" }, "submittedAt": { "type": "string", "description": "提交时间", "format": "date-time" }, "reviewedAt": { "type": "string", "description": "评价时间", "format": "date-time" }, "photos": { "type": "array", "description": "照片URL列表", "items": { "type": "string", "description": "照片URL列表" } }, "videoUrl": { "type": "string", "description": "视频URL" }, "audioUrl": { "type": "string", "description": "语音URL" }, "content": { "type": "string", "description": "阅读心得/完成内容" }, "teacherFeedback": { "$ref": "#/components/schemas/TaskFeedbackResponse" }, "task": { "$ref": "#/components/schemas/TaskInfo" } }, "description": "家长端任务列表响应(含完成信息)" }, "NotificationForParentResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "title": { "type": "string", "description": "标题" }, "content": { "type": "string", "description": "内容" }, "isRead": { "type": "boolean", "description": "是否已读" }, "readAt": { "type": "string", "description": "阅读时间", "format": "date-time" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "notificationType": { "type": "string", "description": "通知类型" } }, "description": "家长端通知响应" }, "PageResultNotificationForParentResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/NotificationForParentResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultNotificationForParentResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultNotificationForParentResponse" } } }, "ResultNotificationForParentResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/NotificationForParentResponse" } } }, "GrowthRecordForParentResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "title": { "type": "string", "description": "标题" }, "content": { "type": "string", "description": "内容" }, "images": { "type": "array", "description": "图片URL列表", "items": { "type": "string", "description": "图片URL列表" } }, "recordDate": { "type": "string", "description": "记录日期", "format": "date" }, "recordType": { "type": "string", "description": "记录类型" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" }, "class": { "$ref": "#/components/schemas/ClassInfo" } }, "description": "家长端成长档案响应" }, "ResultGrowthRecordForParentResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/GrowthRecordForParentResponse" } } }, "PageResultGrowthRecordForParentResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/GrowthRecordForParentResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultGrowthRecordForParentResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultGrowthRecordForParentResponse" } } }, "ResultListGrowthRecordForParentResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/GrowthRecordForParentResponse" } } } }, "ChildInfoResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "学生ID", "format": "int64" }, "name": { "type": "string", "description": "姓名" }, "gender": { "type": "string", "description": "性别" }, "birthDate": { "type": "string", "description": "出生日期", "format": "date" }, "relationship": { "type": "string", "description": "与家长关系:FATHER/MOTHER/GRANDFATHER/GRANDMOTHER/OTHER" }, "readingCount": { "type": "integer", "description": "阅读次数(student_record 数量)", "format": "int32" }, "lessonCount": { "type": "integer", "description": "上课次数(lesson 记录数)", "format": "int32" }, "class": { "$ref": "#/components/schemas/ClassInfo" } }, "description": "家长端孩子列表响应" }, "ResultListChildInfoResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ChildInfoResponse" } } } }, "ChildProfileResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "学生ID", "format": "int64" }, "name": { "type": "string", "description": "姓名" }, "gender": { "type": "string", "description": "性别" }, "birthDate": { "type": "string", "description": "出生日期", "format": "date" }, "relationship": { "type": "string", "description": "与家长关系" }, "readingCount": { "type": "integer", "description": "阅读次数", "format": "int32" }, "lessonCount": { "type": "integer", "description": "上课次数", "format": "int32" }, "stats": { "$ref": "#/components/schemas/StatsInfo" }, "class": { "$ref": "#/components/schemas/ClassInfo" } }, "description": "家长端孩子详情响应" }, "ResultChildProfileResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/ChildProfileResponse" } } }, "StatsInfo": { "type": "object", "properties": { "lessonRecords": { "type": "integer", "description": "阅读记录数", "format": "int32" }, "growthRecords": { "type": "integer", "description": "成长档案数", "format": "int32" }, "taskCompletions": { "type": "integer", "description": "任务完成数", "format": "int32" } }, "description": "统计信息" }, "LessonRecordResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "记录ID(student_record.id)", "format": "int64" }, "lesson": { "$ref": "#/components/schemas/LessonInfo" }, "focus": { "type": "integer", "description": "专注度评分", "format": "int32" }, "participation": { "type": "integer", "description": "参与度评分", "format": "int32" }, "interest": { "type": "integer", "description": "兴趣度评分", "format": "int32" }, "understanding": { "type": "integer", "description": "理解度评分", "format": "int32" }, "notes": { "type": "string", "description": "备注" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "家长端阅读记录响应" }, "PageResultLessonRecordResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/LessonRecordResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultLessonRecordResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultLessonRecordResponse" } } }, "OssTokenVo": { "type": "object", "properties": { "accessid": { "type": "string" }, "policy": { "type": "string" }, "signature": { "type": "string" }, "dir": { "type": "string" }, "host": { "type": "string" }, "key": { "type": "string" }, "expire": { "type": "integer", "format": "int32" } } }, "ResultOssTokenVo": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/OssTokenVo" } } }, "ResultUserInfoResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/UserInfoResponse" } } }, "UserInfoResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "用户 ID", "format": "int64" }, "username": { "type": "string", "description": "用户名" }, "name": { "type": "string", "description": "姓名" }, "email": { "type": "string", "description": "邮箱" }, "phone": { "type": "string", "description": "电话" }, "avatarUrl": { "type": "string", "description": "头像 URL" }, "role": { "type": "string", "description": "用户角色" }, "tenantId": { "type": "integer", "description": "租户 ID", "format": "int64" } }, "description": "用户信息响应" }, "ResultListThemeResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ThemeResponse" } } } }, "PageResultTenantResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/TenantResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultTenantResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultTenantResponse" } } }, "ResultListTenantResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/TenantResponse" } } } }, "ResultStatsResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/StatsResponse" } } }, "StatsResponse": { "type": "object", "properties": { "totalTenants": { "type": "integer", "description": "租户总数", "format": "int64" }, "activeTenants": { "type": "integer", "description": "活跃租户数", "format": "int64" }, "totalTeachers": { "type": "integer", "description": "教师总数", "format": "int64" }, "totalStudents": { "type": "integer", "description": "学生总数", "format": "int64" }, "totalCourses": { "type": "integer", "description": "课程总数", "format": "int64" }, "totalLessons": { "type": "integer", "description": "课时总数", "format": "int64" } }, "description": "统计数据响应" }, "ResultStatsTrendResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/StatsTrendResponse" } } }, "StatsTrendResponse": { "type": "object", "properties": { "dates": { "type": "array", "description": "日期列表", "items": { "type": "string", "description": "日期列表" } }, "newStudents": { "type": "array", "description": "新增学生数列表", "items": { "type": "integer", "description": "新增学生数列表", "format": "int32" } }, "newTeachers": { "type": "array", "description": "新增教师数列表", "items": { "type": "integer", "description": "新增教师数列表", "format": "int32" } }, "newCourses": { "type": "array", "description": "新增课程数列表", "items": { "type": "integer", "description": "新增课程数列表", "format": "int32" } } }, "description": "趋势数据响应" }, "ActiveTenantsQueryRequest": { "type": "object", "properties": { "limit": { "type": "integer", "description": "返回数量限制", "format": "int32", "example": 5 } }, "description": "活跃租户查询请求" }, "ActiveTenantItemResponse": { "type": "object", "properties": { "tenantId": { "type": "integer", "description": "租户 ID", "format": "int64" }, "tenantName": { "type": "string", "description": "租户名称" }, "activeUsers": { "type": "integer", "description": "活跃用户数", "format": "int32" }, "courseCount": { "type": "integer", "description": "课程使用数", "format": "int32" } }, "description": "活跃租户项响应" }, "ResultListActiveTenantItemResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ActiveTenantItemResponse" } } } }, "PopularCoursesQueryRequest": { "type": "object", "properties": { "limit": { "type": "integer", "description": "返回数量限制", "format": "int32", "example": 5 } }, "description": "热门课程查询请求" }, "PopularCourseItemResponse": { "type": "object", "properties": { "courseId": { "type": "integer", "description": "课程 ID", "format": "int64" }, "courseName": { "type": "string", "description": "课程名称" }, "usageCount": { "type": "integer", "description": "使用次数", "format": "int32" }, "teacherCount": { "type": "integer", "description": "教师数量", "format": "int32" } }, "description": "热门课程项响应" }, "ResultListPopularCourseItemResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/PopularCourseItemResponse" } } } }, "RecentActivitiesQueryRequest": { "type": "object", "properties": { "limit": { "type": "integer", "description": "返回数量限制", "format": "int32", "example": 10 } }, "description": "最近活动查询请求" }, "RecentActivityItemResponse": { "type": "object", "properties": { "activityId": { "type": "integer", "description": "活动 ID", "format": "int64" }, "activityType": { "type": "string", "description": "活动类型" }, "description": { "type": "string", "description": "活动描述" }, "operatorId": { "type": "integer", "description": "操作人 ID", "format": "int64" }, "operatorName": { "type": "string", "description": "操作人名称" }, "operationTime": { "type": "string", "description": "操作时间", "format": "date-time" } }, "description": "最近活动项响应" }, "ResultListRecentActivityItemResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/RecentActivityItemResponse" } } } }, "PageResultResourceLibraryResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/ResourceLibraryResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultResourceLibraryResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultResourceLibraryResponse" } } }, "PageResultResourceItemResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/ResourceItemResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultResourceItemResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultResourceItemResponse" } } }, "CoursePageQueryRequest": { "type": "object", "properties": { "pageNum": { "type": "integer", "description": "页码", "format": "int32", "example": 1 }, "pageSize": { "type": "integer", "description": "每页数量", "format": "int32", "example": 10 }, "keyword": { "type": "string", "description": "关键词" }, "category": { "type": "string", "description": "分类" }, "status": { "type": "string", "description": "状态" }, "gradeTags": { "type": "string", "description": "年级(支持多个,逗号分隔)" }, "reviewOnly": { "type": "boolean", "description": "是否仅查询待审核", "example": false } }, "description": "课程分页查询请求" }, "ResultListCourseLessonResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/CourseLessonResponse" } } } }, "ResultListLessonStepResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/LessonStepResponse" } } } }, "CourseCollectionPageQueryRequest": { "type": "object", "properties": { "pageNum": { "type": "integer", "description": "页码", "format": "int32", "example": 1 }, "pageSize": { "type": "integer", "description": "每页数量", "format": "int32", "example": 10 }, "status": { "type": "string", "description": "状态" }, "gradeLevels": { "type": "string", "description": "年级(支持多个,逗号分隔)" } }, "description": "课程套餐分页查询请求" }, "PageResultCourseCollectionResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/CourseCollectionResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultCourseCollectionResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultCourseCollectionResponse" } } } }, "securitySchemes": { "Bearer": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT" } } }, "x-openapi": { "x-setting": { "customCode": 200, "language": "zh-CN", "enableSwaggerModels": true, "swaggerModelName": "Swagger Models", "enableReloadCacheParameter": false, "enableAfterScript": true, "enableDocumentManage": true, "enableVersion": false, "enableRequestCache": true, "enableFilterMultipartApis": false, "enableFilterMultipartApiMethodType": "POST", "enableHost": false, "enableHostText": "", "enableDynamicParameter": false, "enableDebug": true, "enableFooter": true, "enableFooterCustom": false, "enableSearch": true, "enableOpenApi": true, "enableHomeCustom": false, "enableGroup": true, "enableResponseCode": true }, "x-markdownFiles": [] } }