diff --git a/HHWMS.Web/Areas/TaskManage/Controllers/TaskHeaderController.cs b/HHWMS.Web/Areas/TaskManage/Controllers/TaskHeaderController.cs index 688c936..4297bba 100644 --- a/HHWMS.Web/Areas/TaskManage/Controllers/TaskHeaderController.cs +++ b/HHWMS.Web/Areas/TaskManage/Controllers/TaskHeaderController.cs @@ -146,6 +146,169 @@ namespace HHWMS.Web.Controllers #endregion Delete + #region Cancel + + [ActionDescription("TaskHeader.Cancel")] + public ActionResult Cancel(string id) + { + var vm = Wtm.CreateVM(id); + return PartialView(vm); + } + + [HttpPost] + [ActionDescription("TaskHeader.Cancel")] + public ActionResult Cancel(string id, IFormCollection nouse) + { + if (!int.TryParse(id, out var taskId)) + { + return FFResult().CloseDialog().Alert("任务参数错误").RefreshGrid(); + } + + using (var transaction = DC.BeginTransaction()) + { + try + { + var task = DC.Set() + .FromSqlRaw("SELECT * FROM `TaskHeader` WHERE `ID` = {0} FOR UPDATE", taskId) + .AsNoTracking() + .SingleOrDefault(); + if (task == null) + { + return FFResult().CloseDialog().Alert("任务不存在或已被处理").RefreshGrid(); + } + + if (task.ZoneId != 1027 + || task.RoadWay != 1 + || task.TaskType != TaskTypeEnum.入库) + { + return FFResult().CloseDialog().Alert("仅允许取消线边库入库任务").RefreshGrid(); + } + + if (task.Status != TaskStatusEnum.新建 + && task.Status != TaskStatusEnum.待下发 + && task.Status != TaskStatusEnum.已下发) + { + return FFResult().CloseDialog().Alert("当前任务状态不允许取消").RefreshGrid(); + } + + if (_unitwork.IsExit(x => x.HeaderId == task.ID)) + { + return FFResult().CloseDialog().Alert("任务存在明细,不能使用此功能取消").RefreshGrid(); + } + + var inventories = _unitwork.Find(x => + x.ContainerCode == task.ContainerCode) + .ToList(); + if (inventories.Any(x => + x.ZoneId != task.ZoneId + || !SameCode(x.LocationCode, task.ToLocation) + || x.TaskStatus != InventoryTaskStatusEnum.Locked + || (x.Qty ?? 0) != 0)) + { + return FFResult().CloseDialog() + .Alert("托盘存在非零库存或库存状态不一致,不能取消") + .RefreshGrid(); + } + + var container = _unitwork.FindSingle(x => x.Code == task.ContainerCode); + var location = _unitwork.FindSingle(x => x.Code == task.ToLocation); + var hasInventory = inventories.Any(); + if (container == null + || location == null + || container.IsLock != ContainerLockEnum.任务锁 + || container.Status != (hasInventory ? ContainerStatus.有 : ContainerStatus.空) + || !SameCode(container.LocationCode, task.ToLocation) + || location.Status != LocationStatusEnum.锁定 + || location.ContainerStatus != (hasInventory ? LocationStatus.有货 : LocationStatus.空仓位) + || !SameCode(location.ContainerCode, task.ContainerCode)) + { + return FFResult().CloseDialog() + .Alert("托盘或库位状态与任务不一致,请先排查") + .RefreshGrid(); + } + + if (task.Status == TaskStatusEnum.已下发 + && !TryCancelWcsTask(task, out var wcsError)) + { + return FFResult().CloseDialog().Alert(wcsError).RefreshGrid(); + } + + var operatorCode = Wtm.LoginUserInfo?.ITCode ?? "WMS"; + var now = DateTime.Now; + if (inventories.Any()) + { + _unitwork.BatchDelete(inventories); + } + + container.LocationCode = string.Empty; + container.IsLock = ContainerLockEnum.未锁; + container.Status = hasInventory ? ContainerStatus.有 : ContainerStatus.空; + container.UpdateBy = operatorCode; + container.UpdateTime = now; + _unitwork.Update(container); + + location.ContainerCode = string.Empty; + location.Status = LocationStatusEnum.未锁; + location.ContainerStatus = LocationStatus.空仓位; + location.Version = Guid.NewGuid(); + location.UpdateBy = operatorCode; + location.UpdateTime = now; + _unitwork.Update(location); + + _unitwork.Delete(task); + transaction.Commit(); + + Wtm.DoLog("取消线边库入库任务", ActionLogTypesEnum.Normal, + "CancelInboundTask", request: task.TaskNo, + result: $"取消成功,清理库存{inventories.Count}条"); + return FFResult().CloseDialog().Alert("任务取消成功").RefreshGrid(); + } + catch (Exception ex) + { + transaction.Rollback(); + return FFResult().CloseDialog() + .Alert(ex.InnerException?.Message ?? ex.Message) + .RefreshGrid(); + } + } + } + + private static bool SameCode(string left, string right) + { + return string.Equals(left, right, StringComparison.OrdinalIgnoreCase); + } + + private bool TryCancelWcsTask(TaskHeader task, out string errorMessage) + { + try + { + var request = new { TaskNo = task.TaskNo }; + var wcsResult = Wtm.CallAPI("WCSXB", "TaskCancel", + HttpMethodEnum.POST, request).Result.Data; + if (wcsResult == null) + { + errorMessage = "WCS取消任务无响应,WMS未清理数据"; + return false; + } + + if (!wcsResult.Success) + { + errorMessage = $"WCS取消任务失败:{wcsResult.Msg}"; + return false; + } + + errorMessage = null; + return true; + } + catch (Exception ex) + { + errorMessage = $"调用WCS取消任务接口异常:{ex.InnerException?.Message ?? ex.Message}"; + return false; + } + } + + #endregion Cancel + #region Details [ActionDescription("Sys.Details")] diff --git a/HHWMS.Web/Areas/TaskManage/Views/TaskHeader/Cancel.cshtml b/HHWMS.Web/Areas/TaskManage/Views/TaskHeader/Cancel.cshtml new file mode 100644 index 0000000..97e1549 --- /dev/null +++ b/HHWMS.Web/Areas/TaskManage/Views/TaskHeader/Cancel.cshtml @@ -0,0 +1,19 @@ +@model HHWMS.Web.TaskHeaderVM + + + + 确认取消该线边库入库任务?取消后将删除未完成的零库存记录,并释放托盘和目标库位。 + 已下发任务仅在WCS尚未开始执行时允许取消。 + + + + + + + + + + + + + diff --git a/docs/线边库零库存占用库位-取消入库任务-方案记录.md b/docs/线边库零库存占用库位-取消入库任务-方案记录.md new file mode 100644 index 0000000..a016296 --- /dev/null +++ b/docs/线边库零库存占用库位-取消入库任务-方案记录.md @@ -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任务仍会明确拒绝。 diff --git a/docs/线边库零库存占用库位-取消入库任务-测试报告.md b/docs/线边库零库存占用库位-取消入库任务-测试报告.md new file mode 100644 index 0000000..01a0d18 --- /dev/null +++ b/docs/线边库零库存占用库位-取消入库任务-测试报告.md @@ -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` 已不是“任务创建”时,继续返回失败,禁止删除已执行任务。 + +上线复测应确认:未执行任务删除成功;重复调用返回成功;已执行任务返回失败。 diff --git a/sql/20260718_cancel_xb_inbound_task_verify.sql b/sql/20260718_cancel_xb_inbound_task_verify.sql new file mode 100644 index 0000000..dd9662d --- /dev/null +++ b/sql/20260718_cancel_xb_inbound_task_verify.sql @@ -0,0 +1,73 @@ +-- 线边库零库存占用库位:取消入库任务 +-- 本事项没有数据库结构或初始化数据变更。 +-- 本脚本仅用于上线前后只读核查,不会修改任何数据。 +-- 请在线边库 default 数据库执行。 + +-- 1. 统计允许进入取消校验的候选任务。 +SELECT + COUNT(*) AS TaskCount, + SUM(CASE WHEN `Status` = 0 THEN 1 ELSE 0 END) AS NewCount, + SUM(CASE WHEN `Status` = 1 THEN 1 ELSE 0 END) AS PendingCount, + SUM(CASE WHEN `Status` = 5 THEN 1 ELSE 0 END) AS AssignedCount +FROM `TaskHeader` +WHERE `ZoneId` = 1027 + AND `RoadWay` = 1 + AND `TaskType` = 1 + AND `Status` IN (0, 1, 5); + +-- 2. 列出状态不符合自动取消条件的任务,结果应为空。 +SELECT + t.`ID`, + t.`TaskNo`, + t.`Status`, + t.`ContainerCode`, + t.`ToLocation`, + (SELECT COUNT(*) FROM `TaskDetail` d WHERE d.`HeaderId` = t.`ID`) AS DetailCount, + (SELECT COUNT(*) FROM `Inventory` i WHERE i.`ContainerCode` = t.`ContainerCode`) AS InventoryCount, + c.`IsLock` AS ContainerLock, + c.`Status` AS ContainerStatus, + c.`LocationCode` AS ContainerLocation, + l.`Status` AS LocationLock, + l.`ContainerStatus` AS LocationContainerStatus, + l.`ContainerCode` AS LocationContainer +FROM `TaskHeader` t +LEFT JOIN `Container` c ON c.`Code` = t.`ContainerCode` +LEFT JOIN `Location` l ON l.`Code` = t.`ToLocation` +WHERE t.`ZoneId` = 1027 + AND t.`RoadWay` = 1 + AND t.`TaskType` = 1 + AND t.`Status` IN (0, 1, 5) + AND ( + (SELECT COUNT(*) FROM `TaskDetail` d WHERE d.`HeaderId` = t.`ID`) <> 0 + OR EXISTS ( + SELECT 1 + FROM `Inventory` i + WHERE i.`ContainerCode` = t.`ContainerCode` + AND ( + i.`ZoneId` <> t.`ZoneId` + OR UPPER(COALESCE(i.`LocationCode`, '')) <> UPPER(COALESCE(t.`ToLocation`, '')) + OR i.`TaskStatus` <> 1 + OR COALESCE(i.`Qty`, 0) <> 0 + ) + ) + OR c.`IsLock` <> 1 + OR UPPER(COALESCE(c.`LocationCode`, '')) <> UPPER(COALESCE(t.`ToLocation`, '')) + OR c.`Status` <> CASE + WHEN EXISTS (SELECT 1 FROM `Inventory` i WHERE i.`ContainerCode` = t.`ContainerCode`) + THEN 'some' ELSE 'empty' END + OR l.`Status` <> 1 + OR UPPER(COALESCE(l.`ContainerCode`, '')) <> UPPER(COALESCE(t.`ContainerCode`, '')) + OR l.`ContainerStatus` <> CASE + WHEN EXISTS (SELECT 1 FROM `Inventory` i WHERE i.`ContainerCode` = t.`ContainerCode`) + THEN 'some' ELSE 'empty' END + ) +ORDER BY t.`ID`; + +-- 3. 取消单条任务后核查。执行前替换任务号。 +SET @TaskNo = '请替换为实际任务号'; + +SELECT COUNT(*) AS RemainingTaskCount +FROM `TaskHeader` +WHERE `TaskNo` = @TaskNo; + +-- 成功取消后应同时人工核对:原目标库位未锁且无托盘号,原托盘未锁且LocationCode为空。