增加线边仓取消任务
This commit is contained in:
1 parent
7c2722c88d
commit
db202e16e1
5 files changed
+471
No files matched your search
@@ -0,0 +1,117 @@
|
||||
# 线边库零库存占用库位:取消入库任务——实施方案
|
||||
|
||||
## 1. 范围与结论
|
||||
|
||||
- 目标:处理线边库长期未完成入库任务造成的零库存、托盘和库位持续占用。
|
||||
- 操作方式:复用任务列表原有“取消任务”按钮,增加确认页,一次点击完成取消。
|
||||
- WCS要求:已下发任务必须先由WCS确认仍处于“任务创建”状态并删除成功,WMS才释放占用。
|
||||
- 数据库:本事项没有表结构和初始化数据变更,不需要上线DDL/DML。
|
||||
- 修改范围:WMS两个文件,WCS一个文件,不调整入库创建、WCS执行和任务完成主流程。
|
||||
|
||||
## 2. 原占用逻辑
|
||||
|
||||
线边库入库任务创建成功后,会同时产生以下占用:
|
||||
|
||||
| 对象 | 普通入库 | 空托入库 |
|
||||
| --- | --- | --- |
|
||||
| `TaskHeader` | 新增入库任务 | 新增入库任务 |
|
||||
| `Inventory` | 新增数量尚未计算的锁定库存 | 不新增库存 |
|
||||
| `Container.IsLock` | `任务锁` | `任务锁` |
|
||||
| `Container.Status` | `有` | `空` |
|
||||
| `Container.LocationCode` | 目标库位 | 目标库位 |
|
||||
| `Location.Status` | `锁定` | `锁定` |
|
||||
| `Location.ContainerStatus` | `有货` | `空仓位` |
|
||||
| `Location.ContainerCode` | 托盘号 | 托盘号 |
|
||||
|
||||
任务未完成时,上述数据不会进入完成回调,因此目标库位会一直被占用。
|
||||
|
||||
## 3. 取消流程
|
||||
|
||||
```text
|
||||
任务列表选择一条任务
|
||||
→ 点击“取消任务”
|
||||
→ 确认任务、库存、托盘和库位状态
|
||||
→ 已下发:调用WCS TaskCancel
|
||||
→ WCS任务未开始:删除WCS任务并返回成功
|
||||
→ WMS事务内删除零库存、释放托盘和库位、删除任务
|
||||
→ 刷新任务列表
|
||||
```
|
||||
|
||||
`新建`、`待下发`状态不调用WCS;`已下发`状态必须先取得WCS成功响应。WCS无响应、返回失败或任务已开始执行时,WMS不清理任何数据。
|
||||
|
||||
## 4. WMS取消条件
|
||||
|
||||
取消入口只处理以下任务:
|
||||
|
||||
1. `ZoneId=1027`,即线边库。
|
||||
2. `RoadWay=1`。
|
||||
3. `TaskType=入库`。
|
||||
4. 状态为 `新建`、`待下发`或`已下发`。
|
||||
5. 不存在 `TaskDetail`。
|
||||
6. 托盘下的库存全部属于当前库区和目标库位、处于任务锁、`Qty`为空或0。
|
||||
7. 普通入库的托盘/库位必须保持“有货”状态,空托入库必须保持“空”状态。
|
||||
8. 托盘必须保持任务锁并绑定目标库位;目标库位必须保持锁定并绑定该托盘。
|
||||
|
||||
任一条件不满足时直接提示人工排查,不调用WCS、不删除任务、不修改库存和占用状态。
|
||||
|
||||
## 5. WCS接口
|
||||
|
||||
- 地址:`POST /api/WCS/TaskCancel`
|
||||
- 请求:
|
||||
|
||||
```json
|
||||
{
|
||||
"TaskNo": "WMS任务号"
|
||||
}
|
||||
```
|
||||
|
||||
- 响应:沿用WCS现有 `BllResult`,WMS读取 `Success` 和 `Msg`。
|
||||
- WCS处理:复用 `BaseBll.TaskCancel`,按 `tNo_WMS` 查找任务;只有 `NowState=任务创建` 时删除WCS任务表记录和内存任务。
|
||||
- 已执行任务:返回“任务已经执行无法取消”,WMS保留全部数据。
|
||||
- 未找到任务:按“已取消”返回成功,使重复取消和历史孤立WMS任务可以继续释放占用。
|
||||
|
||||
## 6. WMS成功恢复内容
|
||||
|
||||
| 对象 | 恢复动作 |
|
||||
| --- | --- |
|
||||
| 零库存 | 删除该托盘下通过校验的零库存记录 |
|
||||
| 托盘 | 清空 `LocationCode`,`IsLock=未锁` |
|
||||
| 托盘状态 | 普通入库保持 `有`;空托入库保持 `空` |
|
||||
| 目标库位 | 清空 `ContainerCode`,`Status=未锁`,`ContainerStatus=空仓位` |
|
||||
| 目标库位版本 | 生成新的 `Version`,避免继续使用旧并发版本 |
|
||||
| WMS任务 | 删除 `TaskHeader` |
|
||||
| 操作日志 | 记录任务号和清理的零库存条数 |
|
||||
|
||||
所有WMS恢复动作位于同一数据库事务内。任何数据库异常都会回滚WMS侧修改。
|
||||
|
||||
## 7. 代码影响
|
||||
|
||||
WMS仓库:
|
||||
|
||||
- `TaskHeaderController.Cancel`:增加确认和取消处理。
|
||||
- `TaskHeaderController.TryCancelWcsTask`:调用线边库WCS取消接口。
|
||||
- `TaskHeader/Cancel.cshtml`:增加一键确认页面。
|
||||
|
||||
任务列表中的“取消任务”动作和中文资源原本已经存在,因此没有修改列表ViewModel、菜单、资源文件或数据库权限数据。
|
||||
|
||||
WCS仓库:
|
||||
|
||||
- `WcsWebApiController.TaskCancel`:增加接口入口和最小请求模型。
|
||||
- 删除逻辑直接复用已有 `BaseBll.TaskCancel`,没有修改设备执行、状态推进和PLC逻辑。
|
||||
|
||||
## 8. 上线与回退
|
||||
|
||||
上线顺序:
|
||||
|
||||
1. 先发布线边库WCS,确认 `/api/WCS/TaskCancel` 可访问。
|
||||
2. 确认WMS正式配置存在 `Domains:WCSXB`,且地址以 `/api/WCS/` 结尾。
|
||||
3. 再发布WMS。
|
||||
4. 先选择一条确认未开始执行的测试任务验证,再处理历史任务。
|
||||
|
||||
当前仓库 `appsettings.json` 仅保留旧的 `WCS` 示例键,但现有线边库任务下发代码同样使用 `WCSXB`。本事项沿用现有调用方式,不擅自修改生产地址;发布时必须核对部署配置。
|
||||
|
||||
回退时先回退或停用WMS取消入口,再回退WCS接口。没有数据库结构需要回退。
|
||||
|
||||
如果WCS已删除任务后WMS数据库提交发生异常,可以重新执行取消;WCS任务不存在时会返回成功,WMS重新校验库存、托盘和库位状态后继续处理。
|
||||
|
||||
由于“WCS未找到任务”按成功处理,操作人员仍应只对确认未完成、现场没有正在搬运的历史任务执行取消;已存在且已经开始执行的WCS任务仍会明确拒绝。
|
||||
@@ -0,0 +1,99 @@
|
||||
# 线边库零库存占用库位:取消入库任务——测试报告
|
||||
|
||||
## 1. 测试信息
|
||||
|
||||
- 日期:2026-07-18
|
||||
- WMS分支:`yfwms`
|
||||
- WCS分支:`master`
|
||||
- WMS数据库:本地 `wms_yongfeng_xb`
|
||||
- 测试方式:代码审查、项目构建、真实数据只读核查、临时表取消演练
|
||||
- 数据保护:未修改、删除真实业务任务、库存、托盘和库位数据
|
||||
|
||||
## 2. 测试结果
|
||||
|
||||
| 编号 | 场景 | 结果 |
|
||||
| --- | --- | --- |
|
||||
| T01 | WMS待提交范围 | 通过;仅取消控制器、确认页和本事项文档/SQL |
|
||||
| T02 | WCS待提交范围 | 通过;仅 `WcsWebApiController` 新增取消接口 |
|
||||
| T03 | WMS项目构建 | 通过;0错误,15个现有警告 |
|
||||
| T04 | Razor确认页编译 | 通过;随WMS项目构建成功 |
|
||||
| T05 | WCS请求为空或任务号为空 | 源码核查通过;接口直接返回失败,不进入删除逻辑 |
|
||||
| T06 | WCS任务仍为“任务创建” | 源码核查通过;按WCS任务号条件删除数据库任务和内存任务,不依赖实体主键 |
|
||||
| T07 | WCS任务已开始执行 | 源码核查通过;`NowState!=任务创建` 时返回失败 |
|
||||
| T08 | WCS未找到任务 | 源码核查通过;按“已取消”返回成功,WMS可继续释放历史占用 |
|
||||
| T09 | WCS无响应或返回失败 | 源码核查通过;WMS在调用返回成功前不执行库存、托盘、库位和任务清理 |
|
||||
| T10 | 非线边库/非入库/非允许状态 | 通过;WMS直接拒绝 |
|
||||
| T11 | 存在任务明细、非零库存或状态不一致 | 通过;WMS直接拒绝并提示排查 |
|
||||
| T12 | 任务并发取消 | 通过;WMS使用 `TaskHeader FOR UPDATE` 锁定任务行 |
|
||||
| T13 | WMS恢复事务 | 通过;零库存、托盘、库位和任务在同一事务内处理 |
|
||||
| T14 | 数据库脚本 | 通过;在本地执行5条语句成功,只包含 `SELECT` 和会话变量,无DDL/DML |
|
||||
| T15 | WCS项目完整构建 | 当前环境未执行;外部WCS仓库构建被沙箱禁止,列为正式发布前门槛 |
|
||||
|
||||
## 3. 本地数据核查
|
||||
|
||||
取消候选条件:`ZoneId=1027`、`RoadWay=1`、`TaskType=入库`、状态为新建/待下发/已下发。
|
||||
|
||||
```text
|
||||
候选任务 65条
|
||||
新建任务 2条
|
||||
待下发任务 0条
|
||||
已下发任务 63条
|
||||
普通入库任务 63条
|
||||
空托入库任务 2条
|
||||
通过全部取消前校验 65条
|
||||
```
|
||||
|
||||
65条任务均无任务明细;普通入库任务均关联零数量锁定库存;托盘、目标库位和任务绑定状态一致。
|
||||
|
||||
## 4. 临时表取消演练
|
||||
|
||||
以真实65条候选任务复制到MySQL临时表,在临时表中按代码顺序执行:删除零库存、释放托盘、释放目标库位、删除任务。
|
||||
|
||||
```text
|
||||
RemainingTasks: 0
|
||||
RemainingInventories: 0
|
||||
InvalidContainers: 0
|
||||
InvalidLocations: 0
|
||||
```
|
||||
|
||||
临时表随数据库连接关闭自动删除,真实业务表未发生更新或删除。
|
||||
|
||||
## 5. 兼容性与异常处理
|
||||
|
||||
- 原入库创建、WCS任务下发、WCS完成回调没有修改。
|
||||
- 新建和待下发任务不调用WCS;已下发任务必须由WCS先取消成功。
|
||||
- WCS任务已执行、接口异常或无响应时,WMS数据保持原样;WCS未找到任务时按已取消处理。
|
||||
- 库存存在实际数量、任务明细或托盘/库位状态被人工改动时,不自动修复,避免误删实际库存。
|
||||
- WCS接口复用已有任务状态和删除逻辑,没有增加新的设备状态。
|
||||
|
||||
## 6. 测试结论与上线门槛
|
||||
|
||||
WMS代码构建、现有数据校验和数据库恢复演练通过,取消范围和恢复结果符合需求。WCS接口逻辑与已有 `BaseBll.TaskCancel` 一致。
|
||||
|
||||
正式上线前必须满足:
|
||||
|
||||
1. WCS程序完成正式环境构建并先于WMS发布。
|
||||
2. 使用真实WCS创建一条不启动执行的任务,验证接口返回成功且任务消失。
|
||||
3. 使用一条已启动任务验证WCS拒绝,且WMS占用不变。
|
||||
4. 确认WMS部署配置中的 `WCSXB` 指向线边库WCS。
|
||||
|
||||
上述真实WCS联调涉及现场WCS运行状态,本地未启动设备执行程序,不能用本地数据库临时表替代。
|
||||
|
||||
## 7. 现场问题修复记录
|
||||
|
||||
2026-07-18首次现场调用发现WCS删除失败:
|
||||
|
||||
```text
|
||||
Where(entity) Primary key required
|
||||
SqlSugar.DeleteableProvider.Where(T deleteObj)
|
||||
```
|
||||
|
||||
原因是 `I_Task` 没有配置SqlSugar主键,取消逻辑错误使用了 `BaseDal.Delete(task)` 实体删除重载。
|
||||
|
||||
修复内容:
|
||||
|
||||
1. 改为 `Delete(x => x.tNo == task.tNo)` 条件删除,与任务强制删除和自动完成使用的方式一致。
|
||||
2. WCS找不到任务时按“任务不存在或已取消”返回成功,WMS继续释放历史占用。
|
||||
3. WCS仍能找到任务但 `NowState` 已不是“任务创建”时,继续返回失败,禁止删除已执行任务。
|
||||
|
||||
上线复测应确认:未执行任务删除成功;重复调用返回成功;已执行任务返回失败。
|
||||
Reference in new issue
Block a user