# 前端集成蓝图：跨主权多节点资金流动性自动预测 (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)
- [ ] 跨节点资金到账的实时追踪。
- [ ] 调拨费用的动态核算。
- [ ] 导出包含流动性分析的全球财务月报。