feat(wms): 添加钢卷缓存功能模块

- 创建钢卷缓存实体类WmsCoilCache，包含缓存ID、钢卷ID、JSON数据等字段
- 定义钢卷缓存服务接口IWmsCoilCacheService，提供查询、新增、修改、删除等操作方法
- 实现钢卷缓存服务业务逻辑WmsCoilCacheServiceImpl，包含分页查询和批量操作功能
- 开发钢卷缓存控制器WmsCoilCacheController，提供RESTful API接口
- 创建钢卷缓存映射器WmsCoilCacheMapper及对应的XML映射文件
- 添加钢卷缓存业务对象WmsCoilCacheBo和视图对象WmsCoilCacheVo
- 实现按钢卷ID保存或更新缓存的功能，支持存在则覆盖、不存在则新增的逻辑
- 提供按钢卷ID查询缓存数据的专用接口

klp-wms/src/main/java/com/klp/controller/WmsCoilCacheController.java

@@ -0,0 +1,117 @@
+package com.klp.controller;
+
+import java.util.List;
+import java.util.Arrays;
+
+import lombok.RequiredArgsConstructor;
+import javax.servlet.http.HttpServletResponse;
+import javax.validation.constraints.*;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.validation.annotation.Validated;
+import com.klp.common.annotation.RepeatSubmit;
+import com.klp.common.annotation.Log;
+import com.klp.common.core.controller.BaseController;
+import com.klp.common.core.domain.PageQuery;
+import com.klp.common.core.domain.R;
+import com.klp.common.core.validate.AddGroup;
+import com.klp.common.core.validate.EditGroup;
+import com.klp.common.enums.BusinessType;
+import com.klp.common.utils.poi.ExcelUtil;
+import com.klp.domain.vo.WmsCoilCacheVo;
+import com.klp.domain.bo.WmsCoilCacheBo;
+import com.klp.service.IWmsCoilCacheService;
+import com.klp.common.core.page.TableDataInfo;
+
+/**
+ * 钢卷缓存
+ *
+ * @author klp
+ * @date 2026-04-24
+ */
+@Validated
+@RequiredArgsConstructor
+@RestController
+@RequestMapping("/wms/coilCache")
+public class WmsCoilCacheController extends BaseController {
+
+    private final IWmsCoilCacheService iWmsCoilCacheService;
+
+    /**
+     * 查询钢卷缓存列表
+     */
+    @GetMapping("/list")
+    public TableDataInfo<WmsCoilCacheVo> list(WmsCoilCacheBo bo, PageQuery pageQuery) {
+        return iWmsCoilCacheService.queryPageList(bo, pageQuery);
+    }
+
+    /**
+     * 导出钢卷缓存列表
+     */
+    @Log(title = "钢卷缓存", businessType = BusinessType.EXPORT)
+    @PostMapping("/export")
+    public void export(WmsCoilCacheBo bo, HttpServletResponse response) {
+        List<WmsCoilCacheVo> list = iWmsCoilCacheService.queryList(bo);
+        ExcelUtil.exportExcel(list, "钢卷缓存", WmsCoilCacheVo.class, response);
+    }
+
+    /**
+     * 获取钢卷缓存详细信息
+     *
+     * @param cacheId 主键
+     */
+    @GetMapping("/{cacheId}")
+    public R<WmsCoilCacheVo> getInfo(@NotNull(message = "主键不能为空")
+                                     @PathVariable Long cacheId) {
+        return R.ok(iWmsCoilCacheService.queryById(cacheId));
+    }
+
+    /**
+     * 新增钢卷缓存
+     */
+    @Log(title = "钢卷缓存", businessType = BusinessType.INSERT)
+    @RepeatSubmit()
+    @PostMapping()
+    public R<Void> add(@Validated(AddGroup.class) @RequestBody WmsCoilCacheBo bo) {
+        return toAjax(iWmsCoilCacheService.insertByBo(bo));
+    }
+
+    /**
+     * 修改钢卷缓存
+     */
+    @Log(title = "钢卷缓存", businessType = BusinessType.UPDATE)
+    @RepeatSubmit()
+    @PutMapping()
+    public R<Void> edit(@Validated(EditGroup.class) @RequestBody WmsCoilCacheBo bo) {
+        return toAjax(iWmsCoilCacheService.updateByBo(bo));
+    }
+
+    /**
+     * 删除钢卷缓存
+     *
+     * @param cacheIds 主键串
+     */
+    @Log(title = "钢卷缓存", businessType = BusinessType.DELETE)
+    @DeleteMapping("/{cacheIds}")
+    public R<Void> remove(@NotEmpty(message = "主键不能为空")
+                          @PathVariable Long[] cacheIds) {
+        return toAjax(iWmsCoilCacheService.deleteWithValidByIds(Arrays.asList(cacheIds), true));
+    }
+
+    /**
+     * 保存或更新钢卷缓存（通过钢卷ID）
+     */
+    @Log(title = "钢卷缓存", businessType = BusinessType.INSERT)
+    @PostMapping("/save")
+    public R<Void> saveCache(@RequestBody WmsCoilCacheBo bo) {
+        return toAjax(iWmsCoilCacheService.saveOrUpdateByCoilId(bo));
+    }
+
+    /**
+     * 获取钢卷缓存（通过钢卷ID）
+     */
+    @GetMapping("/getByCoilId/{coilId}")
+    public R<WmsCoilCacheVo> getCacheByCoilId(@NotNull(message = "钢卷ID不能为空")
+                                              @PathVariable Long coilId) {
+        return R.ok(iWmsCoilCacheService.queryByCoilId(coilId));
+    }
+}

