Commit Graph

172 Commits

Author SHA1 Message Date
Claude Opus 4.6
c2e4477cdf docs: 更新开发日志 2026-03-21
记录学校端课程中心重构工作:
- 后端 SchoolCourseController 返回完整 CourseResponse
- 新增 CourseCenterView.vue 组件
- 新增 course-center.ts API 层
- 菜单文案修改:课程管理 → 课程中心
- 课程详情页现在展示完整数据

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-21 18:25:39 +08:00
Claude Opus 4.6
ca56d8556e docs: 添加课程中心重构设计文档
记录教师端和学校端课程中心重构的设计方案:
- 功能对比矩阵
- 架构设计(前端组件、API层、后端接口)
- 页面布局设计
- 关键技术实现
- 文件变更清单
- 测试验证要点

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-21 18:22:31 +08:00
Claude Opus 4.6
3183d1d388 feat: 学校端课程中心优化 - 照搬教师端实现
主要变更:
- 学校端课程详情页返回完整 CourseResponse(与教师端一致)
- 新增课程中心视图 CourseCenterView.vue(学校端/教师端)
- 新增 course-center.ts API 层
- 新增 PackageFilterMetaResponse 用于筛选元数据
- 菜单文案修改:课程管理 -> 课程中心

后端优化:
- SchoolCourseController.getCourse() 返回 CourseResponse
- CourseCollectionService 新增筛选元数据查询方法
- CoursePackageResponse 新增 filterMeta 字段

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-21 18:14:49 +08:00
Claude Opus 4.6
cf7e6bf94f Merge remote-tracking branch 'origin/master' into retirado 2026-03-21 16:09:38 +08:00
zhonghua
c55b2266fb fix: task_feedback 表字段对齐与完成情况图片展示
- 新增 V47 迁移:为 task_feedback 添加 create_by、update_by、deleted 字段
- 修复 TaskFeedbackMapper 使用 deleted 替代 deleted_at
- 教师端完成情况:将「X张照片」改为图片缩略图展示,支持点击预览
- 评价弹窗提交内容预览区显示图片网格,参考家长端提交页面

Made-with: Cursor
2026-03-20 19:05:59 +08:00
zhonghua
5cb903d7ed feat: 家长端任务、教师端统计、数据库迁移等
- 家长端阅读任务:从 task_target 获取任务(学生+班级),支持家长关联孩子查看
- 家长端提交任务:修复照片上传,使用 uploadFile(file, poster) 符合 API 规范
- 教师端任务列表:TaskResponse 新增 targetCount、completionCount,填充目标人数与完成人数
- 数据库迁移:V45 添加 task_completion.photos,V46 添加 submitted_at、reviewed_at
- 其他:班级学生、家长孩子、学校班级统计等修复

Made-with: Cursor
2026-03-20 18:43:47 +08:00
zhonghua
c93d325cee fix: 课后记录页面前后端对齐 - 修改 getStudentRecords 返回 { lesson, students } 结构 - 修改 batchSaveStudentRecords 接受 { records } 请求体 - 新增 StudentRecordsResponse/StudentWithRecordResponse/BatchStudentRecordsRequest - 前端增强数据容错
Made-with: Cursor
2026-03-20 16:11:08 +08:00
zhonghua
463c3d9922 feat: 阅读任务模块 - 关联绘本、任务模板与教师端优化
Made-with: Cursor
2026-03-20 15:55:33 +08:00
Claude Opus 4.6
101b0a6a42 docs: 更新 2026-03-20 开发日志和 CHANGELOG
- 完善今日工作总结
- 添加关键文件索引
- 记录遗留问题和后续优化建议
- 更新 CHANGELOG 添加阅读任务模块重写记录

Co-Authored-By: Claude <noreply@anthropic.com>
2026-03-20 15:15:03 +08:00
zhonghua
de742d9acf Merge branch 'retirado' of http://8.148.151.56:3000/tonytech/kindergarten_java 2026-03-20 15:09:46 +08:00
Claude Opus 4.6
2839fd7296 fix: 修复创建任务时 relatedBookName 字段未保存的问题
问题描述:
- TaskServiceImpl.createTask() 方法中遗漏了 relatedBookName 字段的设置
- 导致前端传入的关联绘本名称无法保存到数据库

