course / content-structure
课程内容
课程信息架构、课时设计规范、媒体与题库、测验作业参数与迁移项目的工程化做法。
课程是有谷乐学里 复用价值最高 的资产。把章节结构、媒体规范、题库字段与发布流程定义清楚，能显著降低教研返工与学员端故障。本页面向内容负责人与制作老师。
课程信息架构：从大纲到小节
推荐层级
必学与选学
- 必学：考试与证书挂钩，出现在默认可见路径上。
- 选学：拓展、阅读材料、兴趣分支；需在路径上明示「可选」，避免学员误以为算分。
在学期中途 重排章节顺序 前，评估对已学习学员的影响：是否需要批量标记「章节已读」或重新发布路径。若产品不支持平滑迁移，宁可新建学期副本。
课时设计：媒体、交互与节奏
视频与图文
- 视频：建议分段 + 章节标记（若播放器支持），利于跳转复习；片头片尾品牌露出需压缩时长。
- 图文：长文拆成「折叠段落」或分页（以学员端能力为准），每屏一个核心结论。
- 字幕与讲义：无障碍与弱网场景友好；字幕文件请与视频同一时间轴校验。
内嵌练习的位置
练习放在 认知负荷峰值后（例如演示完例题立刻跟练），比全部堆在课尾效果更好。每课时的练习次数建议 1～3 次，避免滑腻。
可达性与体验
- 重要操作按钮勿只依赖颜色区分。
- 外链一律
https，并在新标签打开（若可配置）。 - 大文件提供 体积与预计加载时间 提示。
测验：题型、参数与质检
常见参数组合
题库质检清单（发布前）
- 题干无歧义；否定式提问量适中。
- 单选/多选/判断的 正确项数量 与题型一致。
- 解析覆盖「为什么错」，而非只给答案字母。
- 图片分辨率与题面可读性在手机屏上验证。
- 分值总和与成绩单展示一致（含四舍五入规则）。
作业：批改、互评与迟交
- 评分量表：若有多位助教，先对齐 rubric，减少学员投诉。
- 迟交：明确是否扣分、是否影响证书；规则写在作业说明首位。
- 附件大小与格式：限制 zip/pdf/doc 等，防止恶意文件与安全告警。
课程内容迁移
迁移往往是项目里 最耗时 的部分。建议用「资产盘点 → 试点 → 批处理 → 验收」四阶段，而不是一次性全量导入。
阶段 0：资产盘点
列出：
- 章节树（来源系统导出或手工表格）。
- 媒体清单（URL、分辨率、是否需转码、版权证明）。
- 题库导出（题型、选项、答案、标签字段是否齐全）。
阶段 1：试点单元（1～2 章）
目标：跑通 导入 → 学员端渲染 → 测验判分 → 报表。
记录：
- 字段映射表（老系统列名 → 有谷字段名）。
- 失败样本与修复规则（例如选项里含换行、图片相对路径）。
阶段 2：批处理
- 分批：按课程或按周次拆批，单批出问题可回滚。
- 幂等：脚本或接口导入时带业务主键（老课程 ID / 题号），避免重复跑批产生双份内容。
- 灰度：先对内部账号开放新课程，再对学员切换路径绑定。
阶段 3：验收与冻结
- 与教务对 总章节数、总题数、媒体 404 列表 做签字表。
- 开课前 冻结 大改；紧急修复走变更记录。
迁移中的典型坑
若老系统无法导出结构化数据，优先雇人 先结构化再导入，比在平台里手工复制粘贴数千道题更便宜。
发布与版本习惯（建议）
- 大课用 「学期/期次」 Suffix 区分版本，避免学员搜到过期课。
- 教研内部用变更日志记录「改了哪几题、哪几段视频」，便于审计与家长/学员问询。
相关链接