klp-wms/src/main/java/com/klp/domain/WmsCoilCache.java

@@ -0,0 +1,45 @@
+package com.klp.domain;
+
+import com.baomidou.mybatisplus.annotation.*;
+import com.klp.common.core.domain.BaseEntity;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+
+/**
+ * 钢卷缓存对象 wms_coil_cache
+ *
+ * @author klp
+ * @date 2026-04-24
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@TableName("wms_coil_cache")
+public class WmsCoilCache extends BaseEntity {
+
+    private static final long serialVersionUID=1L;
+
+    /**
+     * 钢卷缓存主键ID
+     */
+    @TableId(value = "cache_id")
+    private Long cacheId;
+    /**
+     * 钢卷ID
+     */
+    private Long coilId;
+    /**
+     * 钢卷JSON数据
+     */
+    private String coilJson;
+    /**
+     * 删除标识 0正常 2删除
+     */
+    @TableLogic
+    private Long delFlag;
+    /**
+     * 备注
+     */
+    private String remark;
+
+}

klp-wms/src/main/java/com/klp/domain/bo/WmsCoilCacheBo.java

@@ -0,0 +1,41 @@
+package com.klp.domain.bo;
+
+import com.klp.common.core.domain.BaseEntity;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import javax.validation.constraints.*;
+
+
+/**
+ * 钢卷缓存业务对象 wms_coil_cache
+ *
+ * @author klp
+ * @date 2026-04-24
+ */
+
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class WmsCoilCacheBo extends BaseEntity {
+
+    /**
+     * 钢卷缓存主键ID
+     */
+    private Long cacheId;
+
+    /**
+     * 钢卷ID
+     */
+    private Long coilId;
+
+    /**
+     * 钢卷JSON数据
+     */
+    private String coilJson;
+
+    /**
+     * 备注
+     */
+    private String remark;
+
+
+}

klp-wms/src/main/java/com/klp/domain/vo/WmsCoilCacheVo.java

@@ -0,0 +1,47 @@
+package com.klp.domain.vo;
+
+import com.alibaba.excel.annotation.ExcelIgnoreUnannotated;
+import com.alibaba.excel.annotation.ExcelProperty;
+import com.klp.common.annotation.ExcelDictFormat;
+import com.klp.common.convert.ExcelDictConvert;
+import lombok.Data;
+
+
+/**
+ * 钢卷缓存视图对象 wms_coil_cache
+ *
+ * @author klp
+ * @date 2026-04-24
+ */
+@Data
+@ExcelIgnoreUnannotated
+public class WmsCoilCacheVo {
+
+    private static final long serialVersionUID = 1L;
+
+    /**
+     * 钢卷缓存主键ID
+     */
+    @ExcelProperty(value = "钢卷缓存主键ID")
+    private Long cacheId;
+
+    /**
+     * 钢卷ID
+     */
+    @ExcelProperty(value = "钢卷ID")
+    private Long coilId;
+
+    /**
+     * 钢卷JSON数据
+     */
+    @ExcelProperty(value = "钢卷JSON数据")
+    private String coilJson;
+
+    /**
+     * 备注
+     */
+    @ExcelProperty(value = "备注")
+    private String remark;
+
+
+}

