feat(wms): 添加考勤记录管理功能

- 新增 AttendanceRecords 实体类定义数据库表结构
- 创建 AttendanceRecordsBo 业务对象用于数据传输
- 实现 AttendanceRecordsController 提供 REST API 接口
- 开发 AttendanceRecordsMapper 数据访问层接口
- 实现 AttendanceRecordsServiceImpl 业务逻辑服务
- 定义 AttendanceRecordsVo 视图对象用于数据展示
- 集成 Excel 导出功能支持考勤数据批量导出
- 添加分页查询、条件筛选等数据检索功能

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

@@ -0,0 +1,71 @@
+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.AttendanceRecordsVo;
+import com.klp.domain.bo.AttendanceRecordsBo;
+import com.klp.service.IAttendanceRecordsService;
+import com.klp.common.core.page.TableDataInfo;
+
+@Validated
+@RequiredArgsConstructor
+@RestController
+@RequestMapping("/wms/attendanceRecords")
+public class AttendanceRecordsController extends BaseController {
+
+    private final IAttendanceRecordsService iAttendanceRecordsService;
+
+    @GetMapping("/list")
+    public TableDataInfo<AttendanceRecordsVo> list(AttendanceRecordsBo bo, PageQuery pageQuery) {
+        return iAttendanceRecordsService.queryPageList(bo, pageQuery);
+    }
+
+    @Log(title = "打卡记录", businessType = BusinessType.EXPORT)
+    @PostMapping("/export")
+    public void export(AttendanceRecordsBo bo, HttpServletResponse response) {
+        List<AttendanceRecordsVo> list = iAttendanceRecordsService.queryList(bo);
+        ExcelUtil.exportExcel(list, "打卡记录", AttendanceRecordsVo.class, response);
+    }
+
+    @GetMapping("/{id}")
+    public R<AttendanceRecordsVo> getInfo(@NotNull(message = "主键不能为空")
+                                      @PathVariable Integer id) {
+        return R.ok(iAttendanceRecordsService.queryById(id));
+    }
+
+    @Log(title = "打卡记录", businessType = BusinessType.INSERT)
+    @RepeatSubmit()
+    @PostMapping()
+    public R<Void> add(@Validated(AddGroup.class) @RequestBody AttendanceRecordsBo bo) {
+        return toAjax(iAttendanceRecordsService.insertByBo(bo));
+    }
+
+    @Log(title = "打卡记录", businessType = BusinessType.UPDATE)
+    @RepeatSubmit()
+    @PutMapping()
+    public R<Void> edit(@Validated(EditGroup.class) @RequestBody AttendanceRecordsBo bo) {
+        return toAjax(iAttendanceRecordsService.updateByBo(bo));
+    }
+
+    @Log(title = "打卡记录", businessType = BusinessType.DELETE)
+    @DeleteMapping("/{ids}")
+    public R<Void> remove(@NotEmpty(message = "主键不能为空")
+                          @PathVariable Integer[] ids) {
+        return toAjax(iAttendanceRecordsService.deleteWithValidByIds(Arrays.asList(ids), true));
+    }
+}

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

@@ -0,0 +1,36 @@
+package com.klp.domain;
+
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+
+import java.io.Serializable;
+import java.util.Date;
+
+@Data
+@TableName("attendance_records")
+public class AttendanceRecords implements Serializable {
+
+    private static final long serialVersionUID = 1L;
+
+    @TableId(value = "id")
+    private Integer id;
+
+    private String pin;
+
+    private String ename;
+
+    private String deptname;
+
+    private String sn;
+
+    private Date checktime;
+
+    private Integer verify;
+
+    private Integer stateno;
+
+    private String state;
+
+    private Date createdAt;
+}

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

@@ -0,0 +1,37 @@
+package com.klp.domain.bo;
+
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.util.Date;
+import com.fasterxml.jackson.annotation.JsonFormat;
+
+@Data
+@EqualsAndHashCode(callSuper = false)
+public class AttendanceRecordsBo {
+
+    private Integer id;
+
+    private String pin;
+
+    private String ename;
+
+    private String deptname;
+
+    private String sn;
+
+    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
+    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
+    private Date checktimeStart;
+
+    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
+    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
+    private Date checktimeEnd;
+
+    private Integer verify;
+
+    private Integer stateno;
+
+    private String state;
+}

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

@@ -0,0 +1,47 @@
+package com.klp.domain.vo;
+
+import lombok.Data;
+
+import java.util.Date;
+import com.fasterxml.jackson.annotation.JsonFormat;
+import com.alibaba.excel.annotation.ExcelIgnoreUnannotated;
+import com.alibaba.excel.annotation.ExcelProperty;
+
+@Data
+@ExcelIgnoreUnannotated
+public class AttendanceRecordsVo {
+
+    private static final long serialVersionUID = 1L;
+
+    @ExcelProperty(value = "主键ID")
+    private Integer id;
+
+    @ExcelProperty(value = "人员编号")
+    private String pin;
+
+    @ExcelProperty(value = "姓名")
+    private String ename;
+
+    @ExcelProperty(value = "部门名称")
+    private String deptname;
+
+    @ExcelProperty(value = "设备编号")
+    private String sn;
+
+    @ExcelProperty(value = "打卡时间")
+    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
+    private Date checktime;
+
+    @ExcelProperty(value = "验证方式")
+    private Integer verify;
+
+    @ExcelProperty(value = "状态编号")
+    private Integer stateno;
+
+    @ExcelProperty(value = "状态")
+    private String state;
+
+    @ExcelProperty(value = "创建时间")
+    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
+    private Date createdAt;
+}

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

