chore(archive): chg_0010/0011/0012 入库 + CLAUDE.md F-2 修正 LMS 路径
- chg_0010 federated_risk_control → archive/2026-10-02-... - chg_0011 vehicle_cloud_compliance → archive/2026-10-02-... - chg_0012 lms_multiscene_v2 → archive/2026-10-02-... - CLAUDE.md F-2 修正:LMS 实际路径 src/backend/src/lms/(旧条目写 dth/lms/ 错) - F-2 加 chg_0012 LMS v2 视图(CourseList/CourseDetail/SceneRenderer + 4 Scene) - 已落 chg 索引:12 归档 + 0 提案(chg_0010/0011/0012 三行带 merge commit + e2e 数) - 关键文档加 frc/vc/lms-v2 三份 scenario.md 引用 Co-Authored-By: Claude Code <[email protected]>
This commit is contained in:
1 parent
415a017dec
commit
3056bf4e32
18 files changed
+18
-6
No files matched your search
@@ -0,0 +1,74 @@
|
||||
---
|
||||
change_id: chg_0010
|
||||
status: proposed
|
||||
owner: pm@team
|
||||
stakeholders: [pd, tm, qa, dev]
|
||||
priority: P1
|
||||
target_release: v0.6
|
||||
created: 2026-09-28
|
||||
skip_coverage: false
|
||||
---
|
||||
|
||||
# chg_0010 federated_risk_control — 3 银行联合反欺诈场景
|
||||
|
||||
## Why
|
||||
|
||||
chg_0009 已落地 10 个真算法算子(paillier-he / threshold-sig / psi / did-identity / tds-connector /
|
||||
data-masking / data-watermark / abac-policy / model-watermark / mpc-beaver),但缺少**真实业务场景**
|
||||
把它们组合起来跑通。
|
||||
|
||||
需求 §5(数智安全人才平台 design doc line 212)要求"业务场景测试:模拟 N 机构联合数据流通场景
|
||||
(金融联合风控 / 医疗联合诊断 / 车云数据合规),证明算子在真实多方流程下能协同工作"。
|
||||
|
||||
金融联合风控是三个候选中**算子覆盖率最高**的场景(直接命中 8/10 chg_0009 算子 + 1 chg_0008 算子),
|
||||
也是 SP-1 实验台最典型的"多方数据不出域"用例。
|
||||
|
||||
**约束**:
|
||||
- 不改 backend 代码(10 算子已齐备,0 新依赖,0 新接口)
|
||||
- 不加前端(场景测试目标是 backend e2e 协同,不是 UI)
|
||||
- 复用 chg_0006 LMS 的多实体建模思路:用 admin token + per-bank 标签模拟 3 银行(避免改 auth)
|
||||
|
||||
## Scope
|
||||
|
||||
**做**:
|
||||
|
||||
1. **场景设计文档** `docs/dth/frc/scenario.md`:定义 FRC 场景的 6 步流程图 + 数据流图
|
||||
+ 不变性约束 + 与既有算子的映射表。
|
||||
|
||||
2. **集成 e2e 测试** `tests/e2e/dth_frc.test.sh`:12 case 串起 8 个算子,覆盖:
|
||||
- S1: 3 银行 DID 建立 + TDS 合约 hash 匹配(did-identity + tds-connector)
|
||||
- S2: DID 验证循环 + 篡改检测(did-identity)
|
||||
- S3: TDS 合约 hash 不匹配 → 流程拒绝(tds-connector)
|
||||
- S4: PSI 黑名单交集正确(psi:仅输出共享欺诈 ID,不泄露非交集)
|
||||
- S5: PSI 不泄露非交集(psi:交集元素计数 ≤ min(各银行黑名单大小))
|
||||
- S6: Paillier 跨行特征求和不变性(paillier-he:Enc(bankA)·Enc(bankB)·Enc(bankC) = Enc(sum))
|
||||
- S7: Threshold 2-of-3 风险签名重构(threshold-sig:2 share → verify_code=0)
|
||||
- S8: Threshold 1 share 签名失败(threshold-sig:1 share → verify_code≠0)
|
||||
- S9: ABAC 风险分析师通过 + 游客拒绝(abac-policy)
|
||||
- S10: 数据水印嵌入提取 roundtrip(data-watermark:聚合报告含零宽水印)
|
||||
- S11: 审计链 HMAC 完整(compliance-audit:完整 8 步流程链 chainValid=true)
|
||||
- S12: E2E 端到端(依次跑 S1→S11 全程,每步 invariant 通过)
|
||||
|
||||
3. **门禁更新** `openspec/scripts/check_spec_coverage.sh`:无需改动(5 件套天然 cover)。
|
||||
5. **端口**:仍 30000(DTH_BASE 默认;不冲突 LMS / SP-1 实验台)。
|
||||
|
||||
**不做**:
|
||||
|
||||
- ❌ 新建 FRC 专属 endpoint(直接复用 `POST /experiment/runs` 一个一个跑算子)
|
||||
- ❌ 新加前端(backend-only e2e)
|
||||
- ❌ 新加 operator(10 算子全够用)
|
||||
- ❌ 新加依赖(纯 shell + python3 + jq,已在 chg_0002 启用)
|
||||
- ❌ 改 abac / auth(admin token 全程够用,per-bank 标签在 input 里传)
|
||||
|
||||
## Acceptance
|
||||
|
||||
- 12 case e2e 全 PASS(chg_0010 自身)
|
||||
- 5 回归 e2e 全 PASS(chg_0002/0005/0006/0007/0008/0009)
|
||||
- gate `PROJECT_ROOT=. bash openspec/scripts/check_spec_coverage.sh` gap=0
|
||||
- `tsc --noEmit` 0 error(除预存 chg_0002 vertical-lr.ts:52)
|
||||
- 文档 `docs/dth/frc/scenario.md` 包含:流程图(mermaid)+ 数据流 + 算子映射表 + 不变性清单
|
||||
|
||||
## 与 handoff §2 的对应
|
||||
|
||||
handoff §2 优先级 2 = "chg_0010 真实业务场景测试设计" → 本 chg 闭环。
|
||||
本 chg 完成 = handoff §2 全部三条都关闭(1️⃣chg_0009 重派 ✅ 2️⃣chg_0010 设计 ✅ 3️⃣框架文档化待办)。
|
||||
@@ -0,0 +1,100 @@
|
||||
# Spec: experiment_platform
|
||||
|
||||
## Requirement
|
||||
|
||||
THE SYSTEM SHALL provide a multi-bank federated risk control (FRC) scenario that composes
|
||||
8 existing operators (did-identity / tds-connector / psi / paillier-he / threshold-sig /
|
||||
abac-policy / data-watermark / compliance-audit) into a 6-step end-to-end fraud detection
|
||||
flow across 3 simulated banks (BankA / BankB / BankC), proving that **multi-party, no-PII-leak,
|
||||
audit-traceable** risk decisions can be made WITHOUT any new operator / endpoint / dependency,
|
||||
so that 业务方能用现有算子验证"数据不出域"的多方金融场景。
|
||||
|
||||
## ADDED Scenarios
|
||||
|
||||
### S1 3 银行 DID 建立 + TDS 合约匹配
|
||||
|
||||
- **WHEN** BankA / BankB / BankC each call did-identity.create() with their private keys
|
||||
- **THEN** output 3 distinct DIDs (`did:frc:bankA/...`, `did:frc:bankB/...`, `did:frc:bankC/...`)
|
||||
- **AND** tds-connector.match() with matching `contract_hash` returns `{match: true, token: <3-part JWT>}`
|
||||
- **AND** output `schema_version === "v2"`
|
||||
|
||||
### S2 DID 验证循环 + 篡改检测
|
||||
|
||||
- **WHEN** each of the 3 DIDs from S1 is verified with did-identity.verify()
|
||||
- **THEN** all 3 return `{valid: true}`
|
||||
- **AND** if any DID document is tampered (e.g., swap `publicKey`), verify() returns `{valid: false}`
|
||||
|
||||
### S3 TDS 合约 hash 不匹配 → 流程拒绝
|
||||
|
||||
- **WHEN** tds-connector.match() is called with `contract_hash_a === contract_hash_b`
|
||||
- **THEN** output `{match: false, error: "contract-mismatch"}`
|
||||
- **AND** the FRC flow is aborted at step 1 (no PSI / aggregation runs)
|
||||
|
||||
### S4 PSI 黑名单交集正确
|
||||
|
||||
- **WHEN** 3 banks submit private blacklists:
|
||||
- BankA = `[f01, f02, f03, f04]`
|
||||
- BankB = `[f01, f02, f03, f05]`
|
||||
- BankC = `[f01, f02, f03, f06, f07]`
|
||||
- **THEN** PSI intersection output = `[f01, f02, f03]` (sorted, no duplicates, no extras)
|
||||
- **AND** output `intersection_size === 3`
|
||||
- **AND** schema_version = "v2"
|
||||
|
||||
### S5 PSI 不泄露非交集(隐私不变性)
|
||||
|
||||
- **WHEN** S4 PSI is run
|
||||
- **THEN** the output NEVER contains elements outside `[f01, f02, f03]`
|
||||
- **AND** the output size is **at most** `min(len(A), len(B), len(C))` (here min=3)
|
||||
- **AND** no per-bank blacklist sizes are revealed in the output (`{intersection: [...], intersection_size: N}` only)
|
||||
|
||||
### S6 Paillier 跨行特征求和不变性
|
||||
|
||||
- **WHEN** 3 banks submit encrypted average-risk features:
|
||||
- BankA: Enc(100)
|
||||
- BankB: Enc(200)
|
||||
- BankC: Enc(300)
|
||||
- **THEN** `sumProduct = Enc(100) · Enc(200) · Enc(300) mod n² === Enc(600)`
|
||||
- **AND** Decrypt(Enc(600)) === 600 (mod n)
|
||||
- **AND** schema_version = "v2"
|
||||
|
||||
### S7 Threshold 2-of-3 风险签名重构
|
||||
|
||||
- **WHEN** the aggregator (TDS) computes a risk decision and requests 3 banks to sign via threshold-sig
|
||||
- **THEN** with **2 of 3 shares** (any 2 banks), Lagrange interpolation reconstructs the secret
|
||||
- **AND** verify_code === 0 (signature valid)
|
||||
- **AND** output `recovered === original_payload`
|
||||
|
||||
### S8 Threshold 1 share 签名失败
|
||||
|
||||
- **WHEN** only **1 share** is provided to threshold-sig.reconstruct()
|
||||
- **THEN** verify_code !== 0 (signature fails — needs ≥ 2 shares)
|
||||
- **AND** error code reflects "insufficient-shares"
|
||||
|
||||
### S9 ABAC 风险分析师通过 + 游客拒绝
|
||||
|
||||
- **WHEN** an ABAC policy requires `subject.role === "risk-analyst"` AND `subject.region in ["BJ","SH","GZ"]` AND `env.timewindow 09:00-18:00`
|
||||
- **THEN** request from `{role: "risk-analyst", region: "BJ", time: "10:00"}` returns `{allow: true}`
|
||||
- **AND** request from `{role: "guest", region: "BJ", time: "10:00"}` returns `{allow: false, reason: "role-deny"}`
|
||||
- **AND** request from `{role: "risk-analyst", region: "NY", time: "10:00"}` returns `{allow: false, reason: "region-deny"}`
|
||||
- **AND** request from `{role: "risk-analyst", region: "BJ", time: "20:00"}` returns `{allow: false, reason: "timewindow-deny"}`
|
||||
|
||||
### S10 数据水印嵌入提取 roundtrip
|
||||
|
||||
- **WHEN** the aggregator embeds `payload = "FRC|2026-09-28|bankA,bankB,bankC"` into a report via data-watermark
|
||||
- **THEN** the report's visible length is unchanged (zero-width chars)
|
||||
- **AND** data-watermark.extract(report) recovers the **exact** payload string
|
||||
- **AND** schema_version = "v2"
|
||||
|
||||
### S11 审计链 HMAC 完整
|
||||
|
||||
- **WHEN** the full FRC flow runs through steps S1→S10 (or as many as allowed by input)
|
||||
- **THEN** compliance-audit chain contains ≥ 8 entries (one per FRC step)
|
||||
- **AND** each entry has HMAC-SHA256 chain linkage (`prev_hash` references the prior entry)
|
||||
- **AND** chainValid === true on full replay
|
||||
|
||||
### S12 E2E 端到端 8 步不变性
|
||||
|
||||
- **WHEN** a single shell run executes S1→S11 in order with the canonical 3-bank input fixture
|
||||
- **THEN** every intermediate assertion in S1..S11 passes
|
||||
- **AND** the final output reports `e2e dth_frc: pass=N fail=0` (N = total sub-assertions, expected 12+)
|
||||
- **AND** total wall-clock time for the e2e is < 60s (operators are local Python/TS, no external I/O)
|
||||
@@ -0,0 +1,71 @@
|
||||
# Tasks (DAG)
|
||||
|
||||
- id: T1
|
||||
type: architect
|
||||
depends_on: []
|
||||
output: docs/dth/frc/scenario.md
|
||||
verification:
|
||||
- 文档含 mermaid 流程图(6 步 + 8 算子映射)
|
||||
- 数据流表(每步:输入 → 算子 → 输出 → 不变性)
|
||||
- 算子映射表(每算子:何时被调用 / 输入 schema / 输出 schema)
|
||||
- 不变性清单(S1-S12 → 对应算子 + 测试断言)
|
||||
- 复用矩阵(既有 10 算子的复用率 ≥ 80%)
|
||||
|
||||
- id: T2
|
||||
type: implementer
|
||||
depends_on: [T1]
|
||||
output: |
|
||||
tests/e2e/dth_frc.test.sh (12 case e2e shell 脚本)
|
||||
verification:
|
||||
- 脚本无 set -e(每条 assertion 独立计数)
|
||||
- 使用 DTH_BASE=${DTH_BASE:-http://127.0.0.1:30000}
|
||||
- 每条 assert 用 python3 json_get (与 chg_0008/0009 一致)
|
||||
- 包含 admin token login (pre_admin_login)
|
||||
- 12 case 覆盖 S1..S12
|
||||
- 总耗时 < 60s
|
||||
- 复用既有 helpers(不要重写 json_get / assert / login)
|
||||
|
||||
- id: T3
|
||||
type: tester
|
||||
depends_on: [T2]
|
||||
output: |
|
||||
1 次完整 e2e 跑通(bash tests/e2e/dth_frc.test.sh 12/0)
|
||||
verification:
|
||||
- pass=12 fail=0
|
||||
- 含 4+ 不变性断言(PSI 交集正确 / PSI 不泄露 / Paillier sum / 水印 roundtrip)
|
||||
- 含 1 篡改检测(did-identity 篡改 verify 失败)
|
||||
- 含 1 拒绝路径(TDS mismatch → 流程拒绝)
|
||||
- 含 1 跨银行 E2E 串联(S12 = S1→S11 一气呵成)
|
||||
|
||||
- id: T4
|
||||
type: qa
|
||||
depends_on: [T3]
|
||||
output: |
|
||||
PROJECT_ROOT=. bash openspec/scripts/check_spec_coverage.sh
|
||||
6 e2e 套件全跑(chg_0002/0005/0006/0007/0008/0009/0010 = 7 套)
|
||||
verification:
|
||||
- gate gap = 0
|
||||
- tsc --noEmit 0 error(除预存 chg_0002 vertical-lr.ts:52)
|
||||
- 5 回归 + 1 新 = 6 e2e 套件全 PASS
|
||||
- 总断言数 ≥ 144(135 旧 + 12 新 = 147)
|
||||
- 报告落 /tmp/chg_0010-qa.log
|
||||
|
||||
- id: T5
|
||||
type: pm
|
||||
depends_on: [T4]
|
||||
output: |
|
||||
openspec/changes/chg_0010_federated_risk_control/.xstudio-report.md
|
||||
chg_0010 实施说明(取舍 + 与 chg_0009 复用率 + 后续 chg_0011 候选)
|
||||
verification:
|
||||
- 报告含 改动文件清单 + 门禁结果 + 算子复用率 + 是否建议合并
|
||||
- 报告大小 ≥ 30 行
|
||||
- chg_0010 任务全部完成
|
||||
|
||||
# Notes
|
||||
|
||||
- 无 backend 代码改动(10 算子已齐备)
|
||||
- 无 frontend 代码改动(业务场景 e2e only)
|
||||
- 无新依赖
|
||||
- 测试端口 30000(与既有 e2e 一致;DTH_BASE env 可覆盖)
|
||||
- 提交顺序建议:T1 (docs) → T2 (test script) → T3 (test PASS) → T4 (gate + regressions) → T5 (report)
|
||||
- 与 chg_0009 的边界:不动 OperatorsService / ExperimentModule 注册(10 算子已注册),仅新增 test 脚本
|
||||
+50
@@ -0,0 +1,50 @@
|
||||
# spec: experiment_platform@chg_0010
|
||||
scenarios:
|
||||
- id: S1
|
||||
cases: [C1_3bank_did_setup_tds_match]
|
||||
- id: S2
|
||||
cases: [C2_did_verify_loop_tamper_detect]
|
||||
- id: S3
|
||||
cases: [C3_tds_mismatch_abort]
|
||||
- id: S4
|
||||
cases: [C4_psi_intersection_correct]
|
||||
- id: S5
|
||||
cases: [C5_psi_no_leak_non_intersection]
|
||||
- id: S6
|
||||
cases: [C6_paillier_cross_bank_sum_invariant]
|
||||
- id: S7
|
||||
cases: [C7_threshold_sig_2shares_reconstruct]
|
||||
- id: S8
|
||||
cases: [C8_threshold_sig_1share_fails]
|
||||
- id: S9
|
||||
cases: [C9_abac_policy_decision_matrix]
|
||||
- id: S10
|
||||
cases: [C10_data_watermark_roundtrip]
|
||||
- id: S11
|
||||
cases: [C11_audit_chain_hmac_valid]
|
||||
- id: S12
|
||||
cases: [C12_e2e_full_flow_8_steps]
|
||||
gate:
|
||||
blocking_gap_tolerance: 0
|
||||
implementation_files:
|
||||
- tests/e2e/dth_frc.test.sh
|
||||
- docs/dth/frc/scenario.md
|
||||
test_files:
|
||||
- tests/e2e/dth_frc.test.sh
|
||||
notes:
|
||||
reuses_operators_no_new_code: true
|
||||
operator_coverage: "8 of 10 chg_0009 operators + 1 chg_0008 operator"
|
||||
operators_used:
|
||||
- did-identity (S1, S2)
|
||||
- tds-connector (S1, S3)
|
||||
- psi (S4, S5)
|
||||
- paillier-he (S6)
|
||||
- threshold-sig (S7, S8)
|
||||
- abac-policy (S9)
|
||||
- data-watermark (S10)
|
||||
- compliance-audit (S11)
|
||||
invariant_assertions: 4
|
||||
- C4 psi_intersection_correct (正确性)
|
||||
- C5 psi_no_leak_non_intersection (隐私)
|
||||
- C6 paillier_homomorphic_sum (密码学)
|
||||
- C10 watermark_roundtrip (可恢复性)
|
||||
@@ -0,0 +1,139 @@
|
||||
### C1_3bank_did_setup_tds_match
|
||||
- Scenario: S1
|
||||
- Type: e2e
|
||||
- Priority: P0
|
||||
- Given: backend running on 30000, admin token, 3 bank private keys
|
||||
- When: POST /experiment/runs × 3 with operator=did-identity (per-bank), then POST with operator=tds-connector (matching contract_hash)
|
||||
- Then: 3 DIDs created + tds match=true + token non-empty (3-part JWT)
|
||||
- And: schema_version=v2
|
||||
- Automated: true
|
||||
- Bound Task: T2
|
||||
|
||||
### C2_did_verify_loop_tamper_detect
|
||||
- Scenario: S2
|
||||
- Type: e2e
|
||||
- Priority: P0
|
||||
- Given: 3 DIDs from C1
|
||||
- When: verify each DID, then mutate one DID's publicKey and re-verify
|
||||
- Then: original 3 verify returns valid=true; mutated DID verify returns valid=false
|
||||
- Automated: true
|
||||
- Bound Task: T2
|
||||
|
||||
### C3_tds_mismatch_abort
|
||||
- Scenario: S3
|
||||
- Type: e2e
|
||||
- Priority: P1
|
||||
- Given: contract_hash_a ≠ contract_hash_b
|
||||
- When: POST /experiment/runs with operator=tds-connector
|
||||
- Then: response.match=false, error="contract-mismatch"
|
||||
- And: FRC flow aborts (no PSI / aggregation steps executed)
|
||||
- Automated: true
|
||||
- Bound Task: T2
|
||||
|
||||
### C4_psi_intersection_correct
|
||||
- Scenario: S4
|
||||
- Type: e2e
|
||||
- Priority: P0
|
||||
- Given: 3 blacklists A=[f01,f02,f03,f04] / B=[f01,f02,f03,f05] / C=[f01,f02,f03,f06,f07]
|
||||
- When: POST /experiment/runs with operator=psi
|
||||
- Then: response.intersection=[f01,f02,f03] (sorted, deduped)
|
||||
- And: intersection_size=3
|
||||
- And: schema_version=v2
|
||||
- Automated: true
|
||||
- Bound Task: T2
|
||||
|
||||
### C5_psi_no_leak_non_intersection
|
||||
- Scenario: S5
|
||||
- Type: e2e
|
||||
- Priority: P0 (privacy invariant)
|
||||
- Given: blacklists from C4
|
||||
- When: inspect full PSI response (all keys + values)
|
||||
- Then: output NEVER contains f04/f05/f06/f07 (non-intersection)
|
||||
- And: output size ≤ min(4,3,4)=3
|
||||
- And: no per-bank blacklist size or membership info in output
|
||||
- Automated: true
|
||||
- Bound Task: T2
|
||||
|
||||
### C6_paillier_cross_bank_sum_invariant
|
||||
- Scenario: S6
|
||||
- Type: e2e
|
||||
- Priority: P0
|
||||
- Given: paillier public key, 3 features (100/200/300)
|
||||
- When: POST /experiment/runs with operator=paillier-he, input={action: "homomorphic_sum", values: [100,200,300]}
|
||||
- Then: decrypted sum === 600 (mod n)
|
||||
- And: homomorphic_invariant passes (Enc(a)·Enc(b) mod n² === Enc(a+b))
|
||||
- And: schema_version=v2
|
||||
- Automated: true
|
||||
- Bound Task: T2
|
||||
|
||||
### C7_threshold_sig_2shares_reconstruct
|
||||
- Scenario: S7
|
||||
- Type: e2e
|
||||
- Priority: P0
|
||||
- Given: 3-of-3 Shamir shares, payload
|
||||
- When: POST /experiment/runs with operator=threshold-sig, input={shares: [s1,s2,s3], threshold: 2}
|
||||
- Then: 2-share Lagrange reconstruction recovers secret
|
||||
- And: verify_code=0 (signature valid)
|
||||
- And: recovered payload === original payload
|
||||
- Automated: true
|
||||
- Bound Task: T2
|
||||
|
||||
### C8_threshold_sig_1share_fails
|
||||
- Scenario: S8
|
||||
- Type: e2e
|
||||
- Priority: P1
|
||||
- Given: 3 shares from C7
|
||||
- When: POST with shares=[s1] only
|
||||
- Then: verify_code≠0
|
||||
- And: error code="insufficient-shares" or equivalent
|
||||
- Automated: true
|
||||
- Bound Task: T2
|
||||
|
||||
### C9_abac_policy_decision_matrix
|
||||
- Scenario: S9
|
||||
- Type: e2e
|
||||
- Priority: P0
|
||||
- Given: abac policy requiring role=risk-analyst AND region∈[BJ,SH,GZ] AND time∈[09:00,18:00]
|
||||
- When: 4 POSTs with combinations (allow / 3× deny)
|
||||
- Then: allow for {role:risk-analyst,region:BJ,time:10:00}
|
||||
- And: deny "role-deny" for {role:guest}
|
||||
- And: deny "region-deny" for {region:NY}
|
||||
- And: deny "timewindow-deny" for {time:20:00}
|
||||
- Automated: true
|
||||
- Bound Task: T2
|
||||
|
||||
### C10_data_watermark_roundtrip
|
||||
- Scenario: S10
|
||||
- Type: e2e
|
||||
- Priority: P0
|
||||
- Given: report text, watermark payload="FRC|2026-09-28|bankA,bankB,bankC"
|
||||
- When: POST with operator=data-watermark (embed), then POST same text (extract)
|
||||
- Then: report length unchanged after embed (zero-width chars)
|
||||
- And: extract returns exact payload string
|
||||
- And: schema_version=v2
|
||||
- Automated: true
|
||||
- Bound Task: T2
|
||||
|
||||
### C11_audit_chain_hmac_valid
|
||||
- Scenario: S11
|
||||
- Type: e2e
|
||||
- Priority: P1
|
||||
- Given: 8 FRC step entries (S1-S10 condensed: did×3 / tds / psi / paillier / threshold / abac / watermark = ~9 audit entries)
|
||||
- When: POST with operator=compliance-audit, action=verify_chain
|
||||
- Then: chain length ≥ 8
|
||||
- And: each entry has prev_hash link
|
||||
- And: chainValid=true
|
||||
- Automated: true
|
||||
- Bound Task: T2
|
||||
|
||||
### C12_e2e_full_flow_8_steps
|
||||
- Scenario: S12
|
||||
- Type: e2e
|
||||
- Priority: P0
|
||||
- Given: canonical 3-bank fixture (BankA/BankC blacklists + features + shares + ABAC subject + report)
|
||||
- When: 1 shell run executes all 11 steps in sequence (C1-C11 in order)
|
||||
- Then: pass=12 fail=0 (12 main cases)
|
||||
- And: total wall-clock < 60s
|
||||
- And: no operator-not-found or 500 errors in any substep
|
||||
- Automated: true
|
||||
- Bound Task: T3 (E2E orchestration test)
|
||||
+125
@@ -0,0 +1,125 @@
|
||||
# chg_0011 vehicle_cloud_compliance — 完成报告
|
||||
|
||||
> 2026-09-29 · owner: pm@team · status: **建议合并**
|
||||
|
||||
## 改动文件清单
|
||||
|
||||
| 文件 | 行数 | 一句话 |
|
||||
|---|---:|---|
|
||||
| `openspec/changes/chg_0011_vehicle_cloud_compliance/proposal.md` | 95 | 业务动因(数据出域可追溯)+ 6 算子映射 + 出域 PII 清单 |
|
||||
| `openspec/changes/chg_0011_vehicle_cloud_compliance/spec.md` | 82 | 10 scenario WHEN/THEN |
|
||||
| `openspec/changes/chg_0011_vehicle_cloud_compliance/tasks.md` | 72 | DAG(T0-T5) |
|
||||
| `openspec/changes/chg_0011_vehicle_cloud_compliance/testcases.md` | 121 | 10 case + 4 不变性 + 1 拒绝路径 + 1 跨车 E2E |
|
||||
| `openspec/changes/chg_0011_vehicle_cloud_compliance/testcases.map.yaml` | 57 | spec ↔ case 绑定 + 算子复用矩阵 + chg_0010 互补对照表 |
|
||||
| `docs/dth/vc/scenario.md` | 197+ | 6 步 mermaid + 6 算子映射 + 9 不变性 + 出域 PII 清单 + 复用矩阵 |
|
||||
| `tests/e2e/dth_vc.test.sh` | 392 | 10 case 端到端(C1~C10 = S1~S10),24 assertion |
|
||||
|
||||
## 门禁结果(T4)
|
||||
|
||||
| 门禁 | 结果 |
|
||||
|---|---|
|
||||
| `PROJECT_ROOT=. bash openspec/scripts/check_spec_coverage.sh` | **gap = 0** ✅ |
|
||||
| `cd src/backend && npx tsc --noEmit` | **0 新错**(仅 chg_0002 vertical-lr.ts:52 预存 TS2352)✅ |
|
||||
| `bash tests/e2e/dth_vc.test.sh` | **pass=24 fail=0**(10 case × 24 assertion),耗时 26s ✅ |
|
||||
| 7 回归 + 1 新 = 8 套 e2e 同 backend 实例 | **全 196/0** ✅ |
|
||||
|
||||
### 8 套 e2e 成绩
|
||||
|
||||
| 套件 | case | pass | fail | 来源 |
|
||||
|---|---:|---:|---:|---|
|
||||
| dth_experiment | 16 | 16 | 0 | chg_0002 |
|
||||
| dth_experiment_extend | 27 | 27 | 0 | chg_0005 |
|
||||
| dth_lms | 17 | 17 | 0 | chg_0006 |
|
||||
| dth_lite_demo | 33 | 33 | 0 | chg_0007 |
|
||||
| dth_operator_real | 15 | 15 | 0 | chg_0008 |
|
||||
| dth_sp1_more | 27 | 27 | 0 | chg_0009 |
|
||||
| dth_frc | 37 | 37 | 0 | chg_0010 |
|
||||
| **dth_vc** | 24 | 24 | 0 | **chg_0011** |
|
||||
| **总计** | **196** | **196** | **0** | — |
|
||||
|
||||
## 算子复用矩阵(chg_0011 → 既有 19 算子)
|
||||
|
||||
| 算子 | 来源 chg | VC 复用 | 步骤 |
|
||||
|---|---|:---:|---|
|
||||
| `tds-connector` | chg_0009 | ✅ | S1 / S2(match + abort 路径) |
|
||||
| `data-masking` | chg_0009 | ✅ | S3 / S4(150 次字段级调用) |
|
||||
| `data-watermark` | chg_0009 | ✅ | S5 / S6(embed + extract + 长度不变) |
|
||||
| `horizontal-fedavg` | **chg_0008** | ✅ | S7(fleet 50 client 聚合) |
|
||||
| `abac-policy` | chg_0009 | ✅ | S8(1 allow + role-deny + ip-deny) |
|
||||
| `compliance-audit` | **chg_0008** | ✅ | S9(6 entry HMAC chain + verify) |
|
||||
| `did-identity` | chg_0009 | ❌ | FRC 独占 |
|
||||
| `psi` / `paillier-he` / `threshold-sig` | chg_0009 | ❌ | FRC 独占(多方不出域场景) |
|
||||
| `mpc-beaver` / `model-watermark` / `data-masking` 等 | chg_0008/0009 | ❌ | VC 不需要 |
|
||||
|
||||
**复用率**:
|
||||
- 6/19 = **32%** 算子被 chg_0011 使用
|
||||
- **互补算子**(chg_0011 独占):data-masking / horizontal-fedavg
|
||||
- **共有算子**(与 chg_0010 共享):tds-connector / data-watermark / abac-policy / compliance-audit
|
||||
|
||||
## 出域 PII 清单(核心约束)
|
||||
|
||||
| 字段 | 类别 | 是否出域 | 出域形态 |
|
||||
|---|---|:---:|---|
|
||||
| GPS 经纬度 | PII | ❌ | data-masking `phone` 字段类型 |
|
||||
| 车牌号 | PII | ❌ | data-masking 自定义字段感知保留前后 |
|
||||
| 车主 ID(身份证)| PII | ❌ | data-masking `id_card` 字段类型(前 6 后 4) |
|
||||
| 邮箱 | PII | ❌ | data-masking `email` 字段类型(前 2 + 域名) |
|
||||
| 故障码 / 电池电压 / 里程 | 业务 | ✅ | 明文上云 |
|
||||
|
||||
**业务验证**:C3 跑 50 车 × 3 PII 字段 = 150 次 data-masking,**0 次 PII 泄漏**(断言:原始 PII 字符串不在 masked output 出现)。
|
||||
|
||||
## chg_0010 ↔ chg_0011 互补对照
|
||||
|
||||
| 维度 | chg_0010 金融联合风控 | chg_0011 车云数据合规 |
|
||||
|---|---|---|
|
||||
| 数据流向 | 不出域(多方计算) | **出域可追溯** |
|
||||
| 隐私保护 | PSI / Paillier / Threshold Sig | **水印 + 审计链** |
|
||||
| 算子覆盖率 | 8/19 = 42% | **6/19 = 32%** |
|
||||
| 独占算子 | psi / paillier-he / threshold-sig / did-identity | **data-masking / horizontal-fedavg** |
|
||||
| 共有算子 | tds-connector / data-watermark / abac-policy / compliance-audit | 同 4 个 |
|
||||
| 业务上下文 | 银行反欺诈 | 车云合规分析 |
|
||||
| E2E 耗时 | 2.4s | 26s(150 次 data-masking) |
|
||||
|
||||
## VC 内 4+1+1+1 关键覆盖
|
||||
|
||||
| 类型 | 断言 | 结果 |
|
||||
|---|---|---|
|
||||
| **不变性 1** | PII 无泄漏 | ✅ C3_masking_no_pii_leak(150 次调用 0 泄漏)|
|
||||
| **不变性 2** | 脱敏可逆(hash 稳定) | ✅ C4_masking_reversible_hash_same + C4_masking_hash_64hex |
|
||||
| **不变性 3** | 水印 roundtrip 严格一致 | ✅ C5_watermark_roundtrip |
|
||||
| **不变性 4** | 水印不可见 | ✅ C6_watermark_visible_unchanged + C6_watermark_zw_count_4x |
|
||||
| **不变性 5** | 审计链 valid | ✅ C9_audit_chainValid + C9_audit_entries_6 |
|
||||
| **拒绝路径** | TDS hash 不匹配 → contract-mismatch | ✅ C2_tds_mismatch_false + C2_tds_mismatch_err + C2_tds_mismatch_no_token |
|
||||
| **E2E 串联** | 1 shell 跑 C1~C10 全过 | ✅ C10_e2e_full_flow_pass |
|
||||
| **聚合正确性** | fleet 50 client + noise_applied=false | ✅ C7_fedavg_client_count_50 + C7_fedavg_no_noise |
|
||||
|
||||
## 实施取舍
|
||||
|
||||
1. **C3 50 车 × 3 字段 = 150 次**:data-masking 是单字段算子,e2e 在 shell 层循环调用 150 次
|
||||
(每次 ~50ms,总 7.5s),保留"业务流 = 50 车 × 3 字段"的真实性。
|
||||
2. **C6 零宽字符计数**:BSD `tr -d '\200-\377'` 不能可靠剥离多字节 UTF-8,改用 Python
|
||||
codepoint 计数(`zw = {'', '', '', ''}`)。
|
||||
3. **C7 horizontal-fedavg 行为**:flat weights[] 模式忽略 `aggregation` 字段,永远返回 mean;
|
||||
e2e 验证 `client_count=50` + `noise_applied=false` 两个核心不变量,不依赖 exact mean 值。
|
||||
4. **C8 abac-policy env 字段名**:用 `ip_range`(不是 `ip_cidr`),与算子 schema 严格对齐
|
||||
(见 operators/abac-policy.ts:121)。
|
||||
5. **C9 审计链 6 entry**:比 chg_0010 少 2 entry,因为 chg_0011 业务流只 6 步
|
||||
(tds → masking → watermark → fedavg → abac → close),精简且自洽。
|
||||
|
||||
## 是否建议合并
|
||||
|
||||
**是。** 理由:
|
||||
- 0 新代码 / 0 新依赖 / 0 新接口(与 proposal "不做" 段完全一致)
|
||||
- 5 件套完整 + 门禁 gap=0 + tsc 0 新错 + 8 套 e2e 196/0 全 PASS
|
||||
- 算子复用率 32%(chg_0010 互补:独占 2 算子 / 共有 4 算子)
|
||||
- 文档含出域 PII 清单(PII 必脱敏 + 业务字段保留)— 满足车云合规硬约束
|
||||
- 总耗时 26s < 60s 阈值;TS 场景测试不拖累回归套件
|
||||
|
||||
## 下一步建议
|
||||
|
||||
- 归档 chg_0011:`mv openspec/changes/chg_0011_vehicle_cloud_compliance → archive/2026-09-29-chg_0011_vehicle_cloud_compliance`
|
||||
- handoff §2 优先级 2(chg_0010/0011 设计候选 A/B)全部关闭;§2.3 框架文档化
|
||||
(dispatch-helpers 收口)仍待 chg_0013 候选文档化为开箱即用的 helper / prompt 模板。
|
||||
- chg_0012 (LMS v2 多场景) 已提案,待 dispatch。
|
||||
|
||||
— chg_0011 闭环 —
|
||||
@@ -0,0 +1,95 @@
|
||||
---
|
||||
change_id: chg_0011
|
||||
status: proposed
|
||||
owner: pm@team
|
||||
stakeholders: [pd, tm, qa, dev]
|
||||
priority: P1
|
||||
target_release: v0.7
|
||||
created: 2026-09-29
|
||||
skip_coverage: false
|
||||
---
|
||||
|
||||
# chg_0011 vehicle_cloud_compliance — 车云数据合规场景
|
||||
|
||||
## Why
|
||||
|
||||
chg_0010(金融联合风控)已落地"数据不出域"的多方计算场景,但需求 §5 还要求另一类互补场景:
|
||||
**"数据出域可追溯"** — 数据确实需要离开车端到云端,但全程可审计、可还原、可鉴权。
|
||||
|
||||
候选三场景中:
|
||||
|
||||
- **金融联合风控** → chg_0010 已闭环(80% 复用率,多方数据不出域)。
|
||||
- **车云数据合规** → **本 chg**(32% 复用率,6/19 算子,数据出域可追溯)。
|
||||
- 医疗联合诊断 → 后续候选(与 chg_0011 互补,暂缓)。
|
||||
|
||||
车云合规的特殊性在于:
|
||||
|
||||
1. **车端 PII 必须出域**(监管/合规分析需要)— 但要**字段感知脱敏 + 零宽水印 + 审计链**全程可还原。
|
||||
2. **出域字段有白名单边界** — GPS / 车牌 / 车主 ID 全部脱敏,业务字段(故障码 / 电池电压 / 里程)保留。
|
||||
3. **不依赖 PSI / 同态加密**(与 chg_0010 互补)— 数据明文聚合,但通过水印 + 审计保证可追溯。
|
||||
|
||||
**约束**:
|
||||
|
||||
- 不改 backend 代码(6 算子已齐备:tds-connector / data-masking / data-watermark / horizontal-fedavg / abac-policy / compliance-audit)
|
||||
- 不加前端(场景测试目标是 backend e2e 协同)
|
||||
- 不动 OperatorsService / ExperimentModule 注册(19 算子已注册)
|
||||
- 复用 chg_0010 的 e2e 风格:admin token + per-vehicle 标签模拟 50 辆车
|
||||
|
||||
## Scope
|
||||
|
||||
**做**:
|
||||
|
||||
1. **场景设计文档** `docs/dth/vc/scenario.md`:定义 VC 场景的 6 步流程 + 数据流图 + 不变性约束 + 与既有算子的映射表 + **出域 PII 清单**。
|
||||
|
||||
2. **集成 e2e 测试** `tests/e2e/dth_vc.test.sh`:10 case 串起 6 个算子,覆盖:
|
||||
- S1: 车端 TDS 合约 hash 匹配(tds-connector → JWT token)
|
||||
- S2: TDS 合约 hash 不匹配 → 流程拒绝(tds-connector → error="contract-mismatch")
|
||||
- S3: 50 车 telemetry 字段感知脱敏(data-masking:GPS/车牌/车主ID 全脱敏,业务字段保留)
|
||||
- S4: 脱敏可逆性证明(data-masking:reversible_hash=SHA256 字段 → 业务对账还原)
|
||||
- S5: 聚合报告零宽水印嵌入 + 提取 roundtrip(data-watermark)
|
||||
- S6: 水印不可见(data-watermark:visible length 不变)
|
||||
- S7: 50 车 fleet 聚合(horizontal-fedavg:mean + stddev)
|
||||
- S8: ABAC 合规分析师通过 + 工程师拒绝(abac-policy)
|
||||
- S9: 审计链 HMAC 完整(compliance-audit:6 步流程 chainValid=true)
|
||||
- S10: E2E 端到端 6 步(admin login → S1→S9 串行 + 总耗时 < 60s)
|
||||
|
||||
3. **门禁更新** `openspec/scripts/check_spec_coverage.sh`:无需改动(5 件套天然 cover)。
|
||||
|
||||
**不做**:
|
||||
|
||||
- ❌ 新建 VC 专属 endpoint(直接复用 `POST /experiment/runs` 一个一个跑算子)
|
||||
- ❌ 新加前端(backend-only e2e)
|
||||
- ❌ 新加 operator(19 算子全够用,本 chg 用 6 个)
|
||||
- ❌ 新加依赖(纯 shell + python3 + jq,已在 chg_0002 启用)
|
||||
- ❌ 改 abac / auth / tds-connector(admin token 全程够用)
|
||||
|
||||
## Acceptance
|
||||
|
||||
- 10 case e2e 全 PASS(chg_0011 自身)
|
||||
- 7 回归 e2e 全 PASS(chg_0002/0005/0006/0007/0008/0009/0010 = 7 套)
|
||||
- gate `PROJECT_ROOT=. bash openspec/scripts/check_spec_coverage.sh` gap=0
|
||||
- `tsc --noEmit` 0 error(除预存 chg_0002 vertical-lr.ts:52)
|
||||
- 文档 `docs/dth/vc/scenario.md` 包含:mermaid 流程图(6 步)+ 数据流表 + 算子映射表 + 不变性清单 + **出域 PII 清单** + 复用矩阵
|
||||
|
||||
## 与 chg_0010 的互补关系
|
||||
|
||||
| 维度 | chg_0010 金融联合风控 | chg_0011 车云数据合规 |
|
||||
|---|---|---|
|
||||
| 数据流向 | 不出域(多方计算) | **出域可追溯** |
|
||||
| 隐私保护 | PSI / Paillier / Threshold Sig | **水印 + 审计链** |
|
||||
| 算子覆盖率 | 8/19 = 42%(10 算子 + 6 真算法) | **6/19 = 32%** |
|
||||
| 独占算子 | psi / paillier-he / threshold-sig / did-identity | **data-masking / horizontal-fedavg** |
|
||||
| 共有算子 | abac-policy / data-watermark / compliance-audit / tds-connector | 同 4 个 |
|
||||
| 业务上下文 | 银行反欺诈 | 车云合规分析 |
|
||||
|
||||
## 与 handoff §2 的对应
|
||||
|
||||
handoff §2 优先级 2 = "chg_0010 真实业务场景测试设计" → chg_0010 已闭环 ✓。
|
||||
chg_0011 是 handoff §2 的**第 2 个候选场景**(车云数据合规),完成 = handoff §2 三场景全部覆盖(金融 ✓ / 车云 ✓ / 医疗 暂缓)。
|
||||
|
||||
## 风险
|
||||
|
||||
- **R1** data-masking v2 是**字段级单值**算子,50 车 telemetry 是批量数据。
|
||||
- 缓解:e2e 在 shell 层做 50 次循环调用(每车 3 字段),保持"业务流 = 50 车 × 3 字段 = 150 次算子调用"的真实性。
|
||||
- **R2** horizontal-fedavg 在 chg_0008 的测试用例断言 `aggregated == [0.3, 0.4]` 精确等于均值。
|
||||
- 缓解:50 车 fleet 取均值,fedavg 直接给 mean,无 epsilon 时精确等于数学均值。
|
||||
@@ -0,0 +1,82 @@
|
||||
# Spec: experiment_platform
|
||||
|
||||
## Requirement
|
||||
|
||||
THE SYSTEM SHALL provide a vehicle-to-cloud data compliance (VC) scenario that composes
|
||||
6 existing operators (tds-connector / data-masking / data-watermark / horizontal-fedavg /
|
||||
abac-policy / compliance-audit) into a 6-step end-to-end compliant telemetry flow across
|
||||
50 simulated vehicles, proving that **out-of-domain PII is masked + watermarked + audit-traceable**
|
||||
WITHOUT any new operator / endpoint / dependency, so that 业务方能用现有算子验证"数据出域可追溯"
|
||||
的车云合规场景。
|
||||
|
||||
## ADDED Scenarios
|
||||
|
||||
### S1 车端 TDS 合约 hash 匹配
|
||||
|
||||
- **WHEN** the vehicle's TDS client submits `contract_hash` matching the cloud platform's `contract_hash`
|
||||
- **THEN** tds-connector.match() returns `{contract_hash_match: true, access_token: <3-part JWT>}`
|
||||
- **AND** the JWT has 3 dot-separated parts (header.payload.signature)
|
||||
- **AND** output `schema_version === "v2"`
|
||||
|
||||
### S2 TDS 合约 hash 不匹配 → 流程拒绝
|
||||
|
||||
- **WHEN** tds-connector.match() is called with `contract_hash_a !== contract_hash_b`
|
||||
- **THEN** output `{contract_hash_match: false, error: "contract-mismatch"}`
|
||||
- **AND** the VC flow is aborted at step 1 (no data-masking / aggregation runs)
|
||||
|
||||
### S3 字段感知脱敏(50 车 × 3 字段 = 150 次调用)
|
||||
|
||||
- **WHEN** 50 vehicles submit telemetry with GPS / plate / owner_id PII fields + business fields (fault_code / battery_voltage / mileage)
|
||||
- **THEN** data-masking masks **all 3 PII fields per vehicle** (150 masked values total)
|
||||
- **AND** the original PII values (GPS coordinates / plate numbers / owner IDs) NEVER appear in any masked output
|
||||
- **AND** business fields (fault_code / battery_voltage / mileage) are NOT masked — they are passed through unchanged
|
||||
- **AND** schema_version = "v2"
|
||||
|
||||
### S4 脱敏可逆性证明
|
||||
|
||||
- **WHEN** the masked output from S3 is inspected
|
||||
- **THEN** each masked entry contains a `reversible_hash` field (SHA256 of the original value)
|
||||
- **AND** the SHA256 hash is **stable** — re-masking the same original value produces the same reversible_hash
|
||||
- **AND** the reversible_hash length is exactly 64 hex chars (SHA256)
|
||||
|
||||
### S5 聚合报告零宽水印嵌入 + 提取 roundtrip
|
||||
|
||||
- **WHEN** the fleet aggregator embeds `payload = "VC|2026-09-29|fleet-50|v1"` into a fleet report via data-watermark
|
||||
- **THEN** data-watermark.extract(watermarked_report) returns the **exact** payload string
|
||||
- **AND** the embedded payload survives a single roundtrip (embed → extract = payload)
|
||||
- **AND** schema_version = "v2"
|
||||
|
||||
### S6 水印不可见
|
||||
|
||||
- **WHEN** S5 embed is performed with `text = "fleet report body..."` and payload above
|
||||
- **THEN** the visible (printable) length of `watermarked_text` is **unchanged** from `text` (zero-width chars are not visible)
|
||||
- **AND** the **byte** length grows by exactly `payload.length * 4` (4 zero-width chars per byte)
|
||||
|
||||
### S7 50 车 fleet 聚合(horizontal-fedavg)
|
||||
|
||||
- **WHEN** 50 vehicles submit their mean-fault-code (normalized to [0, 1])
|
||||
- **THEN** horizontal-fedavg outputs `aggregated` as the fleet-wide mean
|
||||
- **AND** `client_count === 50`
|
||||
- **AND** no Gaussian DP noise is applied (epsilon absent)
|
||||
- **AND** schema_version = "v2"
|
||||
|
||||
### S8 ABAC 合规分析师通过 + 工程师拒绝
|
||||
|
||||
- **WHEN** an ABAC policy requires `subject.role === "compliance-analyst"` AND `env.ip in CIDR "10.0.0.0/24"`
|
||||
- **THEN** request from `{role: "compliance-analyst", ip: "10.0.0.5"}` returns `{decision: "allow"}`
|
||||
- **AND** request from `{role: "engineer", ip: "10.0.0.5"}` returns `{decision: "deny", reasons: [...allow_miss...]}`
|
||||
- **AND** request from `{role: "compliance-analyst", ip: "192.168.1.5"}` returns `{decision: "deny", reasons: [...env_violation: ip...]}` (out of CIDR)
|
||||
|
||||
### S9 审计链 HMAC 完整(6 步流程链)
|
||||
|
||||
- **WHEN** the full VC flow runs through 6 audit entries (S1 tds + S3 masking + S5 watermark + S7 fedavg + S8 abac + S8-close = 6 entries)
|
||||
- **THEN** compliance-audit chain contains ≥ 6 entries (one per VC step)
|
||||
- **AND** each entry has HMAC-SHA256 chain linkage (`prev_hash` references the prior entry)
|
||||
- **AND** `chainValid === true` on full replay
|
||||
|
||||
### S10 E2E 端到端 6 步不变性
|
||||
|
||||
- **WHEN** a single shell run executes S1→S9 in order with the canonical 50-vehicle fixture
|
||||
- **THEN** every intermediate assertion in S1..S9 passes
|
||||
- **AND** the final output reports `e2e dth_vc: pass=N fail=0` (N = total sub-assertions, expected 10+)
|
||||
- **AND** total wall-clock time for the e2e is < 60s (operators are local TS, no external I/O)
|
||||
@@ -0,0 +1,72 @@
|
||||
# Tasks (DAG)
|
||||
|
||||
- id: T1
|
||||
type: architect
|
||||
depends_on: []
|
||||
output: docs/dth/vc/scenario.md
|
||||
verification:
|
||||
- 文档含 mermaid 流程图(6 步 + 6 算子映射)
|
||||
- 数据流表(每步:输入 → 算子 → 输出 → 不变性)
|
||||
- 算子映射表(每算子:何时被调用 / 输入 schema / 输出 schema)
|
||||
- 不变性清单(S1-S10 → 对应算子 + 测试断言)
|
||||
- **出域 PII 清单**(GPS / 车牌 / 车主 ID / 业务字段 — 是否出域 + 脱敏方式 + 反向验证)
|
||||
- 复用矩阵(既有 19 算子的复用率 ≥ 32%)
|
||||
|
||||
- id: T2
|
||||
type: implementer
|
||||
depends_on: [T1]
|
||||
output: |
|
||||
tests/e2e/dth_vc.test.sh (10 case e2e shell 脚本)
|
||||
verification:
|
||||
- 脚本无 set -e(每条 assertion 独立计数)
|
||||
- 使用 DTH_BASE=${DTH_BASE:-http://127.0.0.1:30000}
|
||||
- 每条 assert 用 python3 json_get (与 chg_0010 一致)
|
||||
- 包含 admin token login (pre_admin_login)
|
||||
- 10 case 覆盖 S1..S10
|
||||
- 总耗时 < 60s
|
||||
- 复用既有 helpers(不要重写 json_get / assert / login,从 chg_0010 复制)
|
||||
|
||||
- id: T3
|
||||
type: tester
|
||||
depends_on: [T2]
|
||||
output: |
|
||||
1 次完整 e2e 跑通(bash tests/e2e/dth_vc.test.sh 10/0)
|
||||
verification:
|
||||
- pass=10 fail=0
|
||||
- 含 4+ 不变性断言(脱敏可逆 / 水印 roundtrip / 水印不可见 / 审计链 HMAC)
|
||||
- 含 1 拒绝路径(TDS mismatch → 流程拒绝)
|
||||
- 含 1 跨车 E2E 串联(S10 = S1→S9 一气呵成)
|
||||
|
||||
- id: T4
|
||||
type: qa
|
||||
depends_on: [T3]
|
||||
output: |
|
||||
PROJECT_ROOT=. bash openspec/scripts/check_spec_coverage.sh
|
||||
7 e2e 套件全跑(chg_0002/0005/0006/0007/0008/0009/0010/0011 = 8 套)
|
||||
verification:
|
||||
- gate gap = 0
|
||||
- tsc --noEmit 0 error(除预存 chg_0002 vertical-lr.ts:52)
|
||||
- 7 回归 + 1 新 = 8 e2e 套件全 PASS
|
||||
- 总断言数 ≥ 182(172 旧 + 10 新 = 182)
|
||||
- 报告落 /tmp/chg_0011-qa.log
|
||||
|
||||
- id: T5
|
||||
type: pm
|
||||
depends_on: [T4]
|
||||
output: |
|
||||
openspec/changes/chg_0011_vehicle_cloud_compliance/.xstudio-report.md
|
||||
chg_0011 实施说明(取舍 + 与 chg_0010 互补算子差异 + 后续医疗候选)
|
||||
verification:
|
||||
- 报告含 改动文件清单 + 门禁结果 + 算子复用率 + 是否建议合并
|
||||
- 报告大小 ≥ 30 行
|
||||
- chg_0011 任务全部完成
|
||||
|
||||
# Notes
|
||||
|
||||
- 无 backend 代码改动(19 算子已齐备,本 chg 用其中 6 个)
|
||||
- 无 frontend 代码改动(业务场景 e2e only)
|
||||
- 无新依赖
|
||||
- 测试端口 30000(与既有 e2e 一致;DTH_BASE env 可覆盖)
|
||||
- 提交顺序建议:T1 (docs) → T2 (test script) → T3 (test PASS) → T4 (gate + regressions) → T5 (report)
|
||||
- 与 chg_0010 的边界:不动 OperatorsService / ExperimentModule 注册(19 算子已注册),仅新增 test 脚本
|
||||
- 与 chg_0010 的复用:共用 tds-connector / data-watermark / abac-policy / compliance-audit 4 算子;新增 data-masking / horizontal-fedavg 2 算子
|
||||
+58
@@ -0,0 +1,58 @@
|
||||
# spec: experiment_platform@chg_0011
|
||||
scenarios:
|
||||
- id: S1
|
||||
cases: [C1_vc_tds_contract_match]
|
||||
- id: S2
|
||||
cases: [C2_vc_tds_mismatch_abort]
|
||||
- id: S3
|
||||
cases: [C3_vc_field_aware_masking]
|
||||
- id: S4
|
||||
cases: [C4_vc_masking_reversible]
|
||||
- id: S5
|
||||
cases: [C5_vc_watermark_embed_extract_roundtrip]
|
||||
- id: S6
|
||||
cases: [C6_vc_watermark_invisible_length]
|
||||
- id: S7
|
||||
cases: [C7_vc_fleet_fedavg_aggregation]
|
||||
- id: S8
|
||||
cases: [C8_vc_abac_compliance_analyst]
|
||||
- id: S9
|
||||
cases: [C9_vc_audit_chain_hmac_valid]
|
||||
- id: S10
|
||||
cases: [C10_vc_e2e_full_flow_6_steps]
|
||||
gate:
|
||||
blocking_gap_tolerance: 0
|
||||
implementation_files:
|
||||
- tests/e2e/dth_vc.test.sh
|
||||
- docs/dth/vc/scenario.md
|
||||
test_files:
|
||||
- tests/e2e/dth_vc.test.sh
|
||||
notes:
|
||||
reuses_operators_no_new_code: true
|
||||
operator_coverage: "6 of 19 chg_0002/0008/0009 operators"
|
||||
operators_used:
|
||||
- tds-connector (S1, S2)
|
||||
- data-masking (S3, S4)
|
||||
- data-watermark (S5, S6)
|
||||
- horizontal-fedavg (S7)
|
||||
- abac-policy (S8)
|
||||
- compliance-audit (S9)
|
||||
invariant_assertions: 4
|
||||
- C4 masking_reversible (合规可还原)
|
||||
- C5 watermark_roundtrip (可恢复性)
|
||||
- C6 watermark_invisible_length (不可见性)
|
||||
- C9 audit_chain_hmac_valid (不可篡改性)
|
||||
complementary_to_chg_0010:
|
||||
shared_operators:
|
||||
- tds-connector
|
||||
- data-watermark
|
||||
- abac-policy
|
||||
- compliance-audit
|
||||
chg_0011_unique:
|
||||
- data-masking
|
||||
- horizontal-fedavg
|
||||
chg_0010_unique:
|
||||
- psi
|
||||
- paillier-he
|
||||
- threshold-sig
|
||||
- did-identity
|
||||
@@ -0,0 +1,122 @@
|
||||
### C1_vc_tds_contract_match
|
||||
- Scenario: S1
|
||||
- Type: e2e
|
||||
- Priority: P0
|
||||
- Given: backend running on 30000, admin token, vehicle's contract_hash = "vc-contract-v1"
|
||||
- When: POST /experiment/runs with operator=tds-connector (matching contract_hash_a == contract_hash_b)
|
||||
- Then: response.tds.contract_hash_match=true
|
||||
- And: response.tds.access_token is non-empty 3-part JWT (header.payload.signature)
|
||||
- And: schema_version=v2
|
||||
- Automated: true
|
||||
- Bound Task: T2
|
||||
|
||||
### C2_vc_tds_mismatch_abort
|
||||
- Scenario: S2
|
||||
- Type: e2e
|
||||
- Priority: P1
|
||||
- Given: contract_hash_a = "vc-contract-v1", contract_hash_b = "vc-contract-v2" (different)
|
||||
- When: POST /experiment/runs with operator=tds-connector
|
||||
- Then: response.tds.contract_hash_match=false
|
||||
- And: response.tds.error="contract-mismatch"
|
||||
- And: response.tds.access_token=null
|
||||
- And: VC flow aborts (no data-masking / aggregation runs)
|
||||
- Automated: true
|
||||
- Bound Task: T2
|
||||
|
||||
### C3_vc_field_aware_masking
|
||||
- Scenario: S3
|
||||
- Type: e2e
|
||||
- Priority: P0
|
||||
- Given: 50 vehicles × 3 PII fields (GPS / plate / owner_id) + 3 business fields (fault_code / battery_voltage / mileage)
|
||||
- When: 150 POST calls to data-masking (PII fields masked) + business fields passed through
|
||||
- Then: all 50 vehicles' GPS coordinates, plate numbers, owner IDs are masked (50 of each)
|
||||
- And: NO original PII value appears in any masked output (assert no GPS lat/lon, no plate, no owner_id strings)
|
||||
- And: business fields (fault_code "P0301", battery_voltage "12.6V", mileage "50000km") appear unchanged
|
||||
- And: schema_version=v2
|
||||
- Automated: true
|
||||
- Bound Task: T2
|
||||
|
||||
### C4_vc_masking_reversible
|
||||
- Scenario: S4
|
||||
- Type: e2e
|
||||
- Priority: P0 (compliance invariant)
|
||||
- Given: 1 vehicle with original GPS / plate / owner_id values, data-masked once
|
||||
- When: re-run data-masking on the same original values
|
||||
- Then: both runs produce the SAME reversible_hash for each field (SHA256 stable)
|
||||
- And: reversible_hash is exactly 64 hex chars (SHA256 output)
|
||||
- And: re-masking returns identical masked output (deterministic)
|
||||
- Automated: true
|
||||
- Bound Task: T2
|
||||
|
||||
### C5_vc_watermark_embed_extract_roundtrip
|
||||
- Scenario: S5
|
||||
- Type: e2e
|
||||
- Priority: P0
|
||||
- Given: fleet report text "Fleet avg fault_rate=0.05, fleet size=50", payload="VC|2026-09-29|fleet-50|v1"
|
||||
- When: POST data-watermark (action=embed) with text + payload, then POST (action=extract) on watermarked_text
|
||||
- Then: extract returns the EXACT payload string "VC|2026-09-29|fleet-50|v1"
|
||||
- And: roundtrip payload matches byte-for-byte
|
||||
- And: schema_version=v2
|
||||
- Automated: true
|
||||
- Bound Task: T2
|
||||
|
||||
### C6_vc_watermark_invisible_length
|
||||
- Scenario: S6
|
||||
- Type: e2e
|
||||
- Priority: P1
|
||||
- Given: text="Fleet avg fault_rate=0.05, fleet size=50" (37 chars), data-watermark embed
|
||||
- When: POST data-watermark (action=embed) with payload="VC|2026-09-29|fleet-50|v1" (24 bytes)
|
||||
- Then: visible (printable) length of watermarked_text == 37 (unchanged)
|
||||
- And: total length of watermarked_text == 37 + 24*4 == 133 (zero-width chars added)
|
||||
- And: zero-width chars appended is exactly 96 (= 24 * 4)
|
||||
- Automated: true
|
||||
- Bound Task: T2
|
||||
|
||||
### C7_vc_fleet_fedavg_aggregation
|
||||
- Scenario: S7
|
||||
- Type: e2e
|
||||
- Priority: P0
|
||||
- Given: 50 vehicles each submit a normalized fault-rate in [0, 1]
|
||||
- When: POST horizontal-fedavg with input.weights=[0.02, 0.05, ..., 0.08] (50 numbers)
|
||||
- Then: response.fedavg.aggregated[0] is the mean of the 50 values (no DP noise, epsilon absent)
|
||||
- And: response.fedavg.client_count=50
|
||||
- And: response.fedavg.noise_applied=false
|
||||
- And: schema_version=v2
|
||||
- Automated: true
|
||||
- Bound Task: T2
|
||||
|
||||
### C8_vc_abac_compliance_analyst
|
||||
- Scenario: S8
|
||||
- Type: e2e
|
||||
- Priority: P0
|
||||
- Given: abac policy requiring role=compliance-analyst AND env.ip in CIDR 10.0.0.0/24
|
||||
- When: 3 POSTs with combinations (1 allow + 2 deny)
|
||||
- Then: allow for {role: compliance-analyst, ip: 10.0.0.5}
|
||||
- And: deny with allow_miss for {role: engineer, ip: 10.0.0.5}
|
||||
- And: deny with env_violation:ip for {role: compliance-analyst, ip: 192.168.1.5}
|
||||
- Automated: true
|
||||
- Bound Task: T2
|
||||
|
||||
### C9_vc_audit_chain_hmac_valid
|
||||
- Scenario: S9
|
||||
- Type: e2e
|
||||
- Priority: P1
|
||||
- Given: 6 VC step audit entries (S1 tds + S3 masking summary + S5 watermark + S7 fedavg + S8 abac + S8-close)
|
||||
- When: POST compliance-audit with action=record (5 appends to chain), then POST verify=true with entries=full chain
|
||||
- Then: chain length === 6
|
||||
- And: each entry has prev_hash linking prior entry's hash
|
||||
- And: chainValid=true on verify replay
|
||||
- Automated: true
|
||||
- Bound Task: T2
|
||||
|
||||
### C10_vc_e2e_full_flow_6_steps
|
||||
- Scenario: S10
|
||||
- Type: e2e
|
||||
- Priority: P0
|
||||
- Given: canonical 50-vehicle fixture (TDS contract, masked telemetry, watermark payload, fleet weights, ABAC policy, audit entries)
|
||||
- When: 1 shell run executes all 9 steps in sequence (C1-C9 in order)
|
||||
- Then: pass=10 fail=0 (10 main cases)
|
||||
- And: total wall-clock < 60s
|
||||
- And: no operator-not-found or 500 errors in any substep
|
||||
- Automated: true
|
||||
- Bound Task: T3 (E2E orchestration test)
|
||||
@@ -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
|
||||
```
|
||||
@@ -0,0 +1,88 @@
|
||||
---
|
||||
change_id: chg_0012
|
||||
status: proposed
|
||||
owner: pm@dth
|
||||
stakeholders: [pd, tm, qa, dev]
|
||||
priority: P1
|
||||
target_release: v0.8
|
||||
created: 2026-09-29
|
||||
skip_coverage: 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 教学场景闭环。
|
||||
@@ -0,0 +1,87 @@
|
||||
# Spec: lms_v2
|
||||
|
||||
## Requirement
|
||||
|
||||
THE SYSTEM SHALL provide a multi-scene LMS v2 platform where each course is an
|
||||
**ordered scene sequence** of 4 types (slide / quiz / simulation / pbl),
|
||||
with append-only progress tracking and a built-in FRC 6-scene template that
|
||||
maps chg_0010's 6-step federated risk control flow into embeddable iframe
|
||||
scenes, so that 业务方能把"算子协同 + 教学编排"封装成可复用课程 WITHOUT
|
||||
introducing new operators / endpoints / dependencies.
|
||||
|
||||
## ADDED Scenarios
|
||||
|
||||
### S1 LMS v1 数据模型基础
|
||||
|
||||
- **WHEN** admin GET /api/ssw/dth/lms/students
|
||||
- **THEN** 响应 data 数组长度 ≥ 2,含固定 seed UUID `11111111-1111-1111-1111-111111111111`
|
||||
- **AND** schema 含 id / student_no / name / email / created_at
|
||||
- **AND** admin GET /api/ssw/dth/lms/courses 同样 ≥ 2 + schema 含 code / credits / instructor
|
||||
|
||||
### S2 多场景数据模型 v2
|
||||
|
||||
- **WHEN** admin GET /api/ssw/dth/lms-v2/courses/:id/scenes
|
||||
- **THEN** 响应 code = 200(lms_course_scene 表存在)
|
||||
- **AND** admin POST /lms-v2/courses with `scene_type="video"` → 422 INVALID_SCENE_TYPE(CHECK 约束拒绝)
|
||||
|
||||
### S3 创建多场景课程
|
||||
|
||||
- **WHEN** admin POST /lms-v2/courses with code + name + scenes[{slide,quiz}]
|
||||
- **THEN** 回 200 + course + 2 scenes(按 order_index 升序)
|
||||
- **AND** 重复 code → 409 DUPLICATE_COURSE_CODE
|
||||
- **AND** admin POST /lms-v2/courses/from-frc-template → 回 200 + course + 6 simulation scenes
|
||||
|
||||
### S4 选课 + 进度 append-only 幂等
|
||||
|
||||
- **WHEN** admin POST /lms/courses/:courseId/enroll with student_id
|
||||
- **THEN** 回 200,lms_enrollment 记录建立(progress_scene_ids = [])
|
||||
- **AND** POST /lms-v2/scenes/:sceneId/complete with student_id + course_id → progress_count = 1
|
||||
- **AND** 再次 complete 同一 scene → progress_count 仍 = 1(append-only 幂等)
|
||||
- **AND** complete 不同 scene → progress_count = 2
|
||||
|
||||
### S5 SlideScene Markdown 渲染(MiniMD 5 节点)
|
||||
|
||||
- **WHEN** slide payload 含 markdown:`# Title\n## Sub\n- a\n- b\nnormal\n\`\`\`\ncode\n\`\`\`\nillegal`
|
||||
- **THEN** GET /lms-v2/courses/:courseId/scenes/:sceneId/render 返回 html:
|
||||
`<h1>Title</h1><h2>Sub</h2><ul><li>a</li><li>b</li></ul><p>normal</p><pre><code>code</code></pre><p>illegal</p>`
|
||||
- **AND** "illegal" 节点作为 `<p>` 原样保留(非 5 类节点不抛错、不删字符)
|
||||
|
||||
### S6 QuizScene 判分
|
||||
|
||||
- **WHEN** quiz 含 choice 题(answer="2")+ short 题(keywords=["私有不泄露","交集"])
|
||||
- **THEN** grade(answers={q1:"2"}) → score=1.0(choice 全对)
|
||||
- **AND** grade(answers={q1:"1"}) → score=0.0(choice 全错)
|
||||
- **AND** grade(answers={qs1:"PSI 求交集"}) → score=1.0(1/2 关键词命中 = 50% ≥ 满分)
|
||||
- **AND** grade(answers={qs1:"完全不相关"}) → score=0.0(0 关键词命中)
|
||||
|
||||
### S7 SimScene iframe + embed_url 校验
|
||||
|
||||
- **WHEN** admin POST /lms-v2/courses with simulation scene + embed_url="https://example.com/embed"
|
||||
- **THEN** 回 200
|
||||
- **AND** GET /render → 回 embed_url 字段 = "https://example.com/embed"
|
||||
- **AND** admin POST with embed_url="javascript:alert(1)" → 400 INVALID_EMBED_URL(非 http(s):// 前缀)
|
||||
|
||||
### S8 FRC 6-scene 模板(严格对位 chg_0010 S1-S6)
|
||||
|
||||
- **WHEN** admin POST /lms-v2/courses/from-frc-template with course_code + teacher
|
||||
- **THEN** 创建 1 门课程 + 6 simulation scenes
|
||||
- **AND** order_index 严格 = 1,2,3,4,5,6
|
||||
- **AND** 6 embed_url 严格对位:
|
||||
- s1: did-tds
|
||||
- s2: psi
|
||||
- s3: paillier
|
||||
- s4: threshold
|
||||
- s5: abac
|
||||
- s6: audit
|
||||
|
||||
### S9 E2E 完整流程
|
||||
|
||||
- **WHEN** admin login → from-frc-template → student login → enroll → 6 render + 6 complete
|
||||
- **THEN** 每个 scene 的 complete 回 200
|
||||
- **AND** 最终 progress_count = 6 / 6 = 1.0
|
||||
|
||||
### S10 PBL 占位一致性
|
||||
|
||||
- **WHEN** admin POST /lms-v2/courses with scene_type="pbl"
|
||||
- **THEN** GET /render 回 code=501 NOT_IMPLEMENTED + msg="PBL 场景 v2 实现,当前仅作课程占位"
|
||||
- **AND** 前端 PBLScene.tsx 占位文案 "PBL 场景 v2 实现,当前仅作课程占位" 与后端 501 文案字面一致
|
||||
@@ -0,0 +1,72 @@
|
||||
# Tasks (DAG)
|
||||
|
||||
- id: T1
|
||||
type: architect
|
||||
depends_on: []
|
||||
output: docs/dth/lms-v2/scenario.md
|
||||
verification:
|
||||
- 4 类 scene payload schema 表
|
||||
- MiniMD 5 节点规格 (h1/h2/p/ul/li/code) + 原样保留非法节点
|
||||
- FRC 模板字段表(6 scene + embed_url 对位)
|
||||
- 与 OpenMAIC 对位(保留 simulation 命名)
|
||||
- 关键不变量 6 条
|
||||
|
||||
- id: T2
|
||||
type: implementer
|
||||
depends_on: [T1]
|
||||
output: |
|
||||
src/backend/src/lms/lms-v2.controller.ts (6 endpoints)
|
||||
src/backend/src/lms/lms-v2.service.ts (5 service methods + MiniMD)
|
||||
src/backend/src/common/pglite/init.ts (lms_course_scene 表 + progress_scene_ids 列)
|
||||
src/backend/src/lms/lms.module.ts (注册 v2 controller + service)
|
||||
src/frontend/src/api/lms/client.ts (8 API helpers)
|
||||
src/frontend/src/views/LMS/{CourseList,CourseDetail,SceneRenderer,SlideScene,QuizScene,SimScene,PBLScene}.tsx
|
||||
src/frontend/src/App.tsx (注册 /lms 3 个路由)
|
||||
tests/e2e/dth_lms_v2.test.sh (10 case e2e)
|
||||
verification:
|
||||
- 0 新算子 / 0 新依赖 / 0 前端框架切换
|
||||
- 6 不变量:409 / 422 / 400 / 501 / append-only / scene_type enum CHECK
|
||||
- FRC 6 scene embed_url 严格对位 chg_0010 S1-S6
|
||||
- 10 case e2e 覆盖 S1-S10
|
||||
- 复用既有 helpers(json_get / assert / login)
|
||||
|
||||
- id: T3
|
||||
type: tester
|
||||
depends_on: [T2]
|
||||
output: |
|
||||
1 次完整 e2e 跑通(bash tests/e2e/dth_lms_v2.test.sh 10/0)
|
||||
verification:
|
||||
- pass=10 case, fail=0
|
||||
- 含 4+ 不变性断言(slide 渲染 / quiz 判分 / append-only / FRC 对位)
|
||||
- 含 1 拒绝路径(非法 embed_url → 400)
|
||||
- 含 1 完整 E2E 串联(C9)
|
||||
|
||||
- id: T4
|
||||
type: qa
|
||||
depends_on: [T3]
|
||||
output: |
|
||||
PROJECT_ROOT=. bash openspec/scripts/check_spec_coverage.sh
|
||||
6 e2e 套件全跑(chg_0006/0008/0009/0010/0011/0012)
|
||||
verification:
|
||||
- gate gap = 0
|
||||
- tsc --noEmit 0 error(除预存 chg_0002 vertical-lr.ts:52)
|
||||
- 5 回归 + 1 新 = 6 e2e 套件全 PASS
|
||||
- 报告落 /tmp/chg_0012-qa.log
|
||||
|
||||
- id: T5
|
||||
type: pm
|
||||
depends_on: [T4]
|
||||
output: |
|
||||
openspec/changes/chg_0012_lms_multiscene_v2/.xstudio-report.md
|
||||
verification:
|
||||
- 报告含 改动文件清单 + 门禁结果 + 是否建议合并
|
||||
- 报告大小 ≥ 30 行
|
||||
- chg_0012 任务全部完成
|
||||
|
||||
# Notes
|
||||
|
||||
- LMS v1 schema / seed 不动(chg_0006 e2e 不回归);v2 在 v1 之上增量扩展
|
||||
- LMS 路径在 src/backend/src/lms/(CLAUDE.md F-2 索引 dth/lms/ 是错的;以在盘为准)
|
||||
- backend 测试端口 30051(PGlite 数据放 /tmp/lmsv2-pglite)
|
||||
- 提交顺序:T1 (docs) → T2 (impl) → T3 (e2e) → T4 (gate) → T5 (pm)
|
||||
- 与 chg_0006 的边界:v1 controllers/services 不动,v2 是新加 module import
|
||||
@@ -0,0 +1,65 @@
|
||||
# spec: lms_v2@chg_0012
|
||||
scenarios:
|
||||
- id: S1
|
||||
cases: [C1_lms_v1_data_model_basic]
|
||||
- id: S2
|
||||
cases: [C2_multiscene_v2_data_model]
|
||||
- id: S3
|
||||
cases: [C3_create_multi_scene_course]
|
||||
- id: S4
|
||||
cases: [C4_enroll_and_progress_append_only]
|
||||
- id: S5
|
||||
cases: [C5_slide_markdown_render]
|
||||
- id: S6
|
||||
cases: [C6_quiz_grading]
|
||||
- id: S7
|
||||
cases: [C7_sim_iframe_embed_url]
|
||||
- id: S8
|
||||
cases: [C8_frc_6_scene_template]
|
||||
- id: S9
|
||||
cases: [C9_e2e_full_flow]
|
||||
- id: S10
|
||||
cases: [C10_pbl_placeholder_consistency]
|
||||
gate:
|
||||
blocking_gap_tolerance: 0
|
||||
implementation_files:
|
||||
- src/backend/src/lms/lms-v2.controller.ts
|
||||
- src/backend/src/lms/lms-v2.service.ts
|
||||
- src/backend/src/common/pglite/init.ts
|
||||
- src/backend/src/lms/lms.module.ts
|
||||
- src/frontend/src/api/lms/client.ts
|
||||
- src/frontend/src/views/LMS/CourseList.tsx
|
||||
- src/frontend/src/views/LMS/CourseDetail.tsx
|
||||
- src/frontend/src/views/LMS/SceneRenderer.tsx
|
||||
- src/frontend/src/views/LMS/SlideScene.tsx
|
||||
- src/frontend/src/views/LMS/QuizScene.tsx
|
||||
- src/frontend/src/views/LMS/SimScene.tsx
|
||||
- src/frontend/src/views/LMS/PBLScene.tsx
|
||||
- src/frontend/src/App.tsx
|
||||
- docs/dth/lms-v2/scenario.md
|
||||
test_files:
|
||||
- tests/e2e/dth_lms_v2.test.sh
|
||||
notes:
|
||||
reuses_operators_no_new_code: true
|
||||
operator_coverage: "0 of 19 chg_0002/0008/0009 operators (none used; LMS v2 only orchestrates)"
|
||||
scenario_count: 10
|
||||
invariant_assertions: 6
|
||||
duplicates_course_code_invariant: 409
|
||||
duplicate_enroll_invariant: 409
|
||||
append_only_progress: true
|
||||
illegal_scene_type_invariant: 422
|
||||
bad_embed_url_invariant: 400
|
||||
pbl_not_implemented: 501
|
||||
scene_type_enum_values:
|
||||
- slide
|
||||
- quiz
|
||||
- simulation
|
||||
- pbl
|
||||
frc_template_scene_count: 6
|
||||
frc_embed_url_keywords:
|
||||
- did-tds
|
||||
- psi
|
||||
- paillier
|
||||
- threshold
|
||||
- abac
|
||||
- audit
|
||||
@@ -0,0 +1,84 @@
|
||||
# Testcases: chg_0012_lms_multiscene_v2
|
||||
|
||||
Each case asserts one specific scenario from spec.md via the e2e shell script
|
||||
`tests/e2e/dth_lms_v2.test.sh`. The script reuses `json_get` / `assert` / `login`
|
||||
helpers from chg_0006/0010/0011.
|
||||
|
||||
## S1 LMS v1 数据模型基础
|
||||
|
||||
- **C1_lms_v1_data_model_basic**
|
||||
- GET /api/ssw/dth/lms/students → ≥ 2 students, schema complete, seed UUID present
|
||||
- GET /api/ssw/dth/lms/courses → ≥ 2 courses, schema complete, seed UUID present
|
||||
|
||||
## S2 多场景数据模型 v2
|
||||
|
||||
- **C2_multiscene_v2_data_model**
|
||||
- GET /api/ssw/dth/lms-v2/courses/:id/scenes → code 200 (lms_course_scene table exists)
|
||||
- POST with scene_type="video" → 422 INVALID_SCENE_TYPE (CHECK constraint rejects)
|
||||
|
||||
## S3 创建多场景课程
|
||||
|
||||
- **C3_create_multi_scene_course**
|
||||
- admin POST /lms-v2/courses with code + scenes[slide,quiz] → 200 + 2 scenes
|
||||
- duplicate code → 409 DUPLICATE_COURSE_CODE
|
||||
- admin POST /lms-v2/courses/from-frc-template → 200 + 6 simulation scenes
|
||||
|
||||
## S4 选课 + 进度 append-only 幂等
|
||||
|
||||
- **C4_enroll_and_progress_append_only**
|
||||
- enroll → 200
|
||||
- complete scene 1 → progress_count = 1
|
||||
- complete scene 1 again → progress_count still 1 (idempotent)
|
||||
- complete scene 2 → progress_count = 2
|
||||
|
||||
## S5 SlideScene Markdown 渲染(MiniMD 5 节点)
|
||||
|
||||
- **C5_slide_markdown_render**
|
||||
- render slide scene → 200
|
||||
- html contains: `<h1>`, `<h2>`, `<ul>`, 2× `<li>`, `<p>normal`, `<code>code-block-here`
|
||||
- "illegal_node_blah" preserved verbatim (rendered as `<p>`)
|
||||
|
||||
## S6 QuizScene 判分
|
||||
|
||||
- **C6_quiz_grading**
|
||||
- perfect choice → score = 1.0
|
||||
- wrong choice → score = 0.0
|
||||
- 50% keyword hit (1/2) → score = 1.0
|
||||
- 0% keyword hit → score = 0.0
|
||||
|
||||
## S7 SimScene iframe + embed_url 校验
|
||||
|
||||
- **C7_sim_iframe_embed_url**
|
||||
- create with https URL → 200
|
||||
- render → embed_url matches
|
||||
- create with `javascript:` URL → 400 INVALID_EMBED_URL
|
||||
|
||||
## S8 FRC 6-scene 模板(严格对位 chg_0010 S1-S6)
|
||||
|
||||
- **C8_frc_6_scene_template**
|
||||
- from-frc-template → 6 scenes, all type=simulation
|
||||
- order_index strictly 1,2,3,4,5,6
|
||||
- 6 embed_url keywords present (did-tds, psi, paillier, threshold, abac, audit)
|
||||
|
||||
## S9 E2E 完整流程
|
||||
|
||||
- **C9_e2e_full_flow**
|
||||
- admin login → from-frc-template → student login → enroll
|
||||
- 6 render calls all 200
|
||||
- 6 complete calls all 200
|
||||
- final progress_count = 6, progress_pct = 1.0
|
||||
|
||||
## S10 PBL 占位一致性
|
||||
|
||||
- **C10_pbl_placeholder_consistency**
|
||||
- create with scene_type="pbl" → 200
|
||||
- render → code = 501 NOT_IMPLEMENTED
|
||||
- backend msg = "PBL 场景 v2 实现,当前仅作课程占位"
|
||||
- frontend PBLScene.tsx constant = same string (drift detector)
|
||||
|
||||
## all test_runner_and_gate_pass
|
||||
|
||||
- **C11_test_runner_passes_all** — bash tests/e2e/dth_lms_v2.test.sh exit 0
|
||||
- **C12_check_spec_coverage_gap_zero** — bash openspec/scripts/check_spec_coverage.sh gap=0
|
||||
|
||||
Total: 12 cases, 45 sub-assertions.
|
||||
Reference in new issue
Block a user