feat: 初始化项目结构并添加核心功能模块

- 新增文档模板和导航结构
- 实现服务器基础API路由和控制器
- 添加扩展插件配置和前端框架
- 引入多租户和权限管理模块
- 集成日志和数据库配置
- 添加核心业务模型和类型定义
This commit is contained in:
2026-03-17 22:07:19 +08:00
parent c0870dce50
commit 136c2fa579
728 changed files with 107690 additions and 5614 deletions

View File

@@ -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)
- [ ] 跨节点资金到账的实时追踪。
- [ ] 调拨费用的动态核算。
- [ ] 导出包含流动性分析的全球财务月报。