wurenzhi
136c2fa579
- 新增文档模板和导航结构 - 实现服务器基础API路由和控制器 - 添加扩展插件配置和前端框架 - 引入多租户和权限管理模块 - 集成日志和数据库配置 - 添加核心业务模型和类型定义
2.8 KiB
2.8 KiB
前端集成蓝图：弹性多式联运自动对冲引擎 (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)
- 实时获取全球航道拥堵数据。
- 支持针对大批量订单的一键批量切换。
- 导出包含多式联运切换路径的物流报告。