修复内容:
- 在 createTask() 方法中添加 task.setRelatedBookName(request.getRelatedBookName())

测试验证:
- 后端 API 测试全部通过 (6/6)
- 学校端只读模式验证通过
- 创建任务后正确返回 relatedBookName 字段

同时添加:
- 阅读任务模块测试计划
- E2E 测试用例文件
- 详细测试报告

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-20 15:07:17 +08:00
En
9f04daa955 fix: 数据看板使用趋势 Y 轴步进值调整为 1
- 修改 DashboardView.vue 中趋势图表的 Y 轴配置
- 左右 Y 轴(授课次数、学生数)的步进值均设为 1
2026-03-20 14:54:11 +08:00
En
27cb883b23 feat: Flyway 迁移脚本更新课程包统计数据
V10__update_course_package_stats.sql:
- 根据 lesson 表实际数据更新 usage_count (status != 'cancelled')
- 根据 lesson 表实际数据更新 teacher_count (status = 'completed' 去重教师)
2026-03-20 14:38:26 +08:00
En
4ec61e48ca fix: 课程包统计逻辑修正
1. CoursePackageMapper: 新增 decrementUsageCount 方法
   - 课程取消时减少使用次数

2. LessonServiceImpl: 完善课程状态变更时的统计
   - cancelLesson: 取消时 usage_count -1
   - startLesson: 设置 startDatetime
   - completeLesson: 完成时设置 endDatetime

统计口径:
- usage_count: status != 'cancelled' 的课程数(创建时 +1,取消时 -1)
- teacher_count: status = 'completed' 的课程中去重教师数
2026-03-20 14:38:26 +08:00
zhonghua
161e05dce4 fix:修复数据库迁移启动失败 2026-03-20 14:34:21 +08:00
zhonghua
26f55da670 Merge branch 'retirado' of http://8.148.151.56:3000/tonytech/kindergarten_java
# Conflicts:
#	reading-platform-frontend/src/api/school.ts
#	reading-platform-frontend/src/api/teacher.ts
#	reading-platform-frontend/src/views/school/tasks/TaskListView.vue
#	reading-platform-frontend/src/views/teacher/tasks/TaskListView.vue
#	reading-platform-java/src/main/java/com/reading/platform/controller/school/SchoolTaskController.java
#	reading-platform-java/src/main/java/com/reading/platform/controller/teacher/TeacherTaskController.java
#	reading-platform-java/src/main/java/com/reading/platform/dto/response/TaskCompletionDetailResponse.java
#	reading-platform-java/src/main/java/com/reading/platform/service/TaskService.java
#	reading-platform-java/src/main/java/com/reading/platform/service/impl/TaskServiceImpl.java
2026-03-20 14:27:28 +08:00
Claude Opus 4.6
f62aa18e72 feat: 阅读任务模块重写(Phase 1-4)
## 主要变更

### 后端改造 (Phase 1)
- 新增 task_feedback 表存储教师评价
- task 表添加 related_book_name 字段
- task_completion 表添加 video_url, audio_url 字段
- 新增 TaskFeedback 实体和服务层
- 扩展 TaskService 支持完成情况查询和评价功能
- 学校端 API 改为只读模式 (/v1/school/reading-tasks)

### 教师端前端 (Phase 2)
- 创建任务弹窗添加关联绘本字段
- 完成情况弹窗支持新状态值 (PENDING/SUBMITTED/REVIEWED)
- 新增评价弹窗组件(评价结果、评分、评语)
- 显示提交内容预览(照片、视频、音频、文字)

### 家长端前端 (Phase 3)
- 提交功能改造支持照片上传(最多9张)
- 支持视频/音频链接输入
- 阅读心得文字输入
- 新增查看教师评价功能
- 状态驱动操作(待提交/已提交/已评价)

### 学校端前端 (Phase 4)
- 完全重写为只读模式
- 移除创建/编辑/删除功能
- 多维度筛选(关键字、类型、状态、日期、排序)
- 统计卡片(任务数、进行中、已提交、已评价)
- 任务详情弹窗
- 完成情况列表弹窗
- 提交详情弹窗

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-20 14:08:36 +08:00
zhonghua
802327f075 fix: 任务模板 API 修复与学校端功能实现
- TaskTemplateCreateRequest: isDefault/isPublic 改为 Boolean 类型
- SchoolTaskTemplateController: 接入 TaskTemplateService 实现完整 CRUD
- getTemplates: 支持 publicOnly、keyword、taskType 参数
- 学校端列表显示全部模板(含 isPublic=0)
- 前端 getTaskTemplates: 分页字段 Number 转换

