feat(wms): 添加考勤排班、班次及倒班规则功能模块

- 新增 IWmsAttendanceScheduleService 接口及其实现类
- 新增 IWmsAttendanceShiftService 接口及其实现类
- 新增 IWmsAttendanceShiftRuleService 接口及其实现类
- 添加 WmsAttendanceSchedule、WmsAttendanceShift、WmsAttendanceShiftRule 实体类
- 创建对应的 BO 和 VO 类用于数据传输
- 添加 WmsAttendanceScheduleController、WmsAttendanceShiftController、WmsAttendanceShiftRuleController 控制器
- 新增相应的 Mapper 接口和 XML 映射文件
- 实现分页查询、新增、修改、删除等基础功能
- 集成 Excel 导出功能和数据校验机制

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

@@ -0,0 +1,49 @@
+package com.klp.service;
+
+import com.klp.domain.WmsAttendanceSchedule;
+import com.klp.domain.vo.WmsAttendanceScheduleVo;
+import com.klp.domain.bo.WmsAttendanceScheduleBo;
+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-05-08
+ */
+public interface IWmsAttendanceScheduleService {
+
+    /**
+     * 查询排班(谁在哪天上班)
+     */
+    WmsAttendanceScheduleVo queryById(Long scheduleId);
+
+    /**
+     * 查询排班(谁在哪天上班)列表
+     */
+    TableDataInfo<WmsAttendanceScheduleVo> queryPageList(WmsAttendanceScheduleBo bo, PageQuery pageQuery);
+
+    /**
+     * 查询排班(谁在哪天上班)列表
+     */
+    List<WmsAttendanceScheduleVo> queryList(WmsAttendanceScheduleBo bo);
+
+    /**
+     * 新增排班(谁在哪天上班)
+     */
+    Boolean insertByBo(WmsAttendanceScheduleBo bo);
+
+    /**
+     * 修改排班(谁在哪天上班)
+     */
+    Boolean updateByBo(WmsAttendanceScheduleBo bo);
+
+    /**
+     * 校验并批量删除排班(谁在哪天上班)信息
+     */
+    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
+}

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

@@ -0,0 +1,49 @@
+package com.klp.service;
+
+import com.klp.domain.WmsAttendanceShiftRule;
+import com.klp.domain.vo.WmsAttendanceShiftRuleVo;
+import com.klp.domain.bo.WmsAttendanceShiftRuleBo;
+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-05-08
+ */
+public interface IWmsAttendanceShiftRuleService {
+
+    /**
+     * 查询倒班规则（支持按日期或按周期自动切换班次）
+     */
+    WmsAttendanceShiftRuleVo queryById(Long ruleId);
+
+    /**
+     * 查询倒班规则（支持按日期或按周期自动切换班次）列表
+     */
+    TableDataInfo<WmsAttendanceShiftRuleVo> queryPageList(WmsAttendanceShiftRuleBo bo, PageQuery pageQuery);
+
+    /**
+     * 查询倒班规则（支持按日期或按周期自动切换班次）列表
+     */
+    List<WmsAttendanceShiftRuleVo> queryList(WmsAttendanceShiftRuleBo bo);
+
+    /**
+     * 新增倒班规则（支持按日期或按周期自动切换班次）
+     */
+    Boolean insertByBo(WmsAttendanceShiftRuleBo bo);
+
+    /**
+     * 修改倒班规则（支持按日期或按周期自动切换班次）
+     */
+    Boolean updateByBo(WmsAttendanceShiftRuleBo bo);
+
+    /**
+     * 校验并批量删除倒班规则（支持按日期或按周期自动切换班次）信息
+     */
+    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
+}

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

@@ -0,0 +1,49 @@
+package com.klp.service;
+
+import com.klp.domain.WmsAttendanceShift;
+import com.klp.domain.vo.WmsAttendanceShiftVo;
+import com.klp.domain.bo.WmsAttendanceShiftBo;
+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-05-08
+ */
+public interface IWmsAttendanceShiftService {
+
+    /**
+     * 查询班次
+     */
+    WmsAttendanceShiftVo queryById(Long shiftId);
+
+    /**
+     * 查询班次列表
+     */
+    TableDataInfo<WmsAttendanceShiftVo> queryPageList(WmsAttendanceShiftBo bo, PageQuery pageQuery);
+
+    /**
+     * 查询班次列表
+     */
+    List<WmsAttendanceShiftVo> queryList(WmsAttendanceShiftBo bo);
+
+    /**
+     * 新增班次
+     */
+    Boolean insertByBo(WmsAttendanceShiftBo bo);
+
+    /**
+     * 修改班次
+     */
+    Boolean updateByBo(WmsAttendanceShiftBo bo);
+
+    /**
+     * 校验并批量删除班次信息
+     */
+    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
+}

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

