305 lines
8.4 KiB
Markdown
305 lines
8.4 KiB
Markdown
|
# WMS 微服务实现总结
|
|||
|
|
|
|||
|
|
## ✅ 已完成的工作
|
|||
|
|
|
|||
|
|
### 1️⃣ 基础服务 (cpte-wms-basic-service)
|
|||
|
|
|
|||
|
|
#### Entity 实体类（4 个）
|
|||
|
|
- ✅ `Item.java` - 物料实体
|
|||
|
|
- ✅ `Area.java` - 库区实体
|
|||
|
|
- ✅ `Point.java` - 库位实体
|
|||
|
|
- ✅ `Container.java` - 容器实体
|
|||
|
|
|
|||
|
|
#### Mapper 接口（4 个）
|
|||
|
|
- ✅ `ItemMapper.java`
|
|||
|
|
- ✅ `AreaMapper.java`
|
|||
|
|
- ✅ `PointMapper.java`
|
|||
|
|
- ✅ `ContainerMapper.java`
|
|||
|
|
|
|||
|
|
#### Service 接口和实现（8 个）
|
|||
|
|
- ✅ `IItemService.java` + `ItemServiceImpl.java`
|
|||
|
|
- ✅ `IAreaService.java` + `AreaServiceImpl.java`
|
|||
|
|
- ✅ `IPointService.java` + `PointServiceImpl.java`
|
|||
|
|
- ✅ `IContainerService.java` + `ContainerServiceImpl.java`
|
|||
|
|
|
|||
|
|
#### Controller（1 个已完成）
|
|||
|
|
- ✅ `ItemController.java` - 物料管理（增删改查、分页查询）
|
|||
|
|
|
|||
|
|
### 2️⃣ 入库服务 (cpte-wms-service\cpte-wms-inbound-service)
|
|||
|
|
|
|||
|
|
待实现：
|
|||
|
|
- ⏳ 入库单 Entity
|
|||
|
|
- ⏳ 入库单 DTO
|
|||
|
|
- ⏳ 入库单 Controller
|
|||
|
|
- ⏳ Feign 调用基础服务
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📋 接下来要实现的内容
|
|||
|
|
|
|||
|
|
### 第一步：完成基础服务的 Controller
|
|||
|
|
|
|||
|
|
1. **AreaController** - 库区管理
|
|||
|
|
- 新增库区
|
|||
|
|
- 修改库区
|
|||
|
|
- 删除库区
|
|||
|
|
- 查询库区（分页、详情）
|
|||
|
|
|
|||
|
|
2. **PointController** - 库位管理
|
|||
|
|
- 新增库位
|
|||
|
|
- 修改库位
|
|||
|
|
- 删除库位
|
|||
|
|
- 查询库位（分页、详情）
|
|||
|
|
|
|||
|
|
3. **ContainerController** - 容器管理
|
|||
|
|
- 新增容器
|
|||
|
|
- 修改容器
|
|||
|
|
- 删除容器
|
|||
|
|
- 查询容器（分页、详情）
|
|||
|
|
|
|||
|
|
### 第二步：实现入库服务
|
|||
|
|
|
|||
|
|
1. **创建入库单 Entity**
|
|||
|
|
- 入库单主表
|
|||
|
|
- 入库单明细表
|
|||
|
|
|
|||
|
|
2. **创建 Feign Client**
|
|||
|
|
- 调用基础服务查询物料
|
|||
|
|
- 调用基础服务查询库位
|
|||
|
|
|
|||
|
|
3. **实现入库 Controller**
|
|||
|
|
- 新增入库单
|
|||
|
|
- 审核入库单
|
|||
|
|
- 执行入库
|
|||
|
|
- 查询入库单
|
|||
|
|
|
|||
|
|
### 第三步：数据库建表脚本
|
|||
|
|
|
|||
|
|
创建 SQL 建表脚本，包括：
|
|||
|
|
- wms_basic_item（物料表）
|
|||
|
|
- wms_basic_area（库区表）
|
|||
|
|
- wms_basic_point（库位表）
|
|||
|
|
- wms_basic_container（容器表）
|
|||
|
|
- wms_inbound_order（入库单主表）
|
|||
|
|
- wms_inbound_order_detail（入库单明细表）
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🎯 业务流程说明
|
|||
|
|
|
|||
|
|
### 入库业务流程
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
1. 创建入库单
|
|||
|
|
↓
|
|||
|
|
2. 调用基础服务查询物料信息（验证物料是否存在）
|
|||
|
|
↓
|
|||
|
|
3. 调用基础服务查询库位信息（验证库位是否存在）
|
|||
|
|
↓
|
|||
|
|
4. 保存入库单
|
|||
|
|
↓
|
|||
|
|
5. 审核入库单
|
|||
|
|
↓
|
|||
|
|
6. 执行入库（调用库存服务增加库存）
|
|||
|
|
↓
|
|||
|
|
7. 调用调度服务创建 AGV 上架任务
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Feign 服务间调用
|
|||
|
|
|
|||
|
|
```java
|
|||
|
|
// 入库服务中通过 Feign 调用基础服务
|
|||
|
|
@Autowired
|
|||
|
|
private BasicServiceClient basicServiceClient;
|
|||
|
|
|
|||
|
|
// 查询物料信息
|
|||
|
|
Result<Item> itemResult = basicServiceClient.getItemById(itemId);
|
|||
|
|
if (!itemResult.isSuccess()) {
|
|||
|
|
return Result.error("物料不存在");
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 查询库位信息
|
|||
|
|
Result<Point> pointResult = basicServiceClient.getPointById(pointId);
|
|||
|
|
if (!pointResult.isSuccess()) {
|
|||
|
|
return Result.error("库位不存在");
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📊 数据库表结构（待创建）
|
|||
|
|
|
|||
|
|
### 基础数据表
|
|||
|
|
|
|||
|
|
```sql
|
|||
|
|
-- 物料表
|
|||
|
|
CREATE TABLE wms_basic_item (
|
|||
|
|
id VARCHAR(64) PRIMARY KEY,
|
|||
|
|
item_code VARCHAR(50) NOT NULL COMMENT '物料编码',
|
|||
|
|
item_name VARCHAR(100) NOT NULL COMMENT '物料名称',
|
|||
|
|
item_spec VARCHAR(100) COMMENT '规格型号',
|
|||
|
|
item_model VARCHAR(100) COMMENT '物料模型',
|
|||
|
|
item_unit VARCHAR(20) COMMENT '单位',
|
|||
|
|
item_category VARCHAR(50) COMMENT '物料分类',
|
|||
|
|
item_brand VARCHAR(50) COMMENT '品牌',
|
|||
|
|
safe_stock INT DEFAULT 0 COMMENT '安全库存',
|
|||
|
|
min_stock INT DEFAULT 0 COMMENT '最小库存',
|
|||
|
|
max_stock INT DEFAULT 0 COMMENT '最大库存',
|
|||
|
|
status INT DEFAULT 1 COMMENT '状态',
|
|||
|
|
remark VARCHAR(500) COMMENT '备注',
|
|||
|
|
create_by VARCHAR(50),
|
|||
|
|
create_time DATETIME,
|
|||
|
|
update_by VARCHAR(50),
|
|||
|
|
update_time DATETIME,
|
|||
|
|
del_flag INT DEFAULT 0
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
-- 库区表
|
|||
|
|
CREATE TABLE wms_basic_area (
|
|||
|
|
id VARCHAR(64) PRIMARY KEY,
|
|||
|
|
area_code VARCHAR(50) NOT NULL,
|
|||
|
|
area_name VARCHAR(100) NOT NULL,
|
|||
|
|
area_type INT COMMENT '库区类型',
|
|||
|
|
warehouse_code VARCHAR(50),
|
|||
|
|
warehouse_name VARCHAR(100),
|
|||
|
|
manager VARCHAR(50),
|
|||
|
|
phone VARCHAR(20),
|
|||
|
|
area_size DOUBLE COMMENT '面积',
|
|||
|
|
capacity INT COMMENT '库容',
|
|||
|
|
status INT DEFAULT 1,
|
|||
|
|
remark VARCHAR(500),
|
|||
|
|
create_by VARCHAR(50),
|
|||
|
|
create_time DATETIME,
|
|||
|
|
update_by VARCHAR(50),
|
|||
|
|
update_time DATETIME,
|
|||
|
|
del_flag INT DEFAULT 0
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
-- 库位表
|
|||
|
|
CREATE TABLE wms_basic_point (
|
|||
|
|
id VARCHAR(64) PRIMARY KEY,
|
|||
|
|
point_code VARCHAR(50) NOT NULL,
|
|||
|
|
point_name VARCHAR(100) NOT NULL,
|
|||
|
|
point_type INT COMMENT '库位类型',
|
|||
|
|
area_code VARCHAR(50),
|
|||
|
|
area_name VARCHAR(100),
|
|||
|
|
warehouse_code VARCHAR(50),
|
|||
|
|
warehouse_name VARCHAR(100),
|
|||
|
|
row VARCHAR(20) COMMENT '排',
|
|||
|
|
column VARCHAR(20) COMMENT '列',
|
|||
|
|
level VARCHAR(20) COMMENT '层',
|
|||
|
|
max_length DOUBLE COMMENT '最大长度',
|
|||
|
|
max_width DOUBLE COMMENT '最大宽度',
|
|||
|
|
max_height DOUBLE COMMENT '最大高度',
|
|||
|
|
max_weight DOUBLE COMMENT '最大重量',
|
|||
|
|
current_stock INT DEFAULT 0 COMMENT '当前库存',
|
|||
|
|
status INT DEFAULT 1,
|
|||
|
|
remark VARCHAR(500),
|
|||
|
|
create_by VARCHAR(50),
|
|||
|
|
create_time DATETIME,
|
|||
|
|
update_by VARCHAR(50),
|
|||
|
|
update_time DATETIME,
|
|||
|
|
del_flag INT DEFAULT 0
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
-- 容器表
|
|||
|
|
CREATE TABLE wms_basic_container (
|
|||
|
|
id VARCHAR(64) PRIMARY KEY,
|
|||
|
|
container_code VARCHAR(50) NOT NULL,
|
|||
|
|
container_name VARCHAR(100) NOT NULL,
|
|||
|
|
container_type INT COMMENT '容器类型',
|
|||
|
|
container_spec VARCHAR(100) COMMENT '容器规格',
|
|||
|
|
length DOUBLE COMMENT '长度',
|
|||
|
|
width DOUBLE COMMENT '宽度',
|
|||
|
|
height DOUBLE COMMENT '高度',
|
|||
|
|
self_weight DOUBLE COMMENT '自重',
|
|||
|
|
max_weight DOUBLE COMMENT '最大载重',
|
|||
|
|
material INT COMMENT '材质',
|
|||
|
|
color VARCHAR(20) COMMENT '颜色',
|
|||
|
|
supplier VARCHAR(100) COMMENT '供应商',
|
|||
|
|
status INT DEFAULT 1,
|
|||
|
|
remark VARCHAR(500),
|
|||
|
|
create_by VARCHAR(50),
|
|||
|
|
create_time DATETIME,
|
|||
|
|
update_by VARCHAR(50),
|
|||
|
|
update_time DATETIME,
|
|||
|
|
del_flag INT DEFAULT 0
|
|||
|
|
);
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 入库业务表
|
|||
|
|
|
|||
|
|
```sql
|
|||
|
|
-- 入库单主表
|
|||
|
|
CREATE TABLE wms_inbound_order (
|
|||
|
|
id VARCHAR(64) PRIMARY KEY,
|
|||
|
|
order_no VARCHAR(50) NOT NULL COMMENT '入库单号',
|
|||
|
|
order_type INT COMMENT '入库类型',
|
|||
|
|
source_type INT COMMENT '来源类型',
|
|||
|
|
source_no VARCHAR(50) COMMENT '来源单号',
|
|||
|
|
warehouse_code VARCHAR(50) COMMENT '仓库编码',
|
|||
|
|
warehouse_name VARCHAR(100) COMMENT '仓库名称',
|
|||
|
|
total_quantity INT DEFAULT 0 COMMENT '总数量',
|
|||
|
|
total_boxes INT DEFAULT 0 COMMENT '总箱数',
|
|||
|
|
status INT DEFAULT 0 COMMENT '状态',
|
|||
|
|
supplier_code VARCHAR(50) COMMENT '供应商编码',
|
|||
|
|
supplier_name VARCHAR(100) COMMENT '供应商名称',
|
|||
|
|
arrival_date DATETIME COMMENT '到货日期',
|
|||
|
|
plan_inbound_date DATETIME COMMENT '计划入库日期',
|
|||
|
|
actual_inbound_date DATETIME COMMENT '实际入库日期',
|
|||
|
|
remark VARCHAR(500) COMMENT '备注',
|
|||
|
|
create_by VARCHAR(50),
|
|||
|
|
create_time DATETIME,
|
|||
|
|
update_by VARCHAR(50),
|
|||
|
|
update_time DATETIME,
|
|||
|
|
del_flag INT DEFAULT 0
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
-- 入库单明细表
|
|||
|
|
CREATE TABLE wms_inbound_order_detail (
|
|||
|
|
id VARCHAR(64) PRIMARY KEY,
|
|||
|
|
order_id VARCHAR(64) NOT NULL COMMENT '入库单 ID',
|
|||
|
|
order_no VARCHAR(50) NOT NULL COMMENT '入库单号',
|
|||
|
|
item_id VARCHAR(64) NOT NULL COMMENT '物料 ID',
|
|||
|
|
item_code VARCHAR(50) NOT NULL COMMENT '物料编码',
|
|||
|
|
item_name VARCHAR(100) NOT NULL COMMENT '物料名称',
|
|||
|
|
item_spec VARCHAR(100) COMMENT '规格',
|
|||
|
|
expected_quantity INT NOT NULL COMMENT '应收数量',
|
|||
|
|
actual_quantity INT DEFAULT 0 COMMENT '实收数量',
|
|||
|
|
unit VARCHAR(20) COMMENT '单位',
|
|||
|
|
batch_no VARCHAR(50) COMMENT '批次号',
|
|||
|
|
production_date DATETIME COMMENT '生产日期',
|
|||
|
|
expiry_date DATETIME COMMENT '有效期',
|
|||
|
|
point_id VARCHAR(64) COMMENT '库位 ID',
|
|||
|
|
point_code VARCHAR(50) COMMENT '库位编码',
|
|||
|
|
status INT DEFAULT 0 COMMENT '状态',
|
|||
|
|
remark VARCHAR(500),
|
|||
|
|
create_by VARCHAR(50),
|
|||
|
|
create_time DATETIME,
|
|||
|
|
update_by VARCHAR(50),
|
|||
|
|
update_time DATETIME,
|
|||
|
|
del_flag INT DEFAULT 0
|
|||
|
|
);
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🚀 下一步行动
|
|||
|
|
|
|||
|
|
请告诉我是否需要我继续实现：
|
|||
|
|
|
|||
|
|
1. ✅ 基础服务的其他 Controller（Area、Point、Container）
|
|||
|
|
2. ✅ 入库服务的完整实现（Entity、DTO、Controller）
|
|||
|
|
3. ✅ Feign 调用集成
|
|||
|
|
4. ✅ 数据库建表脚本
|
|||
|
|
|
|||
|
|
或者你有其他优先级安排？
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📖 相关文档
|
|||
|
|
|
|||
|
|
- [ApiFox 测试指南](APIFOX_TEST_GUIDE.md)
|
|||
|
|
- [Feign 使用指南](FEIGN_USAGE.md)
|
|||
|
|
- [本地开发配置](LOCAL_DEV_FEIGN_CONFIG.md)
|