Files
makemd/docs/blueprints/frontend-integration/node-liquidity-forecast-ui.md
Ansonai 6759d47de4 docs: 新增V30.0版本相关设计文档与指南
新增服务器启动文档、设计说明书、风险清单等核心文档
补充前端集成蓝图、多租户实施清单、上线红线检查清单
添加质量保障文档与早期业务规格书
2026-03-16 01:31:26 +08:00

45 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 前端集成蓝图:跨主权多节点资金流动性自动预测 (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)
- [ ] 跨节点资金到账的实时追踪。
- [ ] 调拨费用的动态核算。
- [ ] 导出包含流动性分析的全球财务月报。