# 前端集成蓝图：弹性多式联运自动对冲引擎 (Intermodal Failover)

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

## 1. 业务意图 (Business Intent)
- **核心价值**：当全球主航道发生黑天鹅事件时，自动计算并执行多式联运切换（如海转铁），最小化时效延误。
- **关联后端 Service**：`IntermodalFailoverService.ts`

## 2. UI/UX 布局方案 (Layout Design)
- **页面入口**：Console -> 履约中心 -> 多式联运调度
- **展示组件**：
    - [ ] **全球航道监控图**：展示苏伊士运河、巴拿马运河等关键航道的实时拥堵度。
    - [ ] **多式联运切换建议列表**：展示 AGI 生成的 Failover 建议（SEA_TO_RAIL, SEA_TO_AIR）。
    - [ ] **时效-成本平衡图**：对比原始海运路径与多式联运路径的时效提升与成本增加。
- **交互草图**：
    ```text
    +-----------------------------------------------------------+
    | [Icon] 多式联运自愈看板 (Intermodal Failover)           |
    +-----------------------------------------------------------+
    | [ 原始路径: 苏伊士运河 (Sea) ] [ 状态: 严重堵塞 (BLOCKED) ] |
    +-----------------------------------------------------------+
    | 目的地: 伦敦 (London) | 预估延误: 25 天                    |
    +-----------------------------------------------------------+
    | [ AGI 路由自愈建议 (Failover Suggestion) ]                |
    | --------------------------------------------------------- |
    | 建议：切换至 [中欧班列 (Sea-to-Rail)]                     |
    | 时效：-10 天 (缩短 10 天) | 成本：+$5.2/kg (建议对冲)     |
    | --------------------------------------------------------- |
    | [?] 为何建议？                                            |
    | "苏伊士运河发生长达 15 天的严重拥堵，海转铁成本仅增加 |
    | $5.2/kg，但可避免 10 天以上的订单违约风险。"            |
    +-----------------------------------------------------------+
    | [ 忽略建议 ]                      [ 确认切换并对冲运费 ]   |
    +-----------------------------------------------------------+
    ```

## 3. API 交互契约 (API Integration)
- **数据获取**：`GET /api/v1/logistics/failover/calculate?original_route_id=SEA-001`
- **关键字段映射**
    - `method` -> 切换方法 (SEA_TO_RAIL, etc.)
    - `estimated_cost` -> 预估切换成本
    - `timeframe_days` -> 预估时效
- **状态流转**：
    - 切换发现风险 -> 调用 `IntermodalFailoverService.calculateFailover` -> 重新渲染成本对比图。

## 4. 生产校验项 (FE Readiness)
- [ ] 实时获取全球航道拥堵数据。
- [ ] 支持针对大批量订单的一键批量切换。
- [ ] 导出包含多式联运切换路径的物流报告。