Files
makemd/docs/blueprints/frontend-integration/node-liquidity-forecast-ui.md

45 lines
2.3 KiB
Markdown
Raw Normal View History

# 前端集成蓝图:跨主权多节点资金流动性自动预测 (Liquidity Forecast)
> **[AI-3 @ 2026-03-14]**:由后端 Agent 在完成 BIZ_FIN_90 逻辑后产出。
## 1. 业务意图 (Business Intent)
- **核心价值**:预测全球贸易 Hub 节点的资金缺口,自动建议跨节点资金调拨,确保全球清算网络的高效运行。
- **关联后端 Service**`NodeLiquidityForecastService.ts`
## 2. UI/UX 布局方案 (Layout Design)
- **页面入口**Console -> 财务中心 -> 节点流动性看板
- **展示组件**
- [ ] **全球节点流动性热力图**:展示各 Hub 节点的资金盈余/缺口状态。
- [ ] **资金流入/流出趋势图**:展示特定节点的预测资金流向。
- [ ] **头寸调拨建议列表**:展示 AGI 生成的资金重平衡建议。
- **交互草图**
```text
+-----------------------------------------------------------+
| [Icon] 节点流动性自动预测 (Liquidity Forecast) |
+-----------------------------------------------------------+
| [ 节点: Hub-EU-01 ] [ 状态: 预警 (TIGHT) ] [ 缺口: $12,500 ] |
+-----------------------------------------------------------+
| 预计流入: $45,000 | 预计流出: $57,500 | 风险等级: 中高 (TIGHT) |
+-----------------------------------------------------------+
| [ AGI 调拨建议 (Rebalancing Advice) ] |
| "监测到 Hub-EU-01 明日清算量激增,建议从 Hub-CN-01 调拨 |
| $15,000 以对冲流动性风险。手续费预估:$12.00。" |
+-----------------------------------------------------------+
| [ 忽略建议 ] [ 一键发起节点间调拨 ] |
+-----------------------------------------------------------+
```
## 3. API 交互契约 (API Integration)
- **数据获取**`GET /api/v1/finance/liquidity/forecast?node_id=Hub-EU-01`
- **关键字段映射**
- `net_liquidity` -> 净头寸
- `risk_level` -> 风险等级
- `estimated_inflow` -> 预计流入
- **状态流转**
- 风险发现 -> 调用 `NodeLiquidityForecastService.forecastNodeLiquidity` -> 触发预警。
## 4. 生产校验项 (FE Readiness)
- [ ] 跨节点资金到账的实时追踪。
- [ ] 调拨费用的动态核算。
- [ ] 导出包含流动性分析的全球财务月报。