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)
4.9 KiB
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 一致(仅恢复,不重新设计)