makemd/docs/blueprints/frontend-integration/crowdsourced-logistics.md

前端集成蓝图：最后一公里众包路由优化 (Crowdsourced Last-mile)

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

1. 业务意图 (Business Intent)

• 核心价值：在传统物流商瘫痪时，自动调度众包资源，确保履约不中断，提升物流韧性。
• 关联后端 Service：CrowdsourcedLogisticsService.ts

2. UI/UX 布局方案 (Layout Design)

• 页面入口：Console -> 履约中心 -> 众包物流管理
• 展示组件：
  • 众包代理地图：展示各城市活跃的众包代理 (Crowdsourced Agents)。
  • 调度请求表：展示已分配的众包任务 (Assigned Tasks)。
  • 成本对比看板：展示传统物流 vs 众包物流的成本差异。
• 交互草图：

  +-----------------------------------------------------------+
  | [Icon] 众包物流调度 (Crowdsourced Logistics)             |
  +-----------------------------------------------------------+
  | [ 状态：已分配 (ASSIGNED) ]                               |
  | 订单 ID: ORD-9012 | 城市: 伦敦 (London) | 代理: Agent-X  |
  +-----------------------------------------------------------+
  | 预估成本: £12.50 | 传统成本: £8.00 | 差额: +£4.50         |
  +-----------------------------------------------------------+
  | [ AGI 韧性建议 (Resilience Insight) ]                    |
  | "传统物流商 (Royal Mail) 罢工，建议启用众包路由。       |
  | 虽成本增加 £4.50，但可避免 5 天延误，保护 DSR 评分。"    |
  +-----------------------------------------------------------+
  | [ 取消调度 ]                      [ 确认派单并通知代理 ]   |
  +-----------------------------------------------------------+
  

3. API 交互契约 (API Integration)

• 数据获取：GET /api/v1/logistics/crowdsourced/requests
• 关键字段映射
  • agent_did -> 代理 DID
  • city -> 城市
  • estimated_cost -> 预估成本
• 状态流转：
  • 点击 [确认派单] -> 调用 POST /api/v1/logistics/crowdsourced/approve -> 状态变为 IN_TRANSIT。

4. 生产校验项 (FE Readiness)

• 众包代理状态的实时监控（Online/Offline）。
• 众包派送费用的精准核算。
• 集成众包 App 的推送通知。