docs: 新增V30.0版本相关设计文档与指南
新增服务器启动文档、设计说明书、风险清单等核心文档 补充前端集成蓝图、多租户实施清单、上线红线检查清单 添加质量保障文档与早期业务规格书
This commit is contained in:
@@ -0,0 +1,44 @@
|
||||
# 前端集成蓝图:智能争议仲裁建议 (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)。
|
||||
Reference in New Issue
Block a user