wurenzhi
136c2fa579
- 新增文档模板和导航结构 - 实现服务器基础API路由和控制器 - 添加扩展插件配置和前端框架 - 引入多租户和权限管理模块 - 集成日志和数据库配置 - 添加核心业务模型和类型定义
46 lines
2.3 KiB
Markdown
46 lines
2.3 KiB
Markdown
# 前端集成蓝图：跨节点自治清算协议 (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)
|
||
- [ ] 跨节点网络延迟的实时监控。
|
||
- [ ] 节点间身份握手证书的有效性校验。
|
||
- [ ] 导出包含多节点路径的全球财务汇总。
|