Made-with: Cursor
2026-03-20 13:49:15 +08:00
zhonghua
37a6aba8cc feat: 任务完成情况 API 与 UI 优化
- 学校/教师端: 新增 GET/PUT 任务完成情况接口,支持分页与状态筛选
- 后端: TaskCompletionDetailResponse 含学生姓名、班级信息
- 后端: 新增 getTaskCompletionStats、getTaskCompletionsWithStudent
- 学校端: 状态筛选移至弹框标题后,分页始终显示
- 班级字段: 支持 ACTIVE 状态,无记录时用 student.grade 兜底
- 迁移 V43: 添加 student_class_history 测试数据

Made-with: Cursor
2026-03-20 11:48:56 +08:00
En
13fc0e720e refactor: 课程包统计与启动脚本优化
1. LessonStatus 枚举:code 值改为大写(与枚举名一致)
2. CoursePackageMapper:新增课程包统计方法
   - incrementUsageCount: 增加使用次数
   - updateTeacherCount: 更新教师数量(去重统计)
3. 启动脚本:端口调整为 8481(后端) 和 5174(前端)
2026-03-20 11:15:08 +08:00
En
79e90410dd refactor: 替换 Lesson 状态魔法值为 LessonStatus 枚举
- 将 LessonServiceImpl 中所有状态魔法值替换为 LessonStatus 枚举
- 提升代码可维护性和类型安全
2026-03-20 11:04:10 +08:00
zhonghua
f90037dd17 feat: 根据排课lessonType直接进入子课程,子课程结束即上课结束;右侧添加课程类型展示
- 后端:LessonDetailResponse 新增 lessonType,从 SchedulePlan 读取
- 前端:根据 lessonType 直接进入对应子课程,子课程结束即上课结束
- 前端:右侧面板课程资源上方添加课程类型标签展示

Made-with: Cursor
2026-03-20 10:56:41 +08:00
zhonghua
5a05af18dd Merge branch 'master' of http://8.148.151.56:3000/tonytech/kindergarten_java 2026-03-20 10:07:26 +08:00
zhonghua
8502d8b2d3 fix:优化上课备课路由死循环 2026-03-20 10:07:17 +08:00
Claude Opus 4.6
a31921f27f fix: 统一启动脚本端口配置为 8480
- 修改 start-all.sh: 端口检查、健康检查使用 8480
- 修改 stop-all.sh: 停止后端服务使用 8480
- 与 application.yml 中的 SERVER_PORT:8480 保持一致

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-20 09:55:35 +08:00
En
a054c410c2 refactor: 学校端课程响应重构
- 将 toSchoolCourseResponse 转换逻辑从 Controller 移到 Response 类
- 使用静态方法引用简化 Controller 代码
- 删除已弃用的文档文件
2026-03-20 09:42:04 +08:00
En
c3b1056c29 feat: 租户管理与课程套餐优化
- 优化租户管理相关接口与实体类
- 更新课程套餐服务层实现
- 新增数据库迁移脚本 V42
- 同步更新前端 API 类型与页面组件
2026-03-19 23:28:40 +08:00
zhonghua
ed9371b21f feat: 排课/预约优化与国际化
- main.ts: dayjs 时间国际化使用中文
- 排课日期禁止选择过去时间(学校端、教师端、校本课程预约)
- 移除选择课程套餐,租户仅一个套餐直接展示课程包
- 教师端预约上课增加排课计划参考表格

Made-with: Cursor
2026-03-19 18:31:54 +08:00
zhonghua
824ce7ad80 feat: 教师端预约上课与学校端新建排课流程一致
- 后端:教师可访问课程套餐/课程包/lesson-types API
- 后端:TeacherScheduleServiceImpl 支持 coursePackageId、lessonType
- 前端:新增 TeacherCreateScheduleModal 四步流程(选择课程包→课程类型→班级→时间)
- 前端:ScheduleView 集成新弹窗
- 前端:课程中心 PrepareModeView 预约上课使用相同四步流程,支持预设

