makemd/docs/blueprints/frontend-integration/intermodal-failover-ui.md

前端集成蓝图：弹性多式联运自动对冲引擎 (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）。
  • 时效-成本平衡图：对比原始海运路径与多式联运路径的时效提升与成本增加。
• 交互草图：

  +-----------------------------------------------------------+
  | [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)

• 实时获取全球航道拥堵数据。
• 支持针对大批量订单的一键批量切换。
• 导出包含多式联运切换路径的物流报告。