docs: 新增V30.0版本相关设计文档与指南
新增服务器启动文档、设计说明书、风险清单等核心文档 补充前端集成蓝图、多租户实施清单、上线红线检查清单 添加质量保障文档与早期业务规格书
This commit is contained in:
45
docs/blueprints/frontend-integration/multi-currency-recon.md
Normal file
45
docs/blueprints/frontend-integration/multi-currency-recon.md
Normal file
@@ -0,0 +1,45 @@
|
||||
# 前端集成蓝图:跨主权多币种对冲对账引擎 (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` 超过阈值的订单。
|
||||
- [ ] **对冲建议卡片**:展示建议的对冲动作(如:锁定汇率)。
|
||||
- **交互草图**:
|
||||
```text
|
||||
+-----------------------------------------------------------+
|
||||
| [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)。
|
||||
- [ ] 汇损金额的货币格式化校验。
|
||||
- [ ] 导出包含汇率路径的对账明细。
|
||||
Reference in New Issue
Block a user