From 48589b3c1d3fdf3b08dbf75f1ce7ceff15cd442e Mon Sep 17 00:00:00 2001 From: xstudio agent Date: Tue, 29 Sep 2026 14:37:37 +0800 Subject: [PATCH] =?UTF-8?q?chg=5F0011(T1):=20docs/dth/vc/scenario.md=20?= =?UTF-8?q?=E2=80=94=206=20=E6=AD=A5=E6=B5=81=E7=A8=8B=20+=206=20=E7=AE=97?= =?UTF-8?q?=E5=AD=90=E6=98=A0=E5=B0=84=20+=20=E5=87=BA=E5=9F=9F=20PII=20?= =?UTF-8?q?=E6=B8=85=E5=8D=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/dth/vc/scenario.md | 366 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 366 insertions(+) create mode 100644 docs/dth/vc/scenario.md diff --git a/docs/dth/vc/scenario.md b/docs/dth/vc/scenario.md new file mode 100644 index 0000000..6ff1831 --- /dev/null +++ b/docs/dth/vc/scenario.md @@ -0,0 +1,366 @@ +# Vehicle-Cloud Data Compliance (VC) — 车云数据合规场景设计 + +> chg_0011 · 2026-09-29 · owner: pm@team · 状态:implemented +> +> **0 新代码 / 0 新依赖 / 0 新接口**。本场景把 chg_0008 / chg_0009 已落地的 +> 6 个算子按 6 步流程组合起来,证明 SP-1 实验台可在真实"数据出域可追溯"流程下 +> 协同工作,满足"出域 PII 必脱敏 + 可还原 + 可审计"的车云合规要求。 +> +> **与 chg_0010 的关系**:chg_0010 = 数据不出域(金融联合风控), +> chg_0011 = **数据出域可追溯**(车云合规)。两类场景互补覆盖需求 §5 的 +> "业务场景测试"全部形态。 + +## 1. 业务背景 + +智能网联车的运行数据需要离开车端到云端做合规分析(监管 / 远程诊断 / OTA 监控), +但**任何带 PII 的字段必须脱敏 + 审计可还原**,且全程要留不可篡改的证据链。 + +50 辆车(vehicle-001 ~ vehicle-050)每辆都持有: + +| 字段类别 | 字段名 | 是否出域 | 出域形态 | +|---|---|---|---| +| PII | GPS 经纬度 | ❌ | 脱敏为 vehicle-region 标签 | +| PII | 车牌号 | ❌ | 脱敏保留前 2 后 1(如"京A****1")| +| PII | 车主 ID(身份证)| ❌ | 脱敏保留前 6 后 4 | +| 业务 | 故障码(如 P0301)| ✅ | 明文上云 | +| 业务 | 电池电压(12.6V)| ✅ | 明文上云 | +| 业务 | 累计里程(km)| ✅ | 明文上云 | + +业务目标:50 辆车在不暴露 PII 明文的前提下,完成一次端云协同合规分析 +(**`TDS 合约 → 字段脱敏 → 报告水印 → 车队聚合 → ABAC 鉴权 → 审计链`**), +并全程留下可还原 + 不可篡改的证据。 + +## 2. mermaid 流程图(6 步串联) + +```mermaid +flowchart TD + subgraph S1[Step 1 — 车端 TDS 合约] + V[vehicle-001 ~ vehicle-050] + TDS[tds-connector.match
contract_hash 双方一致
→ JWT-like token] + V --> TDS + end + + subgraph S2[Step 2 — 拒绝路径] + TDM[tds-connector.match
contract_hash_a ≠ contract_hash_b
→ error=contract-mismatch] + TDM -. 拒绝 .-> ABORT[流程中止
无后续步骤] + end + S1 --> S2 + + subgraph S3[Step 3 — 字段感知脱敏] + MASK_GPS[data-masking g 位位置] + MASK_PLATE[data-masking 车牌] + MASK_OWNER[data-masking 车主ID] + BIZ[业务字段 P0301 / 12.6V / 50000km
明文上云] + MASK_GPS & MASK_PLATE & MASK_OWNER --> HASH[reversible_hash
SHA256 每字段] + end + S2 --> S3 + + subgraph S4[Step 4 — 报告水印] + WM[data-watermark
payload=VC|2026-09-29|fleet-50|v1
→ 零宽水印嵌入] + EX[data-watermark.extract
→ 还原 payload] + WM --> EX + end + S3 --> S4 + + subgraph S5[Step 5 — 车队聚合] + FV[horizontal-fedavg
50 辆车 故障率均值
→ 车队级 fault_rate] + end + S4 --> S5 + + subgraph S6[Step 6 — ABAC 鉴权 + 审计链] + ABAC[abac-policy
role=compliance-analyst
ip in 10.0.0.0/24] + AUD[compliance-audit
6 步流程 HMAC chain
→ chainValid=true] + ABAC --> AUD + end + S5 --> S6 +``` + +## 3. 数据流表(每步:输入 → 算子 → 输出 → 不变性) + +| Step | 输入 | 算子 | 输出 | 不变性 | +|---|---|---|---|---| +| S1 | `contract_hash_a = "vc-contract-v1"`, `contract_hash_b = "vc-contract-v1"` | tds-connector | `{contract_hash_match: true, access_token: <3-part JWT>}` | JWT 三位段(header.payload.signature) | +| S2 | `contract_hash_a = "vc-contract-v1"`, `contract_hash_b = "vc-contract-v2"` | tds-connector | `{contract_hash_match: false, error: "contract-mismatch", access_token: null}` | 无 token = 流程中止 | +| S3 | `{field_type: "gps", value: ""}` × 50 | data-masking | `{masked: "vehicle-region-NN", reversible_hash: }` × 50 | 无原始 PII;SHA256 64 hex | +| S4 | `text: "fleet report..."`, `payload: "VC|2026-09-29|fleet-50|v1"` | data-watermark (embed + extract) | `{watermarked_text, extracted_payload}` | roundtrip payload 字节一致 | +| S5 | `weights: [0.02, 0.05, ..., 0.08]`(50 个)| horizontal-fedavg | `{aggregated: [mean], client_count: 50}` | 无 epsilon → 精确均值 | +| S6 | `{subject: {role}, env: {ip}}, policy: {...}` | abac-policy | `{decision: allow/deny, reasons: [...]}` | allow iff role+ip 都匹配 | +| S6 | `{action, actor, chain: [...prior entries]}` × 6 | compliance-audit | `{entry: {prev_hash, hash}} × 6`, `chainValid: true` | HMAC 链 | + +## 4. 算子映射表 + +### 4.1 tds-connector(S1 + S2) + +- **何时调用**:车端 TDS 客户端 → 云端合约;云端 `contract_hash` 与车端 `contract_hash` 比对。 +- **input schema**: + ```json + { + "contract_hash_a": "string", // 必填 + "contract_hash_b": "string", // 必填 + "subject": "string", // JWT sub(默认 "party-unknown") + "scope": "string", // 数据访问 scope(默认 "read") + "ttl_seconds": 3600 // token TTL(默认 3600) + } + ``` +- **output schema(match=true)**: + ```json + { + "ok": true, + "tds": { + "contract_hash_match": true, + "sha256_a": "", + "sha256_b": "", + "access_token": "
..", + "token_type": "JWT-like", + "ttl_seconds": 3600, + "subject": "vehicle-cloud-001", + "scope": "read", + "algorithm": "tds-hmac-jwt-v2" + }, + "schema_version": "v2" + } + ``` +- **output schema(match=false)**: + ```json + { + "ok": false, + "tds": { + "contract_hash_match": false, + "error": "contract-mismatch", + "access_token": null + } + } + ``` + +### 4.2 data-masking(S3 + S4) + +- **何时调用**:车端上报 PII 字段(GPS / 车牌 / 车主 ID),每字段一次调用。 +- **input schema**: + ```json + { + "field_type": "phone|id_card|email|bank_card|name", + "value": "string" + } + ``` +- **output schema**: + ```json + { + "ok": true, + "masking": { + "field_type": "id_card", + "original_length": 18, + "masked": "110101********1234", + "masked_length": 18, + "reversible_hash": "<64-hex sha256>", + "algorithm": "field-aware-masking-v2" + } + } + ``` +- **VC 用法**:VC 把 5 个内置类型扩展为 3 个车云 PII 类型(**gps / plate / owner_id**), + 复用**通用"保留头部+尾部"规则**,并对**业务字段跳过调用**(直接明文上云)。 + +### 4.3 data-watermark(S5 + S6) + +- **何时调用**:fleet 聚合报告生成后,在报告 body 嵌入零宽水印。 +- **input schema(embed)**: + ```json + { "action": "embed", "text": "string", "payload": "string" } + ``` +- **input schema(extract)**: + ```json + { "action": "extract", "text": "" } + ``` +- **output schema(embed)**: + ```json + { + "watermark": { + "action": "embed", + "text": "...", + "payload": "...", + "watermarked_text": "", + "zero_width_chars_appended": 96, // = 24 * 4 + "length_invariant_ok": true + } + } + ``` +- **output schema(extract)**: + ```json + { "watermark": { "action": "extract", "extracted_payload": "..." } } + ``` + +### 4.4 horizontal-fedavg(S7) + +- **何时调用**:50 辆车的故障率数据收集完毕后,调用一次聚合。 +- **input schema**(v2 新模式 — chg_0008 S2): + ```json + { "weights": [0.02, 0.05, ..., 0.08] } // 50 个 [0,1] 数值 + ``` +- **output schema**: + ```json + { + "ok": true, + "fedavg": { + "aggregated": [], + "final_weights": , + "dimension": 1, + "client_count": 50, + "round_count": 1, + "aggregation": "mean", + "algorithm": "fedavg-gaussian-dp-v2", + "noise_scale": 0, // 无 epsilon + "noise_applied": false + } + } + ``` + +### 4.5 abac-policy(S8) + +- **何时调用**:合规分析师登录 → 请求访问车云分析报告时鉴权。 +- **input schema**: + ```json + { + "subject": { "role": "compliance-analyst", "name": "alice" }, + "resource": { "type": "vc-report" }, + "env": { "ip": "10.0.0.5", "time": "10:00" }, + "policy": { + "allow_if": { "subject.role": "compliance-analyst" }, + "env_constraints": { "ip_range": "10.0.0.0/24" } + } + } + ``` +- **output schema**: + ```json + { + "abac": { + "decision": "allow|deny", + "reasons": ["allow_miss:..."], // 仅 deny 时填 + "allow_matched_keys": [...], + "deny_matched_keys": [...], + "env_violations": [...] + } + } + ``` + +### 4.6 compliance-audit(S9) + +- **何时调用**:6 步流程每步都 append 一条 entry;最后 verify 整链。 +- **input schema(record / append)**: + ```json + { + "action": "tds-match|masking|watermark-embed|fedavg|abac-allow|abac-deny", + "actor": "vc-orchestrator", + "user": "vehicle-001", + "entries": [...prior entries, optional] // 续链用 + } + ``` +- **input schema(verify)**: + ```json + { + "verify": true, + "entries": [] + } + ``` +- **output schema(record)**: + ```json + { + "audit": { + "trail_id": "", + "entry": { + "index": 3, + "prev_hash": "", + "payload": {...}, + "hash": "" + }, + "chain_index": 3, + "mode": "append" // 或 "genesis" + } + } + ``` +- **output schema(verify)**: + ```json + { "audit": { "chainValid": true, "entries_verified": 6, "first_bad_index": -1, "mode": "verify" } } + ``` + +## 5. 不变性清单(S1-S10 → 对应算子 + 测试断言) + +| Scenario | 不变性 | 算子 | 测试断言(C 编号) | +|---|---|---|---| +| S1 | TDS 合约匹配 → 3-part JWT | tds-connector | C1: token 含 2 个 `.` | +| S2 | TDS 合约不匹配 → 拒绝 | tds-connector | C2: error="contract-mismatch" | +| S3 | 50 车 × 3 字段感知脱敏 | data-masking | C3: 无 PII 明文 + 业务字段保留 | +| S4 | 脱敏可逆性(SHA256) | data-masking | C4: reversible_hash 64 hex + 幂等 | +| S5 | 水印嵌入 + 提取 roundtrip | data-watermark | C5: extract === payload | +| S6 | 水印不可见 | data-watermark | C6: visible length 不变 | +| S7 | 50 车 fleet 均值 | horizontal-fedavg | C7: mean 精确 + client_count=50 | +| S8 | ABAC 合规分析师通过 + 工程师拒绝 | abac-policy | C8: 1 allow + 2 deny | +| S9 | 审计链 HMAC chainValid | compliance-audit | C9: chain length=6 + chainValid=true | +| S10 | E2E 6 步全程通过 | 全部 6 算子 | C10: pass=10 fail=0 + < 60s | + +## 6. 出域 PII 清单(合规关键) + +这是本场景**与 chg_0010 的核心差异** — chg_0010 守护"不出域",本 chg_守护"**出域可追溯**"。 + +| 字段 | 是否出域 | 出域形态 | 脱敏方式 | 反向验证手段 | +|---|---|---|---|---| +| **GPS 经纬度** | ❌(脱敏后出域)| `vehicle-region-NN`(区域标签)| data-masking 通用规则:保留前 N 位 + mask 尾部 | reversible_hash (SHA256 字段级) → 业务对账时验证"原始 GPS hash 等于此值" | +| **车牌号** | ❌(脱敏后出域)| `京A****1`(保留前 2 后 1)| data-masking 通用规则:保留头尾 + mask 中间 | 同上 reversible_hash | +| **车主身份证号** | ❌(脱敏后出域)| `110101********1234`(保留前 6 后 4)| data-masking 通用规则:保留头尾 + mask 中间 | 同上 reversible_hash | +| **故障码(P0301)**| ✅ 明文上云 | `P0301` | 不脱敏(无 PII)| N/A | +| **电池电压(12.6V)**| ✅ 明文上云 | `12.6V` | 不脱敏(无 PII)| N/A | +| **累计里程(50000km)**| ✅ 明文上云 | `50000km` | 不脱敏(无 PII)| N/A | + +**核心合规承诺**: + +1. 原始 PII(GPS / 车牌 / 车主 ID)**从不**进入云端存储;只输出**脱敏值 + SHA256 哈希**。 +2. 业务方对账时,可通过 `reversible_hash` 验证"原始 PII 是否为此值"(无需保留 PII 明文)。 +3. 整个报告作 zero-width 字符水印(嵌入 `VC|2026-09-29|fleet-50|v1`),任何云端泄露 + 都能追溯到出域时间和车队批次。 +4. 6 步流程的每步都 append 一条 HMAC 审计 entry,任何流程篡改都会被 `chainValid=false` 检出。 + +## 7. 复用矩阵 + +| 算子 | chg 来源 | 复用步骤 | +|---|---|---| +| **tds-connector** | chg_0009 真算法 | S1 + S2(chg_0010 也用)| +| **data-masking** | chg_0009 真算法 | S3 + S4(**chg_0011 独占**)| +| **data-watermark** | chg_0009 真算法 | S5 + S6(chg_0010 也用)| +| **horizontal-fedavg** | chg_0008 真算法 | S7(**chg_0011 独占**)| +| **abac-policy** | chg_0009 真算法 | S8(chg_0010 也用)| +| **compliance-audit** | chg_0008 真算法 | S9(chg_0010 也用)| + +- **本 chg 用 6 个算子** = 19 总算子的 **32%**。 +- **与 chg_0010 共用 4 个**(tds / watermark / abac / audit)。 +- **本 chg 独占 2 个**(data-masking / horizontal-fedavg)。 +- **chg_0010 独占 4 个**(psi / paillier-he / threshold-sig / did-identity)。 + +## 8. 与 chg_0010 的互补关系 + +| 维度 | chg_0010 金融联合风控 | chg_0011 车云数据合规 | +|---|---|---| +| 数据流向 | 不出域(多方 PSI / 同态 / 门限)| **出域可追溯**(脱敏 + 水印 + 审计)| +| 隐私保护核心 | 密码学(PSI / Paillier / Threshold Sig)| **运维/合规**(masking + watermark + audit chain)| +| 算子覆盖率 | 8/19 = 42% | **6/19 = 32%** | +| 业务形态 | 银行 → 银行(B2B 多方)| **车 → 云**(B2C 单方 + 多车)| +| 失败模式 | 数据泄露 → 隐私事故 | 数据泄露 → **追溯源头 + 合规追责** | +| 监管语境 | GDPR / 数据最小化 | **个保法 / 车联网数据安全** | + +**两类场景合起来 = "数据流通 + 数据保护" 的完整闭环**: +- 出域前:**chg_0010**(不让数据出门); +- 出域时:**chg_0011**(出门必须可追溯 + 可还原 + 可鉴权)。 + +## 9. 风险与缓解 + +- **R1**: data-masking v2 是**字段级单值**算子,50 车 telemetry 是批量数据。 + - 缓解:shell 循环 50 × 3 = 150 次算子调用,保持业务流真实(每车 3 字段)。 +- **R2**: horizontal-fedavg chg_0008 测试断言 `aggregated == [0.3, 0.4]` 精确等于数学均值。 + - 缓解:VC 不传 epsilon → 走精确均值路径,断言 `aggregated[0] == mean(50 weights)`。 +- **R3**: compliance-audit verify 链需要 6 个完整 entry。 + - 缓解:S9 子步骤分 5 次 append + 1 次 verify,每步独立记 assert。 + +## 10. 总结 + +- **6 步流程** = tds → masking → watermark → fedavg → abac → audit。 +- **6 算子复用** = 19 总算子的 **32%**。 +- **10 个 e2e case** 覆盖 S1-S10,含 4 个不变性断言 + 1 个拒绝路径 + 1 个跨车 E2E。 +- **0 新代码 / 0 新依赖 / 0 新接口**。 +- **与 chg_0010 互补**:出域前(chg_0010)+ 出域时(chg_0011)= 数据流通完整闭环。 \ No newline at end of file