Files
dth/openspec/changes/chg_0012_lms_multiscene_v2/proposal.md
T
xstudio agent 4a6c044105 chg_0012: lms_multiscene_v2 提案 — 4 类场景课程平台(LMS v1 重建 + slide/quiz/sim/PBL + FRC 6-scene 模板)
WHY
LMS (chg_0006) 仅 students/courses/enrollment 3 表 + 无内容结构;代码 workspace+sandbox 双缺失需重建。借鉴 OpenMAIC 4 类场景(slide/quiz/simulation/PBL)作为内容结构模型,保持 NestJS+React 栈,零新框架/新依赖/新算子。

改动:技能矩阵 + 9 scenarios(v1 重建/多场景 schema/创建课程/选课进度/SlideScene/QuizScene/SimScene/FRC 模板/E2E 走课)+ 10 cases + 5 tasks DAG
设计:MiniMD 自实现 h1/h2/p/ul/li/code(5 节点,零 marked 依赖);PBL v1 占位(spec 含 type=prod,render 返 501,前后端文案一致「即将推出」);FRC 模板 embed_url 命名严格对应 chg_0010 S1-S6(字符串断言不真 GET iframe)
2026-09-29 14:22:26 +08:00

6.1 KiB
Raw Blame History

change_id, status, owner, stakeholders, priority, target_release, created, skip_coverage, requires_human_validation
change_id status owner stakeholders priority target_release created skip_coverage requires_human_validation
chg_0012 draft pm@dth
pd
dev
qa
P1 v0.6 2026-09-29 false false

Change: LMS v2 多场景课程平台

Why

dth LMS (chg_0006) 仅落地 students / courses / enrollment 三张表 + 17 e2e,没有课程内容结构——课程只是元数据(代码/学分/教师),没有「讲什么 / 测什么 / 练什么」。前端 LMS 视图从未构建(chg_0006 Non-Goals 显式排除)。chg_0006 主线 merge 后代码层也不可见(workspace + sandbox 双缺失),需要 chg_0012 重建并升级。

借鉴 OpenMAIC(THU-MAIC, Next.js + LangGraph)的核心 insight:4 类场景(slide / quiz / simulation / PBL)作为课程内容模型。dth 不引入新框架(不迁 Next.js、不引 LangGraph),保持 NestJS + React 一致性,把 4 类场景作为 NestJS 后端的 scene.type enum + React 前端 4 个渲染器落地。

dth 已具备的「interactive simulation」素材 = 19 算子 + chg_0010 FRC + chg_0011 VC 场景——比 OpenMAIC 自己造 HTML 物理实验更精准(隐私计算场景)。可作为 SimScene iframe 嵌入的天然内容源。

Who

  • 教师 / 教务管理员:建多场景课程(admin 权限)
  • 学员:选课 + 走完 slide/quiz/simulation/PBL + 进度跟踪
  • AI 助教(v2 可选):v1 不实现,留 TODO

Scope

  • 后端:
    • LMS v1 重建(chg_0006 缺失补回):3 张 PGlite 表 lms_student / lms_course / lms_enrollment
    • 多场景数据模型扩展:1 张新表 lms_course_scene(FK → lms_course),字段 scene_type enum(slide|quiz|simulation|pbl) + payload_json + order_index
    • 进度跟踪:lms_enrollment.progress_scene_ids[] JSON 字段
    • 渲染端点:
      • GET /api/ssw/dth/lms/courses/:id/scenes/:sceneId/render → 渲染后 HTML
      • POST /api/ssw/dth/lms/scenes/:sceneId/grade → 提交答题,返回判分结果
    • FRC 模板端点:POST /api/ssw/dth/lms/courses/from-frc-template → 自动生成 chg_0010 FRC 6-scene sim course
  • 前端:
    • views/LMS/CourseList.tsx:课程列表 + 选课按钮
    • views/LMS/CourseDetail.tsx:课程详情 + scene 列表 + 进度条
    • views/LMS/SceneRenderer.tsx:4 类 scene 渲染分发(Slide / Quiz / Simulation / PBL)
    • views/LMS/SlideScene.tsx / QuizScene.tsx / SimScene.tsx / PBLScene.tsx:4 类组件
    • Markdown → HTML 内联实现(h1/h2/p/ul/li/code),零新依赖
  • e2e:tests/e2e/dth_lms_v2.test.sh(10 case 覆盖 S1-S10)
  • 零新算子、零新依赖、零前端框架切换

