Files
dth/openspec/changes/chg_0010_federated_risk_control/proposal.md
T
xstudio agentandClaude Code fadd9e46d0 chg_0010: federated_risk_control 提案 — 3 银行联合反欺诈场景(5 件套,无新代码,纯算子组合)
场景:3 银行(BankA/BankB/BankC)联合反欺诈,不泄露 PII,6 步流程
  1. DID 建立 + TDS 合约匹配 (did-identity + tds-connector)
  2. PSI 黑名单交集 (psi)
  3. Paillier 跨行特征聚合 (paillier-he)
  4. Threshold 2-of-3 风险签名 (threshold-sig)
  5. ABAC 风险分析师访问控制 (abac-policy)
  6. 数据水印嵌入 (data-watermark) + 审计链 HMAC (compliance-audit)

12 case e2e (S1-S12) 覆盖 8/10 chg_0009 算子 + 1 chg_0008 算子
4 不变性断言:PSI 正确 / PSI 不泄露 / Paillier 同态 / 水印 roundtrip

约束:
- 不改 backend 代码(10 算子已齐备,0 新依赖,0 新接口)
- 不加前端(backend-only e2e)
- 复用既有 /experiment/runs 一个一个跑算子
- admin token 全程,per-bank 标签在 input 里传

gate: PROJECT_ROOT=. bash openspec/scripts/check_spec_coverage.sh → PASS (gap=0, 9 archived + 1 active)

handoff §2 优先级 2 闭环。
实施待 sandbox dispatch(T1 architect → T5 pm)。

Co-Authored-By: Claude Code <[email protected]>
2026-09-28 21:49:33 +08:00

3.7 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_0010 proposed pm@team
pd
tm
qa
dev
P1 v0.6 2026-09-28 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)。

  4. 端口:仍 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️⃣框架文档化待办)。