50 lines
2.8 KiB
Markdown
50 lines
2.8 KiB
Markdown
# 前端集成蓝图：弹性多式联运自动对冲引擎 (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)
|
||
- [ ] 实时获取全球航道拥堵数据。
|
||
- [ ] 支持针对大批量订单的一键批量切换。
|
||
- [ ] 导出包含多式联运切换路径的物流报告。
|