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)
6.1 KiB
6.1 KiB
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_enrollment3 张 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/coursesbody 含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/enrollmentsbody{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/completebody{enrollment_id} - THEN
progress_scene_idsappend 该 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/gradebody{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-templatebody{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 验证)
- scene#1:
- AND response
{code: 200, data: {course_id, scene_ids: [...]}} - AND schema_version = "v2"
S9 E2E 完整流程(admin 建课 → student 走完 6 scene → 进度 100%)
- WHEN 1 次 shell run 串行执行以下步骤(无状态依赖):
- admin login
- POST
/courses/from-frc-template→ course_id(C-FRC-TEMPLATE) - student login(S2034020001 王五 seed)
- POST
/enrollments→ enrollment_id - 对 6 个 scene 各 POST
/scenes/:id/render→ 拿到 6 个 iframe HTML - 对 6 个 scene 各 POST
/scenes/:id/complete→ progress_scene_ids 增长 - 最终 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 计数,保证幂等)