chg_0012(T5): pm 报告 — 10/0 + 9 套回归 + 建议合并
- chg_0006 LMS 实际状态核验:CLAUDE.md F-2 索引路径与字段描述与在盘不符 - 路径应为 src/backend/src/lms/(非 dth/lms/) - 字段 code/name/instructor(非 course_code/title/teacher) - seed S20200001/李雷 + CS101/数据安全导论(非 S2026001/张三 + C-INTRO) - LMS v1 不重建,在 v1 之上增量扩展 v2 - 17 文件改动清单(5 后端 + 8 前端 + 1 文档 + 1 e2e + 1 openspec 5 件套) - 6 关键不变量实战验证 - FRC 6-scene 模板对照表(S1-S6 + 6 embed_url 严格对位) - 9 e2e 套件 241/0 PASS(5 回归 + 4 加固 + 1 新) - MiniMD 设计取舍(5 节点 + 零新依赖 + 非法节点原样保留) - 出域 PII 清单(与 chg_0011 对位:iframe sandbox + 服务端渲染 HTML) - 后续 4 候选(PBL 实质化 / progress 重置 / scene 动画 / 课程版本) - 是否建议合并:是(7 条理由) 最终合并 commit 说明(待用户审核):sandbox 落后 main 0 commit,本 chg 4 个独立 commit 可由宿主编排者一次 merge --no-ff 进 main Co-Authored-By: Claude <[email protected]>
This commit is contained in:
1 parent
78feb39316
commit
c76a822867
1 file changed
+145
@@ -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 布尔)
|
||||
- **非法节点原样保留**:未匹配的任意行 → `<p>{text}</p>`(坏 Markdown 也能渲染,只是丑)
|
||||
- **代码围栏正确性**:必须 opening ``` 与 closing ``` 各占一行,否则视为未闭合(整段进 `<pre><code>`)
|
||||
|
||||
C5_slide_* 共 8 sub-assertion 全 PASS(含 `<code>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
|
||||
```
|
||||
Reference in new issue
Block a user