Files
makemd/docs/blueprints/frontend-integration/dispute-arbitration-ui.md
Ansonai 6759d47de4 docs: 新增V30.0版本相关设计文档与指南
新增服务器启动文档、设计说明书、风险清单等核心文档
补充前端集成蓝图、多租户实施清单、上线红线检查清单
添加质量保障文档与早期业务规格书
2026-03-16 01:31:26 +08:00

45 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 前端集成蓝图:智能争议仲裁建议 (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)。