docs: 新增V30.0版本相关设计文档与指南
新增服务器启动文档、设计说明书、风险清单等核心文档 补充前端集成蓝图、多租户实施清单、上线红线检查清单 添加质量保障文档与早期业务规格书
This commit is contained in:
46
docs/blueprints/frontend-integration/fx-hedging-risk.md
Normal file
46
docs/blueprints/frontend-integration/fx-hedging-risk.md
Normal file
@@ -0,0 +1,46 @@
|
||||
# 📋 前端实现方案:多币种自动锁汇避险 (FX Hedging)
|
||||
|
||||
## 1. UI 布局草图 (UI Layout Sketch)
|
||||
|
||||
```
|
||||
+-------------------------------------------------------------------------+
|
||||
| [Breadcrumb: Console > Finance > FX Risk] |
|
||||
+-------------------------------------------------------------------------+
|
||||
| [Currency Pair: USD/CNY] [Current Rate: 7.2450] [Volatility: 2.4%] |
|
||||
+-------------------------------------------------------------------------+
|
||||
| +-------------------------+ +-------------------------+ +-------------+ |
|
||||
| | 待结汇金额 (Receivable) | | 预估汇损风险 (Risk) | | 建议操作 | |
|
||||
| | $250,000.00 | | -$1,250.00 | | [立即锁汇] | |
|
||||
| +-------------------------+ +-------------------------+ +-------------+ |
|
||||
+-------------------------------------------------------------------------+
|
||||
| [汇率趋势与风险等级 (FX Trend & Risk Level)] |
|
||||
| [Chart: 过去30天汇率波动曲线] |
|
||||
| > 风险等级: [MEDIUM] (波动率超过 2%) |
|
||||
+-------------------------------------------------------------------------+
|
||||
| [锁汇建议详情 (Hedging Advice)] |
|
||||
| > AI 建议锁定 50% 的待结汇款项以对冲近期人民币升值风险。 |
|
||||
| [输入框: 锁汇比例 [%]] [按钮: 发起锁汇请求 (Execute Hedge)] |
|
||||
+-------------------------------------------------------------------------+
|
||||
```
|
||||
|
||||
## 2.交互状态机 (Interaction FSM)
|
||||
|
||||
- **IDLE**: 页面初始加载。
|
||||
- **AUDITING**: 调用 `/api/finance/fx/audit/:pair` 分析风险。
|
||||
- **RECOMMENDING**: 渲染避险建议与操作按钮。
|
||||
- **EXECUTING**: 点击“发起锁汇”,调用 `MultiAssetSettlementService.lockExchangeRate`。
|
||||
- **VERIFIED**: 锁汇指令已发送至银行/支付网关,进入 PENDING_REVIEW。
|
||||
|
||||
## 3. 核心 API 字段映射 (API Field Mapping)
|
||||
|
||||
| 前端字段 (Frontend) | 后端 API 字段 (Backend) | 说明 (Description) |
|
||||
| :--- | :--- | :--- |
|
||||
| 当前汇率 | `latestRate` | 实时同步的中间价 |
|
||||
| 波动率 | `volatility` | 过去30天的标准差波动 |
|
||||
| 风险级别 | `riskLevel` | LOW/MEDIUM/CRITICAL |
|
||||
| 建议动作 | `suggestion` | 具体的避险操作叙述 |
|
||||
|
||||
## 4. ROI 可视化逻辑 (ROI Visualization)
|
||||
|
||||
- **风险热力**: 波动率 > 5% 触发红色闪烁告警。
|
||||
- **损耗模拟**: 自动计算“若不锁汇且汇率变动 1%,预计损耗金额”。
|
||||
Reference in New Issue
Block a user