feat: 初始化项目结构并添加核心功能模块

- 新增文档模板和导航结构
- 实现服务器基础API路由和控制器
- 添加扩展插件配置和前端框架
- 引入多租户和权限管理模块
- 集成日志和数据库配置
- 添加核心业务模型和类型定义
This commit is contained in:
2026-03-17 22:07:19 +08:00
parent c0870dce50
commit 136c2fa579
728 changed files with 107690 additions and 5614 deletions

View File

@@ -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)。