klp-wms/src/main/java/com/klp/mapper/WmsCoilCacheMapper.java

@@ -0,0 +1,16 @@
+package com.klp.mapper;
+
+import com.klp.domain.WmsCoilCache;
+import com.klp.domain.vo.WmsCoilCacheVo;
+import com.klp.common.core.mapper.BaseMapperPlus;
+import org.apache.ibatis.annotations.Param;
+
+/**
+ * 钢卷缓存Mapper接口
+ *
+ * @author klp
+ * @date 2026-04-24
+ */
+public interface WmsCoilCacheMapper extends BaseMapperPlus<WmsCoilCacheMapper, WmsCoilCache, WmsCoilCacheVo> {
+    WmsCoilCacheVo selectVoByCoilId(@Param("coilId") Long coilId);
+}

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

@@ -0,0 +1,59 @@
+package com.klp.service;
+
+import com.klp.domain.WmsCoilCache;
+import com.klp.domain.vo.WmsCoilCacheVo;
+import com.klp.domain.bo.WmsCoilCacheBo;
+import com.klp.common.core.page.TableDataInfo;
+import com.klp.common.core.domain.PageQuery;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * 钢卷缓存Service接口
+ *
+ * @author klp
+ * @date 2026-04-24
+ */
+public interface IWmsCoilCacheService {
+
+    /**
+     * 查询钢卷缓存
+     */
+    WmsCoilCacheVo queryById(Long cacheId);
+
+    /**
+     * 查询钢卷缓存列表
+     */
+    TableDataInfo<WmsCoilCacheVo> queryPageList(WmsCoilCacheBo bo, PageQuery pageQuery);
+
+    /**
+     * 查询钢卷缓存列表
+     */
+    List<WmsCoilCacheVo> queryList(WmsCoilCacheBo bo);
+
+    /**
+     * 新增钢卷缓存
+     */
+    Boolean insertByBo(WmsCoilCacheBo bo);
+
+    /**
+     * 修改钢卷缓存
+     */
+    Boolean updateByBo(WmsCoilCacheBo bo);
+
+    /**
+     * 校验并批量删除钢卷缓存信息
+     */
+    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
+
+    /**
+     * 保存或更新钢卷缓存（通过钢卷ID，有则覆盖，无则新增）
+     */
+    Boolean saveOrUpdateByCoilId(WmsCoilCacheBo bo);
+
+    /**
+     * 获取钢卷缓存（通过钢卷ID）
+     */
+    WmsCoilCacheVo queryByCoilId(Long coilId);
+}

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

