# 📋 前端实现方案：多币种自动锁汇避险 (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%，预计损耗金额”。