refactor(terminology): 统一术语标准并优化代码类型安全
- 将B2B统一为TOB术语 - 将状态值统一为大写格式 - 优化类型声明,避免使用any - 将float类型替换为decimal以提高精度 - 新增术语标准化文档 - 优化路由结构和菜单分类 - 添加TypeORM实体类 - 增强加密模块安全性 - 重构前端路由结构 - 完善任务模板和验收标准
This commit is contained in:
@@ -2,11 +2,11 @@
|
||||
|
||||
## 任务列表
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|
||||
| -------- | ------ | ------ | ---------- | ---- | ---- | ----------- | --- | -------- | ---- | ------------ |
|
||||
| BE-SR001 | 售后逆向闭环 | 退货处理接口 | 订单ID, 退货原因 | 退货ID | 前端提交 | ✅ completed | P0 | - | 12h | AI-Backend-5 |
|
||||
| BE-SR002 | 售后逆向闭环 | 退款流程引擎 | 退货ID, 审批结果 | 退款状态 | 审批完成 | ✅ completed | P0 | BE-SR001 | 14h | AI-Backend-5 |
|
||||
| BE-SR003 | 售后逆向闭环 | 售后工单系统 | 退货ID, 工单信息 | 工单ID | 退货创建 | ✅ completed | P0 | BE-SR001 | 16h | AI-Backend-5 |
|
||||
| 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 |
|
||||
|
||||
## 相关闭环
|
||||
|
||||
@@ -14,6 +14,94 @@
|
||||
|
||||
## 依赖关系
|
||||
|
||||
- BE-SR001 是基础任务,无依赖
|
||||
- BE-SR002 依赖 BE-SR001
|
||||
- BE-SR003 依赖 BE-SR001
|
||||
```
|
||||
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