kindergarten_java/docs/CHANGELOG.md

变更日志 (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 开始规范化维护。