Files
dth/openspec/changes/chg_0011_vehicle_cloud_compliance/proposal.md
T

4.9 KiB
Raw Blame History

change_id, status, owner, stakeholders, priority, target_release, created, skip_coverage
change_id status owner stakeholders priority target_release created skip_coverage
chg_0011 proposed pm@team
pd
tm
qa
dev
P1 v0.7 2026-09-29 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 时精确等于数学均值。