feat(wms): 新增钢卷退货功能

- 在IWmsMaterialCoilService接口中添加returnCoil方法定义
- 在WmsMaterialCoilController控制器中新增退货接口映射
- 在WmsMaterialCoilServiceImpl实现类中实现完整的退货逻辑
- 实现将原钢卷转为历史数据并创建新钢卷记录的功能
- 实现退货仓查找及仓库状态更新机制
- 实现二维码内容更新以记录退货操作步骤
- 添加退货操作的权限验证和数据校验机制

klp-wms/src/main/java/com/klp/service/IWmsMaterialCoilService.java

@@ -213,5 +213,14 @@ public interface IWmsMaterialCoilService {
     Map<String, Object> completeSpecialSplit(@NotNull(message = "待操作记录ID不能为空") Long pendingActionId);
 
     Map<String, Object> cancelSpecialSplit(@NotNull(message = "待操作记录ID不能为空") Long pendingActionId);
+
+    /**
+     * 钢卷退货操作
+     * 将钢卷退货到退货仓，创建新钢卷记录，将原钢卷设置为历史钢卷
+     *
+     * @param coilId 原钢卷ID
+     * @return 退货后的新钢卷信息
+     */
+    WmsMaterialCoilVo returnCoil(@NotNull(message = "钢卷ID不能为空") Long coilId);
 }