# 前端集成蓝图：跨节点自治清算协议 (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 的清算证据链。
- **交互草图**：
    ```text
    +-----------------------------------------------------------+
    | [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)
- [ ] 跨节点网络延迟的实时监控。
- [ ] 节点间身份握手证书的有效性校验。
- [ ] 导出包含多节点路径的全球财务汇总。