feat(wms): 新增发货计划、发货单主表及明细表功能模块

- 新增发货计划实体类、业务对象、控制器、服务接口及实现
- 新增发货单主表实体类、业务对象、控制器、服务接口及实现
- 新增发货单明细表实体类、业务对象、控制器、服务接口及实现
- 配置相关Mapper接口与XML映射文件
- 实现基础的增删改查及分页查询功能
- 支持Excel导出功能
- 添加基础数据校验与日志记录

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

@@ -0,0 +1,49 @@
+package com.klp.service;
+
+import com.klp.domain.WmsDeliveryPlan;
+import com.klp.domain.vo.WmsDeliveryPlanVo;
+import com.klp.domain.bo.WmsDeliveryPlanBo;
+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 2025-11-25
+ */
+public interface IWmsDeliveryPlanService {
+
+    /**
+     * 查询发货计划
+     */
+    WmsDeliveryPlanVo queryById(Long planId);
+
+    /**
+     * 查询发货计划列表
+     */
+    TableDataInfo<WmsDeliveryPlanVo> queryPageList(WmsDeliveryPlanBo bo, PageQuery pageQuery);
+
+    /**
+     * 查询发货计划列表
+     */
+    List<WmsDeliveryPlanVo> queryList(WmsDeliveryPlanBo bo);
+
+    /**
+     * 新增发货计划
+     */
+    Boolean insertByBo(WmsDeliveryPlanBo bo);
+
+    /**
+     * 修改发货计划
+     */
+    Boolean updateByBo(WmsDeliveryPlanBo bo);
+
+    /**
+     * 校验并批量删除发货计划信息
+     */
+    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
+}

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

@@ -0,0 +1,49 @@
+package com.klp.service;
+
+import com.klp.domain.WmsDeliveryWaybillDetail;
+import com.klp.domain.vo.WmsDeliveryWaybillDetailVo;
+import com.klp.domain.bo.WmsDeliveryWaybillDetailBo;
+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 2025-11-25
+ */
+public interface IWmsDeliveryWaybillDetailService {
+
+    /**
+     * 查询发货单明细
+     */
+    WmsDeliveryWaybillDetailVo queryById(Long detailId);
+
+    /**
+     * 查询发货单明细列表
+     */
+    TableDataInfo<WmsDeliveryWaybillDetailVo> queryPageList(WmsDeliveryWaybillDetailBo bo, PageQuery pageQuery);
+
+    /**
+     * 查询发货单明细列表
+     */
+    List<WmsDeliveryWaybillDetailVo> queryList(WmsDeliveryWaybillDetailBo bo);
+
+    /**
+     * 新增发货单明细
+     */
+    Boolean insertByBo(WmsDeliveryWaybillDetailBo bo);
+
+    /**
+     * 修改发货单明细
+     */
+    Boolean updateByBo(WmsDeliveryWaybillDetailBo bo);
+
+    /**
+     * 校验并批量删除发货单明细信息
+     */
+    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
+}

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

@@ -0,0 +1,49 @@
+package com.klp.service;
+
+import com.klp.domain.WmsDeliveryWaybill;
+import com.klp.domain.vo.WmsDeliveryWaybillVo;
+import com.klp.domain.bo.WmsDeliveryWaybillBo;
+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 2025-11-25
+ */
+public interface IWmsDeliveryWaybillService {
+
+    /**
+     * 查询发货单主
+     */
+    WmsDeliveryWaybillVo queryById(Long waybillId);
+
+    /**
+     * 查询发货单主列表
+     */
+    TableDataInfo<WmsDeliveryWaybillVo> queryPageList(WmsDeliveryWaybillBo bo, PageQuery pageQuery);
+
+    /**
+     * 查询发货单主列表
+     */
+    List<WmsDeliveryWaybillVo> queryList(WmsDeliveryWaybillBo bo);
+
+    /**
+     * 新增发货单主
+     */
+    Boolean insertByBo(WmsDeliveryWaybillBo bo);
+
+    /**
+     * 修改发货单主
+     */
+    Boolean updateByBo(WmsDeliveryWaybillBo bo);
+
+    /**
+     * 校验并批量删除发货单主信息
+     */
+    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
+}

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

