feat(wms): 添加考勤规则管理功能

- 创建考勤规则实体类WmsAttendanceRule，包含迟到、早退、旷工相关配置字段
- 实现考勤规则业务对象WmsAttendanceRuleBo和视图对象WmsAttendanceRuleVo
- 开发考勤规则服务接口IWmsAttendanceRuleService及其实现类
- 构建考勤规则控制器WmsAttendanceRuleController，提供增删改查API
- 配置考勤规则数据访问层WmsAttendanceRuleMapper及对应的XML映射文件
- 实现考勤规则列表查询、详情获取、新增修改、删除导出等功能
- 添加数据验证、分页查询、Excel导出等基础功能支持

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

@@ -0,0 +1,99 @@
+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.WmsAttendanceRuleVo;
+import com.klp.domain.bo.WmsAttendanceRuleBo;
+import com.klp.service.IWmsAttendanceRuleService;
+import com.klp.common.core.page.TableDataInfo;
+
+/**
+ * 考勤规则（迟到/早退/旷工规则配置）
+ *
+ * @author klp
+ * @date 2026-05-12
+ */
+@Validated
+@RequiredArgsConstructor
+@RestController
+@RequestMapping("/wms/attendanceRule")
+public class WmsAttendanceRuleController extends BaseController {
+
+    private final IWmsAttendanceRuleService iWmsAttendanceRuleService;
+
+    /**
+     * 查询考勤规则（迟到/早退/旷工规则配置）列表
+     */
+    @GetMapping("/list")
+    public TableDataInfo<WmsAttendanceRuleVo> list(WmsAttendanceRuleBo bo, PageQuery pageQuery) {
+        return iWmsAttendanceRuleService.queryPageList(bo, pageQuery);
+    }
+
+    /**
+     * 导出考勤规则（迟到/早退/旷工规则配置）列表
+     */
+    @Log(title = "考勤规则（迟到/早退/旷工规则配置）", businessType = BusinessType.EXPORT)
+    @PostMapping("/export")
+    public void export(WmsAttendanceRuleBo bo, HttpServletResponse response) {
+        List<WmsAttendanceRuleVo> list = iWmsAttendanceRuleService.queryList(bo);
+        ExcelUtil.exportExcel(list, "考勤规则（迟到/早退/旷工规则配置）", WmsAttendanceRuleVo.class, response);
+    }
+
+    /**
+     * 获取考勤规则（迟到/早退/旷工规则配置）详细信息
+     *
+     * @param ruleId 主键
+     */
+    @GetMapping("/{ruleId}")
+    public R<WmsAttendanceRuleVo> getInfo(@NotNull(message = "主键不能为空")
+                                     @PathVariable Long ruleId) {
+        return R.ok(iWmsAttendanceRuleService.queryById(ruleId));
+    }
+
+    /**
+     * 新增考勤规则（迟到/早退/旷工规则配置）
+     */
+    @Log(title = "考勤规则（迟到/早退/旷工规则配置）", businessType = BusinessType.INSERT)
+    @RepeatSubmit()
+    @PostMapping()
+    public R<Void> add(@Validated(AddGroup.class) @RequestBody WmsAttendanceRuleBo bo) {
+        return toAjax(iWmsAttendanceRuleService.insertByBo(bo));
+    }
+
+    /**
+     * 修改考勤规则（迟到/早退/旷工规则配置）
+     */
+    @Log(title = "考勤规则（迟到/早退/旷工规则配置）", businessType = BusinessType.UPDATE)
+    @RepeatSubmit()
+    @PutMapping()
+    public R<Void> edit(@Validated(EditGroup.class) @RequestBody WmsAttendanceRuleBo bo) {
+        return toAjax(iWmsAttendanceRuleService.updateByBo(bo));
+    }
+
+    /**
+     * 删除考勤规则（迟到/早退/旷工规则配置）
+     *
+     * @param ruleIds 主键串
+     */
+    @Log(title = "考勤规则（迟到/早退/旷工规则配置）", businessType = BusinessType.DELETE)
+    @DeleteMapping("/{ruleIds}")
+    public R<Void> remove(@NotEmpty(message = "主键不能为空")
+                          @PathVariable Long[] ruleIds) {
+        return toAjax(iWmsAttendanceRuleService.deleteWithValidByIds(Arrays.asList(ruleIds), true));
+    }
+}

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

