# 前端集成蓝图：最后一公里众包路由优化 (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 众包物流的成本差异。
- **交互草图**：
    ```text
    +-----------------------------------------------------------+
    | [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 的推送通知。