@@ -0,0 +1,110 @@
+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.WmsDeliveryPlanBo;
+import com.klp.domain.vo.WmsDeliveryPlanVo;
+import com.klp.domain.WmsDeliveryPlan;
+import com.klp.mapper.WmsDeliveryPlanMapper;
+import com.klp.service.IWmsDeliveryPlanService;
+
+import java.util.List;
+import java.util.Map;
+import java.util.Collection;
+
+/**
+ * 发货计划Service业务层处理
+ *
+ * @author klp
+ * @date 2025-11-25
+ */
+@RequiredArgsConstructor
+@Service
+public class WmsDeliveryPlanServiceImpl implements IWmsDeliveryPlanService {
+
+    private final WmsDeliveryPlanMapper baseMapper;
+
+    /**
+     * 查询发货计划
+     */
+    @Override
+    public WmsDeliveryPlanVo queryById(Long planId){
+        return baseMapper.selectVoById(planId);
+    }
+
+    /**
+     * 查询发货计划列表
+     */
+    @Override
+    public TableDataInfo<WmsDeliveryPlanVo> queryPageList(WmsDeliveryPlanBo bo, PageQuery pageQuery) {
+        LambdaQueryWrapper<WmsDeliveryPlan> lqw = buildQueryWrapper(bo);
+        Page<WmsDeliveryPlanVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
+        return TableDataInfo.build(result);
+    }
+
+    /**
+     * 查询发货计划列表
+     */
+    @Override
+    public List<WmsDeliveryPlanVo> queryList(WmsDeliveryPlanBo bo) {
+        LambdaQueryWrapper<WmsDeliveryPlan> lqw = buildQueryWrapper(bo);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    private LambdaQueryWrapper<WmsDeliveryPlan> buildQueryWrapper(WmsDeliveryPlanBo bo) {
+        Map<String, Object> params = bo.getParams();
+        LambdaQueryWrapper<WmsDeliveryPlan> lqw = Wrappers.lambdaQuery();
+        lqw.like(StringUtils.isNotBlank(bo.getPlanName()), WmsDeliveryPlan::getPlanName, bo.getPlanName());
+        lqw.eq(bo.getPlanDate() != null, WmsDeliveryPlan::getPlanDate, bo.getPlanDate());
+        return lqw;
+    }
+
+    /**
+     * 新增发货计划
+     */
+    @Override
+    public Boolean insertByBo(WmsDeliveryPlanBo bo) {
+        WmsDeliveryPlan add = BeanUtil.toBean(bo, WmsDeliveryPlan.class);
+        validEntityBeforeSave(add);
+        boolean flag = baseMapper.insert(add) > 0;
+        if (flag) {
+            bo.setPlanId(add.getPlanId());
+        }
+        return flag;
+    }
+
+    /**
+     * 修改发货计划
+     */
+    @Override
+    public Boolean updateByBo(WmsDeliveryPlanBo bo) {
+        WmsDeliveryPlan update = BeanUtil.toBean(bo, WmsDeliveryPlan.class);
+        validEntityBeforeSave(update);
+        return baseMapper.updateById(update) > 0;
+    }
+
+    /**
+     * 保存前的数据校验
+     */
+    private void validEntityBeforeSave(WmsDeliveryPlan entity){
+        //TODO 做一些数据校验,如唯一约束
+    }
+
+    /**
+     * 批量删除发货计划
+     */
+    @Override
+    public Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid) {
+        if(isValid){
+            //TODO 做一些业务上的校验,判断是否需要校验
+        }
+        return baseMapper.deleteBatchIds(ids) > 0;
+    }
+}

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

