makemd/docs/blueprints/frontend-integration/multi-currency-recon.md

前端集成蓝图：跨主权多币种对冲对账引擎 (Multi-Currency Recon)

[AI-3 @ 2026-03-14]：由后端 Agent 在完成 BIZ_FIN_50 逻辑后产出。

1. 业务意图 (Business Intent)

• 核心价值：自动化处理汇率波动导致的对账偏差，保护商户资金主权，减少财务核对成本。
• 关联后端 Service：MultiCurrencyHedgingReconService.ts

2. UI/UX 布局方案 (Layout Design)

• 页面入口：Console -> 财务中心 -> 多币种对账
• 展示组件：
  • 汇率波动看板：展示下单汇率 vs 结算汇率。
  • 对账偏差列表：高亮显示 fx_drift 超过阈值的订单。
  • 对冲建议卡片：展示建议的对冲动作（如：锁定汇率）。
• 交互草图：

  +-----------------------------------------------------------+
  | [Icon] 多币种对冲对账 (Multi-Currency Recon)             |
  +-----------------------------------------------------------+
  | [ 状态：发现异常 (DISCREPANCY) ]                           |
  | 订单 ID: ORD-5678 | 订单金额: €1,000 | 汇损: -$45.20      |
  +-----------------------------------------------------------+
  | 下单汇率: 1 USD = 0.92 EUR | 当前汇率: 1 USD = 0.88 EUR      |
  +-----------------------------------------------------------+
  | [ AGI 对冲建议 (Hedging Advice) ]                         |
  | "监测到欧元大幅贬值，建议对未来 7 天的欧元结算订单执行 |
  | 锁汇操作，预估可挽回损失：$320.00。"                     |
  +-----------------------------------------------------------+
  | [ 忽略 ]                      [ 一键执行锁汇对冲 ]         |
  +-----------------------------------------------------------+
  

3. API 交互契约 (API Integration)

• 数据获取：GET /api/v1/finance/recon/fx
• 关键字段映射
  • fx_drift -> 汇损金额
  • order_rate -> 下单汇率
  • current_rate -> 当前汇率
• 状态流转：
  • 点击 [执行对冲] -> 调用 POST /api/v1/finance/hedging/approve -> 状态变为 HEDGED。

4. 生产校验项 (FE Readiness)

• 汇率数据的实时刷新（< 1 min）。
• 汇损金额的货币格式化校验。
• 导出包含汇率路径的对账明细。