kindergarten_java/docs/dev-logs/2026-03-13.md

开发日志 - 2026-03-13

开发者: Claude 日期: 2026-03-13

---

今日工作内容

1. 学校端 API 调试与修复

问题发现

• 学校端大部分 API 返回 500 错误
• 用户登录失败（密码哈希不匹配）
• 缺少统计 API 和课程 API

修复过程

1. 密码问题修复

• 发现数据库中的密码哈希与测试密码 123456 不匹配
• 创建 reset_passwords.py 脚本，使用 BCrypt 生成新哈希
• 更新所有用户表（admin_users, tenants, teachers, parents）的密码

2. 创建 School Stats API

• 创建 SchoolStatsController.java
• 实现以下接口：
  • /api/school/stats - 基础统计
  • /api/school/stats/teachers - 活跃教师排行
  • /api/school/stats/courses - 课程使用统计
  • /api/school/stats/activities - 近期活动
  • /api/school/stats/lesson-trend - 授课趋势
  • /api/school/stats/course-distribution - 课程分布

3. 创建 School Course API

• 创建 SchoolCourseController.java
• 实现以下接口：
  • /api/school/courses - 课程列表
  • /api/school/courses/{id} - 课程详情

4. 修复 API 响应格式不匹配

• 后端返回：{list, total, pageNum, pageSize, pages}
• 前端期望：{items, total, page, pageSize}
• 更新 src/api/school.ts 的类型定义
• 批量更新所有视图文件：result.items → result.list

5. 修复 SchoolPackageController 路径

• 将 /api/v1/school/packages 改为 /api/school/packages

---

测试结果

学校端功能测试

• ✅ 登录功能正常
• ✅ Dashboard 加载正常，统计 API 响应正常
• ✅ 教师管理页面加载正常
• ✅ 学生管理页面加载正常
• ✅ 班级管理页面加载正常
• ✅ 课程管理页面加载正常

API 状态汇总

API	状态
/api/auth/login	✅
/api/school/stats	✅
/api/school/teachers	✅
/api/school/students	✅
/api/school/classes	✅
/api/school/parents	✅
/api/school/tasks	✅
/api/school/courses	✅
/api/school/growth-records	✅
/api/school/packages	✅

---

新增文件

后端

• SchoolStatsController.java - 统计数据控制器
• SchoolCourseController.java - 课程管理控制器

脚本

• reset_passwords.py - 密码重置脚本
• test_db_query.py - 数据库查询测试脚本
• verify_password.py - 密码哈希验证脚本

文档

• /docs/test-logs/school/2026-03-13.md - 学校端测试记录
• /docs/dev-logs/2026-03-13.md - 今日开发日志

---

技术要点

BCrypt 密码哈希

import bcrypt

# 生成哈希
salt = bcrypt.gensalt(rounds=10)
password_hash = bcrypt.hashpw(password.encode('utf-8'), salt)

# 验证密码
bcrypt.checkpw(password.encode('utf-8'), hash_bytes)

MyBatis-Plus 分页查询

Page<Clazz> page = classService.getClassPage(tenantId, pageNum, pageSize, keyword, grade, status);
return Result.success(PageResult.of(page));

---

待完成工作

1. 测试教师/学生添加功能
2. 测试班级创建功能
3. 测试任务创建功能
4. 测试家长管理功能
5. 完善统计数据计算逻辑

---

2. 教师端 API 调试与修复

问题发现

• 前端 API 导入错误：getApi 函数不存在（应为 getReadingPlatformAPI）
• 教师端 Dashboard API 返回 500 错误
• 缺少教师端统计相关的 API 端点

修复过程

1. 修复 API 客户端导入

• 更新 src/api/client.ts：getApi → getReadingPlatformAPI
• 更新 src/api/teacher.ts：修正导入函数名
• 更新 src/api/school-course.ts：批量修正导入

2. 创建 Teacher Stats API

• 创建 TeacherStatsController.java
• 实现以下接口：
  • /api/teacher/dashboard - 教师端首页统计
  • /api/teacher/today-lessons - 今日课程
  • /api/teacher/recommended-courses - 推荐课程
  • /api/teacher/weekly-stats - 本周统计
  • /api/teacher/lesson-trend - 授课趋势
  • /api/teacher/course-usage - 课程使用统计