@@ -0,0 +1,121 @@
+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.WmsDeliveryWaybillDetailBo;
+import com.klp.domain.vo.WmsDeliveryWaybillDetailVo;
+import com.klp.domain.WmsDeliveryWaybillDetail;
+import com.klp.mapper.WmsDeliveryWaybillDetailMapper;
+import com.klp.service.IWmsDeliveryWaybillDetailService;
+
+import java.util.List;
+import java.util.Map;
+import java.util.Collection;
+
+/**
+ * 发货单明细Service业务层处理
+ *
+ * @author klp
+ * @date 2025-11-25
+ */
+@RequiredArgsConstructor
+@Service
+public class WmsDeliveryWaybillDetailServiceImpl implements IWmsDeliveryWaybillDetailService {
+
+    private final WmsDeliveryWaybillDetailMapper baseMapper;
+
+    /**
+     * 查询发货单明细
+     */
+    @Override
+    public WmsDeliveryWaybillDetailVo queryById(Long detailId){
+        return baseMapper.selectVoById(detailId);
+    }
+
+    /**
+     * 查询发货单明细列表
+     */
+    @Override
+    public TableDataInfo<WmsDeliveryWaybillDetailVo> queryPageList(WmsDeliveryWaybillDetailBo bo, PageQuery pageQuery) {
+        LambdaQueryWrapper<WmsDeliveryWaybillDetail> lqw = buildQueryWrapper(bo);
+        Page<WmsDeliveryWaybillDetailVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
+        return TableDataInfo.build(result);
+    }
+
+    /**
+     * 查询发货单明细列表
+     */
+    @Override
+    public List<WmsDeliveryWaybillDetailVo> queryList(WmsDeliveryWaybillDetailBo bo) {
+        LambdaQueryWrapper<WmsDeliveryWaybillDetail> lqw = buildQueryWrapper(bo);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    private LambdaQueryWrapper<WmsDeliveryWaybillDetail> buildQueryWrapper(WmsDeliveryWaybillDetailBo bo) {
+        Map<String, Object> params = bo.getParams();
+        LambdaQueryWrapper<WmsDeliveryWaybillDetail> lqw = Wrappers.lambdaQuery();
+        lqw.eq(bo.getWaybillId() != null, WmsDeliveryWaybillDetail::getWaybillId, bo.getWaybillId());
+        lqw.eq(bo.getCoilId() != null, WmsDeliveryWaybillDetail::getCoilId, bo.getCoilId());
+        lqw.like(StringUtils.isNotBlank(bo.getProductName()), WmsDeliveryWaybillDetail::getProductName, bo.getProductName());
+        lqw.eq(StringUtils.isNotBlank(bo.getEdgeType()), WmsDeliveryWaybillDetail::getEdgeType, bo.getEdgeType());
+        lqw.eq(StringUtils.isNotBlank(bo.getPackaging()), WmsDeliveryWaybillDetail::getPackaging, bo.getPackaging());
+        lqw.eq(StringUtils.isNotBlank(bo.getSettlementType()), WmsDeliveryWaybillDetail::getSettlementType, bo.getSettlementType());
+        lqw.eq(StringUtils.isNotBlank(bo.getRawMaterialFactory()), WmsDeliveryWaybillDetail::getRawMaterialFactory, bo.getRawMaterialFactory());
+        lqw.eq(StringUtils.isNotBlank(bo.getCoilNo()), WmsDeliveryWaybillDetail::getCoilNo, bo.getCoilNo());
+        lqw.eq(StringUtils.isNotBlank(bo.getSpecification()), WmsDeliveryWaybillDetail::getSpecification, bo.getSpecification());
+        lqw.eq(StringUtils.isNotBlank(bo.getMaterial()), WmsDeliveryWaybillDetail::getMaterial, bo.getMaterial());
+        lqw.eq(bo.getQuantity() != null, WmsDeliveryWaybillDetail::getQuantity, bo.getQuantity());
+        lqw.eq(bo.getWeight() != null, WmsDeliveryWaybillDetail::getWeight, bo.getWeight());
+        lqw.eq(bo.getUnitPrice() != null, WmsDeliveryWaybillDetail::getUnitPrice, bo.getUnitPrice());
+        return lqw;
+    }
+
+    /**
+     * 新增发货单明细
+     */
+    @Override
+    public Boolean insertByBo(WmsDeliveryWaybillDetailBo bo) {
+        WmsDeliveryWaybillDetail add = BeanUtil.toBean(bo, WmsDeliveryWaybillDetail.class);
+        validEntityBeforeSave(add);
+        boolean flag = baseMapper.insert(add) > 0;
+        if (flag) {
+            bo.setDetailId(add.getDetailId());
+        }
+        return flag;
+    }
+
+    /**
+     * 修改发货单明细
+     */
+    @Override
+    public Boolean updateByBo(WmsDeliveryWaybillDetailBo bo) {
+        WmsDeliveryWaybillDetail update = BeanUtil.toBean(bo, WmsDeliveryWaybillDetail.class);
+        validEntityBeforeSave(update);
+        return baseMapper.updateById(update) > 0;
+    }
+
+    /**
+     * 保存前的数据校验
+     */
+    private void validEntityBeforeSave(WmsDeliveryWaybillDetail entity){
+        //TODO 做一些数据校验,如唯一约束
+    }
+
+    /**
+     * 批量删除发货单明细
+     */
+    @Override
+    public Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid) {
+        if(isValid){
+            //TODO 做一些业务上的校验,判断是否需要校验
+        }
+        return baseMapper.deleteBatchIds(ids) > 0;
+    }
+}

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

