Files
dth/openspec/changes/chg_0012_lms_multiscene_v2/spec.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

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 计数,保证幂等)