@@ -0,0 +1,66 @@
+package com.klp.domain;
+
+import com.baomidou.mybatisplus.annotation.*;
+import com.klp.common.core.domain.BaseEntity;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.math.BigDecimal;
+
+/**
+ * 考勤规则（迟到/早退/旷工规则配置）对象 wms_attendance_rule
+ *
+ * @author klp
+ * @date 2026-05-12
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@TableName("wms_attendance_rule")
+public class WmsAttendanceRule extends BaseEntity {
+
+    private static final long serialVersionUID=1L;
+
+    /**
+     * 主键ID
+     */
+    @TableId(value = "rule_id")
+    private Long ruleId;
+    /**
+     * 迟到警告阈值（分钟内仅警告，不扣款）
+     */
+    private Long lateWarn;
+    /**
+     * 迟到一级阈值（分钟）
+     */
+    private Long late1;
+    /**
+     * 迟到二级阈值（分钟）
+     */
+    private Long late2;
+    /**
+     * 迟到一级扣款（元/次）
+     */
+    private BigDecimal deduct1;
+    /**
+     * 迟到二级扣款（元/次）
+     */
+    private BigDecimal deduct2;
+    /**
+     * 超过多少分钟按旷工半天处理
+     */
+    private Long absentHalfDay;
+    /**
+     * 连续旷工多少天自动离职
+     */
+    private Long continuousAbsentDays;
+    /**
+     * 备注
+     */
+    private String remark;
+    /**
+     * 删除标记(0正常 1删除)
+     */
+    @TableLogic
+    private Long delFlag;
+
+}

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

@@ -0,0 +1,67 @@
+package com.klp.domain.bo;
+
+import com.klp.common.core.domain.BaseEntity;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import javax.validation.constraints.*;
+
+import java.math.BigDecimal;
+
+/**
+ * 考勤规则（迟到/早退/旷工规则配置）业务对象 wms_attendance_rule
+ *
+ * @author klp
+ * @date 2026-05-12
+ */
+
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class WmsAttendanceRuleBo extends BaseEntity {
+
+    /**
+     * 主键ID
+     */
+    private Long ruleId;
+
+    /**
+     * 迟到警告阈值（分钟内仅警告，不扣款）
+     */
+    private Long lateWarn;
+
+    /**
+     * 迟到一级阈值（分钟）
+     */
+    private Long late1;
+
+    /**
+     * 迟到二级阈值（分钟）
+     */
+    private Long late2;
+
+    /**
+     * 迟到一级扣款（元/次）
+     */
+    private BigDecimal deduct1;
+
+    /**
+     * 迟到二级扣款（元/次）
+     */
+    private BigDecimal deduct2;
+
+    /**
+     * 超过多少分钟按旷工半天处理
+     */
+    private Long absentHalfDay;
+
+    /**
+     * 连续旷工多少天自动离职
+     */
+    private Long continuousAbsentDays;
+
+    /**
+     * 备注
+     */
+    private String remark;
+
+
+}

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

@@ -0,0 +1,83 @@
+package com.klp.domain.vo;
+
+import java.math.BigDecimal;
+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_attendance_rule
+ *
+ * @author klp
+ * @date 2026-05-12
+ */
+@Data
+@ExcelIgnoreUnannotated
+public class WmsAttendanceRuleVo {
+
+    private static final long serialVersionUID = 1L;
+
+    /**
+     * 主键ID
+     */
+    @ExcelProperty(value = "主键ID")
+    private Long ruleId;
+
+    /**
+     * 迟到警告阈值（分钟内仅警告，不扣款）
+     */
+    @ExcelProperty(value = "迟到警告阈值", converter = ExcelDictConvert.class)
+    @ExcelDictFormat(readConverterExp = "分=钟内仅警告，不扣款")
+    private Long lateWarn;
+
+    /**
+     * 迟到一级阈值（分钟）
+     */
+    @ExcelProperty(value = "迟到一级阈值", converter = ExcelDictConvert.class)
+    @ExcelDictFormat(readConverterExp = "分=钟")
+    private Long late1;
+
+    /**
+     * 迟到二级阈值（分钟）
+     */
+    @ExcelProperty(value = "迟到二级阈值", converter = ExcelDictConvert.class)
+    @ExcelDictFormat(readConverterExp = "分=钟")
+    private Long late2;
+
+    /**
+     * 迟到一级扣款（元/次）
+     */
+    @ExcelProperty(value = "迟到一级扣款", converter = ExcelDictConvert.class)
+    @ExcelDictFormat(readConverterExp = "元=/次")
+    private BigDecimal deduct1;
+
+    /**
+     * 迟到二级扣款（元/次）
+     */
+    @ExcelProperty(value = "迟到二级扣款", converter = ExcelDictConvert.class)
+    @ExcelDictFormat(readConverterExp = "元=/次")
+    private BigDecimal deduct2;
+
+    /**
+     * 超过多少分钟按旷工半天处理
+     */
+    @ExcelProperty(value = "超过多少分钟按旷工半天处理")
+    private Long absentHalfDay;
+
+    /**
+     * 连续旷工多少天自动离职
+     */
+    @ExcelProperty(value = "连续旷工多少天自动离职")
+    private Long continuousAbsentDays;
+
+    /**
+     * 备注
+     */
+    @ExcelProperty(value = "备注")
+    private String remark;
+
+
+}

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

