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

46 lines
2.3 KiB
Markdown
Raw Normal View History

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