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)
6.1 KiB
6.1 KiB
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 |
|
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_typeenum(slide|quiz|simulation|pbl) +payload_json+order_index - 进度跟踪:
lms_enrollment.progress_scene_ids[]JSON 字段 - 渲染端点:
GET /api/ssw/dth/lms/courses/:id/scenes/:sceneId/render→ 渲染后 HTMLPOST /api/ssw/dth/lms/scenes/:sceneId/grade→ 提交答题,返回判分结果
- FRC 模板端点:
POST /api/ssw/dth/lms/courses/from-frc-template→ 自动生成 chg_0010 FRC 6-scene sim course
- LMS v1 重建(chg_0006 缺失补回):3 张 PGlite 表
- 前端:
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
- ✅
check_spec_coverage.shgap=0(chg_0012 自含 10 scenarios / 10 cases / 5 tasks) - ✅
tsc --noEmit0 新错(除预存 chg_0002 vertical-lr.ts:52) - ✅
bash tests/e2e/dth_lms_v2.test.shpass=10 fail=0(耗时 < 60s) - ✅ 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
- ✅ LMS 3 子系统恢复可见:
GET /api/ssw/dth/lms/students返回 chg_0006 seed 数据 - ✅ 多场景课程端到端:admin POST 1 个含 6 scene(slide+quiz+simulation+pbl)的课程 → student 选课 → 走完 6 scene → progress 100%
- ✅ FRC 6-scene 模板:
POST /api/ssw/dth/lms/courses/from-frc-template返回 course 含 6 个 simulation scene,每个 scene 对应 chg_0010 S1-S6 - ✅ 算子复用:0 新算子,0 新后端依赖
- ✅ 前端 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),不阻断主流程。