makemd/docs/blueprints/frontend-integration/did-settlement.md

前端集成蓝图：基于 DID 的自治清算协议 (DID Settlement)

[AI-3 @ 2026-03-14]：由后端 Agent 在完成 BIZ_FIN_40 逻辑后产出。

1. 业务意图 (Business Intent)

• 核心价值：自动化处理品牌方、代运营与达人的三方自动分润，降低结算争议 95%，实现“无感清算”。
• 关联后端 Service：DIDSettlementService.ts

2. UI/UX 布局方案 (Layout Design)

• 页面入口：Console -> 财务中心 -> 自治清算管理
• 展示组件：
  • DID 合约看板：展示各主体的 DID 身份与分成比例。
  • 清算记录表：展示每笔订单的清算状态与隐私存证证明。
  • 分润热力图：展示各主体的历史收益占比。
• 交互草图：

  +-----------------------------------------------------------+
  | [Icon] 自治清算管理 (DID-based Settlement)               |
  +-----------------------------------------------------------+
  | [ 当前合约状态：已激活 (ACTIVE) ]                         |
  | - 品牌方 (Brand): 70% [DID: brand-001] [✅ Verified]      |
  | - 代运营 (Ops):   20% [DID: ops-002]   [✅ Verified]      |
  | - 达人 (KOL):     10% [DID: kol-003]   [✅ Verified]      |
  +-----------------------------------------------------------+
  | [ 最近清算记录 (Last 10 Settlements) ]                    |
  | --------------------------------------------------------- |
  | Order ID | Party | Amount | Status | ZKP Proof          |
  | ORD-1234 | Brand | $140.0 | ✅ Done | [ View Proof ]     |
  | ORD-1234 | Ops   | $40.0  | ✅ Done | [ View Proof ]     |
  | ORD-1234 | KOL   | $20.0  | ✅ Done | [ View Proof ]     |
  +-----------------------------------------------------------+
  | [?] 审计备注：所有清算均通过 ZKP 存证，隐私且不可篡改。   |
  +-----------------------------------------------------------+
  

3. API 交互契约 (API Integration)

• 数据获取：GET /api/v1/finance/settlement/did
• 关键字段映射：
  • party_did -> DID 标识
  • party_role -> 角色
  • amount -> 清算金额
  • proof_hash -> ZKP 证明哈希
• 状态流转：
  • 点击 [View Proof] -> 调用 PrivateAuditService.verifyProof -> 展示验证通过标识。

4. 生产校验项 (FE Readiness)

• DID 身份的实名/实体认证校验。
• 大额清算的二次确认机制。
• 导出加密格式的清算审计流水。