# 课程设置页课程详情、课件列表与课件标签 ## 问题背景 每日课 `daily-lesson/course.html`(课程设置页)左侧是播放清单树(tnode),右侧是文件浏览器,原来只能把视频加进播放清单。一门课除了视频,还会有课本、音频、练习册、闪卡、台词等资源,需要挂到清单里的某个节点上,并按资源标题打标签。 ## 用户对话整理 course.html 页面 tnode 增加点击事件,点击后,右侧文件浏览器下边框向上收缩一半,留出新区域增加课程详情容器框。框内此时和上方文件浏览器联动。文件浏览器隐藏原本的「添加到播放清单」按钮,增加「添加为课件」,加入课件后,文件详情区域展示为课件列表,课件列表顶部有快捷标签:课本、音频、练习册、闪卡、台词,也可以对课件(列表文件)右击,添加标签,标签也可以理解为资源标题,常见的资源都会有类似的标题。上述标签作为基础标签(标题),这里不要硬编码标题,后续资源可能有更多扩展标题。可以增加资源码+标题名的形式定义标签。 第二轮(player.html 附件与 PDF 预览): player.html 页面视频下方区域和 course.html 页面文件浏览器下方类似:对应课程在视频下方展示课程附件列表。这里的附件可以点击,并在隐藏左侧课程列表时(点击右上角隐藏课程列表按钮后),将附件列表调整到左侧同原本课程列表的宽度,并在附件列表右侧增加 pdf 预览区域。点击对应的附件,则 pdf 预览区域直接显示附件内容。pdf 附件参考项目里 `D:\codes\MyProjects\easy-study\daily-lesson\frontend` 路径下的 pdf 阅读器和涂鸦工具,一模一样地迁移过来,方便孩子答题。 补充:附件仅调整宽度到左侧,不调整高度,视频还正常保持满屏宽度播放,在视频左下角展示附件列表。 ## 后续任务步骤 1. 后端:新增课件表、标签表、课件标签关联表;基础标签放在 `daily-lesson/backend/config/course-tags.json`,按「资源码 + 标题名」定义,首次读取时补进用户的标签字典。 2. 后端:新增标签列表/新建、节点课件列表/加入、课件打标签/去标签、移除课件接口;清单树返回每个节点的课件数;复制节点时连同课件和标签一起复制;删除节点时课件跟着删。 3. 后端:`GET /courses/browse` 增加 `kind=ware`,扫描课件类文件(视频、音频、PDF、图片、文档、文本、网页),默认仍只扫视频。 4. 前端 course.html:点 tnode 打开课程详情,右栏文件浏览器收缩到上半,下半是课程详情;再点同一节点或点关闭按钮收起。 5. 前端:详情打开时文件浏览器切到课件模式,「添加到播放清单」换成「添加为课件」,右键菜单同样换成加为课件;已是本节点课件的文件在浏览器里加标记;浏览器跳到节点所在目录。 6. 前端:课件列表顶部快捷标签从接口读取,点标签给选中的课件加/去标签,带计数;末尾「+ 标签」按资源码 + 标题名新建标签;课件右键菜单可加/去标签、新建标签、在文件浏览器中定位、打开、移除课件。 7. 补后端测试,并用临时库和临时端口在浏览器里验证,不碰正在用的 `lesson.db`。 8. 第二轮后端:新增 `GET /courses/{subject_id}/wares`(一门课全部课件)和 `GET /courses/ware/{id}/file`(从网站根目录读课件原文件,同源给 PDF 阅读器用)。 9. 第二轮前端 player.html:视频下方显示当前这一课的附件(本课和上级文件夹挂的课件),点附件打开预览;收起课程清单后,视频仍占满宽度,附件列表在视频左下方、宽度同原来的课程清单,右边是预览区。 10. 第二轮:PDF 用 pdf.js 逐页渲染成图片,照搬 `daily-lesson/frontend` 作业单的页面加涂鸦画布(SheetPage + ink.js)和右侧工具条(铅笔颜色粗细、橡皮大小、清空、ABC 印章、保存);图片附件同样可涂鸦;音频、视频、网页和文本也能在预览区打开。 ## 规划 - 课件挂在清单节点上,文件夹和视频都能挂。一个课件可以有多个标签,标签按用户存,所有科目共用。 - 「不硬编码」:前端不写任何标签名,只读 `GET /courses/tags`;基础标签只在配置文件里,加新基础标签改配置即可,用户也能在页面上新建。 - 课件模式扫描全部课件类文件,网站根目录下有 9 万多个 mp3、3 万多张图片,所以只在课件模式下这样扫,播放清单模式仍只扫视频;两种扫描结果在前端按「模式 + 路径」缓存,切换不重复扫描,点「打开」时重新扫描。 - 编辑模式下点行仍是勾选和选粘贴位置,不改课程详情。 - 第二轮:`daily-lesson/frontend` 里的「pdf 阅读器」其实是作业单图片(预先导出的 jpg)叠涂鸦画布,没有解析 PDF。player.html 的附件是真 PDF,所以引入 pdf.js(从仓库里 `studydeck` 已装的 pdfjs-dist 6.1.200 复制 legacy 版本到 `daily-lesson/vendor/pdfjs/`,含中文 CMap、标准字体和图片解码 wasm),先把每页画成图片,再套原样的页面和涂鸦逻辑。PDF 原文件经后端同源读取,避免资源主机跨域。 - 第二轮:课程清单展开时点附件,会自动收起清单再打开预览,因为预览区只在收起时出现。涂鸦和原来一样存在浏览器本地,按附件分开存。 ## 说明 - 相关旧目录:`daily-lesson/tasks/1115-齿轮按钮与清单编辑勾选`(文件浏览器、编辑模式的上一轮)。 - 新表:`daily_course_ware`(课件)、`daily_course_tag`(标签字典,资源码 + 标题名)、`daily_course_ware_tag`(对应关系)。启动时 `create_all` 自动建,不改旧表。 - 新接口:`GET/POST /courses/tags`、`GET/POST /courses/node/{id}/wares`、`POST /courses/wares/tag`、`POST /courses/wares/delete`;`GET /courses/browse` 加 `kind=video|ware`,每个文件夹多回 `total`;清单树每个节点多回 `wares`。写进了 `daily-lesson/docs/course-library-design.md`。 - 基础标签只在 `daily-lesson/backend/config/course-tags.json`。每次读标签时,配置里有、用户没有的资源码会补上。以后如果做「删除标签」,要先改成只补一次,否则删掉的基础标签会被补回来。 - 课件模式扫描量:整个网站根目录 14.5 万个文件、约 10MB、1.2 秒;ORT 1.4 万个、1.2MB、0.13 秒。切课件模式时沿用当前打开的范围;当前范围是整个网站根目录时只扫目标目录。 - 课件右键菜单的标签:都有打勾(点了去掉)、部分有画横线(点了都加上)、都没有留空(点了加上)。快捷标签:选中的课件都有时按钮带蓝框,点了去掉,否则都加上。 - 已用 `lesson.db` 的副本和临时端口 8169/5169 在浏览器里走过:点视频和文件夹打开详情(1280×800 下上下各 331px,820 宽窄屏也是各半),浏览器跳到节点目录并列出 MP3 等文件;加为课件 2 个,清单行出现课件数,浏览器行标「课件」;快捷标签加/去、右键加标签、部分有的标记、新建标签(错资源码被拦下,「Poster」存成 poster 并加到 2 个选中课件上)、定位闪烁、Delete 移除;关闭后回到只看视频、「添加到播放清单」回来;再点同一文件夹收起并取消选中;编辑模式下点行不改详情,删掉当前节点后详情收起,课件列表里按 Delete 不会删清单。控制台无报错(只有编辑模式勾选框没有 name 的旧提示)。后端 21 个测试通过(新增 3 个)。 - 正在跑的 8160 后端仍是旧进程,没有加载这次改动,要重启一次。重启前打开课程详情会提示「读不到标签 / 课件,8160 后端要重启一次」,课件模式只看得到视频。 - 没做:标签改名、删除、排序;课件排序和改名;孩子端或播放器里展示课件。 ### 第二轮:播放器附件与 PDF 预览 - 新接口:`GET /courses/{subject_id}/wares`、`GET /courses/ware/{id}/file`。后者只读网站根目录里、已加为课件的本地文件,路径按字面拼,拒绝 `.`、`..`、反斜杠、冒号;测试里覆盖了越界、外链、文件不在。后端 22 个测试通过(新增 1 个)。 - pdf.js:`daily-lesson/vendor/pdfjs/`(6.1.200 legacy,约 4.2MB,199 个文件),附 `README.md` 说明来源和升级方式。`tools/dev_server.py` 补了 `.mjs`、`.wasm` 的类型,Windows 注册表可能把脚本类型改掉,和原来 `.js` 的写法一样显式写死。 - pdf.js 6 的文档对象没有 `destroy()`,要销毁加载任务;宽屏时滚动的是播放区那一列,懒加载的观察范围要用这一列,否则只画得出第一页。 - 已用 `lesson.db` 副本和 8169/5169 在浏览器里走过:1280×800 下清单展开时附件在视频下方占满右栏;点 PDF 后清单收起,视频 1238px 满宽,附件 360px 在左下,预览在右并滚到顶;36 页的 PDF 先画 2 页,往下滚再画;中文课表 PDF 正常;铅笔、ABC 印章写进 `course-ware-ink-v1:5`,换附件再回来涂鸦还在;图片附件能涂鸦,音频附件出播放器、工具条收起;展开清单时预览和工具条藏起,再收起恢复;下一课只剩文件夹挂的附件,预览清空。820 宽(iPad 竖屏)同样左右排开。控制台只有 favicon 的 404。 - 8160 现在是 17:04 带 `--reload` 重启的,已经加载了新接口。5160 页面服务没在跑,要开 `python tools/dev_server.py`。 - 没做:涂鸦存到服务器(现在和原作业单一样只存在这台设备的浏览器里);PDF 缩放。