@@ -0,0 +1,15 @@
+package com.klp.mapper;
+
+import com.klp.domain.WmsAttendanceRule;
+import com.klp.domain.vo.WmsAttendanceRuleVo;
+import com.klp.common.core.mapper.BaseMapperPlus;
+
+/**
+ * 考勤规则（迟到/早退/旷工规则配置）Mapper接口
+ *
+ * @author klp
+ * @date 2026-05-12
+ */
+public interface WmsAttendanceRuleMapper extends BaseMapperPlus<WmsAttendanceRuleMapper, WmsAttendanceRule, WmsAttendanceRuleVo> {
+
+}

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

@@ -0,0 +1,49 @@
+package com.klp.service;
+
+import com.klp.domain.WmsAttendanceRule;
+import com.klp.domain.vo.WmsAttendanceRuleVo;
+import com.klp.domain.bo.WmsAttendanceRuleBo;
+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-12
+ */
+public interface IWmsAttendanceRuleService {
+
+    /**
+     * 查询考勤规则（迟到/早退/旷工规则配置）
+     */
+    WmsAttendanceRuleVo queryById(Long ruleId);
+
+    /**
+     * 查询考勤规则（迟到/早退/旷工规则配置）列表
+     */
+    TableDataInfo<WmsAttendanceRuleVo> queryPageList(WmsAttendanceRuleBo bo, PageQuery pageQuery);
+
+    /**
+     * 查询考勤规则（迟到/早退/旷工规则配置）列表
+     */
+    List<WmsAttendanceRuleVo> queryList(WmsAttendanceRuleBo bo);
+
+    /**
+     * 新增考勤规则（迟到/早退/旷工规则配置）
+     */
+    Boolean insertByBo(WmsAttendanceRuleBo bo);
+
+    /**
+     * 修改考勤规则（迟到/早退/旷工规则配置）
+     */
+    Boolean updateByBo(WmsAttendanceRuleBo bo);
+
+    /**
+     * 校验并批量删除考勤规则（迟到/早退/旷工规则配置）信息
+     */
+    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
+}

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

