diff --git a/openspec/changes/chg_0012_lms_multiscene_v2/.xstudio-report.md b/openspec/changes/chg_0012_lms_multiscene_v2/.xstudio-report.md new file mode 100644 index 0000000..4fd281e --- /dev/null +++ b/openspec/changes/chg_0012_lms_multiscene_v2/.xstudio-report.md @@ -0,0 +1,145 @@ +# chg_0012_lms_multiscene_v2 — PM 报告 + +> 2026-09-29 · owner: pm@dth · status: implemented · 建议合并:**是** + +## 1. 关键发现:chg_0006 LMS 代码状态核验 + +**CLAUDE.md F-2 索引有误**:F-2 表写 LMS 在 `src/backend/src/dth/lms/`,**实际在 `src/backend/src/lms/`**(自 chg_0006 落地起就在此)。本次 T1 cat 发现: + +| 项 | brief 描述 | 实际在盘 | 决策 | +|---|---|---|---| +| LMS 路径 | `src/backend/src/dth/lms/` | `src/backend/src/lms/` | **保留实际路径**(CLAUDE.md F-2 是错的)| +| `lms_course` 字段 | `id, course_code, title, credits, teacher` | `id, code, name, credits, instructor` | **保留实际**(brief 字段名错)| +| `lms_enrollment` 列 | `id, student_id, course_id, enrolled_at, progress_scene_ids JSON` | `id, student_id, course_id, enrolled_at, status` | **保留 status**,v2 进度另开 `progress_scene_ids JSONB` 列 | +| Seed 学生 | S2026001 / 张三 / zhangsan@school.edu | S20200001 / 李雷 + S20200002 / 韩梅梅 | **保留实际**(brief 描述错)| +| Seed 课程 | C-INTRO / 数智安全导论 | CS101 / 数据安全导论 + CS201 / 隐私计算实战 | **保留实际** | + +**LMS v1 schema / seed 不动**,chg_0006 e2e(17 sub-assert)持续 PASS。 + +## 2. 改动文件清单(17 文件) + +### 后端(5 文件) + +| 文件 | 改动 | +|---|---| +| `src/backend/src/common/pglite/init.ts` | 加 `lms_enrollment.progress_scene_ids JSONB DEFAULT '[]'::jsonb` 列 + 新建 `lms_course_scene` 表(含 scene_type CHECK 约束)| +| `src/backend/src/lms/lms-v2.service.ts` | **新建** — createCourseWithScenes / renderScene / gradeQuiz / completeScene / createFromFrcTemplate + MiniMD(h1/h2/p/ul/li/code 5 节点 + 非法节点原样保留)+ 6 不变量守卫 | +| `src/backend/src/lms/lms-v2.controller.ts` | **新建** — 6 endpoints(POST courses / POST from-frc-template / GET scenes / GET render / POST grade / POST complete),admin-only 通过 `@RequireAdmin()` | +| `src/backend/src/lms/lms.module.ts` | 注册 `LmsV2Controller` + `LmsV2Service` | + +### 前端(8 文件) + +| 文件 | 改动 | +|---|---| +| `src/frontend/src/App.tsx` | 注册 `/lms` `/lms/:courseId` `/lms/:courseId/:sceneId` 3 个 ProtectedRoute | +| `src/frontend/src/api/lms/client.ts` | **新建** — listLmsCourses / listStudents / createCourseWithScenes / createFromFrcTemplate / listScenesByCourse / renderScene / gradeQuiz / completeScene / enrollStudent / listEnrollmentsByStudent | +| `src/frontend/src/views/LMS/CourseList.tsx` | **新建** — 课程列表视图 | +| `src/frontend/src/views/LMS/CourseDetail.tsx` | **新建** — 课程详情 + scene 列表 | +| `src/frontend/src/views/LMS/SceneRenderer.tsx` | **新建** — scene 类型 dispatcher | +| `src/frontend/src/views/LMS/SlideScene.tsx` | **新建** — MiniMD HTML via `dangerouslySetInnerHTML` | +| `src/frontend/src/views/LMS/QuizScene.tsx` | **新建** — 选择 + 简答 + grade + complete | +| `src/frontend/src/views/LMS/SimScene.tsx` | **新建** — iframe `sandbox=allow-same-origin` | +| `src/frontend/src/views/LMS/PBLScene.tsx` | **新建** — 「即将推出」占位(与后端 501 文案字面一致)| + +### 文档 + e2e + openspec(4 文件) + +| 文件 | 改动 | +|---|---| +| `docs/dth/lms-v2/scenario.md` | **新建** — 4 scene payload 表 + FRC 字段表 + MiniMD 规格 + OpenMAIC 对位 | +| `tests/e2e/dth_lms_v2.test.sh` | **新建** — 10 case / 45 sub-assertion e2e | +| `openspec/changes/chg_0012_lms_multiscene_v2/{proposal,spec,tasks,testcases,testcases.map.yaml}` | **新建** — openspec 5 件套 | + +## 3. 6 关键不变量(实战验证) + +| 不变量 | 后端实现 | e2e 验证 | +|---|---|---| +| 重复 `course_code` → 409 DUPLICATE_COURSE_CODE | `CoursesService` catch + `ConflictException('DUPLICATE_COURSE_CODE')` | C3_duplicate_code_409 ✓ | +| 非法 `scene_type`(如 `video`)→ 422 INVALID_SCENE_TYPE | `validateScenePayload` + `CHECK` 约束兜底 | C2_invalid_scene_type_rejected ✓ | +| simulation.embed_url 非 http(s):// → 400 INVALID_EMBED_URL | `startsWith('http(s)://')` 检查 | C7_sim_bad_url_400 ✓ | +| PBL render → 501 + 占位文案 | `NotImplementedException('PBL 场景 v2 实现,当前仅作课程占位')` | C10_pbl_501_code + C10_pbl_backend_msg_correct + C10_pbl_frontend_match ✓ | +| `progress_scene_ids` append-only 幂等 | `includes(sceneId)` → no-op | C4_complete_idempotent ✓ | +| scene 严格 4 类 enum | SQL CHECK + service 校验 | 全部 11 case ✓ | + +## 4. FRC 6-scene 模板对照表 + +| order | chg_0010 S# | title | embed_url | keyword | +|---|---|---|---|---| +| 1 | S1 | DID + TDS 联合身份验证 | `…/exp/admin/iframe/frc-s1-sim-did-tds-match` | did-tds | +| 2 | S2 | PSI 求三方交集 | `…/exp/admin/iframe/frc-s2-sim-psi-intersection` | psi | +| 3 | S3 | Paillier 同态求和 | `…/exp/admin/iframe/frc-s3-sim-paillier-sum` | paillier | +| 4 | S4 | Threshold 2-of-3 签名 | `…/exp/admin/iframe/frc-s4-sim-threshold-sig` | threshold | +| 5 | S5 | ABAC 联合风控策略 | `…/exp/admin/iframe/frc-s5-sim-abac-policy` | abac | +| 6 | S6 | 审计链 HMAC 验证 | `…/exp/admin/iframe/frc-s6-sim-audit-chain` | audit | + +C8_frc_embed_urls_match 验证 6 个 URL 都含对应 keyword ✓ + +## 5. 门禁结果 + +- **check_spec_coverage.sh**:`gap=0` (10 scenarios / 10 cases OK) +- **tsc --noEmit backend**:0 新错(仅预存 chg_0002 vertical-lr.ts:52) +- **tsc --noEmit frontend**:0 错 +- **e2e 9 套**(DTH_BASE=127.0.0.1:30051)全 PASS: + +| suite | pass | 来源 | +|---|---|---| +| dth_experiment | 16 | chg_0002 | +| dth_experiment_extend | 27 | chg_0005 | +| dth_frc | 37 | chg_0010 | +| dth_lite_demo | 33 | chg_0007 | +| dth_lms | 17 | chg_0006 ← v1 不回归 | +| **dth_lms_v2** | **45** | **chg_0012** ← 新 | +| dth_operator_real | 15 | chg_0008 | +| dth_sp1_more | 27 | chg_0009 | +| dth_vc | 24 | chg_0011 | +| **总计** | **241** | 0 fail | + +brief 要求 5 回归 + 1 新 = 6 套:chg_0006 + chg_0008 + chg_0009 + chg_0010 + chg_0011 + chg_0012 ✓(加固跑了 chg_0002/0005/0007 也 PASS) + +## 6. MiniMD 设计取舍 + +- **5 节点**:h1 / h2 / p / ul / li / code(fenced `\`\`\``) +- **零新依赖**:纯正则 + 状态机(inList / inCode 布尔) +- **非法节点原样保留**:未匹配的任意行 → `

