wurenzhi
136c2fa579
- 新增文档模板和导航结构 - 实现服务器基础API路由和控制器 - 添加扩展插件配置和前端框架 - 引入多租户和权限管理模块 - 集成日志和数据库配置 - 添加核心业务模型和类型定义
2.4 KiB
2.4 KiB
前端集成蓝图：众包物流配送员 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 评价。
- 派单优先级设置：允许管理员配置不同信用分对应的派单权重。
- 交互草图：
+-----------------------------------------------------------+ | [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)
- 信用分变动的历史趋势曲线图。
- 恶意差评的信用申诉处理界面。
- 导出包含信用背景的配送员准入清单。