46 lines
2.3 KiB
Markdown
46 lines
2.3 KiB
Markdown
# 前端集成蓝图：最后一公里众包路由优化 (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 的推送通知。
|