docs: 新增V30.0版本相关设计文档与指南
新增服务器启动文档、设计说明书、风险清单等核心文档 补充前端集成蓝图、多租户实施清单、上线红线检查清单 添加质量保障文档与早期业务规格书
This commit is contained in:
44
docs/blueprints/frontend-integration/courier-credit-ui.md
Normal file
44
docs/blueprints/frontend-integration/courier-credit-ui.md
Normal file
@@ -0,0 +1,44 @@
|
||||
# 前端集成蓝图:众包物流配送员 DID 信用分级 (Courier Credit)
|
||||
|
||||
> **[AI-3 @ 2026-03-14]**:由后端 Agent 在完成 BIZ_LOG_70 逻辑后产出。
|
||||
|
||||
## 1. 业务意图 (Business Intent)
|
||||
- **核心价值**:建立基于 DID 的配送员信用体系,通过自动化评分与等级划分,筛选优质众包资源,降低末端派送风险。
|
||||
- **关联后端 Service**:`CourierCreditService.ts`
|
||||
|
||||
## 2. UI/UX 布局方案 (Layout Design)
|
||||
- **页面入口**:Console -> 履约中心 -> 众包资源 -> 配送员信用
|
||||
- **展示组件**:
|
||||
- [ ] **配送员信用分布图**:展示活跃配送员的信用等级分布 (Platinum, Gold, etc.)。
|
||||
- [ ] **信用明细卡片**:展示特定配送员的履约率、争议率及 AGI 评价。
|
||||
- [ ] **派单优先级设置**:允许管理员配置不同信用分对应的派单权重。
|
||||
- **交互草图**:
|
||||
```text
|
||||
+-----------------------------------------------------------+
|
||||
| [Icon] 配送员信用分级管理 (Courier Credit) |
|
||||
+-----------------------------------------------------------+
|
||||
| [ 配送员: Courier-Alpha ] [ 信用分: 95.5 ] [ 等级: 铂金 ] |
|
||||
+-----------------------------------------------------------+
|
||||
| 成功派送: 1,200 | 争议案件: 2 | 准时率: 99.2% |
|
||||
+-----------------------------------------------------------+
|
||||
| [ AGI 信用洞察 (Credit Insight) ] |
|
||||
| "该配送员信用极佳,近 30 天无任何投诉。建议提升其在核心 |
|
||||
| 商业区的派单优先级,并解锁 '高货值商品' 派送权限。" |
|
||||
+-----------------------------------------------------------+
|
||||
| [ 降低权限 ] [ 提升派单权重 (1.2x) ] |
|
||||
+-----------------------------------------------------------+
|
||||
```
|
||||
|
||||
## 3. API 交互契约 (API Integration)
|
||||
- **数据获取**:`GET /api/v1/logistics/courier/credit?did=DID-123`
|
||||
- **关键字段映射**
|
||||
- `rating` -> 信用分
|
||||
- `successful_deliveries` -> 成功数
|
||||
- `dispute_count` -> 争议数
|
||||
- **状态流转**:
|
||||
- 配送完成 -> 调用 `CourierCreditService.updateCourierScore` -> 更新 UI 评分。
|
||||
|
||||
## 4. 生产校验项 (FE Readiness)
|
||||
- [ ] 信用分变动的历史趋势曲线图。
|
||||
- [ ] 恶意差评的信用申诉处理界面。
|
||||
- [ ] 导出包含信用背景的配送员准入清单。
|
||||
Reference in New Issue
Block a user