docs: 新增V30.0版本相关设计文档与指南
新增服务器启动文档、设计说明书、风险清单等核心文档 补充前端集成蓝图、多租户实施清单、上线红线检查清单 添加质量保障文档与早期业务规格书
This commit is contained in:
@@ -0,0 +1,44 @@
|
||||
# 前端集成蓝图:跨主权多节点资金流动性自动预测 (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)
|
||||
- [ ] 跨节点资金到账的实时追踪。
|
||||
- [ ] 调拨费用的动态核算。
|
||||
- [ ] 导出包含流动性分析的全球财务月报。
|
||||
Reference in New Issue
Block a user