Made-with: Cursor
2026-03-19 18:14:25 +08:00
zhonghua
3f6696d7bb feat: 教师端排课优化
- 排课详情/课表:显示班级、课程、课程类型(使用 toSchedulePlanResponse 填充)
- 开始上课:改用 from-schedule API,避免 teacherId/title/lessonDate 校验失败
- 前端:TeacherSchedule 增加 lessonType/coursePackageName,课程展示兼容 coursePackageName

Made-with: Cursor
2026-03-19 18:00:03 +08:00
En
69d00d7650 Merge remote-tracking branch 'origin/master' 2026-03-19 17:53:05 +08:00
zhonghua
7c5110b6d2 feat: 新建排课课程类型图标改用 @ant-design/icons-vue
Made-with: Cursor
2026-03-19 17:41:39 +08:00
En
2b611f6c17 fix(V41): 修复中间表优化迁移脚本(使用存储过程处理不存在的情况)
- 使用存储过程和 IF EXISTS 检查来删除索引和字段
- 避免因为索引/字段不存在导致迁移失败
- 创建临时 FlywayCleanerConfig 用于清理失败的 v41 迁移记录
- 成功执行 V41 迁移,优化中间表结构

影响范围:
- course_collection_package: 删除 uk_collection_package 索引和 deleted 字段
- tenant_course: 删除 uk_tenant_course 索引和 deleted 字段
- class_teacher: 删除 deleted 字段

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-19 17:28:15 +08:00
En
48172921d7 fix: 修复 V41 迁移脚本的 SQL 语法错误(MySQL 不支持 IF EXISTS) 2026-03-19 16:54:21 +08:00
En
dad4c14f97 Merge remote-tracking branch 'origin/master' 2026-03-19 16:40:13 +08:00
En
60213b513d refactor(entity): 中间表优化 - 移除联合唯一索引和 deleted 字段
- CourseCollectionPackage、TenantCourse、ClassTeacher 改为独立实体类
- 不再继承 BaseEntity,移除 deleted 字段,使用物理删除
- 创建 V41 迁移脚本移除联合唯一索引和 deleted 字段
- 更新中间表设计规范到 CLAUDE.md 和统一开发规范.md

 refactor(entity): 中间表优化 - 移除联合唯一索引和 deleted 字段

- CourseCollectionPackage、TenantCourse、ClassTeacher 改为独立实体类
- 不再继承 BaseEntity,移除 deleted 字段,使用物理删除
- 创建 V41 迁移脚本移除联合唯一索引和 deleted 字段
- 更新中间表设计规范到 CLAUDE.md 和统一开发规范.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-19 16:38:51 +08:00
zhonghua
829a70e448 feat: 学校端课程排期功能完善
- 排课计划参考:对齐管理端课程包详情,支持时间/课程类型/课程名称/区域活动/备注五列
- 支持两种 schedule_ref_data 格式(周排课表、课程类型说明)
- 新建排课弹窗样式提取为 CreateScheduleModal.scss 修复 SASS 编译错误
- 切换视图(列表/课表/日历)时自动刷新数据
- 排课列表、课表、日历视图增加课程类型 tag 展示
- 后端:timetable/lesson-types 接口修复,LessonTypeEnum 补充类型

Made-with: Cursor
2026-03-19 16:34:48 +08:00
En
7743ae7a01 优化 2026-03-19 15:38:00 +08:00
En
a2751d7aa5 Merge remote-tracking branch 'origin/master'
# Conflicts:
#	reading-platform-java/src/main/java/com/reading/platform/service/CourseLessonService.java
2026-03-19 15:27:03 +08:00
En
67b87fae73 refactor(service): Service 层重构 - 接口与实现分离
重构以下服务类为接口 + 实现类结构,符合三层架构规范:
- CourseCollectionService → CourseCollectionService + CourseCollectionServiceImpl
- CourseLessonService → CourseLessonService + CourseLessonServiceImpl
- ResourceLibraryService → ResourceLibraryService + ResourceLibraryServiceImpl
- ThemeService → ThemeService + ThemeServiceImpl

变更详情:
- 接口继承 IService<Entity>,定义业务方法签名
- 实现类继承 ServiceImpl 并实现对应接口,添加 @Override 注解
- CourseCollectionServiceImpl 注入 CourseLessonService 接口依赖
- FileStorageService 保持原结构(纯工具类无需拆分)

