refactor: 优化代码结构并修复类型问题
- 移除未使用的TabPane组件 - 修复类型定义和导入方式 - 优化mock数据源的环境变量判断逻辑 - 更新文档结构并归档旧文件 - 添加新的UI组件和Memo组件 - 调整API路径和响应处理
This commit is contained in:
107
docs/ARCHIVE/00_Business/tasks/backend/09_after_sales.md
Normal file
107
docs/ARCHIVE/00_Business/tasks/backend/09_after_sales.md
Normal file
@@ -0,0 +1,107 @@
|
||||
# 售后逆向后端任务
|
||||
|
||||
## 任务列表
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
|
||||
| -------- | ------ | ------ | ---------- | ---- | ---- | ----------- | --- | -------- | ---- | ------------ | -------- |
|
||||
| BE-SR001 | 售后逆向闭环 | 退货处理接口 | 订单ID, 退货原因 | 退货ID | 前端提交 | ✅ completed | P0 | - | 12h | AI-Backend-5 | 2026-03-20 |
|
||||
| BE-SR002 | 售后逆向闭环 | 退款流程引擎 | 退货ID, 审批结果 | 退款状态 | 审批完成 | ✅ completed | P0 | BE-SR001 | 14h | AI-Backend-5 | 2026-03-20 |
|
||||
| BE-SR003 | 售后逆向闭环 | 售后工单系统 | 退货ID, 工单信息 | 工单ID | 退货创建 | ✅ completed | P0 | BE-SR001 | 16h | AI-Backend-5 | 2026-03-20 |
|
||||
|
||||
## 相关闭环
|
||||
|
||||
- 售后逆向闭环
|
||||
|
||||
## 依赖关系
|
||||
|
||||
```
|
||||
BE-SR001 ─┬─► BE-SR002
|
||||
└─► BE-SR003
|
||||
```
|
||||
|
||||
## 数据库表结构
|
||||
|
||||
### cf_return
|
||||
| 字段 | 类型 | 说明 |
|
||||
| ---- | ---- | ---- |
|
||||
| id | string | 退货记录ID |
|
||||
| tenant_id | string | 租户ID |
|
||||
| order_id | string | 订单ID |
|
||||
| reason | string | 退货原因 |
|
||||
| status | enum | PENDING/APPROVED/REJECTED/REFUNDED |
|
||||
| created_at | datetime | 创建时间 |
|
||||
| updated_at | datetime | 更新时间 |
|
||||
|
||||
### cf_refund
|
||||
| 字段 | 类型 | 说明 |
|
||||
| ---- | ---- | ---- |
|
||||
| id | string | 退款记录ID |
|
||||
| tenant_id | string | 租户ID |
|
||||
| return_id | string | 退货ID |
|
||||
| order_id | string | 订单ID |
|
||||
| amount | decimal(10,2) | 退款金额 |
|
||||
| status | enum | PENDING/COMPLETED/FAILED |
|
||||
| created_at | datetime | 创建时间 |
|
||||
| updated_at | datetime | 更新时间 |
|
||||
|
||||
### cf_service_ticket
|
||||
| 字段 | 类型 | 说明 |
|
||||
| ---- | ---- | ---- |
|
||||
| id | string | 工单ID |
|
||||
| tenant_id | string | 租户ID |
|
||||
| return_id | string | 退货ID |
|
||||
| order_id | string | 订单ID |
|
||||
| subject | string | 工单主题 |
|
||||
| description | text | 工单描述 |
|
||||
| status | enum | OPEN/IN_PROGRESS/RESOLVED/CLOSED |
|
||||
| created_at | datetime | 创建时间 |
|
||||
| updated_at | datetime | 更新时间 |
|
||||
|
||||
## API端点
|
||||
|
||||
### 售后管理API
|
||||
- `GET /api/after-sales/returns` - 获取退货列表
|
||||
- `POST /api/after-sales/returns` - 创建退货申请
|
||||
- `GET /api/after-sales/returns/:id` - 获取退货详情
|
||||
- `PUT /api/after-sales/returns/:id/status` - 更新退货状态
|
||||
- `GET /api/after-sales/refunds` - 获取退款列表
|
||||
- `POST /api/after-sales/refunds` - 创建退款
|
||||
- `GET /api/after-sales/refunds/:id` - 获取退款详情
|
||||
- `GET /api/after-sales/tickets` - 获取工单列表
|
||||
- `POST /api/after-sales/tickets` - 创建工单
|
||||
- `GET /api/after-sales/tickets/:id` - 获取工单详情
|
||||
- `PUT /api/after-sales/tickets/:id/status` - 更新工单状态
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [ ] 退货处理接口能正确处理退货申请
|
||||
- [ ] 退款流程引擎能准确执行退款流程
|
||||
- [ ] 售后工单系统能有效管理售后工单
|
||||
- [ ] 所有接口响应时间不超过1.5秒
|
||||
- [ ] 数据一致性得到保证
|
||||
|
||||
## 测试要求
|
||||
|
||||
- [ ] 单元测试:覆盖退货和退款逻辑
|
||||
- [ ] 集成测试:验证与订单系统的交互
|
||||
- [ ] 端到端测试:模拟完整的售后流程
|
||||
- [ ] 边界测试:测试异常数据和边界情况
|
||||
|
||||
## 风险提示
|
||||
|
||||
- **风险点1**:退款操作风险 - 应对措施:实现审批流程和限额控制
|
||||
- **风险点2**:售后工单积压 - 应对措施:实现工单优先级和自动分配
|
||||
- **风险点3**:退货原因分析不准确 - 应对措施:建立退货原因分类和分析机制
|
||||
|
||||
## 性能要求
|
||||
|
||||
- 响应时间:平均响应时间 < 1.5秒
|
||||
- 并发处理:支持150个并发请求
|
||||
- 数据处理:能处理5000条售后记录/小时
|
||||
|
||||
## 安全要求
|
||||
|
||||
- 权限控制:只有CUSTOMER_SERVICE和ADMIN角色可访问售后数据
|
||||
- 审计日志:所有售后操作需记录详细日志
|
||||
- 输入验证:严格验证所有售后相关输入
|
||||
- 数据一致性:确保售后数据的准确性和一致性
|
||||
Reference in New Issue
Block a user