From 32d2364c7777c8c856566bc55ff97bb10891cd3f Mon Sep 17 00:00:00 2001 From: En Date: Fri, 6 Mar 2026 12:23:10 +0800 Subject: [PATCH] =?UTF-8?q?refactor(i18n):=20=E5=85=A8=E9=9D=A2=E7=BF=BB?= =?UTF-8?q?=E8=AF=91Swagger=E6=B3=A8=E8=A7=A3=E5=92=8C=E5=AE=9E=E4=BD=93?= =?UTF-8?q?=E6=B3=A8=E9=87=8A=E4=B8=BA=E4=B8=AD=E6=96=87?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 翻译41个控制器的所有@Tag和@Operation注解为中文 - Admin系列控制器：9个 - School系列控制器：13个 - Teacher系列控制器：9个 - Parent系列控制器：4个 - AuthController和FileUploadController：2个 - 翻译41个实体类的类注释为中文 - 管理员/教师/学生/家长/租户等核心实体 - 课程/课时/任务/成长档案等业务实体 - 各类关系映射实体 - 翻译21个DTO的@Schema注解为中文 - Request DTOs: 19个(创建/更新请求) - Response DTOs: 4个(登录/用户信息/课程/租户响应) - 新增CLAUDE.md项目文档 所有翻译确保符合上下文语义，保持代码功能不变。 Co-Authored-By: Claude Opus 4.6 --- CLAUDE.md | 144 ++++++++++++++++++ .../platform/controller/AuthController.java | 10 +- .../controller/FileUploadController.java | 6 +- .../admin/AdminCourseController.java | 32 ++-- .../admin/AdminCourseLessonController.java | 12 +- .../admin/AdminCoursePackageController.java | 20 +-- .../admin/AdminOperationLogController.java | 4 +- .../admin/AdminResourceController.java | 18 +-- .../admin/AdminSettingsController.java | 6 +- .../admin/AdminStatsController.java | 12 +- .../admin/AdminTenantController.java | 20 +-- .../admin/AdminThemeController.java | 12 +- .../parent/ParentChildController.java | 6 +- .../parent/ParentGrowthController.java | 12 +- .../parent/ParentNotificationController.java | 12 +- .../parent/ParentTaskController.java | 8 +- .../school/SchoolClassController.java | 12 +- .../school/SchoolCourseController.java | 12 +- .../school/SchoolCoursePackageController.java | 6 +- .../school/SchoolExportController.java | 10 +- .../school/SchoolGrowthController.java | 12 +- .../school/SchoolOperationLogController.java | 4 +- .../school/SchoolParentController.java | 16 +- .../school/SchoolScheduleController.java | 18 +-- .../school/SchoolSettingsController.java | 2 +- .../school/SchoolStatsController.java | 4 +- .../school/SchoolStudentController.java | 12 +- .../school/SchoolTaskController.java | 12 +- .../school/SchoolTeacherController.java | 14 +- .../teacher/TeacherCourseController.java | 8 +- .../TeacherCourseLessonController.java | 6 +- .../teacher/TeacherDashboardController.java | 8 +- .../teacher/TeacherGrowthController.java | 12 +- .../teacher/TeacherLessonController.java | 16 +- .../TeacherNotificationController.java | 12 +- .../teacher/TeacherScheduleController.java | 6 +- .../TeacherSchoolCourseController.java | 6 +- .../teacher/TeacherTaskController.java | 12 +- .../dto/request/ClassCreateRequest.java | 12 +- .../dto/request/ClassUpdateRequest.java | 12 +- .../dto/request/CourseCreateRequest.java | 100 ++++++------ .../dto/request/CourseUpdateRequest.java | 100 ++++++------ .../request/GrowthRecordCreateRequest.java | 2 +- .../request/GrowthRecordUpdateRequest.java | 14 +- .../dto/request/LessonCreateRequest.java | 28 ++-- .../dto/request/LessonUpdateRequest.java | 2 +- .../platform/dto/request/LoginRequest.java | 12 +- .../dto/request/ParentCreateRequest.java | 18 +-- .../dto/request/ParentUpdateRequest.java | 14 +- .../dto/request/StudentCreateRequest.java | 2 +- .../dto/request/StudentUpdateRequest.java | 22 +-- .../dto/request/TaskCreateRequest.java | 22 +-- .../dto/request/TaskUpdateRequest.java | 16 +- .../dto/request/TeacherCreateRequest.java | 22 +-- .../dto/request/TeacherUpdateRequest.java | 16 +- .../dto/request/TenantCreateRequest.java | 30 ++-- .../dto/request/TenantUpdateRequest.java | 24 +-- .../platform/dto/response/CourseResponse.java | 144 +++++++++--------- .../platform/dto/response/LoginResponse.java | 14 +- .../platform/dto/response/TenantResponse.java | 26 ++-- .../dto/response/UserInfoResponse.java | 18 +-- .../reading/platform/entity/AdminUser.java | 2 +- .../reading/platform/entity/ClassTeacher.java | 2 +- .../com/reading/platform/entity/Clazz.java | 2 +- .../com/reading/platform/entity/Course.java | 32 ++-- .../platform/entity/CourseActivity.java | 2 +- .../reading/platform/entity/CourseLesson.java | 2 +- .../platform/entity/CoursePackage.java | 2 +- .../platform/entity/CourseResource.java | 2 +- .../reading/platform/entity/CourseScript.java | 2 +- .../platform/entity/CourseScriptPage.java | 2 +- .../platform/entity/CourseVersion.java | 2 +- .../reading/platform/entity/GrowthRecord.java | 2 +- .../com/reading/platform/entity/Lesson.java | 2 +- .../platform/entity/LessonFeedback.java | 2 +- .../reading/platform/entity/Notification.java | 2 +- .../reading/platform/entity/OperationLog.java | 2 +- .../com/reading/platform/entity/Parent.java | 2 +- .../platform/entity/ParentStudent.java | 2 +- .../reading/platform/entity/ResourceItem.java | 2 +- .../platform/entity/ResourceLibrary.java | 2 +- .../reading/platform/entity/SchedulePlan.java | 2 +- .../platform/entity/ScheduleTemplate.java | 2 +- .../reading/platform/entity/SchoolCourse.java | 2 +- .../com/reading/platform/entity/Student.java | 2 +- .../platform/entity/StudentClassHistory.java | 2 +- .../platform/entity/StudentRecord.java | 2 +- .../platform/entity/SystemSetting.java | 2 +- .../java/com/reading/platform/entity/Tag.java | 2 +- .../com/reading/platform/entity/Task.java | 2 +- .../platform/entity/TaskCompletion.java | 2 +- .../reading/platform/entity/TaskTarget.java | 2 +- .../reading/platform/entity/TaskTemplate.java | 2 +- .../com/reading/platform/entity/Teacher.java | 2 +- .../com/reading/platform/entity/Tenant.java | 2 +- .../reading/platform/entity/TenantCourse.java | 2 +- .../com/reading/platform/entity/Theme.java | 2 +- 97 files changed, 735 insertions(+), 591 deletions(-) create mode 100644 CLAUDE.md diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..83431ee --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,144 @@ +# CLAUDE.md + +This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. + +## Project Overview + +This is a **Kindergarten Course Management System** (少儿智慧阅读平台) with a Spring Boot backend and Vue 3 frontend. The system manages courses, lessons, tasks, and student growth records for kindergartens. + +## Architecture + +### Backend (`reading-platform-java`) +- **Framework**: Spring Boot 3.2.3 + Java 17 +- **Persistence**: MyBatis-Plus 3.5.5 +- **Security**: Spring Security + JWT +- **API Docs**: Knife4j (Swagger OpenAPI 3) +- **Database**: MySQL 8.0 +- **Migration**: Flyway + +### Frontend (`reading-platform-frontend`) +- **Framework**: Vue 3 + TypeScript + Vite +- **UI**: Ant Design Vue +- **State**: Pinia +- **API**: Axios with auto-generated TypeScript clients via Orval + +## Multi-Tenant Architecture + +The system supports multiple kindergartens (tenants): +- `admin` role: Super admin (no tenant, manages system-wide courses) +- `school` role: School administrator (manages school's teachers, students, classes) +- `teacher` role: Teacher (manages lessons, tasks for their tenant) +- `parent` role: Parent (views child's progress and tasks) + +Each entity (except `admin_users`) has a `tenant_id` field. System courses have `tenant_id = NULL`. + +## Project Structure + +``` +kindergarten_java/ +├── reading-platform-java/ # Spring Boot backend +│ ├── src/main/java/.../controller/ +│ │ ├── admin/ # Super admin endpoints (/api/v1/admin/*) +│ │ ├── school/ # School admin endpoints (/api/v1/school/*) +│ │ ├── teacher/ # Teacher endpoints (/api/v1/teacher/*) +│ │ └── parent/ # Parent endpoints (/api/v1/parent/*) +│ ├── entity/ # Database entities (27 tables) +│ ├── mapper/ # MyBatis-Plus mappers +│ ├── service/ # Service layer interface + impl +│ ├── common/ +│ │ ├── annotation/RequireRole # Role-based access control +│ │ ├── security/ # JWT authentication +│ │ ├── enums/ # UserRole, CourseStatus, etc. +│ │ ├── response/ # Result, PageResult +│ │ └── config/ # Security, MyBatis, OpenAPI configs +│ └── resources/ +│ ├── db/migration/ # Flyway migration scripts +│ └── mapper/ # MyBatis XML files +│ +├── reading-platform-frontend/ # Vue 3 frontend +│ ├── src/views/ +│ │ ├── admin/ # Super admin pages +│ │ ├── school/ # School admin pages +│ │ ├── teacher/ # Teacher pages +│ │ └── parent/ # Parent pages +│ ├── api/generated/ # Auto-generated API clients +│ ├── api-spec.yml # OpenAPI specification +│ └── router/index.ts # Vue Router config +│ +├── docker-compose.yml # Backend + Frontend services +└── docs/开发协作指南.md # Development guide (Chinese) +``` + +## Key Patterns + +### 1. Role-Based Access Control +Use `@RequireRole` annotation on controllers/services: +```java +@RequireRole(UserRole.SCHOOL) // Only school admins can access +``` + +### 2. Tenant Isolation +Use `SecurityUtils.getCurrentTenantId()` in school/teacher/parent endpoints to filter data by current tenant. + +### 3. Unified Response Format +```java +Result success(T data) // { code: 200, message: "success", data: ... } +Result error(code, msg) // { code: xxx, message: "...", data: null } +``` + +### 4. OpenAPI-Driven Development +- Backend: Annotate controllers with `@Operation`, `@Parameter`, `@Schema` +- Frontend: Run `npm run api:update` to regenerate TypeScript clients from `api-spec.yml` + +## Development Commands + +### Backend +```bash +# Run with Docker Compose (recommended) +docker compose up --build + +# Run locally (requires MySQL running) +cd reading-platform-java +mvn spring-boot:run + +# Build +mvn clean package -DskipTests +``` + +### Frontend +```bash +cd reading-platform-frontend +npm install +npm run dev +npm run build + +# Update API clients from backend spec +npm run api:update +``` + +### Database Migration +- Add new migration scripts to `reading-platform-java/src/main/resources/db/migration/V{n}__description.sql` +- Flyway runs automatically on backend startup (dev mode only) + +## Database Schema (27 Tables) +- **Tenant**: tenants, tenant_courses +- **Users**: admin_users, teachers, students, parents, parent_students +- **Class**: classes, class_teachers, student_class_history +- **Course**: courses, course_versions, course_resources, course_scripts, course_script_pages, course_activities +- **Lesson**: lessons, lesson_feedbacks, student_records +- **Task**: tasks, task_targets, task_completions, task_templates +- **Growth**: growth_records +- **Resource**: resource_libraries, resource_items +- **Schedule**: schedule_plans, schedule_templates +- **System**: system_settings, notifications, operation_logs, tags + +## Test Accounts +| Role | Username | Password | +|------|----------|----------| +| Admin | admin | admin123 | +| School | school | 123456 | +| Teacher | teacher1 | 123456 | +| Parent | parent1 | 123456 | + +## API Documentation +- Access: http://localhost:8080/doc.html (after backend starts) diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/AuthController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/AuthController.java index 72158c9..0e3bd01 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/AuthController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/AuthController.java @@ -11,7 +11,7 @@ import jakarta.validation.Valid; import lombok.RequiredArgsConstructor; import org.springframework.web.bind.annotation.*; -@Tag(name = "Auth", description = "Authentication APIs") +@Tag(name = "认证", description = "认证相关接口") @RestController @RequestMapping("/api/v1/auth") @RequiredArgsConstructor @@ -19,26 +19,26 @@ public class AuthController { private final AuthService authService; - @Operation(summary = "User login") + @Operation(summary = "用户登录") @PostMapping("/login") public Result login(@Valid @RequestBody LoginRequest request) { return Result.success(authService.login(request)); } - @Operation(summary = "User logout") + @Operation(summary = "用户登出") @PostMapping("/logout") public Result logout() { // JWT is stateless - client simply discards the token return Result.success(); } - @Operation(summary = "Get current user info") + @Operation(summary = "获取当前用户信息") @GetMapping("/me") public Result getCurrentUser() { return Result.success(authService.getCurrentUserInfo()); } - @Operation(summary = "Change password") + @Operation(summary = "修改密码") @PostMapping("/change-password") public Result changePassword( @RequestParam String oldPassword, diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/FileUploadController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/FileUploadController.java index e57617c..9e0256c 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/FileUploadController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/FileUploadController.java @@ -11,7 +11,7 @@ import org.springframework.web.multipart.MultipartFile; import java.util.HashMap; import java.util.Map; -@Tag(name = "File Upload", description = "File Upload APIs") +@Tag(name = "文件上传", description = "文件上传接口") @RestController @RequestMapping("/api/v1/files") @RequiredArgsConstructor @@ -19,7 +19,7 @@ public class FileUploadController { private final FileUploadService fileUploadService; - @Operation(summary = "Upload file") + @Operation(summary = "上传文件") @PostMapping("/upload") public Result> uploadFile(@RequestParam("file") MultipartFile file) { String url = fileUploadService.uploadFile(file); @@ -29,7 +29,7 @@ public class FileUploadController { return Result.success(result); } - @Operation(summary = "Delete file") + @Operation(summary = "删除文件") @DeleteMapping("/delete") public Result deleteFile(@RequestParam("filePath") String filePath) { fileUploadService.deleteFile(filePath); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminCourseController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminCourseController.java index 84e99b4..9daba15 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminCourseController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminCourseController.java @@ -15,7 +15,7 @@ import jakarta.validation.Valid; import lombok.RequiredArgsConstructor; import org.springframework.web.bind.annotation.*; -@Tag(name = "Admin - Course", description = "System Course Management APIs for Admin") +@Tag(name = "管理员 - 课程", description = "系统课程管理接口（管理员专用）") @RestController @RequestMapping("/api/v1/admin/courses") @RequiredArgsConstructor @@ -24,26 +24,26 @@ public class AdminCourseController { private final CourseService courseService; - @Operation(summary = "Create system course") + @Operation(summary = "创建系统课程") @PostMapping public Result createCourse(@Valid @RequestBody CourseCreateRequest request) { // System courses have null tenantId; service sets isSystem=1 when tenantId is null return Result.success(courseService.createCourse(null, request)); } - @Operation(summary = "Update course") + @Operation(summary = "更新课程") @PutMapping("/{id}") public Result updateCourse(@PathVariable Long id, @RequestBody CourseUpdateRequest request) { return Result.success(courseService.updateCourse(id, request)); } - @Operation(summary = "Get course by ID") + @Operation(summary = "根据ID获取课程") @GetMapping("/{id}") public Result getCourse(@PathVariable Long id) { return Result.success(courseService.getCourseById(id)); } - @Operation(summary = "Get system course page (all statuses)") + @Operation(summary = "获取系统课程分页（所有状态）") @GetMapping public Result> getCoursePage( @RequestParam(value = "page", required = false) Integer pageNum, @@ -55,7 +55,7 @@ public class AdminCourseController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Get courses pending review") + @Operation(summary = "获取待审核课程") @GetMapping("/review") public Result> getReviewCoursePage( @RequestParam(value = "page", required = false) Integer pageNum, @@ -64,28 +64,28 @@ public class AdminCourseController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Delete course") + @Operation(summary = "删除课程") @DeleteMapping("/{id}") public Result deleteCourse(@PathVariable Long id) { courseService.deleteCourse(id); return Result.success(); } - @Operation(summary = "Submit course for review") + @Operation(summary = "提交课程审核") @PostMapping("/{id}/submit") public Result submitCourse(@PathVariable Long id) { courseService.submitCourse(id); return Result.success(); } - @Operation(summary = "Withdraw course from review") + @Operation(summary = "撤销课程审核") @PostMapping("/{id}/withdraw") public Result withdrawCourse(@PathVariable Long id) { courseService.withdrawCourse(id); return Result.success(); } - @Operation(summary = "Approve course") + @Operation(summary = "审批课程") @PostMapping("/{id}/approve") public Result approveCourse( @PathVariable Long id, @@ -94,7 +94,7 @@ public class AdminCourseController { return Result.success(); } - @Operation(summary = "Reject course") + @Operation(summary = "驳回课程") @PostMapping("/{id}/reject") public Result rejectCourse( @PathVariable Long id, @@ -103,35 +103,35 @@ public class AdminCourseController { return Result.success(); } - @Operation(summary = "Publish course") + @Operation(summary = "发布课程") @PostMapping("/{id}/publish") public Result publishCourse(@PathVariable Long id) { courseService.publishCourse(id); return Result.success(); } - @Operation(summary = "Direct publish course (skip review)") + @Operation(summary = "直接发布课程（跳过审核）") @PostMapping("/{id}/direct-publish") public Result directPublishCourse(@PathVariable Long id) { courseService.publishCourse(id); return Result.success(); } - @Operation(summary = "Unpublish (archive) course") + @Operation(summary = "取消发布（归档）课程") @PostMapping("/{id}/unpublish") public Result unpublishCourse(@PathVariable Long id) { courseService.archiveCourse(id); return Result.success(); } - @Operation(summary = "Republish course") + @Operation(summary = "重新发布课程") @PostMapping("/{id}/republish") public Result republishCourse(@PathVariable Long id) { courseService.publishCourse(id); return Result.success(); } - @Operation(summary = "Archive course") + @Operation(summary = "归档课程") @PostMapping("/{id}/archive") public Result archiveCourse(@PathVariable Long id) { courseService.archiveCourse(id); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminCourseLessonController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminCourseLessonController.java index 94bb64c..ed085d2 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminCourseLessonController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminCourseLessonController.java @@ -12,7 +12,7 @@ import org.springframework.web.bind.annotation.*; import java.util.List; -@Tag(name = "Admin - Course Lessons", description = "Course Lesson Management for Admin") +@Tag(name = "管理员 - 课程课时", description = "课程课时管理接口（管理员专用）") @RestController @RequestMapping("/api/v1/admin/courses/{courseId}/lessons") @RequiredArgsConstructor @@ -21,32 +21,32 @@ public class AdminCourseLessonController { private final CourseLessonService courseLessonService; - @Operation(summary = "Get lessons for a course") + @Operation(summary = "获取课程的课时列表") @GetMapping public Result> getLessons(@PathVariable Long courseId) { return Result.success(courseLessonService.getLessonsByCourse(courseId)); } - @Operation(summary = "Get lesson by ID") + @Operation(summary = "根据ID获取课时") @GetMapping("/{id}") public Result getLesson(@PathVariable Long courseId, @PathVariable Long id) { return Result.success(courseLessonService.getLessonById(id)); } - @Operation(summary = "Create course lesson") + @Operation(summary = "创建课程课时") @PostMapping public Result createLesson(@PathVariable Long courseId, @RequestBody CourseLesson lesson) { lesson.setCourseId(courseId); return Result.success(courseLessonService.createLesson(lesson)); } - @Operation(summary = "Update course lesson") + @Operation(summary = "更新课程课时") @PutMapping("/{id}") public Result updateLesson(@PathVariable Long courseId, @PathVariable Long id, @RequestBody CourseLesson lesson) { return Result.success(courseLessonService.updateLesson(id, lesson)); } - @Operation(summary = "Delete course lesson") + @Operation(summary = "删除课程课时") @DeleteMapping("/{id}") public Result deleteLesson(@PathVariable Long courseId, @PathVariable Long id) { courseLessonService.deleteLesson(id); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminCoursePackageController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminCoursePackageController.java index 4c30d41..aef3347 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminCoursePackageController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminCoursePackageController.java @@ -12,7 +12,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; import lombok.RequiredArgsConstructor; import org.springframework.web.bind.annotation.*; -@Tag(name = "Admin - Course Packages", description = "Course Package Management for Admin") +@Tag(name = "管理员 - 课程包", description = "课程包管理接口（管理员专用）") @RestController @RequestMapping("/api/v1/admin/packages") @RequiredArgsConstructor @@ -21,7 +21,7 @@ public class AdminCoursePackageController { private final CoursePackageService coursePackageService; - @Operation(summary = "Get course packages") + @Operation(summary = "获取课程包列表") @GetMapping public Result> getPackages( @RequestParam(value = "page", defaultValue = "1") int page, @@ -32,39 +32,39 @@ public class AdminCoursePackageController { return Result.success(PageResult.of(result)); } - @Operation(summary = "Get course package by ID") + @Operation(summary = "根据ID获取课程包") @GetMapping("/{id}") public Result getPackage(@PathVariable Long id) { return Result.success(coursePackageService.getPackageById(id)); } - @Operation(summary = "Create course package") + @Operation(summary = "创建课程包") @PostMapping public Result createPackage(@RequestBody CoursePackage pkg) { return Result.success(coursePackageService.createPackage(pkg)); } - @Operation(summary = "Update course package") + @Operation(summary = "更新课程包") @PutMapping("/{id}") public Result updatePackage(@PathVariable Long id, @RequestBody CoursePackage pkg) { return Result.success(coursePackageService.updatePackage(id, pkg)); } - @Operation(summary = "Delete course package") + @Operation(summary = "删除课程包") @DeleteMapping("/{id}") public Result deletePackage(@PathVariable Long id) { coursePackageService.deletePackage(id); return Result.success(); } - @Operation(summary = "Submit package for review") + @Operation(summary = "提交课程包审核") @PostMapping("/{id}/submit") public Result submitPackage(@PathVariable Long id) { coursePackageService.submitPackage(id); return Result.success(); } - @Operation(summary = "Review package (approve or reject)") + @Operation(summary = "审核课程包（通过或拒绝）") @PostMapping("/{id}/review") public Result reviewPackage( @PathVariable Long id, @@ -75,14 +75,14 @@ public class AdminCoursePackageController { return Result.success(); } - @Operation(summary = "Publish package") + @Operation(summary = "发布课程包") @PostMapping("/{id}/publish") public Result publishPackage(@PathVariable Long id) { coursePackageService.publishPackage(id); return Result.success(); } - @Operation(summary = "Take package offline") + @Operation(summary = "下架课程包") @PostMapping("/{id}/offline") public Result offlinePackage(@PathVariable Long id) { coursePackageService.offlinePackage(id); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminOperationLogController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminOperationLogController.java index 0131daf..806b5dd 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminOperationLogController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminOperationLogController.java @@ -12,7 +12,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; import lombok.RequiredArgsConstructor; import org.springframework.web.bind.annotation.*; -@Tag(name = "Admin - Operation Logs", description = "Operation Log Management for Admin") +@Tag(name = "管理员 - 操作日志", description = "操作日志管理接口（管理员专用）") @RestController @RequestMapping("/api/v1/admin/operation-logs") @RequiredArgsConstructor @@ -21,7 +21,7 @@ public class AdminOperationLogController { private final OperationLogService operationLogService; - @Operation(summary = "Get operation logs") + @Operation(summary = "获取操作日志") @GetMapping public Result> getLogs( @RequestParam(defaultValue = "1") int pageNum, diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminResourceController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminResourceController.java index 529ca53..47d508c 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminResourceController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminResourceController.java @@ -15,7 +15,7 @@ import org.springframework.web.bind.annotation.*; import java.util.List; -@Tag(name = "Admin - Resources", description = "Resource Library Management for Admin") +@Tag(name = "管理员 - 资源", description = "资源库管理接口（管理员专用）") @RestController @RequestMapping("/api/v1/admin/resources") @RequiredArgsConstructor @@ -24,32 +24,32 @@ public class AdminResourceController { private final ResourceService resourceService; - @Operation(summary = "Get all resource libraries") + @Operation(summary = "获取所有资源库") @GetMapping("/libraries") public Result> getLibraries(@RequestParam(required = false) Long tenantId) { return Result.success(resourceService.getLibraries(tenantId)); } - @Operation(summary = "Create resource library") + @Operation(summary = "创建资源库") @PostMapping("/libraries") public Result createLibrary(@RequestBody ResourceLibrary library) { return Result.success(resourceService.createLibrary(library)); } - @Operation(summary = "Update resource library") + @Operation(summary = "更新资源库") @PutMapping("/libraries/{id}") public Result updateLibrary(@PathVariable Long id, @RequestBody ResourceLibrary library) { return Result.success(resourceService.updateLibrary(id, library)); } - @Operation(summary = "Delete resource library") + @Operation(summary = "删除资源库") @DeleteMapping("/libraries/{id}") public Result deleteLibrary(@PathVariable Long id) { resourceService.deleteLibrary(id); return Result.success(); } - @Operation(summary = "Get resource items") + @Operation(summary = "获取资源项") @GetMapping("/items") public Result> getItems( @RequestParam(defaultValue = "1") int pageNum, @@ -60,19 +60,19 @@ public class AdminResourceController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Create resource item") + @Operation(summary = "创建资源项") @PostMapping("/items") public Result createItem(@RequestBody ResourceItem item) { return Result.success(resourceService.createItem(item)); } - @Operation(summary = "Update resource item") + @Operation(summary = "更新资源项") @PutMapping("/items/{id}") public Result updateItem(@PathVariable Long id, @RequestBody ResourceItem item) { return Result.success(resourceService.updateItem(id, item)); } - @Operation(summary = "Delete resource item") + @Operation(summary = "删除资源项") @DeleteMapping("/items/{id}") public Result deleteItem(@PathVariable Long id) { resourceService.deleteItem(id); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminSettingsController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminSettingsController.java index 55f2ff9..d56c203 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminSettingsController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminSettingsController.java @@ -11,7 +11,7 @@ import org.springframework.web.bind.annotation.*; import java.util.Map; -@Tag(name = "Admin - Settings", description = "Admin System Settings Management") +@Tag(name = "管理员 - 设置", description = "管理员系统设置管理") @RestController @RequestMapping("/api/v1/admin/settings") @RequiredArgsConstructor @@ -23,13 +23,13 @@ public class AdminSettingsController { private final SystemSettingService systemSettingService; - @Operation(summary = "Get admin system settings") + @Operation(summary = "获取管理员系统设置") @GetMapping public Result> getSettings() { return Result.success(systemSettingService.getSettings(ADMIN_TENANT_ID)); } - @Operation(summary = "Update admin system settings") + @Operation(summary = "更新管理员系统设置") @PutMapping public Result updateSettings(@RequestBody Map settings) { Map stringSettings = new java.util.HashMap<>(); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminStatsController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminStatsController.java index e9e8014..ede4206 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminStatsController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminStatsController.java @@ -12,7 +12,7 @@ import org.springframework.web.bind.annotation.*; import java.util.List; import java.util.Map; -@Tag(name = "Admin - Stats", description = "Admin Statistics Dashboard") +@Tag(name = "管理员 - 统计", description = "管理员统计仪表盘") @RestController @RequestMapping("/api/v1/admin/stats") @RequiredArgsConstructor @@ -21,33 +21,33 @@ public class AdminStatsController { private final AdminStatsService adminStatsService; - @Operation(summary = "Get overall statistics") + @Operation(summary = "获取整体统计数据") @GetMapping public Result> getStats() { return Result.success(adminStatsService.getStats()); } - @Operation(summary = "Get trend data (last 6 months)") + @Operation(summary = "获取趋势数据（近6个月）") @GetMapping("/trend") public Result>> getTrendData() { return Result.success(adminStatsService.getTrendData()); } - @Operation(summary = "Get active tenants") + @Operation(summary = "获取活跃租户") @GetMapping("/tenants/active") public Result>> getActiveTenants( @RequestParam(defaultValue = "10") int limit) { return Result.success(adminStatsService.getActiveTenants(limit)); } - @Operation(summary = "Get popular courses") + @Operation(summary = "获取热门课程") @GetMapping("/courses/popular") public Result>> getPopularCourses( @RequestParam(defaultValue = "10") int limit) { return Result.success(adminStatsService.getPopularCourses(limit)); } - @Operation(summary = "Get recent activities") + @Operation(summary = "获取最近活动") @GetMapping("/activities") public Result>> getActivities( @RequestParam(defaultValue = "10") int limit) { diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminTenantController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminTenantController.java index e97e1c0..0904051 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminTenantController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminTenantController.java @@ -20,7 +20,7 @@ import java.util.HashMap; import java.util.List; import java.util.Map; -@Tag(name = "Admin - Tenant", description = "Tenant Management APIs for Admin") +@Tag(name = "管理员 - 租户", description = "租户管理接口（管理员专用）") @RestController @RequestMapping("/api/v1/admin/tenants") @RequiredArgsConstructor @@ -29,25 +29,25 @@ public class AdminTenantController { private final TenantService tenantService; - @Operation(summary = "Create tenant") + @Operation(summary = "创建租户") @PostMapping public Result createTenant(@Valid @RequestBody TenantCreateRequest request) { return Result.success(tenantService.createTenant(request)); } - @Operation(summary = "Update tenant") + @Operation(summary = "更新租户") @PutMapping("/{id}") public Result updateTenant(@PathVariable Long id, @RequestBody TenantUpdateRequest request) { return Result.success(tenantService.updateTenant(id, request)); } - @Operation(summary = "Get tenant by ID") + @Operation(summary = "根据ID获取租户") @GetMapping("/{id}") public Result getTenant(@PathVariable Long id) { return Result.success(tenantService.getTenantById(id)); } - @Operation(summary = "Get tenant page") + @Operation(summary = "获取租户分页") @GetMapping public Result> getTenantPage( @RequestParam(value = "page", required = false) Integer pageNum, @@ -59,20 +59,20 @@ public class AdminTenantController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Delete tenant") + @Operation(summary = "删除租户") @DeleteMapping("/{id}") public Result deleteTenant(@PathVariable Long id) { tenantService.deleteTenant(id); return Result.success(); } - @Operation(summary = "Get all active tenants") + @Operation(summary = "获取所有活跃租户") @GetMapping("/active") public Result> getAllActiveTenants() { return Result.success(tenantService.getAllActiveTenants()); } - @Operation(summary = "Update tenant status") + @Operation(summary = "更新租户状态") @PutMapping("/{id}/status") public Result> updateTenantStatus(@PathVariable Long id, @RequestBody Map body) { String status = body.get("status"); @@ -88,7 +88,7 @@ public class AdminTenantController { return Result.success(result); } - @Operation(summary = "Reset tenant school account password") + @Operation(summary = "重置租户学校账号密码") @PostMapping("/{id}/reset-password") public Result> resetTenantPassword(@PathVariable Long id) { String tempPassword = tenantService.resetSchoolAccountPassword(id); @@ -97,7 +97,7 @@ public class AdminTenantController { return Result.success(result); } - @Operation(summary = "Update tenant quota") + @Operation(summary = "更新租户配额") @PutMapping("/{id}/quota") public Result updateTenantQuota(@PathVariable Long id, @RequestBody Map body) { TenantUpdateRequest req = new TenantUpdateRequest(); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminThemeController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminThemeController.java index cd446c3..46c4adf 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminThemeController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/admin/AdminThemeController.java @@ -12,7 +12,7 @@ import org.springframework.web.bind.annotation.*; import java.util.List; -@Tag(name = "Admin - Themes", description = "Theme Management for Admin") +@Tag(name = "管理员 - 主题", description = "主题管理接口（管理员专用）") @RestController @RequestMapping("/api/v1/admin/themes") @RequiredArgsConstructor @@ -21,31 +21,31 @@ public class AdminThemeController { private final ThemeService themeService; - @Operation(summary = "Get all themes") + @Operation(summary = "获取所有主题") @GetMapping public Result> getThemes(@RequestParam(required = false) Boolean enabledOnly) { return Result.success(themeService.getAllThemes(enabledOnly)); } - @Operation(summary = "Get theme by ID") + @Operation(summary = "根据ID获取主题") @GetMapping("/{id}") public Result getTheme(@PathVariable Long id) { return Result.success(themeService.getThemeById(id)); } - @Operation(summary = "Create theme") + @Operation(summary = "创建主题") @PostMapping public Result createTheme(@RequestBody Theme theme) { return Result.success(themeService.createTheme(theme)); } - @Operation(summary = "Update theme") + @Operation(summary = "更新主题") @PutMapping("/{id}") public Result updateTheme(@PathVariable Long id, @RequestBody Theme theme) { return Result.success(themeService.updateTheme(id, theme)); } - @Operation(summary = "Delete theme") + @Operation(summary = "删除主题") @DeleteMapping("/{id}") public Result deleteTheme(@PathVariable Long id) { themeService.deleteTheme(id); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/parent/ParentChildController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/parent/ParentChildController.java index f2ee0f8..3dd0e0c 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/parent/ParentChildController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/parent/ParentChildController.java @@ -11,7 +11,7 @@ import org.springframework.web.bind.annotation.*; import java.util.List; -@Tag(name = "Parent - Child", description = "Child Information APIs for Parent") +@Tag(name = "家长 - 孩子", description = "孩子信息接口（家长专用）") @RestController @RequestMapping("/api/v1/parent/children") @RequiredArgsConstructor @@ -19,14 +19,14 @@ public class ParentChildController { private final StudentService studentService; - @Operation(summary = "Get my children") + @Operation(summary = "获取我的孩子") @GetMapping public Result> getMyChildren() { Long parentId = SecurityUtils.getCurrentUserId(); return Result.success(studentService.getStudentsByParentId(parentId)); } - @Operation(summary = "Get child by ID") + @Operation(summary = "根据ID获取孩子") @GetMapping("/{id}") public Result getChild(@PathVariable Long id) { return Result.success(studentService.getStudentById(id)); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/parent/ParentGrowthController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/parent/ParentGrowthController.java index 2592a71..b334b6a 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/parent/ParentGrowthController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/parent/ParentGrowthController.java @@ -24,7 +24,7 @@ public class ParentGrowthController { private final GrowthRecordService growthRecordService; - @Operation(summary = "Create growth record") + @Operation(summary = "创建成长档案") @PostMapping public Result createGrowthRecord(@Valid @RequestBody GrowthRecordCreateRequest request) { Long tenantId = SecurityUtils.getCurrentTenantId(); @@ -32,19 +32,19 @@ public class ParentGrowthController { return Result.success(growthRecordService.createGrowthRecord(tenantId, userId, "parent", request)); } - @Operation(summary = "Update growth record") + @Operation(summary = "更新成长档案") @PutMapping("/{id}") public Result updateGrowthRecord(@PathVariable Long id, @RequestBody GrowthRecordUpdateRequest request) { return Result.success(growthRecordService.updateGrowthRecord(id, request)); } - @Operation(summary = "Get growth record by ID") + @Operation(summary = "根据ID获取成长档案") @GetMapping("/{id}") public Result getGrowthRecord(@PathVariable Long id) { return Result.success(growthRecordService.getGrowthRecordById(id)); } - @Operation(summary = "Get growth records by student ID") + @Operation(summary = "根据学生ID获取成长档案") @GetMapping("/student/{studentId}") public Result> getGrowthRecordsByStudent( @PathVariable Long studentId, @@ -55,7 +55,7 @@ public class ParentGrowthController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Get recent growth records") + @Operation(summary = "获取最近成长档案") @GetMapping("/student/{studentId}/recent") public Result> getRecentGrowthRecords( @PathVariable Long studentId, @@ -63,7 +63,7 @@ public class ParentGrowthController { return Result.success(growthRecordService.getRecentGrowthRecords(studentId, limit)); } - @Operation(summary = "Delete growth record") + @Operation(summary = "删除成长档案") @DeleteMapping("/{id}") public Result deleteGrowthRecord(@PathVariable Long id) { growthRecordService.deleteGrowthRecord(id); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/parent/ParentNotificationController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/parent/ParentNotificationController.java index 7eacace..b7b3d13 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/parent/ParentNotificationController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/parent/ParentNotificationController.java @@ -11,7 +11,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; import lombok.RequiredArgsConstructor; import org.springframework.web.bind.annotation.*; -@Tag(name = "Parent - Notification", description = "Notification APIs for Parent") +@Tag(name = "家长 - 通知", description = "通知接口（家长专用）") @RestController @RequestMapping("/api/v1/parent/notifications") @RequiredArgsConstructor @@ -19,13 +19,13 @@ public class ParentNotificationController { private final NotificationService notificationService; - @Operation(summary = "Get notification by ID") + @Operation(summary = "根据ID获取通知") @GetMapping("/{id}") public Result getNotification(@PathVariable Long id) { return Result.success(notificationService.getNotificationById(id)); } - @Operation(summary = "Get my notifications") + @Operation(summary = "获取我的通知") @GetMapping public Result> getMyNotifications( @RequestParam(value = "page", required = false) Integer pageNum, @@ -36,14 +36,14 @@ public class ParentNotificationController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Mark notification as read") + @Operation(summary = "标记通知为已读") @PostMapping("/{id}/read") public Result markAsRead(@PathVariable Long id) { notificationService.markAsRead(id); return Result.success(); } - @Operation(summary = "Mark all notifications as read") + @Operation(summary = "标记所有通知为已读") @PostMapping("/read-all") public Result markAllAsRead() { Long userId = SecurityUtils.getCurrentUserId(); @@ -51,7 +51,7 @@ public class ParentNotificationController { return Result.success(); } - @Operation(summary = "Get unread count") + @Operation(summary = "获取未读通知数量") @GetMapping("/unread-count") public Result getUnreadCount() { Long userId = SecurityUtils.getCurrentUserId(); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/parent/ParentTaskController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/parent/ParentTaskController.java index 5821017..7547649 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/parent/ParentTaskController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/parent/ParentTaskController.java @@ -11,7 +11,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; import lombok.RequiredArgsConstructor; import org.springframework.web.bind.annotation.*; -@Tag(name = "Parent - Task", description = "Task APIs for Parent") +@Tag(name = "家长 - 任务", description = "任务接口（家长专用）") @RestController @RequestMapping("/api/v1/parent/tasks") @RequiredArgsConstructor @@ -19,13 +19,13 @@ public class ParentTaskController { private final TaskService taskService; - @Operation(summary = "Get task by ID") + @Operation(summary = "根据ID获取任务") @GetMapping("/{id}") public Result getTask(@PathVariable Long id) { return Result.success(taskService.getTaskById(id)); } - @Operation(summary = "Get tasks by student ID") + @Operation(summary = "根据学生ID获取任务") @GetMapping("/student/{studentId}") public Result> getTasksByStudent( @PathVariable Long studentId, @@ -36,7 +36,7 @@ public class ParentTaskController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Complete task") + @Operation(summary = "完成任务") @PostMapping("/{taskId}/complete") public Result completeTask( @PathVariable Long taskId, diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolClassController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolClassController.java index bc398f5..e2f8271 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolClassController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolClassController.java @@ -16,7 +16,7 @@ import org.springframework.web.bind.annotation.*; import java.util.List; -@Tag(name = "School - Class", description = "Class Management APIs for School") +@Tag(name = "学校 - 班级", description = "班级管理接口（学校管理员专用）") @RestController @RequestMapping("/api/v1/school/classes") @RequiredArgsConstructor @@ -24,14 +24,14 @@ public class SchoolClassController { private final ClassService classService; - @Operation(summary = "Create class") + @Operation(summary = "创建班级") @PostMapping public Result createClass(@Valid @RequestBody ClassCreateRequest request) { Long tenantId = SecurityUtils.getCurrentTenantId(); return Result.success(classService.createClass(tenantId, request)); } - @Operation(summary = "Update class") + @Operation(summary = "更新班级") @PutMapping("/{id}") public Result updateClass(@PathVariable Long id, @RequestBody ClassUpdateRequest request) { return Result.success(classService.updateClass(id, request)); @@ -56,21 +56,21 @@ public class SchoolClassController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Delete class") + @Operation(summary = "删除班级") @DeleteMapping("/{id}") public Result deleteClass(@PathVariable Long id) { classService.deleteClass(id); return Result.success(); } - @Operation(summary = "Assign teachers to class") + @Operation(summary = "分配教师到班级") @PostMapping("/{id}/teachers") public Result assignTeachers(@PathVariable Long id, @RequestBody List teacherIds) { classService.assignTeachers(id, teacherIds); return Result.success(); } - @Operation(summary = "Assign students to class") + @Operation(summary = "分配学生到班级") @PostMapping("/{id}/students") public Result assignStudents(@PathVariable Long id, @RequestBody List studentIds) { classService.assignStudents(id, studentIds); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolCourseController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolCourseController.java index 18cec05..8588392 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolCourseController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolCourseController.java @@ -13,7 +13,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; import lombok.RequiredArgsConstructor; import org.springframework.web.bind.annotation.*; -@Tag(name = "School - School Courses", description = "School Custom Course Management") +@Tag(name = "学校 - 校本课程", description = "校本课程管理接口（学校管理员专用）") @RestController @RequestMapping("/api/v1/school/school-courses") @RequiredArgsConstructor @@ -22,7 +22,7 @@ public class SchoolCourseController { private final SchoolCourseService schoolCourseService; - @Operation(summary = "Get school courses") + @Operation(summary = "获取校本课程") @GetMapping public Result> getCourses( @RequestParam(defaultValue = "1") int pageNum, @@ -33,13 +33,13 @@ public class SchoolCourseController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Get school course by ID") + @Operation(summary = "根据ID获取校本课程") @GetMapping("/{id}") public Result getCourse(@PathVariable Long id) { return Result.success(schoolCourseService.getCourseById(id)); } - @Operation(summary = "Create school course") + @Operation(summary = "创建校本课程") @PostMapping public Result createCourse(@RequestBody SchoolCourse course) { Long tenantId = SecurityUtils.getCurrentTenantId(); @@ -47,13 +47,13 @@ public class SchoolCourseController { return Result.success(schoolCourseService.createCourse(tenantId, userId, course)); } - @Operation(summary = "Update school course") + @Operation(summary = "更新校本课程") @PutMapping("/{id}") public Result updateCourse(@PathVariable Long id, @RequestBody SchoolCourse course) { return Result.success(schoolCourseService.updateCourse(id, course)); } - @Operation(summary = "Delete school course") + @Operation(summary = "删除校本课程") @DeleteMapping("/{id}") public Result deleteCourse(@PathVariable Long id) { schoolCourseService.deleteCourse(id); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolCoursePackageController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolCoursePackageController.java index 0ebf67f..9095447 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolCoursePackageController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolCoursePackageController.java @@ -12,7 +12,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; import lombok.RequiredArgsConstructor; import org.springframework.web.bind.annotation.*; -@Tag(name = "School - Course Packages", description = "Course Packages for School") +@Tag(name = "学校 - 课程包", description = "课程包接口（学校管理员专用）") @RestController @RequestMapping("/api/v1/school/course-packages") @RequiredArgsConstructor @@ -21,7 +21,7 @@ public class SchoolCoursePackageController { private final CoursePackageService coursePackageService; - @Operation(summary = "Get available course packages") + @Operation(summary = "获取可用课程包列表") @GetMapping public Result> getPackages( @RequestParam(defaultValue = "1") int pageNum, @@ -31,7 +31,7 @@ public class SchoolCoursePackageController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Get course package by ID") + @Operation(summary = "根据ID获取课程包") @GetMapping("/{id}") public Result getPackage(@PathVariable Long id) { return Result.success(coursePackageService.getPackageById(id)); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolExportController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolExportController.java index 5b46f01..260553f 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolExportController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolExportController.java @@ -15,7 +15,7 @@ import org.springframework.web.bind.annotation.*; import java.io.IOException; import java.time.LocalDate; -@Tag(name = "School - Export", description = "School Data Export") +@Tag(name = "学校 - 导出", description = "学校数据导出接口（学校管理员专用）") @RestController @RequestMapping("/api/v1/school/export") @RequiredArgsConstructor @@ -24,7 +24,7 @@ public class SchoolExportController { private final ExportService exportService; - @Operation(summary = "Export teachers to Excel") + @Operation(summary = "导出教师信息到Excel") @GetMapping("/teachers") public ResponseEntity exportTeachers() throws IOException { Long tenantId = SecurityUtils.getCurrentTenantId(); @@ -32,7 +32,7 @@ public class SchoolExportController { return buildResponse(data, "teachers_" + LocalDate.now() + ".xlsx"); } - @Operation(summary = "Export students to Excel") + @Operation(summary = "导出学生信息到Excel") @GetMapping("/students") public ResponseEntity exportStudents() throws IOException { Long tenantId = SecurityUtils.getCurrentTenantId(); @@ -40,7 +40,7 @@ public class SchoolExportController { return buildResponse(data, "students_" + LocalDate.now() + ".xlsx"); } - @Operation(summary = "Export lessons to Excel") + @Operation(summary = "导出课时信息到Excel") @GetMapping("/lessons") public ResponseEntity exportLessons() throws IOException { Long tenantId = SecurityUtils.getCurrentTenantId(); @@ -48,7 +48,7 @@ public class SchoolExportController { return buildResponse(data, "lessons_" + LocalDate.now() + ".xlsx"); } - @Operation(summary = "Export growth records to Excel") + @Operation(summary = "导出成长档案到Excel") @GetMapping("/growth-records") public ResponseEntity exportGrowthRecords() throws IOException { Long tenantId = SecurityUtils.getCurrentTenantId(); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolGrowthController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolGrowthController.java index c3b7f9c..757466c 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolGrowthController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolGrowthController.java @@ -14,7 +14,7 @@ import jakarta.validation.Valid; import lombok.RequiredArgsConstructor; import org.springframework.web.bind.annotation.*; -@Tag(name = "School - Growth Record", description = "Growth Record Management APIs for School") +@Tag(name = "学校 - 成长档案", description = "成长档案管理接口（学校管理员专用）") @RestController @RequestMapping("/api/v1/school/growth-records") @RequiredArgsConstructor @@ -22,7 +22,7 @@ public class SchoolGrowthController { private final GrowthRecordService growthRecordService; - @Operation(summary = "Create growth record") + @Operation(summary = "创建成长档案") @PostMapping public Result createGrowthRecord(@Valid @RequestBody GrowthRecordCreateRequest request) { Long tenantId = SecurityUtils.getCurrentTenantId(); @@ -31,19 +31,19 @@ public class SchoolGrowthController { return Result.success(growthRecordService.createGrowthRecord(tenantId, userId, role, request)); } - @Operation(summary = "Update growth record") + @Operation(summary = "更新成长档案") @PutMapping("/{id}") public Result updateGrowthRecord(@PathVariable Long id, @RequestBody GrowthRecordUpdateRequest request) { return Result.success(growthRecordService.updateGrowthRecord(id, request)); } - @Operation(summary = "Get growth record by ID") + @Operation(summary = "根据ID获取成长档案") @GetMapping("/{id}") public Result getGrowthRecord(@PathVariable Long id) { return Result.success(growthRecordService.getGrowthRecordById(id)); } - @Operation(summary = "Get growth record page") + @Operation(summary = "获取成长档案分页") @GetMapping public Result> getGrowthRecordPage( @RequestParam(value = "page", required = false) Integer pageNum, @@ -55,7 +55,7 @@ public class SchoolGrowthController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Delete growth record") + @Operation(summary = "删除成长档案") @DeleteMapping("/{id}") public Result deleteGrowthRecord(@PathVariable Long id) { growthRecordService.deleteGrowthRecord(id); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolOperationLogController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolOperationLogController.java index 23a1573..e08592d 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolOperationLogController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolOperationLogController.java @@ -13,7 +13,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; import lombok.RequiredArgsConstructor; import org.springframework.web.bind.annotation.*; -@Tag(name = "School - Operation Logs", description = "Operation Log for School") +@Tag(name = "学校 - 操作日志", description = "操作日志接口（学校管理员专用）") @RestController @RequestMapping("/api/v1/school/operation-logs") @RequiredArgsConstructor @@ -22,7 +22,7 @@ public class SchoolOperationLogController { private final OperationLogService operationLogService; - @Operation(summary = "Get school operation logs") + @Operation(summary = "获取学校操作日志") @GetMapping public Result> getLogs( @RequestParam(defaultValue = "1") int pageNum, diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolParentController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolParentController.java index 552c899..297455d 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolParentController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolParentController.java @@ -14,7 +14,7 @@ import jakarta.validation.Valid; import lombok.RequiredArgsConstructor; import org.springframework.web.bind.annotation.*; -@Tag(name = "School - Parent", description = "Parent Management APIs for School") +@Tag(name = "学校 - 家长", description = "家长管理接口（学校管理员专用）") @RestController @RequestMapping("/api/v1/school/parents") @RequiredArgsConstructor @@ -22,14 +22,14 @@ public class SchoolParentController { private final ParentService parentService; - @Operation(summary = "Create parent") + @Operation(summary = "创建家长") @PostMapping public Result createParent(@Valid @RequestBody ParentCreateRequest request) { Long tenantId = SecurityUtils.getCurrentTenantId(); return Result.success(parentService.createParent(tenantId, request)); } - @Operation(summary = "Update parent") + @Operation(summary = "更新家长") @PutMapping("/{id}") public Result updateParent(@PathVariable Long id, @RequestBody ParentUpdateRequest request) { return Result.success(parentService.updateParent(id, request)); @@ -41,7 +41,7 @@ public class SchoolParentController { return Result.success(parentService.getParentById(id)); } - @Operation(summary = "Get parent page") + @Operation(summary = "获取家长分页") @GetMapping public Result> getParentPage( @RequestParam(value = "page", required = false) Integer pageNum, @@ -53,21 +53,21 @@ public class SchoolParentController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Delete parent") + @Operation(summary = "删除家长") @DeleteMapping("/{id}") public Result deleteParent(@PathVariable Long id) { parentService.deleteParent(id); return Result.success(); } - @Operation(summary = "Reset parent password") + @Operation(summary = "重置家长密码") @PostMapping("/{id}/reset-password") public Result resetPassword(@PathVariable Long id, @RequestParam String newPassword) { parentService.resetPassword(id, newPassword); return Result.success(); } - @Operation(summary = "Bind student to parent") + @Operation(summary = "绑定学生到家长") @PostMapping("/{parentId}/students/{studentId}") public Result bindStudent( @PathVariable Long parentId, @@ -78,7 +78,7 @@ public class SchoolParentController { return Result.success(); } - @Operation(summary = "Unbind student from parent") + @Operation(summary = "解绑家长与学生关系") @DeleteMapping("/{parentId}/students/{studentId}") public Result unbindStudent(@PathVariable Long parentId, @PathVariable Long studentId) { parentService.unbindStudent(parentId, studentId); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolScheduleController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolScheduleController.java index 892affd..b8956c2 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolScheduleController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolScheduleController.java @@ -14,7 +14,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; import lombok.RequiredArgsConstructor; import org.springframework.web.bind.annotation.*; -@Tag(name = "School - Schedule", description = "School Schedule Management") +@Tag(name = "学校 - 课表", description = "课表管理接口（学校管理员专用）") @RestController @RequestMapping("/api/v1/school/schedules") @RequiredArgsConstructor @@ -23,7 +23,7 @@ public class SchoolScheduleController { private final ScheduleService scheduleService; - @Operation(summary = "Get schedule plans") + @Operation(summary = "获取课表计划") @GetMapping public Result> getSchedulePlans( @RequestParam(defaultValue = "1") int pageNum, @@ -34,33 +34,33 @@ public class SchoolScheduleController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Get schedule plan by ID") + @Operation(summary = "根据ID获取课表计划") @GetMapping("/{id}") public Result getSchedulePlan(@PathVariable Long id) { return Result.success(scheduleService.getSchedulePlanById(id)); } - @Operation(summary = "Create schedule plan") + @Operation(summary = "创建课表计划") @PostMapping public Result createSchedulePlan(@RequestBody SchedulePlan plan) { Long tenantId = SecurityUtils.getCurrentTenantId(); return Result.success(scheduleService.createSchedulePlan(tenantId, plan)); } - @Operation(summary = "Update schedule plan") + @Operation(summary = "更新课表计划") @PutMapping("/{id}") public Result updateSchedulePlan(@PathVariable Long id, @RequestBody SchedulePlan plan) { return Result.success(scheduleService.updateSchedulePlan(id, plan)); } - @Operation(summary = "Delete schedule plan") + @Operation(summary = "删除课表计划") @DeleteMapping("/{id}") public Result deleteSchedulePlan(@PathVariable Long id) { scheduleService.deleteSchedulePlan(id); return Result.success(); } - @Operation(summary = "Get schedule templates") + @Operation(summary = "获取课表模板") @GetMapping("/templates") public Result> getScheduleTemplates( @RequestParam(defaultValue = "1") int pageNum, @@ -70,14 +70,14 @@ public class SchoolScheduleController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Create schedule template") + @Operation(summary = "创建课表模板") @PostMapping("/templates") public Result createScheduleTemplate(@RequestBody ScheduleTemplate template) { Long tenantId = SecurityUtils.getCurrentTenantId(); return Result.success(scheduleService.createScheduleTemplate(tenantId, template)); } - @Operation(summary = "Delete schedule template") + @Operation(summary = "删除课表模板") @DeleteMapping("/templates/{id}") public Result deleteScheduleTemplate(@PathVariable Long id) { scheduleService.deleteScheduleTemplate(id); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolSettingsController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolSettingsController.java index 3cce3cc..6140fb9 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolSettingsController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolSettingsController.java @@ -12,7 +12,7 @@ import org.springframework.web.bind.annotation.*; import java.util.Map; -@Tag(name = "School - Settings", description = "School Settings Management") +@Tag(name = "学校 - 设置", description = "学校设置管理接口（学校管理员专用）") @RestController @RequestMapping("/api/v1/school/settings") @RequiredArgsConstructor diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolStatsController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolStatsController.java index aa1d414..a3e5f69 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolStatsController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolStatsController.java @@ -12,7 +12,7 @@ import org.springframework.web.bind.annotation.*; import java.util.Map; -@Tag(name = "School - Stats", description = "School Statistics Dashboard") +@Tag(name = "学校 - 统计", description = "学校统计仪表盘接口（学校管理员专用）") @RestController @RequestMapping("/api/v1/school/stats") @RequiredArgsConstructor @@ -21,7 +21,7 @@ public class SchoolStatsController { private final SchoolStatsService schoolStatsService; - @Operation(summary = "Get school statistics") + @Operation(summary = "获取学校统计数据") @GetMapping public Result> getStats() { Long tenantId = SecurityUtils.getCurrentTenantId(); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolStudentController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolStudentController.java index b4a33a7..217e327 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolStudentController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolStudentController.java @@ -14,7 +14,7 @@ import jakarta.validation.Valid; import lombok.RequiredArgsConstructor; import org.springframework.web.bind.annotation.*; -@Tag(name = "School - Student", description = "Student Management APIs for School") +@Tag(name = "学校 - 学生", description = "学生管理接口（学校管理员专用）") @RestController @RequestMapping("/api/v1/school/students") @RequiredArgsConstructor @@ -22,26 +22,26 @@ public class SchoolStudentController { private final StudentService studentService; - @Operation(summary = "Create student") + @Operation(summary = "创建学生") @PostMapping public Result createStudent(@Valid @RequestBody StudentCreateRequest request) { Long tenantId = SecurityUtils.getCurrentTenantId(); return Result.success(studentService.createStudent(tenantId, request)); } - @Operation(summary = "Update student") + @Operation(summary = "更新学生") @PutMapping("/{id}") public Result updateStudent(@PathVariable Long id, @RequestBody StudentUpdateRequest request) { return Result.success(studentService.updateStudent(id, request)); } - @Operation(summary = "Get student by ID") + @Operation(summary = "根据ID获取学生") @GetMapping("/{id}") public Result getStudent(@PathVariable Long id) { return Result.success(studentService.getStudentById(id)); } - @Operation(summary = "Get student page") + @Operation(summary = "获取学生分页") @GetMapping public Result> getStudentPage( @RequestParam(value = "page", required = false) Integer pageNum, @@ -54,7 +54,7 @@ public class SchoolStudentController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Delete student") + @Operation(summary = "删除学生") @DeleteMapping("/{id}") public Result deleteStudent(@PathVariable Long id) { studentService.deleteStudent(id); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolTaskController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolTaskController.java index 13fe2bf..62b15d7 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolTaskController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolTaskController.java @@ -14,7 +14,7 @@ import jakarta.validation.Valid; import lombok.RequiredArgsConstructor; import org.springframework.web.bind.annotation.*; -@Tag(name = "School - Task", description = "Task Management APIs for School") +@Tag(name = "学校 - 任务", description = "任务管理接口（学校管理员专用）") @RestController @RequestMapping("/api/v1/school/tasks") @RequiredArgsConstructor @@ -22,7 +22,7 @@ public class SchoolTaskController { private final TaskService taskService; - @Operation(summary = "Create task") + @Operation(summary = "创建任务") @PostMapping public Result createTask(@Valid @RequestBody TaskCreateRequest request) { Long tenantId = SecurityUtils.getCurrentTenantId(); @@ -31,19 +31,19 @@ public class SchoolTaskController { return Result.success(taskService.createTask(tenantId, userId, role, request)); } - @Operation(summary = "Update task") + @Operation(summary = "更新任务") @PutMapping("/{id}") public Result updateTask(@PathVariable Long id, @RequestBody TaskUpdateRequest request) { return Result.success(taskService.updateTask(id, request)); } - @Operation(summary = "Get task by ID") + @Operation(summary = "根据ID获取任务") @GetMapping("/{id}") public Result getTask(@PathVariable Long id) { return Result.success(taskService.getTaskById(id)); } - @Operation(summary = "Get task page") + @Operation(summary = "获取任务分页") @GetMapping public Result> getTaskPage( @RequestParam(value = "page", required = false) Integer pageNum, @@ -56,7 +56,7 @@ public class SchoolTaskController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Delete task") + @Operation(summary = "删除任务") @DeleteMapping("/{id}") public Result deleteTask(@PathVariable Long id) { taskService.deleteTask(id); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolTeacherController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolTeacherController.java index 0f20407..9244573 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolTeacherController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolTeacherController.java @@ -14,7 +14,7 @@ import jakarta.validation.Valid; import lombok.RequiredArgsConstructor; import org.springframework.web.bind.annotation.*; -@Tag(name = "School - Teacher", description = "Teacher Management APIs for School") +@Tag(name = "学校 - 教师", description = "教师管理接口（学校管理员专用）") @RestController @RequestMapping("/api/v1/school/teachers") @RequiredArgsConstructor @@ -22,26 +22,26 @@ public class SchoolTeacherController { private final TeacherService teacherService; - @Operation(summary = "Create teacher") + @Operation(summary = "创建教师") @PostMapping public Result createTeacher(@Valid @RequestBody TeacherCreateRequest request) { Long tenantId = SecurityUtils.getCurrentTenantId(); return Result.success(teacherService.createTeacher(tenantId, request)); } - @Operation(summary = "Update teacher") + @Operation(summary = "更新教师") @PutMapping("/{id}") public Result updateTeacher(@PathVariable Long id, @RequestBody TeacherUpdateRequest request) { return Result.success(teacherService.updateTeacher(id, request)); } - @Operation(summary = "Get teacher by ID") + @Operation(summary = "根据ID获取教师") @GetMapping("/{id}") public Result getTeacher(@PathVariable Long id) { return Result.success(teacherService.getTeacherById(id)); } - @Operation(summary = "Get teacher page") + @Operation(summary = "获取教师分页") @GetMapping public Result> getTeacherPage( @RequestParam(value = "page", required = false) Integer pageNum, @@ -53,14 +53,14 @@ public class SchoolTeacherController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Delete teacher") + @Operation(summary = "删除教师") @DeleteMapping("/{id}") public Result deleteTeacher(@PathVariable Long id) { teacherService.deleteTeacher(id); return Result.success(); } - @Operation(summary = "Reset teacher password") + @Operation(summary = "重置教师密码") @PostMapping("/{id}/reset-password") public Result resetPassword(@PathVariable Long id, @RequestParam String newPassword) { teacherService.resetPassword(id, newPassword); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherCourseController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherCourseController.java index ac06236..463f68c 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherCourseController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherCourseController.java @@ -13,7 +13,7 @@ import org.springframework.web.bind.annotation.*; import java.util.List; -@Tag(name = "Teacher - Course", description = "Course APIs for Teacher") +@Tag(name = "教师 - 课程", description = "课程接口（教师专用）") @RestController @RequestMapping("/api/v1/teacher/courses") @RequiredArgsConstructor @@ -21,13 +21,13 @@ public class TeacherCourseController { private final CourseService courseService; - @Operation(summary = "Get course by ID") + @Operation(summary = "根据ID获取课程") @GetMapping("/{id}") public Result getCourse(@PathVariable Long id) { return Result.success(courseService.getCourseById(id)); } - @Operation(summary = "Get course page") + @Operation(summary = "获取课程分页") @GetMapping public Result> getCoursePage( @RequestParam(value = "page", required = false) Integer pageNum, @@ -39,7 +39,7 @@ public class TeacherCourseController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Get all courses") + @Operation(summary = "获取所有课程") @GetMapping("/all") public Result> getAllCourses() { Long tenantId = SecurityUtils.getCurrentTenantId(); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherCourseLessonController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherCourseLessonController.java index 9ac6a60..15b2249 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherCourseLessonController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherCourseLessonController.java @@ -12,7 +12,7 @@ import org.springframework.web.bind.annotation.*; import java.util.List; -@Tag(name = "Teacher - Course Lessons", description = "Course Lessons for Teacher") +@Tag(name = "教师 - 课程课时", description = "课程课时接口（教师专用）") @RestController @RequestMapping("/api/v1/teacher/courses/{courseId}/lessons") @RequiredArgsConstructor @@ -21,13 +21,13 @@ public class TeacherCourseLessonController { private final CourseLessonService courseLessonService; - @Operation(summary = "Get lessons for a course") + @Operation(summary = "获取课程的课时列表") @GetMapping public Result> getLessons(@PathVariable Long courseId) { return Result.success(courseLessonService.getLessonsByCourse(courseId)); } - @Operation(summary = "Get lesson by ID") + @Operation(summary = "根据ID获取课时") @GetMapping("/{id}") public Result getLesson(@PathVariable Long courseId, @PathVariable Long id) { return Result.success(courseLessonService.getLessonById(id)); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherDashboardController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherDashboardController.java index cdad03e..3205ba3 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherDashboardController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherDashboardController.java @@ -13,7 +13,7 @@ import org.springframework.web.bind.annotation.*; import java.util.List; import java.util.Map; -@Tag(name = "Teacher - Dashboard", description = "Teacher Dashboard") +@Tag(name = "教师 - 仪表盘", description = "教师仪表盘") @RestController @RequestMapping("/api/v1/teacher/dashboard") @RequiredArgsConstructor @@ -22,7 +22,7 @@ public class TeacherDashboardController { private final TeacherDashboardService teacherDashboardService; - @Operation(summary = "Get teacher dashboard overview") + @Operation(summary = "获取教师仪表盘概览") @GetMapping public Result> getDashboard() { Long teacherId = SecurityUtils.getCurrentUserId(); @@ -30,7 +30,7 @@ public class TeacherDashboardController { return Result.success(teacherDashboardService.getDashboard(teacherId, tenantId)); } - @Operation(summary = "Get today's lessons") + @Operation(summary = "获取今天课时") @GetMapping("/today") public Result>> getTodayLessons() { Long teacherId = SecurityUtils.getCurrentUserId(); @@ -38,7 +38,7 @@ public class TeacherDashboardController { return Result.success(teacherDashboardService.getTodayLessons(teacherId, tenantId)); } - @Operation(summary = "Get weekly lessons") + @Operation(summary = "获取本周课时") @GetMapping("/weekly") public Result>> getWeeklyLessons() { Long teacherId = SecurityUtils.getCurrentUserId(); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherGrowthController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherGrowthController.java index 3ded03d..526b5aa 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherGrowthController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherGrowthController.java @@ -14,7 +14,7 @@ import jakarta.validation.Valid; import lombok.RequiredArgsConstructor; import org.springframework.web.bind.annotation.*; -@Tag(name = "Teacher - Growth Record", description = "Growth Record APIs for Teacher") +@Tag(name = "教师 - 成长档案", description = "成长档案接口（教师专用）") @RestController @RequestMapping("/api/v1/teacher/growth-records") @RequiredArgsConstructor @@ -22,7 +22,7 @@ public class TeacherGrowthController { private final GrowthRecordService growthRecordService; - @Operation(summary = "Create growth record") + @Operation(summary = "创建成长档案") @PostMapping public Result createGrowthRecord(@Valid @RequestBody GrowthRecordCreateRequest request) { Long tenantId = SecurityUtils.getCurrentTenantId(); @@ -30,19 +30,19 @@ public class TeacherGrowthController { return Result.success(growthRecordService.createGrowthRecord(tenantId, userId, "teacher", request)); } - @Operation(summary = "Update growth record") + @Operation(summary = "更新成长档案") @PutMapping("/{id}") public Result updateGrowthRecord(@PathVariable Long id, @RequestBody GrowthRecordUpdateRequest request) { return Result.success(growthRecordService.updateGrowthRecord(id, request)); } - @Operation(summary = "Get growth record by ID") + @Operation(summary = "根据ID获取成长档案") @GetMapping("/{id}") public Result getGrowthRecord(@PathVariable Long id) { return Result.success(growthRecordService.getGrowthRecordById(id)); } - @Operation(summary = "Get growth record page") + @Operation(summary = "获取成长档案分页") @GetMapping public Result> getGrowthRecordPage( @RequestParam(value = "page", required = false) Integer pageNum, @@ -54,7 +54,7 @@ public class TeacherGrowthController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Delete growth record") + @Operation(summary = "删除成长档案") @DeleteMapping("/{id}") public Result deleteGrowthRecord(@PathVariable Long id) { growthRecordService.deleteGrowthRecord(id); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherLessonController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherLessonController.java index 33a2cdf..bcd6238 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherLessonController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherLessonController.java @@ -18,7 +18,7 @@ import org.springframework.web.bind.annotation.*; import java.time.LocalDate; import java.util.List; -@Tag(name = "Teacher - Lesson", description = "Lesson APIs for Teacher") +@Tag(name = "教师 - 课时", description = "课时接口（教师专用）") @RestController @RequestMapping("/api/v1/teacher/lessons") @RequiredArgsConstructor @@ -26,26 +26,26 @@ public class TeacherLessonController { private final LessonService lessonService; - @Operation(summary = "Create lesson") + @Operation(summary = "创建课时") @PostMapping public Result createLesson(@Valid @RequestBody LessonCreateRequest request) { Long tenantId = SecurityUtils.getCurrentTenantId(); return Result.success(lessonService.createLesson(tenantId, request)); } - @Operation(summary = "Update lesson") + @Operation(summary = "更新课时") @PutMapping("/{id}") public Result updateLesson(@PathVariable Long id, @RequestBody LessonUpdateRequest request) { return Result.success(lessonService.updateLesson(id, request)); } - @Operation(summary = "Get lesson by ID") + @Operation(summary = "根据ID获取课时") @GetMapping("/{id}") public Result getLesson(@PathVariable Long id) { return Result.success(lessonService.getLessonById(id)); } - @Operation(summary = "Get my lessons") + @Operation(summary = "获取我的课时") @GetMapping public Result> getMyLessons( @RequestParam(value = "page", required = false) Integer pageNum, @@ -58,7 +58,7 @@ public class TeacherLessonController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Start lesson") + @Operation(summary = "开始课时") @PostMapping("/{id}/start") public Result startLesson(@PathVariable Long id) { lessonService.startLesson(id); @@ -72,14 +72,14 @@ public class TeacherLessonController { return Result.success(); } - @Operation(summary = "Cancel lesson") + @Operation(summary = "取消课时") @PostMapping("/{id}/cancel") public Result cancelLesson(@PathVariable Long id) { lessonService.cancelLesson(id); return Result.success(); } - @Operation(summary = "Get today's lessons") + @Operation(summary = "获取今天课时") @GetMapping("/today") public Result> getTodayLessons() { Long tenantId = SecurityUtils.getCurrentTenantId(); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherNotificationController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherNotificationController.java index e218879..ed39041 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherNotificationController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherNotificationController.java @@ -11,7 +11,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; import lombok.RequiredArgsConstructor; import org.springframework.web.bind.annotation.*; -@Tag(name = "Teacher - Notification", description = "Notification APIs for Teacher") +@Tag(name = "教师 - 通知", description = "通知接口（教师专用）") @RestController @RequestMapping("/api/v1/teacher/notifications") @RequiredArgsConstructor @@ -19,13 +19,13 @@ public class TeacherNotificationController { private final NotificationService notificationService; - @Operation(summary = "Get notification by ID") + @Operation(summary = "根据ID获取通知") @GetMapping("/{id}") public Result getNotification(@PathVariable Long id) { return Result.success(notificationService.getNotificationById(id)); } - @Operation(summary = "Get my notifications") + @Operation(summary = "获取我的通知") @GetMapping public Result> getMyNotifications( @RequestParam(value = "page", required = false) Integer pageNum, @@ -36,14 +36,14 @@ public class TeacherNotificationController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Mark notification as read") + @Operation(summary = "标记通知为已读") @PostMapping("/{id}/read") public Result markAsRead(@PathVariable Long id) { notificationService.markAsRead(id); return Result.success(); } - @Operation(summary = "Mark all notifications as read") + @Operation(summary = "标记所有通知为已读") @PostMapping("/read-all") public Result markAllAsRead() { Long userId = SecurityUtils.getCurrentUserId(); @@ -51,7 +51,7 @@ public class TeacherNotificationController { return Result.success(); } - @Operation(summary = "Get unread count") + @Operation(summary = "获取未读通知数量") @GetMapping("/unread-count") public Result getUnreadCount() { Long userId = SecurityUtils.getCurrentUserId(); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherScheduleController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherScheduleController.java index 95abcd3..48c04b8 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherScheduleController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherScheduleController.java @@ -13,7 +13,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; import lombok.RequiredArgsConstructor; import org.springframework.web.bind.annotation.*; -@Tag(name = "Teacher - Schedule", description = "Teacher Schedule View") +@Tag(name = "教师 - 课表", description = "教师课表视图") @RestController @RequestMapping("/api/v1/teacher/schedules") @RequiredArgsConstructor @@ -22,7 +22,7 @@ public class TeacherScheduleController { private final ScheduleService scheduleService; - @Operation(summary = "Get teacher schedule plans") + @Operation(summary = "获取教师课表计划") @GetMapping public Result> getSchedulePlans( @RequestParam(defaultValue = "1") int pageNum, @@ -32,7 +32,7 @@ public class TeacherScheduleController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Get schedule plan by ID") + @Operation(summary = "根据ID获取课表计划") @GetMapping("/{id}") public Result getSchedulePlan(@PathVariable Long id) { return Result.success(scheduleService.getSchedulePlanById(id)); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherSchoolCourseController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherSchoolCourseController.java index cc17950..92a0392 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherSchoolCourseController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherSchoolCourseController.java @@ -13,7 +13,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; import lombok.RequiredArgsConstructor; import org.springframework.web.bind.annotation.*; -@Tag(name = "Teacher - School Courses", description = "School Courses for Teacher") +@Tag(name = "教师 - 校本课程", description = "校本课程接口（教师专用）") @RestController @RequestMapping("/api/v1/teacher/school-courses") @RequiredArgsConstructor @@ -22,7 +22,7 @@ public class TeacherSchoolCourseController { private final SchoolCourseService schoolCourseService; - @Operation(summary = "Get school courses") + @Operation(summary = "获取校本课程") @GetMapping public Result> getCourses( @RequestParam(defaultValue = "1") int pageNum, @@ -33,7 +33,7 @@ public class TeacherSchoolCourseController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Get school course by ID") + @Operation(summary = "根据ID获取校本课程") @GetMapping("/{id}") public Result getCourse(@PathVariable Long id) { return Result.success(schoolCourseService.getCourseById(id)); diff --git a/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherTaskController.java b/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherTaskController.java index ea47e06..574b641 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherTaskController.java +++ b/reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherTaskController.java @@ -14,7 +14,7 @@ import jakarta.validation.Valid; import lombok.RequiredArgsConstructor; import org.springframework.web.bind.annotation.*; -@Tag(name = "Teacher - Task", description = "Task APIs for Teacher") +@Tag(name = "教师 - 任务", description = "任务接口（教师专用）") @RestController @RequestMapping("/api/v1/teacher/tasks") @RequiredArgsConstructor @@ -22,7 +22,7 @@ public class TeacherTaskController { private final TaskService taskService; - @Operation(summary = "Create task") + @Operation(summary = "创建任务") @PostMapping public Result createTask(@Valid @RequestBody TaskCreateRequest request) { Long tenantId = SecurityUtils.getCurrentTenantId(); @@ -30,19 +30,19 @@ public class TeacherTaskController { return Result.success(taskService.createTask(tenantId, userId, "teacher", request)); } - @Operation(summary = "Update task") + @Operation(summary = "更新任务") @PutMapping("/{id}") public Result updateTask(@PathVariable Long id, @RequestBody TaskUpdateRequest request) { return Result.success(taskService.updateTask(id, request)); } - @Operation(summary = "Get task by ID") + @Operation(summary = "根据ID获取任务") @GetMapping("/{id}") public Result getTask(@PathVariable Long id) { return Result.success(taskService.getTaskById(id)); } - @Operation(summary = "Get task page") + @Operation(summary = "获取任务分页") @GetMapping public Result> getTaskPage( @RequestParam(value = "page", required = false) Integer pageNum, @@ -55,7 +55,7 @@ public class TeacherTaskController { return Result.success(PageResult.of(page)); } - @Operation(summary = "Delete task") + @Operation(summary = "删除任务") @DeleteMapping("/{id}") public Result deleteTask(@PathVariable Long id) { taskService.deleteTask(id); diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/request/ClassCreateRequest.java b/reading-platform-java/src/main/java/com/reading/platform/dto/request/ClassCreateRequest.java index 93a1568..6004774 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/request/ClassCreateRequest.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/request/ClassCreateRequest.java @@ -5,20 +5,20 @@ import jakarta.validation.constraints.NotBlank; import lombok.Data; @Data -@Schema(description = "Class Create Request") +@Schema(description = "班级创建请求") public class ClassCreateRequest { - @NotBlank(message = "Class name is required") - @Schema(description = "Class name") + @NotBlank(message = "班级名称不能为空") + @Schema(description = "班级名称") private String name; - @Schema(description = "Grade") + @Schema(description = "年级") private String grade; - @Schema(description = "Description") + @Schema(description = "描述") private String description; - @Schema(description = "Capacity") + @Schema(description = "容量") private Integer capacity; } diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/request/ClassUpdateRequest.java b/reading-platform-java/src/main/java/com/reading/platform/dto/request/ClassUpdateRequest.java index d8fff39..3fd2f3b 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/request/ClassUpdateRequest.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/request/ClassUpdateRequest.java @@ -4,22 +4,22 @@ import io.swagger.v3.oas.annotations.media.Schema; import lombok.Data; @Data -@Schema(description = "Class Update Request") +@Schema(description = "班级更新请求") public class ClassUpdateRequest { - @Schema(description = "Class name") + @Schema(description = "班级名称") private String name; - @Schema(description = "Grade") + @Schema(description = "年级") private String grade; - @Schema(description = "Description") + @Schema(description = "描述") private String description; - @Schema(description = "Capacity") + @Schema(description = "容量") private Integer capacity; - @Schema(description = "Status") + @Schema(description = "状态") private String status; } diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/request/CourseCreateRequest.java b/reading-platform-java/src/main/java/com/reading/platform/dto/request/CourseCreateRequest.java index 972ddc7..4f32a90 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/request/CourseCreateRequest.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/request/CourseCreateRequest.java @@ -7,135 +7,135 @@ import lombok.Data; import java.util.List; @Data -@Schema(description = "Course Create Request") +@Schema(description = "课程创建请求") public class CourseCreateRequest { - @NotBlank(message = "Course name is required") - @Schema(description = "Course name") + @NotBlank(message = "课程名称不能为空") + @Schema(description = "课程名称") private String name; - @Schema(description = "Course code") + @Schema(description = "课程编码") private String code; - @Schema(description = "Description") + @Schema(description = "描述") private String description; - @Schema(description = "Cover URL") + @Schema(description = "封面URL") private String coverUrl; - @Schema(description = "Cover image path") + @Schema(description = "封面图片路径") private String coverImagePath; - @Schema(description = "Category") + @Schema(description = "分类") private String category; - @Schema(description = "Age range") + @Schema(description = "年龄段") private String ageRange; - @Schema(description = "Difficulty level") + @Schema(description = "难度等级") private String difficultyLevel; - @Schema(description = "Duration in minutes") + @Schema(description = "时长（分钟）") private Integer durationMinutes; - @Schema(description = "Objectives") + @Schema(description = "教学目标") private String objectives; // ============================================ - // Course Package Refactoring Fields + // 课程包重构字段 // ============================================ - @Schema(description = "Core content") + @Schema(description = "核心内容") private String coreContent; - // Course introduction (8 fields) - @Schema(description = "Course summary") + // 课程介绍（8个字段） + @Schema(description = "课程摘要") private String introSummary; - @Schema(description = "Course highlights") + @Schema(description = "课程亮点") private String introHighlights; - @Schema(description = "Course goals") + @Schema(description = "课程目标") private String introGoals; - @Schema(description = "Content schedule") + @Schema(description = "内容安排") private String introSchedule; - @Schema(description = "Key points and difficulties") + @Schema(description = "重点难点") private String introKeyPoints; - @Schema(description = "Teaching methods") + @Schema(description = "教学方法") private String introMethods; - @Schema(description = "Evaluation methods") + @Schema(description = "评估方法") private String introEvaluation; - @Schema(description = "Notes and precautions") + @Schema(description = "注意事项") private String introNotes; - // Schedule reference data - @Schema(description = "Schedule reference data (JSON)") + // 课表参考数据 + @Schema(description = "课表参考数据（JSON）") private String scheduleRefData; - // Environment construction (Step 7) - @Schema(description = "Environment construction content") + // 环境创设（步骤7） + @Schema(description = "环境创设内容") private String environmentConstruction; - // Theme and picture book - @Schema(description = "Theme ID") + // 主题与绘本 + @Schema(description = "主题ID") private Long themeId; - @Schema(description = "Picture book name") + @Schema(description = "绘本名称") private String pictureBookName; - // Digital resources - @Schema(description = "Ebook paths (JSON array)") + // 数字资源 + @Schema(description = "电子书路径（JSON数组）") private String ebookPaths; - @Schema(description = "Audio paths (JSON array)") + @Schema(description = "音频路径（JSON数组）") private String audioPaths; - @Schema(description = "Video paths (JSON array)") + @Schema(description = "视频路径（JSON数组）") private String videoPaths; - @Schema(description = "Other resources (JSON array)") + @Schema(description = "其他资源（JSON数组）") private String otherResources; - // Teaching materials - @Schema(description = "PPT file path") + // 教学材料 + @Schema(description = "PPT文件路径") private String pptPath; - @Schema(description = "PPT file name") + @Schema(description = "PPT文件名") private String pptName; - @Schema(description = "Poster paths (JSON array)") + @Schema(description = "海报路径（JSON数组）") private String posterPaths; - @Schema(description = "Teaching tools (JSON array)") + @Schema(description = "教具（JSON数组）") private String tools; - @Schema(description = "Student materials") + @Schema(description = "学生材料") private String studentMaterials; - // Lesson plan, activities, assessment - @Schema(description = "Lesson plan data (JSON)") + // 教案、活动、评估 + @Schema(description = "教案数据（JSON）") private String lessonPlanData; - @Schema(description = "Activities data (JSON)") + @Schema(description = "活动数据（JSON）") private String activitiesData; - @Schema(description = "Assessment data (JSON)") + @Schema(description = "评估数据（JSON）") private String assessmentData; - // Tags - @Schema(description = "Grade tags (JSON array)") + // 标签 + @Schema(description = "年级标签（JSON数组）") private String gradeTags; - @Schema(description = "Domain tags (JSON array)") + @Schema(description = "领域标签（JSON数组）") private String domainTags; - // Collective lesson - @Schema(description = "Has collective lesson") + // 集体课 + @Schema(description = "是否有集体课") private Boolean hasCollectiveLesson; } diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/request/CourseUpdateRequest.java b/reading-platform-java/src/main/java/com/reading/platform/dto/request/CourseUpdateRequest.java index 13e659b..b59375e 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/request/CourseUpdateRequest.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/request/CourseUpdateRequest.java @@ -4,137 +4,137 @@ import io.swagger.v3.oas.annotations.media.Schema; import lombok.Data; @Data -@Schema(description = "Course Update Request") +@Schema(description = "课程更新请求") public class CourseUpdateRequest { - @Schema(description = "Course name") + @Schema(description = "课程名称") private String name; - @Schema(description = "Course code") + @Schema(description = "课程编码") private String code; - @Schema(description = "Description") + @Schema(description = "描述") private String description; - @Schema(description = "Cover URL") + @Schema(description = "封面URL") private String coverUrl; - @Schema(description = "Cover image path") + @Schema(description = "封面图片路径") private String coverImagePath; - @Schema(description = "Category") + @Schema(description = "分类") private String category; - @Schema(description = "Age range") + @Schema(description = "年龄段") private String ageRange; - @Schema(description = "Difficulty level") + @Schema(description = "难度等级") private String difficultyLevel; - @Schema(description = "Duration in minutes") + @Schema(description = "时长（分钟）") private Integer durationMinutes; - @Schema(description = "Objectives") + @Schema(description = "教学目标") private String objectives; - @Schema(description = "Status") + @Schema(description = "状态") private String status; // ============================================ - // Course Package Refactoring Fields + // 课程包重构字段 // ============================================ - @Schema(description = "Core content") + @Schema(description = "核心内容") private String coreContent; - // Course introduction (8 fields) - @Schema(description = "Course summary") + // 课程介绍（8个字段） + @Schema(description = "课程摘要") private String introSummary; - @Schema(description = "Course highlights") + @Schema(description = "课程亮点") private String introHighlights; - @Schema(description = "Course goals") + @Schema(description = "课程目标") private String introGoals; - @Schema(description = "Content schedule") + @Schema(description = "内容安排") private String introSchedule; - @Schema(description = "Key points and difficulties") + @Schema(description = "重点难点") private String introKeyPoints; - @Schema(description = "Teaching methods") + @Schema(description = "教学方法") private String introMethods; - @Schema(description = "Evaluation methods") + @Schema(description = "评估方法") private String introEvaluation; - @Schema(description = "Notes and precautions") + @Schema(description = "注意事项") private String introNotes; - // Schedule reference data - @Schema(description = "Schedule reference data (JSON)") + // 课表参考数据 + @Schema(description = "课表参考数据（JSON）") private String scheduleRefData; - // Environment construction (Step 7) - @Schema(description = "Environment construction content") + // 环境创设（步骤7） + @Schema(description = "环境创设内容") private String environmentConstruction; - // Theme and picture book - @Schema(description = "Theme ID") + // 主题与绘本 + @Schema(description = "主题ID") private Long themeId; - @Schema(description = "Picture book name") + @Schema(description = "绘本名称") private String pictureBookName; - // Digital resources - @Schema(description = "Ebook paths (JSON array)") + // 数字资源 + @Schema(description = "电子书路径（JSON数组）") private String ebookPaths; - @Schema(description = "Audio paths (JSON array)") + @Schema(description = "音频路径（JSON数组）") private String audioPaths; - @Schema(description = "Video paths (JSON array)") + @Schema(description = "视频路径（JSON数组）") private String videoPaths; - @Schema(description = "Other resources (JSON array)") + @Schema(description = "其他资源（JSON数组）") private String otherResources; - // Teaching materials - @Schema(description = "PPT file path") + // 教学材料 + @Schema(description = "PPT文件路径") private String pptPath; - @Schema(description = "PPT file name") + @Schema(description = "PPT文件名") private String pptName; - @Schema(description = "Poster paths (JSON array)") + @Schema(description = "海报路径（JSON数组）") private String posterPaths; - @Schema(description = "Teaching tools (JSON array)") + @Schema(description = "教具（JSON数组）") private String tools; - @Schema(description = "Student materials") + @Schema(description = "学生材料") private String studentMaterials; - // Lesson plan, activities, assessment - @Schema(description = "Lesson plan data (JSON)") + // 教案、活动、评估 + @Schema(description = "教案数据（JSON）") private String lessonPlanData; - @Schema(description = "Activities data (JSON)") + @Schema(description = "活动数据（JSON）") private String activitiesData; - @Schema(description = "Assessment data (JSON)") + @Schema(description = "评估数据（JSON）") private String assessmentData; - // Tags - @Schema(description = "Grade tags (JSON array)") + // 标签 + @Schema(description = "年级标签（JSON数组）") private String gradeTags; - @Schema(description = "Domain tags (JSON array)") + @Schema(description = "领域标签（JSON数组）") private String domainTags; - // Collective lesson - @Schema(description = "Has collective lesson") + // 集体课 + @Schema(description = "是否有集体课") private Boolean hasCollectiveLesson; } diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/request/GrowthRecordCreateRequest.java b/reading-platform-java/src/main/java/com/reading/platform/dto/request/GrowthRecordCreateRequest.java index 7a1c4b5..3ddae6a 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/request/GrowthRecordCreateRequest.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/request/GrowthRecordCreateRequest.java @@ -9,7 +9,7 @@ import java.time.LocalDate; import java.util.List; @Data -@Schema(description = "Growth Record Create Request") +@Schema(description = "成长档案创建请求") public class GrowthRecordCreateRequest { @NotNull(message = "Student ID is required") diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/request/GrowthRecordUpdateRequest.java b/reading-platform-java/src/main/java/com/reading/platform/dto/request/GrowthRecordUpdateRequest.java index d8443c6..1f126db 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/request/GrowthRecordUpdateRequest.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/request/GrowthRecordUpdateRequest.java @@ -7,25 +7,25 @@ import java.time.LocalDate; import java.util.List; @Data -@Schema(description = "Growth Record Update Request") +@Schema(description = "成长档案更新请求") public class GrowthRecordUpdateRequest { - @Schema(description = "Type") + @Schema(description = "类型") private String type; - @Schema(description = "Title") + @Schema(description = "标题") private String title; - @Schema(description = "Content") + @Schema(description = "内容") private String content; - @Schema(description = "Images (JSON array)") + @Schema(description = "图片（JSON数组）") private String images; - @Schema(description = "Record date") + @Schema(description = "记录日期") private LocalDate recordDate; - @Schema(description = "Tags") + @Schema(description = "标签") private List tags; } diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/request/LessonCreateRequest.java b/reading-platform-java/src/main/java/com/reading/platform/dto/request/LessonCreateRequest.java index ebd8384..edc0f2c 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/request/LessonCreateRequest.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/request/LessonCreateRequest.java @@ -9,38 +9,38 @@ import java.time.LocalDate; import java.time.LocalTime; @Data -@Schema(description = "Lesson Create Request") +@Schema(description = "课时创建请求") public class LessonCreateRequest { - @NotNull(message = "Course ID is required") - @Schema(description = "Course ID") + @NotNull(message = "课程ID不能为空") + @Schema(description = "课程ID") private Long courseId; - @Schema(description = "Class ID") + @Schema(description = "班级ID") private Long classId; - @NotNull(message = "Teacher ID is required") - @Schema(description = "Teacher ID") + @NotNull(message = "教师ID不能为空") + @Schema(description = "教师ID") private Long teacherId; - @NotBlank(message = "Title is required") - @Schema(description = "Lesson title") + @NotBlank(message = "标题不能为空") + @Schema(description = "课时标题") private String title; - @NotNull(message = "Lesson date is required") - @Schema(description = "Lesson date") + @NotNull(message = "课时日期不能为空") + @Schema(description = "课时日期") private LocalDate lessonDate; - @Schema(description = "Start time") + @Schema(description = "开始时间") private LocalTime startTime; - @Schema(description = "End time") + @Schema(description = "结束时间") private LocalTime endTime; - @Schema(description = "Location") + @Schema(description = "地点") private String location; - @Schema(description = "Notes") + @Schema(description = "备注") private String notes; } diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/request/LessonUpdateRequest.java b/reading-platform-java/src/main/java/com/reading/platform/dto/request/LessonUpdateRequest.java index abd216d..60cb787 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/request/LessonUpdateRequest.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/request/LessonUpdateRequest.java @@ -7,7 +7,7 @@ import java.time.LocalDate; import java.time.LocalTime; @Data -@Schema(description = "Lesson Update Request") +@Schema(description = "课时更新请求") public class LessonUpdateRequest { @Schema(description = "Lesson title") diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/request/LoginRequest.java b/reading-platform-java/src/main/java/com/reading/platform/dto/request/LoginRequest.java index 97ca543..0325b0e 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/request/LoginRequest.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/request/LoginRequest.java @@ -6,19 +6,19 @@ import jakarta.validation.constraints.NotBlank; import lombok.Data; @Data -@Schema(description = "Login Request") +@Schema(description = "登录请求") public class LoginRequest { - @NotBlank(message = "Username is required") + @NotBlank(message = "用户名不能为空") @JsonAlias("account") - @Schema(description = "Username", example = "admin") + @Schema(description = "用户名", example = "admin") private String username; - @NotBlank(message = "Password is required") - @Schema(description = "Password", example = "admin123") + @NotBlank(message = "密码不能为空") + @Schema(description = "密码", example = "admin123") private String password; - @Schema(description = "Login role", example = "admin") + @Schema(description = "登录角色", example = "admin") private String role; } diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/request/ParentCreateRequest.java b/reading-platform-java/src/main/java/com/reading/platform/dto/request/ParentCreateRequest.java index 7a40c0b..f80bee0 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/request/ParentCreateRequest.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/request/ParentCreateRequest.java @@ -8,25 +8,25 @@ import lombok.Data; @Schema(description = "Parent Create Request") public class ParentCreateRequest { - @NotBlank(message = "Username is required") - @Schema(description = "Username") + @NotBlank(message = "用户名不能为空") + @Schema(description = "用户名") private String username; - @NotBlank(message = "Password is required") - @Schema(description = "Password") + @NotBlank(message = "密码不能为空") + @Schema(description = "密码") private String password; - @NotBlank(message = "Name is required") - @Schema(description = "Name") + @NotBlank(message = "姓名不能为空") + @Schema(description = "姓名") private String name; - @Schema(description = "Phone") + @Schema(description = "电话") private String phone; - @Schema(description = "Email") + @Schema(description = "邮箱") private String email; - @Schema(description = "Gender") + @Schema(description = "性别") private String gender; } diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/request/ParentUpdateRequest.java b/reading-platform-java/src/main/java/com/reading/platform/dto/request/ParentUpdateRequest.java index bb93112..c0f4b66 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/request/ParentUpdateRequest.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/request/ParentUpdateRequest.java @@ -4,25 +4,25 @@ import io.swagger.v3.oas.annotations.media.Schema; import lombok.Data; @Data -@Schema(description = "Parent Update Request") +@Schema(description = "家长更新请求") public class ParentUpdateRequest { - @Schema(description = "Name") + @Schema(description = "姓名") private String name; - @Schema(description = "Phone") + @Schema(description = "电话") private String phone; - @Schema(description = "Email") + @Schema(description = "邮箱") private String email; - @Schema(description = "Avatar URL") + @Schema(description = "头像URL") private String avatarUrl; - @Schema(description = "Gender") + @Schema(description = "性别") private String gender; - @Schema(description = "Status") + @Schema(description = "状态") private String status; } diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/request/StudentCreateRequest.java b/reading-platform-java/src/main/java/com/reading/platform/dto/request/StudentCreateRequest.java index 1dc995b..49b8eac 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/request/StudentCreateRequest.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/request/StudentCreateRequest.java @@ -7,7 +7,7 @@ import lombok.Data; import java.time.LocalDate; @Data -@Schema(description = "Student Create Request") +@Schema(description = "学生创建请求") public class StudentCreateRequest { @NotBlank(message = "Name is required") diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/request/StudentUpdateRequest.java b/reading-platform-java/src/main/java/com/reading/platform/dto/request/StudentUpdateRequest.java index 24d5d18..970ae69 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/request/StudentUpdateRequest.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/request/StudentUpdateRequest.java @@ -6,37 +6,37 @@ import lombok.Data; import java.time.LocalDate; @Data -@Schema(description = "Student Update Request") +@Schema(description = "学生更新请求") public class StudentUpdateRequest { - @Schema(description = "Name") + @Schema(description = "姓名") private String name; - @Schema(description = "Gender") + @Schema(description = "性别") private String gender; - @Schema(description = "Birth date") + @Schema(description = "出生日期") private LocalDate birthDate; - @Schema(description = "Avatar URL") + @Schema(description = "头像URL") private String avatarUrl; - @Schema(description = "Grade") + @Schema(description = "年级") private String grade; - @Schema(description = "Student number") + @Schema(description = "学号") private String studentNo; - @Schema(description = "Reading level") + @Schema(description = "阅读水平") private String readingLevel; - @Schema(description = "Interests") + @Schema(description = "兴趣爱好") private String interests; - @Schema(description = "Notes") + @Schema(description = "备注") private String notes; - @Schema(description = "Status") + @Schema(description = "状态") private String status; } diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/request/TaskCreateRequest.java b/reading-platform-java/src/main/java/com/reading/platform/dto/request/TaskCreateRequest.java index fd59b1f..68aa6a1 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/request/TaskCreateRequest.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/request/TaskCreateRequest.java @@ -8,35 +8,35 @@ import java.time.LocalDate; import java.util.List; @Data -@Schema(description = "Task Create Request") +@Schema(description = "任务创建请求") public class TaskCreateRequest { - @NotBlank(message = "Task title is required") - @Schema(description = "Task title") + @NotBlank(message = "任务标题不能为空") + @Schema(description = "任务标题") private String title; - @Schema(description = "Description") + @Schema(description = "描述") private String description; - @Schema(description = "Task type: reading, homework, activity") + @Schema(description = "任务类型: 阅读、作业、活动") private String type; - @Schema(description = "Course ID") + @Schema(description = "课程ID") private Long courseId; - @Schema(description = "Start date") + @Schema(description = "开始日期") private LocalDate startDate; - @Schema(description = "Due date") + @Schema(description = "截止日期") private LocalDate dueDate; - @Schema(description = "Attachments (JSON array)") + @Schema(description = "附件（JSON数组）") private String attachments; - @Schema(description = "Target type: class, student") + @Schema(description = "目标类型: 班级、学生") private String targetType; - @Schema(description = "Target IDs") + @Schema(description = "目标ID列表") private List targetIds; } diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/request/TaskUpdateRequest.java b/reading-platform-java/src/main/java/com/reading/platform/dto/request/TaskUpdateRequest.java index 81f6f65..072c02e 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/request/TaskUpdateRequest.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/request/TaskUpdateRequest.java @@ -6,28 +6,28 @@ import lombok.Data; import java.time.LocalDate; @Data -@Schema(description = "Task Update Request") +@Schema(description = "任务更新请求") public class TaskUpdateRequest { - @Schema(description = "Task title") + @Schema(description = "任务标题") private String title; - @Schema(description = "Description") + @Schema(description = "描述") private String description; - @Schema(description = "Task type") + @Schema(description = "任务类型") private String type; - @Schema(description = "Start date") + @Schema(description = "开始日期") private LocalDate startDate; - @Schema(description = "Due date") + @Schema(description = "截止日期") private LocalDate dueDate; - @Schema(description = "Status") + @Schema(description = "状态") private String status; - @Schema(description = "Attachments (JSON array)") + @Schema(description = "附件（JSON数组）") private String attachments; } diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/request/TeacherCreateRequest.java b/reading-platform-java/src/main/java/com/reading/platform/dto/request/TeacherCreateRequest.java index a078f7b..db49a6e 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/request/TeacherCreateRequest.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/request/TeacherCreateRequest.java @@ -5,31 +5,31 @@ import jakarta.validation.constraints.NotBlank; import lombok.Data; @Data -@Schema(description = "Teacher Create Request") +@Schema(description = "教师创建请求") public class TeacherCreateRequest { - @NotBlank(message = "Username is required") - @Schema(description = "Username") + @NotBlank(message = "用户名不能为空") + @Schema(description = "用户名") private String username; - @NotBlank(message = "Password is required") - @Schema(description = "Password") + @NotBlank(message = "密码不能为空") + @Schema(description = "密码") private String password; - @NotBlank(message = "Name is required") - @Schema(description = "Name") + @NotBlank(message = "姓名不能为空") + @Schema(description = "姓名") private String name; - @Schema(description = "Phone") + @Schema(description = "电话") private String phone; - @Schema(description = "Email") + @Schema(description = "邮箱") private String email; - @Schema(description = "Gender") + @Schema(description = "性别") private String gender; - @Schema(description = "Bio") + @Schema(description = "个人简介") private String bio; } diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/request/TeacherUpdateRequest.java b/reading-platform-java/src/main/java/com/reading/platform/dto/request/TeacherUpdateRequest.java index 47113d7..ccac6be 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/request/TeacherUpdateRequest.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/request/TeacherUpdateRequest.java @@ -4,28 +4,28 @@ import io.swagger.v3.oas.annotations.media.Schema; import lombok.Data; @Data -@Schema(description = "Teacher Update Request") +@Schema(description = "教师更新请求") public class TeacherUpdateRequest { - @Schema(description = "Name") + @Schema(description = "姓名") private String name; - @Schema(description = "Phone") + @Schema(description = "电话") private String phone; - @Schema(description = "Email") + @Schema(description = "邮箱") private String email; - @Schema(description = "Avatar URL") + @Schema(description = "头像URL") private String avatarUrl; - @Schema(description = "Gender") + @Schema(description = "性别") private String gender; - @Schema(description = "Bio") + @Schema(description = "个人简介") private String bio; - @Schema(description = "Status") + @Schema(description = "状态") private String status; } diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/request/TenantCreateRequest.java b/reading-platform-java/src/main/java/com/reading/platform/dto/request/TenantCreateRequest.java index ca091b1..509fe5a 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/request/TenantCreateRequest.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/request/TenantCreateRequest.java @@ -8,53 +8,53 @@ import lombok.Data; import java.time.LocalDateTime; @Data -@Schema(description = "Tenant Create Request") +@Schema(description = "租户创建请求") public class TenantCreateRequest { - @NotBlank(message = "Tenant name is required") - @Schema(description = "Tenant name") + @NotBlank(message = "租户名称不能为空") + @Schema(description = "租户名称") private String name; - @NotBlank(message = "Login account is required") + @NotBlank(message = "登录账号不能为空") @JsonAlias("loginAccount") - @Schema(description = "Tenant code / login account") + @Schema(description = "租户编码 / 登录账号") private String code; @JsonAlias("contactPerson") - @Schema(description = "Contact person") + @Schema(description = "联系人") private String contactName; - @Schema(description = "Contact phone") + @Schema(description = "联系电话") private String contactPhone; - @Schema(description = "Contact email") + @Schema(description = "联系邮箱") private String contactEmail; - @Schema(description = "Address") + @Schema(description = "地址") private String address; @Schema(description = "Logo URL") private String logoUrl; @JsonAlias("expireDate") - @Schema(description = "Expiration date") + @Schema(description = "过期日期") private LocalDateTime expireAt; @JsonAlias("studentQuota") - @Schema(description = "Max students") + @Schema(description = "最大学生数") private Integer maxStudents; @JsonAlias("teacherQuota") - @Schema(description = "Max teachers") + @Schema(description = "最大教师数") private Integer maxTeachers; - @Schema(description = "Initial password (default: 123456)") + @Schema(description = "初始密码（默认: 123456）") private String password; - @Schema(description = "Package type (optional)") + @Schema(description = "套餐类型（可选）") private String packageType; - @Schema(description = "Start date (optional)") + @Schema(description = "开始日期（可选）") private String startDate; } diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/request/TenantUpdateRequest.java b/reading-platform-java/src/main/java/com/reading/platform/dto/request/TenantUpdateRequest.java index 839dc0e..bd9dc68 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/request/TenantUpdateRequest.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/request/TenantUpdateRequest.java @@ -7,47 +7,47 @@ import lombok.Data; import java.time.LocalDateTime; @Data -@Schema(description = "Tenant Update Request") +@Schema(description = "租户更新请求") public class TenantUpdateRequest { - @Schema(description = "Tenant name") + @Schema(description = "租户名称") private String name; @JsonAlias("contactPerson") - @Schema(description = "Contact person") + @Schema(description = "联系人") private String contactName; - @Schema(description = "Contact phone") + @Schema(description = "联系电话") private String contactPhone; - @Schema(description = "Contact email") + @Schema(description = "联系邮箱") private String contactEmail; - @Schema(description = "Address") + @Schema(description = "地址") private String address; @Schema(description = "Logo URL") private String logoUrl; - @Schema(description = "Status") + @Schema(description = "状态") private String status; @JsonAlias("expireDate") - @Schema(description = "Expiration date") + @Schema(description = "过期日期") private LocalDateTime expireAt; @JsonAlias("studentQuota") - @Schema(description = "Max students") + @Schema(description = "最大学生数") private Integer maxStudents; @JsonAlias("teacherQuota") - @Schema(description = "Max teachers") + @Schema(description = "最大教师数") private Integer maxTeachers; - @Schema(description = "Package type (optional)") + @Schema(description = "套餐类型（可选）") private String packageType; - @Schema(description = "Start date (optional)") + @Schema(description = "开始日期（可选）") private String startDate; } diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/response/CourseResponse.java b/reading-platform-java/src/main/java/com/reading/platform/dto/response/CourseResponse.java index de9cdbc..5b2600f 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/response/CourseResponse.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/response/CourseResponse.java @@ -7,199 +7,199 @@ import java.math.BigDecimal; import java.time.LocalDateTime; /** - * Course Response DTO + * 课程响应DTO */ @Data -@Schema(description = "Course Response") +@Schema(description = "课程响应") public class CourseResponse { - @Schema(description = "Course ID") + @Schema(description = "课程ID") private Long id; - @Schema(description = "Tenant ID") + @Schema(description = "租户ID") private Long tenantId; - @Schema(description = "Course name") + @Schema(description = "课程名称") private String name; - @Schema(description = "Course code") + @Schema(description = "课程编码") private String code; - @Schema(description = "Description") + @Schema(description = "描述") private String description; - @Schema(description = "Cover URL") + @Schema(description = "封面URL") private String coverUrl; - @Schema(description = "Cover image path") + @Schema(description = "封面图片路径") private String coverImagePath; - @Schema(description = "Category") + @Schema(description = "分类") private String category; - @Schema(description = "Age range") + @Schema(description = "年龄段") private String ageRange; - @Schema(description = "Difficulty level") + @Schema(description = "难度等级") private String difficultyLevel; - @Schema(description = "Duration in minutes") + @Schema(description = "时长（分钟）") private Integer durationMinutes; - @Schema(description = "Objectives") + @Schema(description = "教学目标") private String objectives; - @Schema(description = "Status") + @Schema(description = "状态") private String status; - @Schema(description = "Is system course") + @Schema(description = "是否系统课程") private Integer isSystem; // ============================================ - // Course Package Fields + // 课程包字段 // ============================================ - @Schema(description = "Core content") + @Schema(description = "核心内容") private String coreContent; - // Course introduction (8 fields) - @Schema(description = "Course summary") + // 课程介绍（8个字段） + @Schema(description = "课程摘要") private String introSummary; - @Schema(description = "Course highlights") + @Schema(description = "课程亮点") private String introHighlights; - @Schema(description = "Course goals") + @Schema(description = "课程目标") private String introGoals; - @Schema(description = "Content schedule") + @Schema(description = "内容安排") private String introSchedule; - @Schema(description = "Key points and difficulties") + @Schema(description = "重点难点") private String introKeyPoints; - @Schema(description = "Teaching methods") + @Schema(description = "教学方法") private String introMethods; - @Schema(description = "Evaluation methods") + @Schema(description = "评估方法") private String introEvaluation; - @Schema(description = "Notes and precautions") + @Schema(description = "注意事项") private String introNotes; - // Schedule reference data - @Schema(description = "Schedule reference data (JSON)") + // 课表参考数据 + @Schema(description = "课表参考数据（JSON）") private String scheduleRefData; - // Environment construction (Step 7) - @Schema(description = "Environment construction content") + // 环境创设（步骤7） + @Schema(description = "环境创设内容") private String environmentConstruction; - // Theme and picture book - @Schema(description = "Theme ID") + // 主题与绘本 + @Schema(description = "主题ID") private Long themeId; - @Schema(description = "Picture book name") + @Schema(description = "绘本名称") private String pictureBookName; - // Digital resources - @Schema(description = "Ebook paths (JSON array)") + // 数字资源 + @Schema(description = "电子书路径（JSON数组）") private String ebookPaths; - @Schema(description = "Audio paths (JSON array)") + @Schema(description = "音频路径（JSON数组）") private String audioPaths; - @Schema(description = "Video paths (JSON array)") + @Schema(description = "视频路径（JSON数组）") private String videoPaths; - @Schema(description = "Other resources (JSON array)") + @Schema(description = "其他资源（JSON数组）") private String otherResources; - // Teaching materials - @Schema(description = "PPT file path") + // 教学材料 + @Schema(description = "PPT文件路径") private String pptPath; - @Schema(description = "PPT file name") + @Schema(description = "PPT文件名") private String pptName; - @Schema(description = "Poster paths (JSON array)") + @Schema(description = "海报路径（JSON数组）") private String posterPaths; - @Schema(description = "Teaching tools (JSON array)") + @Schema(description = "教具（JSON数组）") private String tools; - @Schema(description = "Student materials") + @Schema(description = "学生材料") private String studentMaterials; - // Lesson plan, activities, assessment - @Schema(description = "Lesson plan data (JSON)") + // 教案、活动、评估 + @Schema(description = "教案数据（JSON）") private String lessonPlanData; - @Schema(description = "Activities data (JSON)") + @Schema(description = "活动数据（JSON）") private String activitiesData; - @Schema(description = "Assessment data (JSON)") + @Schema(description = "评估数据（JSON）") private String assessmentData; - // Tags - @Schema(description = "Grade tags (JSON array)") + // 标签 + @Schema(description = "年级标签（JSON数组）") private String gradeTags; - @Schema(description = "Domain tags (JSON array)") + @Schema(description = "领域标签（JSON数组）") private String domainTags; - // Collective lesson - @Schema(description = "Has collective lesson") + // 集体课 + @Schema(description = "是否有集体课") private Integer hasCollectiveLesson; - // Version and review - @Schema(description = "Version") + // 版本与审核 + @Schema(description = "版本") private String version; - @Schema(description = "Parent ID") + @Schema(description = "父ID") private Long parentId; - @Schema(description = "Is latest") + @Schema(description = "是否最新") private Integer isLatest; - @Schema(description = "Submitted at") + @Schema(description = "提交时间") private LocalDateTime submittedAt; - @Schema(description = "Submitted by") + @Schema(description = "提交人") private Long submittedBy; - @Schema(description = "Reviewed at") + @Schema(description = "审核时间") private LocalDateTime reviewedAt; - @Schema(description = "Reviewed by") + @Schema(description = "审核人") private Long reviewedBy; - @Schema(description = "Review comment") + @Schema(description = "审核意见") private String reviewComment; - @Schema(description = "Review checklist") + @Schema(description = "审核清单") private String reviewChecklist; - @Schema(description = "Published at") + @Schema(description = "发布时间") private LocalDateTime publishedAt; - // Usage statistics - @Schema(description = "Usage count") + // 使用统计 + @Schema(description = "使用次数") private Integer usageCount; - @Schema(description = "Teacher count") + @Schema(description = "教师数") private Integer teacherCount; - @Schema(description = "Average rating") + @Schema(description = "平均评分") private BigDecimal avgRating; - @Schema(description = "Created by") + @Schema(description = "创建人") private Long createdBy; - @Schema(description = "Created at") + @Schema(description = "创建时间") private LocalDateTime createdAt; - @Schema(description = "Updated at") + @Schema(description = "更新时间") private LocalDateTime updatedAt; } diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/response/LoginResponse.java b/reading-platform-java/src/main/java/com/reading/platform/dto/response/LoginResponse.java index 8bebfd2..fdd05af 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/response/LoginResponse.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/response/LoginResponse.java @@ -10,25 +10,25 @@ import lombok.NoArgsConstructor; @Builder @NoArgsConstructor @AllArgsConstructor -@Schema(description = "Login Response") +@Schema(description = "登录响应") public class LoginResponse { - @Schema(description = "JWT Token") + @Schema(description = "JWT令牌") private String token; - @Schema(description = "User ID") + @Schema(description = "用户ID") private Long userId; - @Schema(description = "Username") + @Schema(description = "用户名") private String username; - @Schema(description = "User name") + @Schema(description = "用户姓名") private String name; - @Schema(description = "User role") + @Schema(description = "用户角色") private String role; - @Schema(description = "Tenant ID") + @Schema(description = "租户ID") private Long tenantId; } diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/response/TenantResponse.java b/reading-platform-java/src/main/java/com/reading/platform/dto/response/TenantResponse.java index c586792..9dd1ec9 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/response/TenantResponse.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/response/TenantResponse.java @@ -8,46 +8,46 @@ import java.time.LocalDateTime; @Data @Builder -@Schema(description = "Tenant Response") +@Schema(description = "租户响应") public class TenantResponse { - @Schema(description = "Tenant ID") + @Schema(description = "租户ID") private Long id; - @Schema(description = "Tenant name") + @Schema(description = "租户名称") private String name; - @Schema(description = "Login account (tenant code)") + @Schema(description = "登录账号（租户编码）") private String loginAccount; - @Schema(description = "Contact person") + @Schema(description = "联系人") private String contactPerson; - @Schema(description = "Contact phone") + @Schema(description = "联系电话") private String contactPhone; - @Schema(description = "Contact email") + @Schema(description = "联系邮箱") private String contactEmail; - @Schema(description = "Address") + @Schema(description = "地址") private String address; @Schema(description = "Logo URL") private String logoUrl; - @Schema(description = "Status") + @Schema(description = "状态") private String status; - @Schema(description = "Expiration date") + @Schema(description = "过期日期") private LocalDateTime expireDate; - @Schema(description = "Max students / student quota") + @Schema(description = "最大学生数 / 学生配额") private Integer studentQuota; - @Schema(description = "Max teachers / teacher quota") + @Schema(description = "最大教师数 / 教师配额") private Integer teacherQuota; - @Schema(description = "Created at") + @Schema(description = "创建时间") private LocalDateTime createdAt; } diff --git a/reading-platform-java/src/main/java/com/reading/platform/dto/response/UserInfoResponse.java b/reading-platform-java/src/main/java/com/reading/platform/dto/response/UserInfoResponse.java index df8ae91..5c3b824 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/dto/response/UserInfoResponse.java +++ b/reading-platform-java/src/main/java/com/reading/platform/dto/response/UserInfoResponse.java @@ -10,31 +10,31 @@ import lombok.NoArgsConstructor; @Builder @NoArgsConstructor @AllArgsConstructor -@Schema(description = "User Info Response") +@Schema(description = "用户信息响应") public class UserInfoResponse { - @Schema(description = "User ID") + @Schema(description = "用户ID") private Long id; - @Schema(description = "Username") + @Schema(description = "用户名") private String username; - @Schema(description = "User name") + @Schema(description = "用户姓名") private String name; - @Schema(description = "Email") + @Schema(description = "邮箱") private String email; - @Schema(description = "Phone") + @Schema(description = "电话") private String phone; - @Schema(description = "Avatar URL") + @Schema(description = "头像URL") private String avatarUrl; - @Schema(description = "User role") + @Schema(description = "用户角色") private String role; - @Schema(description = "Tenant ID") + @Schema(description = "租户ID") private Long tenantId; } diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/AdminUser.java b/reading-platform-java/src/main/java/com/reading/platform/entity/AdminUser.java index 03af45a..a9de840 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/AdminUser.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/AdminUser.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Admin User Entity + * 管理员用户实体 */ @Data @TableName("admin_users") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/ClassTeacher.java b/reading-platform-java/src/main/java/com/reading/platform/entity/ClassTeacher.java index ee38937..86d6ef3 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/ClassTeacher.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/ClassTeacher.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Class Teacher Relation Entity + * 班级-教师关联实体 */ @Data @TableName("class_teachers") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/Clazz.java b/reading-platform-java/src/main/java/com/reading/platform/entity/Clazz.java index 5eef106..312d632 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/Clazz.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/Clazz.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Class Entity + * 班级实体 */ @Data @TableName("classes") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/Course.java b/reading-platform-java/src/main/java/com/reading/platform/entity/Course.java index bff5637..ef78b76 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/Course.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/Course.java @@ -7,8 +7,8 @@ import java.math.BigDecimal; import java.time.LocalDateTime; /** - * Course Entity - * Course package entity with comprehensive fields for course management + * 课程实体 + * 课程包实体，包含完整的课程管理字段 */ @Data @TableName("courses") @@ -42,13 +42,13 @@ public class Course { private Integer isSystem; // ============================================ - // Course Package Refactoring Fields (2026-02-28) + // 课程包重构字段 (2026-02-28) // ============================================ - // Core content + // 核心内容 private String coreContent; - // Course introduction (8 fields) + // 课程介绍（8个字段） private String introSummary; private String introHighlights; private String introGoals; @@ -58,45 +58,45 @@ public class Course { private String introEvaluation; private String introNotes; - // Schedule reference data (JSON) + // 课表参考数据（JSON） private String scheduleRefData; - // Environment construction (Step 7) + // 环境创设（步骤7） private String environmentConstruction; - // Theme and picture book relation + // 主题与绘本关系 private Long themeId; private String pictureBookName; - // Cover image + // 封面图片 private String coverImagePath; - // Digital resources (JSON arrays) + // 数字资源（JSON数组） private String ebookPaths; private String audioPaths; private String videoPaths; private String otherResources; - // Teaching materials + // 教学材料 private String pptPath; private String pptName; private String posterPaths; private String tools; private String studentMaterials; - // Lesson plan, activities, assessment (JSON) + // 教案、活动、评估（JSON） private String lessonPlanData; private String activitiesData; private String assessmentData; - // Grade and domain tags (JSON arrays) + // 年级与领域标签（JSON数组） private String gradeTags; private String domainTags; - // Collective lesson flag + // 集体课标志 private Integer hasCollectiveLesson; - // Version and review fields + // 版本与审核字段 private String version; private Long parentId; private Integer isLatest; @@ -108,7 +108,7 @@ public class Course { private String reviewChecklist; private LocalDateTime publishedAt; - // Usage statistics + // 使用统计 private Integer usageCount; private Integer teacherCount; private BigDecimal avgRating; diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/CourseActivity.java b/reading-platform-java/src/main/java/com/reading/platform/entity/CourseActivity.java index ce52518..8b33a1f 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/CourseActivity.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/CourseActivity.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Course Activity Entity + * 课程活动实体 */ @Data @TableName("course_activities") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/CourseLesson.java b/reading-platform-java/src/main/java/com/reading/platform/entity/CourseLesson.java index 347121f..03b24e4 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/CourseLesson.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/CourseLesson.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Course Lesson Entity (chapters/sections within a course) + * 课程课时实体（课程内的章节/部分） */ @Data @TableName("course_lessons") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/CoursePackage.java b/reading-platform-java/src/main/java/com/reading/platform/entity/CoursePackage.java index fad4ca3..96ef704 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/CoursePackage.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/CoursePackage.java @@ -7,7 +7,7 @@ import java.math.BigDecimal; import java.time.LocalDateTime; /** - * Course Package Entity + * 课程包实体 */ @Data @TableName("course_packages") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/CourseResource.java b/reading-platform-java/src/main/java/com/reading/platform/entity/CourseResource.java index 0c58cf6..efc51e4 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/CourseResource.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/CourseResource.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Course Resource Entity + * 课程资源实体 */ @Data @TableName("course_resources") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/CourseScript.java b/reading-platform-java/src/main/java/com/reading/platform/entity/CourseScript.java index 0f0c662..3ce6c9a 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/CourseScript.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/CourseScript.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Course Script Entity + * 课程脚本实体 */ @Data @TableName("course_scripts") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/CourseScriptPage.java b/reading-platform-java/src/main/java/com/reading/platform/entity/CourseScriptPage.java index 854a1d1..5dd378c 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/CourseScriptPage.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/CourseScriptPage.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Course Script Page Entity + * 课程脚本页面实体 */ @Data @TableName("course_script_pages") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/CourseVersion.java b/reading-platform-java/src/main/java/com/reading/platform/entity/CourseVersion.java index b2593d0..eeadf27 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/CourseVersion.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/CourseVersion.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Course Version Entity + * 课程版本实体 */ @Data @TableName("course_versions") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/GrowthRecord.java b/reading-platform-java/src/main/java/com/reading/platform/entity/GrowthRecord.java index 83414cf..4696602 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/GrowthRecord.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/GrowthRecord.java @@ -7,7 +7,7 @@ import java.time.LocalDate; import java.time.LocalDateTime; /** - * Growth Record Entity + * 成长档案实体 */ @Data @TableName("growth_records") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/Lesson.java b/reading-platform-java/src/main/java/com/reading/platform/entity/Lesson.java index b9f7a99..b50a3cf 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/Lesson.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/Lesson.java @@ -8,7 +8,7 @@ import java.time.LocalDateTime; import java.time.LocalTime; /** - * Lesson Entity + * 课时实体 */ @Data @TableName("lessons") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/LessonFeedback.java b/reading-platform-java/src/main/java/com/reading/platform/entity/LessonFeedback.java index 4533cd8..456904b 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/LessonFeedback.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/LessonFeedback.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Lesson Feedback Entity + * 课时反馈实体 */ @Data @TableName("lesson_feedbacks") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/Notification.java b/reading-platform-java/src/main/java/com/reading/platform/entity/Notification.java index fe6bc58..bd72374 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/Notification.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/Notification.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Notification Entity + * 通知实体 */ @Data @TableName("notifications") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/OperationLog.java b/reading-platform-java/src/main/java/com/reading/platform/entity/OperationLog.java index 8bc3ca4..ccabd6c 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/OperationLog.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/OperationLog.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Operation Log Entity + * 操作日志实体 */ @Data @TableName("operation_logs") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/Parent.java b/reading-platform-java/src/main/java/com/reading/platform/entity/Parent.java index 702a250..df83189 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/Parent.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/Parent.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Parent Entity + * 家长实体 */ @Data @TableName("parents") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/ParentStudent.java b/reading-platform-java/src/main/java/com/reading/platform/entity/ParentStudent.java index b43a6e6..0ebb5dc 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/ParentStudent.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/ParentStudent.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Parent Student Relation Entity + * 家长-学生关联实体 */ @Data @TableName("parent_students") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/ResourceItem.java b/reading-platform-java/src/main/java/com/reading/platform/entity/ResourceItem.java index a0965ba..d7f188d 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/ResourceItem.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/ResourceItem.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Resource Item Entity + * 资源项实体 */ @Data @TableName("resource_items") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/ResourceLibrary.java b/reading-platform-java/src/main/java/com/reading/platform/entity/ResourceLibrary.java index c3b2969..25f0040 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/ResourceLibrary.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/ResourceLibrary.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Resource Library Entity + * 资源库实体 */ @Data @TableName("resource_libraries") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/SchedulePlan.java b/reading-platform-java/src/main/java/com/reading/platform/entity/SchedulePlan.java index ba00247..23fc971 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/SchedulePlan.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/SchedulePlan.java @@ -7,7 +7,7 @@ import java.time.LocalDate; import java.time.LocalDateTime; /** - * Schedule Plan Entity + * 课表计划实体 */ @Data @TableName("schedule_plans") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/ScheduleTemplate.java b/reading-platform-java/src/main/java/com/reading/platform/entity/ScheduleTemplate.java index 51866d3..d253773 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/ScheduleTemplate.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/ScheduleTemplate.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Schedule Template Entity + * 课表模板实体 */ @Data @TableName("schedule_templates") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/SchoolCourse.java b/reading-platform-java/src/main/java/com/reading/platform/entity/SchoolCourse.java index 2a01a26..b9e4570 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/SchoolCourse.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/SchoolCourse.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * School Course Entity (tenant-customized courses) + * 校本课程实体（租户自定义课程） */ @Data @TableName("school_courses") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/Student.java b/reading-platform-java/src/main/java/com/reading/platform/entity/Student.java index dba9f44..1943c8f 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/Student.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/Student.java @@ -7,7 +7,7 @@ import java.time.LocalDate; import java.time.LocalDateTime; /** - * Student Entity + * 学生实体 */ @Data @TableName("students") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/StudentClassHistory.java b/reading-platform-java/src/main/java/com/reading/platform/entity/StudentClassHistory.java index 4e40f05..62fbca5 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/StudentClassHistory.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/StudentClassHistory.java @@ -7,7 +7,7 @@ import java.time.LocalDate; import java.time.LocalDateTime; /** - * Student Class History Entity + * 学生班级历史实体 */ @Data @TableName("student_class_history") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/StudentRecord.java b/reading-platform-java/src/main/java/com/reading/platform/entity/StudentRecord.java index f545c5c..0063490 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/StudentRecord.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/StudentRecord.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Student Record Entity + * 学生记录实体 */ @Data @TableName("student_records") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/SystemSetting.java b/reading-platform-java/src/main/java/com/reading/platform/entity/SystemSetting.java index fc9ee2a..ad1d0b0 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/SystemSetting.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/SystemSetting.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * System Setting Entity + * 系统设置实体 */ @Data @TableName("system_settings") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/Tag.java b/reading-platform-java/src/main/java/com/reading/platform/entity/Tag.java index 6c8a3dc..8590ee8 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/Tag.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/Tag.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Tag Entity + * 标签实体 */ @Data @TableName("tags") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/Task.java b/reading-platform-java/src/main/java/com/reading/platform/entity/Task.java index f5dc5ca..78a8172 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/Task.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/Task.java @@ -7,7 +7,7 @@ import java.time.LocalDate; import java.time.LocalDateTime; /** - * Task Entity + * 任务实体 */ @Data @TableName("tasks") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/TaskCompletion.java b/reading-platform-java/src/main/java/com/reading/platform/entity/TaskCompletion.java index cb348fb..d0595ea 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/TaskCompletion.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/TaskCompletion.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Task Completion Entity + * 任务完成实体 */ @Data @TableName("task_completions") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/TaskTarget.java b/reading-platform-java/src/main/java/com/reading/platform/entity/TaskTarget.java index 3742555..c41b805 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/TaskTarget.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/TaskTarget.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Task Target Entity + * 任务目标实体 */ @Data @TableName("task_targets") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/TaskTemplate.java b/reading-platform-java/src/main/java/com/reading/platform/entity/TaskTemplate.java index 9181146..c9a751d 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/TaskTemplate.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/TaskTemplate.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Task Template Entity + * 任务模板实体 */ @Data @TableName("task_templates") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/Teacher.java b/reading-platform-java/src/main/java/com/reading/platform/entity/Teacher.java index e8e7fde..13167e2 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/Teacher.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/Teacher.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Teacher Entity + * 教师实体 */ @Data @TableName("teachers") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/Tenant.java b/reading-platform-java/src/main/java/com/reading/platform/entity/Tenant.java index bc8580e..7d1100a 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/Tenant.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/Tenant.java @@ -9,7 +9,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Tenant Entity + * 租户实体（幼儿园/机构） */ @Data @TableName("tenants") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/TenantCourse.java b/reading-platform-java/src/main/java/com/reading/platform/entity/TenantCourse.java index c9a868d..92fb2f2 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/TenantCourse.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/TenantCourse.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Tenant Course Entity + * 租户-课程关联实体 */ @Data @TableName("tenant_courses") diff --git a/reading-platform-java/src/main/java/com/reading/platform/entity/Theme.java b/reading-platform-java/src/main/java/com/reading/platform/entity/Theme.java index fa2b779..b8b32f3 100644 --- a/reading-platform-java/src/main/java/com/reading/platform/entity/Theme.java +++ b/reading-platform-java/src/main/java/com/reading/platform/entity/Theme.java @@ -6,7 +6,7 @@ import lombok.Data; import java.time.LocalDateTime; /** - * Theme Entity + * 主题实体 */ @Data @TableName("themes")