Files
dth/openspec/changes/chg_0012_lms_multiscene_v2/testcases.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.0 KiB
Raw Blame History

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 "

    Title

    " + "

    Sub

    " + "
    • item 1
    • item 2
    "
  • And: scene_type = "slide"
  • And: schema_version = "v2"
  • And: markdown 含非法节点 → 原样保留在 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一致)