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

前端集成蓝图：智能争议仲裁建议 (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。
• 交互草图：

  +-----------------------------------------------------------+
  | [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)。