@@ -0,0 +1,120 @@
+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.WmsDeliveryWaybillBo;
+import com.klp.domain.vo.WmsDeliveryWaybillVo;
+import com.klp.domain.WmsDeliveryWaybill;
+import com.klp.mapper.WmsDeliveryWaybillMapper;
+import com.klp.service.IWmsDeliveryWaybillService;
+
+import java.util.List;
+import java.util.Map;
+import java.util.Collection;
+
+/**
+ * 发货单主Service业务层处理
+ *
+ * @author klp
+ * @date 2025-11-25
+ */
+@RequiredArgsConstructor
+@Service
+public class WmsDeliveryWaybillServiceImpl implements IWmsDeliveryWaybillService {
+
+    private final WmsDeliveryWaybillMapper baseMapper;
+
+    /**
+     * 查询发货单主
+     */
+    @Override
+    public WmsDeliveryWaybillVo queryById(Long waybillId){
+        return baseMapper.selectVoById(waybillId);
+    }
+
+    /**
+     * 查询发货单主列表
+     */
+    @Override
+    public TableDataInfo<WmsDeliveryWaybillVo> queryPageList(WmsDeliveryWaybillBo bo, PageQuery pageQuery) {
+        LambdaQueryWrapper<WmsDeliveryWaybill> lqw = buildQueryWrapper(bo);
+        Page<WmsDeliveryWaybillVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
+        return TableDataInfo.build(result);
+    }
+
+    /**
+     * 查询发货单主列表
+     */
+    @Override
+    public List<WmsDeliveryWaybillVo> queryList(WmsDeliveryWaybillBo bo) {
+        LambdaQueryWrapper<WmsDeliveryWaybill> lqw = buildQueryWrapper(bo);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    private LambdaQueryWrapper<WmsDeliveryWaybill> buildQueryWrapper(WmsDeliveryWaybillBo bo) {
+        Map<String, Object> params = bo.getParams();
+        LambdaQueryWrapper<WmsDeliveryWaybill> lqw = Wrappers.lambdaQuery();
+        lqw.eq(StringUtils.isNotBlank(bo.getWaybillNo()), WmsDeliveryWaybill::getWaybillNo, bo.getWaybillNo());
+        lqw.like(StringUtils.isNotBlank(bo.getWaybillName()), WmsDeliveryWaybill::getWaybillName, bo.getWaybillName());
+        lqw.eq(bo.getPlanId() != null, WmsDeliveryWaybill::getPlanId, bo.getPlanId());
+        lqw.eq(StringUtils.isNotBlank(bo.getLicensePlate()), WmsDeliveryWaybill::getLicensePlate, bo.getLicensePlate());
+        lqw.eq(StringUtils.isNotBlank(bo.getConsigneeUnit()), WmsDeliveryWaybill::getConsigneeUnit, bo.getConsigneeUnit());
+        lqw.eq(StringUtils.isNotBlank(bo.getSenderUnit()), WmsDeliveryWaybill::getSenderUnit, bo.getSenderUnit());
+        lqw.eq(bo.getDeliveryTime() != null, WmsDeliveryWaybill::getDeliveryTime, bo.getDeliveryTime());
+        lqw.eq(StringUtils.isNotBlank(bo.getWeighbridge()), WmsDeliveryWaybill::getWeighbridge, bo.getWeighbridge());
+        lqw.eq(StringUtils.isNotBlank(bo.getSalesPerson()), WmsDeliveryWaybill::getSalesPerson, bo.getSalesPerson());
+        lqw.eq(StringUtils.isNotBlank(bo.getPrincipal()), WmsDeliveryWaybill::getPrincipal, bo.getPrincipal());
+        lqw.eq(StringUtils.isNotBlank(bo.getPrincipalPhone()), WmsDeliveryWaybill::getPrincipalPhone, bo.getPrincipalPhone());
+        lqw.eq(bo.getStatus() != null, WmsDeliveryWaybill::getStatus, bo.getStatus());
+        return lqw;
+    }
+
+    /**
+     * 新增发货单主
+     */
+    @Override
+    public Boolean insertByBo(WmsDeliveryWaybillBo bo) {
+        WmsDeliveryWaybill add = BeanUtil.toBean(bo, WmsDeliveryWaybill.class);
+        validEntityBeforeSave(add);
+        boolean flag = baseMapper.insert(add) > 0;
+        if (flag) {
+            bo.setWaybillId(add.getWaybillId());
+        }
+        return flag;
+    }
+
+    /**
+     * 修改发货单主
+     */
+    @Override
+    public Boolean updateByBo(WmsDeliveryWaybillBo bo) {
+        WmsDeliveryWaybill update = BeanUtil.toBean(bo, WmsDeliveryWaybill.class);
+        validEntityBeforeSave(update);
+        return baseMapper.updateById(update) > 0;
+    }
+
+    /**
+     * 保存前的数据校验
+     */
+    private void validEntityBeforeSave(WmsDeliveryWaybill entity){
+        //TODO 做一些数据校验,如唯一约束
+    }
+
+    /**
+     * 批量删除发货单主
+     */
+    @Override
+    public Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid) {
+        if(isValid){
+            //TODO 做一些业务上的校验,判断是否需要校验
+        }
+        return baseMapper.deleteBatchIds(ids) > 0;
+    }
+}