Files
makemd/archive/handover/crowdsourced-logistics.md
wurenzhi 136c2fa579 feat: 初始化项目结构并添加核心功能模块
- 新增文档模板和导航结构
- 实现服务器基础API路由和控制器
- 添加扩展插件配置和前端框架
- 引入多租户和权限管理模块
- 集成日志和数据库配置
- 添加核心业务模型和类型定义
2026-03-17 22:07:19 +08:00

2.3 KiB
Raw Blame History

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

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

1. 业务意图 (Business Intent)

  • 核心价值:在传统物流商瘫痪时,自动调度众包资源,确保履约不中断,提升物流韧性。
  • 关联后端 ServiceCrowdsourcedLogisticsService.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 的推送通知。