refactor: 优化代码结构并修复类型问题
- 移除未使用的TabPane组件 - 修复类型定义和导入方式 - 优化mock数据源的环境变量判断逻辑 - 更新文档结构并归档旧文件 - 添加新的UI组件和Memo组件 - 调整API路径和响应处理
This commit is contained in:
105
docs/SERVICES/inventory.md
Normal file
105
docs/SERVICES/inventory.md
Normal file
@@ -0,0 +1,105 @@
|
||||
# 库存域服务
|
||||
|
||||
> **入口**: [_index.md](_index.md)
|
||||
|
||||
---
|
||||
|
||||
## 服务列表
|
||||
|
||||
| 服务 | 文件 | 职责 |
|
||||
|------|------|------|
|
||||
| InventoryService | services/InventoryService.ts | 库存管理 |
|
||||
| WarehouseService | services/WarehouseService.ts | 仓库管理 |
|
||||
| ReplenishmentService | services/ReplenishmentService.ts | 补货管理 |
|
||||
|
||||
---
|
||||
|
||||
## 核心流程
|
||||
|
||||
```
|
||||
库存查询 → 库存调整 → 库存预警 → 自动补货
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## InventoryService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| list | 库存列表 | ListParams | Inventory[] |
|
||||
| get | 库存详情 | skuId | Inventory |
|
||||
| updateStock | 更新库存 | skuId, quantity, type | Inventory |
|
||||
| reserve | 预留库存 | skuId, quantity | Inventory |
|
||||
| release | 释放预留 | skuId, quantity | Inventory |
|
||||
|
||||
### 库存操作类型
|
||||
|
||||
| 类型 | 说明 |
|
||||
|------|------|
|
||||
| IN | 入库 |
|
||||
| OUT | 出库 |
|
||||
| ADJUST | 调整 |
|
||||
| RESERVE | 预留 |
|
||||
| RELEASE | 释放 |
|
||||
|
||||
---
|
||||
|
||||
## WarehouseService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| list | 仓库列表 | tenantId | Warehouse[] |
|
||||
| get | 仓库详情 | id | Warehouse |
|
||||
| create | 创建仓库 | CreateRequest | Warehouse |
|
||||
| update | 更新仓库 | id, UpdateRequest | Warehouse |
|
||||
|
||||
---
|
||||
|
||||
## ReplenishmentService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| checkAlert | 检查预警 | tenantId | Alert[] |
|
||||
| createOrder | 创建补货单 | CreateRequest | ReplenishmentOrder |
|
||||
| getOrder | 获取补货单 | id | ReplenishmentOrder |
|
||||
|
||||
---
|
||||
|
||||
## 状态机
|
||||
|
||||
```
|
||||
IN_STOCK → LOW_STOCK → OUT_OF_STOCK
|
||||
↑ ↓ ↓
|
||||
└───────────┴────────────┘
|
||||
(补货后恢复)
|
||||
```
|
||||
|
||||
| 状态 | 说明 | 触发条件 |
|
||||
|------|------|---------|
|
||||
| IN_STOCK | 有库存 | quantity > threshold |
|
||||
| LOW_STOCK | 低库存 | quantity ≤ threshold |
|
||||
| OUT_OF_STOCK | 缺货 | quantity = 0 |
|
||||
| RESERVED | 预留 | 有预留数量 |
|
||||
|
||||
---
|
||||
|
||||
## API端点
|
||||
|
||||
| 端点 | 方法 | 服务方法 |
|
||||
|------|------|----------|
|
||||
| /api/v1/inventory | GET | InventoryService.list |
|
||||
| /api/v1/inventory/:skuId | GET | InventoryService.get |
|
||||
| /api/v1/inventory/:skuId/stock | PUT | InventoryService.updateStock |
|
||||
| /api/v1/warehouses | GET | WarehouseService.list |
|
||||
| /api/v1/warehouses | POST | WarehouseService.create |
|
||||
| /api/v1/replenishment/alerts | GET | ReplenishmentService.checkAlert |
|
||||
|
||||
---
|
||||
|
||||
*最后更新: 2026-03-22*
|
||||
Reference in New Issue
Block a user