e87e2dde00
后端重构:
- 添加统一响应格式 ResultDto<T> 和 PageResultDto<T>
- 添加分页查询 DTO 基类 PageQueryDto
- 添加响应转换拦截器 TransformInterceptor
- 添加公共工具函数（JSON 解析、分页计算）
- 配置 Swagger/OpenAPI 文档（访问路径：/api-docs）
- Tenant 模块 DTO 规范化示例（添加 @ApiProperty 装饰器）
- CourseLesson 控制器重构 - 移除类级路径参数，修复 Orval 验证错误
- 后端 DTO 规范化 - 为 Course、Lesson、TeacherCourse、SchoolCourse 控制器添加完整的 Swagger 装饰器
前端重构:
- 配置 Orval 从后端 OpenAPI 自动生成 API 客户端
- 生成 API 客户端代码（带完整参数定义）
- 创建 API 客户端统一入口 (src/api/client.ts)
- 创建 API 适配层 (src/api/teacher.adapter.ts)
- 配置文件路由 (unplugin-vue-router)
- 课程模块迁移到新 API 客户端
- 修复 PrepareModeView.vue API 调用错误
- 教师模块迁移到新 API 客户端
- 修复 school-course.ts 类型错误
- 清理 teacher.adapter.ts 未使用导入
- 修复 client.ts API 客户端结构
- 创建文件路由目录结构
Bug 修复:
- 修复路由配置问题 - 移除 top-level await，改用手动路由配置
- 修复响应拦截器 - 正确解包 { code, message, data } 格式的响应
- 清理 teacher.adapter.ts 未使用导入
- 修复 client.ts API 客户端结构
- 创建文件路由目录结构
系统测试:
- 后端 API 测试通过 (7/7)
- 前端路由测试通过 (4/4)
- 数据库完整性验证通过
- Orval API 客户端验证通过
- 超管端功能测试通过 (97.8% 通过率)
新增文件:
- reading-platform-backend/src/common/dto/result.dto.ts
- reading-platform-backend/src/common/dto/page-query.dto.ts
- reading-platform-backend/src/common/interceptors/transform.interceptor.ts
- reading-platform-backend/src/common/utils/json.util.ts
- reading-platform-backend/src/common/utils/pagination.util.ts
- reading-platform-frontend/orval.config.ts
- reading-platform-frontend/src/api/generated/mutator.ts
- reading-platform-frontend/src/api/client.ts
- reading-platform-frontend/src/api/teacher.adapter.ts
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
227 lines
10 KiB
Markdown
227 lines
10 KiB
Markdown
# Page snapshot
|
||
|
||
```yaml
|
||
- generic [ref=e1]:
|
||
- generic [ref=e3]:
|
||
- complementary [ref=e4]:
|
||
- generic [ref=e5]:
|
||
- generic [ref=e6]:
|
||
- img "Logo" [ref=e7]
|
||
- generic [ref=e8]:
|
||
- generic [ref=e9]: 月亮幼儿园
|
||
- generic [ref=e10]: 少儿智慧阅读
|
||
- generic [ref=e11]: 服务平台
|
||
- menu [ref=e12]:
|
||
- menuitem "home 首页" [ref=e13] [cursor=pointer]:
|
||
- img "home" [ref=e14]:
|
||
- img [ref=e15]
|
||
- generic [ref=e18]: 首页
|
||
- menuitem "team 我的班级" [ref=e19] [cursor=pointer]:
|
||
- img "team" [ref=e20]:
|
||
- img [ref=e21]
|
||
- generic [ref=e24]: 我的班级
|
||
- menuitem "book 课程中心" [ref=e25] [cursor=pointer]:
|
||
- img "book" [ref=e26]:
|
||
- img [ref=e27]
|
||
- generic [ref=e30]: 课程中心
|
||
- menuitem "folder-add 校本课程包" [ref=e31] [cursor=pointer]:
|
||
- img "folder-add" [ref=e32]:
|
||
- img [ref=e33]
|
||
- generic [ref=e36]: 校本课程包
|
||
- menuitem "calendar 上课记录" [ref=e37] [cursor=pointer]:
|
||
- img "calendar" [ref=e38]:
|
||
- img [ref=e39]
|
||
- generic [ref=e42]: 上课记录
|
||
- menuitem "schedule 我的课表" [ref=e43] [cursor=pointer]:
|
||
- img "schedule" [ref=e44]:
|
||
- img [ref=e45]
|
||
- generic [ref=e48]: 我的课表
|
||
- menuitem "check-square 阅读任务" [ref=e49] [cursor=pointer]:
|
||
- img "check-square" [ref=e50]:
|
||
- img [ref=e51]
|
||
- generic [ref=e55]: 阅读任务
|
||
- menuitem "file-text 课程反馈" [ref=e56] [cursor=pointer]:
|
||
- img "file-text" [ref=e57]:
|
||
- img [ref=e58]
|
||
- generic [ref=e61]: 课程反馈
|
||
- menuitem "camera 成长档案" [ref=e62] [cursor=pointer]:
|
||
- img "camera" [ref=e63]:
|
||
- img [ref=e64]
|
||
- generic [ref=e67]: 成长档案
|
||
- generic [ref=e68]:
|
||
- generic [ref=e69]:
|
||
- img "menu-fold" [ref=e71] [cursor=pointer]:
|
||
- img [ref=e72]
|
||
- generic [ref=e75]:
|
||
- img "bell" [ref=e78] [cursor=pointer]:
|
||
- img [ref=e79]
|
||
- generic [ref=e82] [cursor=pointer]:
|
||
- img "user" [ref=e85]:
|
||
- img [ref=e86]
|
||
- generic [ref=e88]: 李老师
|
||
- img "down" [ref=e90]:
|
||
- img [ref=e91]
|
||
- main [ref=e93]:
|
||
- generic [ref=e94]:
|
||
- generic [ref=e95]:
|
||
- generic [ref=e96]:
|
||
- button "left 返回" [ref=e97] [cursor=pointer]:
|
||
- img "left" [ref=e98]:
|
||
- img [ref=e99]
|
||
- generic [ref=e101]: 返回
|
||
- img "封面" [ref=e103]
|
||
- generic [ref=e104]:
|
||
- heading "📚 备课模式：折耳兔奇奇测试课程01" [level=1] [ref=e105]
|
||
- generic [ref=e106]:
|
||
- generic [ref=e107]:
|
||
- img "book" [ref=e108]:
|
||
- img [ref=e109]
|
||
- text: 折耳兔奇奇
|
||
- generic [ref=e111]:
|
||
- img "clock-circle" [ref=e112]:
|
||
- img [ref=e113]
|
||
- text: 预计 85 分钟
|
||
- generic [ref=e116]: 小班
|
||
- generic [ref=e117]:
|
||
- button "calendar 预约上课" [ref=e118] [cursor=pointer]:
|
||
- img "calendar" [ref=e119]:
|
||
- img [ref=e120]
|
||
- generic [ref=e122]: 预约上课
|
||
- button "play-circle 开始上课" [ref=e123] [cursor=pointer]:
|
||
- img "play-circle" [ref=e124]:
|
||
- img [ref=e125]
|
||
- generic [ref=e128]: 开始上课
|
||
- button "close 退出备课" [ref=e129] [cursor=pointer]:
|
||
- img "close" [ref=e130]:
|
||
- img [ref=e131]
|
||
- generic [ref=e133]: 退出备课
|
||
- generic [ref=e137]:
|
||
- generic [ref=e139]:
|
||
- generic [ref=e140]:
|
||
- generic [ref=e141] [cursor=pointer]:
|
||
- generic [ref=e142]: 📋
|
||
- text: 课程包概览
|
||
- generic [ref=e143]:
|
||
- generic [ref=e144] [cursor=pointer]: 基本信息
|
||
- generic [ref=e145] [cursor=pointer]: 课程介绍
|
||
- generic [ref=e146] [cursor=pointer]: 排课计划参考
|
||
- generic [ref=e147] [cursor=pointer]: 环创建设
|
||
- generic [ref=e148]:
|
||
- generic [ref=e149] [cursor=pointer]:
|
||
- generic [ref=e150]: 📖
|
||
- text: 包含课程 (4)
|
||
- generic [ref=e151]:
|
||
- generic [ref=e153] [cursor=pointer]:
|
||
- generic [ref=e154]: 📖
|
||
- generic [ref=e155]: 导入课
|
||
- generic [ref=e156]: 10分钟
|
||
- generic [ref=e158] [cursor=pointer]:
|
||
- generic [ref=e159]: 👥
|
||
- generic [ref=e160]: 集体课
|
||
- generic [ref=e161]: 25分钟
|
||
- generic [ref=e163] [cursor=pointer]:
|
||
- generic [ref=e164]: 🏃
|
||
- generic [ref=e165]: 健康领域课
|
||
- generic [ref=e166]: 25分钟
|
||
- generic [ref=e168] [cursor=pointer]:
|
||
- generic [ref=e169]: 🔬
|
||
- generic [ref=e170]: 科学领域课
|
||
- generic [ref=e171]: 25分钟
|
||
- generic [ref=e172]:
|
||
- generic [ref=e173]:
|
||
- generic [ref=e174]: 📝
|
||
- text: 我的备课笔记
|
||
- button "save 保存" [ref=e175] [cursor=pointer]:
|
||
- img "save" [ref=e176]:
|
||
- img [ref=e177]
|
||
- generic [ref=e179]: 保存
|
||
- textbox "在这里记录您的备课笔记、教学心得或需要特别注意的事项..." [ref=e181]
|
||
- generic [ref=e182]:
|
||
- button "clear 清除" [ref=e183] [cursor=pointer]:
|
||
- img "clear" [ref=e184]:
|
||
- img [ref=e185]
|
||
- generic [ref=e187]: 清除
|
||
- button "printer 打印素材清单" [ref=e188] [cursor=pointer]:
|
||
- img "printer" [ref=e189]:
|
||
- img [ref=e190]
|
||
- generic [ref=e192]: 打印素材清单
|
||
- generic [ref=e196]:
|
||
- heading "基本信息" [level=2] [ref=e198]
|
||
- generic [ref=e200]:
|
||
- generic [ref=e201]:
|
||
- generic [ref=e202]:
|
||
- img "info-circle" [ref=e203]:
|
||
- img [ref=e204]
|
||
- text: 基本信息
|
||
- table [ref=e209]:
|
||
- rowgroup [ref=e210]:
|
||
- row "课程名称 折耳兔奇奇测试课程01 关联绘本 折耳兔奇奇" [ref=e211]:
|
||
- rowheader "课程名称" [ref=e212]
|
||
- cell "折耳兔奇奇测试课程01" [ref=e213]:
|
||
- generic [ref=e214]: 折耳兔奇奇测试课程01
|
||
- rowheader "关联绘本" [ref=e215]
|
||
- cell "折耳兔奇奇" [ref=e216]:
|
||
- generic [ref=e217]: 折耳兔奇奇
|
||
- row "课程主题 - 预计时长 85 分钟" [ref=e218]:
|
||
- rowheader "课程主题" [ref=e219]
|
||
- cell "-" [ref=e220]:
|
||
- generic [ref=e221]: "-"
|
||
- rowheader "预计时长" [ref=e222]
|
||
- cell "85 分钟" [ref=e223]:
|
||
- generic [ref=e224]: 85 分钟
|
||
- row "适用年级 小班" [ref=e225]:
|
||
- rowheader "适用年级" [ref=e226]
|
||
- cell "小班" [ref=e227]:
|
||
- generic [ref=e229]: 小班
|
||
- row "核心内容 认识自我" [ref=e230]:
|
||
- rowheader "核心内容" [ref=e231]
|
||
- cell "认识自我" [ref=e232]:
|
||
- generic [ref=e233]: 认识自我
|
||
- generic [ref=e234]:
|
||
- generic [ref=e235]:
|
||
- img "picture" [ref=e236]:
|
||
- img [ref=e237]
|
||
- text: 课程封面
|
||
- img "课程封面" [ref=e240]
|
||
- generic [ref=e241]:
|
||
- generic [ref=e242]:
|
||
- img "bar-chart" [ref=e243]:
|
||
- img [ref=e244]
|
||
- text: 课程统计
|
||
- generic [ref=e246]:
|
||
- generic [ref=e248]:
|
||
- generic [ref=e249]: 课程数量
|
||
- generic [ref=e250]:
|
||
- generic [ref=e252]: "4"
|
||
- generic [ref=e253]: 节
|
||
- generic [ref=e255]:
|
||
- generic [ref=e256]: 预计时长
|
||
- generic [ref=e257]:
|
||
- generic [ref=e259]: "85"
|
||
- generic [ref=e260]: 分钟
|
||
- generic [ref=e262]:
|
||
- generic [ref=e263]: 教师使用
|
||
- generic [ref=e264]:
|
||
- generic [ref=e266]: "0"
|
||
- generic [ref=e267]: 位
|
||
- generic [ref=e269]:
|
||
- generic [ref=e270]: 评分
|
||
- generic [ref=e271]:
|
||
- generic [ref=e272]:
|
||
- generic [ref=e273]: "0"
|
||
- text: ".0"
|
||
- generic [ref=e274]: /5
|
||
- dialog [ref=e276]:
|
||
- document:
|
||
- generic [ref=e279]:
|
||
- generic [ref=e280]:
|
||
- img "exclamation-circle" [ref=e281]:
|
||
- img [ref=e282]
|
||
- generic [ref=e284]: 开始上课
|
||
- generic [ref=e285]: 确认要开始上课吗？系统将创建一条新的授课记录。
|
||
- generic [ref=e286]:
|
||
- button "取 消" [ref=e287] [cursor=pointer]:
|
||
- generic [ref=e288]: 取 消
|
||
- button "确认开始" [active] [ref=e289] [cursor=pointer]:
|
||
- generic [ref=e290]: 确认开始
|
||
``` |