111 lines
3.0 KiB
Markdown
111 lines
3.0 KiB
Markdown
# 04 WMS 领域模型
|
|
|
|
## 业务编码优先
|
|
|
|
业务系统尽量使用明确的业务编码：
|
|
|
|
| 编码 | 含义 |
|
|
| --- | --- |
|
|
| tenant_code | 租户 |
|
|
| warehouse_code | 仓库 |
|
|
| location_code | 库位 |
|
|
| customer_code | 客户 |
|
|
| supplier_code | 供应商 |
|
|
| product_code | 商品 |
|
|
| sku_code | SKU |
|
|
| order_no | 订单 |
|
|
| inbound_no | 入库单 |
|
|
| outbound_no | 出库单 |
|
|
| picking_no | 拣货单 |
|
|
| shipment_no | 发货单 |
|
|
| package_no | 包裹 |
|
|
|
|
不要让业务逻辑全部依赖数据库自增 ID。数据库 ID 可以作为内部主键，但业务关联应优先考虑业务编码。
|
|
|
|
## 业务模块（第一阶段设计）
|
|
|
|
### 1. SaaS
|
|
租户、用户、角色、权限、租户设置、操作日志
|
|
|
|
### 2. 基础资料
|
|
客户、供应商、商品、SKU、SKU 条码、包装规格、重量、尺寸
|
|
|
|
### 3. 仓库
|
|
仓库、库区、库位、库位类型、库位容量、库位策略
|
|
|
|
### 4. 入库
|
|
入库单、入库明细、收货、收货差异、质检、上架、入库流水
|
|
|
|
### 5. 出库
|
|
出库单、出库明细、库存分配、波次、拣货任务、复核、打包、发货
|
|
|
|
### 6. 库存
|
|
库存查询、库存余额、库存流水、库存锁定、库存调整、库存盘点、库存冻结、库存解冻、库存预警
|
|
|
|
### 7. 退货
|
|
退货单、退货收货、退货质检、重新入库、报废
|
|
|
|
### 8. 物流
|
|
物流渠道、承运商、物流服务、运费规则、面单、发货、Tracking
|
|
|
|
### 9. 报表
|
|
库存报表、入库报表、出库报表、库存周转、SKU 销量、仓库作业统计
|
|
|
|
### 10. AI / 数据分析（预留 Python 服务接口）
|
|
库存分析、SKU 销量分析、缺货预测、补货建议、库存周转分析、异常库存、AI WMS Assistant
|
|
|
|
## 订单模型
|
|
|
|
WMS 不应和某一个电商平台强绑定，订单应抽象为统一订单模型，例如：
|
|
|
|
- order
|
|
- order_item
|
|
- order_source
|
|
- order_status
|
|
- order_external_no
|
|
- order_channel
|
|
|
|
以后可以支持：Amazon、Shopify、TikTok Shop、Temu、Shopee、Mirakl、ERP、API、手工订单。
|
|
|
|
**不要在核心订单表中写死 Amazon / TikTok 等平台业务逻辑。**
|
|
|
|
## 第三方平台架构
|
|
|
|
第三方平台必须采用 **Adapter / Connector** 思路：
|
|
|
|
```
|
|
MarketplaceConnector (接口)
|
|
├── AmazonConnector
|
|
├── ShopifyConnector
|
|
├── MiraklConnector
|
|
└── TikTokShopConnector
|
|
```
|
|
|
|
以后增加平台时，不应该修改大量核心 WMS 代码。核心 WMS 只关心：
|
|
|
|
- 统一订单
|
|
- 统一 SKU
|
|
- 统一库存
|
|
- 统一物流
|
|
- 统一状态
|
|
|
|
平台实现放在 `app/Infrastructure/Platforms/{Platform}/`，负责平台数据与统一模型之间的映射。
|
|
|
|
## 状态机
|
|
|
|
入库、出库、订单、库存任务不要到处使用：
|
|
|
|
```php
|
|
if ($status == xxx)
|
|
```
|
|
|
|
应设计明确的状态流转。例如出库：
|
|
|
|
```
|
|
draft → allocated → picking → picked → packing → packed → shipped → completed
|
|
```
|
|
|
|
- 状态使用 PHP Enum 定义，禁止魔法字符串。
|
|
- 允许的状态转换集中定义，**非法状态转换必须被阻止**。
|
|
- 状态变更需记录日志（谁、何时、从何状态到何状态）。
|