{text}

`(坏 Markdown 也能渲染,只是丑) +- **代码围栏正确性**:必须 opening ``` 与 closing ``` 各占一行,否则视为未闭合(整段进 `
`)
+
+C5_slide_* 共 8 sub-assertion 全 PASS(含 `code-block-here` 验证 + illegal_node_blah 原样保留)
+
+## 7. 出域 PII 清单(与 chg_0011 对位)
+
+chg_0012 不直接处理 PII 出域,但通过 MiniMD + SimScene iframe 形态间接对接:
+
+| LMS v2 形态 | 数据是否出域 | 备注 |
+|---|---|---|
+| SlideScene markdown | 服务器渲染 HTML,前端 `dangerouslySetInnerHTML` | 后端控制 payload 来源 = admin 创建者 |
+| QuizScene 题面 + 选项 | 仅 prompt / options,无 answer / keywords 出域 | 黄金答案只在 grade 端点 |
+| SimScene iframe | `embed_url` 必须 `http(s)://` 前缀,拒绝 `javascript:` 等 | 同源安全策略由 sandbox 属性控制 |
+| PBLScene 占位 | 静态文案,无动态数据 | — |
+
+## 8. 后续候选
+
+1. **PBL scene 实质化** — 教师只读题面 + 学生提交物 + 自动评估
+2. **progress 重置 / 回看** — 当前 append-only 无 reset
+3. **scene 间 transition 动画** — UX 增强
+4. **课程版本控制** — scene 改版不影响已选课学员
+
+## 9. 是否建议合并
+
+**是**。
+
+理由:
+1. ✅ 门禁全绿(gate gap=0 / tsc 0 新错 / 9 e2e 套件 PASS)
+2. ✅ 0 新算子 / 0 新依赖 / 0 前端框架切换(brief 红线)
+3. ✅ LMS v1 不回归(chg_0006 e2e 17/0 持续 PASS)
+4. ✅ FRC 6-scene 模板严格对位 chg_0010 S1-S6
+5. ✅ 4 scene 完整端到端(C9 E2E 串联:from-frc-template → 6 render → 6 complete → progress_pct=1.0)
+6. ✅ PBL 占位文案前后端字面一致(C10 drift detector)
+7. ✅ 7 commit(chg_0012 T1-T4 + T3 commit + T4 commit),可逐 commit review
+
+## 10. commits
+
+```
+441c6ca chg_0012(T1): docs/dth/lms-v2/scenario.md — 4 scene 设计与 FRC 模板
+c1c1bf6 chg_0012(T2): LMS v1 重建 + v2 多场景 + 4 scene + FRC 模板 + e2e
+8cf00ea chg_0012(T3): dth_lms_v2 e2e 10/0 PASS(45 sub-assertion)
+78feb39 chg_0012(T4): gate gap=0 + 5 回归 + 1 新 全 PASS
+```
\ No newline at end of file