@@ -0,0 +1,10 @@
+package com.klp.mapper;
+
+import com.klp.domain.AttendanceRecords;
+import com.klp.domain.vo.AttendanceRecordsVo;
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import org.apache.ibatis.annotations.Mapper;
+
+@Mapper
+public interface AttendanceRecordsMapper extends BaseMapper<AttendanceRecords> {
+}

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

@@ -0,0 +1,25 @@
+package com.klp.service;
+
+import com.klp.domain.AttendanceRecords;
+import com.klp.domain.vo.AttendanceRecordsVo;
+import com.klp.domain.bo.AttendanceRecordsBo;
+import com.klp.common.core.page.TableDataInfo;
+import com.klp.common.core.domain.PageQuery;
+
+import java.util.Collection;
+import java.util.List;
+
+public interface IAttendanceRecordsService {
+
+    AttendanceRecordsVo queryById(Integer id);
+
+    TableDataInfo<AttendanceRecordsVo> queryPageList(AttendanceRecordsBo bo, PageQuery pageQuery);
+
+    List<AttendanceRecordsVo> queryList(AttendanceRecordsBo bo);
+
+    Boolean insertByBo(AttendanceRecordsBo bo);
+
+    Boolean updateByBo(AttendanceRecordsBo bo);
+
+    Boolean deleteWithValidByIds(Collection<Integer> ids, Boolean isValid);
+}

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

@@ -0,0 +1,84 @@
+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.AttendanceRecordsBo;
+import com.klp.domain.vo.AttendanceRecordsVo;
+import com.klp.domain.AttendanceRecords;
+import com.klp.mapper.AttendanceRecordsMapper;
+import com.klp.service.IAttendanceRecordsService;
+
+import java.util.List;
+import java.util.Collection;
+
+@RequiredArgsConstructor
+@Service
+public class AttendanceRecordsServiceImpl implements IAttendanceRecordsService {
+
+    private final AttendanceRecordsMapper baseMapper;
+
+    @Override
+    public AttendanceRecordsVo queryById(Integer id) {
+        AttendanceRecords entity = baseMapper.selectById(id);
+        return BeanUtil.toBean(entity, AttendanceRecordsVo.class);
+    }
+
+    @Override
+    public TableDataInfo<AttendanceRecordsVo> queryPageList(AttendanceRecordsBo bo, PageQuery pageQuery) {
+        LambdaQueryWrapper<AttendanceRecords> lqw = buildQueryWrapper(bo);
+        Page<AttendanceRecords> page = baseMapper.selectPage(pageQuery.build(), lqw);
+        List<AttendanceRecordsVo> voList = BeanUtil.copyToList(page.getRecords(), AttendanceRecordsVo.class);
+        Page<AttendanceRecordsVo> voPage = new Page<>(page.getCurrent(), page.getSize(), page.getTotal());
+        voPage.setRecords(voList);
+        return TableDataInfo.build(voPage);
+    }
+
+    @Override
+    public List<AttendanceRecordsVo> queryList(AttendanceRecordsBo bo) {
+        LambdaQueryWrapper<AttendanceRecords> lqw = buildQueryWrapper(bo);
+        List<AttendanceRecords> list = baseMapper.selectList(lqw);
+        return BeanUtil.copyToList(list, AttendanceRecordsVo.class);
+    }
+
+    private LambdaQueryWrapper<AttendanceRecords> buildQueryWrapper(AttendanceRecordsBo bo) {
+        LambdaQueryWrapper<AttendanceRecords> lqw = Wrappers.lambdaQuery();
+        lqw.eq(bo.getId() != null, AttendanceRecords::getId, bo.getId());
+        lqw.eq(StringUtils.isNotBlank(bo.getPin()), AttendanceRecords::getPin, bo.getPin());
+        lqw.like(StringUtils.isNotBlank(bo.getEname()), AttendanceRecords::getEname, bo.getEname());
+        lqw.eq(StringUtils.isNotBlank(bo.getDeptname()), AttendanceRecords::getDeptname, bo.getDeptname());
+        lqw.eq(StringUtils.isNotBlank(bo.getSn()), AttendanceRecords::getSn, bo.getSn());
+        lqw.ge(bo.getChecktimeStart() != null, AttendanceRecords::getChecktime, bo.getChecktimeStart());
+        lqw.le(bo.getChecktimeEnd() != null, AttendanceRecords::getChecktime, bo.getChecktimeEnd());
+        lqw.eq(bo.getVerify() != null, AttendanceRecords::getVerify, bo.getVerify());
+        lqw.eq(bo.getStateno() != null, AttendanceRecords::getStateno, bo.getStateno());
+        lqw.eq(StringUtils.isNotBlank(bo.getState()), AttendanceRecords::getState, bo.getState());
+        lqw.orderByDesc(AttendanceRecords::getChecktime);
+        return lqw;
+    }
+
+    @Override
+    public Boolean insertByBo(AttendanceRecordsBo bo) {
+        AttendanceRecords add = BeanUtil.toBean(bo, AttendanceRecords.class);
+        return baseMapper.insert(add) > 0;
+    }
+
+    @Override
+    public Boolean updateByBo(AttendanceRecordsBo bo) {
+        AttendanceRecords update = BeanUtil.toBean(bo, AttendanceRecords.class);
+        return baseMapper.updateById(update) > 0;
+    }
+
+    @Override
+    public Boolean deleteWithValidByIds(Collection<Integer> ids, Boolean isValid) {
+        if (isValid) {
+        }
+        return baseMapper.deleteBatchIds(ids) > 0;
+    }
+}