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