# 开发日志 - 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 更新）

---