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

83 lines
2.3 KiB
Markdown
Raw Normal View History

# 开发日志 - 2026-03-18
## 完成事项
### 1. 提交昨天的变更代码
**提交内容**
- `SchoolPackageController.java` - 新增 `GET /api/v1/school/packages/{packageId}/courses` 接口
- 文档更新CHANGELOG.md, dev-logs/2026-03-17.md
**Git 提交**
```
commit 4072b21
feat: 添加课程包课程列表查询API
```
### 2. 添加排课计划参考示例数据
**Flyway 迁移脚本**`V29__add_schedule_ref_data.sql`
**为以下课程添加了排课计划参考数据**
#### 小猪佩奇绘本阅读
- 导入课:通过图片、视频等形式导入课程主题
- 集体课:全班集体参与的教学活动
- 五大领域课:语言、社会、科学、艺术、健康
#### 好饿的毛毛虫
- 导入课:通过毛毛虫玩偶导入课程,激发好奇心
- 集体课:绘本共读,了解毛毛虫的成长过程
- 五大领域课:各领域活动安排
#### 三只小猪
- 导入课:通过小猪玩偶和房子图片导入课程主题
- 集体课:绘本共读,理解故事情节和寓意
- 五大领域课:各领域活动安排
**排课计划参考数据结构**
```json
[
{
"lessonType": "INTRODUCTION",
"title": "导入课",
"description": "...",
"suggestedOrder": 1,
"durationMinutes": 15,
"frequency": "每周1次连续2周",
"keyPoints": ["..."],
"tips": "..."
},
{
"lessonType": "COLLECTIVE",
"title": "集体课",
"description": "...",
"suggestedOrder": 2,
"durationMinutes": 25,
"frequency": "每周2次连续4周",
"keyPoints": ["..."],
"tips": "..."
},
// ... 五大领域课
]
```
### 排课计划参考功能说明
**功能目的**
帮助学校老师了解课程包下的三类课程(导入课、集体课、五大领域课)如何安排才能发挥最大价值。
**数据位置**
- 数据库:`course.schedule_ref_data` 字段JSON 格式)
- 实体类:`Course.scheduleRefData`
- 响应 DTO`CoursePackageResponse.CoursePackageCourseItem.scheduleRefData`
**前端显示**
学校端排课功能中,选择课程包后会自动显示该课程包的排课计划参考,帮助老师了解课程安排建议。
### 后续工作
- [ ] 考虑添加 `collectionId` 存储(需要数据库迁移和 DTO 更新)
---