refactor: 优化代码结构并修复类型问题
- 移除未使用的TabPane组件 - 修复类型定义和导入方式 - 优化mock数据源的环境变量判断逻辑 - 更新文档结构并归档旧文件 - 添加新的UI组件和Memo组件 - 调整API路径和响应处理
This commit is contained in:
106
docs/SERVICES/order.md
Normal file
106
docs/SERVICES/order.md
Normal file
@@ -0,0 +1,106 @@
|
||||
# 订单域服务
|
||||
|
||||
> **入口**: [_index.md](_index.md)
|
||||
|
||||
---
|
||||
|
||||
## 服务列表
|
||||
|
||||
| 服务 | 文件 | 职责 |
|
||||
|------|------|------|
|
||||
| OrderService | services/OrderService.ts | 订单管理 |
|
||||
| FulfillmentService | services/FulfillmentService.ts | 订单履约 |
|
||||
| AfterSalesService | services/AfterSalesService.ts | 售后处理 |
|
||||
|
||||
---
|
||||
|
||||
## 核心流程
|
||||
|
||||
```
|
||||
订单创建 → 确认 → 处理 → 发货 → 送达 → 完成
|
||||
↓
|
||||
售后退货 ← ← ← ← ←
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## OrderService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| list | 订单列表 | ListParams | Order[] |
|
||||
| get | 订单详情 | id | Order |
|
||||
| create | 创建订单 | CreateRequest | Order |
|
||||
| update | 更新订单 | id, UpdateRequest | Order |
|
||||
| cancel | 取消订单 | id, reason | Order |
|
||||
| confirm | 确认订单 | id | Order |
|
||||
|
||||
---
|
||||
|
||||
## FulfillmentService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| create | 创建履约 | CreateRequest | Fulfillment |
|
||||
| ship | 发货 | id, trackingInfo | Fulfillment |
|
||||
| deliver | 送达 | id | Fulfillment |
|
||||
| getTracking | 获取物流 | id | TrackingInfo |
|
||||
|
||||
---
|
||||
|
||||
## AfterSalesService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| create | 创建售后 | CreateRequest | AfterSales |
|
||||
| approve | 批准 | id | AfterSales |
|
||||
| reject | 拒绝 | id, reason | AfterSales |
|
||||
| refund | 退款 | id | AfterSales |
|
||||
| return | 退货 | id, returnInfo | AfterSales |
|
||||
|
||||
---
|
||||
|
||||
## 状态机
|
||||
|
||||
```
|
||||
PENDING → CONFIRMED → PROCESSING → SHIPPED → DELIVERED → COMPLETED
|
||||
↓ ↓ ↓ ↓
|
||||
CANCELLED CANCELLED CANCELLED RETURNED
|
||||
```
|
||||
|
||||
| 状态 | 说明 | 允许操作 |
|
||||
|------|------|---------|
|
||||
| PENDING | 待处理 | 确认、取消 |
|
||||
| CONFIRMED | 已确认 | 处理、取消 |
|
||||
| PROCESSING | 处理中 | 发货、取消 |
|
||||
| SHIPPED | 已发货 | 送达、退货 |
|
||||
| DELIVERED | 已送达 | 完成、退货 |
|
||||
| COMPLETED | 已完成 | 售后 |
|
||||
| CANCELLED | 已取消 | - |
|
||||
| RETURNED | 已退货 | 退款 |
|
||||
|
||||
---
|
||||
|
||||
## API端点
|
||||
|
||||
| 端点 | 方法 | 服务方法 |
|
||||
|------|------|----------|
|
||||
| /api/v1/orders | GET | OrderService.list |
|
||||
| /api/v1/orders | POST | OrderService.create |
|
||||
| /api/v1/orders/:id | GET | OrderService.get |
|
||||
| /api/v1/orders/:id | PUT | OrderService.update |
|
||||
| /api/v1/orders/:id/cancel | POST | OrderService.cancel |
|
||||
| /api/v1/orders/:id/confirm | POST | OrderService.confirm |
|
||||
| /api/v1/orders/:id/fulfill | POST | FulfillmentService.create |
|
||||
| /api/v1/orders/:id/ship | POST | FulfillmentService.ship |
|
||||
| /api/v1/orders/:id/after-sales | POST | AfterSalesService.create |
|
||||
|
||||
---
|
||||
|
||||
*最后更新: 2026-03-22*
|
||||
Reference in New Issue
Block a user