Files
makemd/archive/handover/node-liquidity-forecast-ui.md
wurenzhi 136c2fa579 feat: 初始化项目结构并添加核心功能模块
- 新增文档模板和导航结构
- 实现服务器基础API路由和控制器
- 添加扩展插件配置和前端框架
- 引入多租户和权限管理模块
- 集成日志和数据库配置
- 添加核心业务模型和类型定义
2026-03-17 22:07:19 +08:00

2.3 KiB
Raw Blame History

前端集成蓝图:跨主权多节点资金流动性自动预测 (Liquidity Forecast)

[AI-3 @ 2026-03-14]:由后端 Agent 在完成 BIZ_FIN_90 逻辑后产出。

1. 业务意图 (Business Intent)

  • 核心价值:预测全球贸易 Hub 节点的资金缺口,自动建议跨节点资金调拨,确保全球清算网络的高效运行。
  • 关联后端 ServiceNodeLiquidityForecastService.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)

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