@@ -0,0 +1,114 @@
+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.WmsAttendanceRuleBo;
+import com.klp.domain.vo.WmsAttendanceRuleVo;
+import com.klp.domain.WmsAttendanceRule;
+import com.klp.mapper.WmsAttendanceRuleMapper;
+import com.klp.service.IWmsAttendanceRuleService;
+
+import java.util.List;
+import java.util.Map;
+import java.util.Collection;
+
+/**
+ * 考勤规则（迟到/早退/旷工规则配置）Service业务层处理
+ *
+ * @author klp
+ * @date 2026-05-12
+ */
+@RequiredArgsConstructor
+@Service
+public class WmsAttendanceRuleServiceImpl implements IWmsAttendanceRuleService {
+
+    private final WmsAttendanceRuleMapper baseMapper;
+
+    /**
+     * 查询考勤规则（迟到/早退/旷工规则配置）
+     */
+    @Override
+    public WmsAttendanceRuleVo queryById(Long ruleId){
+        return baseMapper.selectVoById(ruleId);
+    }
+
+    /**
+     * 查询考勤规则（迟到/早退/旷工规则配置）列表
+     */
+    @Override
+    public TableDataInfo<WmsAttendanceRuleVo> queryPageList(WmsAttendanceRuleBo bo, PageQuery pageQuery) {
+        LambdaQueryWrapper<WmsAttendanceRule> lqw = buildQueryWrapper(bo);
+        Page<WmsAttendanceRuleVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
+        return TableDataInfo.build(result);
+    }
+
+    /**
+     * 查询考勤规则（迟到/早退/旷工规则配置）列表
+     */
+    @Override
+    public List<WmsAttendanceRuleVo> queryList(WmsAttendanceRuleBo bo) {
+        LambdaQueryWrapper<WmsAttendanceRule> lqw = buildQueryWrapper(bo);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    private LambdaQueryWrapper<WmsAttendanceRule> buildQueryWrapper(WmsAttendanceRuleBo bo) {
+        Map<String, Object> params = bo.getParams();
+        LambdaQueryWrapper<WmsAttendanceRule> lqw = Wrappers.lambdaQuery();
+        lqw.eq(bo.getLateWarn() != null, WmsAttendanceRule::getLateWarn, bo.getLateWarn());
+        lqw.eq(bo.getLate1() != null, WmsAttendanceRule::getLate1, bo.getLate1());
+        lqw.eq(bo.getLate2() != null, WmsAttendanceRule::getLate2, bo.getLate2());
+        lqw.eq(bo.getDeduct1() != null, WmsAttendanceRule::getDeduct1, bo.getDeduct1());
+        lqw.eq(bo.getDeduct2() != null, WmsAttendanceRule::getDeduct2, bo.getDeduct2());
+        lqw.eq(bo.getAbsentHalfDay() != null, WmsAttendanceRule::getAbsentHalfDay, bo.getAbsentHalfDay());
+        lqw.eq(bo.getContinuousAbsentDays() != null, WmsAttendanceRule::getContinuousAbsentDays, bo.getContinuousAbsentDays());
+        return lqw;
+    }
+
+    /**
+     * 新增考勤规则（迟到/早退/旷工规则配置）
+     */
+    @Override
+    public Boolean insertByBo(WmsAttendanceRuleBo bo) {
+        WmsAttendanceRule add = BeanUtil.toBean(bo, WmsAttendanceRule.class);
+        validEntityBeforeSave(add);
+        boolean flag = baseMapper.insert(add) > 0;
+        if (flag) {
+            bo.setRuleId(add.getRuleId());
+        }
+        return flag;
+    }
+
+    /**
+     * 修改考勤规则（迟到/早退/旷工规则配置）
+     */
+    @Override
+    public Boolean updateByBo(WmsAttendanceRuleBo bo) {
+        WmsAttendanceRule update = BeanUtil.toBean(bo, WmsAttendanceRule.class);
+        validEntityBeforeSave(update);
+        return baseMapper.updateById(update) > 0;
+    }
+
+    /**
+     * 保存前的数据校验
+     */
+    private void validEntityBeforeSave(WmsAttendanceRule entity){
+        //TODO 做一些数据校验,如唯一约束
+    }
+
+    /**
+     * 批量删除考勤规则（迟到/早退/旷工规则配置）
+     */
+    @Override
+    public Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid) {
+        if(isValid){
+            //TODO 做一些业务上的校验,判断是否需要校验
+        }
+        return baseMapper.deleteBatchIds(ids) > 0;
+    }
+}

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

@@ -0,0 +1,25 @@
+<?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.WmsAttendanceRuleMapper">
+
+    <resultMap type="com.klp.domain.WmsAttendanceRule" id="WmsAttendanceRuleResult">
+        <result property="ruleId" column="rule_id"/>
+        <result property="lateWarn" column="late_warn"/>
+        <result property="late1" column="late_1"/>
+        <result property="late2" column="late_2"/>
+        <result property="deduct1" column="deduct_1"/>
+        <result property="deduct2" column="deduct_2"/>
+        <result property="absentHalfDay" column="absent_half_day"/>
+        <result property="continuousAbsentDays" column="continuous_absent_days"/>
+        <result property="remark" column="remark"/>
+        <result property="delFlag" column="del_flag"/>
+        <result property="createBy" column="create_by"/>
+        <result property="updateBy" column="update_by"/>
+        <result property="createTime" column="create_time"/>
+        <result property="updateTime" column="update_time"/>
+    </resultMap>
+
+
+</mapper>