Non-Goals

  • PBL 场景渲染 v1 不实现:spec 包含 type=pbl 占位(data model 允许),但 render 端点对 type=pbl 返回 501 NOT_IMPLEMENTED + 友好提示「PBL 场景 v2 实现,当前仅作课程占位」。前端 PBLScene 显示「即将推出」。
  • AI 助教 / TTS / 多 agent 教学:v1 不做,留 TODO。OpenMAIC 的多 agent 讨论、Q&A、白板、TTS 全部不在 chg_0012 scope。
  • slide 富文本(图片/公式/代码高亮):Markdown → HTML 仅支持 h1/h2/p/ul/li/code 5 类节点;图片/表格/LaTeX v2 再做。
  • Quiz 主观题 AI 评分:仅「选择题自动判分」+「简答关键词匹配」;LLM 评分留 v2。
  • scorm / xAPI 标准兼容:v1 不做。
  • 课程版本控制:scenes 不可编辑(POST 后 immutable),更新走 DELETE + POST。

Acceptance

  1. ✅ check_spec_coverage.sh gap=0(chg_0012 自含 10 scenarios / 10 cases / 5 tasks)
  2. ✅ tsc --noEmit 0 新错(除预存 chg_0002 vertical-lr.ts:52)
  3. ✅ bash tests/e2e/dth_lms_v2.test.sh pass=10 fail=0(耗时 < 60s)
  4. ✅ 5 回归套件全 PASS = chg_0008 operator_real (15) + chg_0009 sp1_more (27) + chg_0010 frc (37) + chg_0011 vc (10) + chg_0012 lms_v2 (10) = 99/0
  5. ✅ LMS 3 子系统恢复可见:GET /api/ssw/dth/lms/students 返回 chg_0006 seed 数据
  6. ✅ 多场景课程端到端:admin POST 1 个含 6 scene(slide+quiz+simulation+pbl)的课程 → student 选课 → 走完 6 scene → progress 100%
  7. ✅ FRC 6-scene 模板:POST /api/ssw/dth/lms/courses/from-frc-template 返回 course 含 6 个 simulation scene,每个 scene 对应 chg_0010 S1-S6
  8. ✅ 算子复用:0 新算子,0 新后端依赖
  9. ✅ 前端 LMS 路由可在浏览器访问 http://127.0.0.1:5173/lms,登录后看到课程列表 + 选课 + scene 渲染

算子复用矩阵(与 chg_0010 / 0011 对比)

chg 新算子 后端依赖 前端新组件
chg_0009 sp1_more_operators 10 0 0
chg_0010 federated_risk_control 0 0 0(仅 e2e)
chg_0011 vehicle_cloud_compliance 0 0 0(仅 e2e)
chg_0012 lms_multiscene_v2 0 0(markdown 自实现) 4 组件(SlideScene/QuizScene/SimScene/PBLScene)+ 3 视图

唯一与 chg_0010 的关联:SimScene 嵌入 chg_0010 FRC e2e 跑通页面(chg_0010 提供 URL,chg_0012 iframe 嵌入),其他完全独立。

关键不变量

  • LMS 数据隔离:学员只能看自己已选课的 scenes(enrollment 校验,未选课返回 403)
  • 进度不可降级:scene 完成 = progress_scene_ids append-only(不删除已完成的 scene)
  • PBL 占位一致性:spec 含 type=pbl,render 端点返 501,前后端文案一致
  • FRC 模板复用:模板生成的 6 scene 必须与 chg_0010 S1-S6 一一对应(scene_id = frc-s{i}-sim-{description}),便于 iframe URL 拼接

风险与回退

  • 风险 1:chg_0006 LMS 模块代码缺失(workspace + sandbox 均无),需 T1 验证 chg_0006 archive 中的代码是否在原 file 即可恢复,若不能则 chg_0012 包含完整 LMS v1 重建(已计入 Scope)。
  • 风险 2:iframe 嵌入 chg_0010 e2e 跑通页面需该页面在 dev server 可用且不被鉴权拦截——T2 实施时确认 chg_0010 提供的是 static URL(不需 JWT)还是带 token URL。
  • 回退:若 FRC 模板生成失败(chg_0010 接口变更),chg_0012 仅交付 LMS v1 + slide/quiz scene + iframe 占位(scene.embed_url),不阻断主流程。