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

前端集成蓝图：跨主权多节点资金流动性自动预测 (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 生成的资金重平衡建议。
• 交互草图：

  +-----------------------------------------------------------+
  | [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)

• 跨节点资金到账的实时追踪。
• 调拨费用的动态核算。
• 导出包含流动性分析的全球财务月报。