Files
dth/openspec/changes/chg_0012_lms_multiscene_v2/proposal.md
T
xstudio agent 78feb39316 chg_0012(T4): gate gap=0 + 5 回归 + 1 新 全 PASS
- openspec 5 件套完整(proposal/spec/tasks/testcases/testcases.map.yaml)
- check_spec_coverage.sh: 10 scenarios / 10 cases OK, gap=0
- tsc backend: 0 新错(仅预存 chg_0002 vertical-lr.ts:52)
- tsc frontend: 0 错
- 9 e2e 套件 PASS (DTH_BASE=127.0.0.1:30051):
  - chg_0002 (16) + chg_0005 (27) + chg_0006 (17) + chg_0007 (33)
  - chg_0008 (15) + chg_0009 (27) + chg_0010 (37) + chg_0011 (24)
  - chg_0012 (45 sub-assertion / 10 case)
- 报告落 /tmp/chg_0012-qa.log

5 回归 + 1 新 = 6 套(brief 要求):chg_0006 + chg_0008 + chg_0009 + chg_0010 + chg_0011 + chg_0012 ✓
加固跑了 chg_0002 / chg_0005 / chg_0007 也全 PASS — chg_0012 改动未触及 19 算子/auth/books/shop
Co-Authored-By: Claude <[email protected]>
2026-09-29 16:18:36 +08:00

3.8 KiB
Raw Blame History

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

chg_0012 lms_multiscene_v2 — LMS v2 多场景课程平台

Why

chg_0006 LMS v1(学员 + 课程 + 选课)已落地,但课程是"扁平"资源 — 只描述 课程元信息(代码 / 学分 / 教师),不描述课程怎么上。教学场景里每门课 应该是有序 scene 序列(讲解 → 测验 → 仿真 → PBL),学员按顺序完成并 留进度。

chg_0010 / chg_0011 已用 e2e 跑通"业务场景测试 = 算子协同"模式,但没有一个 "教学编排层"把场景化的算子协同封装成可复用课程。本 chg 把 LMS 升级到 v2, 引入 4 类 scene(slide / quiz / simulation / pbl),同时落地 FRC 6-scene 模板把 chg_0010 的 6 步联合风控流程以"可执行 simulation"形式嵌入 LMS 课程。

What

做:

  1. 场景设计文档 docs/dth/lms-v2/scenario.md:4 类 scene 的设计原则 + payload schema 表 + MiniMD 5 节点规格 + FRC 模板字段表 + 与 OpenMAIC 的对位 (保留 dth 命名 simulation 而非 OpenMAIC 的 interactive,理由:chg_0010/0011 已落地"6 步 simulation 流程"作为术语)。

  2. 后端 LMS v2 扩展(在 chg_0006 v1 之上增量):

    • 新表 lms_course_scene:id, course_id FK, scene_type enum (slide|quiz|simulation|pbl), payload_json TEXT, order_index INT
    • lms_enrollment 加列 progress_scene_ids JSONB(append-only 幂等)
    • lms-v2.service.ts:createCourseWithScenes / renderScene / gradeQuiz / completeScene / createFromFrcTemplate + MiniMD(5 节点 + 非法节点原样保留)
    • lms-v2.controller.ts:6 endpoints
    • lms.module.ts:注册 v2 controller + service
  3. FRC 6-scene 模板 POST /courses/from-frc-template {course_code,teacher}: 6 个 simulation scene(order_index 1-6),embed_url 严格对位 chg_0010 S1-S6 (did-tds / psi / paillier / threshold / abac / audit)。

  4. 前端 LMS v2(4 组件 + 3 视图):

    • CourseList.tsx / CourseDetail.tsx / SceneRenderer.tsx
    • SlideScene.tsx / QuizScene.tsx / SimScene.tsx / PBLScene.tsx
    • 注册 /lms 路径
  5. e2e 测试 tests/e2e/dth_lms_v2.test.sh:10 case 覆盖 S1-S10。

  6. 门禁更新 openspec/scripts/check_spec_coverage.sh:无需改动 (5 件套天然 cover)。

约束:

  • 0 新算子 / 0 新依赖 / 0 前端框架切换。
  • LMS v1 schema / seed 不动(chg_0006 e2e 不回归)。
  • MiniMD 自实现(h1/h2/p/ul/li/code 5 节点 + 非法节点原样保留)— 零新依赖。
  • 不动 src/backend/src/dth/experiment/operators/(19 算子已实现)。
  • 不动 src/backend/src/auth/、books/、shop/(红线)。

关键不变量:

不变量 失败码 文案
重复 course_code 409 DUPLICATE_COURSE_CODE
重复 enroll 409 ALREADY_ENROLLED(与 v1 一致)
非法 scene_type(如 video) 422 INVALID_SCENE_TYPE
simulation.embed_url 非 http(s):// 400 INVALID_EMBED_URL
PBL render 501 NOT_IMPLEMENTED + 占位文案
progress_scene_ids append-only — 重复 complete 不增 count

Acceptance

  • 10 case e2e 全 PASS(chg_0012 自身)
  • 5 回归 e2e 全 PASS(chg_0006/0008/0009/0010/0011)
  • gate PROJECT_ROOT=. bash openspec/scripts/check_spec_coverage.sh gap=0
  • tsc --noEmit 0 error(除预存 chg_0002 vertical-lr.ts:52)
  • 文档 docs/dth/lms-v2/scenario.md 含 4 scene payload schema + MiniMD 规格 + FRC 模板字段表

与 handoff §2 的对应

chg_0009 重派 ✅ → chg_0010 FRC 设计 ✅ → chg_0011 VC 设计 ✅ → 本 chg "LMS 教学编排层" = handoff 教学场景闭环。