docs: 新增V30.0版本相关设计文档与指南
新增服务器启动文档、设计说明书、风险清单等核心文档 补充前端集成蓝图、多租户实施清单、上线红线检查清单 添加质量保障文档与早期业务规格书
This commit is contained in:
@@ -0,0 +1,45 @@
|
||||
# 前端集成蓝图:最后一公里众包路由优化 (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 的推送通知。
|
||||
Reference in New Issue
Block a user