371 lines
11 KiB
Markdown
371 lines
11 KiB
Markdown
# 变更日志 (CHANGELOG)
|
||
|
||
本文档记录项目的所有重要变更。
|
||
|
||
---
|
||
|
||
## [Unreleased]
|
||
|
||
### 待处理
|
||
- TypeScript 编译警告修复（约63个）
|
||
- 性能优化
|
||
|
||
---
|
||
|
||
## [2026-02-28]
|
||
|
||
### 新增
|
||
- **课程包第7步 - 环创建设**
|
||
- 课程包创建/编辑增加第7步"环创建设"
|
||
- 富文本输入框（最大3000字）
|
||
- 填写提示（主题环境布置、区域活动环境、阅读角创设、材料投放建议等）
|
||
- 超管端和学校端课程包详情页展示环创建设内容
|
||
|
||
### 优化
|
||
- **学校端课程管理年级Tab重设计**
|
||
- 原设计：使用 Ant Design Radio.Group，与页面风格不协调
|
||
- 新设计：白色卡片容器 + 自定义Tab按钮
|
||
- 选中状态：绿色渐变背景，与页面头部呼应
|
||
- 筛选功能：支持按年级（全部/小班/中班/大班）筛选课程
|
||
|
||
### 数据库变更
|
||
- Course 表添加 `environment_construction` 字段（TEXT类型）
|
||
|
||
### 文件变更
|
||
- 新增：`Step7Environment.vue` 组件
|
||
- 修改：7个文件（后端2个，前端5个）
|
||
|
||
---
|
||
|
||
## [2026-02-27]
|
||
|
||
### 新增
|
||
- **课程包创建/编辑6步流程重构**
|
||
- 步骤1：基本信息（名称、主题、年级、核心内容、封面）
|
||
- 步骤2：课程介绍（8个Tab：简介、亮点、目标、安排、重难点、方法、评价、注意事项）
|
||
- 步骤3：排课计划参考（可编辑表格）
|
||
- 步骤4：导入课配置（含资源上传、教学反思）
|
||
- 步骤5：集体课配置（含核心资源、4环节模板）
|
||
- 步骤6：五大领域课配置（健康/语言/社会/科学/艺术）
|
||
- **新组件**
|
||
- FileUploader - 统一文件上传组件
|
||
- LessonStepsEditor - 教学环节编辑器
|
||
- LessonConfigPanel - 课程配置面板
|
||
- **文件类型扩展**
|
||
- 新增 audio 音频类型支持
|
||
- 新增 document 文档类型支持
|
||
- PPT类型同时支持PDF格式
|
||
- **数据库字段**
|
||
- 课程介绍8个字段（introSummary等）
|
||
- coreContent 核心内容字段
|
||
- scheduleRefData 排课参考字段
|
||
|
||
### 优化
|
||
- 富文本输入框字符限制从500增加到1500
|
||
- 添加字数统计显示（show-count）
|
||
- 课程封面图片URL构建逻辑优化
|
||
- 保存错误处理优化，添加详细日志
|
||
|
||
### 修复
|
||
- 课程封面图片不显示 - URL路径重复问题
|
||
- 导入课缺少资源上传功能
|
||
- 导入课缺少教学反思字段
|
||
- 教学课件只支持PPT不支持PDF
|
||
- 保存课程偶发失败
|
||
- 文件预览URL路径错误
|
||
- 学校端课程详情不显示课程配置 - API缺少courseLessons关联
|
||
- 超管端排课参考表格列名不匹配 - dayOfWeek/activity
|
||
- 学校端排课参考表格不显示 - 数组类型判断
|
||
|
||
### 学校端新功能（晚上）
|
||
- **套餐管理重构**
|
||
- 已授权套餐列表（卡片布局）
|
||
- 套餐详情弹窗
|
||
- 续订功能（6/12/24个月）
|
||
- 到期状态提醒
|
||
- **课程详情页适配新结构**
|
||
- 信息卡片网格布局
|
||
- 课程介绍8个Tab
|
||
- 排课参考表格
|
||
- 课程配置卡片
|
||
- 数字资源汇总
|
||
- **校本课程包功能完善**
|
||
- 列表页统计概览
|
||
- 预约功能弹窗
|
||
- 排课管理弹窗
|
||
- 详情页预约记录
|
||
|
||
### 文件变更
|
||
- 后端新增：14 个文件（新模块）
|
||
- 后端修改：3 个文件
|
||
- 前端新增：16 个文件（页面和组件）
|
||
- 前端修改：5 个文件
|
||
|
||
---
|
||
|
||
## [2026-02-24]
|
||
|
||
### 新增
|
||
- **学校端家长管理功能**
|
||
- 家长列表（卡片网格布局）
|
||
- 家长CRUD操作（创建、编辑、删除）
|
||
- 重置密码（生成临时密码）
|
||
- 管理关联孩子（查看、添加、解除）
|
||
- 关系标签显示（父亲/母亲/祖父/祖母/其他，不同颜色）
|
||
- **选择孩子功能优化**
|
||
- 弹窗+表格+搜索方式替代下拉框
|
||
- 支持按姓名搜索、按班级筛选
|
||
- 分页加载，支持大量学生数据
|
||
|
||
### 修复
|
||
- 家长管理页面重复变量声明错误 - 合并重复代码块
|
||
- 学生选择表格行选择类型错误 - 修正 onChange 参数类型
|
||
|
||
### 优化
|
||
- 孩子列表显示关系标签，格式为"关系：XX"
|
||
- 不同关系使用不同颜色标签区分
|
||
- 移除未使用的代码（allStudents、loadAllStudents、availableStudents）
|
||
|
||
---
|
||
|
||
## [2026-02-23]
|
||
|
||
### 新增
|
||
- **学校端任务管理 API**
|
||
- SchoolTask、TaskCompletion 类型定义
|
||
- getSchoolTasks、createSchoolTask、updateSchoolTask、deleteSchoolTask
|
||
- getSchoolTaskCompletions 获取任务完成情况
|
||
- **学校端导航菜单二级结构**
|
||
- 人员管理：教师管理、学生管理、班级管理
|
||
- 教学管理：课程管理、课程排期、阅读任务、任务模板、课程反馈
|
||
- 数据中心：数据报告、成长档案
|
||
- 系统管理：套餐管理、操作日志、系统设置
|
||
|
||
### 修复
|
||
- 学校端任务列表无法加载数据 - 补全 API 函数和类型定义
|
||
- 教师端上课记录缺少布置任务入口 - 添加"课后记录"按钮跳转
|
||
|
||
### 优化
|
||
- 学校端导航菜单重构：14个扁平菜单 → 5个一级菜单 + 子菜单
|
||
- 移除所有 Emoji 图标，使用 Ant Design Vue 图标组件
|
||
- 添加 UI 规范：禁止使用 Emoji 图标
|
||
|
||
### 功能确认（已实现）
|
||
- **P1 数据统计增强** ✅
|
||
- 学校端授课统计图表（stats.service.ts）
|
||
- 教师端个人统计（teacher-course.service.ts）
|
||
- 数据导出功能（export.service.ts）
|
||
- **P2 排课功能增强** ✅
|
||
- 课程提醒（schedule-notification.service.ts）
|
||
- 排课模板（school.service.ts）
|
||
- 批量排课（batchCreateSchedules）
|
||
- 拖拽调课（CalendarView.vue + fullcalendar）
|
||
- **P0 阅读任务模块** ✅
|
||
- 家长端任务功能
|
||
- 教师端完成情况详情页
|
||
- 课后记录→布置任务流程
|
||
- **P2/P3 任务模块增强** ✅
|
||
- 任务模板功能（TaskTemplate）
|
||
- 任务提醒通知（定时任务+手动提醒）
|
||
- 任务统计报表
|
||
|
||
---
|
||
|
||
## [2026-02-22]
|
||
|
||
### 新增
|
||
- 测试记录文档系统 (`/docs/test-logs/`)
|
||
- 各端测试记录模板和规范
|
||
- **班级管理功能增强**
|
||
- 数据模型：ClassTeacher 关联表（支持多教师协作）、StudentClassHistory 调班历史表
|
||
- 学校端：班级教师团队管理（添加/编辑/移除教师，设置角色和班主任）
|
||
- 学校端：学生调班功能（选择目标班级、填写原因、查看调班历史）
|
||
- 教师端：班级角色显示（主班/配班/保育员标签、班主任标记）
|
||
- **超管端功能完善**
|
||
- 租户管理完整功能（CRUD、配额调整、密码重置、状态管理）
|
||
- 系统设置后端API
|
||
- 数据看板图表（ECharts：趋势图、统计卡片）
|
||
- **展播模式独立页面**
|
||
- 新路由 `/teacher/broadcast/:id`
|
||
- 新标签页打开，便于教师投屏给学生看的同时自己查看讲稿
|
||
- 支持通过 URL 参数 `?step=N` 指定初始环节
|
||
- 自动全屏、键盘快捷键支持
|
||
- Lucide Vue Next 图标库
|
||
|
||
### 优化
|
||
- "投屏模式"改名为"展播模式"
|
||
- 移除授课页面冗余的全屏按钮
|
||
- 展播页面深色主题设计，高对比度配色，适合课堂投影
|
||
|
||
### 测试
|
||
- 超管端完整功能测试
|
||
- 数据看板、资源库管理正常
|
||
- 租户管理、系统设置已实现
|
||
- 学校端回归测试
|
||
- 所有模块正常
|
||
- 修复系统设置页面导入错误
|
||
- 教师端回归测试
|
||
- 所有模块正常
|
||
- 家长端功能测试
|
||
- 所有模块正常
|
||
- **展播模式自动化测试** (Playwright)
|
||
- 新标签页打开功能 ✅
|
||
- KidsMode 组件显示 ✅
|
||
- 导航控制正常 ✅
|
||
|
||
### 修复
|
||
- 学校端系统设置页面无法加载 - 修复 fileApi 导入方式 (`SettingsView.vue`)
|
||
- 租户详情API 500错误 - BigInt转String序列化
|
||
- 租户配额显示模板语法错误
|
||
- 资源上传响应属性名不匹配
|
||
- 文件下载URL未定义
|
||
- 课程年级筛选API 500错误 - SQLite JSON查询兼容
|
||
- 学生性别统计/显示不一致
|
||
- 课程授权后统计未更新
|
||
- 课程搜索不工作
|
||
- 套餐配额数据不同步
|
||
- 学生年龄显示格式异常
|
||
- 学生调班API 500错误 - 前端变量名冲突 + 数据库字段约束 (`StudentListView.vue`, `schema.prisma`)
|
||
- 学校端导航栏缺少班级管理入口 - 添加菜单项 (`LayoutView.vue`)
|
||
- 教师端移除"添加新班级"功能 - 班级创建应由学校管理员操作 (`ClassListView.vue`)
|
||
- **PDF资源无法显示** - EbookViewer 使用 embed 标签替代 img 标签 (`EbookViewer.vue`)
|
||
|
||
### 测试验证
|
||
- 班级教师管理功能 - 添加/编辑教师角色 ✅
|
||
- 学生调班功能 - 调班操作和历史记录 ✅
|
||
- 教师端班级角色显示 - 主班/班主任标签 ✅
|
||
- 展播模式新标签页功能 ✅
|
||
|
||
---
|
||
|
||
## [2026-02-21]
|
||
|
||
### 新增
|
||
- 家长端完整功能
|
||
- 登录、孩子信息
|
||
- 阅读记录
|
||
- 任务查看
|
||
- 成长档案
|
||
- 通知系统（NotificationBell组件）
|
||
- 数据导出功能
|
||
- 教师端课程反馈页面
|
||
- `GET /teacher/feedbacks` - 反馈列表
|
||
- `GET /teacher/feedbacks/stats` - 反馈统计
|
||
|
||
### 修复
|
||
- 家长登录400错误 - LoginDto 添加 `parent` 角色
|
||
- User 接口缺少 `parent` 角色类型
|
||
- NotificationBell.vue 未使用的导入
|
||
- tagMaps.ts 重复的 ART 属性
|
||
- 教师端课程反馈404错误
|
||
|
||
---
|
||
|
||
## [2026-02-14]
|
||
|
||
### 新增
|
||
- 学校端核心管理模块
|
||
- 教师管理 CRUD
|
||
- 学生管理 CRUD + 批量导入
|
||
- 班级管理
|
||
- 统计数据
|
||
- 套餐信息
|
||
- 教师端首页API
|
||
- 今日课程
|
||
- 推荐课程
|
||
- 本周统计
|
||
- P1功能模块
|
||
- 资源库管理
|
||
- 成长档案
|
||
- 阅读任务
|
||
- 课程反馈
|
||
|
||
### 修复
|
||
- 学校端登录失败 - Tenant模型添加 loginAccount/passwordHash
|
||
- SQLite不支持@db.Text - 移除注解
|
||
- classEntity.lessons不存在 - 使用 lessonCount 替代
|
||
|
||
---
|
||
|
||
## [2026-02-13]
|
||
|
||
### 新增
|
||
- 课程发布审核流程
|
||
- 状态流转：草稿 → 待审核 → 已发布/已驳回
|
||
- 发布前完整性验证
|
||
- 版本历史快照
|
||
- 文件预览功能
|
||
- PDF预览（iframe）
|
||
- 音视频播放器
|
||
- 图片预览
|
||
- PPT在线预览
|
||
- 逐页脚本自动展开功能
|
||
|
||
### 修复
|
||
- 课程编辑数据持久化问题
|
||
- 课堂计划数据保存/加载
|
||
- 延伸活动数据保存/加载
|
||
- 测评工具数据保存/加载
|
||
- "保存课程"按钮状态错误 - 改为 DRAFT
|
||
- 提交审核验证逻辑错误
|
||
- PaletteOutlined 图标不存在 - 替换为 BgColorsOutlined
|
||
|
||
### 优化
|
||
- 延伸活动 UI 重新设计（卡片式布局）
|
||
|
||
---
|
||
|
||
## [2026-02-12]
|
||
|
||
### 新增
|
||
- 教师端核心业务流程打通
|
||
- 课程中心
|
||
- 备课模式
|
||
- 上课模式
|
||
- 课后记录
|
||
- 种子数据脚本
|
||
- 超管端课程包发布功能
|
||
|
||
### 修复
|
||
- 教师端LayoutView编译错误 - JSX语法问题
|
||
- 教师端API 404错误 - 模块未编译
|
||
|
||
---
|
||
|
||
## [2026-02-10]
|
||
|
||
### 新增
|
||
- 文件上传系统重构
|
||
- FormData文件上传
|
||
- Multer处理multipart/form-data
|
||
- 本地文件系统存储
|
||
- 多文件上传支持（每分类15个，单文件200MB）
|
||
- 统一启动脚本 (start-all.sh / stop-all.sh)
|
||
|
||
### 修复
|
||
- 封面图片显示文件名问题 - 静态文件路径配置
|
||
- 中文文件名乱码 - 安全文件名生成
|
||
- Vue编译错误 - 重复函数声明
|
||
|
||
---
|
||
|
||
## [2026-01-29] - 项目启动
|
||
|
||
### 新增
|
||
- 项目初始化
|
||
- 技术选型确定
|
||
- 数据库模型设计（15张表）
|
||
- 认证系统基础框架
|
||
- 四端页面框架
|
||
|
||
---
|
||
|
||
## 版本说明
|
||
|
||
- **[Unreleased]**: 开发中功能
|
||
- **[日期]**: 当天发布的版本
|
||
|
||
---
|
||
|
||
*本变更日志从 2026-02-22 开始规范化维护。*
|