Files
makemd/docs/blueprints/frontend-integration/dispute-arbitration-ui.md

45 lines
2.3 KiB
Markdown
Raw Normal View History

# 前端集成蓝图:智能争议仲裁建议 (Dispute Arbitration)
> **[AI-3 @ 2026-03-14]**:由后端 Agent 在完成 BIZ_CSM_30 逻辑后产出。
## 1. 业务意图 (Business Intent)
- **核心价值**:自动化处理售后纠纷与退款争议,基于全链路证据链给出公正仲裁建议,降低客服工作量。
- **关联后端 Service**`DisputeArbitrationService.ts`
## 2. UI/UX 布局方案 (Layout Design)
- **页面入口**Console -> 客户成功 -> 争议仲裁工作台
- **展示组件**
- [ ] **争议详情卡片**:展示订单 ID、买家 DID、争议理由。
- [ ] **全链路证据链**:聚合订单、物流、支付的全量数据。
- [ ] **AGI 仲裁建议**:展示 `decision_suggested``causal_chain`
- **交互草图**
```text
+-----------------------------------------------------------+
| [Icon] 智能争议仲裁建议 (Dispute Arbitration) |
+-----------------------------------------------------------+
| [ 状态:已建议 (SUGGESTED) ] |
| 订单 ID: ORD-1234 | 买家: DID-ABC | 争议理由: 未收到 |
+-----------------------------------------------------------+
| [ AGI 仲裁书 (Arbitration Opinion) ] |
| "建议决策:驳回退款 (REJECT_REFUND)。 |
| 证据链:物流轨迹显示订单已于 2026-03-12 10:20 妥投, |
| 买家主张“未收到”与证据不符。" |
+-----------------------------------------------------------+
| [ 人工介入 ] [ 一键执行仲裁决定 ] |
+-----------------------------------------------------------+
```
## 3. API 交互契约 (API Integration)
- **数据获取**`GET /api/v1/customer/arbitration`
- **关键字段映射**
- `decision_suggested` -> 仲裁决策
- `causal_chain` -> 仲裁理由
- `status` -> 仲裁状态
- **状态流转**
- 点击 [执行仲裁决定] -> 调用 `POST /api/v1/customer/arbitration/approve` -> 更新订单退款状态。
## 4. 生产校验项 (FE Readiness)
- [ ] 证据链中物流轨迹的完整性展示。
- [ ] 退款金额的货币符号正确显示。
- [ ] 导出加密且防篡改的仲裁报告 (ZKP)。