refactor(terminology): 统一术语标准并优化代码类型安全

- 将B2B统一为TOB术语
- 将状态值统一为大写格式
- 优化类型声明,避免使用any
- 将float类型替换为decimal以提高精度
- 新增术语标准化文档
- 优化路由结构和菜单分类
- 添加TypeORM实体类
- 增强加密模块安全性
- 重构前端路由结构
- 完善任务模板和验收标准
This commit is contained in:
2026-03-20 09:43:50 +08:00
parent eafa1bbe94
commit 48a78137c5
132 changed files with 13767 additions and 2140 deletions

View File

@@ -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角色可访问售后数据
- 审计日志:所有售后操作需记录详细日志
- 输入验证:严格验证所有售后相关输入
- 数据一致性:确保售后数据的准确性和一致性