makemd/docs/blueprints/frontend-integration/sea-freight-advisor-ui.md

前端集成方案：全球物流拥堵指数与航线优化建议 (Sea Freight Advisor) - [BIZ_OPS_160]

1. 业务场景描述 (Business Context)

• 目标：全球贸易环境复杂，罢工、恶劣天气或港口瓶颈会严重拖慢发货时效。系统通过监控全球港口实时拥堵指数，为商户提供“避坑”建议和自动绕路方案。
• 用户收益：规避超长延迟，降低消费者退款率，提升供应链应对“黑天鹅”事件的韧性。

2. UI 布局草图 (UI Layout Sketch)

• 全球港口状态地图 (Global Port Map):
  • 地图标记：主要国际港口（LAX, RTM, NGB, SIN 等）。
  • 标记颜色：绿色（畅通）、黄色（拥堵）、红色（瘫痪/罢工）。
• 受影响订单雷达 (Affected Shipments):
  • 动态滚动条展示正在经过“红色”港口的订单号。
  • 预计延迟天数实时更新。
• 自适应路由策略 (Adaptive Routing Suggestions):
  • 方案 A: Switch to Air（切换至空运，展示差价）。
  • 方案 B: Alternative Port（切换至临近备选港口）。
  • 方案 C: Customer Notification（自动向受影响买家发送道歉信并赠送优惠券）。

3. 核心 API 字段映射 (API Mapping)

• 后端服务: SeaFreightAdvisor.auditRoutes(tenantId, indices)
• 响应结构:

  {
    "success": true,
    "routingSuggestions": [
      {
        "port": "Los Angeles (LAX)",
        "affectedCount": 150,
        "advice": "LA 港口罢工导致平均等待期延长至 14 天。建议后续订单路由至 Long Beach (LGB) 或切换空运。"
      }
    ]
  }
  

• 因果链呈现 (XAI Integration):
  • 叙述：“根据实时海运遥测，LA 港口的作业效率下降 60%，触发预警门槛。系统建议对高货值订单执行空运 Failover。”

4. 交互状态机 (Interaction State Machine)

• Hover Mark: 鼠标悬停在港口图标上，展示该港口过去 30 天的拥堵趋势图。
• Apply Failover: 点击“执行绕路”，系统自动更新 cf_logistics_route 优先级。

5. ROI 可视化逻辑 (ROI Tracking)

• 时效保全值: 计算通过绕路成功规避的平均延迟天数。
• 退款预防额: 基于历史数据，预估通过提前通知买家而减少的“未收到货”纠纷退款。

---

蓝图维护者: AI-2 (Internal) | 版本: V1.0
相关任务: BIZ_OPS_160