diff --git a/README.md b/README.md index 2b99446..edbe617 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,68 @@ -# wms_serve_nantong_yachi +### 立库入库 + +1. 通过`/wms/task/requireStockIn`接口发起入库请求 +2. 调用`TaskControllerServiceImpl::requireStockIn`服务 + * 校验请求体有效性 + * 空载具入库: + * 调用`StackerTaskServiceImpl::requestOneLocation`服务请求库位 + * 创建空载具入库任务 + * 物料入库 + * 循环物料列表 + * 同种物料合并请求 + * `key: goodsId, value: wmsTask`; 缓存所有物料的入库任务 + * 判断数量是否超载 + * 批量保存wms任务 + * **任务现状:** + * wms任务已创建, 任务状态: `WAIT(0, "初始化")` + * wcs任务未创建 + +3. `public class WmsTaskExecutor implements Job` && `public class JobServiceImpl implements IJobService` + * `WmsTaskExecutor`通过实现`Job`接口, 成为定时任务 + * `JobServiceImpl`通过实现`IJobService`接口, 成为定时任务服务, 从而定时扫描所有定时任务 + * 查询所有状态为`WAIT(0, "初始化")`的入库任务 + * 循环所有状态为`WAIT`的入库任务 + * 判断当前箱子是否已经解析成WCS任务并且已经存表 + * 判断当前箱子是否重复解析 + * 生成新的wcs入库任务, `key: vehicleId, value: wcsTask`缓存wcs入库任务 + * 批量保存wcs任务并更新wms任务状态 + * **任务现状:** + * wms任务已解析, 任务状态: `EXECUTED(1, "已解析")` + * wcs任务已创建, 任务状态: `INIT(0, "任务初始化")` + +4. `WcsStackerTaskSender`定时任务 + * 查询所有状态为`INIT`的wcs任务 + * 循环wcs任务列表 + * 生成请求体, 调用`WcsApiServiceImpl::sendWcsStackerTask`下发任务至堆垛机 + * 更新wcs与wms任务状态 + * **任务现状:** + * wcs任务已下发, 排队中, 任务状态: `WAIT(1, "任务排队中")` + * wms任务已下发, 任务状态: `SEND(2, "已下发")` + +5. 堆垛机完成入库任务, 反馈wcs, wcs回调wms接口`/wms/task/sendTaskResult`, 反馈任务状态 + * 查询对应的wcs任务 + * 转换堆垛机任务状态, 从回调的请求体wcs任务状态转换为wms任务状态 + * 若回调的请求体wcs任务状态为`FINISH(100, "任务完成")` + * 根据getWcsTaskId更新相应的 `(可能有多个wms任务状态被修改)` wms任务状态为`FINISH(4, "执行完成")` + * 移除wcs任务,并向wcs备份表添加记录 + * 若回调的请求体wcs任务状态非`FINISH(100, "任务完成")` + * 根据getWcsTaskId更新相应的 `(可能有多个wms任务状态被修改)` wms任务状态为堆垛机转换来的任务状态 + * 更新wcs的任务状态为请求体携带的任务状态 + * **任务现状:** + * 若堆垛机回调请求体携带任务状态非`FINISH(100, "任务完成")` + * wms任务正在执行, 任务状态: `RUN(3, "正在执行")` + * wcs任务正在执行, 任务状态: `RUN|LEAVE|MID|ARRIVE` + * 若堆垛机任务执行完成, 回调请求体任务状态为`FINISH(100, "任务完成")` + * wms任务执行完成, 任务状态`FINISH(4, "执行完成")` + * wcs任务执行完成, 任务状态`FINISH(100, "任务完成")`, **然后被移除任务** +6. `WmsTaskFinisher`定时任务 + * 获取所有任务状态为`FINISH(4, "执行完成")`的wms入库任务, 调用`StackerTaskServiceImpl::finishStackerInTasks`服务 + * 将wmsTask表中所有状态为`FINISH(4, "执行完成")`的任务提取键值对: `key: vehicleId, value: List` + * 根据`vehicleId`遍历键值对, 提取出`List` + * 遍历`List` + * 添加`WmsTask`到任务记录列表 + * 添加`WmsTask`到待删除任务列表 + * 添加库存到待添加库存列表 + * 更新载具信息, 库存信息, 库位工作状态 + * 批量保存任务记录 + * 批量删除入库记录 -南通亚驰WMS后端 \ No newline at end of file