• 使用 try-catch 处理缺失的 lessons 表（远程数据库未同步）

3. 更新前端 API 调用

• 修正 teacher.ts 中的方法名：
  • api.teacherCourseControllerGetDashboard() → api.getDashboard()
  • api.teacherCourseControllerGetTodayLessons() → api.getTodayLessons()
  • api.teacherCourseControllerGetRecommendedCourses() → api.getRecommendedCourses()
  • api.teacherCourseControllerGetWeeklyStats() → api.getWeeklyStats()
  • api.teacherCourseControllerGetLessonTrend() → api.getLessonTrend()
  • api.teacherCourseControllerGetCourseUsage() → api.getCourseUsage()
• 移除未使用的类型导入 TeacherCourseControllerGetLessonTrendParams

4. 添加教师班级端点

• 在 TeacherCourseController.java 中添加 /api/teacher/classes 端点

---

测试结果

教师端功能测试（晚间）

• ✅ 登录功能正常
• ✅ Dashboard 加载成功，显示 25 个统计卡片
• ✅ Dashboard API 调用成功（不再返回 500 错误）
• ✅ 今日课程、推荐课程、本周统计 API 正常响应
• ✅ 授课趋势、课程使用统计 API 正常响应
• ⚠️ 班级管理页面需要进一步测试（classes 端点已添加）

API 状态汇总（新增）

API	状态
/api/teacher/dashboard	✅
/api/teacher/today-lessons	✅
/api/teacher/recommended-courses	✅
/api/teacher/weekly-stats	✅
/api/teacher/lesson-trend	✅
/api/teacher/course-usage	✅
/api/teacher/classes	⚠️ 已添加，待测试

---

新增文件

后端

• TeacherStatsController.java - 教师端统计数据控制器
• 修改 TeacherCourseController.java - 添加班级端点

脚本

• create_lessons_table.py - 创建缺失数据库表的脚本（未执行，远程数据库访问受限）

---

备注

• Java 后端运行在 port 8080
• 前端 Vite 运行在 port 5173
• 远程数据库：8.148.151.56:3306/reading_platform
• 远程数据库缺少 lessons 表，已使用 try-catch 优雅处理

---

3. 课程包三端全链路测试与修复

测试目标

围绕课程包业务，从超管端创建到学校端查看、教师端备课的完整链路测试。

Bug 修复记录

Bug 1: 登录 API 路径错误

• 测试脚本使用 /api/v1/auth/login，实际是 /api/auth/login

Bug 2: 角色名称大小写错误

• 测试脚本使用 "role": "ADMIN"，枚举要求小写 "admin"

Bug 3: 测试账号密码错误

• 测试脚本使用 123456，数据库是 123456

Bug 4: 套餐提交审核必须包含课程

• 提交审核时报错 "套餐必须包含至少一个课程包"
• 修复：先创建课程，再添加到套餐

Bug 5: 学校端 API 路径错误

• 测试脚本使用 /api/v1/school/packages，实际是 /api/school/packages

Bug 6: 教师端无法看到系统课程

• getCoursePage 和 getCoursesByTenantId 只查租户课程
• 修复：同时查询租户课程和系统课程 (isSystem = 1)

Bug 7: 创建系统课程未设置 isSystem 标志

• AdminCourseController.createCourse 设置了但未保存
• 修复：添加 courseMapper.updateById(course)

Bug 8: 课程需要发布才能被教师端看到

• 教师端查询 status = 'published'
• 修复：创建后调用发布接口

新增功能

• 新增套餐授权接口：POST /api/v1/admin/packages/{id}/grant
• 请求参数：tenantId, endDate, pricePaid

测试结果

• ✅ 超管端：登录、创建/发布课程、创建套餐、添加课程、提交审核、审核通过、发布套餐、授权给租户
• ✅ 学校端：登录、查看授权套餐
• ✅ 教师端：登录、查看可用课程

测试脚本

• test_package_full_api.py - 完整套餐 API 测试
• test_three_ends.py - 三端全链路测试
• /docs/test-logs/package/2026-03-13-full-flow.md - 详细测试记录