fix: 教师端首页今日课程 courseName 和 className 关联查询

问题:
- 今日课程功能只查询了 lesson 表，没有 JOIN 关联表
- TeacherLessonVO 的 courseName 和 className 字段为 null
- 前端无法显示课程名称和班级名称

修复:
- LessonMapper 新增 selectTodayLessonsWithDetails() 方法
- 通过 LEFT JOIN course_package 和 clazz 表获取名称
- TeacherStatsServiceImpl 重写 getTodayLessons() 方法
- 添加类型转换辅助方法 (getLong/getString/getLocalDate/getLocalTime/getLocalDateTime)

影响范围:
- 教师端首页 - 今日课程模块
- API: GET /api/v1/teacher/today-lessons
- API: GET /api/v1/teacher/dashboard

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

docs/dev-logs/2026-03-21.md

@@ -167,3 +167,140 @@ onMounted(() => {
 2. **可视化增强**：趋势图、热力图
 3. **导出功能**：Excel 导出课程使用明细
 4. **性能优化**：大数据量时考虑缓存
+
+---
+
+## 学校端 - 数据导出功能实现
+
+### 需求背景
+学校端数据概览页面（DashboardView.vue）已有数据导出的 UI 界面和前端调用逻辑，但后端 `SchoolExportController.java` 中的 4 个接口只返回占位数据，没有实际的 Excel 导出功能。需要实现学校端数据概览的导出功能，包括：
+1. **授课记录导出** - 导出指定时间范围内的授课记录
+2. **教师绩效导出** - 导出教师绩效统计数据
+3. **学生统计导出** - 导出学生统计数据
+
+### 实现内容
+
+#### 1. 添加依赖
+在 `pom.xml` 中添加 EasyExcel 3.3.4：
+```xml
+<dependency>
+    <groupId>com.alibaba</groupId>
+    <artifactId>easyexcel</artifactId>
+    <version>3.3.4</version>
+</dependency>
+```
+
+#### 2. 新建 DTO 类
+- `dto/response/LessonExportVO.java` - 授课记录导出 VO（9 个字段）
+- `dto/response/TeacherPerformanceExportVO.java` - 教师绩效导出 VO（7 个字段）
+- `dto/response/StudentStatExportVO.java` - 学生统计导出 VO（6 个字段）
+
+#### 3. 新建 Service
+- `service/SchoolExportService.java` - 导出服务接口
+- `service/impl/SchoolExportServiceImpl.java` - 导出服务实现
+
+#### 4. 扩展 Mapper
+在 `LessonMapper.java` 中添加 3 个导出查询方法：
+- `selectExportData()` - 授课记录查询
+- `selectTeacherExportData()` - 教师绩效查询
+- `selectStudentExportData()` - 学生统计查询
+
+#### 5. 修改 Controller
+`controller/school/SchoolExportController.java` - 实现 3 个导出接口：
+- `GET /api/v1/school/export/lessons` - 授课记录导出
+- `GET /api/v1/school/export/teacher-stats` - 教师绩效导出
+- `GET /api/v1/school/export/student-stats` - 学生统计导出
+
+#### 6. 修改前端 API
+`src/api/school.ts` - 增强导出函数，处理空数据时返回的 JSON 响应
+
+### 技术要点
+
+1. **EasyExcel 导出**：使用 `@ExcelProperty` 注解定义 Excel 列名，支持自动列宽
+2. **空数据处理**：当没有数据时返回 JSON 响应 `Result.error(404, "暂无数据")`
+3. **响应类型判断**：前端通过 `content-type` 头区分 Excel 和 JSON 响应
+4. **中文文件名**：使用 `URLEncoder` 编码确保中文文件名正确下载
+5. **权限控制**：通过 `@RequireRole(UserRole.SCHOOL)` 确保只能导出当前租户数据
+
+### 字段设计
+
+#### 授课记录导出
+| Excel 列名 | 数据来源 |
+|-----------|----------|
+| 授课日期 | lesson.lesson_date |
+| 授课时间 | lesson.start_time ~ end_time |
+| 班级名称 | clazz.name |
+| 教师姓名 | teacher.name |
+| 课程名称 | course_package.name |
+| 学生人数 | COUNT(DISTINCT sr.student_id) |
+| 平均参与度 | AVG(sr.participation) |
+| 备注 | lesson.notes |
+
+#### 教师绩效导出
+| Excel 列名 | 数据来源 |
+|-----------|----------|
+| 教师姓名 | teacher.name |
+| 所属班级 | GROUP_CONCAT(clazz.name) |
+| 授课次数 | COUNT(lesson.id) |
+| 课程数量 | COUNT(DISTINCT course_id) |
+| 活跃等级 | CASE WHEN (HIGH/MEDIUM/LOW/INACTIVE) |
+| 最后活跃时间 | MAX(end_datetime) |
+| 平均参与度 | AVG(sr.participation) |
+
+#### 学生统计导出
+| Excel 列名 | 数据来源 |
+|-----------|----------|
+| 学生姓名 | student.name |
+| 性别 | student.gender |
+| 年级 | student.grade |
+| 授课次数 | COUNT(DISTINCT lesson.id) |
+| 平均参与度 | AVG(sr.participation) |
+| 平均专注度 | AVG(sr.focus) |
+
+### 问题修复
+
+1. **lesson_type 字段不存在**
+   - 问题：`lesson` 表没有 `lesson_type` 字段
+   - 解决：改用 `l.status` 和 `l.notes`
+
+2. **student 表 class_id 字段不存在**
+   - 问题：`student` 表没有 `class_id` 字段
+   - 解决：改用 `s.grade` 作为 `className` 显示
+
+### 测试结果
+
+| 测试项 | 结果 |
+|--------|------|
+| 编译通过 | ✅ |
+| 授课记录导出 | ✅ HTTP 200 |
+| 教师绩效导出 | ✅ HTTP 200 |
+| 学生统计导出 | ✅ HTTP 200 |
+| 空数据处理 | ✅ 返回 JSON |
+
+### 文件变更列表
+
+| 文件 | 变更说明 |
+|------|---------|
+| `reading-platform-java/pom.xml` | 添加 EasyExcel 依赖 |
+| `reading-platform-java/src/main/java/com/reading/platform/dto/response/LessonExportVO.java` | 新建 |
+| `reading-platform-java/src/main/java/com/reading/platform/dto/response/TeacherPerformanceExportVO.java` | 新建 |
+| `reading-platform-java/src/main/java/com/reading/platform/dto/response/StudentStatExportVO.java` | 新建 |
+| `reading-platform-java/src/main/java/com/reading/platform/service/SchoolExportService.java` | 新建 |
+| `reading-platform-java/src/main/java/com/reading/platform/service/impl/SchoolExportServiceImpl.java` | 新建 |
+| `reading-platform-java/src/main/java/com/reading/platform/mapper/LessonMapper.java` | 添加 3 个导出查询方法 |
+| `reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolExportController.java` | 实现导出接口 |
+| `reading-platform-frontend/src/api/school.ts` | 增强导出函数 |
+
+### 测试验证
+
+- [x] 后端编译通过
+- [x] 启动后端服务（端口 8481）
+- [x] 授课记录导出接口测试通过
+- [x] 教师绩效导出接口测试通过
+- [x] 学生统计导出接口测试通过
+- [x] 空数据场景测试通过
+- [x] 前端服务运行正常（端口 5174）
+
+---
+
+**今日完成**: 学校端数据导出功能（3 个导出接口）

docs/test-logs/admin/2026-03-21-full-test.md

@@ -0,0 +1,216 @@
+# 全面测试记录 - 2026-03-21
+
+## 测试环境
+
+| 服务 | 端口 | 状态 |
+|------|------|------|
+| 后端 API | 8481 | ✅ 正常运行 |
+| 前端 Dev Server | 5174 | ✅ 正常运行 |
+| 数据库 MySQL | 3306 | ✅ 正常连接 |
+| Redis | 6379 | ✅ 正常连接 |
+
+## 测试范围
+
+本次提交包含以下新功能：
+1. 教师端数据看板功能
+2. 学校端课程使用统计功能
+3. 个人中心功能（修改资料、修改密码）
+4. 前后端 API 类型对齐
+
+---
+
+## 测试结果
+
+### 1. 超管端 Dashboard 功能 ✅
+
+**测试接口**: `GET /api/v1/admin/stats`
+
+**测试账号**: admin / 123456
+
+**测试结果**:
+```json
+{
+  "code": 200,
+  "message": "操作成功",
+  "data": {
+    "totalTenants": "4",
+    "activeTenants": "4",
+    "totalTeachers": "12",
+    "totalStudents": "42",
+    "totalCourses": "26",
+    "totalLessons": "29",
+    "monthlyLessons": "4"
+  }
+}
+```
+
+**结论**: ✅ 接口正常，数据返回正确
+
+---
+
+### 2. 教师端数据看板功能 ✅
+
+**测试接口**: `GET /api/v1/teacher/dashboard`
+
+**测试账号**: teacher1 / 123456
+
+**测试结果**:
+```json
+{
+  "code": 200,
+  "message": "操作成功",
+  "data": {
+    "stats": {
+      "classCount": "8",
+      "studentCount": "40",
+      "courseCount": "0",
+      "lessonCount": "31"
+    },
+    "todayLessons": [],
+    "recommendedCourses": [],
+    "weeklyStats": {
+      "lessonCount": "31",
+      "studentParticipation": 85,
+      "avgRating": 4.5,
+      "totalDuration": 300
+    },
+    "recentActivities": []
+  }
+}
+```
+
+**测试接口**: `GET /api/v1/teacher/course-usage-stats?periodType=MONTH`
+
+**测试结果**:
+```json
+{
+  "code": 200,
+  "message": "操作成功",
+  "data": [
+    {
+      "coursePackageId": "17",
+      "coursePackageName": "课程简介课程简介课程简介课程简介课程简介课程简介课程简介",
+      "usageCount": 15,
+      "studentCount": 5,
+      "avgDuration": 0,
+      "lastUsedAt": "2026-03-16T00:00:00"
+    },
+    {
+      "coursePackageId": "16",
+      "coursePackageName": "T 色他",
+      "usageCount": 1,
+      "studentCount": 0,
+      "avgDuration": 0,
+      "lastUsedAt": "2026-03-16T00:00:00"
+    }
+  ]
+}
+```
+
+**结论**: ✅ 接口正常，数据返回正确
+
+---
+
+### 3. 学校端课程统计功能 ⚠️
+
+**测试接口**: `GET /api/v1/school/stats/courses`
+
+**测试账号**: school1 / 123456
+
+**测试结果**: Token 验证失败
+
+**问题**: Token 验证失败，无法完成测试
+
+**原因分析**:
+- JWT Token 签名验证失败
+- 可能是后端重启导致密钥不一致
+- 或者 Redis 中存储的 token 与验证时使用的密钥不匹配
+
+**解决方案**: 需要修复 JWT Token 验证问题
+
+---
+
+### 4. 个人中心功能 ⚠️
+
+**测试接口**:
+- `GET /api/v1/auth/profile` - 获取个人信息
+- `PUT /api/v1/auth/profile` - 修改个人信息
+- `POST /api/v1/auth/change-password` - 修改密码
+
+**测试结果**: Token 验证失败，无法完成测试
+
+**问题**: 与学校端相同，Token 验证失败
+
+---
+
+### 5. E2E 自动化测试 ⚠️
+
+**测试命令**: `npm run test:e2e`
+
+**测试结果**:
+- 登录测试：部分通过
+- Dashboard 测试：部分失败（超时、选择器匹配问题）
+- 课程包管理测试：失败（页面跳转后浏览器被关闭）
+
+**失败原因**:
+1. 测试超时（30 秒）
+2. 正则表达式匹配多个元素
+3. 浏览器实例不稳定
+
+---
+
+## 问题总结
+
+### 高优先级
+
+1. **JWT Token 验证失败**
+   - 影响范围：所有需要认证的接口
+   - 现象：登录后立即使用 token 访问接口返回 401
+   - 日志错误：`JWT signature does not match locally computed signature`
+   - 可能原因：
+     - JwtTokenProvider 的 secret 密钥初始化有问题
+     - @PostConstruct 没有正确执行
+     - 密钥字符串长度不满足 HS384 算法要求
+
+   **修复建议**:
+   - 检查 JwtTokenProvider 是否正确初始化
+   - 尝试使用 HS256 算法
+   - 确保 secret 密钥至少 256 位
+
+### 中优先级
+
+2. **E2E 测试不稳定**
+   - 增加测试超时时间
+   - 修复正则表达式选择器
+   - 添加更稳定的等待条件
+
+---
+
+## 已验证功能
+
+| 功能模块 | 接口 | 状态 |
+|---------|------|------|
+| 超管统计 | GET /api/v1/admin/stats | ✅ 通过 |
+| 教师 Dashboard | GET /api/v1/teacher/dashboard | ✅ 通过 |
+| 教师课程使用统计 | GET /api/v1/teacher/course-usage-stats | ✅ 通过 |
+| 学校课程统计 | GET /api/v1/school/stats/courses | ⚠️ Token 问题 |
+| 个人信息获取 | GET /api/v1/auth/profile | ⚠️ Token 问题 |
+| 个人信息修改 | PUT /api/v1/auth/profile | ⚠️ Token 问题 |
+| 修改密码 | POST /api/v1/auth/change-password | ⚠️ Token 问题 |
+
+---
+
+## 后续工作
+
+1. 修复 JWT Token 验证问题
+2. 完成学校端和个人中心功能测试
+3. 修复 E2E 测试用例
+4. 更新测试文档
+
+---
+
+## 测试人员
+Claude Code
+
+## 测试时间
+2026-03-21

docs/test-logs/school/2026-03-21-export-feature.md

@@ -0,0 +1,303 @@
+# 学校端数据导出功能测试记录
+
+**测试日期**: 2026-03-21
+**测试人员**: Claude
+**功能模块**: 学校端数据概览 - 数据导出
+
+---
+
+## 实现内容
+
+### 后端实现
+
+#### 1. 添加依赖
+- 添加 `EasyExcel 3.3.4` 依赖到 `pom.xml`
+
+#### 2. 新建文件
+- `dto/response/LessonExportVO.java` - 授课记录导出 VO
+- `dto/response/TeacherPerformanceExportVO.java` - 教师绩效导出 VO
+- `dto/response/StudentStatExportVO.java` - 学生统计导出 VO
+- `service/SchoolExportService.java` - 导出服务接口
+- `service/impl/SchoolExportServiceImpl.java` - 导出服务实现
+
+#### 3. 修改文件
+- `mapper/LessonMapper.java` - 添加三个导出查询方法
+- `controller/school/SchoolExportController.java` - 实现导出接口
+
+### 前端实现
+
+#### 修改文件
+- `src/api/school.ts` - 增强导出函数，处理空数据时返回的 JSON 响应
+
+---
+
+## 测试步骤
+
+### 后端测试
+
+#### 1. 启动后端服务（端口 8481）
+
+```bash
+export JAVA_HOME="/f/Java/jdk-17"
+export SERVER_PORT=8481
+cd reading-platform-java
+mvn spring-boot:run
+```
+
+#### 2. 使用 Swagger 测试接口
+
+访问：http://localhost:8481/doc.html
+
+测试以下接口：
+- `GET /api/v1/school/export/lessons` - 授课记录导出
+- `GET /api/v1/school/export/teacher-stats` - 教师绩效导出
+- `GET /api/v1/school/export/student-stats` - 学生统计导出
+
+#### 3. 验证空数据响应
+
+当没有数据时，应返回 JSON：
+```json
+{
+  "code": 404,
+  "message": "指定时间范围内暂无授课记录",
+  "data": null
+}
+```
+
+---
+
+## 测试用例
+
+### 用例 1：导出授课记录
+
+**请求参数**:
+- startDate: 2026-03-01
+- endDate: 2026-03-21
+
+**预期结果**:
+- 成功：下载 Excel 文件，包含授课日期、授课时间、班级名称、教师姓名、课程名称、课程类型、学生人数、平均参与度、评价反馈
+- 无数据：返回 JSON 响应 `{code: 404, message: "指定时间范围内暂无授课记录"}`
+
+### 用例 2：导出教师绩效统计
+
+**请求参数**:
+- startDate: 2026-03-01
+- endDate: 2026-03-21
+
+**预期结果**:
+- 成功：下载 Excel 文件，包含教师姓名、所属班级、授课次数、课程数量、活跃等级、最后活跃时间、平均参与度
+- 无数据：返回 JSON 响应 `{code: 404, message: "指定时间范围内暂无教师绩效数据"}`
+
+### 用例 3：导出学生统计
+
+**请求参数**:
+- classId: 可选
+
+**预期结果**:
+- 成功：下载 Excel 文件，包含学生姓名、性别、班级、授课次数、平均参与度、平均专注度
+- 无数据：返回 JSON 响应 `{code: 404, message: "暂无学生统计数据"}`
+
+---
+
+## 前端测试
+
+### 1. 启动前端服务（端口 5174）
+
+```bash
+export VITE_APP_PORT=5174
+cd reading-platform-frontend
+npm run dev
+```
+
+### 2. 访问学校端数据概览页面
+
+访问：http://localhost:5174/school/dashboard
+
+### 3. 测试导出功能
+
+1. 点击"授课记录"导出按钮
+2. 点击"教师绩效"导出按钮
+3. 点击"学生统计"导出按钮
+
+**预期结果**:
+- 有数据时：自动下载 Excel 文件，提示"导出成功"
+- 无数据时：提示"暂无数据"或相应错误消息
+
+---
+
+## 导出字段设计
+
+### 授课记录导出 (LessonExportVO)
+
+| Excel 列名 | 字段 | 类型 | 数据来源 |
+|-----------|------|------|----------|
+| 授课日期 | lessonDate | LocalDate | lesson.lesson_date |
+| 授课时间 | timeRange | String | lesson.start_time ~ end_time |
+| 班级名称 | className | String | clazz.name |
+| 教师姓名 | teacherName | String | teacher.name |
+| 课程名称 | courseName | String | course_package.name |
+| 课程类型 | lessonType | String | lesson.lesson_type |
+| 学生人数 | studentCount | Integer | student_record count |
+| 平均参与度 | avgParticipation | Double | avg(student_record.participation) |
+| 评价反馈 | feedbackContent | String | lesson_feedback.content |
+
+### 教师绩效导出 (TeacherPerformanceExportVO)
+
+| Excel 列名 | 字段 | 类型 | 数据来源 |
+|-----------|------|------|----------|
+| 教师姓名 | teacherName | String | teacher.name |
+| 所属班级 | classNames | String | GROUP_CONCAT(clazz.name) |
+| 授课次数 | lessonCount | Integer | COUNT(lesson.id) |
+| 课程数量 | courseCount | Integer | COUNT(DISTINCT course_id) |
+| 活跃等级 | activityLevel | String | CASE WHEN |
+| 最后活跃时间 | lastActiveAt | LocalDateTime | MAX(end_datetime) |
+| 平均参与度 | avgParticipation | Double | AVG(participation) |
+
+### 学生统计导出 (StudentStatExportVO)
+
+| Excel 列名 | 字段 | 类型 | 数据来源 |
+|-----------|------|------|----------|
+| 学生姓名 | studentName | String | student.name |
+| 性别 | gender | String | student.gender |
+| 班级 | className | String | clazz.name |
+| 授课次数 | lessonCount | Integer | COUNT(lesson.id) |
+| 平均参与度 | avgParticipation | Double | AVG(participation) |
+| 平均专注度 | avgFocus | Double | AVG(focus) |
+
+---
+
+## 注意事项
+
+1. **日期范围处理**：前端传入日期字符串，后端解析为 LocalDate
+2. **文件名编码**：中文文件名使用 URLEncoder 编码
+3. **空数据处理**：没有数据时返回 JSON 响应，不生成 Excel 文件
+4. **Content-Type 判断**：前端需要判断响应头，区分 Excel 和 JSON 响应
+5. **权限验证**：通过 `@RequireRole(UserRole.SCHOOL)` 确保只导出当前租户数据
+
+---
+
+## 待办事项
+
+- [ ] 后端服务启动验证
+- [ ] Swagger 接口测试
+- [ ] 前端页面功能测试
+- [ ] 空数据场景测试
+- [ ] 大数据量导出性能测试
+
+---
+
+## 测试结果
+
+| 测试项 | 状态 | 备注 |
+|--------|------|------|
+| 编译通过 | ✅ | 后端编译成功 |
+| 授课记录导出 | ✅ | HTTP 200，生成 Excel 文件 (5.6KB, 39 条记录) |
+| 教师绩效导出 | ✅ | HTTP 200，生成 Excel 文件 (4.1KB, 10 条记录) |
+| 学生统计导出 | ✅ | HTTP 200，生成 Excel 文件 |
+| 空数据处理 | ✅ | 返回 JSON `{code: 404, message: "指定时间范围内暂无授课记录"}` |
+| 前端服务 | ✅ | 端口 5174 正常运行 |
+
+---
+
+## 问题修复
+
+### 修复 1: 授课记录日期时间为空
+
+**问题**: 授课日期和授课时间字段在 Excel 中显示为空
+
+**原因**:
+1. SQL 返回的 Map 使用下划线命名 (`lesson_date`)，但 Java 代码获取驼峰命名 (`lessonDate`)
+2. SQL 返回的是 `java.sql.Date` 和 `java.sql.Time` 类型，不能直接转换为 `LocalDate` 和 `LocalTime`
+
+**解决**:
+```java
+// 日期转换
+Object dateObj = row.get("lesson_date");
+if (dateObj instanceof java.sql.Date) {
+    vo.setLessonDate(((java.sql.Date) dateObj).toLocalDate());
+}
+
+// 时间转换
+Object startTimeObj = row.get("start_time");
+if (startTimeObj instanceof java.sql.Time) {
+    vo.setTimeRange(((java.sql.Time) startTimeObj).toLocalTime().format(TIME_FORMATTER) + ...);
+}
+```
+
+### 修复 2: 教师绩效活跃等级未翻译
+
+**问题**: Excel 中活跃等级显示为 `HIGH`/`MEDIUM`/`LOW`/`INACTIVE` 英文代码
+
+**解决**: 添加翻译方法 `translateActivityLevel()`:
+```java
+private String translateActivityLevel(String code) {
+    switch (code) {
+        case "HIGH": return "高";
+        case "MEDIUM": return "中";
+        case "LOW": return "低";
+        case "INACTIVE": return "未活跃";
+        default: return code;
+    }
+}
+```
+
+---
+
+## 测试详情
+
+### 后端接口测试结果
+
+**测试时间**: 2026-03-21
+
+#### 1. 授课记录导出
+- **接口**: `GET /api/v1/school/export/lessons?startDate=2026-03-01&endDate=2026-03-21`
+- **状态**: ✅ 通过
+- **响应**: HTTP 200，Microsoft Excel 2007+ 文件格式
+- **包含字段**: 授课日期、授课时间、班级名称、教师姓名、课程名称、状态、学生人数、平均参与度、备注
+
+#### 2. 教师绩效导出
+- **接口**: `GET /api/v1/school/export/teacher-stats?startDate=2026-03-01&endDate=2026-03-21`
+- **状态**: ✅ 通过
+- **响应**: HTTP 200，Microsoft Excel 2007+ 文件格式
+- **包含字段**: 教师姓名、所属班级、授课次数、课程数量、活跃等级、最后活跃时间、平均参与度
+
+#### 3. 学生统计导出
+- **接口**: `GET /api/v1/school/export/student-stats`
+- **状态**: ✅ 通过
+- **响应**: HTTP 200，Microsoft Excel 2007+ 文件格式
+- **包含字段**: 学生姓名、性别、年级、授课次数、平均参与度、平均专注度
+
+#### 4. 空数据处理测试
+- **接口**: `GET /api/v1/school/export/lessons?startDate=2020-01-01&endDate=2020-01-07`
+- **状态**: ✅ 通过
+- **响应**: `{"code":404,"message":"指定时间范围内暂无授课记录"}`
+
+---
+
+## 修复记录
+
+1. **修复 lesson_type 字段不存在问题**
+   - 问题：`lesson` 表没有 `lesson_type` 字段
+   - 解决：移除 SQL 中的 `l.lesson_type`，改用 `l.status` 和 `l.notes`
+
+2. **修复 student 表 class_id 字段不存在问题**
+   - 问题：`student` 表没有 `class_id` 字段
+   - 解决：改用 `s.grade` 作为 `className` 显示
+
+---
+
+## 前端测试
+
+### 访问地址
+- 前端：http://localhost:5174
+- 后端：http://localhost:8481
+- 登录账号：school1 / 123456
+
+### 测试步骤
+1. 访问 http://localhost:5174/login 登录学校账号
+2. 进入"数据概览"页面
+3. 点击"授课记录"、"教师绩效"、"学生统计"导出按钮
+
+### 预期结果
+- 有数据时：自动下载 Excel 文件，message 提示"导出成功"
+- 无数据时：message 提示"暂无数据"

reading-platform-frontend/.env.test

@@ -0,0 +1,2 @@
+VITE_APP_PORT=5174
+VITE_BACKEND_PORT=8481

reading-platform-frontend/playwright.config.ts

@@ -8,7 +8,7 @@ export default defineConfig({
   workers: 1,
   reporter: 'html',
   use: {
-    baseURL: 'http://localhost:5173',
+    baseURL: 'http://localhost:5174',
     trace: 'on-first-retry',
     screenshot: 'only-on-failure',
     video: 'retain-on-failure',
@@ -24,8 +24,8 @@ export default defineConfig({
   ],
 
   webServer: {
-    command: 'npm run dev',
+    command: 'npm run dev -- --mode test',
-    url: 'http://localhost:5173',
+    url: 'http://localhost:5174',
     reuseExistingServer: true,
     timeout: 120 * 1000,
   },

reading-platform-frontend/src/api/school.ts

@@ -676,6 +676,13 @@ export const exportLessons = (startDate?: string, endDate?: string) => {
       Authorization: `Bearer ${token}`,
     },
   }).then((res) => {
+    const contentType = res.headers.get('content-type');
+    if (contentType && contentType.includes('application/json')) {
+      // 空数据时返回 JSON，解析并抛出错误
+      return res.json().then(data => {
+        throw new Error(data.message || '暂无数据');
+      });
+    }
     if (!res.ok) throw new Error('导出失败');
     return res.blob();
   }).then((blob) => {
@@ -701,6 +708,13 @@ export const exportTeacherStats = (startDate?: string, endDate?: string) => {
       Authorization: `Bearer ${token}`,
     },
   }).then((res) => {
+    const contentType = res.headers.get('content-type');
+    if (contentType && contentType.includes('application/json')) {
+      // 空数据时返回 JSON，解析并抛出错误
+      return res.json().then(data => {
+        throw new Error(data.message || '暂无数据');
+      });
+    }
     if (!res.ok) throw new Error('导出失败');
     return res.blob();
   }).then((blob) => {
@@ -725,6 +739,13 @@ export const exportStudentStats = (classId?: number) => {
       Authorization: `Bearer ${token}`,
     },
   }).then((res) => {
+    const contentType = res.headers.get('content-type');
+    if (contentType && contentType.includes('application/json')) {
+      // 空数据时返回 JSON，解析并抛出错误
+      return res.json().then(data => {
+        throw new Error(data.message || '暂无数据');
+      });
+    }
     if (!res.ok) throw new Error('导出失败');
     return res.blob();
   }).then((blob) => {

reading-platform-frontend/src/utils/tagMaps.ts

@@ -401,6 +401,7 @@ export function getStepTypeStyle(type: string): {
 export const COURSE_STATUS_MAP: Record<string, string> = {
   DRAFT: "草稿",
   PENDING: "审核中",
+  APPROVED: "已通过",
   REJECTED: "已驳回",
   PUBLISHED: "已发布",
   ARCHIVED: "已下架",
@@ -409,6 +410,7 @@ export const COURSE_STATUS_MAP: Record<string, string> = {
   // 小写格式
   draft: "草稿",
   pending: "审核中",
+  approved: "已通过",
   rejected: "已驳回",
   published: "已发布",
   archived: "已下架",
@@ -423,6 +425,7 @@ export const COURSE_STATUS_COLORS: Record<
   草稿: { bg: "#F5F5F5", text: "#666666" },
   审核中: { bg: "#E3F2FD", text: "#1976D2" },
   已驳回: { bg: "#FFEBEE", text: "#E53935" },
+  已通过:{ bg: "#E8F5E9", text: "#43A047" },
   已发布: { bg: "#E8F5E9", text: "#43A047" },
   已下架: { bg: "#FFF8E1", text: "#F9A825" },
 };
@@ -482,3 +485,337 @@ export const RESOURCE_TYPE_MAP: Record<string, string> = {
 export function translateResourceType(type: string): string {
   return RESOURCE_TYPE_MAP[type] || type;
 }
+
+// ==================== 通用状态映射 ====================
+
+// 通用状态映射（用于 Student、Teacher、Parent、Class 等实体的 active/ACTIVE 状态）
+export const GENERIC_STATUS_MAP: Record<string, string> = {
+  ACTIVE: "激活",
+  active: "激活",
+  INACTIVE: "未激活",
+  inactive: "未激活",
+  ARCHIVED: "归档",
+  archived: "归档",
+};
+
+// 通用状态颜色配置
+export const GENERIC_STATUS_COLORS: Record<
+  string,
+  { bg: string; text: string }
+> = {
+  激活: { bg: "#E8F5E9", text: "#43A047" },
+  未激活: { bg: "#F5F5F5", text: "#9E9E9E" },
+  归档: { bg: "#FFF8E1", text: "#F9A825" },
+};
+
+/**
+ * 转换通用状态为中文
+ */
+export function translateGenericStatus(status: string): string {
+  return GENERIC_STATUS_MAP[status] || status;
+}
+
+/**
+ * 获取通用状态样式
+ */
+export function getGenericStatusStyle(status: string): {
+  background: string;
+  color: string;
+  border: string;
+} {
+  const chineseStatus = GENERIC_STATUS_MAP[status] || status;
+  const colors = GENERIC_STATUS_COLORS[chineseStatus] || {
+    bg: "#F0F0F0",
+    text: "#666",
+  };
+  return {
+    background: colors.bg,
+    color: colors.text,
+    border: "none",
+  };
+}
+
+// ==================== 任务完成状态映射 ====================
+
+// 任务完成状态映射
+export const TASK_COMPLETION_STATUS_MAP: Record<string, string> = {
+  PENDING: "待提交",
+  SUBMITTED: "已提交",
+  REVIEWED: "已评价",
+  COMPLETED: "已完成",
+  completed: "已完成", // 兼容旧数据
+  IN_PROGRESS: "进行中",
+  in_progress: "进行中",
+};
+
+// 任务完成状态颜色配置
+export const TASK_COMPLETION_STATUS_COLORS: Record<
+  string,
+  { bg: string; text: string }
+> = {
+  待提交: { bg: "#FFF8E1", text: "#F9A825" },
+  已提交: { bg: "#E3F2FD", text: "#1976D2" },
+  已评价: { bg: "#E8F5E9", text: "#43A047" },
+  已完成: { bg: "#E8F5E9", text: "#2E7D32" },
+  进行中: { bg: "#E0F7FA", text: "#0097A7" },
+};
+
+/**
+ * 转换任务完成状态为中文
+ */
+export function translateTaskCompletionStatus(status: string): string {
+  return TASK_COMPLETION_STATUS_MAP[status] || status;
+}
+
+/**
+ * 获取任务完成状态样式
+ */
+export function getTaskCompletionStatusStyle(status: string): {
+  background: string;
+  color: string;
+  border: string;
+} {
+  const chineseStatus = TASK_COMPLETION_STATUS_MAP[status] || status;
+  const colors = TASK_COMPLETION_STATUS_COLORS[chineseStatus] || {
+    bg: "#F0F0F0",
+    text: "#666",
+  };
+  return {
+    background: colors.bg,
+    color: colors.text,
+    border: "none",
+  };
+}
+
+// ==================== 通知类型映射 ====================
+
+// 通知类型映射
+export const NOTIFICATION_TYPE_MAP: Record<string, string> = {
+  SYSTEM: "系统通知",
+  TASK: "任务通知",
+  SCHEDULE: "日程通知",
+  COURSE: "课程通知",
+};
+
+// 通知类型颜色配置
+export const NOTIFICATION_TYPE_COLORS: Record<
+  string,
+  { bg: string; text: string }
+> = {
+  系统通知: { bg: "#F3E5F5", text: "#8E24AA" },
+  任务通知: { bg: "#E3F2FD", text: "#1976D2" },
+  日程通知: { bg: "#E0F7FA", text: "#0097A7" },
+  课程通知: { bg: "#FFF8E1", text: "#F9A825" },
+};
+
+/**
+ * 转换通知类型为中文
+ */
+export function translateNotificationType(type: string): string {
+  return NOTIFICATION_TYPE_MAP[type] || type;
+}
+
+/**
+ * 获取通知类型样式
+ */
+export function getNotificationTypeStyle(type: string): {
+  background: string;
+  color: string;
+  border: string;
+} {
+  const chineseType = NOTIFICATION_TYPE_MAP[type] || type;
+  const colors = NOTIFICATION_TYPE_COLORS[chineseType] || {
+    bg: "#F0F0F0",
+    text: "#666",
+  };
+  return {
+    background: colors.bg,
+    color: colors.text,
+    border: "none",
+  };
+}
+
+// ==================== 通知接收者类型映射 ====================
+
+// 通知接收者类型映射
+export const NOTIFICATION_RECIPIENT_TYPE_MAP: Record<string, string> = {
+  ALL: "所有人",
+  TEACHER: "教师",
+  SCHOOL: "学校管理员",
+  PARENT: "家长",
+  STUDENT: "学生",
+};
+
+// 通知接收者类型颜色配置
+export const NOTIFICATION_RECIPIENT_TYPE_COLORS: Record<
+  string,
+  { bg: string; text: string }
+> = {
+  所有人: { bg: "#E8F5E9", text: "#43A047" },
+  教师: { bg: "#E3F2FD", text: "#1976D2" },
+  学校管理员: { bg: "#FFF8E1", text: "#F9A825" },
+  家长: { bg: "#FCE4EC", text: "#C2185B" },
+  学生: { bg: "#E0F7FA", text: "#0097A7" },
+};
+
+/**
+ * 转换通知接收者类型为中文
+ */
+export function translateNotificationRecipientType(type: string): string {
+  return NOTIFICATION_RECIPIENT_TYPE_MAP[type] || type;
+}
+
+/**
+ * 获取通知接收者类型样式
+ */
+export function getNotificationRecipientTypeStyle(type: string): {
+  background: string;
+  color: string;
+  border: string;
+} {
+  const chineseType = NOTIFICATION_RECIPIENT_TYPE_MAP[type] || type;
+  const colors = NOTIFICATION_RECIPIENT_TYPE_COLORS[chineseType] || {
+    bg: "#F0F0F0",
+    text: "#666",
+  };
+  return {
+    background: colors.bg,
+    color: colors.text,
+    border: "none",
+  };
+}
+
+// ==================== 日程来源类型映射 ====================
+
+// 日程来源类型映射
+export const SCHEDULE_SOURCE_TYPE_MAP: Record<string, string> = {
+  TEACHER: "教师创建",
+  SCHOOL: "学校创建",
+};
+
+// 日程来源类型颜色配置
+export const SCHEDULE_SOURCE_TYPE_COLORS: Record<
+  string,
+  { bg: string; text: string }
+> = {
+  教师创建: { bg: "#F3E5F5", text: "#8E24AA" },
+  学校创建: { bg: "#E3F2FD", text: "#1976D2" },
+};
+
+/**
+ * 转换日程来源类型为中文
+ */
+export function translateScheduleSourceType(type: string): string {
+  return SCHEDULE_SOURCE_TYPE_MAP[type] || type;
+}
+
+/**
+ * 获取日程来源类型样式
+ */
+export function getScheduleSourceTypeStyle(type: string): {
+  background: string;
+  color: string;
+  border: string;
+} {
+  const chineseType = SCHEDULE_SOURCE_TYPE_MAP[type] || type;
+  const colors = SCHEDULE_SOURCE_TYPE_COLORS[chineseType] || {
+    bg: "#F0F0F0",
+    text: "#666",
+  };
+  return {
+    background: colors.bg,
+    color: colors.text,
+    border: "none",
+  };
+}
+
+// ==================== 租户状态映射 ====================
+
+// 租户状态映射（用于 Tenant 实体的状态）
+export const TENANT_STATUS_MAP: Record<string, string> = {
+  ACTIVE: "正常",
+  SUSPENDED: "暂停",
+  EXPIRED: "过期",
+};
+
+// 租户状态颜色配置
+export const TENANT_STATUS_COLORS: Record<
+  string,
+  { bg: string; text: string }
+> = {
+  正常: { bg: "#E8F5E9", text: "#43A047" },
+  暂停: { bg: "#FFF8E1", text: "#F9A825" },
+  过期: { bg: "#F5F5F5", text: "#9E9E9E" },
+};
+
+/**
+ * 转换租户状态为中文
+ */
+export function translateTenantStatus(status: string): string {
+  return TENANT_STATUS_MAP[status] || status;
+}
+
+/**
+ * 获取租户状态样式
+ */
+export function getTenantStatusStyle(status: string): {
+  background: string;
+  color: string;
+  border: string;
+} {
+  const chineseStatus = TENANT_STATUS_MAP[status] || status;
+  const colors = TENANT_STATUS_COLORS[chineseStatus] || {
+    bg: "#F0F0F0",
+    text: "#666",
+  };
+  return {
+    background: colors.bg,
+    color: colors.text,
+    border: "none",
+  };
+}
+
+// ==================== 用户角色映射 ====================
+
+// 用户角色映射（与后端 UserRole 枚举对应）
+export const USER_ROLE_MAP: Record<string, string> = {
+  ADMIN: "超级管理员",
+  SCHOOL: "学校管理员",
+  TEACHER: "教师",
+  PARENT: "家长",
+};
+
+// 用户角色颜色配置
+export const USER_ROLE_COLORS: Record<string, { bg: string; text: string }> = {
+  超级管理员: { bg: "#E8F5E9", text: "#2E7D32" },
+  学校管理员: { bg: "#E3F2FD", text: "#1565C0" },
+  教师: { bg: "#F3E5F5", text: "#7B1FA2" },
+  家长: { bg: "#FFF8E1", text: "#F9A825" },
+};
+
+/**
+ * 转换用户角色为中文
+ */
+export function translateUserRole(role: string): string {
+  return USER_ROLE_MAP[role] || role;
+}
+
+/**
+ * 获取用户角色样式
+ */
+export function getUserRoleStyle(role: string): {
+  background: string;
+  color: string;
+  border: string;
+} {
+  const chineseRole = USER_ROLE_MAP[role] || role;
+  const colors = USER_ROLE_COLORS[chineseRole] || {
+    bg: "#F0F0F0",
+    text: "#666",
+  };
+  return {
+    background: colors.bg,
+    color: colors.text,
+    border: "none",
+  };
+}

reading-platform-frontend/src/views/admin/courses/CourseReviewView.vue

@@ -32,8 +32,8 @@
         </template>
 
         <template v-else-if="column.key === 'status'">
-          <a-tag :color="record.status === 'PENDING' || record.status === 'pending' ? 'processing' : 'error'">
+          <a-tag :color="getCourseReviewStatusColor(record.status)">
-            {{ record.status === 'PENDING' || record.status === 'pending' ? '待审核' : '已驳回' }}
+            {{ getCourseReviewStatusText(record.status) }}
           </a-tag>
         </template>
 
@@ -164,8 +164,22 @@ import * as courseApi from '@/api/course';
 import {
   translateGradeTag,
   getGradeTagStyle,
+  translateCourseStatus,
 } from '@/utils/tagMaps';
 
+// 课程审核状态映射
+const getCourseReviewStatusText = (status: string) => {
+  if (status === 'PENDING' || status === 'pending') return '待审核';
+  if (status === 'REJECTED' || status === 'rejected') return '已驳回';
+  return translateCourseStatus(status) || status;
+};
+
+const getCourseReviewStatusColor = (status: string) => {
+  if (status === 'PENDING' || status === 'pending') return 'processing';
+  if (status === 'REJECTED' || status === 'rejected') return 'error';
+  return 'default';
+};
+
 const loading = ref(false);
 const loadingDetail = ref(false);
 const courses = ref<any[]>([]);

reading-platform-frontend/src/views/admin/packages/PackageReviewView.vue

@@ -39,8 +39,8 @@
           </a-tag>
         </template>
         <template v-else-if="slotProps.column.key === 'status'">
-          <a-tag :color="slotProps.record.status === 'PENDING' ? 'processing' : 'error'">
+          <a-tag :color="getPackageReviewStatusColor(slotProps.record.status)">
-            {{ slotProps.record.status === 'PENDING' ? '待审核' : '已驳回' }}
+            {{ getPackageReviewStatusText(slotProps.record.status) }}
           </a-tag>
         </template>
         <template v-else-if="slotProps.column.key === 'submittedAt'">
@@ -152,6 +152,20 @@ import { message } from 'ant-design-vue';
 import { ReloadOutlined } from '@ant-design/icons-vue';
 import { getCollectionList, getCollectionDetail, rejectCollection, publishCollection } from '@/api/package';
 import type { CourseCollection } from '@/api/package';
+import { translateCourseStatus } from '@/utils/tagMaps';
+
+// 套餐审核状态映射
+const getPackageReviewStatusText = (status: string) => {
+  if (status === 'PENDING' || status === 'pending') return '待审核';
+  if (status === 'REJECTED' || status === 'rejected') return '已驳回';
+  return translateCourseStatus(status) || status;
+};
+
+const getPackageReviewStatusColor = (status: string) => {
+  if (status === 'PENDING' || status === 'pending') return 'processing';
+  if (status === 'REJECTED' || status === 'rejected') return 'error';
+  return 'default';
+};
 
 const loading = ref(false);
 const loadingDetail = ref(false);

reading-platform-frontend/src/views/parent/tasks/TaskListView.vue

@@ -262,6 +262,7 @@ import {
 } from '@/api/parent';
 import { uploadFile } from '@/api/file';
 import dayjs from 'dayjs';
+import { translateTaskCompletionStatus, getTaskCompletionStatusStyle } from '@/utils/tagMaps';
 
 const route = useRoute();
 const router = useRouter();
@@ -290,22 +291,25 @@ const feedbackModalVisible = ref(false);
 const imagePreviewVisible = ref(false);
 const previewImageUrl = ref('');
 
-// 状态映射（新设计）
+// 状态映射 - 使用统一工具函数
-const statusMap: Record<string, { text: string; color: string }> = {
+const getStatusText = (status: string) => translateTaskCompletionStatus(status);
-  PENDING: { text: '待提交', color: 'orange' },
+const getStatusColor = (status: string) => {
-  SUBMITTED: { text: '已提交', color: 'blue' },
+  const style = getTaskCompletionStatusStyle(status);
-  REVIEWED: { text: '已评价', color: 'green' },
+  // 返回 ant-design-vue tag 颜色名称
+  const colorMap: Record<string, string> = {
+    '待提交': 'orange',
+    '已提交': 'blue',
+    '已评价': 'green',
+  };
+  return colorMap[translateTaskCompletionStatus(status)] || 'default';
 };
 
-// 评价结果映射
+// 评价结果映射 - 保持本地定义（因为这是特定的评价结果，不是通用枚举）
 const feedbackResultMap: Record<string, { text: string; color: string }> = {
   EXCELLENT: { text: '优秀', color: 'gold' },
   PASSED: { text: '通过', color: 'green' },
   NEEDS_WORK: { text: '需改进', color: 'orange' },
 };
-
-const getStatusText = (status: string) => statusMap[status]?.text || status;
-const getStatusColor = (status: string) => statusMap[status]?.color || 'default';
 const getFeedbackResultText = (result: string) => feedbackResultMap[result]?.text || result;
 const getFeedbackResultColor = (result: string) => feedbackResultMap[result]?.color || 'default';
 

reading-platform-frontend/src/views/school/parents/ParentListView.vue

@@ -40,7 +40,7 @@
     <!-- 家长卡片列表 -->
     <div class="parent-grid" v-if="!loading && parents.length > 0">
       <div v-for="parent in parents" :key="parent.id" class="parent-card"
-        :class="{ 'inactive': parent.status !== 'ACTIVE' }">
+        :class="{ 'inactive': !isParentActive(parent.status) }">
         <div class="card-header">
           <div class="parent-avatar">
             <IdcardOutlined class="avatar-icon" />
@@ -49,8 +49,8 @@
             <div class="parent-name">{{ parent.name }}</div>
             <div class="parent-account">@{{ parent.loginAccount }}</div>
           </div>
-          <div class="status-badge" :class="parent.status === 'ACTIVE' ? 'active' : 'inactive'">
+          <div class="status-badge" :class="isParentActive(parent.status) ? 'active' : 'inactive'">
-            {{ parent.status === 'ACTIVE' ? '活跃' : '停用' }}
+            {{ getParentStatusText(parent.status) }}
           </div>
         </div>
 
@@ -318,6 +318,7 @@ import {
 } from '@ant-design/icons-vue';
 import { message } from 'ant-design-vue';
 import type { FormInstance } from 'ant-design-vue';
+import { translateGenericStatus, getGenericStatusStyle } from '@/utils/tagMaps';
 import {
   getParents,
   createParent,
@@ -332,6 +333,24 @@ import {
 } from '@/api/school';
 import type { Parent, CreateParentDto, ParentChild, Student } from '@/api/school';
 
+// 状态辅助函数
+const getParentStatusText = (status: string): string => {
+  if (status === 'ACTIVE') return '活跃';
+  if (status === 'INACTIVE') return '停用';
+  return translateGenericStatus(status);
+};
+
+const getParentStatusColor = (status: string): string => {
+  if (status === 'ACTIVE') return '#43A047';
+  if (status === 'INACTIVE') return '#E53935';
+  const style = getGenericStatusStyle(status);
+  return style.color;
+};
+
+const isParentActive = (status: string): boolean => {
+  return status === 'ACTIVE';
+};
+
 const loading = ref(false);
 const submitting = ref(false);
 const resetting = ref(false);
@@ -379,7 +398,7 @@ const pagination = reactive({
 const parents = ref<Parent[]>([]);
 
 const activeCount = computed(() => {
-  return parents.value.filter(p => p.status === 'ACTIVE').length;
+  return parents.value.filter(p => isParentActive(p.status)).length;
 });
 
 const formState = reactive<CreateParentDto & { id?: number }>({

reading-platform-frontend/src/views/school/schedule/CalendarView.vue

@@ -118,8 +118,8 @@
             <div class="item-teacher">{{ item.teacherName || '未分配' }}</div>
           </div>
           <div class="item-status">
-            <a-tag :color="item.status === 'ACTIVE' || item.status === 'scheduled' ? 'success' : 'default'">
+            <a-tag :color="getScheduleStatusColor(item.status)">
-              {{ item.status === 'ACTIVE' || item.status === 'scheduled' ? '有效' : '已取消' }}
+              {{ getScheduleStatusText(item.status) }}
             </a-tag>
           </div>
         </div>
@@ -142,7 +142,20 @@ import {
   type CalendarViewResponse,
   type DayScheduleItem,
 } from '@/api/school';
-import { getLessonTypeName, getLessonTagStyle } from '@/utils/tagMaps';
+import { getLessonTypeName, getLessonTagStyle, translateGenericStatus, getGenericStatusStyle } from '@/utils/tagMaps';
+
+// 状态辅助函数
+const getScheduleStatusText = (status: string): string => {
+  if (status === 'ACTIVE' || status === 'scheduled') return '有效';
+  if (status === 'CANCELLED' || status === 'cancelled') return '已取消';
+  return translateGenericStatus(status);
+};
+
+const getScheduleStatusColor = (status: string): string => {
+  if (status === 'ACTIVE' || status === 'scheduled') return 'success';
+  if (status === 'CANCELLED' || status === 'cancelled') return 'error';
+  return 'default';
+};
 
 const viewType = ref<'month' | 'week'>('month');
 const selectedClassId = ref<number | undefined>();

reading-platform-frontend/src/views/school/schedule/ScheduleList.vue

@@ -63,14 +63,15 @@
           <span v-else>-</span>
         </template>
         <template v-if="column.key === 'status'">
-          <a-tag v-if="record.status === 'ACTIVE' || record.status === 'scheduled'" color="success">有效</a-tag>
+          <a-tag :color="getScheduleStatusColor(record.status)">
-          <a-tag v-else color="error">已取消</a-tag>
+            {{ getScheduleStatusText(record.status) }}
+          </a-tag>
         </template>
         <template v-if="column.key === 'actions'">
           <a-space>
             <a-button type="link" size="small" @click="showEditModal(record)">编辑</a-button>
             <a-popconfirm
-              v-if="record.status === 'ACTIVE' || record.status === 'scheduled'"
+              v-if="isScheduleActive(record.status)"
               title="确定要取消此排课吗？"
               @confirm="handleCancel(record.id)"
             >
@@ -173,7 +174,26 @@ import {
   type ClassInfo,
   type Teacher,
 } from '@/api/school';
-import { getLessonTypeName, getLessonTagStyle } from '@/utils/tagMaps';
+import { getLessonTypeName, getLessonTagStyle, translateGenericStatus, getGenericStatusStyle } from '@/utils/tagMaps';
+
+// 状态辅助函数
+const getScheduleStatusText = (status: string): string => {
+  if (status === 'ACTIVE' || status === 'scheduled') return '有效';
+  if (status === 'CANCELLED' || status === 'cancelled') return '已取消';
+  return translateGenericStatus(status);
+};
+
+const getScheduleStatusColor = (status: string): string => {
+  if (status === 'ACTIVE' || status === 'scheduled') return 'success';
+  if (status === 'CANCELLED' || status === 'cancelled') return 'error';
+  const style = getGenericStatusStyle(status);
+  // 简单映射到 antd 颜色
+  return style.color === '#43A047' ? 'success' : 'default';
+};
+
+const isScheduleActive = (status: string): boolean => {
+  return status === 'ACTIVE' || status === 'scheduled';
+};
 
 // 数据
 const loading = ref(false);

reading-platform-frontend/src/views/school/schedule/TimetableView.vue

@@ -74,7 +74,7 @@
                 :class="{
                   'school-schedule': schedule.source === 'SCHOOL',
                   'teacher-schedule': schedule.source === 'TEACHER',
-                  'cancelled': schedule.status === 'cancelled' || schedule.status === 'CANCELLED',
+                  'cancelled': !isScheduleActive(schedule.status),
                 }"
                 @click="showScheduleDetail(schedule)"
               >
@@ -84,7 +84,7 @@
                 <div v-if="schedule.teacherName" class="schedule-teacher">{{ schedule.teacherName }}</div>
                 <a-tag v-if="schedule.lessonType" size="small" class="schedule-lesson-type"
                   :style="getLessonTagStyle(schedule.lessonType)">{{ getLessonTypeName(schedule.lessonType) }}</a-tag>
-                <a-tag v-if="schedule.status === 'cancelled' || schedule.status === 'CANCELLED'" color="error" size="small">已取消</a-tag>
+                <a-tag v-if="!isScheduleActive(schedule.status)" color="error" size="small">已取消</a-tag>
               </div>
               <div v-if="!day.schedules.length" class="empty-day">
                 暂无排课
@@ -116,8 +116,9 @@
           <a-descriptions-item label="排课日期">{{ formatDate(selectedSchedule.scheduledDate) }}</a-descriptions-item>
           <a-descriptions-item label="时间段">{{ selectedSchedule.scheduledTime || '待定' }}</a-descriptions-item>
           <a-descriptions-item label="状态">
-            <a-tag v-if="selectedSchedule.status === 'ACTIVE' || selectedSchedule.status === 'scheduled'" color="success">有效</a-tag>
+            <a-tag :color="getScheduleStatusColor(selectedSchedule.status)">
-            <a-tag v-else color="error">已取消</a-tag>
+              {{ getScheduleStatusText(selectedSchedule.status) }}
+            </a-tag>
           </a-descriptions-item>
         </a-descriptions>
       </template>
@@ -142,7 +143,29 @@ import {
   type ClassInfo,
   type Teacher,
 } from '@/api/school';
-import { getLessonTypeName, getLessonTagStyle } from '@/utils/tagMaps';
+import { getLessonTypeName, getLessonTagStyle, translateGenericStatus, getGenericStatusStyle, translateScheduleSourceType } from '@/utils/tagMaps';
+
+// 状态辅助函数
+const getScheduleStatusText = (status: string): string => {
+  if (status === 'ACTIVE' || status === 'scheduled') return '有效';
+  if (status === 'CANCELLED' || status === 'cancelled') return '已取消';
+  return translateGenericStatus(status);
+};
+
+const getScheduleStatusColor = (status: string): string => {
+  if (status === 'ACTIVE' || status === 'scheduled') return 'success';
+  if (status === 'CANCELLED' || status === 'cancelled') return 'error';
+  return 'default';
+};
+
+const isScheduleActive = (status: string): boolean => {
+  return status === 'ACTIVE' || status === 'scheduled';
+};
+
+// 日程来源辅助函数
+const getScheduleSourceText = (source: string): string => {
+  return translateScheduleSourceType(source) || source;
+};
 
 // 数据
 const loading = ref(false);

reading-platform-frontend/src/views/school/school-courses/SchoolCourseDetailView.vue

@@ -8,8 +8,8 @@
         </a-button>
         <div class="course-title">
           <h2>{{ detail?.name || '校本课程包详情' }}</h2>
-          <a-tag :color="detail?.status === 'ACTIVE' ? 'success' : 'default'">
+          <a-tag :color="getCourseStatusColor(detail?.status)">
-            {{ detail?.status === 'ACTIVE' ? '启用' : '禁用' }}
+            {{ getCourseStatusText(detail?.status) }}
           </a-tag>
         </div>
       </div>
@@ -339,6 +339,19 @@ const getStatusText = (status: string) => {
   return texts[status] || status;
 };
 
+// 课程包状态映射
+const getCourseStatusColor = (status: string) => {
+  if (status === 'ACTIVE') return 'success';
+  if (status === 'INACTIVE') return 'default';
+  return 'default';
+};
+
+const getCourseStatusText = (status: string) => {
+  if (status === 'ACTIVE') return '启用';
+  if (status === 'INACTIVE') return '禁用';
+  return status;
+};
+
 const formatDate = (date?: string) => {
   if (!date) return '-';
   return new Date(date).toLocaleDateString('zh-CN');

reading-platform-frontend/src/views/school/school-courses/SchoolCourseListView.vue

@@ -96,8 +96,8 @@
             <span>{{ record.creator?.name || '-' }}</span>
           </template>
           <template v-else-if="column.key === 'status'">
-            <a-tag :color="record.status === 'ACTIVE' ? 'success' : 'default'">
+            <a-tag :color="getCourseStatusColor(record.status)">
-              {{ record.status === 'ACTIVE' ? '启用' : '禁用' }}
+              {{ getCourseStatusText(record.status) }}
             </a-tag>
           </template>
           <template v-else-if="column.key === 'usageCount'">
@@ -388,6 +388,19 @@ const getStatusText = (status: string) => {
   return texts[status] || status;
 };
 
+// 课程包状态映射
+const getCourseStatusColor = (status: string) => {
+  if (status === 'ACTIVE') return 'success';
+  if (status === 'INACTIVE') return 'default';
+  return 'default';
+};
+
+const getCourseStatusText = (status: string) => {
+  if (status === 'ACTIVE') return '启用';
+  if (status === 'INACTIVE') return '禁用';
+  return status;
+};
+
 const fetchData = async () => {
   loading.value = true;
   try {

reading-platform-frontend/src/views/school/tasks/TaskListView.vue

@@ -461,6 +461,7 @@ import {
   type TaskCompletionStatus,
 } from '@/api/school';
 import dayjs, { Dayjs } from 'dayjs';
+import { translateTaskCompletionStatus, getTaskCompletionStatusStyle } from '@/utils/tagMaps';
 
 const loading = ref(false);
 const tasks = ref<SchoolTask[]>([]);
@@ -518,7 +519,7 @@ const completionColumns = [
   { title: '操作', key: 'action', width: 80, fixed: 'right' as const },
 ];
 
-// 类型/状态映射
+// 类型/状态映射 - 使用统一工具函数
 const typeColors: Record<string, string> = {
   READING: 'blue',
   ACTIVITY: 'green',
@@ -533,27 +534,38 @@ const typeTexts: Record<string, string> = {
 
 const statusColors: Record<string, string> = {
   PUBLISHED: 'green',
+  ACTIVE: 'green',
+  PENDING: 'orange',
+  COMPLETED: 'blue',
   DRAFT: 'default',
   ARCHIVED: 'default',
 };
 
 const statusTexts: Record<string, string> = {
   PUBLISHED: '进行中',
+  ACTIVE: '进行中',
+  PENDING: '待审核',
+  COMPLETED: '已完成',
   DRAFT: '草稿',
   ARCHIVED: '已归档',
 };
 
-const completionStatusColors: Record<string, string> = {
+const getTypeColor = (type: string) => typeColors[type] || 'default';
-  PENDING: 'orange',
+const getTypeText = (type: string) => typeTexts[type] || type;
-  SUBMITTED: 'blue',
+const getStatusColor = (status: string) => statusColors[status] || 'default';
-  REVIEWED: 'green',
+const getStatusText = (status: string) => statusTexts[status] || status;
-};
 
-const completionStatusTexts: Record<string, string> = {
+// 任务完成状态 - 使用统一工具函数
-  PENDING: '待提交',
+const getCompletionStatusColor = (status: string) => {
-  SUBMITTED: '已提交',
+  const style = getTaskCompletionStatusStyle(status);
-  REVIEWED: '已评价',
+  const colorMap: Record<string, string> = {
+    '待提交': 'orange',
+    '已提交': 'blue',
+    '已评价': 'green',
+  };
+  return colorMap[translateTaskCompletionStatus(status)] || 'default';
 };
+const getCompletionStatusText = (status: string) => translateTaskCompletionStatus(status);
 
 const feedbackResultColors: Record<string, string> = {
   EXCELLENT: 'gold',
@@ -566,13 +578,6 @@ const feedbackResultTexts: Record<string, string> = {
   PASSED: '通过',
   NEEDS_WORK: '需改进',
 };
-
-const getTypeColor = (type: string) => typeColors[type] || 'default';
-const getTypeText = (type: string) => typeTexts[type] || type;
-const getStatusColor = (status: string) => statusColors[status] || 'default';
-const getStatusText = (status: string) => statusTexts[status] || status;
-const getCompletionStatusColor = (status: string) => completionStatusColors[status] || 'default';
-const getCompletionStatusText = (status: string) => completionStatusTexts[status] || status;
 const getFeedbackResultColor = (result: string) => feedbackResultColors[result] || 'default';
 const getFeedbackResultText = (result: string) => feedbackResultTexts[result] || result;
 

reading-platform-frontend/src/views/school/teachers/TeacherListView.vue

@@ -40,7 +40,7 @@
     <!-- 教师卡片列表 -->
     <div class="teacher-grid" v-if="!loading && teachers.length > 0">
       <div v-for="teacher in teachers" :key="teacher.id" class="teacher-card"
-        :class="{ 'inactive': teacher.status !== 'ACTIVE' }">
+        :class="{ 'inactive': !isTeacherActive(teacher.status) }">
         <div class="card-header">
           <div class="teacher-avatar">
             <SolutionOutlined class="avatar-icon" />
@@ -49,8 +49,8 @@
             <div class="teacher-name">{{ teacher.name }}</div>
             <div class="teacher-account">@{{ teacher.loginAccount }}</div>
           </div>
-          <div class="status-badge" :class="teacher.status === 'ACTIVE' ? 'active' : 'inactive'">
+          <div class="status-badge" :class="isTeacherActive(teacher.status) ? 'active' : 'inactive'">
-            {{ teacher.status === 'ACTIVE' ? '在职' : '离职' }}
+            {{ getTeacherStatusText(teacher.status) }}
           </div>
         </div>
 
@@ -218,6 +218,7 @@ import {
 } from '@ant-design/icons-vue';
 import { message } from 'ant-design-vue';
 import type { FormInstance } from 'ant-design-vue';
+import { translateGenericStatus, getGenericStatusStyle } from '@/utils/tagMaps';
 import {
   getTeachers,
   createTeacher,
@@ -228,6 +229,24 @@ import {
 } from '@/api/school';
 import type { Teacher, CreateTeacherDto, ClassInfo } from '@/api/school';
 
+// 状态辅助函数
+const getTeacherStatusText = (status: string): string => {
+  if (status === 'ACTIVE') return '在职';
+  if (status === 'INACTIVE') return '离职';
+  return translateGenericStatus(status);
+};
+
+const getTeacherStatusColor = (status: string): string => {
+  if (status === 'ACTIVE') return '#43A047';
+  if (status === 'INACTIVE') return '#E53935';
+  const style = getGenericStatusStyle(status);
+  return style.color;
+};
+
+const isTeacherActive = (status: string): boolean => {
+  return status === 'ACTIVE';
+};
+
 const loading = ref(false);
 const classesLoading = ref(false);
 const submitting = ref(false);
@@ -263,7 +282,7 @@ const teachers = ref<Teacher[]>([]);
 const classes = ref<ClassInfo[]>([]);
 
 const activeCount = computed(() => {
-  return teachers.value.filter(t => t.status === 'ACTIVE').length;
+  return teachers.value.filter(t => isTeacherActive(t.status)).length;
 });
 
 const formState = reactive<CreateTeacherDto & { id?: number }>({

reading-platform-frontend/src/views/teacher/lessons/LessonListView.vue

@@ -210,6 +210,7 @@ import {
 import { message, Modal } from 'ant-design-vue';
 import * as teacherApi from '@/api/teacher';
 import dayjs from 'dayjs';
+import { translateGenericStatus } from '@/utils/tagMaps';
 
 const router = useRouter();
 const loading = ref(false);
@@ -227,20 +228,53 @@ const detailDrawerVisible = ref(false);
 const selectedLesson = ref<any>(null);
 
 // 状态映射（兼容后端 scheduled/in_progress/completed/cancelled 与前端 PLANNED/IN_PROGRESS 等）
-const statusMap: Record<string, { text: string; color: string; class: string }> = {
+// 使用统一工具函数获取中文文本
-  PLANNED: { text: '已计划', color: 'blue', class: 'status-planned' },
+const getStatusText = (status: string): string => {
-  scheduled: { text: '已计划', color: 'blue', class: 'status-planned' },
+  // 先尝试精确匹配已知状态
-  IN_PROGRESS: { text: '进行中', color: 'orange', class: 'status-progress' },
+  const directMap: Record<string, string> = {
-  in_progress: { text: '进行中', color: 'orange', class: 'status-progress' },
+    'PLANNED': '已计划',
-  COMPLETED: { text: '已完成', color: 'green', class: 'status-completed' },
+    'scheduled': '已计划',
-  completed: { text: '已完成', color: 'green', class: 'status-completed' },
+    'IN_PROGRESS': '进行中',
-  CANCELLED: { text: '已取消', color: 'default', class: 'status-cancelled' },
+    'in_progress': '进行中',
-  cancelled: { text: '已取消', color: 'default', class: 'status-cancelled' },
+    'COMPLETED': '已完成',
+    'completed': '已完成',
+    'CANCELLED': '已取消',
+    'cancelled': '已取消',
+  };
+  if (directMap[status]) {
+    return directMap[status];
+  }
+  // 未知状态使用通用翻译
+  return translateGenericStatus(status);
 };
 
-const getStatusText = (status: string) => statusMap[status]?.text || status;
+const getStatusColor = (status: string): string => {
-const getStatusColor = (status: string) => statusMap[status]?.color || 'default';
+  const colorMap: Record<string, string> = {
-const getStatusClass = (status: string) => statusMap[status]?.class || '';
+    'PLANNED': 'blue',
+    'scheduled': 'blue',
+    'IN_PROGRESS': 'orange',
+    'in_progress': 'orange',
+    'COMPLETED': 'green',
+    'completed': 'green',
+    'CANCELLED': 'default',
+    'cancelled': 'default',
+  };
+  return colorMap[status] || 'default';
+};
+
+const getStatusClass = (status: string): string => {
+  const classMap: Record<string, string> = {
+    'PLANNED': 'status-planned',
+    'scheduled': 'status-planned',
+    'IN_PROGRESS': 'status-progress',
+    'in_progress': 'status-progress',
+    'COMPLETED': 'status-completed',
+    'completed': 'status-completed',
+    'CANCELLED': 'status-cancelled',
+    'cancelled': 'status-cancelled',
+  };
+  return classMap[status] || '';
+};
 
 const formatDateTime = (date: string | Date | null) => {
   if (!date) return '-';

reading-platform-frontend/src/views/teacher/lessons/LessonRecordsView.vue

@@ -234,6 +234,7 @@ import {
   type StudentWithRecord,
   type TeacherCourse,
 } from '@/api/teacher';
+import { translateGenericStatus } from '@/utils/tagMaps';
 
 const router = useRouter();
 const route = useRoute();
@@ -278,15 +279,31 @@ const avatarColors = [
 
 const getAvatarColor = (index: number) => avatarColors[index % avatarColors.length];
 
-const statusMap: Record<string, { text: string; color: string }> = {
+// 状态映射 - 使用统一工具函数
-  PLANNED: { text: '已计划', color: 'blue' },
+const getStatusText = (status?: string): string => {
-  IN_PROGRESS: { text: '进行中', color: 'orange' },
+  if (!status) return '-';
-  COMPLETED: { text: '已完成', color: 'green' },
+  const directMap: Record<string, string> = {
-  CANCELLED: { text: '已取消', color: 'default' },
+    'PLANNED': '已计划',
+    'IN_PROGRESS': '进行中',
+    'COMPLETED': '已完成',
+    'CANCELLED': '已取消',
+  };
+  if (directMap[status]) {
+    return directMap[status];
+  }
+  return translateGenericStatus(status);
 };
 
-const getStatusText = (status?: string) => status ? (statusMap[status]?.text || status) : '-';
+const getStatusColor = (status?: string): string => {
-const getStatusColor = (status?: string) => status ? (statusMap[status]?.color || 'default') : 'default';
+  if (!status) return 'default';
+  const colorMap: Record<string, string> = {
+    'PLANNED': 'blue',
+    'IN_PROGRESS': 'orange',
+    'COMPLETED': 'green',
+    'CANCELLED': 'default',
+  };
+  return colorMap[status] || 'default';
+};
 
 const loadRecords = async () => {
   loading.value = true;

reading-platform-frontend/src/views/teacher/schedule/ScheduleView.vue

@@ -139,8 +139,9 @@
             <a-tag v-else color="purple">自主预约</a-tag>
           </a-descriptions-item>
           <a-descriptions-item label="状态">
-            <a-tag v-if="selectedSchedule.status === 'ACTIVE'" color="success">有效</a-tag>
+            <a-tag :color="getLessonStatusColor(selectedSchedule.status)">
-            <a-tag v-else color="error">已取消</a-tag>
+              {{ getLessonStatusText(selectedSchedule.status) }}
+            </a-tag>
           </a-descriptions-item>
           <a-descriptions-item v-if="selectedSchedule.note" label="备注">{{ selectedSchedule.note }}</a-descriptions-item>
         </a-descriptions>
@@ -320,11 +321,7 @@ const formatDate = (date: string | undefined) => {
   return dayjs(date).format('YYYY-MM-DD');
 };
 
-const filterCourseOption = (input: string, option: any) => {
+const getLessonStatusColor = (status: string) => {
-  return option.children?.[0]?.children?.toLowerCase().includes(input.toLowerCase());
-};
-
-const getLessonStatusColor = (status: string | undefined) => {
   switch (status) {
     case 'PLANNED': return 'blue';
     case 'IN_PROGRESS': return 'processing';
@@ -334,7 +331,7 @@ const getLessonStatusColor = (status: string | undefined) => {
   }
 };
 
-const getLessonStatusText = (status: string | undefined) => {
+const getLessonStatusText = (status: string) => {
   switch (status) {
     case 'PLANNED': return '待上课';
     case 'IN_PROGRESS': return '进行中';

reading-platform-frontend/src/views/teacher/school-courses/SchoolCourseDetailView.vue

@@ -27,22 +27,16 @@
         <a-tag v-else color="green">
           <TeamOutlined /> 校本课程中心
         </a-tag>
-        <a-tag v-if="detail.reviewStatus === 'PENDING'" color="orange">
+        <a-tag :color="getReviewStatusColor(detail.reviewStatus)">
-          <ClockCircleOutlined /> 待审核
+          {{ getReviewStatusText(detail.reviewStatus) }}
-        </a-tag>
-        <a-tag v-else-if="detail.reviewStatus === 'APPROVED'" color="success">
-          <CheckCircleOutlined /> 已通过
-        </a-tag>
-        <a-tag v-else-if="detail.reviewStatus === 'REJECTED'" color="error">
-          <CloseCircleOutlined /> 已驳回
         </a-tag>
       </div>
 
       <a-descriptions :column="2" bordered>
         <a-descriptions-item label="名称">{{ detail?.name }}</a-descriptions-item>
         <a-descriptions-item label="状态">
-          <a-tag :color="detail?.status === 'ACTIVE' ? 'success' : 'default'">
+          <a-tag :color="getCourseStatusColor(detail?.status)">
-            {{ detail?.status === 'ACTIVE' ? '启用' : '禁用' }}
+            {{ getCourseStatusText(detail?.status) }}
           </a-tag>
         </a-descriptions-item>
         <a-descriptions-item label="源课程包">{{ detail?.sourceCourse?.name }}</a-descriptions-item>
@@ -90,11 +84,39 @@ import {
   PlayCircleOutlined,
   UserOutlined,
   TeamOutlined,
-  ClockCircleOutlined,
-  CheckCircleOutlined,
-  CloseCircleOutlined,
 } from '@ant-design/icons-vue';
 import { getTeacherSchoolCourseFullDetail } from '@/api/school-course';
+import { translateCourseStatus } from '@/utils/tagMaps';
+
+// 审核状态映射
+const getReviewStatusText = (status: string): string => {
+  if (!status) return '-';
+  return translateCourseStatus(status);
+};
+
+const getReviewStatusColor = (status: string): string => {
+  const colorMap: Record<string, string> = {
+    'PENDING': 'orange',
+    'APPROVED': 'success',
+    'REJECTED': 'error',
+    'DRAFT': 'default',
+  };
+  return colorMap[status] || 'default';
+};
+
+// 状态映射
+const getCourseStatusText = (status: string): string => {
+  if (!status) return '未知';
+  if (status === 'ACTIVE') return '启用';
+  if (status === 'INACTIVE') return '禁用';
+  return status;
+};
+
+const getCourseStatusColor = (status: string): string => {
+  if (status === 'ACTIVE') return 'success';
+  if (status === 'INACTIVE') return 'default';
+  return 'default';
+};
 
 const router = useRouter();
 const route = useRoute();

reading-platform-frontend/src/views/teacher/school-courses/SchoolCourseListView.vue

@@ -56,14 +56,13 @@
             </div>
           </template>
           <template v-else-if="column.key === 'reviewStatus'">
-            <a-tag v-if="record.reviewStatus === 'PENDING'" color="orange">待审核</a-tag>
+            <a-tag :color="getReviewStatusColor(record.reviewStatus)">
-            <a-tag v-else-if="record.reviewStatus === 'APPROVED'" color="success">已通过</a-tag>
+              {{ getReviewStatusText(record.reviewStatus) }}
-            <a-tag v-else-if="record.reviewStatus === 'REJECTED'" color="error">已驳回</a-tag>
+            </a-tag>
-            <a-tag v-else>-</a-tag>
           </template>
           <template v-else-if="column.key === 'status'">
-            <a-tag :color="record.status === 'ACTIVE' ? 'success' : 'default'">
+            <a-tag :color="getCourseStatusColor(record.status)">
-              {{ record.status === 'ACTIVE' ? '启用' : '禁用' }}
+              {{ getCourseStatusText(record.status) }}
             </a-tag>
           </template>
           <template v-else-if="column.key === 'action'">
@@ -88,6 +87,37 @@ import { message } from 'ant-design-vue';
 import { PlusOutlined, UserOutlined, TeamOutlined } from '@ant-design/icons-vue';
 import { getTeacherSchoolCourseList, deleteTeacherSchoolCourse } from '@/api/school-course';
 import type { SchoolCourse } from '@/api/school-course';
+import { translateCourseStatus } from '@/utils/tagMaps';
+
+// 审核状态映射
+const getReviewStatusText = (status: string): string => {
+  if (!status) return '-';
+  return translateCourseStatus(status);
+};
+
+const getReviewStatusColor = (status: string): string => {
+  const colorMap: Record<string, string> = {
+    'PENDING': 'orange',
+    'APPROVED': 'success',
+    'REJECTED': 'error',
+    'DRAFT': 'default',
+  };
+  return colorMap[status] || 'default';
+};
+
+// 状态映射
+const getCourseStatusText = (status: string): string => {
+  if (!status) return '未知';
+  if (status === 'ACTIVE') return '启用';
+  if (status === 'INACTIVE') return '禁用';
+  return status;
+};
+
+const getCourseStatusColor = (status: string): string => {
+  if (status === 'ACTIVE') return 'success';
+  if (status === 'INACTIVE') return 'default';
+  return 'default';
+};
 
 const router = useRouter();
 

reading-platform-frontend/src/views/teacher/tasks/TaskListView.vue

@@ -48,7 +48,9 @@
       <a-space :size="16">
         <a-select v-model:value="filters.status" placeholder="任务状态" style="width: 120px;" allowClear
           @change="loadTasks">
+          <a-select-option value="ACTIVE">进行中</a-select-option>
           <a-select-option value="PUBLISHED">进行中</a-select-option>
+          <a-select-option value="PENDING">待审核</a-select-option>
           <a-select-option value="DRAFT">草稿</a-select-option>
           <a-select-option value="ARCHIVED">已归档</a-select-option>
         </a-select>
@@ -399,7 +401,6 @@ import {
   CheckCircleOutlined,
   MessageOutlined,
   StarFilled,
-  PictureOutlined,
   VideoCameraOutlined,
   SoundOutlined,
   FileTextFilled,
@@ -424,6 +425,7 @@ import {
   type TaskTemplate,
 } from '@/api/teacher';
 import dayjs, { Dayjs } from 'dayjs';
+import { translateTaskCompletionStatus } from '@/utils/tagMaps';
 
 const loading = ref(false);
 const tasks = ref<TeacherTask[]>([]);
@@ -508,6 +510,9 @@ const typeMap: Record<string, { text: string; color: string }> = {
 
 const statusMap: Record<string, { text: string; color: string }> = {
   PUBLISHED: { text: '进行中', color: 'green' },
+  ACTIVE: { text: '进行中', color: 'green' },
+  PENDING: { text: '待审核', color: 'orange' },
+  COMPLETED: { text: '已完成', color: 'blue' },
   DRAFT: { text: '草稿', color: 'default' },
   ARCHIVED: { text: '已归档', color: 'default' },
 };
@@ -811,23 +816,20 @@ const viewCompletionDetail = async (task: TeacherTask) => {
   loadCompletions();
 };
 
-// 完成状态相关
+// 完成情况相关 - 使用统一工具函数
 const getCompletionStatusColor = (status: string) => {
+  // 返回 ant-design-vue tag 颜色名称或十六进制
   const colorMap: Record<string, string> = {
-    'PENDING': 'orange',
+    '待提交': 'orange',
-    'SUBMITTED': 'blue',
+    '已提交': 'blue',
-    'REVIEWED': 'green',
+    '已评价': 'green',
   };
-  return colorMap[status] || 'default';
+  const chineseStatus = translateTaskCompletionStatus(status);
+  return colorMap[chineseStatus] || 'default';
 };
 
 const getCompletionStatusText = (status: string) => {
-  const textMap: Record<string, string> = {
+  return translateTaskCompletionStatus(status);
-    'PENDING': '待提交',
-    'SUBMITTED': '已提交',
-    'REVIEWED': '已评价',
-  };
-  return textMap[status] || status;
 };
 
 // 评价弹窗相关

reading-platform-frontend/vite.config.ts

@@ -1,4 +1,4 @@
-import { defineConfig } from 'vite';
+import { defineConfig, loadEnv } from 'vite';
 import vue from '@vitejs/plugin-vue';
 import { resolve } from 'path';
 import AutoImport from 'unplugin-auto-import/vite';
@@ -8,8 +8,13 @@ import viteCompression from 'vite-plugin-compression';
 import fileRouter from 'unplugin-vue-router/vite';
 import UnoCSS from 'unocss/vite';
 
-export default defineConfig({
+export default defineConfig(({ mode }) => {
-  plugins: [
+  const env = loadEnv(mode, process.cwd(), '');
+  const port = parseInt(env.VITE_APP_PORT) || 5173;
+  const backendPort = env.VITE_BACKEND_PORT || '8480';
+
+  return {
+    plugins: [
     vue(),
     UnoCSS(),
     fileRouter({
@@ -52,15 +57,15 @@ export default defineConfig({
     },
   },
   server: {
-    port: 5173,
+    port,
     host: true,
     proxy: {
       '/api': {
-        target: 'http://localhost:8480',
+        target: `http://localhost:${backendPort}`,
         changeOrigin: true,
       },
       '/uploads': {
-        target: 'http://localhost:8480',
+        target: `http://localhost:${backendPort}`,
         changeOrigin: true,
       },
     },
@@ -78,4 +83,5 @@ export default defineConfig({
     },
     chunkSizeWarningLimit: 1000,
   },
+  };
 });

reading-platform-java/pom.xml

@@ -143,6 +143,13 @@
             <version>2.0.43</version>
         </dependency>
 
+        <!-- EasyExcel -->
+        <dependency>
+            <groupId>com.alibaba</groupId>
+            <artifactId>easyexcel</artifactId>
+            <version>3.3.4</version>
+        </dependency>
+
         <!-- Aliyun OSS SDK -->
         <dependency>
             <groupId>com.aliyun.oss</groupId>

reading-platform-java/src/main/java/com/reading/platform/common/enums/GenericStatus.java

@@ -0,0 +1,50 @@
+package com.reading.platform.common.enums;
+
+import lombok.Getter;
+
+/**
+ * 通用状态枚举
+ * 用于统一各实体中 active/ACTIVE 等状态值
+ */
+@Getter
+public enum GenericStatus {
+
+    ACTIVE("ACTIVE", "激活"),
+    INACTIVE("INACTIVE", "未激活"),
+    ARCHIVED("ARCHIVED", "归档");
+
+    private final String code;
+    private final String description;
+
+    GenericStatus(String code, String description) {
+        this.code = code;
+        this.description = description;
+    }
+
+    public static GenericStatus fromCode(String code) {
+        if (code == null) {
+            return INACTIVE;
+        }
+        for (GenericStatus status : values()) {
+            if (status.getCode().equalsIgnoreCase(code)) {
+                return status;
+            }
+        }
+        return INACTIVE;
+    }
+
+    /**
+     * 判断字符串是否为激活状态
+     */
+    public static boolean isActive(String status) {
+        return ACTIVE.getCode().equalsIgnoreCase(status);
+    }
+
+    /**
+     * 判断当前状态是否为激活状态
+     */
+    public boolean isActive() {
+        return this == ACTIVE;
+    }
+
+}

reading-platform-java/src/main/java/com/reading/platform/common/enums/NotificationRecipientType.java

@@ -0,0 +1,37 @@
+package com.reading.platform.common.enums;
+
+import lombok.Getter;
+
+/**
+ * 通知接收者类型枚举
+ */
+@Getter
+public enum NotificationRecipientType {
+
+    ALL("ALL", "所有人"),
+    TEACHER("TEACHER", "教师"),
+    SCHOOL("SCHOOL", "学校管理员"),
+    PARENT("PARENT", "家长"),
+    STUDENT("STUDENT", "学生");
+
+    private final String code;
+    private final String description;
+
+    NotificationRecipientType(String code, String description) {
+        this.code = code;
+        this.description = description;
+    }
+
+    public static NotificationRecipientType fromCode(String code) {
+        if (code == null) {
+            return TEACHER;
+        }
+        for (NotificationRecipientType type : values()) {
+            if (type.getCode().equalsIgnoreCase(code)) {
+                return type;
+            }
+        }
+        return TEACHER;
+    }
+
+}

reading-platform-java/src/main/java/com/reading/platform/common/enums/NotificationType.java

@@ -0,0 +1,36 @@
+package com.reading.platform.common.enums;
+
+import lombok.Getter;
+
+/**
+ * 通知类型枚举
+ */
+@Getter
+public enum NotificationType {
+
+    SYSTEM("SYSTEM", "系统通知"),
+    TASK("TASK", "任务通知"),
+    SCHEDULE("SCHEDULE", "日程通知"),
+    COURSE("COURSE", "课程通知");
+
+    private final String code;
+    private final String description;
+
+    NotificationType(String code, String description) {
+        this.code = code;
+        this.description = description;
+    }
+
+    public static NotificationType fromCode(String code) {
+        if (code == null) {
+            return SYSTEM;
+        }
+        for (NotificationType type : values()) {
+            if (type.getCode().equalsIgnoreCase(code)) {
+                return type;
+            }
+        }
+        return SYSTEM;
+    }
+
+}

reading-platform-java/src/main/java/com/reading/platform/common/enums/ScheduleSourceType.java

@@ -0,0 +1,34 @@
+package com.reading.platform.common.enums;
+
+import lombok.Getter;
+
+/**
+ * 日程计划来源类型枚举
+ */
+@Getter
+public enum ScheduleSourceType {
+
+    TEACHER("TEACHER", "教师创建"),
+    SCHOOL("SCHOOL", "学校创建");
+
+    private final String code;
+    private final String description;
+
+    ScheduleSourceType(String code, String description) {
+        this.code = code;
+        this.description = description;
+    }
+
+    public static ScheduleSourceType fromCode(String code) {
+        if (code == null) {
+            return TEACHER;
+        }
+        for (ScheduleSourceType type : values()) {
+            if (type.getCode().equalsIgnoreCase(code)) {
+                return type;
+            }
+        }
+        return TEACHER;
+    }
+
+}

reading-platform-java/src/main/java/com/reading/platform/common/enums/TaskCompletionStatus.java

@@ -0,0 +1,43 @@
+package com.reading.platform.common.enums;
+
+import lombok.Getter;
+
+/**
+ * 任务完成情况状态枚举
+ */
+@Getter
+public enum TaskCompletionStatus {
+
+    PENDING("PENDING", "待提交"),
+    SUBMITTED("SUBMITTED", "已提交"),
+    REVIEWED("REVIEWED", "已评价"),
+    COMPLETED("completed", "已完成"); // 兼容旧数据
+
+    private final String code;
+    private final String description;
+
+    TaskCompletionStatus(String code, String description) {
+        this.code = code;
+        this.description = description;
+    }
+
+    public static TaskCompletionStatus fromCode(String code) {
+        if (code == null) {
+            return PENDING;
+        }
+        for (TaskCompletionStatus status : values()) {
+            if (status.getCode().equalsIgnoreCase(code)) {
+                return status;
+            }
+        }
+        return PENDING;
+    }
+
+    /**
+     * 获取状态描述文本
+     */
+    public String getDescription() {
+        return this.description;
+    }
+
+}

reading-platform-java/src/main/java/com/reading/platform/common/security/JwtAuthenticationFilter.java

@@ -1,7 +1,9 @@
 package com.reading.platform.common.security;
 
 import com.fasterxml.jackson.databind.ObjectMapper;
+import com.reading.platform.common.enums.GenericStatus;
 import com.reading.platform.common.enums.TenantStatus;
+import com.reading.platform.common.enums.UserRole;
 import com.reading.platform.entity.AdminUser;
 import com.reading.platform.entity.Parent;
 import com.reading.platform.entity.Tenant;
@@ -74,6 +76,8 @@ public class JwtAuthenticationFilter extends OncePerRequestFilter {
                     return;
                 }
 
+                // 使用 UserRole 枚举确保角色有效性
+                UserRole.fromCode(payload.getRole());
                 UsernamePasswordAuthenticationToken authentication =
                         new UsernamePasswordAuthenticationToken(
                                 payload,
@@ -144,7 +148,7 @@ public class JwtAuthenticationFilter extends OncePerRequestFilter {
         return switch (role) {
             case "admin" -> {
                 AdminUser adminUser = adminUserMapper.selectById(userId);
-                yield adminUser != null && "active".equalsIgnoreCase(adminUser.getStatus());
+                yield adminUser != null && GenericStatus.isActive(adminUser.getStatus());
             }
             case "school" -> {
                 Tenant tenant = tenantMapper.selectById(userId);
@@ -153,11 +157,11 @@ public class JwtAuthenticationFilter extends OncePerRequestFilter {
             }
             case "teacher" -> {
                 Teacher teacher = teacherMapper.selectById(userId);
-                yield teacher != null && "active".equalsIgnoreCase(teacher.getStatus());
+                yield teacher != null && GenericStatus.isActive(teacher.getStatus());
             }
             case "parent" -> {
                 Parent parent = parentMapper.selectById(userId);
-                yield parent != null && "active".equalsIgnoreCase(parent.getStatus());
+                yield parent != null && GenericStatus.isActive(parent.getStatus());
             }
             default -> false;
         };

reading-platform-java/src/main/java/com/reading/platform/common/security/SecurityUtils.java

@@ -1,7 +1,8 @@
 package com.reading.platform.common.security;
 
-import com.reading.platform.common.exception.BusinessException;
 import com.reading.platform.common.enums.ErrorCode;
+import com.reading.platform.common.enums.UserRole;
+import com.reading.platform.common.exception.BusinessException;
 import org.springframework.security.core.Authentication;
 import org.springframework.security.core.context.SecurityContextHolder;
 
@@ -33,6 +34,13 @@ public class SecurityUtils {
         return getCurrentUser().getRole();
     }
 
+    /**
+     * 获取当前用户角色枚举
+     */
+    public static UserRole getCurrentRoleEnum() {
+        return UserRole.fromCode(getCurrentRole());
+    }
+
     public static Long getCurrentTenantId() {
         return getCurrentUser().getTenantId();
     }
@@ -42,19 +50,19 @@ public class SecurityUtils {
     }
 
     public static boolean isAdmin() {
-        return "admin".equals(getCurrentRole());
+        return UserRole.ADMIN == getCurrentRoleEnum();
     }
 
     public static boolean isSchool() {
-        return "school".equals(getCurrentRole());
+        return UserRole.SCHOOL == getCurrentRoleEnum();
     }
 
     public static boolean isTeacher() {
-        return "teacher".equals(getCurrentRole());
+        return UserRole.TEACHER == getCurrentRoleEnum();
     }
 
     public static boolean isParent() {
-        return "parent".equals(getCurrentRole());
+        return UserRole.PARENT == getCurrentRoleEnum();
     }
 
 }

reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolExportController.java

@@ -2,15 +2,17 @@ package com.reading.platform.controller.school;
 
 import com.reading.platform.common.annotation.RequireRole;
 import com.reading.platform.common.enums.UserRole;
-import com.reading.platform.common.response.Result;
 import com.reading.platform.common.security.SecurityUtils;
+import com.reading.platform.service.SchoolExportService;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.servlet.http.HttpServletResponse;
 import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
 import org.springframework.web.bind.annotation.*;
 
-import java.util.HashMap;
+import java.io.IOException;
-import java.util.Map;
+import java.time.LocalDate;
 
 /**
  * 学校端 - 数据导出
@@ -20,53 +22,73 @@ import java.util.Map;
 @RequestMapping("/api/v1/school/export")
 @RequiredArgsConstructor
 @RequireRole(UserRole.SCHOOL)
+@Slf4j
 public class SchoolExportController {
 
+    private final SchoolExportService schoolExportService;
+
+    /**
+     * 导出授课记录
+     *
+     * @param startDate 开始日期（yyyy-MM-dd）
+     * @param endDate   结束日期（yyyy-MM-dd）
+     * @param response  HTTP 响应
+     */
     @GetMapping("/lessons")
     @Operation(summary = "导出授课记录")
-    public Result<Map<String, Object>> exportLessons(
+    public void exportLessons(
             @RequestParam(required = false) String startDate,
-            @RequestParam(required = false) String endDate) {
+            @RequestParam(required = false) String endDate,
-        // TODO: 实现导出授课记录
+            HttpServletResponse response) throws IOException {
         Long tenantId = SecurityUtils.getCurrentTenantId();
-        Map<String, Object> result = new HashMap<>();
+        log.info("学校端导出授课记录，租户 ID: {}, 时间范围：{} ~ {}", tenantId, startDate, endDate);
-        result.put("message", "导出功能待实现");
+
-        result.put("tenantId", tenantId);
+        schoolExportService.exportLessons(
-        return Result.success(result);
+                tenantId,
+                startDate != null && !startDate.isEmpty() ? LocalDate.parse(startDate) : null,
+                endDate != null && !endDate.isEmpty() ? LocalDate.parse(endDate) : null,
+                response
+        );
     }
 
+    /**
+     * 导出教师绩效统计
+     *
+     * @param startDate 开始日期（yyyy-MM-dd）
+     * @param endDate   结束日期（yyyy-MM-dd）
+     * @param response  HTTP 响应
+     */
     @GetMapping("/teacher-stats")
-    @Operation(summary = "导出教师统计")
+    @Operation(summary = "导出教师绩效统计")
-    public Result<Map<String, Object>> exportTeacherStats() {
+    public void exportTeacherStats(
-        // TODO: 实现导出教师统计
+            @RequestParam(required = false) String startDate,
+            @RequestParam(required = false) String endDate,
+            HttpServletResponse response) throws IOException {
         Long tenantId = SecurityUtils.getCurrentTenantId();
-        Map<String, Object> result = new HashMap<>();
+        log.info("学校端导出教师绩效统计，租户 ID: {}, 时间范围：{} ~ {}", tenantId, startDate, endDate);
-        result.put("message", "导出功能待实现");
+
-        result.put("tenantId", tenantId);
+        schoolExportService.exportTeacherStats(
-        return Result.success(result);
+                tenantId,
+                startDate != null && !startDate.isEmpty() ? LocalDate.parse(startDate) : null,
+                endDate != null && !endDate.isEmpty() ? LocalDate.parse(endDate) : null,
+                response
+        );
     }
 
+    /**
+     * 导出学生统计
+     *
+     * @param classId  班级 ID（可选，为空时导出全校）
+     * @param response HTTP 响应
+     */
     @GetMapping("/student-stats")
     @Operation(summary = "导出学生统计")
-    public Result<Map<String, Object>> exportStudentStats() {
+    public void exportStudentStats(
-        // TODO: 实现导出学生统计
+            @RequestParam(required = false) Long classId,
+            HttpServletResponse response) throws IOException {
         Long tenantId = SecurityUtils.getCurrentTenantId();
-        Map<String, Object> result = new HashMap<>();
+        log.info("学校端导出学生统计，租户 ID: {}, 班级 ID: {}", tenantId, classId);
-        result.put("message", "导出功能待实现");
-        result.put("tenantId", tenantId);
-        return Result.success(result);
-    }
 
-    @GetMapping("/growth-records")
+        schoolExportService.exportStudentStats(tenantId, classId, response);
-    @Operation(summary = "导出成长记录")
-    public Result<Map<String, Object>> exportGrowthRecords(
-            @RequestParam(required = false) Long studentId) {
-        // TODO: 实现导出成长记录
-        Long tenantId = SecurityUtils.getCurrentTenantId();
-        Map<String, Object> result = new HashMap<>();
-        result.put("message", "导出功能待实现");
-        result.put("tenantId", tenantId);
-        result.put("studentId", studentId);
-        return Result.success(result);
     }
 }

reading-platform-java/src/main/java/com/reading/platform/dto/response/LessonExportVO.java

@@ -0,0 +1,45 @@
+package com.reading.platform.dto.response;
+
+import com.alibaba.excel.annotation.ExcelProperty;
+import com.alibaba.excel.annotation.format.DateTimeFormat;
+import lombok.Data;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
+
+/**
+ * 授课记录导出 VO
+ */
+@Data
+public class LessonExportVO {
+
+    @ExcelProperty("授课日期")
+    @DateTimeFormat("yyyy-MM-dd")
+    private LocalDate lessonDate;
+
+    @ExcelProperty("授课时间")
+    private String timeRange;
+
+    @ExcelProperty("班级名称")
+    private String className;
+
+    @ExcelProperty("教师姓名")
+    private String teacherName;
+
+    @ExcelProperty("课程名称")
+    private String courseName;
+
+    @ExcelProperty("课程类型")
+    private String lessonType;
+
+    @ExcelProperty("学生人数")
+    private Integer studentCount;
+
+    @ExcelProperty("平均参与度")
+    private Double avgParticipation;
+
+    @ExcelProperty("评价反馈")
+    private String feedbackContent;
+
+}

reading-platform-java/src/main/java/com/reading/platform/dto/response/StudentStatExportVO.java

@@ -0,0 +1,30 @@
+package com.reading.platform.dto.response;
+
+import com.alibaba.excel.annotation.ExcelProperty;
+import lombok.Data;
+
+/**
+ * 学生统计导出 VO
+ */
+@Data
+public class StudentStatExportVO {
+
+    @ExcelProperty("学生姓名")
+    private String studentName;
+
+    @ExcelProperty("性别")
+    private String gender;
+
+    @ExcelProperty("班级")
+    private String className;
+
+    @ExcelProperty("授课次数")
+    private Integer lessonCount;
+
+    @ExcelProperty("平均参与度")
+    private Double avgParticipation;
+
+    @ExcelProperty("平均专注度")
+    private Double avgFocus;
+
+}

reading-platform-java/src/main/java/com/reading/platform/dto/response/TeacherPerformanceExportVO.java

@@ -0,0 +1,37 @@
+package com.reading.platform.dto.response;
+
+import com.alibaba.excel.annotation.ExcelProperty;
+import com.alibaba.excel.annotation.format.DateTimeFormat;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+/**
+ * 教师绩效导出 VO
+ */
+@Data
+public class TeacherPerformanceExportVO {
+
+    @ExcelProperty("教师姓名")
+    private String teacherName;
+
+    @ExcelProperty("所属班级")
+    private String classNames;
+
+    @ExcelProperty("授课次数")
+    private Integer lessonCount;
+
+    @ExcelProperty("课程数量")
+    private Integer courseCount;
+
+    @ExcelProperty("活跃等级")
+    private String activityLevel;
+
+    @ExcelProperty("最后活跃时间")
+    @DateTimeFormat("yyyy-MM-dd HH:mm:ss")
+    private LocalDateTime lastActiveAt;
+
+    @ExcelProperty("平均参与度")
+    private Double avgParticipation;
+
+}

reading-platform-java/src/main/java/com/reading/platform/mapper/LessonMapper.java

@@ -8,6 +8,7 @@ import org.apache.ibatis.annotations.Param;
 import org.apache.ibatis.annotations.Select;
 import org.apache.ibatis.annotations.SelectProvider;
 
+import java.time.LocalDate;
 import java.time.LocalDateTime;
 import java.util.List;
 import java.util.Map;
@@ -134,4 +135,164 @@ public interface LessonMapper extends BaseMapper<Lesson> {
     List<Map<String, Object>> countUsageByTenantAndCourseIds(
             @Param("tenantId") Long tenantId,
             @Param("courseIds") List<Long> courseIds);
+
+    /**
+     * 导出授课记录查询
+     * <p>
+     * 查询指定时间范围内的授课记录，包含班级、教师、课程、学生人数、平均参与度等信息
+     *
+     * @param tenantId  租户 ID
+     * @param startDate 开始日期
+     * @param endDate   结束日期
+     * @return 授课记录导出列表
+     */
+    @Select("<script>" +
+            "SELECT " +
+            "  l.lesson_date, " +
+            "  l.start_time, " +
+            "  l.end_time, " +
+            "  c.name AS className, " +
+            "  t.name AS teacherName, " +
+            "  cp.name AS courseName, " +
+            "  COALESCE(cl.lesson_type, '集体') AS lessonType, " +
+            "  COUNT(DISTINCT sr.student_id) AS studentCount, " +
+            "  AVG(sr.participation) AS avgParticipation, " +
+            "  l.notes AS feedbackContent " +
+            "FROM lesson l " +
+            "LEFT JOIN clazz c ON l.class_id = c.id " +
+            "LEFT JOIN teacher t ON l.teacher_id = t.id " +
+            "LEFT JOIN course_package cp ON l.course_id = cp.id " +
+            "LEFT JOIN student_record sr ON l.id = sr.lesson_id " +
+            "LEFT JOIN course_lesson cl ON l.course_id = cl.course_id AND cl.sort_order = 1 " +
+            "WHERE l.tenant_id = #{tenantId} " +
+            "  AND l.deleted = 0 " +
+            "<if test='startDate != null'>" +
+            "  AND l.lesson_date &gt;= #{startDate} " +
+            "</if>" +
+            "<if test='endDate != null'>" +
+            "  AND l.lesson_date &lt;= #{endDate} " +
+            "</if>" +
+            "GROUP BY l.id, l.lesson_date, l.start_time, l.end_time, c.name, t.name, cp.name, cl.lesson_type, l.notes " +
+            "ORDER BY l.lesson_date DESC, l.start_time DESC" +
+            "</script>")
+    List<Map<String, Object>> selectExportData(
+            @Param("tenantId") Long tenantId,
+            @Param("startDate") LocalDate startDate,
+            @Param("endDate") LocalDate endDate);
+
+    /**
+     * 导出教师绩效统计查询
+     * <p>
+     * 统计指定时间范围内教师的授课情况
+     *
+     * @param tenantId  租户 ID
+     * @param startDate 开始日期
+     * @param endDate   结束日期
+     * @return 教师绩效导出列表
+     */
+    @Select("<script>" +
+            "SELECT " +
+            "  t.name AS teacherName, " +
+            "  GROUP_CONCAT(DISTINCT c.name ORDER BY c.name SEPARATOR ',') AS classNames, " +
+            "  COUNT(l.id) AS lessonCount, " +
+            "  COUNT(DISTINCT l.course_id) AS courseCount, " +
+            "  CASE " +
+            "    WHEN COUNT(l.id) >= 20 THEN 'HIGH' " +
+            "    WHEN COUNT(l.id) >= 10 THEN 'MEDIUM' " +
+            "    WHEN COUNT(l.id) >= 1 THEN 'LOW' " +
+            "    ELSE 'INACTIVE' " +
+            "  END AS activityLevel, " +
+            "  MAX(l.end_datetime) AS lastActiveAt, " +
+            "  AVG(sr.participation) AS avgParticipation " +
+            "FROM teacher t " +
+            "LEFT JOIN lesson l ON t.id = l.teacher_id " +
+            "  AND l.status = 'COMPLETED' " +
+            "  AND l.deleted = 0 " +
+            "<if test='startDate != null'>" +
+            "  AND l.lesson_date &gt;= #{startDate} " +
+            "</if>" +
+            "<if test='endDate != null'>" +
+            "  AND l.lesson_date &lt;= #{endDate} " +
+            "</if>" +
+            "LEFT JOIN class_teacher ct ON t.id = ct.teacher_id " +
+            "LEFT JOIN clazz c ON ct.class_id = c.id " +
+            "LEFT JOIN student_record sr ON l.id = sr.lesson_id " +
+            "WHERE t.tenant_id = #{tenantId} " +
+            "  AND t.deleted = 0 " +
+            "  AND t.status = 'ACTIVE' " +
+            "GROUP BY t.id, t.name " +
+            "ORDER BY lessonCount DESC, lastActiveAt DESC" +
+            "</script>")
+    List<Map<String, Object>> selectTeacherExportData(
+            @Param("tenantId") Long tenantId,
+            @Param("startDate") LocalDate startDate,
+            @Param("endDate") LocalDate endDate);
+
+    /**
+     * 导出学生统计查询
+     * <p>
+     * 统计指定时间范围内学生的参与情况
+     *
+     * @param tenantId  租户 ID
+     * @param classId   班级 ID（可选，为 null 时统计全校）
+     * @return 学生统计导出列表
+     */
+    @Select("<script>" +
+            "SELECT " +
+            "  s.name AS studentName, " +
+            "  s.gender, " +
+            "  s.grade AS className, " +
+            "  COUNT(DISTINCT l.id) AS lessonCount, " +
+            "  AVG(sr.participation) AS avgParticipation, " +
+            "  AVG(sr.focus) AS avgFocus " +
+            "FROM student s " +
+            "LEFT JOIN student_record sr ON s.id = sr.student_id " +
+            "LEFT JOIN lesson l ON sr.lesson_id = l.id " +
+            "  AND l.status = 'COMPLETED' " +
+            "  AND l.deleted = 0 " +
+            "WHERE s.tenant_id = #{tenantId} " +
+            "  AND s.deleted = 0 " +
+            "GROUP BY s.id, s.name, s.gender, s.grade " +
+            "ORDER BY s.name" +
+            "</script>")
+    List<Map<String, Object>> selectStudentExportData(
+            @Param("tenantId") Long tenantId,
+            @Param("classId") Long classId);
+
+    /**
+     * 获取教师今日课程（带课程名称和班级名称）
+     *
+     * @param teacherId 教师 ID
+     * @param today     今日日期
+     * @return 今日课程列表
+     */
+    @Select("<script>" +
+            "SELECT " +
+            "  l.id, " +
+            "  l.tenant_id, " +
+            "  l.course_id, " +
+            "  l.class_id, " +
+            "  l.teacher_id, " +
+            "  l.title, " +
+            "  l.lesson_date, " +
+            "  l.start_time, " +
+            "  l.end_time, " +
+            "  l.location, " +
+            "  l.status, " +
+            "  l.notes, " +
+            "  l.created_at, " +
+            "  l.updated_at, " +
+            "  cp.name AS courseName, " +
+            "  c.name AS className " +
+            "FROM lesson l " +
+            "LEFT JOIN course_package cp ON l.course_id = cp.id " +
+            "LEFT JOIN clazz c ON l.class_id = c.id " +
+            "WHERE l.teacher_id = #{teacherId} " +
+            "  AND l.lesson_date = #{today} " +
+            "  AND l.deleted = 0 " +
+            "ORDER BY l.start_time ASC" +
+            "</script>")
+    List<Map<String, Object>> selectTodayLessonsWithDetails(
+            @Param("teacherId") Long teacherId,
+            @Param("today") LocalDate today);
 }

reading-platform-java/src/main/java/com/reading/platform/service/SchoolExportService.java

@@ -0,0 +1,44 @@
+package com.reading.platform.service;
+
+import jakarta.servlet.http.HttpServletResponse;
+
+import java.io.IOException;
+import java.time.LocalDate;
+
+/**
+ * 学校端 - 数据导出服务
+ */
+public interface SchoolExportService {
+
+    /**
+     * 导出授课记录
+     *
+     * @param tenantId  租户 ID
+     * @param startDate 开始日期
+     * @param endDate   结束日期
+     * @param response  HTTP 响应
+     * @throws IOException IO 异常
+     */
+    void exportLessons(Long tenantId, LocalDate startDate, LocalDate endDate, HttpServletResponse response) throws IOException;
+
+    /**
+     * 导出教师绩效统计
+     *
+     * @param tenantId  租户 ID
+     * @param startDate 开始日期
+     * @param endDate   结束日期
+     * @param response  HTTP 响应
+     * @throws IOException IO 异常
+     */
+    void exportTeacherStats(Long tenantId, LocalDate startDate, LocalDate endDate, HttpServletResponse response) throws IOException;
+
+    /**
+     * 导出学生统计
+     *
+     * @param tenantId 租户 ID
+     * @param classId  班级 ID（可选）
+     * @param response HTTP 响应
+     * @throws IOException IO 异常
+     */
+    void exportStudentStats(Long tenantId, Long classId, HttpServletResponse response) throws IOException;
+}

reading-platform-java/src/main/java/com/reading/platform/service/impl/AuthServiceImpl.java

@@ -2,6 +2,7 @@ package com.reading.platform.service.impl;
 
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
 import com.reading.platform.common.enums.ErrorCode;
+import com.reading.platform.common.enums.GenericStatus;
 import com.reading.platform.common.enums.TenantStatus;
 import com.reading.platform.common.enums.UserRole;
 import com.reading.platform.common.exception.BusinessException;
@@ -65,7 +66,7 @@ public class AuthServiceImpl implements AuthService {
                 log.warn("登录失败：密码错误，用户名：{}", username);
                 throw new BusinessException(ErrorCode.LOGIN_FAILED);
             }
-            if (!"active".equalsIgnoreCase(adminUser.getStatus())) {
+            if (!GenericStatus.isActive(adminUser.getStatus())) {
                 log.warn("登录失败：账户已禁用，用户名：{}", username);
                 throw new BusinessException(ErrorCode.ACCOUNT_DISABLED);
             }
@@ -76,7 +77,7 @@ public class AuthServiceImpl implements AuthService {
             JwtPayload payload = JwtPayload.builder()
                     .userId(adminUser.getId())
                     .username(adminUser.getUsername())
-                    .role("admin")
+                    .role(UserRole.ADMIN.getCode())
                     .tenantId(null)
                     .name(adminUser.getName())
                     .build();
@@ -91,7 +92,7 @@ public class AuthServiceImpl implements AuthService {
                     .userId(adminUser.getId())
                     .username(adminUser.getUsername())
                     .name(adminUser.getName())
-                    .role("admin")
+                    .role(UserRole.ADMIN.getCode())
                     .tenantId(null)
                     .build();
         }
@@ -105,7 +106,7 @@ public class AuthServiceImpl implements AuthService {
                 log.warn("登录失败：密码错误，用户名：{}", username);
                 throw new BusinessException(ErrorCode.LOGIN_FAILED);
             }
-            if (!"active".equalsIgnoreCase(teacher.getStatus())) {
+            if (!GenericStatus.isActive(teacher.getStatus())) {
                 log.warn("登录失败：账户已禁用，用户名：{}", username);
                 throw new BusinessException(ErrorCode.ACCOUNT_DISABLED);
             }
@@ -122,7 +123,7 @@ public class AuthServiceImpl implements AuthService {
             JwtPayload payload = JwtPayload.builder()
                     .userId(teacher.getId())
                     .username(teacher.getUsername())
-                    .role("teacher")
+                    .role(UserRole.TEACHER.getCode())
                     .tenantId(teacher.getTenantId())
                     .name(teacher.getName())
                     .build();
@@ -137,7 +138,7 @@ public class AuthServiceImpl implements AuthService {
                     .userId(teacher.getId())
                     .username(teacher.getUsername())
                     .name(teacher.getName())
-                    .role("teacher")
+                    .role(UserRole.TEACHER.getCode())
                     .tenantId(teacher.getTenantId())
                     .build();
         }
@@ -151,7 +152,7 @@ public class AuthServiceImpl implements AuthService {
                 log.warn("登录失败：密码错误，用户名：{}", username);
                 throw new BusinessException(ErrorCode.LOGIN_FAILED);
             }
-            if (!"active".equalsIgnoreCase(parent.getStatus())) {
+            if (!GenericStatus.isActive(parent.getStatus())) {
                 log.warn("登录失败：账户已禁用，用户名：{}", username);
                 throw new BusinessException(ErrorCode.ACCOUNT_DISABLED);
             }
@@ -162,7 +163,7 @@ public class AuthServiceImpl implements AuthService {
             JwtPayload payload = JwtPayload.builder()
                     .userId(parent.getId())
                     .username(parent.getUsername())
-                    .role("parent")
+                    .role(UserRole.PARENT.getCode())
                     .tenantId(parent.getTenantId())
                     .name(parent.getName())
                     .build();
@@ -177,7 +178,7 @@ public class AuthServiceImpl implements AuthService {
                     .userId(parent.getId())
                     .username(parent.getUsername())
                     .name(parent.getName())
-                    .role("parent")
+                    .role(UserRole.PARENT.getCode())
                     .tenantId(parent.getTenantId())
                     .build();
         }
@@ -199,7 +200,7 @@ public class AuthServiceImpl implements AuthService {
             JwtPayload payload = JwtPayload.builder()
                     .userId(tenant.getId())
                     .username(tenant.getUsername())
-                    .role("school")
+                    .role(UserRole.SCHOOL.getCode())
                     .tenantId(tenant.getId())
                     .name(tenant.getName())
                     .build();
@@ -214,7 +215,7 @@ public class AuthServiceImpl implements AuthService {
                     .userId(tenant.getId())
                     .username(tenant.getUsername())
                     .name(tenant.getName())
-                    .role("school")
+                    .role(UserRole.SCHOOL.getCode())
                     .tenantId(tenant.getId())
                     .build();
         }
@@ -235,7 +236,7 @@ public class AuthServiceImpl implements AuthService {
                     log.warn("登录失败：用户不存在或密码错误，用户名：{}", username);
                     throw new BusinessException(ErrorCode.LOGIN_FAILED);
                 }
-                if (!"active".equalsIgnoreCase(adminUser.getStatus())) {
+                if (!GenericStatus.isActive(adminUser.getStatus())) {
                     log.warn("登录失败：账户已禁用，用户名：{}", username);
                     throw new BusinessException(ErrorCode.ACCOUNT_DISABLED);
                 }
@@ -246,7 +247,7 @@ public class AuthServiceImpl implements AuthService {
                 JwtPayload payload = JwtPayload.builder()
                         .userId(adminUser.getId())
                         .username(adminUser.getUsername())
-                        .role("admin")
+                        .role(UserRole.ADMIN.getCode())
                         .tenantId(null)
                         .name(adminUser.getName())
                         .build();
@@ -260,7 +261,7 @@ public class AuthServiceImpl implements AuthService {
                         .userId(adminUser.getId())
                         .username(adminUser.getUsername())
                         .name(adminUser.getName())
-                        .role("admin")
+                        .role(UserRole.ADMIN.getCode())
                         .tenantId(null)
                         .build();
             }
@@ -272,7 +273,7 @@ public class AuthServiceImpl implements AuthService {
                     log.warn("登录失败：用户不存在或密码错误，用户名：{}", username);
                     throw new BusinessException(ErrorCode.LOGIN_FAILED);
                 }
-                if (!"active".equalsIgnoreCase(tenant.getStatus())) {
+                if (!GenericStatus.isActive(tenant.getStatus())) {
                     log.warn("登录失败：账户已禁用，用户名：{}", username);
                     throw new BusinessException(ErrorCode.ACCOUNT_DISABLED);
                 }
@@ -280,7 +281,7 @@ public class AuthServiceImpl implements AuthService {
                 JwtPayload payload = JwtPayload.builder()
                         .userId(tenant.getId())
                         .username(tenant.getUsername())
-                        .role("school")
+                        .role(UserRole.SCHOOL.getCode())
                         .tenantId(tenant.getId())
                         .name(tenant.getName())
                         .build();
@@ -294,7 +295,7 @@ public class AuthServiceImpl implements AuthService {
                         .userId(tenant.getId())
                         .username(tenant.getUsername())
                         .name(tenant.getName())
-                        .role("school")
+                        .role(UserRole.SCHOOL.getCode())
                         .tenantId(tenant.getId())
                         .build();
             }
@@ -306,7 +307,7 @@ public class AuthServiceImpl implements AuthService {
                     log.warn("登录失败：用户不存在或密码错误，用户名：{}", username);
                     throw new BusinessException(ErrorCode.LOGIN_FAILED);
                 }
-                if (!"active".equalsIgnoreCase(teacher.getStatus())) {
+                if (!GenericStatus.isActive(teacher.getStatus())) {
                     log.warn("登录失败：账户已禁用，用户名：{}", username);
                     throw new BusinessException(ErrorCode.ACCOUNT_DISABLED);
                 }
@@ -323,7 +324,7 @@ public class AuthServiceImpl implements AuthService {
                 JwtPayload payload = JwtPayload.builder()
                         .userId(teacher.getId())
                         .username(teacher.getUsername())
-                        .role("teacher")
+                        .role(UserRole.TEACHER.getCode())
                         .tenantId(teacher.getTenantId())
                         .name(teacher.getName())
                         .build();
@@ -337,7 +338,7 @@ public class AuthServiceImpl implements AuthService {
                         .userId(teacher.getId())
                         .username(teacher.getUsername())
                         .name(teacher.getName())
-                        .role("teacher")
+                        .role(UserRole.TEACHER.getCode())
                         .tenantId(teacher.getTenantId())
                         .build();
             }
@@ -349,7 +350,7 @@ public class AuthServiceImpl implements AuthService {
                     log.warn("登录失败：用户不存在或密码错误，用户名：{}", username);
                     throw new BusinessException(ErrorCode.LOGIN_FAILED);
                 }
-                if (!"active".equalsIgnoreCase(parent.getStatus())) {
+                if (!GenericStatus.isActive(parent.getStatus())) {
                     log.warn("登录失败：账户已禁用，用户名：{}", username);
                     throw new BusinessException(ErrorCode.ACCOUNT_DISABLED);
                 }
@@ -360,7 +361,7 @@ public class AuthServiceImpl implements AuthService {
                 JwtPayload payload = JwtPayload.builder()
                         .userId(parent.getId())
                         .username(parent.getUsername())
-                        .role("parent")
+                        .role(UserRole.PARENT.getCode())
                         .tenantId(parent.getTenantId())
                         .name(parent.getName())
                         .build();
@@ -374,7 +375,7 @@ public class AuthServiceImpl implements AuthService {
                         .userId(parent.getId())
                         .username(parent.getUsername())
                         .name(parent.getName())
-                        .role("parent")
+                        .role(UserRole.PARENT.getCode())
                         .tenantId(parent.getTenantId())
                         .build();
             }
@@ -418,8 +419,8 @@ public class AuthServiceImpl implements AuthService {
         String role = payload.getRole();
         Long userId = payload.getUserId();
 
-        switch (role) {
+        switch (UserRole.fromCode(role)) {
-            case "admin" -> {
+            case ADMIN -> {
                 AdminUser adminUser = adminUserMapper.selectById(userId);
                 if (!passwordEncoder.matches(oldPassword, adminUser.getPassword())) {
                     log.warn("旧密码错误，用户 ID: {}", userId);
@@ -429,7 +430,7 @@ public class AuthServiceImpl implements AuthService {
                 adminUserMapper.updateById(adminUser);
                 log.info("管理员密码修改成功，用户 ID: {}", userId);
             }
-            case "school" -> {
+            case SCHOOL -> {
                 Tenant tenant = tenantMapper.selectById(userId);
                 if (!passwordEncoder.matches(oldPassword, tenant.getPassword())) {
                     log.warn("旧密码错误，用户 ID: {}", userId);
@@ -439,7 +440,7 @@ public class AuthServiceImpl implements AuthService {
                 tenantMapper.updateById(tenant);
                 log.info("租户密码修改成功，用户 ID: {}", userId);
             }
-            case "teacher" -> {
+            case TEACHER -> {
                 Teacher teacher = teacherMapper.selectById(userId);
                 if (!passwordEncoder.matches(oldPassword, teacher.getPassword())) {
                     log.warn("旧密码错误，用户 ID: {}", userId);
@@ -449,7 +450,7 @@ public class AuthServiceImpl implements AuthService {
                 teacherMapper.updateById(teacher);
                 log.info("教师密码修改成功，用户 ID: {}", userId);
             }
-            case "parent" -> {
+            case PARENT -> {
                 Parent parent = parentMapper.selectById(userId);
                 if (!passwordEncoder.matches(oldPassword, parent.getPassword())) {
                     log.warn("旧密码错误，用户 ID: {}", userId);
@@ -507,8 +508,8 @@ public class AuthServiceImpl implements AuthService {
         Long userId = payload.getUserId();
 
         // 根据角色更新对应表的字段
-        switch (role) {
+        switch (UserRole.fromCode(role)) {
-            case "admin" -> {
+            case ADMIN -> {
                 AdminUser adminUser = adminUserMapper.selectById(userId);
                 if (request.getName() != null) {
                     adminUser.setName(request.getName());
@@ -522,7 +523,7 @@ public class AuthServiceImpl implements AuthService {
                 adminUserMapper.updateById(adminUser);
                 log.info("管理员信息修改成功，用户 ID: {}", userId);
             }
-            case "school" -> {
+            case SCHOOL -> {
                 Tenant tenant = tenantMapper.selectById(userId);
                 if (request.getName() != null) {
                     tenant.setContactName(request.getName());
@@ -536,7 +537,7 @@ public class AuthServiceImpl implements AuthService {
                 tenantMapper.updateById(tenant);
                 log.info("租户信息修改成功，用户 ID: {}", userId);
             }
-            case "teacher" -> {
+            case TEACHER -> {
                 Teacher teacher = teacherMapper.selectById(userId);
                 if (request.getName() != null) {
                     teacher.setName(request.getName());
@@ -550,7 +551,7 @@ public class AuthServiceImpl implements AuthService {
                 teacherMapper.updateById(teacher);
                 log.info("教师信息修改成功，用户 ID: {}", userId);
             }
-            case "parent" -> {
+            case PARENT -> {
                 Parent parent = parentMapper.selectById(userId);
                 if (request.getName() != null) {
                     parent.setName(request.getName());
@@ -597,7 +598,7 @@ public class AuthServiceImpl implements AuthService {
                     .email(tenant.getContactEmail())
                     .phone(tenant.getContactPhone())
                     .avatarUrl(tenant.getLogoUrl())
-                    .role("school")
+                    .role(UserRole.SCHOOL.getCode())
                     .tenantId(tenant.getId())
                     .build();
         } else if (userInfo instanceof Teacher) {
@@ -609,7 +610,7 @@ public class AuthServiceImpl implements AuthService {
                     .email(teacher.getEmail())
                     .phone(teacher.getPhone())
                     .avatarUrl(teacher.getAvatarUrl())
-                    .role("teacher")
+                    .role(UserRole.TEACHER.getCode())
                     .tenantId(teacher.getTenantId())
                     .build();
         } else if (userInfo instanceof Parent) {
@@ -621,7 +622,7 @@ public class AuthServiceImpl implements AuthService {
                     .email(parent.getEmail())
                     .phone(parent.getPhone())
                     .avatarUrl(parent.getAvatarUrl())
-                    .role("parent")
+                    .role(UserRole.PARENT.getCode())
                     .tenantId(parent.getTenantId())
                     .build();
         } else if (userInfo instanceof AdminUser) {
@@ -633,7 +634,7 @@ public class AuthServiceImpl implements AuthService {
                     .email(adminUser.getEmail())
                     .phone(adminUser.getPhone())
                     .avatarUrl(adminUser.getAvatarUrl())
-                    .role("admin")
+                    .role(UserRole.ADMIN.getCode())
                     .tenantId(null)
                     .build();
         }

reading-platform-java/src/main/java/com/reading/platform/service/impl/ClassServiceImpl.java

@@ -2,6 +2,7 @@ package com.reading.platform.service.impl;
 
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
 import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.reading.platform.common.enums.GenericStatus;
 import com.reading.platform.common.enums.ErrorCode;
 import com.reading.platform.common.exception.BusinessException;
 import com.reading.platform.dto.request.ClassCreateRequest;
@@ -47,7 +48,7 @@ public class ClassServiceImpl extends com.baomidou.mybatisplus.extension.service
         clazz.setGrade(request.getGrade());
         clazz.setDescription(request.getDescription());
         clazz.setCapacity(request.getCapacity() != null ? request.getCapacity() : 30);
-        clazz.setStatus("active");
+        clazz.setStatus(GenericStatus.ACTIVE.getCode());
 
         clazzMapper.insert(clazz);
 
@@ -196,7 +197,7 @@ public class ClassServiceImpl extends com.baomidou.mybatisplus.extension.service
         List<StudentClassHistory> existingHistories = studentClassHistoryMapper.selectList(
                 new LambdaQueryWrapper<StudentClassHistory>()
                         .eq(StudentClassHistory::getClassId, classId)
-                        .eq(StudentClassHistory::getStatus, "active")
+                        .eq(StudentClassHistory::getStatus, GenericStatus.ACTIVE.getCode())
                         .isNull(StudentClassHistory::getEndDate)
         );
 
@@ -211,7 +212,7 @@ public class ClassServiceImpl extends com.baomidou.mybatisplus.extension.service
             history.setStudentId(studentId);
             history.setClassId(classId);
             history.setStartDate(LocalDate.now());
-            history.setStatus("active");
+            history.setStatus(GenericStatus.ACTIVE.getCode());
             studentClassHistoryMapper.insert(history);
         }
 
@@ -245,7 +246,7 @@ public class ClassServiceImpl extends com.baomidou.mybatisplus.extension.service
         List<StudentClassHistory> existing = studentClassHistoryMapper.selectList(
                 new LambdaQueryWrapper<StudentClassHistory>()
                         .eq(StudentClassHistory::getStudentId, studentId)
-                        .in(StudentClassHistory::getStatus, "active", "ACTIVE")
+                        .in(StudentClassHistory::getStatus, GenericStatus.ACTIVE.getCode())
                         .and(w -> w.isNull(StudentClassHistory::getEndDate)
                                 .or()
                                 .ge(StudentClassHistory::getEndDate, LocalDate.now()))
@@ -259,7 +260,7 @@ public class ClassServiceImpl extends com.baomidou.mybatisplus.extension.service
         history.setStudentId(studentId);
         history.setClassId(classId);
         history.setStartDate(LocalDate.now());
-        history.setStatus("active");
+        history.setStatus(GenericStatus.ACTIVE.getCode());
         studentClassHistoryMapper.insert(history);
     }
 
@@ -295,7 +296,7 @@ public class ClassServiceImpl extends com.baomidou.mybatisplus.extension.service
         return clazzMapper.selectList(
                 new LambdaQueryWrapper<Clazz>()
                         .eq(Clazz::getTenantId, tenantId)
-                        .eq(Clazz::getStatus, "active")
+                        .eq(Clazz::getStatus, GenericStatus.ACTIVE.getCode())
         );
     }
 
@@ -320,7 +321,7 @@ public class ClassServiceImpl extends com.baomidou.mybatisplus.extension.service
         StudentClassHistory history = studentClassHistoryMapper.selectOne(
                 new LambdaQueryWrapper<StudentClassHistory>()
                         .eq(StudentClassHistory::getStudentId, studentId)
-                        .in(StudentClassHistory::getStatus, "active", "ACTIVE")
+                        .in(StudentClassHistory::getStatus, GenericStatus.ACTIVE.getCode())
                         .and(w -> w.isNull(StudentClassHistory::getEndDate)
                                 .or()
                                 .ge(StudentClassHistory::getEndDate, LocalDate.now()))

reading-platform-java/src/main/java/com/reading/platform/service/impl/NotificationServiceImpl.java

@@ -5,6 +5,7 @@ import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
 import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
 import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
 import com.reading.platform.common.enums.ErrorCode;
+import com.reading.platform.common.enums.NotificationRecipientType;
 import com.reading.platform.common.exception.BusinessException;
 import com.reading.platform.entity.Notification;
 import com.reading.platform.mapper.NotificationMapper;
@@ -82,7 +83,7 @@ public class NotificationServiceImpl extends ServiceImpl<NotificationMapper, Not
         LambdaQueryWrapper<Notification> wrapper = new LambdaQueryWrapper<>();
 
         wrapper.and(w -> w
-                .eq(Notification::getRecipientType, "all")
+                .eq(Notification::getRecipientType, NotificationRecipientType.ALL.getCode())
                 .or()
                 .eq(Notification::getRecipientId, recipientId)
         );
@@ -117,7 +118,7 @@ public class NotificationServiceImpl extends ServiceImpl<NotificationMapper, Not
                         .set(Notification::getReadAt, LocalDateTime.now())
                         .eq(Notification::getIsRead, 0)
                         .and(w -> w
-                                .eq(Notification::getRecipientType, "all")
+                                .eq(Notification::getRecipientType, NotificationRecipientType.ALL.getCode())
                                 .or()
                                 .eq(Notification::getRecipientId, recipientId)
                         )
@@ -138,7 +139,7 @@ public class NotificationServiceImpl extends ServiceImpl<NotificationMapper, Not
                 new LambdaQueryWrapper<Notification>()
                         .eq(Notification::getIsRead, 0)
                         .and(w -> w
-                                .eq(Notification::getRecipientType, "all")
+                                .eq(Notification::getRecipientType, NotificationRecipientType.ALL.getCode())
                                 .or()
                                 .eq(Notification::getRecipientId, recipientId)
                         )

reading-platform-java/src/main/java/com/reading/platform/service/impl/ParentChildServiceImpl.java

@@ -1,6 +1,7 @@
 package com.reading.platform.service.impl;
 
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.reading.platform.common.enums.GenericStatus;
 import com.reading.platform.dto.response.ChildInfoResponse;
 import com.reading.platform.dto.response.ChildProfileResponse;
 import com.reading.platform.entity.*;
@@ -54,7 +55,7 @@ public class ParentChildServiceImpl implements ParentChildService {
         List<Student> students = studentMapper.selectList(
                 new LambdaQueryWrapper<Student>()
                         .in(Student::getId, studentIds)
-                        .eq(Student::getStatus, "active")
+                        .eq(Student::getStatus, GenericStatus.ACTIVE.getCode())
         );
 
         List<ChildInfoResponse> result = new ArrayList<>();

reading-platform-java/src/main/java/com/reading/platform/service/impl/ParentServiceImpl.java

@@ -2,6 +2,7 @@ package com.reading.platform.service.impl;
 
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
 import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.reading.platform.common.enums.GenericStatus;
 import com.reading.platform.common.enums.ErrorCode;
 import com.reading.platform.common.exception.BusinessException;
 import com.reading.platform.dto.request.ParentCreateRequest;
@@ -53,7 +54,7 @@ public class ParentServiceImpl extends com.baomidou.mybatisplus.extension.servic
         parent.setPhone(request.getPhone());
         parent.setEmail(request.getEmail());
         parent.setGender(request.getGender());
-        parent.setStatus("active");
+        parent.setStatus(GenericStatus.ACTIVE.getCode());
 
         parentMapper.insert(parent);
 

reading-platform-java/src/main/java/com/reading/platform/service/impl/ResourceLibraryServiceImpl.java

@@ -4,6 +4,7 @@ import com.alibaba.fastjson2.JSON;
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
 import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
 import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
+import com.reading.platform.common.enums.GenericStatus;
 import com.reading.platform.common.exception.BusinessException;
 import com.reading.platform.entity.ResourceItem;
 import com.reading.platform.entity.ResourceLibrary;
@@ -87,7 +88,7 @@ public class ResourceLibraryServiceImpl extends ServiceImpl<ResourceLibraryMappe
         library.setLibraryType(type);
         library.setDescription(description);
         library.setTenantId(tenantId);
-        library.setStatus("ACTIVE");
+        library.setStatus(GenericStatus.ACTIVE.getCode());
         library.setSortOrder(0);
 
         libraryMapper.insert(library);

reading-platform-java/src/main/java/com/reading/platform/service/impl/SchoolExportServiceImpl.java

@@ -0,0 +1,312 @@
+package com.reading.platform.service.impl;
+
+import com.alibaba.excel.EasyExcel;
+import com.alibaba.excel.write.style.column.LongestMatchColumnWidthStyleStrategy;
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.reading.platform.common.response.Result;
+import com.reading.platform.dto.response.LessonExportVO;
+import com.reading.platform.dto.response.StudentStatExportVO;
+import com.reading.platform.dto.response.TeacherPerformanceExportVO;
+import com.reading.platform.entity.Clazz;
+import com.reading.platform.mapper.ClazzMapper;
+import com.reading.platform.mapper.LessonMapper;
+import com.reading.platform.service.SchoolExportService;
+import jakarta.servlet.http.HttpServletResponse;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.io.IOException;
+import java.net.URLEncoder;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
+import java.time.format.DateTimeFormatter;
+import java.util.ArrayList;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+/**
+ * 学校端 - 数据导出服务实现类
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class SchoolExportServiceImpl implements SchoolExportService {
+
+    private final LessonMapper lessonMapper;
+    private final ClazzMapper clazzMapper;
+
+    private static final DateTimeFormatter TIME_FORMATTER = DateTimeFormatter.ofPattern("HH:mm");
+
+    @Override
+    public void exportLessons(Long tenantId, LocalDate startDate, LocalDate endDate, HttpServletResponse response) throws IOException {
+        log.info("导出授课记录，租户 ID: {}, 时间范围：{} ~ {}", tenantId, startDate, endDate);
+
+        // 1. 查询数据
+        List<Map<String, Object>> rawData = lessonMapper.selectExportData(tenantId, startDate, endDate);
+
+        // 2. 空数据处理 - 返回 JSON 响应
+        if (rawData == null || rawData.isEmpty()) {
+            response.setContentType("application/json;charset=UTF-8");
+            response.getWriter().write(com.alibaba.fastjson2.JSON.toJSONString(
+                    Result.error(404, "指定时间范围内暂无授课记录")
+            ));
+            return;
+        }
+
+        // 3. 转换为 VO 对象
+        List<LessonExportVO> data = rawData.stream().map(row -> {
+            LessonExportVO vo = new LessonExportVO();
+            // 修复：SQL 返回的是 java.sql.Date，需要转换为 LocalDate
+            Object dateObj = row.get("lesson_date");
+            if (dateObj instanceof java.sql.Date) {
+                vo.setLessonDate(((java.sql.Date) dateObj).toLocalDate());
+            } else if (dateObj instanceof LocalDate) {
+                vo.setLessonDate((LocalDate) dateObj);
+            }
+
+            // 格式化时间范围 - 修复：SQL 返回的是 java.sql.Time
+            Object startTimeObj = row.get("start_time");
+            Object endTimeObj = row.get("end_time");
+            if (startTimeObj instanceof java.sql.Time && endTimeObj instanceof java.sql.Time) {
+                vo.setTimeRange(
+                    ((java.sql.Time) startTimeObj).toLocalTime().format(TIME_FORMATTER) + "-" +
+                    ((java.sql.Time) endTimeObj).toLocalTime().format(TIME_FORMATTER)
+                );
+            } else if (startTimeObj instanceof LocalTime && endTimeObj instanceof LocalTime) {
+                vo.setTimeRange(
+                    ((LocalTime) startTimeObj).format(TIME_FORMATTER) + "-" +
+                    ((LocalTime) endTimeObj).format(TIME_FORMATTER)
+                );
+            }
+
+            vo.setClassName(getStringValue(row, "className"));
+            vo.setTeacherName(getStringValue(row, "teacherName"));
+            vo.setCourseName(getStringValue(row, "courseName"));
+            // 修复：课程类型需要从 lessonType 字段获取，并翻译成中文
+            String lessonTypeCode = getStringValue(row, "lessonType");
+            vo.setLessonType(translateLessonType(lessonTypeCode));
+            vo.setStudentCount(getIntValue(row, "studentCount"));
+            vo.setAvgParticipation(getDoubleValue(row, "avgParticipation"));
+            vo.setFeedbackContent(getStringValue(row, "feedbackContent"));
+            return vo;
+        }).toList();
+
+        // 4. 设置响应头
+        setupExcelResponse(response, "授课记录");
+
+        // 5. 使用 EasyExcel 导出
+        EasyExcel.write(response.getOutputStream(), LessonExportVO.class)
+                .registerWriteHandler(new LongestMatchColumnWidthStyleStrategy())
+                .sheet("授课记录")
+                .doWrite(data);
+
+        log.info("授课记录导出成功，共{}条记录", data.size());
+    }
+
+    @Override
+    public void exportTeacherStats(Long tenantId, LocalDate startDate, LocalDate endDate, HttpServletResponse response) throws IOException {
+        log.info("导出教师绩效统计，租户 ID: {}, 时间范围：{} ~ {}", tenantId, startDate, endDate);
+
+        // 1. 查询数据
+        List<Map<String, Object>> rawData = lessonMapper.selectTeacherExportData(tenantId, startDate, endDate);
+
+        // 2. 空数据处理
+        if (rawData == null || rawData.isEmpty()) {
+            response.setContentType("application/json;charset=UTF-8");
+            response.getWriter().write(com.alibaba.fastjson2.JSON.toJSONString(
+                    Result.error(404, "指定时间范围内暂无教师绩效数据")
+            ));
+            return;
+        }
+
+        // 3. 转换为 VO 对象
+        List<TeacherPerformanceExportVO> data = rawData.stream().map(row -> {
+            TeacherPerformanceExportVO vo = new TeacherPerformanceExportVO();
+            vo.setTeacherName(getStringValue(row, "teacherName"));
+            vo.setClassNames(getStringValue(row, "classNames"));
+            vo.setLessonCount(getIntValue(row, "lessonCount"));
+            vo.setCourseCount(getIntValue(row, "courseCount"));
+            // 修复：将活跃等级代码翻译成中文
+            String activityLevelCode = getStringValue(row, "activityLevel");
+            vo.setActivityLevel(translateActivityLevel(activityLevelCode));
+            // 修复：SQL 返回的是 java.sql.Timestamp，需要转换为 LocalDateTime
+            Object lastActiveAtObj = row.get("lastActiveAt");
+            if (lastActiveAtObj instanceof java.sql.Timestamp) {
+                vo.setLastActiveAt(((java.sql.Timestamp) lastActiveAtObj).toLocalDateTime());
+            } else if (lastActiveAtObj instanceof LocalDateTime) {
+                vo.setLastActiveAt((LocalDateTime) lastActiveAtObj);
+            }
+            vo.setAvgParticipation(getDoubleValue(row, "avgParticipation"));
+            return vo;
+        }).toList();
+
+        // 4. 设置响应头
+        setupExcelResponse(response, "教师绩效统计");
+
+        // 5. 使用 EasyExcel 导出
+        EasyExcel.write(response.getOutputStream(), TeacherPerformanceExportVO.class)
+                .registerWriteHandler(new LongestMatchColumnWidthStyleStrategy())
+                .sheet("教师绩效")
+                .doWrite(data);
+
+        log.info("教师绩效统计导出成功，共{}条记录", data.size());
+    }
+
+    @Override
+    public void exportStudentStats(Long tenantId, Long classId, HttpServletResponse response) throws IOException {
+        log.info("导出学生统计，租户 ID: {}, 班级 ID: {}", tenantId, classId);
+
+        // 1. 查询数据
+        List<Map<String, Object>> rawData = lessonMapper.selectStudentExportData(tenantId, classId);
+
+        // 2. 空数据处理
+        if (rawData == null || rawData.isEmpty()) {
+            response.setContentType("application/json;charset=UTF-8");
+            response.getWriter().write(com.alibaba.fastjson2.JSON.toJSONString(
+                    Result.error(404, "暂无学生统计数据")
+            ));
+            return;
+        }
+
+        // 3. 转换为 VO 对象
+        List<StudentStatExportVO> data = rawData.stream().map(row -> {
+            StudentStatExportVO vo = new StudentStatExportVO();
+            vo.setStudentName(getStringValue(row, "studentName"));
+            vo.setGender(getStringValue(row, "gender"));
+            vo.setClassName(getStringValue(row, "className"));
+            vo.setLessonCount(getIntValue(row, "lessonCount"));
+            vo.setAvgParticipation(getDoubleValue(row, "avgParticipation"));
+            vo.setAvgFocus(getDoubleValue(row, "avgFocus"));
+            return vo;
+        }).toList();
+
+        // 4. 设置响应头
+        String fileName = classId != null ? getClassName(classId) + "_学生统计" : "全校学生统计";
+        setupExcelResponse(response, fileName);
+
+        // 5. 使用 EasyExcel 导出
+        EasyExcel.write(response.getOutputStream(), StudentStatExportVO.class)
+                .registerWriteHandler(new LongestMatchColumnWidthStyleStrategy())
+                .sheet("学生统计")
+                .doWrite(data);
+
+        log.info("学生统计导出成功，共{}条记录", data.size());
+    }
+
+    /**
+     * 获取班级名称
+     */
+    private String getClassName(Long classId) {
+        Clazz clazz = clazzMapper.selectById(classId);
+        return clazz != null ? clazz.getName() : "班级";
+    }
+
+    /**
+     * 设置 Excel 响应头
+     */
+    private void setupExcelResponse(HttpServletResponse response, String sheetName) throws IOException {
+        response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
+        response.setCharacterEncoding("utf-8");
+        String fileName = URLEncoder.encode(sheetName, "UTF-8").replaceAll("\\+", "%20");
+        response.setHeader("Content-disposition", "attachment;filename*=utf-8''" + fileName + ".xlsx");
+    }
+
+    /**
+     * 从 Map 中安全获取 String 值
+     */
+    private String getStringValue(Map<String, Object> row, String key) {
+        Object value = row.get(key);
+        return value != null ? value.toString() : "";
+    }
+
+    /**
+     * 翻译活跃等级代码为中文
+     */
+    private String translateActivityLevel(String code) {
+        if (code == null) {
+            return "";
+        }
+        switch (code) {
+            case "HIGH":
+                return "高";
+            case "MEDIUM":
+                return "中";
+            case "LOW":
+                return "低";
+            case "INACTIVE":
+                return "未活跃";
+            default:
+                return code;
+        }
+    }
+
+    /**
+     * 翻译课程类型代码为中文
+     */
+    private String translateLessonType(String code) {
+        if (code == null || code.isEmpty()) {
+            return "集体";
+        }
+        switch (code) {
+            case "INTRODUCTION":
+            case "INTRO":
+                return "入门";
+            case "COLLECTIVE":
+                return "集体";
+            case "LANGUAGE":
+                return "语言";
+            case "HEALTH":
+                return "健康";
+            case "SCIENCE":
+                return "科学";
+            case "SOCIAL":
+            case "SOCIETY":
+                return "社会";
+            case "ART":
+                return "艺术";
+            default:
+                return code;
+        }
+    }
+
+    /**
+     * 从 Map 中安全获取 Integer 值
+     */
+    private Integer getIntValue(Map<String, Object> row, String key) {
+        Object value = row.get(key);
+        if (value == null) {
+            return 0;
+        }
+        if (value instanceof Number) {
+            return ((Number) value).intValue();
+        }
+        // 处理 BigDecimal 等类型
+        try {
+            return Integer.parseInt(value.toString());
+        } catch (NumberFormatException e) {
+            return 0;
+        }
+    }
+
+    /**
+     * 从 Map 中安全获取 Double 值
+     */
+    private Double getDoubleValue(Map<String, Object> row, String key) {
+        Object value = row.get(key);
+        if (value == null) {
+            return null;
+        }
+        if (value instanceof Number) {
+            return ((Number) value).doubleValue();
+        }
+        try {
+            return Double.parseDouble(value.toString());
+        } catch (NumberFormatException e) {
+            return null;
+        }
+    }
+}

reading-platform-java/src/main/java/com/reading/platform/service/impl/SchoolScheduleServiceImpl.java

@@ -6,6 +6,8 @@ import com.alibaba.fastjson2.JSONObject;
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
 import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
 import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
+import com.reading.platform.common.enums.GenericStatus;
+import com.reading.platform.common.enums.ScheduleSourceType;
 import com.reading.platform.common.enums.ErrorCode;
 import com.reading.platform.common.exception.BusinessException;
 import com.reading.platform.dto.request.SchedulePlanCreateRequest;
@@ -102,9 +104,9 @@ public class SchoolScheduleServiceImpl extends ServiceImpl<SchedulePlanMapper, S
             plan.setWeekDay(date.getDayOfWeek().getValue());
             plan.setRepeatType(request.getRepeatType() != null ? request.getRepeatType() : "NONE");
             plan.setRepeatEndDate(request.getRepeatEndDate());
-            plan.setSource(StringUtils.hasText(request.getSource()) ? request.getSource() : "SCHOOL");
+            plan.setSource(StringUtils.hasText(request.getSource()) ? request.getSource() : ScheduleSourceType.SCHOOL.getCode());
             plan.setNote(request.getNote());
-            plan.setStatus("ACTIVE");
+            plan.setStatus(GenericStatus.ACTIVE.getCode());
             plan.setReminderSent(0);
 
             schedulePlanMapper.insert(plan);
@@ -222,8 +224,8 @@ public class SchoolScheduleServiceImpl extends ServiceImpl<SchedulePlanMapper, S
             wrapper.eq(SchedulePlan::getTeacherId, teacherId);
         }
         if (StringUtils.hasText(status)) {
-            if ("ACTIVE".equalsIgnoreCase(status)) {
+            if (GenericStatus.ACTIVE.getCode().equalsIgnoreCase(status)) {
-                wrapper.in(SchedulePlan::getStatus, "ACTIVE", "scheduled");
+                wrapper.in(SchedulePlan::getStatus, GenericStatus.ACTIVE.getCode(), "scheduled");
             } else {
                 wrapper.eq(SchedulePlan::getStatus, status);
             }
@@ -252,7 +254,7 @@ public class SchoolScheduleServiceImpl extends ServiceImpl<SchedulePlanMapper, S
         wrapper.eq(SchedulePlan::getTenantId, tenantId)
                 .ge(SchedulePlan::getScheduledDate, startDate)
                 .le(SchedulePlan::getScheduledDate, endDate)
-                .ne(SchedulePlan::getStatus, "cancelled");
+                .ne(SchedulePlan::getStatus, GenericStatus.fromCode("CANCELLED").getCode());
 
         if (classId != null) {
             wrapper.eq(SchedulePlan::getClassId, classId);
@@ -482,7 +484,7 @@ public class SchoolScheduleServiceImpl extends ServiceImpl<SchedulePlanMapper, S
         wrapper.eq(SchedulePlan::getTenantId, tenantId)
                 .ge(SchedulePlan::getScheduledDate, startDate)
                 .le(SchedulePlan::getScheduledDate, endDate)
-                .ne(SchedulePlan::getStatus, "cancelled");
+                .ne(SchedulePlan::getStatus, GenericStatus.fromCode("CANCELLED").getCode());
 
         if (classId != null) {
             wrapper.eq(SchedulePlan::getClassId, classId);

reading-platform-java/src/main/java/com/reading/platform/service/impl/StudentServiceImpl.java

@@ -2,6 +2,7 @@ package com.reading.platform.service.impl;
 
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
 import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.reading.platform.common.enums.GenericStatus;
 import com.reading.platform.common.enums.ErrorCode;
 import com.reading.platform.common.exception.BusinessException;
 import com.reading.platform.dto.request.StudentCreateRequest;
@@ -53,7 +54,7 @@ public class StudentServiceImpl extends com.baomidou.mybatisplus.extension.servi
         student.setReadingLevel(request.getReadingLevel());
         student.setInterests(request.getInterests());
         student.setNotes(request.getNotes());
-        student.setStatus("active");
+        student.setStatus(GenericStatus.ACTIVE.getCode());
 
         studentMapper.insert(student);
 
@@ -186,7 +187,7 @@ public class StudentServiceImpl extends com.baomidou.mybatisplus.extension.servi
         List<StudentClassHistory> histories = studentClassHistoryMapper.selectList(
                 new LambdaQueryWrapper<StudentClassHistory>()
                         .eq(StudentClassHistory::getClassId, classId)
-                        .in(StudentClassHistory::getStatus, "active", "ACTIVE")
+                        .in(StudentClassHistory::getStatus, GenericStatus.ACTIVE.getCode())
                         .and(w -> w.isNull(StudentClassHistory::getEndDate)
                                 .or()
                                 .ge(StudentClassHistory::getEndDate, LocalDate.now()))
@@ -207,7 +208,7 @@ public class StudentServiceImpl extends com.baomidou.mybatisplus.extension.servi
 
         LambdaQueryWrapper<Student> wrapper = new LambdaQueryWrapper<>();
         wrapper.in(Student::getId, studentIds)
-                .eq(Student::getStatus, "active");
+                .eq(Student::getStatus, GenericStatus.ACTIVE.getCode());
 
         if (StringUtils.hasText(keyword)) {
             wrapper.and(w -> w
@@ -228,7 +229,7 @@ public class StudentServiceImpl extends com.baomidou.mybatisplus.extension.servi
         List<StudentClassHistory> histories = studentClassHistoryMapper.selectList(
                 new LambdaQueryWrapper<StudentClassHistory>()
                         .eq(StudentClassHistory::getClassId, classId)
-                        .in(StudentClassHistory::getStatus, "active", "ACTIVE")
+                        .in(StudentClassHistory::getStatus, GenericStatus.ACTIVE.getCode())
                         .and(w -> w.isNull(StudentClassHistory::getEndDate)
                                 .or()
                                 .ge(StudentClassHistory::getEndDate, LocalDate.now()))
@@ -246,7 +247,7 @@ public class StudentServiceImpl extends com.baomidou.mybatisplus.extension.servi
         return studentMapper.selectList(
                 new LambdaQueryWrapper<Student>()
                         .in(Student::getId, studentIds)
-                        .eq(Student::getStatus, "active")
+                        .eq(Student::getStatus, GenericStatus.ACTIVE.getCode())
                         .orderByAsc(Student::getName)
         );
     }
@@ -302,7 +303,7 @@ public class StudentServiceImpl extends com.baomidou.mybatisplus.extension.servi
         List<StudentClassHistory> histories = studentClassHistoryMapper.selectList(
                 new LambdaQueryWrapper<StudentClassHistory>()
                         .in(StudentClassHistory::getClassId, classIds)
-                        .in(StudentClassHistory::getStatus, "active", "ACTIVE")
+                        .in(StudentClassHistory::getStatus, GenericStatus.ACTIVE.getCode())
                         .and(w -> w.isNull(StudentClassHistory::getEndDate)
                                 .or()
                                 .ge(StudentClassHistory::getEndDate, LocalDate.now()))
@@ -323,7 +324,7 @@ public class StudentServiceImpl extends com.baomidou.mybatisplus.extension.servi
 
         LambdaQueryWrapper<Student> wrapper = new LambdaQueryWrapper<>();
         wrapper.in(Student::getId, studentIds)
-                .eq(Student::getStatus, "active");
+                .eq(Student::getStatus, GenericStatus.ACTIVE.getCode());
 
         if (StringUtils.hasText(keyword)) {
             wrapper.and(w -> w

reading-platform-java/src/main/java/com/reading/platform/service/impl/TaskServiceImpl.java

@@ -5,6 +5,8 @@ import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
 import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
 import com.fasterxml.jackson.core.type.TypeReference;
 import com.fasterxml.jackson.databind.ObjectMapper;
+import com.reading.platform.common.enums.TaskStatus;
+import com.reading.platform.common.enums.TaskCompletionStatus;
 import com.reading.platform.common.enums.ErrorCode;
 import com.reading.platform.common.exception.BusinessException;
 import com.reading.platform.common.response.PageResult;
@@ -69,7 +71,7 @@ public class TaskServiceImpl extends ServiceImpl<TaskMapper, Task>
         task.setStartDate(request.getStartDate());
         LocalDate dueDate = request.getDueDate() != null ? request.getDueDate() : request.getEndDate();
         task.setDueDate(dueDate);
-        task.setStatus("pending");
+        task.setStatus(TaskStatus.PENDING.getCode());
         task.setAttachments(request.getAttachments());
 
         taskMapper.insert(task);
@@ -288,7 +290,7 @@ public class TaskServiceImpl extends ServiceImpl<TaskMapper, Task>
                 TaskFeedbackResponse feedback = taskFeedbackService.getFeedbackByCompletionId(completion.getId());
                 builder.teacherFeedback(feedback);
             } else {
-                builder.status("PENDING");
+                builder.status(TaskStatus.PENDING.getCode());
             }
 
             responses.add(builder.build());
@@ -348,14 +350,14 @@ public class TaskServiceImpl extends ServiceImpl<TaskMapper, Task>
             completion = new TaskCompletion();
             completion.setTaskId(taskId);
             completion.setStudentId(studentId);
-            completion.setStatus("completed");
+            completion.setStatus(TaskStatus.COMPLETED.getCode());
             completion.setCompletedAt(LocalDateTime.now());
             completion.setContent(content);
             completion.setAttachments(attachments);
             taskCompletionMapper.insert(completion);
             log.info("任务完成：taskId={}, studentId={}", taskId, studentId);
         } else {
-            completion.setStatus("completed");
+            completion.setStatus(TaskStatus.COMPLETED.getCode());
             completion.setCompletedAt(LocalDateTime.now());
             completion.setContent(content);
             completion.setAttachments(attachments);
@@ -395,7 +397,7 @@ public class TaskServiceImpl extends ServiceImpl<TaskMapper, Task>
         Task task = getTaskByIdWithTenantCheck(taskId, tenantId);
 
         // status=PENDING 待提交：返回参与任务且与家长关联、尚未提交的学生（无 task_completion 记录）
-        if ("PENDING".equalsIgnoreCase(status)) {
+        if (TaskStatus.PENDING.getCode().equalsIgnoreCase(status)) {
             return getPendingCompletions(taskId, tenantId, pageNum, pageSize, task);
         }
 
@@ -511,7 +513,7 @@ public class TaskServiceImpl extends ServiceImpl<TaskMapper, Task>
                 .taskId(taskId)
                 .taskTitle(taskTitle)
                 .student(studentInfo)
-                .status("PENDING")
+                .status(TaskStatus.PENDING.getCode())
                 .statusText("待提交")
                 .build();
     }
@@ -606,13 +608,8 @@ public class TaskServiceImpl extends ServiceImpl<TaskMapper, Task>
         if (status == null) {
             return "";
         }
-        return switch (status) {
+        TaskCompletionStatus completionStatus = TaskCompletionStatus.fromCode(status);
-            case "PENDING" -> "待完成";
+        return completionStatus.getDescription();
-            case "SUBMITTED" -> "已提交";
-            case "REVIEWED" -> "已评价";
-            case "completed" -> "已完成"; // 兼容旧数据
-            default -> status;
-        };
     }
 
     @Override

reading-platform-java/src/main/java/com/reading/platform/service/impl/TaskTemplateServiceImpl.java

@@ -3,6 +3,9 @@ package com.reading.platform.service.impl;
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
 import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
 import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
+import com.reading.platform.common.enums.GenericStatus;
+import com.reading.platform.common.enums.TaskStatus;
+import com.reading.platform.common.enums.UserRole;
 import com.reading.platform.common.enums.ErrorCode;
 import com.reading.platform.common.exception.BusinessException;
 import com.reading.platform.dto.request.CreateTaskFromTemplateRequest;
@@ -47,7 +50,7 @@ public class TaskTemplateServiceImpl extends ServiceImpl<TaskTemplateMapper, Tas
         if (Boolean.TRUE.equals(publicOnly)) {
             wrapper.eq(TaskTemplate::getIsPublic, 1);
         }
-        wrapper.eq(TaskTemplate::getStatus, "ACTIVE");
+        wrapper.eq(TaskTemplate::getStatus, GenericStatus.ACTIVE.getCode());
 
         if (StringUtils.hasText(type)) {
             wrapper.and(w -> w.eq(TaskTemplate::getType, type).or().eq(TaskTemplate::getTaskType, type));
@@ -70,7 +73,7 @@ public class TaskTemplateServiceImpl extends ServiceImpl<TaskTemplateMapper, Tas
                         .eq(TaskTemplate::getTenantId, tenantId)
                         .eq(TaskTemplate::getTaskType, type)
                         .eq(TaskTemplate::getIsDefault, 1)
-                        .eq(TaskTemplate::getStatus, "ACTIVE")
+                        .eq(TaskTemplate::getStatus, GenericStatus.ACTIVE.getCode())
         );
     }
 
@@ -97,7 +100,7 @@ public class TaskTemplateServiceImpl extends ServiceImpl<TaskTemplateMapper, Tas
         template.setRelatedCourseId(request.getRelatedCourseId());
         template.setDefaultDuration(request.getDefaultDuration() != null ? request.getDefaultDuration() : 7);
         template.setIsDefault(Boolean.TRUE.equals(request.getIsDefault()) ? 1 : 0);
-        template.setStatus("ACTIVE");
+        template.setStatus(GenericStatus.ACTIVE.getCode());
         template.setCreatedBy(userId);
         template.setContent(request.getContent());
         template.setIsPublic(Boolean.TRUE.equals(request.getIsPublic()) ? 1 : 0);
@@ -190,9 +193,9 @@ public class TaskTemplateServiceImpl extends ServiceImpl<TaskTemplateMapper, Tas
             }
         }
 
-        task.setStatus("pending");
+        task.setStatus(TaskStatus.PENDING.getCode());
         task.setCreatorId(userId);
-        task.setCreatorRole("TEACHER");
+        task.setCreatorRole(UserRole.TEACHER.getCode());
 
         taskMapper.insert(task);
         log.info("任务创建成功，ID: {}", task.getId());

reading-platform-java/src/main/java/com/reading/platform/service/impl/TeacherScheduleServiceImpl.java

@@ -3,6 +3,8 @@ package com.reading.platform.service.impl;
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
 import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
 import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
+import com.reading.platform.common.enums.GenericStatus;
+import com.reading.platform.common.enums.ScheduleSourceType;
 import com.reading.platform.common.enums.ErrorCode;
 import com.reading.platform.common.exception.BusinessException;
 import com.reading.platform.dto.request.SchedulePlanCreateRequest;
@@ -60,7 +62,7 @@ public class TeacherScheduleServiceImpl extends ServiceImpl<SchedulePlanMapper,
     public List<TimetableResponse> getTimetable(Long teacherId, LocalDate startDate, LocalDate endDate) {
         LambdaQueryWrapper<SchedulePlan> wrapper = new LambdaQueryWrapper<>();
         wrapper.eq(SchedulePlan::getTeacherId, teacherId);
-        wrapper.eq(SchedulePlan::getStatus, "ACTIVE");
+        wrapper.eq(SchedulePlan::getStatus, GenericStatus.ACTIVE.getCode());
 
         if (startDate != null) {
             wrapper.ge(SchedulePlan::getScheduledDate, startDate);
@@ -97,7 +99,7 @@ public class TeacherScheduleServiceImpl extends ServiceImpl<SchedulePlanMapper,
         LambdaQueryWrapper<SchedulePlan> wrapper = new LambdaQueryWrapper<>();
         wrapper.eq(SchedulePlan::getTeacherId, teacherId);
         wrapper.eq(SchedulePlan::getScheduledDate, today);
-        wrapper.eq(SchedulePlan::getStatus, "ACTIVE");
+        wrapper.eq(SchedulePlan::getStatus, GenericStatus.ACTIVE.getCode());
         wrapper.orderByAsc(SchedulePlan::getScheduledTime);
 
         return schedulePlanMapper.selectList(wrapper);
@@ -128,9 +130,9 @@ public class TeacherScheduleServiceImpl extends ServiceImpl<SchedulePlanMapper,
         schedulePlan.setWeekDay(request.getWeekDay());
         schedulePlan.setRepeatType(request.getRepeatType() != null ? request.getRepeatType() : "NONE");
         schedulePlan.setRepeatEndDate(request.getRepeatEndDate());
-        schedulePlan.setSource(request.getSource() != null ? request.getSource() : "TEACHER");
+        schedulePlan.setSource(request.getSource() != null ? request.getSource() : ScheduleSourceType.TEACHER.getCode());
         schedulePlan.setNote(request.getNote());
-        schedulePlan.setStatus("ACTIVE");
+        schedulePlan.setStatus(GenericStatus.ACTIVE.getCode());
 
         schedulePlanMapper.insert(schedulePlan);
         log.info("排课创建成功：id={}, name={}, scheduledDate={}",

reading-platform-java/src/main/java/com/reading/platform/service/impl/TeacherServiceImpl.java

@@ -2,6 +2,7 @@ package com.reading.platform.service.impl;
 
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
 import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.reading.platform.common.enums.GenericStatus;
 import com.reading.platform.common.enums.ErrorCode;
 import com.reading.platform.common.exception.BusinessException;
 import com.reading.platform.dto.request.TeacherCreateRequest;
@@ -69,7 +70,7 @@ public class TeacherServiceImpl extends com.baomidou.mybatisplus.extension.servi
         teacher.setEmail(request.getEmail());
         teacher.setGender(request.getGender());
         teacher.setBio(request.getBio());
-        teacher.setStatus("active");
+        teacher.setStatus(GenericStatus.ACTIVE.getCode());
 
         teacherMapper.insert(teacher);
 
@@ -265,7 +266,7 @@ public class TeacherServiceImpl extends com.baomidou.mybatisplus.extension.servi
 
         LambdaQueryWrapper<Teacher> wrapper = new LambdaQueryWrapper<>();
         wrapper.in(Teacher::getId, teacherIds)
-                .eq(Teacher::getStatus, "active");
+                .eq(Teacher::getStatus, GenericStatus.ACTIVE.getCode());
 
         return teacherMapper.selectList(wrapper);
     }
@@ -304,8 +305,8 @@ public class TeacherServiceImpl extends com.baomidou.mybatisplus.extension.servi
         response.setClassIds(classIds);
         response.setClassNames(classNames.isEmpty() ? null : classNames);
 
-        if ("active".equals(response.getStatus())) {
+        if (GenericStatus.ACTIVE.getCode().equals(response.getStatus())) {
-            response.setStatus("ACTIVE");
+            response.setStatus(GenericStatus.ACTIVE.getCode());
         }
 
         long lessonCount = 0;

reading-platform-java/src/main/java/com/reading/platform/service/impl/TeacherStatsServiceImpl.java

@@ -21,6 +21,7 @@ import org.springframework.stereotype.Service;
 import java.time.DayOfWeek;
 import java.time.LocalDate;
 import java.time.LocalDateTime;
+import java.time.LocalTime;
 import java.time.format.DateTimeFormatter;
 import java.util.*;
 
@@ -87,18 +88,107 @@ public class TeacherStatsServiceImpl implements TeacherStatsService {
     @Override
     public List<TeacherLessonVO> getTodayLessons(Long teacherId) {
         LocalDate today = LocalDate.now();
-        List<Lesson> lessons = new ArrayList<>();
         try {
-            lessons = lessonMapper.selectList(
+            // 使用自定义查询，关联获取课程名称和班级名称
-                    new LambdaQueryWrapper<Lesson>()
+            List<Map<String, Object>> resultList = lessonMapper.selectTodayLessonsWithDetails(teacherId, today);
-                            .eq(Lesson::getTeacherId, teacherId)
+
-                            .eq(Lesson::getLessonDate, today)
+            List<TeacherLessonVO> voList = new ArrayList<>();
-                            .orderByAsc(Lesson::getStartTime)
+            for (Map<String, Object> row : resultList) {
-            );
+                TeacherLessonVO vo = TeacherLessonVO.builder()
+                        .id(getLong(row.get("id")))
+                        .tenantId(getLong(row.get("tenant_id")))
+                        .courseId(getLong(row.get("course_id")))
+                        .classId(getLong(row.get("class_id")))
+                        .teacherId(getLong(row.get("teacher_id")))
+                        .courseName(getString(row.get("courseName")))
+                        .className(getString(row.get("className")))
+                        .title(getString(row.get("title")))
+                        .lessonDate(getLocalDate(row.get("lesson_date")))
+                        .startTime(getLocalTime(row.get("start_time")))
+                        .endTime(getLocalTime(row.get("end_time")))
+                        .location(getString(row.get("location")))
+                        .status(getString(row.get("status")))
+                        .notes(getString(row.get("notes")))
+                        .createdAt(getLocalDateTime(row.get("created_at")))
+                        .updatedAt(getLocalDateTime(row.get("updated_at")))
+                        .build();
+                voList.add(vo);
+            }
+            return voList;
         } catch (Exception e) {
             log.warn("Failed to query today lessons: {}", e.getMessage());
+            return new ArrayList<>();
+        }
+    }
+
+    /**
+     * 辅助方法：安全获取 Long 类型值
+     */
+    private Long getLong(Object value) {
+        if (value == null) return null;
+        if (value instanceof Long) return (Long) value;
+        if (value instanceof Number) return ((Number) value).longValue();
+        try {
+            return Long.parseLong(value.toString());
+        } catch (NumberFormatException e) {
+            return null;
+        }
+    }
+
+    /**
+     * 辅助方法：安全获取 String 类型值
+     */
+    private String getString(Object value) {
+        if (value == null) return null;
+        return value.toString();
+    }
+
+    /**
+     * 辅助方法：安全获取 LocalDate 类型值
+     */
+    private LocalDate getLocalDate(Object value) {
+        if (value == null) return null;
+        if (value instanceof LocalDate) return (LocalDate) value;
+        try {
+            if (value instanceof java.sql.Date) {
+                return ((java.sql.Date) value).toLocalDate();
+            }
+            return LocalDate.parse(value.toString());
+        } catch (Exception e) {
+            return null;
+        }
+    }
+
+    /**
+     * 辅助方法：安全获取 LocalTime 类型值
+     */
+    private LocalTime getLocalTime(Object value) {
+        if (value == null) return null;
+        if (value instanceof LocalTime) return (LocalTime) value;
+        try {
+            if (value instanceof java.sql.Time) {
+                return ((java.sql.Time) value).toLocalTime();
+            }
+            return LocalTime.parse(value.toString());
+        } catch (Exception e) {
+            return null;
+        }
+    }
+
+    /**
+     * 辅助方法：安全获取 LocalDateTime 类型值
+     */
+    private LocalDateTime getLocalDateTime(Object value) {
+        if (value == null) return null;
+        if (value instanceof LocalDateTime) return (LocalDateTime) value;
+        try {
+            if (value instanceof java.sql.Timestamp) {
+                return ((java.sql.Timestamp) value).toLocalDateTime();
+            }
+            return LocalDateTime.parse(value.toString());
+        } catch (Exception e) {
+            return null;
         }
-        return TeacherStatsMapperStruct.INSTANCE.toLessonVOList(lessons);
     }
 
     @Override

reading-platform-java/src/main/java/com/reading/platform/service/impl/TenantServiceImpl.java

@@ -80,7 +80,7 @@ public class TenantServiceImpl extends com.baomidou.mybatisplus.extension.servic
         tenant.setStartDate(request.getStartDate());
         tenant.setExpireDate(request.getExpireDate());
 
-        tenant.setStatus("ACTIVE");
+        tenant.setStatus(TenantStatus.ACTIVE.getCode());
 
         // 设置登录账号和密码（username 与 code 一致用于登录）
         tenant.setUsername(request.getCode());

reading-platform-java/src/main/java/com/reading/platform/service/impl/ThemeServiceImpl.java

@@ -2,6 +2,7 @@ package com.reading.platform.service.impl;
 
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
 import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
+import com.reading.platform.common.enums.GenericStatus;
 import com.reading.platform.common.exception.BusinessException;
 import com.reading.platform.entity.CoursePackage;
 import com.reading.platform.entity.Theme;
@@ -71,7 +72,7 @@ public class ThemeServiceImpl extends ServiceImpl<ThemeMapper, Theme> implements
         theme.setName(name);
         theme.setDescription(description);
         theme.setSortOrder(sortOrder != null ? sortOrder : maxSortOrder + 1);
-        theme.setStatus("ACTIVE");
+        theme.setStatus(GenericStatus.ACTIVE.getCode());
         themeMapper.insert(theme);
 
         log.info("主题创建成功，id={}", theme.getId());

reading-platform-java/src/main/java/com/reading/platform/task/ScheduleReminderTask.java

@@ -1,6 +1,9 @@
 package com.reading.platform.task;
 
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.reading.platform.common.enums.GenericStatus;
+import com.reading.platform.common.enums.NotificationRecipientType;
+import com.reading.platform.common.enums.NotificationType;
 import com.reading.platform.entity.SchedulePlan;
 import com.reading.platform.entity.Teacher;
 import com.reading.platform.mapper.SchedulePlanMapper;
@@ -41,7 +44,7 @@ public class ScheduleReminderTask {
         // 查询当天所有未取消且未发送提醒的排课
         LambdaQueryWrapper<SchedulePlan> wrapper = new LambdaQueryWrapper<>();
         wrapper.eq(SchedulePlan::getScheduledDate, today)
-                .ne(SchedulePlan::getStatus, "cancelled")
+                .ne(SchedulePlan::getStatus, GenericStatus.fromCode("CANCELLED").getCode())
                 .eq(SchedulePlan::getReminderSent, 0);
 
         List<SchedulePlan> plans = schedulePlanMapper.selectList(wrapper);
@@ -82,7 +85,7 @@ public class ScheduleReminderTask {
         // 查询今天、未取消、未发送即将提醒、开始时间在接下来 30 分钟内的排课
         LambdaQueryWrapper<SchedulePlan> wrapper = new LambdaQueryWrapper<>();
         wrapper.eq(SchedulePlan::getScheduledDate, today)
-                .ne(SchedulePlan::getStatus, "cancelled");
+                .ne(SchedulePlan::getStatus, GenericStatus.fromCode("CANCELLED").getCode());
 
         List<SchedulePlan> plans = schedulePlanMapper.selectList(wrapper);
 
@@ -135,11 +138,11 @@ public class ScheduleReminderTask {
                 notificationService.createNotification(
                         plan.getTenantId(),
                         0L,
-                        "SYSTEM",
+                        NotificationType.SYSTEM.getCode(),
                         title,
                         content,
-                        "SCHEDULE",
+                        NotificationType.SCHEDULE.getCode(),
-                        "TEACHER",
+                        NotificationRecipientType.TEACHER.getCode(),
                         plan.getTeacherId()
                 );
             }