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)
This commit is contained in:
xstudio agent committed 2026-09-29 14:22:26 +08:00
1 parent 98c49a75b5
commit 4a6c044105
5 files changed
+507

No files matched your search

@@ -0,0 +1,91 @@
---
change_id: chg_0012
status: draft
owner: pm@dth
stakeholders: [pd, dev, qa]
priority: P1
target_release: v0.6
created: 2026-09-29
skip_coverage: false
requires_human_validation: 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),不阻断主流程。
@@ -0,0 +1,110 @@
# Spec: lms
## Requirement
THE SYSTEM SHALL provide a multi-scene LMS v2 that lets an admin author courses composed of
typed scenes (`slide | quiz | simulation | pbl`), lets a student enroll and walk through scenes
with progress tracking, and reuses the existing 19 operators + chg_0010 FRC scenarios as the
`simulation` scene content source via iframe embed, WITHOUT introducing any new operator / new
backend dependency / new frontend framework, so that 业务方能把「课程数据 / 单元测验 / 算子场景
演练」统一在 LMS 一个子系统里管理.
## ADDED Scenarios
### S1 LMS v1 数据模型重建(chg_0006 缺失补回)
- **WHEN** backend starts and `lms_student / lms_course / lms_enrollment` 3 张 PGlite 表不存在
- **THEN** backend 自动建表(与 chg_0006 schema 完全一致:`lms_student(id, student_no, name,
email) / lms_course(id, course_code, title, credits, teacher) / lms_enrollment(id, student_id,
course_id, enrolled_at)`)
- **AND** 启动时 seed 1 个示例学生 S2026001 / 张三 + 1 个示例课程 C-INTRO / 数智安全导论
- **AND** schema_version = "v1"
- **AND** `GET /api/ssw/dth/lms/students` 返回 [S2026001 张三],`GET /api/ssw/dth/lms/courses` 返回 [C-INTRO 数智安全导论]
### S2 多场景课程数据模型
- **WHEN** 1 张新表 `lms_course_scene` 被加入
- **THEN** schema 包含字段 `(id, course_id FK, scene_type enum[slide|quiz|simulation|pbl],
payload_json TEXT, order_index INT, created_at TIMESTAMP)`
- **AND** schema_version = "v2"
- **AND** `scene_type` 接受 4 个枚举值(slide / quiz / simulation / pbl);非法值(如 `video`)
在 PBlite 入库前 reject 422
### S3 创建多场景课程(admin)
- **WHEN** admin POST `/api/ssw/dth/lms/courses` body 含 `course_code + title + credits +
teacher + scenes[]`(每个 scene 含 `scene_type + payload + order_index`)
- **THEN** response `{code: 200, data: {course_id: <uuid>, scene_ids: [<uuid>...]}}`
- **AND** courses 表写入 1 行,scenes 表写入 N 行(scene_type 按入参一一对应)
- **AND** scenes 按 order_index 升序返回
- **AND** 同一 course_code 二次 POST 返回 409 DUPLICATE_COURSE_CODE
- **AND** schema_version = "v2"
### S4 学生选课 + 进度跟踪
- **WHEN** student POST `/api/ssw/dth/lms/enrollments` body `{student_id, course_id}`
- **THEN** `lms_enrollment` 表写入 1 行(带初始 `progress_scene_ids = []` + `enrolled_at`)
- **AND** response `{code: 200, data: {enrollment_id, course_id, student_id,
progress_scene_ids: []}}`
- **AND** 同一 student × course 重复 enroll 返回 409 ALREADY_ENROLLED(不创建重复行)
- **WHEN** student POST `/api/ssw/dth/lms/scenes/:sceneId/complete` body `{enrollment_id}`
- **THEN** `progress_scene_ids` append 该 sceneId(去重幂等)
- **AND** response 返 `{progress_scene_ids: [...], progress_pct: <float 0~1>}`
- **AND** schema_version = "v2"
### S5 SlideScene 渲染(Markdown → HTML)
- **WHEN** GET `/api/ssw/dth/lms/courses/:id/scenes/:sceneId/render` 且 scene_type = `slide`
- **THEN** payload_json 含 `{markdown: "# 标题\n## 副标题\n- 点 1\n- 点 2"}` → 后端用自实现的
MiniMD 转换器(h1/h2/p/ul/li/code 5 类节点,零依赖)→ 响应 `{rendered_html: "<h1>标题</h1>...",
scene_type: "slide"}`
- **AND** schema_version = "v2"
- **AND** 未支持节点(如 markdown 里的 `<table>`)原样保留(不报错也不渲染)
### S6 QuizScene 答题 + 自动判分
- **WHEN** scene_type = `quiz` + payload_json 含 `{question: "Q?", options: ["A","B","C","D"],
answer: "A"}`(选择题)或 `{question: "Q?", keywords: ["k1","k2"]}`(简答)
- **THEN** POST `/api/ssw/dth/lms/scenes/:sceneId/grade` body `{student_answer: "A"}` →
选择题 response `{score: 1.0, correct: true, expected: "A"}`;body `{student_answer: "I think
the answer involves k1 and k2"}` → 简答 response `{score: 1.0, matched: ["k1","k2"]}`
(关键词命中 ≥ 50% 即满分)
- **AND** schema_version = "v2"
- **AND** student_answer 缺失 → 400 MISSING_ANSWER
### S7 SimScene 嵌入 chg_0010 FRC iframe
- **WHEN** scene_type = `simulation` + payload_json 含 `{embed_url: "http://127.0.0.1:3000/api/ssw/dth/lms/.../frc-s1-sim-tds-match",
description: "TDS 合约匹配"}`
- **THEN** GET render 端点响应 `{rendered_html: "<iframe src=\"<embed_url>\" ...></iframe>",
scene_type: "simulation"}`
- **AND** embed_url 含 http(s):// 前缀 + 合法路径;非法 URL 返回 400 INVALID_EMBED_URL
- **AND** schema_version = "v2"
### S8 FRC 6-scene 模板自动生成
- **WHEN** admin POST `/api/ssw/dth/lms/courses/from-frc-template` body `{course_code, teacher}`
- **THEN** 后端生成 1 个 course + 6 个 scene,全部 scene_type = `simulation`,order_index 1-6
- **AND** 6 scene 的 payload.embed_url 严格对应 chg_0010 S1-S6:
- scene#1: `frc-s1-sim-did-tds-match`(描述:DID + TDS 联合身份验证)
- scene#2: `frc-s2-sim-psi-intersection`(描述:PSI 求三方交集)
- scene#3: `frc-s3-sim-paillier-sum`(描述:Paillier 同态求和)
- scene#4: `frc-s4-sim-threshold-sig`(描述:Threshold 2-of-3 签名)
- scene#5: `frc-s5-sim-abac-policy`(描述:ABAC 联合风控策略)
- scene#6: `frc-s6-sim-audit-chain`(描述:审计链 HMAC 验证)
- **AND** response `{code: 200, data: {course_id, scene_ids: [...]}}`
- **AND** schema_version = "v2"
### S9 E2E 完整流程(admin 建课 → student 走完 6 scene → 进度 100%)
- **WHEN** 1 次 shell run 串行执行以下步骤(无状态依赖):
1. admin login
2. POST `/courses/from-frc-template` → course_id(C-FRC-TEMPLATE)
3. student login(S2034020001 王五 seed)
4. POST `/enrollments` → enrollment_id
5. 对 6 个 scene 各 POST `/scenes/:id/render` → 拿到 6 个 iframe HTML
6. 对 6 个 scene 各 POST `/scenes/:id/complete` → progress_scene_ids 增长
7. 最终 GET `/enrollments/:id` → progress_pct = 1.0(6/6)
- **THEN** 所有步骤 PASS,e2e 输出 `pass=10 fail=0`(10 main cases)
- **AND** 总耗时 < 60s
- **AND** 进度数据从 enrollment 行读出(不连 lms_course_scene 计数,保证幂等)
@@ -0,0 +1,106 @@
# Tasks (DAG)
- id: T1
type: architect
depends_on: []
output: docs/dth/lms-v2/scenario.md
verification:
- 数据模型图(lms_student / lms_course / lms_enrollment / lms_course_scene 4 表 + FK)
- scene type 4 类枚举定义 + payload schema
- Markdown → HTML MiniMD 转换器 5 节点规格(h1/h2/p/ul/li/code)
- FRC 6-scene 模板字段表(embed_url 命名规则)
- **chg_0006 LMS 模块代码状态确认**:T1 必须先查 `src/backend/src/dth/lms/` 是否存在,
若缺失则 chg_0012 包含完整 LMS v1 重建(已在 proposal Scope 兜底)
- 前端 4 组件 + 3 视图路由设计
- id: T2
type: implementer
depends_on: [T1]
output: |
src/backend/src/dth/lms/ 重建(缺失补回):
- entities/{student,course,enrollment}.entity.ts
- lms.controller.ts(students/courses/enrollments CRUD)
- lms-v2.controller.ts(scenes / frc-template / grade / complete / render)
- lms.service.ts(含 MiniMD 转换器)
- lms-v2.service.ts(scenes + FRC 模板生成)
- lms.module.ts(注册 controllers + services + entities)
src/frontend/src/views/LMS/:
- CourseList.tsx / CourseDetail.tsx / SceneRenderer.tsx
- SlideScene.tsx / QuizScene.tsx / SimScene.tsx / PBLScene.tsx
- routes 注册 /lms 路径
tests/e2e/dth_lms_v2.test.sh(10 case e2e 脚本)
verification:
- 后端 LMS 3 子系统恢复(GET /students 返回 chg_0006 seed)
- lms_course_scene 表自动建(schema v2)
- admin POST /courses 含 scenes → 7 字段响应(course_id + scene_ids[])
- MiniMD 转换器仅依赖 stdlib(无 marked / markdown-it)
- 4 scene 组件 props 类型与 backend payload 严格对齐
- PBLScene 渲染「即将推出」占位 + 后端 501 一致
- 复用既有 helpers(json_get / pre_admin_login / assert),不重写
- 脚本无 `set -e`,每条 assertion 独立 fail 计数
- DTH_BASE=${DTH_BASE:-http://127.0.0.1:30000}
- id: T3
type: tester
depends_on: [T2]
output: |
1 次完整 e2e 跑通(bash tests/e2e/dth_lms_v2.test.sh 10/0)
verification:
- pass=10 fail=0
- 含 S1 数据重建(seed 可见)
- 含 S2 多场景 schema(scene_type 枚举校验)
- 含 S3 创建多场景课程(含 6 scene)
- 含 S4 选课 + 进度 append-only
- 含 S5 Markdown → HTML 5 节点 + 非法节点保留
- 含 S6 Quiz 选择 + 简答 关键词 50% 命中
- 含 S7 SimScene iframe + embed_url 校验
- 含 S8 FRC 6-scene 模板(embed_url 一一对应 chg_0010 S1-S6)
- 含 S9 E2E 完整流程(progress_pct = 1.0)
- 进度不可降级(重复 complete sceneId 不变长)
- 非法 scene_type 入参 422
- 非法 embed_url 400
- 重复 enroll 409
- 重复 course_code 409
- id: T4
type: qa
depends_on: [T3]
output: |
PROJECT_ROOT=. bash openspec/scripts/check_spec_coverage.sh
4 e2e 套件全跑(chg_0008/0009/0010/0011/0012 = 5 套)
verification:
- gate gap = 0
- tsc --noEmit 0 新错(除预存 chg_0002 vertical-lr.ts:52)
- 4 回归 + 1 新 = 5 套 e2e 全 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
- 总断言数 ≥ 89(79 旧 + 10 新 = 89)
- 报告落 /tmp/chg_0012-qa.log
- id: T5
type: pm
depends_on: [T4]
output: |
openspec/changes/chg_0012_lms_multiscene_v2/.xstudio-report.md
chg_0012 实施说明(取舍 + chg_0006 重建说明 + FRC 模板复用 + 后续 chg_0013 候选)
verification:
- 报告含 改动文件清单 + 门禁结果 + LMS v1 重建证据 + FRC 模板截图(S8 embed_url
对照表) + 是否建议合并
- chg_0006 LMS 代码缺失的发现 + chg_0012 处理方式
- 报告大小 ≥ 35 行
- chg_0012 任务全部完成
# Notes
- 无 backend 新依赖(MiniMD 自实现,pglite 已在 chg_0001 装齐)
- 无 frontend 新框架(React + Vite + axios + react-router-dom,已在 chg_0004 装齐)
- 测试端口 30000(与既有 e2e 一致;DTH_BASE env 可覆盖)
- 提交顺序建议:T1 (docs + data model) → T2 (backend LMS v1 重建 + scenes + test) → T3 (test PASS)
→ T4 (gate + regressions) → T5 (report)
- 与 chg_0010/0011 的边界:仅 reuse chg_0010 S1-S6 名称作为 FRC 模板 embed_url 标识;
不动 OperatorsService / ExperimentModule 注册,不依赖 chg_0010/0011 e2e 跑通页可用性
(embed_url 仅作为字符串断言,不真去 GET iframe 内容)
- chg_0006 LMS 模块代码缺失(T1 必须显式确认):
- 若 workspace + sandbox 均无 → chg_0012 T2 包含完整重建(已计入 Scope)
- 若 workspace 有 sandbox 无 → 从 workspace 复制到 sandbox 后启动
- 重建的代码与 chg_0006 archive 中的 entities 一致(仅恢复,不重新设计)
@@ -0,0 +1,62 @@
# spec: lms@chg_0012
scenarios:
- id: S1
cases: [C1_lms_v1_data_model_basics]
- id: S2
cases: [C2_multiscene_data_model_v2, C10_pbl_placeholder_consistent_501]
- id: S3
cases: [C3_create_multiscene_course]
- id: S4
cases: [C4_enroll_and_progress_append_only]
- id: S5
cases: [C5_slide_scene_markdown_render]
- id: S6
cases: [C6_quiz_scene_grading_choice_and_short]
- id: S7
cases: [C7_sim_scene_iframe_embed]
- id: S8
cases: [C8_frc_6_scene_template_auto]
- id: S9
cases: [C9_e2e_full_flow_walkthrough]
gate:
blocking_gap_tolerance: 0
implementation_files:
- src/backend/src/dth/lms/
- src/frontend/src/views/LMS/
- docs/dth/lms-v2/scenario.md
test_files:
- tests/e2e/dth_lms_v2.test.sh
notes:
reuses_operators_no_new_code: false
new_module_count: 1
new_frontend_components: 4
operator_coverage: "0 of 19 existing operators used (LMS 子系统自含,不依赖实验台算子)"
operators_used: []
chg_0010_dependency:
relationship: "loose"
usage: "FRC 模板的 embed_url 命名严格对应 chg_0010 S1-S6(字符串断言,不真去 GET iframe)"
runtime_blocking: false
chg_0006_dependency:
relationship: "compile + restore"
issue: "chg_0006 LMS 模块代码 workspace + sandbox 双缺失(CLAUDE.md F-2 列出但文件不在)"
resolution: "T1 必须先验证,T2 包含完整 LMS v1 重建(已在 proposal Scope 兜底)"
invariant_assertions: 4
- C4 enrollment progress append-only (幂等)
- C5 MiniMD 非法节点保留 (不渲染不报错)
- C6 Quiz 关键词 50% 命中 = 满分 (宽松判分)
- C10 PBL 501 与前端 PBLScene 文案一致 (占位一致性)
privacy_invariant: "C9 progress_pct 从 enrollment.progress_scene_ids 计算(不连 lms_course_scene 计数,幂等)"
pbl_v1_scope: "spec 含 type=pbl,render 端点返 501,前后端文案一致;PBLScene UI 显示「即将推出」"
complements_chg_0010: false
complementary_operators_vs_chg_0010: "无(chg_0012 独立 LMS 改造)"
frc_template_reuse: "POST /courses/from-frc-template → 6 个 simulation scene,对应 chg_0010 S1-S6"
no_new_dependency: true
new_frontend_components:
- SlideScene (Markdown → HTML,MiniMD 后端转换 + dangerouslySetInnerHTML 渲染)
- QuizScene (选择/简答,自动判分)
- SimScene (iframe,sandbox=allow-same-origin)
- PBLScene (v1 占位「即将推出」)
new_frontend_views:
- CourseList (课程列表 + 选课按钮)
- CourseDetail (课程详情 + scene 列表 + 进度条)
- SceneRenderer (4 scene 渲染分发)
@@ -0,0 +1,138 @@
### C1_lms_v1_data_model_basics
- Scenario: S1
- Type: e2e
- Priority: P0
- Given: backend restarted on 30000, pglite fresh init
- When: GET /api/ssw/dth/lms/students + /courses (no auth for read-only list per chg_0006)
- Then: response includes seed student S2026001 / 张三 + seed course C-INTRO / 数智安全导论
- And: schema_version = "v1"
- And: lms_student row count = 1, lms_course row count = 1, lms_enrollment row count = 0
- Automated: true
- Bound Task: T2
### C2_multiscene_data_model_v2
- Scenario: S2
- Type: e2e
- Priority: P0
- Given: backend running, lms_course_scene table exists
- When: query \`SELECT column_name, data_type FROM information_schema.columns WHERE table_name='lms_course_scene'\`
- Then: columns include id (uuid), course_id (uuid FK), scene_type (enum text), order_index (int), payload_json (text), created_at (timestamp)
- And: scene_type column has CHECK constraint accepting 4 values: slide, quiz, simulation, pbl
- And: schema_version = "v2"
- Automated: true
- Bound Task: T2
### C3_create_multiscene_course
- Scenario: S3
- Type: e2e
- Priority: P0
- Given: admin token, fresh course_code C-MULTI-001
- When: POST /api/ssw/dth/lms/courses with body {course_code, title, credits: 3, teacher, scenes: [{scene_type: slide, payload: {markdown: "# A"}, order_index: 1}, {scene_type: quiz, payload: {question: "Q?", options: ["A","B"], answer: "A"}, order_index: 2}]}
- Then: response code=200, data.course_id = uuid, data.scene_ids.length = 2
- And: lms_course row 1 inserted; lms_course_scene row 2 inserted (ordered by order_index 1, 2)
- And: 重复 POST 同一 course_code → 409 DUPLICATE_COURSE_CODE
- And: schema_version = "v2"
- Automated: true
- Bound Task: T2
### C4_enroll_and_progress_append_only
- Scenario: S4
- Type: e2e
- Priority: P0
- Given: student S2034020001 王五 (chg_0012 seed) + course C-MULTI-001 from C3
- When: POST /api/ssw/dth/lms/enrollments body {student_id, course_id}
- Then: response code=200, enrollment_id present, progress_scene_ids = []
- And: 重复 enroll 同一 student × course → 409 ALREADY_ENROLLED
- When: POST /api/ssw/dth/lms/scenes/:sceneId/complete body {enrollment_id} × 2 不同 sceneId
- Then: 第 1 次 response progress_scene_ids.length=1, 第 2 次 length=2, progress_pct = 2/2 = 1.0
- And: 重 complete 第 1 个 sceneId → progress_scene_ids.length 仍为 2(幂等 append-only)
- And: schema_version = "v2"
- Automated: true
- Bound Task: T2
### C5_slide_scene_markdown_render
- Scenario: S5
- Type: e2e
- Priority: P0
- Given: scene_id (type=slide) with payload.markdown = "# Title\n## Sub\n- item 1\n- item 2"
- When: GET /api/ssw/dth/lms/courses/:id/scenes/:sceneId/render
- Then: response data.rendered_html contains "<h1>Title</h1>" + "<h2>Sub</h2>" + "<ul><li>item 1</li><li>item 2</li></ul>"
- And: scene_type = "slide"
- And: schema_version = "v2"
- And: markdown 含非法节点 <table> → 原样保留在 rendered_html(MiniMiniMD 不报错)
- Automated: true
- Bound Task: T2
### C6_quiz_scene_grading_choice_and_short
- Scenario: S6
- Type: e2e
- Priority: P0
- Given: 2 quiz scene:scene_a (choice: answer=A), scene_b (short: keywords=[k1,k2])
- When: POST /api/ssw/dth/lms/scenes/scene_a/grade body {student_answer: "A"}
- Then: response data.score = 1.0, data.correct = true, data.expected = "A"
- When: POST /api/ssw/dth/lms/scenes/scene_a/grade body {student_answer: "B"}
- Then: response data.score = 0.0, data.correct = false
- When: POST /api/ssw/dth/lms/scenes/scene_b/grade body {student_answer: "involves k1 and k2"}
- Then: response data.score = 1.0, data.matched = ["k1","k2"] (2/2 keywords hit)
- When: body {student_answer: "k1 only"} → score = 0.5 (1/2 hit)
- And: 缺失 student_answer → 400 MISSING_ANSWER
- And: schema_version = "v2"
- Automated: true
- Bound Task: T2
### C7_sim_scene_iframe_embed
- Scenario: S7
- Type: e2e
- Priority: P0
- Given: scene (type=simulation) with payload.embed_url = "http://127.0.0.1:3000/api/ssw/dth/lms/courses/.../frc-s1-sim-tds-match"
- When: GET render
- Then: response data.rendered_html contains "<iframe" + payload.embed_url + sandbox="allow-same-origin"
- And: scene_type = "simulation"
- And: 非法 URL (无 http:// 前缀) → 400 INVALID_EMBED_URL
- And: schema_version = "v2"
- Automated: true
- Bound Task: T2
### C8_frc_6_scene_template_auto
- Scenario: S8
- Type: e2e
- Priority: P0
- Given: admin token, fresh course_code C-FRC-T-001
- When: POST /api/ssw/dth/lms/courses/from-frc-template body {course_code, teacher}
- Then: response code=200, data.course_id = uuid, data.scene_ids.length = 6
- And: 6 scene.scene_type = "simulation" (全部)
- And: 6 scene.order_index = 1,2,3,4,5,6
- And: 6 scene.payload.description 严格匹配 chg_0010 S1-S6:
- s1: "DID + TDS 联合身份验证"
- s2: "PSI 求三方交集"
- s3: "Paillier 同态求和"
- s4: "Threshold 2-of-3 签名"
- s5: "ABAC 联合风控策略"
- s6: "审计链 HMAC 验证"
- And: 6 scene.payload.embed_url 含子串 frc-s{i}-sim-{slug}(i=1..6)
- And: schema_version = "v2"
- Automated: true
- Bound Task: T2
### C9_e2e_full_flow_walkthrough
- Scenario: S9
- Type: e2e
- Priority: P0
- Given: backend + LMS v2 + chg_0010 服务可用(embed_url 仅作字符串断言,不真去 GET iframe)
- When: 1 shell run 顺序执行:admin login → POST from-frc-template (C-FRC-T-002) → student login → POST enrollments → 6 次 render → 6 次 complete → GET enrollments/:id
- Then: pass=10 fail=0(含 C1-C9 + sub-assertion)
- And: progress_pct = 1.0(6/6 scene completed)
- And: 总耗时 < 60s
- Automated: true
- Bound Task: T3 (E2E orchestration test)
### C10_pbl_placeholder_consistent_501
- Scenario: S2 (multi-scene schema) + Scene render consistency
- Type: e2e
- Priority: P1
- Given: scene (type=pbl) with minimal payload
- When: GET render
- Then: response code=501, msg = "NOT_IMPLEMENTED: PBL 场景 v2 实现,当前仅作课程占位"
- And: 前端 PBLScene 组件显示「即将推出」文案(与后端 501 文案一致)
- Automated: true
- Bound Task: T2 (PBL placeholder backend + frontend一致)