docs: 更新开发日志 2026-03-21
记录学校端课程中心重构工作： - 后端 SchoolCourseController 返回完整 CourseResponse - 新增 CourseCenterView.vue 组件 - 新增 course-center.ts API 层 - 菜单文案修改：课程管理 → 课程中心 - 课程详情页现在展示完整数据 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Claude Opus 4.6
parent
ca56d8556e
commit
c2e4477cdf
203
docs/dev-logs/2026-03-21.md
Normal file
203
docs/dev-logs/2026-03-21.md
Normal file
@ -0,0 +1,203 @@
|
||||
# 开发日志 - 2026-03-21
|
||||
|
||||
## 学校端课程中心重构
|
||||
|
||||
### 背景
|
||||
|
||||
原有学校端"课程管理"模块功能单一：
|
||||
- 课程详情页展示数据不完整（缺少课程介绍、排课参考、环创建设等）
|
||||
- 与教师端课程中心存在功能重复
|
||||
- 用户体验与教师端不一致
|
||||
|
||||
### 目标
|
||||
|
||||
1. 学校端课程中心照搬教师端实现
|
||||
2. 课程详情页返回完整数据
|
||||
3. 统一两端浏览体验
|
||||
|
||||
---
|
||||
|
||||
## 完成的工作
|
||||
|
||||
### 1. 后端修改
|
||||
|
||||
#### SchoolCourseController.java
|
||||
- `getSchoolCourse()` 改为返回 `CourseResponse`（之前返回 `SchoolCourseResponse`）
|
||||
- 使用 `courseService.getCourseByIdWithLessons(id)` 获取完整数据
|
||||
- 与教师端 `TeacherCourseController.getCourse()` 保持一致
|
||||
|
||||
```java
|
||||
// 修改后
|
||||
@GetMapping("/{id}")
|
||||
public Result<CourseResponse> getSchoolCourse(@PathVariable Long id) {
|
||||
Long tenantId = SecurityUtils.getCurrentTenantId();
|
||||
courseService.getCourseByIdWithTenantCheck(id, tenantId);
|
||||
return Result.success(courseService.getCourseByIdWithLessons(id));
|
||||
}
|
||||
```
|
||||
|
||||
#### SchoolPackageController.java
|
||||
- 新增 `getPackagesByCollection()` - 获取套餐下的课程包列表
|
||||
- 新增 `getFilterMeta()` - 获取筛选元数据（年级、主题）
|
||||
|
||||
#### CourseCollectionService.java / Impl
|
||||
- 新增 `getPackagesByCollection()` 方法
|
||||
- 新增 `getFilterMeta()` 方法
|
||||
|
||||
#### PackageFilterMetaResponse.java（新增）
|
||||
- 筛选元数据响应类
|
||||
- 包含 grades 和 themes 两个列表
|
||||
|
||||
### 2. 前端修改
|
||||
|
||||
#### 新增文件
|
||||
|
||||
| 文件 | 说明 |
|
||||
|-----|------|
|
||||
| `src/api/course-center.ts` | 课程中心通用 API |
|
||||
| `src/views/school/courses-new/CourseCenterView.vue` | 学校端课程中心页面 |
|
||||
| `src/views/school/courses-new/components/CoursePackageCard.vue` | 课程包卡片组件 |
|
||||
| `src/views/teacher/courses-new/CourseCenterView.vue` | 教师端课程中心页面 |
|
||||
| `src/views/teacher/courses-new/components/CoursePackageCard.vue` | 课程包卡片组件 |
|
||||
|
||||
#### 修改文件
|
||||
|
||||
| 文件 | 修改内容 |
|
||||
|-----|---------|
|
||||
| `src/router/index.ts` | 课程中心路由指向新组件 |
|
||||
| `src/views/school/LayoutView.vue` | 菜单文案：课程管理 → 课程中心 |
|
||||
| `src/api/school.ts` | `getSchoolCourse()` 返回 `Promise<any>` |
|
||||
|
||||
### 3. 设计文档
|
||||
|
||||
新增：`docs/design/25-课程中心重构设计.md`
|
||||
|
||||
内容包括：
|
||||
- 功能对比矩阵（教师端 vs 学校端）
|
||||
- 数据展示对比（重构前后）
|
||||
- 架构设计（组件、API、后端）
|
||||
- 页面布局设计
|
||||
- 关键技术实现
|
||||
- 文件变更清单
|
||||
- 测试验证清单
|
||||
|
||||
---
|
||||
|
||||
## 课程详情页数据对比
|
||||
|
||||
| 数据项 | 重构前 | 重构后 |
|
||||
|-------|:------:|:------:|
|
||||
| 基本信息 | ✅ | ✅ |
|
||||
| 使用统计 | ✅ | ✅ |
|
||||
| 版本记录 | ✅ | ✅ |
|
||||
| 课程介绍（8项） | ❌ | ✅ |
|
||||
| 排课计划参考 | ❌ | ✅ |
|
||||
| 环创建设 | ❌ | ✅ |
|
||||
| 课程配置（lessons） | ❌ | ✅ |
|
||||
| 数字资源 | ❌ | ✅ |
|
||||
|
||||
---
|
||||
|
||||
## 关键技术点
|
||||
|
||||
### 1. API 返回完整 CourseResponse
|
||||
|
||||
课程详情 API 现在返回完整的 `CourseResponse`，包含：
|
||||
|
||||
```typescript
|
||||
{
|
||||
// 基本信息
|
||||
id, name, description, coverImagePath, durationMinutes,
|
||||
gradeTags, domainTags,
|
||||
|
||||
// 课程介绍（8项）
|
||||
introSummary, introHighlights, introGoals, introSchedule,
|
||||
introKeyPoints, introMethods, introEvaluation, introNotes,
|
||||
|
||||
// 排课参考
|
||||
scheduleRefData: JSON 格式的周计划表,
|
||||
|
||||
// 环创建设
|
||||
environmentConstruction,
|
||||
|
||||
// 课程配置
|
||||
courseLessons: [
|
||||
{
|
||||
id, name, lessonType, duration,
|
||||
objectives, preparation, extension, reflection,
|
||||
videoPath, pptPath, pdfPath,
|
||||
steps: [{ id, name, duration, objective, content }]
|
||||
}
|
||||
],
|
||||
|
||||
// 统计
|
||||
usageCount, teacherCount, avgRating
|
||||
}
|
||||
```
|
||||
|
||||
### 2. 前端页面布局
|
||||
|
||||
课程中心采用左右两栏布局：
|
||||
- **左侧**：套餐列表（垂直列表）
|
||||
- **右侧**：课程包网格 + 筛选区
|
||||
|
||||
课程详情页展示区域：
|
||||
1. 封面图
|
||||
2. 基本信息卡片（3列）
|
||||
3. 课程介绍（Tab 切换）
|
||||
4. 排课计划参考（表格）
|
||||
5. 环创建设
|
||||
6. 课程配置（课程卡片列表）
|
||||
7. 数字资源（分类展示）
|
||||
|
||||
---
|
||||
|
||||
## 测试验证
|
||||
|
||||
### API 测试
|
||||
|
||||
```bash
|
||||
# 登录获取 token
|
||||
curl -X POST http://localhost:8480/api/v1/auth/login \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"username":"school1","password":"123456"}'
|
||||
|
||||
# 获取课程详情
|
||||
curl -H "Authorization: Bearer $TOKEN" \
|
||||
http://localhost:8480/api/v1/school/courses/17 | jq '.data | keys'
|
||||
```
|
||||
|
||||
结果验证：
|
||||
- ✅ courseLessons: 7 个课程
|
||||
- ✅ scheduleRefData: 存在
|
||||
- ✅ introSummary 等字段: 存在
|
||||
- ✅ environmentConstruction: 存在
|
||||
|
||||
### 前端测试
|
||||
|
||||
- ✅ 学校端课程中心页面正常加载
|
||||
- ✅ 套餐列表正常显示
|
||||
- ✅ 课程包网格正常显示
|
||||
- ✅ 筛选功能正常
|
||||
- ✅ 课程详情页展示完整数据
|
||||
|
||||
---
|
||||
|
||||
## Git 提交记录
|
||||
|
||||
```
|
||||
ca56d85 docs: 添加课程中心重构设计文档
|
||||
3183d1d feat: 学校端课程中心优化 - 照搬教师端实现
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 遗留问题
|
||||
|
||||
1. **组件复用**：学校端和教师端的 CourseCenterView 代码高度相似，可考虑抽象为通用组件
|
||||
2. **学校端收藏**：暂未实现收藏功能
|
||||
3. **学校端创建校本**：暂未实现
|
||||
|
||||
---
|
||||
|
||||
*本日志创建于 2026-03-21*
|
||||
Loading…
Reference in New Issue
Block a user