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

- 新增 AttendanceRecords 实体类定义数据库表结构
- 创建 AttendanceRecordsBo 业务对象用于数据传输
- 实现 AttendanceRecordsController 提供 REST API 接口
- 开发 AttendanceRecordsMapper 数据访问层接口
- 实现 AttendanceRecordsServiceImpl 业务逻辑服务
- 定义 AttendanceRecordsVo 视图对象用于数据展示
- 集成 Excel 导出功能支持考勤数据批量导出
- 添加分页查询、条件筛选等数据检索功能
This commit is contained in:
2026-04-21 13:01:53 +08:00
parent e22648bff0
commit a2067815a9
7 changed files with 310 additions and 0 deletions

View File

@@ -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));
}
}

View File

@@ -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;
}

View File

@@ -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;
}

View File

@@ -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;
}

View File

@@ -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> {
}

View File

@@ -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);
}

View File

@@ -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;
}
}