验证:
- mvn compile -DskipTests 编译通过

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-19 15:08:01 +08:00
zhonghua
f425209abe feat: 校园端课程列表筛选与卡片展示参考教师端
- 筛选栏:年级/领域/课程类型下拉、搜索框,保留授权新课程按钮
- 卡片:新增 lessonTags 展示(导入课、集体课、领域等)
- 后端:学校课程 API 支持 domain、lessonType 参数及 lessonTags 返回
- 主题保持校园端绿色

Made-with: Cursor
2026-03-19 15:07:40 +08:00
zhonghua
20c500e921 feat: 教师课程中心 - 年级/领域/课程类型筛选与 lessonTags 展示
- 新增 lessonType 筛选参数,支持 SOCIAL/SOCIETY/DOMAIN_* 等格式兼容
- 列表接口返回 lessonTags(name,lessonType) 供 tag 展示
- 新增 LessonTagResponse DTO
- 完善 tagMaps 与 LESSON_TYPE_NAMES 映射(INTRO/DOMAIN_*)
- 修复筛选参数未传递到接口的问题

Made-with: Cursor
2026-03-19 15:01:13 +08:00
zhonghua
c652cda7a8 fix: 教师端课程包按 学校->套餐->课程包 层级查询
- 新增 getTenantPackageCoursePage 方法实现层级分页查询
- TeacherCourseController 使用新方法替代直接按 tenant_id 查询
- 修复 /api/v1/teacher/courses 无数据问题

Made-with: Cursor
2026-03-19 14:20:49 +08:00
zhonghua
ccce7e66bb feat(school): 教师管理前后端对齐 - 支持loginAccount/classIds字段
- TeacherCreateRequest: 添加@JsonAlias(loginAccount)支持前端字段
- TeacherCreateRequest/UpdateRequest: 支持classIds班级分配
- TeacherResponse: 返回loginAccount、classIds、classNames、lessonCount
- 重置密码接口: 自动生成并返回tempPassword
- 创建/更新教师时处理class_teacher关联

Made-with: Cursor
2026-03-19 14:11:41 +08:00
zhonghua
81dd74662e fix: 修复 /api/v1/school/courses 接口 gradeTags 前端显示数据丢失
- 后端: 增强 SchoolCourseController.parseJsonArray 兼容多种 JSON 格式
- 后端: 新增 SchoolCourseResponse,gradeTags/domainTags 规范为 String[]
- 前端: 学校端课程列表/详情统一使用 parseGradeLevels 解析 gradeTags
- 前端: 兼容 grade_tags/domain_tags snake_case 字段

Made-with: Cursor
2026-03-19 14:05:28 +08:00
En
efedb37cae Merge remote-tracking branch 'origin/master'
# Conflicts:
#	reading-platform-frontend/src/views/admin/collections/CollectionEditView.vue
2026-03-19 12:34:35 +08:00
En
9a9caab60b feat(db): 添加 V40 迁移脚本删除 tenant_package 表的 package_id 字段
- 创建 V40__drop_tenant_package_package_id.sql 迁移脚本
- 安全删除 tenant_package 表中废弃的 package_id/packageId 列
- 该字段已在 V31 中尝试删除,V40 用于修复执行失败的情况
- TenantPackage 实体已使用 collectionId 字段替代

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-19 12:34:00 +08:00
zhonghua
8f5a0fcdda fix: 套餐管理优化与 gradeLevels/重复包修复
- gradeLevels: 后端 JSON 解析修复,前端兼容错误格式
- 筛选下拉: 状态选项按业务流程排序
- 已下架: 列表与详情页增加编辑、删除操作
- 课程包关联: 前后端去重,修复 uk_collection_package 唯一约束冲突

Made-with: Cursor
2026-03-19 11:37:04 +08:00
zhonghua
289fcbee52 feat: 课程套餐与课程包管理优化
- 课程套餐:适用年级从已选课程包自动同步,年级列改为只读
- 课程套餐:草稿/已驳回状态添加发布按钮
- 课程包:已发布状态不显示编辑按钮,编辑页增加状态校验
- 套餐创建:年级列从课程包读取,不可编辑

Made-with: Cursor
2026-03-19 11:18:02 +08:00
En
134cc6a075 Merge remote-tracking branch 'origin/master' 2026-03-19 11:09:28 +08:00