feat(wms): 添加钢卷与合同关联关系管理功能

- 创建 WmsCoilContractRel 实体类定义钢卷与合同关联关系数据结构
- 实现 IWmsCoilContractRelService 接口提供基础CRUD操作方法
- 开发 WmsCoilContractRelServiceImpl 业务逻辑实现类
- 添加 WmsCoilContractRelController 控制器支持RESTful API接口
- 设计 WmsCoilContractRelMapper 数据访问接口及XML映射文件
- 创建 WmsCoilContractRelBo 业务对象和 WmsCoilContractRelVo 视图对象
- 集成分页查询、新增、修改、删除和导出功能
- 添加数据验证和重复提交防护机制

klp-wms/src/main/java/com/klp/service/impl/WmsCoilContractRelServiceImpl.java

@@ -0,0 +1,109 @@
+package com.klp.service.impl;
+
+import cn.hutool.core.bean.BeanUtil;
+import com.klp.common.core.page.TableDataInfo;
+import com.klp.common.core.domain.PageQuery;
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.baomidou.mybatisplus.core.toolkit.Wrappers;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import com.klp.domain.bo.WmsCoilContractRelBo;
+import com.klp.domain.vo.WmsCoilContractRelVo;
+import com.klp.domain.WmsCoilContractRel;
+import com.klp.mapper.WmsCoilContractRelMapper;
+import com.klp.service.IWmsCoilContractRelService;
+
+import java.util.List;
+import java.util.Map;
+import java.util.Collection;
+
+/**
+ * 钢卷与合同关联关系Service业务层处理
+ *
+ * @author klp
+ * @date 2026-04-18
+ */
+@RequiredArgsConstructor
+@Service
+public class WmsCoilContractRelServiceImpl implements IWmsCoilContractRelService {
+
+    private final WmsCoilContractRelMapper baseMapper;
+
+    /**
+     * 查询钢卷与合同关联关系
+     */
+    @Override
+    public WmsCoilContractRelVo queryById(Long relId){
+        return baseMapper.selectVoById(relId);
+    }
+
+    /**
+     * 查询钢卷与合同关联关系列表
+     */
+    @Override
+    public TableDataInfo<WmsCoilContractRelVo> queryPageList(WmsCoilContractRelBo bo, PageQuery pageQuery) {
+        LambdaQueryWrapper<WmsCoilContractRel> lqw = buildQueryWrapper(bo);
+        Page<WmsCoilContractRelVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
+        return TableDataInfo.build(result);
+    }
+
+    /**
+     * 查询钢卷与合同关联关系列表
+     */
+    @Override
+    public List<WmsCoilContractRelVo> queryList(WmsCoilContractRelBo bo) {
+        LambdaQueryWrapper<WmsCoilContractRel> lqw = buildQueryWrapper(bo);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    private LambdaQueryWrapper<WmsCoilContractRel> buildQueryWrapper(WmsCoilContractRelBo bo) {
+        Map<String, Object> params = bo.getParams();
+        LambdaQueryWrapper<WmsCoilContractRel> lqw = Wrappers.lambdaQuery();
+        lqw.eq(bo.getCoilId() != null, WmsCoilContractRel::getCoilId, bo.getCoilId());
+        lqw.eq(bo.getContractId() != null, WmsCoilContractRel::getContractId, bo.getContractId());
+        return lqw;
+    }
+
+    /**
+     * 新增钢卷与合同关联关系
+     */
+    @Override
+    public Boolean insertByBo(WmsCoilContractRelBo bo) {
+        WmsCoilContractRel add = BeanUtil.toBean(bo, WmsCoilContractRel.class);
+        validEntityBeforeSave(add);
+        boolean flag = baseMapper.insert(add) > 0;
+        if (flag) {
+            bo.setRelId(add.getRelId());
+        }
+        return flag;
+    }
+
+    /**
+     * 修改钢卷与合同关联关系
+     */
+    @Override
+    public Boolean updateByBo(WmsCoilContractRelBo bo) {
+        WmsCoilContractRel update = BeanUtil.toBean(bo, WmsCoilContractRel.class);
+        validEntityBeforeSave(update);
+        return baseMapper.updateById(update) > 0;
+    }
+
+    /**
+     * 保存前的数据校验
+     */
+    private void validEntityBeforeSave(WmsCoilContractRel entity){
+        //TODO 做一些数据校验,如唯一约束
+    }
+
+    /**
+     * 批量删除钢卷与合同关联关系
+     */
+    @Override
+    public Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid) {
+        if(isValid){
+            //TODO 做一些业务上的校验,判断是否需要校验
+        }
+        return baseMapper.deleteBatchIds(ids) > 0;
+    }
+}