{ "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:8080", "description": "Generated server url" } ], "security": [ { "Bearer": [] } ], "tags": [ { "name": "教师端 - 任务模板", "description": "Teacher Task Template APIs" }, { "name": "教师端 - 反馈管理", "description": "Teacher Feedback APIs" }, { "name": "School - Task", "description": "Task Management APIs for School" }, { "name": "Parent - Task", "description": "Task APIs for Parent" }, { "name": "Admin - Course", "description": "System Course Management APIs for Admin" }, { "name": "超管 - 系统设置", "description": "Admin Settings APIs" }, { "name": "学校端 - 操作日志", "description": "School Operation Log APIs" }, { "name": "School - Parent", "description": "Parent Management APIs for School" }, { "name": "Parent - Child", "description": "Child Information APIs for Parent" }, { "name": "Teacher - Task", "description": "Task APIs for Teacher" }, { "name": "学校端 - 排课管理", "description": "School Schedule APIs" }, { "name": "学校端 - 反馈管理", "description": "School Feedback APIs" }, { "name": "Teacher - Notification", "description": "Notification APIs for Teacher" }, { "name": "School - Student", "description": "Student Management APIs for School" }, { "name": "School - Class", "description": "Class Management APIs for School" }, { "name": "Parent - Growth Record", "description": "Growth Record APIs for Parent" }, { "name": "学校端 - 数据报告", "description": "School Report APIs" }, { "name": "Teacher - Course", "description": "Course APIs for Teacher" }, { "name": "学校端 - 数据导出", "description": "School Export APIs" }, { "name": "School - Teacher", "description": "Teacher Management APIs for School" }, { "name": "认证管理", "description": "Authentication APIs" }, { "name": "教师端 - 排课管理", "description": "Teacher Schedule APIs" }, { "name": "超管 - 统计管理", "description": "Admin Stats APIs" }, { "name": "超管端 - 租户管理", "description": "Tenant Management APIs for Admin" }, { "name": "学校端 - 任务模板", "description": "School Task Template APIs" }, { "name": "Teacher - Growth Record", "description": "Growth Record APIs for Teacher" }, { "name": "学校端 - 系统设置", "description": "School Settings APIs" }, { "name": "Teacher - Lesson", "description": "Lesson APIs for Teacher" }, { "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": [ "Teacher - Task" ], "summary": "Get task by 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": [ "Teacher - Task" ], "summary": "Update task", "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": [ "Teacher - Task" ], "summary": "Delete task", "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/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/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": "updateTemplate", "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/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" } } } } } }, "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/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": "updateSchedule", "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/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" } } } } } }, "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": [ "Teacher - Lesson" ], "summary": "Get lesson by ID", "operationId": "getLesson", "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": [ "Teacher - Lesson" ], "summary": "Update lesson", "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/growth-records/{id}": { "get": { "tags": [ "Teacher - Growth Record" ], "summary": "Get growth record by 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": [ "Teacher - Growth Record" ], "summary": "Update growth record", "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": [ "Teacher - Growth Record" ], "summary": "Delete growth record", "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/tasks/{id}": { "get": { "tags": [ "School - Task" ], "summary": "Get task by ID", "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" } } } } } }, "put": { "tags": [ "School - Task" ], "summary": "Update task", "operationId": "updateTask_1", "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": [ "School - Task" ], "summary": "Delete task", "operationId": "deleteTask_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/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/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": "updateTemplate_1", "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/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" } } } } } }, "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/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", "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/school/settings/security": { "get": { "tags": [ "学校端 - 系统设置" ], "summary": "获取安全设置", "operationId": "getSecuritySettings", "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", "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/school/settings/notification": { "get": { "tags": [ "学校端 - 系统设置" ], "summary": "获取通知设置", "operationId": "getNotificationSettings", "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", "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/school/settings/basic": { "get": { "tags": [ "学校端 - 系统设置" ], "summary": "获取基础设置", "operationId": "getBasicSettings", "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", "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/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/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": "updateSchedule_1", "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/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" } } } } } }, "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/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/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": [ "Parent - Growth Record" ], "summary": "Update growth record", "operationId": "updateGrowthRecord_2", "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": [ "Parent - Growth Record" ], "summary": "Delete growth record", "operationId": "deleteGrowthRecord_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/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/ResultTheme" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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/ResultTheme" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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/ResultResourceLibrary" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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/LibraryUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultResourceLibrary" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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/ResultResourceItem" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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/ItemUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultResourceItem" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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": "findOne_1", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultCoursePackageResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PackageCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultCoursePackage" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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": "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}/courses": { "put": { "tags": [ "超管端 - 课程套餐" ], "summary": "设置套餐课程", "operationId": "setCourses", "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/admin/courses/{id}": { "get": { "tags": [ "Admin - Course" ], "summary": "Get course by ID", "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": [ "Admin - Course" ], "summary": "Update course", "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/ResultCourse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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": [ "Admin - Course" ], "summary": "Delete course", "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_2", "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/ResultCourseLesson" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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": "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/ResultCourseLesson" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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": "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/StepCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultLessonStep" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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/teacher/tasks": { "get": { "tags": [ "Teacher - Task" ], "summary": "Get task page", "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": "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": [ "Teacher - Task" ], "summary": "Create task", "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" } } ], "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" } } } } } }, "post": { "tags": [ "教师端 - 任务模板" ], "summary": "创建模板", "operationId": "createTemplate", "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/teacher/task-templates/from-template": { "post": { "tags": [ "教师端 - 任务模板" ], "summary": "从模板创建任务", "operationId": "createFromTemplate", "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/teacher/schedules": { "get": { "tags": [ "教师端 - 排课管理" ], "summary": "获取教师排课列表", "operationId": "getSchedules", "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" } } } } } }, "post": { "tags": [ "教师端 - 排课管理" ], "summary": "创建排课", "operationId": "createSchedule", "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/teacher/notifications/{id}/read": { "post": { "tags": [ "Teacher - Notification" ], "summary": "Mark notification as read", "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": [ "Teacher - Notification" ], "summary": "Mark all notifications as read", "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": [ "Teacher - Lesson" ], "summary": "Get my lessons", "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": [ "Teacher - Lesson" ], "summary": "Create lesson", "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}/start": { "post": { "tags": [ "Teacher - Lesson" ], "summary": "Start lesson", "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}/complete": { "post": { "tags": [ "Teacher - Lesson" ], "summary": "Complete lesson", "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": [ "Teacher - Lesson" ], "summary": "Cancel lesson", "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/growth-records": { "get": { "tags": [ "Teacher - Growth Record" ], "summary": "Get growth record page", "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": [ "Teacher - Growth Record" ], "summary": "Create growth record", "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" } }, { "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/tasks": { "get": { "tags": [ "School - Task" ], "summary": "Get task page", "operationId": "getTaskPage_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": "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" } } ], "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": [ "School - Task" ], "summary": "Create task", "operationId": "createTask_1", "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/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" } } ], "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" } } } } } }, "post": { "tags": [ "学校端 - 任务模板" ], "summary": "创建模板", "operationId": "createTemplate_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/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": "startDate", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "endDate", "in": "query", "required": false, "schema": { "type": "string" } }, { "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/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" } } } } } }, "post": { "tags": [ "学校端 - 排课管理" ], "summary": "创建排课", "operationId": "createSchedule_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/school/schedules/batch": { "post": { "tags": [ "学校端 - 排课管理" ], "summary": "批量创建排课", "operationId": "batchCreateSchedules", "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/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/{id}/renew": { "post": { "tags": [ "学校端 - 课程套餐" ], "summary": "续费套餐", "operationId": "renewPackage", "parameters": [ { "name": "id", "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": [ "Parent - Task" ], "summary": "Complete task", "operationId": "completeTask", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "studentId", "in": "query", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "content", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "attachments", "in": "query", "required": false, "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/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/parent/growth-records": { "post": { "tags": [ "Parent - Growth Record" ], "summary": "Create growth record", "operationId": "createGrowthRecord_2", "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/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", "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/ResultListTheme" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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/ResultTheme" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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/ResultPageResultResourceLibrary" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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/LibraryCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultResourceLibrary" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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/ResultPageResultResourceItem" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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/ItemCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultResourceItem" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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": "findAll_1", "parameters": [ { "name": "status", "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/ResultPageResultCoursePackageResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PackageCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultCoursePackage" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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": "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/packages/{id}/review": { "post": { "tags": [ "超管端 - 课程套餐" ], "summary": "审核套餐", "operationId": "review", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReviewRequest" } } }, "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": "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/packages/{id}/offline": { "post": { "tags": [ "超管端 - 课程套餐" ], "summary": "下线套餐", "operationId": "offline", "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}/grant": { "post": { "tags": [ "超管端 - 课程套餐" ], "summary": "授权套餐给租户", "operationId": "grantToTenant", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GrantRequest" } } }, "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": { "get": { "tags": [ "Admin - Course" ], "summary": "Get system course page", "operationId": "getCoursePage_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": "keyword", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "category", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultCourse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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": [ "Admin - Course" ], "summary": "Create system course", "operationId": "createCourse", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CourseCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultCourse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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/{id}/publish": { "post": { "tags": [ "Admin - Course" ], "summary": "Publish course", "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/courses/{id}/archive": { "post": { "tags": [ "Admin - Course" ], "summary": "Archive course", "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_2", "parameters": [ { "name": "courseId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListCourseLesson" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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", "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/ResultCourseLesson" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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/ResultListLessonStep" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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/StepCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultLessonStep" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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/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/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/students": { "get": { "tags": [ "Teacher - Course" ], "summary": "Get all students of teacher", "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/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/schedules/today": { "get": { "tags": [ "教师端 - 排课管理" ], "summary": "获取今日排课", "operationId": "getTodaySchedules", "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/schedules/timetable": { "get": { "tags": [ "教师端 - 排课管理" ], "summary": "获取教师课程表", "operationId": "getTimetable", "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/teacher/recommended-courses": { "get": { "tags": [ "教师端 - 统计数据" ], "summary": "获取推荐课程", "operationId": "getRecommendedCourses", "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultListCourse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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": [ "Teacher - Notification" ], "summary": "Get my notifications", "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": [ "Teacher - Notification" ], "summary": "Get notification by 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": [ "Teacher - Notification" ], "summary": "Get unread count", "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/today": { "get": { "tags": [ "Teacher - Lesson" ], "summary": "Get today's lessons", "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 } }, { "name": "type", "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/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": [ "Teacher - Course" ], "summary": "Get course page", "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": "category", "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": [ "Teacher - Course" ], "summary": "Get course by 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": [ "Teacher - Course" ], "summary": "Get all courses", "operationId": "getAllCourses", "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": [ "Teacher - Course" ], "summary": "Get teacher's classes", "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": [ "Teacher - Course" ], "summary": "Get teachers of class", "operationId": "getClassTeachers", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } } ], "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/{id}/students": { "get": { "tags": [ "Teacher - Course" ], "summary": "Get students of class", "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/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/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/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": { "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" } }, { "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/reports/teachers": { "get": { "tags": [ "学校端 - 数据报告" ], "summary": "获取教师报告", "operationId": "getTeacherReports", "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/reports/students": { "get": { "tags": [ "学校端 - 数据报告" ], "summary": "获取学生报告", "operationId": "getStudentReports", "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/reports/overview": { "get": { "tags": [ "学校端 - 数据报告" ], "summary": "获取报告概览", "operationId": "getOverview", "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/reports/courses": { "get": { "tags": [ "学校端 - 数据报告" ], "summary": "获取课程报告", "operationId": "getCourseReports", "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/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": "findTenantPackages", "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/package": { "get": { "tags": [ "学校端 - 课程套餐" ], "summary": "获取套餐信息", "operationId": "getPackageInfo", "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/packages/package/usage": { "get": { "tags": [ "学校端 - 课程套餐" ], "summary": "获取套餐使用情况", "operationId": "getPackageUsage", "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/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/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/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/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/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/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/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", "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/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/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/parent/tasks": { "get": { "tags": [ "Parent - Task" ], "summary": "Get my tasks", "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/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/parent/tasks/{id}": { "get": { "tags": [ "Parent - Task" ], "summary": "Get task by ID", "operationId": "getTask_2", "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": [ "Parent - Task" ], "summary": "Get tasks by student ID", "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/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/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" } } ], "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultPageResultNotificationResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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/ResultNotificationResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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/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/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" } } } } } } }, "/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/ResultListGrowthRecordResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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/ResultListStudentResponse" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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/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/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/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/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/stats/trend": { "get": { "tags": [ "超管 - 统计管理" ], "summary": "获取趋势数据", "operationId": "getTrendData", "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/stats/tenants/active": { "get": { "tags": [ "超管 - 统计管理" ], "summary": "获取活跃租户", "operationId": "getActiveTenants", "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/admin/stats/courses/popular": { "get": { "tags": [ "超管 - 统计管理" ], "summary": "获取热门课程", "operationId": "getPopularCourses", "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/admin/stats/activities": { "get": { "tags": [ "超管 - 统计管理" ], "summary": "获取最近活动", "operationId": "getRecentActivities_1", "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/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/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/ResultCourseLesson" } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "401": { "description": "Unauthorized", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ResultVoid" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/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": "任务类型" }, "startDate": { "type": "string", "description": "开始日期", "format": "date" }, "dueDate": { "type": "string", "description": "截止日期", "format": "date" }, "status": { "type": "string", "description": "状态" }, "attachments": { "type": "string", "description": "附件（JSON 数组）" } }, "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": "任务类型" }, "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": "附件" }, "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" } } } }, "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" }, "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" } } }, "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": "状态" } }, "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" }, "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": "性别" }, "bio": { "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": "教师响应" }, "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": "学生响应" }, "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" } } }, "ThemeCreateRequest": { "required": [ "name" ], "type": "object", "properties": { "name": { "type": "string", "description": "主题名称" }, "description": { "type": "string", "description": "主题描述" }, "sortOrder": { "type": "integer", "description": "排序号", "format": "int32" } }, "description": "创建主题请求" }, "ResultTheme": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/Theme" } } }, "Theme": { "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" }, "name": { "type": "string", "description": "主题名称" }, "description": { "type": "string", "description": "主题描述" }, "sortOrder": { "type": "integer", "description": "排序号", "format": "int32" }, "status": { "type": "string", "description": "状态：ACTIVE、INACTIVE" } }, "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": "状态" }, "packageType": { "type": "string", "description": "套餐类型" }, "teacherQuota": { "type": "integer", "description": "教师配额", "format": "int32" }, "studentQuota": { "type": "integer", "description": "学生配额", "format": "int32" }, "startDate": { "type": "string", "description": "开始日期", "format": "date" }, "expireDate": { "type": "string", "description": "结束日期", "format": "date" }, "expireAt": { "type": "string", "description": "过期时间（兼容旧字段）", "format": "date-time", "deprecated": true }, "maxStudents": { "type": "integer", "description": "最大学生数（兼容旧字段）", "format": "int32", "deprecated": true }, "maxTeachers": { "type": "integer", "description": "最大教师数（兼容旧字段）", "format": "int32", "deprecated": true } }, "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" }, "packageType": { "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": "租户响应" }, "LibraryUpdateRequest": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" } } }, "ResourceLibrary": { "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": "string", "description": "租户 ID" }, "name": { "type": "string", "description": "资源库名称" }, "description": { "type": "string", "description": "资源库描述" }, "libraryType": { "type": "string", "description": "资源库类型 (PICTURE_BOOK/MATERIAL/TEMPLATE)" }, "coverImage": { "type": "string", "description": "封面图片 URL" }, "createdBy": { "type": "integer", "description": "创建人 ID", "format": "int64" }, "status": { "type": "string", "description": "状态" }, "sortOrder": { "type": "integer", "description": "排序号", "format": "int32" } }, "description": "资源库实体" }, "ResultResourceLibrary": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/ResourceLibrary" } } }, "ItemUpdateRequest": { "type": "object", "properties": { "title": { "type": "string" }, "description": { "type": "string" }, "tags": { "type": "string" } } }, "ResourceItem": { "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" }, "libraryId": { "type": "string", "description": "资源库 ID" }, "tenantId": { "type": "string", "description": "租户 ID" }, "title": { "type": "string", "description": "资源标题" }, "description": { "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": "string", "description": "资源标签 (JSON 数组)" }, "sortOrder": { "type": "integer", "description": "排序号", "format": "int32" }, "type": { "type": "string", "description": "资源类型（保留字段，兼容旧数据）" }, "name": { "type": "string", "description": "资源名称（保留字段，兼容旧数据）" }, "code": { "type": "string", "description": "资源编码（保留字段，兼容旧数据）" }, "quantity": { "type": "integer", "description": "数量（保留字段，兼容旧数据）", "format": "int32" }, "availableQuantity": { "type": "integer", "description": "可用数量（保留字段，兼容旧数据）", "format": "int32" }, "location": { "type": "string", "description": "存放位置（保留字段，兼容旧数据）" }, "status": { "type": "string", "description": "状态" } }, "description": "资源项实体" }, "ResultResourceItem": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/ResourceItem" } } }, "PackageCreateRequest": { "required": [ "gradeLevels", "name", "price" ], "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": "适用年级" } } }, "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" }, "name": { "type": "string", "description": "套餐名称" }, "description": { "type": "string", "description": "套餐描述" }, "price": { "type": "integer", "description": "价格（分）", "format": "int64" }, "discountPrice": { "type": "integer", "description": "折后价格（分）", "format": "int64" }, "discountType": { "type": "string", "description": "折扣类型：PERCENTAGE、FIXED" }, "gradeLevels": { "type": "string", "description": "适用年级（JSON 数组）" }, "courseCount": { "type": "integer", "description": "课程数量", "format": "int32" }, "status": { "type": "string", "description": "状态：DRAFT、PENDING、APPROVED、REJECTED、PUBLISHED、OFFLINE" }, "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" } }, "description": "课程套餐实体" }, "ResultCoursePackage": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/CoursePackage" } } }, "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": "课程更新请求" }, "Course": { "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": "课程实体" }, "ResultCourse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/Course" } } }, "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": "创建课程环节请求" }, "CourseLesson": { "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" }, "courseId": { "type": "integer", "description": "课程 ID", "format": "int64" }, "lessonType": { "type": "string", "description": "课程类型：INTRODUCTION、LANGUAGE、SOCIETY、SCIENCE、ART、HEALTH" }, "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": "评测数据（JSON）" }, "useTemplate": { "type": "boolean", "description": "是否使用模板" }, "sortOrder": { "type": "integer", "description": "排序号", "format": "int32" } }, "description": "课程环节实体" }, "ResultCourseLesson": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/CourseLesson" } } }, "StepCreateRequest": { "type": "object", "properties": { "name": { "type": "string" }, "content": { "type": "string" }, "duration": { "type": "integer", "format": "int32" }, "objective": { "type": "string" }, "resourceIds": { "type": "array", "items": { "type": "integer", "format": "int64" } } } }, "LessonStep": { "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" }, "name": { "type": "string", "description": "环节名称" }, "content": { "type": "string", "description": "环节内容" }, "duration": { "type": "integer", "description": "时长（分钟）", "format": "int32" }, "objective": { "type": "string", "description": "教学目标" }, "resourceIds": { "type": "string", "description": "资源 ID 列表（JSON 数组）" }, "sortOrder": { "type": "integer", "description": "排序号", "format": "int32" } }, "description": "教学环节实体" }, "ResultLessonStep": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/LessonStep" } } }, "TaskCreateRequest": { "required": [ "title" ], "type": "object", "properties": { "title": { "type": "string", "description": "任务标题" }, "description": { "type": "string", "description": "描述" }, "type": { "type": "string", "description": "任务类型：reading-阅读，homework-作业，activity-活动" }, "courseId": { "type": "integer", "description": "课程 ID", "format": "int64" }, "startDate": { "type": "string", "description": "开始日期", "format": "date" }, "dueDate": { "type": "string", "description": "截止日期", "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": "任务创建请求" }, "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": "课时创建请求" }, "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", "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": "简介" } }, "description": "教师创建请求" }, "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": "学生创建请求" }, "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", "format": "date" }, "pricePaid": { "type": "integer", "format": "int64" } } }, "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": "班级创建请求" }, "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": "租户编码/登录账号" }, "contactName": { "type": "string", "description": "联系人" }, "contactPhone": { "type": "string", "description": "联系电话" }, "contactEmail": { "type": "string", "description": "联系邮箱" }, "address": { "type": "string", "description": "地址" }, "logoUrl": { "type": "string", "description": "Logo URL" }, "packageType": { "type": "string", "description": "套餐类型" }, "teacherQuota": { "type": "integer", "description": "教师配额", "format": "int32" }, "studentQuota": { "type": "integer", "description": "学生配额", "format": "int32" }, "startDate": { "type": "string", "description": "开始日期", "format": "date" }, "expireDate": { "type": "string", "description": "结束日期", "format": "date" }, "expireAt": { "type": "string", "description": "过期时间（兼容旧字段）", "format": "date-time", "deprecated": true }, "maxStudents": { "type": "integer", "description": "最大学生数（兼容旧字段）", "format": "int32", "deprecated": true }, "maxTeachers": { "type": "integer", "description": "最大教师数（兼容旧字段）", "format": "int32", "deprecated": true } }, "description": "租户创建请求" }, "LibraryCreateRequest": { "type": "object", "properties": { "name": { "type": "string" }, "type": { "type": "string" }, "description": { "type": "string" }, "tenantId": { "type": "string" } } }, "ItemCreateRequest": { "type": "object", "properties": { "libraryId": { "type": "string" }, "title": { "type": "string" }, "fileType": { "type": "string" }, "filePath": { "type": "string" }, "fileSize": { "type": "integer", "format": "int64" }, "description": { "type": "string" }, "tags": { "type": "string" }, "tenantId": { "type": "string" } } }, "ReviewRequest": { "type": "object", "properties": { "approved": { "type": "boolean" }, "comment": { "type": "string" } } }, "GrantRequest": { "type": "object", "properties": { "tenantId": { "type": "integer", "format": "int64" }, "endDate": { "type": "string" }, "pricePaid": { "type": "integer", "format": "int64" } } }, "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": "课程创建请求" }, "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" }, "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": "课程实体" }, "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" } } }, "ResultListMapStringObject": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "ResultListCourse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Course" } } } }, "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" } } }, "ResultListLessonResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/LessonResponse" } } } }, "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" } } }, "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" }, "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": "string", "description": "年级标签" }, "domainTags": { "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" } } }, "description": "课程响应" }, "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" } } }, "ResultCourseResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/CourseResponse" } } }, "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" } } } }, "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" } } }, "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" } } }, "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" } } } }, "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" } }, "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" } }, "description": "课程套餐响应" }, "ResultListCoursePackageResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/CoursePackageResponse" } } } }, "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" } } }, "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" } } } }, "NotificationResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64" }, "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" }, "createdAt": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "通知响应" }, "PageResultNotificationResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/NotificationResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultNotificationResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultNotificationResponse" } } }, "ResultNotificationResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/NotificationResponse" } } }, "ResultListGrowthRecordResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/GrowthRecordResponse" } } } }, "ResultListStudentResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/StudentResponse" } } } }, "ResultObject": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "object" } } }, "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": "用户信息响应" }, "ResultListTheme": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Theme" } } } }, "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" } } } }, "PageResultResourceLibrary": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/ResourceLibrary" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultResourceLibrary": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultResourceLibrary" } } }, "PageResultResourceItem": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/ResourceItem" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultResourceItem": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultResourceItem" } } }, "PageResultCoursePackageResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/CoursePackageResponse" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultCoursePackageResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultCoursePackageResponse" } } }, "ResultCoursePackageResponse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/CoursePackageResponse" } } }, "PageResultCourse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/Course" } }, "total": { "type": "integer", "format": "int64" }, "pageNum": { "type": "integer", "format": "int64" }, "pageSize": { "type": "integer", "format": "int64" }, "pages": { "type": "integer", "format": "int64" } } }, "ResultPageResultCourse": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/PageResultCourse" } } }, "ResultListCourseLesson": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/CourseLesson" } } } }, "ResultListLessonStep": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/LessonStep" } } } } }, "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": [] } }