Files
makemd/docs/blueprints/frontend-integration/fx-hedging-risk.md
Ansonai 6759d47de4 docs: 新增V30.0版本相关设计文档与指南
新增服务器启动文档、设计说明书、风险清单等核心文档
补充前端集成蓝图、多租户实施清单、上线红线检查清单
添加质量保障文档与早期业务规格书
2026-03-16 01:31:26 +08:00

2.5 KiB

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