@@ -0,0 +1,113 @@
+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.WmsAttendanceScheduleBo;
+import com.klp.domain.vo.WmsAttendanceScheduleVo;
+import com.klp.domain.WmsAttendanceSchedule;
+import com.klp.mapper.WmsAttendanceScheduleMapper;
+import com.klp.service.IWmsAttendanceScheduleService;
+
+import java.util.List;
+import java.util.Map;
+import java.util.Collection;
+
+/**
+ * 排班(谁在哪天上班)Service业务层处理
+ *
+ * @author klp
+ * @date 2026-05-08
+ */
+@RequiredArgsConstructor
+@Service
+public class WmsAttendanceScheduleServiceImpl implements IWmsAttendanceScheduleService {
+
+    private final WmsAttendanceScheduleMapper baseMapper;
+
+    /**
+     * 查询排班(谁在哪天上班)
+     */
+    @Override
+    public WmsAttendanceScheduleVo queryById(Long scheduleId){
+        return baseMapper.selectVoById(scheduleId);
+    }
+
+    /**
+     * 查询排班(谁在哪天上班)列表
+     */
+    @Override
+    public TableDataInfo<WmsAttendanceScheduleVo> queryPageList(WmsAttendanceScheduleBo bo, PageQuery pageQuery) {
+        LambdaQueryWrapper<WmsAttendanceSchedule> lqw = buildQueryWrapper(bo);
+        Page<WmsAttendanceScheduleVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
+        return TableDataInfo.build(result);
+    }
+
+    /**
+     * 查询排班(谁在哪天上班)列表
+     */
+    @Override
+    public List<WmsAttendanceScheduleVo> queryList(WmsAttendanceScheduleBo bo) {
+        LambdaQueryWrapper<WmsAttendanceSchedule> lqw = buildQueryWrapper(bo);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    private LambdaQueryWrapper<WmsAttendanceSchedule> buildQueryWrapper(WmsAttendanceScheduleBo bo) {
+        Map<String, Object> params = bo.getParams();
+        LambdaQueryWrapper<WmsAttendanceSchedule> lqw = Wrappers.lambdaQuery();
+        lqw.eq(bo.getUserId() != null, WmsAttendanceSchedule::getUserId, bo.getUserId());
+        lqw.eq(bo.getWorkDate() != null, WmsAttendanceSchedule::getWorkDate, bo.getWorkDate());
+        lqw.eq(bo.getShiftId() != null, WmsAttendanceSchedule::getShiftId, bo.getShiftId());
+        lqw.like(StringUtils.isNotBlank(bo.getShiftName()), WmsAttendanceSchedule::getShiftName, bo.getShiftName());
+        lqw.eq(StringUtils.isNotBlank(bo.getShiftGroup()), WmsAttendanceSchedule::getShiftGroup, bo.getShiftGroup());
+        return lqw;
+    }
+
+    /**
+     * 新增排班(谁在哪天上班)
+     */
+    @Override
+    public Boolean insertByBo(WmsAttendanceScheduleBo bo) {
+        WmsAttendanceSchedule add = BeanUtil.toBean(bo, WmsAttendanceSchedule.class);
+        validEntityBeforeSave(add);
+        boolean flag = baseMapper.insert(add) > 0;
+        if (flag) {
+            bo.setScheduleId(add.getScheduleId());
+        }
+        return flag;
+    }
+
+    /**
+     * 修改排班(谁在哪天上班)
+     */
+    @Override
+    public Boolean updateByBo(WmsAttendanceScheduleBo bo) {
+        WmsAttendanceSchedule update = BeanUtil.toBean(bo, WmsAttendanceSchedule.class);
+        validEntityBeforeSave(update);
+        return baseMapper.updateById(update) > 0;
+    }
+
+    /**
+     * 保存前的数据校验
+     */
+    private void validEntityBeforeSave(WmsAttendanceSchedule 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/WmsAttendanceShiftRuleServiceImpl.java

@@ -0,0 +1,113 @@
+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.WmsAttendanceShiftRuleBo;
+import com.klp.domain.vo.WmsAttendanceShiftRuleVo;
+import com.klp.domain.WmsAttendanceShiftRule;
+import com.klp.mapper.WmsAttendanceShiftRuleMapper;
+import com.klp.service.IWmsAttendanceShiftRuleService;
+
+import java.util.List;
+import java.util.Map;
+import java.util.Collection;
+
+/**
+ * 倒班规则（支持按日期或按周期自动切换班次）Service业务层处理
+ *
+ * @author klp
+ * @date 2026-05-08
+ */
+@RequiredArgsConstructor
+@Service
+public class WmsAttendanceShiftRuleServiceImpl implements IWmsAttendanceShiftRuleService {
+
+    private final WmsAttendanceShiftRuleMapper baseMapper;
+
+    /**
+     * 查询倒班规则（支持按日期或按周期自动切换班次）
+     */
+    @Override
+    public WmsAttendanceShiftRuleVo queryById(Long ruleId){
+        return baseMapper.selectVoById(ruleId);
+    }
+
+    /**
+     * 查询倒班规则（支持按日期或按周期自动切换班次）列表
+     */
+    @Override
+    public TableDataInfo<WmsAttendanceShiftRuleVo> queryPageList(WmsAttendanceShiftRuleBo bo, PageQuery pageQuery) {
+        LambdaQueryWrapper<WmsAttendanceShiftRule> lqw = buildQueryWrapper(bo);
+        Page<WmsAttendanceShiftRuleVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
+        return TableDataInfo.build(result);
+    }
+
+    /**
+     * 查询倒班规则（支持按日期或按周期自动切换班次）列表
+     */
+    @Override
+    public List<WmsAttendanceShiftRuleVo> queryList(WmsAttendanceShiftRuleBo bo) {
+        LambdaQueryWrapper<WmsAttendanceShiftRule> lqw = buildQueryWrapper(bo);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    private LambdaQueryWrapper<WmsAttendanceShiftRule> buildQueryWrapper(WmsAttendanceShiftRuleBo bo) {
+        Map<String, Object> params = bo.getParams();
+        LambdaQueryWrapper<WmsAttendanceShiftRule> lqw = Wrappers.lambdaQuery();
+        lqw.eq(StringUtils.isNotBlank(bo.getRuleType()), WmsAttendanceShiftRule::getRuleType, bo.getRuleType());
+        lqw.eq(StringUtils.isNotBlank(bo.getChangeDays()), WmsAttendanceShiftRule::getChangeDays, bo.getChangeDays());
+        lqw.eq(bo.getCycleDays() != null, WmsAttendanceShiftRule::getCycleDays, bo.getCycleDays());
+        lqw.eq(bo.getShiftA() != null, WmsAttendanceShiftRule::getShiftA, bo.getShiftA());
+        lqw.eq(bo.getShiftB() != null, WmsAttendanceShiftRule::getShiftB, bo.getShiftB());
+        return lqw;
+    }
+
+    /**
+     * 新增倒班规则（支持按日期或按周期自动切换班次）
+     */
+    @Override
+    public Boolean insertByBo(WmsAttendanceShiftRuleBo bo) {
+        WmsAttendanceShiftRule add = BeanUtil.toBean(bo, WmsAttendanceShiftRule.class);
+        validEntityBeforeSave(add);
+        boolean flag = baseMapper.insert(add) > 0;
+        if (flag) {
+            bo.setRuleId(add.getRuleId());
+        }
+        return flag;
+    }
+
+    /**
+     * 修改倒班规则（支持按日期或按周期自动切换班次）
+     */
+    @Override
+    public Boolean updateByBo(WmsAttendanceShiftRuleBo bo) {
+        WmsAttendanceShiftRule update = BeanUtil.toBean(bo, WmsAttendanceShiftRule.class);
+        validEntityBeforeSave(update);
+        return baseMapper.updateById(update) > 0;
+    }
+
+    /**
+     * 保存前的数据校验
+     */
+    private void validEntityBeforeSave(WmsAttendanceShiftRule 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/WmsAttendanceShiftServiceImpl.java

@@ -0,0 +1,117 @@
+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.WmsAttendanceShiftBo;
+import com.klp.domain.vo.WmsAttendanceShiftVo;
+import com.klp.domain.WmsAttendanceShift;
+import com.klp.mapper.WmsAttendanceShiftMapper;
+import com.klp.service.IWmsAttendanceShiftService;
+
+import java.util.List;
+import java.util.Map;
+import java.util.Collection;
+
+/**
+ * 班次Service业务层处理
+ *
+ * @author klp
+ * @date 2026-05-08
+ */
+@RequiredArgsConstructor
+@Service
+public class WmsAttendanceShiftServiceImpl implements IWmsAttendanceShiftService {
+
+    private final WmsAttendanceShiftMapper baseMapper;
+
+    /**
+     * 查询班次
+     */
+    @Override
+    public WmsAttendanceShiftVo queryById(Long shiftId){
+        return baseMapper.selectVoById(shiftId);
+    }
+
+    /**
+     * 查询班次列表
+     */
+    @Override
+    public TableDataInfo<WmsAttendanceShiftVo> queryPageList(WmsAttendanceShiftBo bo, PageQuery pageQuery) {
+        LambdaQueryWrapper<WmsAttendanceShift> lqw = buildQueryWrapper(bo);
+        Page<WmsAttendanceShiftVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
+        return TableDataInfo.build(result);
+    }
+
+    /**
+     * 查询班次列表
+     */
+    @Override
+    public List<WmsAttendanceShiftVo> queryList(WmsAttendanceShiftBo bo) {
+        LambdaQueryWrapper<WmsAttendanceShift> lqw = buildQueryWrapper(bo);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    private LambdaQueryWrapper<WmsAttendanceShift> buildQueryWrapper(WmsAttendanceShiftBo bo) {
+        Map<String, Object> params = bo.getParams();
+        LambdaQueryWrapper<WmsAttendanceShift> lqw = Wrappers.lambdaQuery();
+        lqw.like(StringUtils.isNotBlank(bo.getShiftName()), WmsAttendanceShift::getShiftName, bo.getShiftName());
+        lqw.eq(StringUtils.isNotBlank(bo.getShiftType()), WmsAttendanceShift::getShiftType, bo.getShiftType());
+        lqw.eq(StringUtils.isNotBlank(bo.getSeason()), WmsAttendanceShift::getSeason, bo.getSeason());
+        lqw.eq(bo.getStartTime() != null, WmsAttendanceShift::getStartTime, bo.getStartTime());
+        lqw.eq(bo.getEndTime() != null, WmsAttendanceShift::getEndTime, bo.getEndTime());
+        lqw.eq(bo.getStartTime2() != null, WmsAttendanceShift::getStartTime2, bo.getStartTime2());
+        lqw.eq(bo.getEndTime2() != null, WmsAttendanceShift::getEndTime2, bo.getEndTime2());
+        lqw.eq(bo.getIsCrossDay() != null, WmsAttendanceShift::getIsCrossDay, bo.getIsCrossDay());
+        lqw.eq(bo.getWorkHours() != null, WmsAttendanceShift::getWorkHours, bo.getWorkHours());
+        return lqw;
+    }
+
+    /**
+     * 新增班次
+     */
+    @Override
+    public Boolean insertByBo(WmsAttendanceShiftBo bo) {
+        WmsAttendanceShift add = BeanUtil.toBean(bo, WmsAttendanceShift.class);
+        validEntityBeforeSave(add);
+        boolean flag = baseMapper.insert(add) > 0;
+        if (flag) {
+            bo.setShiftId(add.getShiftId());
+        }
+        return flag;
+    }
+
+    /**
+     * 修改班次
+     */
+    @Override
+    public Boolean updateByBo(WmsAttendanceShiftBo bo) {
+        WmsAttendanceShift update = BeanUtil.toBean(bo, WmsAttendanceShift.class);
+        validEntityBeforeSave(update);
+        return baseMapper.updateById(update) > 0;
+    }
+
+    /**
+     * 保存前的数据校验
+     */
+    private void validEntityBeforeSave(WmsAttendanceShift entity){
+        //TODO 做一些数据校验,如唯一约束
+    }
+
+    /**
+     * 批量删除班次
+     */
+    @Override
+    public Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid) {
+        if(isValid){
+            //TODO 做一些业务上的校验,判断是否需要校验
+        }
+        return baseMapper.deleteBatchIds(ids) > 0;
+    }
+}