Files
makemd/archive/handover/node-liquidity-forecast-ui.md
wurenzhi 136c2fa579 feat: 初始化项目结构并添加核心功能模块
- 新增文档模板和导航结构
- 实现服务器基础API路由和控制器
- 添加扩展插件配置和前端框架
- 引入多租户和权限管理模块
- 集成日志和数据库配置
- 添加核心业务模型和类型定义
2026-03-17 22:07:19 +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)
- [ ] 跨节点资金到账的实时追踪。
- [ ] 调拨费用的动态核算。
- [ ] 导出包含流动性分析的全球财务月报。