Files
makemd/archive/handover/dispute-arbitration-ui.md
wurenzhi 136c2fa579 feat: 初始化项目结构并添加核心功能模块
- 新增文档模板和导航结构
- 实现服务器基础API路由和控制器
- 添加扩展插件配置和前端框架
- 引入多租户和权限管理模块
- 集成日志和数据库配置
- 添加核心业务模型和类型定义
2026-03-17 22:07:19 +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)。