makemd/docs/blueprints/frontend-integration/cross-node-settlement-ui.md

前端集成蓝图：跨节点自治清算协议 (Cross-Node Settlement)

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

1. 业务意图 (Business Intent)

• 核心价值：实现 Hub 节点间的自动化利润分润与资金清算，构建去中心化的全球贸易价值网。
• 关联后端 Service：CrossNodeSettlementService.ts

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

• 页面入口：Console -> 财务中心 -> 跨节点清算
• 展示组件：
  • 节点拓扑图：展示当前 Hub 与其它贸易 Hub 间的连接状态。
  • 清算流水表：展示跨节点分润的详细记录（Source, Target, Amount, Status）。
  • 清算证明卡片：展示基于 DID 与 ZKP 的清算证据链。
• 交互草图：

  +-----------------------------------------------------------+
  | [Icon] 跨节点自治清算 (Cross-Node Settlement)           |
  +-----------------------------------------------------------+
  | [ 当前节点: Hub-Local ] <----( $1,200 )----> [ Hub-Remote ] |
  +-----------------------------------------------------------+
  | [ 最近清算记录 ]                                          |
  | ID: CN-7788 | 目标: Node-Alpha | 金额: $450.00 | ✅ 已确认 |
  +-----------------------------------------------------------+
  | [ AGI 清算洞察 ]                                          |
  | "系统已自动识别跨节点订单 ORD-9900 的分润协议。预估结算 |
  | 金额：$120.00。清算证据已通过 DID 存证并发送至目标节点。" |
  +-----------------------------------------------------------+
  | [ 撤回请求 ]                      [ 查看 ZKP 证据链 ]      |
  +-----------------------------------------------------------+
  

3. API 交互契约 (API Integration)

• 数据获取：GET /api/v1/finance/settlement/cross-node
• 关键字段映射
  • source_node_id -> 发起节点
  • target_node_id -> 目标节点
  • settlement_proof_hash -> 证明哈希
• 状态流转：
  • 发起结算 -> PENDING -> 目标节点确认 -> EXECUTED。

4. 生产校验项 (FE Readiness)

• 跨节点网络延迟的实时监控。
• 节点间身份握手证书的有效性校验。
• 导出包含多节点路径的全球财务汇总。