@@ -0,0 +1,135 @@
+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 com.klp.common.utils.StringUtils;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import com.klp.domain.bo.WmsCoilCacheBo;
+import com.klp.domain.vo.WmsCoilCacheVo;
+import com.klp.domain.WmsCoilCache;
+import com.klp.mapper.WmsCoilCacheMapper;
+import com.klp.service.IWmsCoilCacheService;
+
+import java.util.List;
+import java.util.Map;
+import java.util.Collection;
+
+/**
+ * 钢卷缓存Service业务层处理
+ *
+ * @author klp
+ * @date 2026-04-24
+ */
+@RequiredArgsConstructor
+@Service
+public class WmsCoilCacheServiceImpl implements IWmsCoilCacheService {
+
+    private final WmsCoilCacheMapper baseMapper;
+
+    /**
+     * 查询钢卷缓存
+     */
+    @Override
+    public WmsCoilCacheVo queryById(Long cacheId){
+        return baseMapper.selectVoById(cacheId);
+    }
+
+    /**
+     * 查询钢卷缓存列表
+     */
+    @Override
+    public TableDataInfo<WmsCoilCacheVo> queryPageList(WmsCoilCacheBo bo, PageQuery pageQuery) {
+        LambdaQueryWrapper<WmsCoilCache> lqw = buildQueryWrapper(bo);
+        Page<WmsCoilCacheVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
+        return TableDataInfo.build(result);
+    }
+
+    /**
+     * 查询钢卷缓存列表
+     */
+    @Override
+    public List<WmsCoilCacheVo> queryList(WmsCoilCacheBo bo) {
+        LambdaQueryWrapper<WmsCoilCache> lqw = buildQueryWrapper(bo);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    private LambdaQueryWrapper<WmsCoilCache> buildQueryWrapper(WmsCoilCacheBo bo) {
+        Map<String, Object> params = bo.getParams();
+        LambdaQueryWrapper<WmsCoilCache> lqw = Wrappers.lambdaQuery();
+        lqw.eq(bo.getCoilId() != null, WmsCoilCache::getCoilId, bo.getCoilId());
+        lqw.eq(StringUtils.isNotBlank(bo.getCoilJson()), WmsCoilCache::getCoilJson, bo.getCoilJson());
+        return lqw;
+    }
+
+    /**
+     * 新增钢卷缓存
+     */
+    @Override
+    public Boolean insertByBo(WmsCoilCacheBo bo) {
+        WmsCoilCache add = BeanUtil.toBean(bo, WmsCoilCache.class);
+        validEntityBeforeSave(add);
+        boolean flag = baseMapper.insert(add) > 0;
+        if (flag) {
+            bo.setCacheId(add.getCacheId());
+        }
+        return flag;
+    }
+
+    /**
+     * 修改钢卷缓存
+     */
+    @Override
+    public Boolean updateByBo(WmsCoilCacheBo bo) {
+        WmsCoilCache update = BeanUtil.toBean(bo, WmsCoilCache.class);
+        validEntityBeforeSave(update);
+        return baseMapper.updateById(update) > 0;
+    }
+
+    /**
+     * 保存前的数据校验
+     */
+    private void validEntityBeforeSave(WmsCoilCache entity){
+        //TODO 做一些数据校验,如唯一约束
+    }
+
+    /**
+     * 批量删除钢卷缓存
+     */
+    @Override
+    public Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid) {
+        if(isValid){
+            //TODO 做一些业务上的校验,判断是否需要校验
+        }
+        return baseMapper.deleteBatchIds(ids) > 0;
+    }
+
+    /**
+     * 保存或更新钢卷缓存（通过钢卷ID，有则覆盖，无则新增）
+     */
+    @Override
+    public Boolean saveOrUpdateByCoilId(WmsCoilCacheBo bo) {
+        WmsCoilCacheVo exist = baseMapper.selectVoByCoilId(bo.getCoilId());
+        if (exist != null) {
+            WmsCoilCache update = BeanUtil.toBean(bo, WmsCoilCache.class);
+            update.setCacheId(exist.getCacheId());
+            return baseMapper.updateById(update) > 0;
+        } else {
+            WmsCoilCache add = BeanUtil.toBean(bo, WmsCoilCache.class);
+            validEntityBeforeSave(add);
+            return baseMapper.insert(add) > 0;
+        }
+    }
+
+    /**
+     * 获取钢卷缓存（通过钢卷ID）
+     */
+    @Override
+    public WmsCoilCacheVo queryByCoilId(Long coilId) {
+        return baseMapper.selectVoByCoilId(coilId);
+    }
+}

klp-wms/src/main/resources/mapper/klp/WmsCoilCacheMapper.xml

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE mapper
+    PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
+    "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="com.klp.mapper.WmsCoilCacheMapper">
+
+    <resultMap type="com.klp.domain.WmsCoilCache" id="WmsCoilCacheResult">
+        <result property="cacheId" column="cache_id"/>
+        <result property="coilId" column="coil_id"/>
+        <result property="coilJson" column="coil_json"/>
+        <result property="delFlag" column="del_flag"/>
+        <result property="createBy" column="create_by"/>
+        <result property="createTime" column="create_time"/>
+        <result property="updateBy" column="update_by"/>
+        <result property="updateTime" column="update_time"/>
+        <result property="remark" column="remark"/>
+    </resultMap>
+
+
+<select id="selectVoByCoilId" resultMap="WmsCoilCacheResult">
+        select * from wms_coil_cache where coil_id = #{coilId}
+    </select>
+
+</mapper>