From 5921928c962dfc56241325ad3fb1c2792a815ced Mon Sep 17 00:00:00 2001
From: aikai <ZZL86tdd>
Date: Tue, 27 Aug 2024 09:19:01 +0800
Subject: [PATCH] =?UTF-8?q?feat(attendance):=20=E6=B7=BB=E5=8A=A0=E8=A1=A5?=
 =?UTF-8?q?=E5=8D=A1=E5=8A=9F=E8=83=BD=E5=92=8C=E8=B4=A2=E5=8A=A1=E6=94=AF?=
 =?UTF-8?q?=E4=BB=98=E5=8F=96=E6=B6=88=E9=A2=86=E5=8F=96?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 在考勤功能中，增加补卡次数限制和补卡操作接口。- 财务支付功能中，增加取消领取操作，优化支付管理。

重构和样式调整：
- 无

fixes:
-无

BREAKING CHANGE:
-考勤组实体和相关请求/响应VO中增加replacementCardNum字段，以支持补卡次数限制。
- 财务支付的取消领取操作可能会对相关业务逻辑产生影响，需确保在使用前进行测试。
---
 .../FinancialPaymentController.java           | 10 ++-
 .../vo/FinancialPaymentPageReqVO.java         |  3 +
 .../FinancialPaymentMapper.java               |  9 +++
 .../FinancialPaymentService.java              |  7 ++
 .../FinancialPaymentServiceImpl.java          |  5 ++
 .../FinancialPaymentMapper.xml                | 11 +++
 .../system/enums/ErrorCodeConstants.java      |  3 +
 .../attendance/AttendanceController.java      | 14 ++++
 .../dto/AttendanceReplacementCardDTO.java     | 21 ++++++
 .../group/vo/AttendanceGroupPageReqVO.java    |  5 ++
 .../admin/group/vo/AttendanceGroupRespVO.java |  4 +
 .../group/vo/AttendanceGroupSaveReqVO.java    |  2 +
 .../attendance/group/AttendanceGroupDO.java   |  5 ++
 .../service/attendance/AttendanceService.java | 26 +++++++
 .../attendance/AttendanceServiceImpl.java     | 74 +++++++++++++++++++
 15 files changed, 198 insertions(+), 1 deletion(-)
 create mode 100644 yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/attendance/dto/AttendanceReplacementCardDTO.java

diff --git a/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/controller/admin/financialpayment/FinancialPaymentController.java b/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/controller/admin/financialpayment/FinancialPaymentController.java
index 079a52a8..74cae05b 100644
--- a/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/controller/admin/financialpayment/FinancialPaymentController.java
+++ b/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/controller/admin/financialpayment/FinancialPaymentController.java
@@ -62,6 +62,13 @@ public class FinancialPaymentController {
         return success(true);
     }
 
+    @PostMapping("/cancel")
+    @Operation(summary = "取消领取")
+    public CommonResult<Boolean> cancel(@RequestBody List<Long> ids) {
+        financialPaymentService.cancel(ids);
+        return success(true);
+    }
+
     @DeleteMapping("/delete")
     @Operation(summary = "删除财务支付管理")
     @Parameter(name = "id", description = "编号", required = true)
@@ -88,7 +95,8 @@ public class FinancialPaymentController {
             item.setFinancialPaymentId(financialPaymentItemDO.getFinancialPaymentId());
             item.setCreateTime(financialPaymentItemDO.getCreateTime());
             if (CollectionUtil.isNotEmpty(financialPaymentItemDO.getFileItems())) {
-                item.setFileItems(new ArrayList<UploadUserFile>());
+                List<UploadUserFile> uploadUserFiles = BeanUtils.toBean(financialPaymentItemDO.getFileItems(), UploadUserFile.class);
+                item.setFileItems(uploadUserFiles);
             }
             items.add(item);
         }
diff --git a/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/controller/admin/financialpayment/vo/FinancialPaymentPageReqVO.java b/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/controller/admin/financialpayment/vo/FinancialPaymentPageReqVO.java
index b982b385..4ca64098 100644
--- a/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/controller/admin/financialpayment/vo/FinancialPaymentPageReqVO.java
+++ b/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/controller/admin/financialpayment/vo/FinancialPaymentPageReqVO.java
@@ -24,6 +24,9 @@ public class FinancialPaymentPageReqVO extends PageParam {
     @Schema(description = "申请人的用户名称", example = "13599")
     private String nickname;
 
+    @Schema(description = "财务名称", example = "13599")
+    private String financeName;
+
     @Schema(description = "原因", example = "13599")
     private String reason;
 
diff --git a/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/dal/mysql/financialpayment/FinancialPaymentMapper.java b/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/dal/mysql/financialpayment/FinancialPaymentMapper.java
index 0972765f..49c6aa4c 100644
--- a/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/dal/mysql/financialpayment/FinancialPaymentMapper.java
+++ b/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/dal/mysql/financialpayment/FinancialPaymentMapper.java
@@ -8,6 +8,8 @@ import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
 import org.apache.ibatis.annotations.Mapper;
 import org.apache.ibatis.annotations.Param;
 
+import java.util.List;
+
 /**
  * 财务支付管理 Mapper
  *
@@ -32,4 +34,11 @@ public interface FinancialPaymentMapper extends BaseMapperX<FinancialPaymentDO>
      * @return
      */
     FinancialPaymentDO getFinancialPayment(@Param("id") Long id);
+
+    /**
+     * 拒绝领取
+     *
+     * @param ids
+     */
+    void cancel(@Param("ids") List<Long> ids);
 }
diff --git a/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/service/financialpayment/FinancialPaymentService.java b/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/service/financialpayment/FinancialPaymentService.java
index a461c748..5c159489 100644
--- a/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/service/financialpayment/FinancialPaymentService.java
+++ b/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/service/financialpayment/FinancialPaymentService.java
@@ -74,4 +74,11 @@ public interface FinancialPaymentService {
      * @param financialPayment
      */
     void updateById(FinancialPaymentDO financialPayment);
+
+    /**
+     * 取消领取
+     *
+     * @param ids
+     */
+    void cancel(List<Long> ids);
 }
diff --git a/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/service/financialpayment/FinancialPaymentServiceImpl.java b/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/service/financialpayment/FinancialPaymentServiceImpl.java
index 1af8195f..2fec7e34 100644
--- a/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/service/financialpayment/FinancialPaymentServiceImpl.java
+++ b/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/service/financialpayment/FinancialPaymentServiceImpl.java
@@ -169,4 +169,9 @@ public class FinancialPaymentServiceImpl implements FinancialPaymentService {
         financialPaymentMapper.updateById(financialPayment);
     }
 
+    @Override
+    public void cancel(List<Long> ids) {
+        financialPaymentMapper.cancel(ids);
+    }
+
 }
diff --git a/yudao-module-bpm/yudao-module-bpm-biz/src/main/resources/mapper/financialpayment/FinancialPaymentMapper.xml b/yudao-module-bpm/yudao-module-bpm-biz/src/main/resources/mapper/financialpayment/FinancialPaymentMapper.xml
index 382893d7..2e32b7a8 100644
--- a/yudao-module-bpm/yudao-module-bpm-biz/src/main/resources/mapper/financialpayment/FinancialPaymentMapper.xml
+++ b/yudao-module-bpm/yudao-module-bpm-biz/src/main/resources/mapper/financialpayment/FinancialPaymentMapper.xml
@@ -40,6 +40,9 @@
             <if test="vo.reason != null and vo.reason != ''">
                 and a.reason like concat('%', #{vo.reason}, '%')
             </if>
+            <if test="vo.financeName != null and vo.financeName != ''">
+                and d.nickname like concat('%', #{vo.financeName}, '%')
+            </if>
             <if test="vo.receiveType != null">
                 <if test="vo.receiveType == 1">
                     and a.receive_user_id is null
@@ -73,6 +76,14 @@
         </where>
         ORDER BY a.status asc,a.end_time DESC
         </select>
+    <update id="cancel">
+        update bpm_financial_payment set receive_user_id = null
+        where id in
+        <foreach collection="ids" item="id" open="(" separator="," close=")">
+            #{id}
+        </foreach>
+        and status = 0
+    </update>
     <select id="getFinancialPayment"
             resultType="cn.iocoder.yudao.module.bpm.dal.dataobject.financialpayment.FinancialPaymentDO">
         select
diff --git a/yudao-module-system/yudao-module-system-api/src/main/java/cn/iocoder/yudao/module/system/enums/ErrorCodeConstants.java b/yudao-module-system/yudao-module-system-api/src/main/java/cn/iocoder/yudao/module/system/enums/ErrorCodeConstants.java
index 140b5137..27b39ef6 100644
--- a/yudao-module-system/yudao-module-system-api/src/main/java/cn/iocoder/yudao/module/system/enums/ErrorCodeConstants.java
+++ b/yudao-module-system/yudao-module-system-api/src/main/java/cn/iocoder/yudao/module/system/enums/ErrorCodeConstants.java
@@ -204,6 +204,9 @@ public interface ErrorCodeConstants {
     ErrorCode GROUP_SHIFT_IN_USE = new ErrorCode(1_003_014_000, "班次使用中不允许删除");
 
     ErrorCode THERE_ARE_STILL_PEOPLE_IN_THE_ATTENDANCE_GROUP_WHO_ARE_NOT_ALLOWED_TO_BE_DELETED = new ErrorCode(1_003_015_000, "考勤组还有人员不允许删除");
+    ErrorCode INSUFFICIENT_NUMBER_OF_CARD_REFILLS = new ErrorCode(1_003_016_000, "补卡次数不足");
+    ErrorCode ABNORMAL_CARD_REPLENISHMENT = new ErrorCode(1_003_017_000, "补卡异常");
+    ErrorCode CANNOT_FIND_THE_RECORD_THAT_NEEDS_TO_BE_REPLACED = new ErrorCode(1_003_018_000, "查询不到需要补卡的记录");
 
 
     ErrorCode LOG_FORM_NOT_USE = new ErrorCode(1_009_010_004, "你不用使用该日志模板");
diff --git a/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/attendance/AttendanceController.java b/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/attendance/AttendanceController.java
index cf24fa43..cd22bbaf 100644
--- a/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/attendance/AttendanceController.java
+++ b/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/attendance/AttendanceController.java
@@ -39,6 +39,20 @@ public class AttendanceController {
         return success(vo);
     }
 
+    @GetMapping("/getReplacementCardNum")
+    @Operation(summary = "获取本月剩余补卡次数")
+    public CommonResult<Integer> getReplacementCardNum() {
+        Integer num = attendanceService.getReplacementCardNum();
+        return success(num);
+    }
+
+    @PostMapping("/replacementCard")
+    @Operation(summary = "补卡")
+    public CommonResult replacementCard(@RequestBody AttendanceReplacementCardDTO dto) {
+        attendanceService.replacementCard(dto);
+        return success("补卡成功");
+    }
+
     @GetMapping("/getRules/{groupId}")
     @Operation(summary = "获取考勤规则")
     public CommonResult<AttendanceRulesVO> getRules(@PathVariable Long groupId) {
diff --git a/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/attendance/dto/AttendanceReplacementCardDTO.java b/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/attendance/dto/AttendanceReplacementCardDTO.java
new file mode 100644
index 00000000..226f880b
--- /dev/null
+++ b/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/attendance/dto/AttendanceReplacementCardDTO.java
@@ -0,0 +1,21 @@
+package cn.iocoder.yudao.module.system.controller.admin.attendance.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.experimental.Accessors;
+
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Data
+@Accessors(chain = true)
+public class AttendanceReplacementCardDTO {
+
+    @Schema(description = "日期 yyyy-MM-dd格式")
+    private String actualDayTime;
+
+    @Schema(description = "班次子表id")
+    private Long attendanceGroupShiftItemId;
+
+    @Schema(description = "上下班类型 0上班 1下班")
+    private Integer workType;
+}
diff --git a/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/group/vo/AttendanceGroupPageReqVO.java b/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/group/vo/AttendanceGroupPageReqVO.java
index 9b3a05b1..8fd7176a 100644
--- a/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/group/vo/AttendanceGroupPageReqVO.java
+++ b/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/group/vo/AttendanceGroupPageReqVO.java
@@ -1,6 +1,7 @@
 package cn.iocoder.yudao.module.system.controller.admin.group.vo;
 
 import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import com.alibaba.excel.annotation.ExcelProperty;
 import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;
 import lombok.EqualsAndHashCode;
@@ -48,6 +49,10 @@ public class AttendanceGroupPageReqVO extends PageParam {
     @Schema(description = "节假日自动排休 0否 1是")
     private Integer autoHolidaysFlag;
 
+    @Schema(description = "可补卡次数(每个月1号凌晨重置 默认3次)")
+    private Integer replacementCardNum;
+
+
     @Schema(description = "创建时间")
     @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
     private LocalDateTime[] createTime;
diff --git a/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/group/vo/AttendanceGroupRespVO.java b/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/group/vo/AttendanceGroupRespVO.java
index 488c2a04..0121e6e7 100644
--- a/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/group/vo/AttendanceGroupRespVO.java
+++ b/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/group/vo/AttendanceGroupRespVO.java
@@ -63,6 +63,10 @@ public class AttendanceGroupRespVO {
     @ExcelProperty("节假日自动排休 0否 1是")
     private Integer autoHolidaysFlag;
 
+    @Schema(description = "可补卡次数(每个月1号凌晨重置 默认3次)")
+    @ExcelProperty("可补卡次数(每个月1号凌晨重置 默认3次)")
+    private Integer replacementCardNum;
+
     @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
     @ExcelProperty("创建时间")
     private LocalDateTime createTime;
diff --git a/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/group/vo/AttendanceGroupSaveReqVO.java b/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/group/vo/AttendanceGroupSaveReqVO.java
index fe4f2ee4..03d1fe38 100644
--- a/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/group/vo/AttendanceGroupSaveReqVO.java
+++ b/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/group/vo/AttendanceGroupSaveReqVO.java
@@ -40,4 +40,6 @@ public class AttendanceGroupSaveReqVO {
     @Schema(description = "节假日自动排休 0否 1是")
     private Integer autoHolidaysFlag;
 
+    @Schema(description = "可补卡次数(每个月1号凌晨重置 默认3次)")
+    private Integer replacementCardNum;
 }
diff --git a/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/dal/dataobject/attendance/group/AttendanceGroupDO.java b/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/dal/dataobject/attendance/group/AttendanceGroupDO.java
index 6ea8c5d9..826dcbc9 100644
--- a/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/dal/dataobject/attendance/group/AttendanceGroupDO.java
+++ b/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/dal/dataobject/attendance/group/AttendanceGroupDO.java
@@ -68,6 +68,11 @@ public class AttendanceGroupDO extends BaseDO {
      * 节假日自动排休 0否 1是
      */
     private Integer autoHolidaysFlag;
+    /**
+     * 可补卡次数(每个月1号凌晨重置 默认3次)
+     */
+    private Integer replacementCardNum;
+
 
     /**
      * 管理员名称列表逗号隔开
diff --git a/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/service/attendance/AttendanceService.java b/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/service/attendance/AttendanceService.java
index 3563369f..b742198b 100644
--- a/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/service/attendance/AttendanceService.java
+++ b/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/service/attendance/AttendanceService.java
@@ -113,4 +113,30 @@ public interface AttendanceService {
      * @return
      */
     AttendanceRulesVO getRulesByUserId();
+
+    /**
+     * 获取本月补卡次数
+     *
+     * @return
+     */
+    Integer getReplacementCardNum();
+
+    /**
+     * 使用补卡次数
+     *
+     * @param userId
+     */
+    void useReplacementCardNum(Long userId);
+
+    /**
+     * 使用补卡次数
+     */
+    void useReplacementCardNum();
+
+    /**
+     * 补卡
+     *
+     * @param dto
+     */
+    void replacementCard(AttendanceReplacementCardDTO dto);
 }
diff --git a/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/service/attendance/AttendanceServiceImpl.java b/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/service/attendance/AttendanceServiceImpl.java
index 471a651d..94617a46 100644
--- a/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/service/attendance/AttendanceServiceImpl.java
+++ b/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/service/attendance/AttendanceServiceImpl.java
@@ -948,6 +948,80 @@ public class AttendanceServiceImpl implements AttendanceService {
         return this.getRules(activationGroup.getId());
     }
 
+    @Override
+    public Integer getReplacementCardNum() {
+        Long userId = getLoginUserId();
+        Integer num = 0;
+        String key = "ReplacementCardNum" + "_" + userId + "_" + LocalDateTime.now().format(Constants.REPO_DATE_FORMAT);
+        String value = stringRedisTemplate.opsForValue().get(key);
+        if (StringUtils.isEmpty(value)) {
+            // -- 获取当前用户
+            AttendanceGroupDO group = attendanceGroupService.getByUserId(userId);
+            if (group != null) {
+                num = group.getReplacementCardNum();
+            }
+            stringRedisTemplate.opsForValue().set(key, num.toString(), 32, TimeUnit.DAYS);
+            return num;
+        }
+        return Integer.valueOf(value);
+    }
+
+    @Override
+    public void useReplacementCardNum() {
+        this.useReplacementCardNum(null);
+    }
+
+    @Override
+    public void replacementCard(AttendanceReplacementCardDTO dto) {
+        Long userId = getLoginUserId();
+        //先减去补卡次数
+        this.useReplacementCardNum(userId);
+        try {
+            int update = attendancePunchRecordMapper.update(new AttendancePunchRecordDO().setStatus(AttendanceOnTheDayDTO.REPLACEMENT_CARD),
+                    new LambdaQueryWrapper<AttendancePunchRecordDO>()
+                            .eq(AttendancePunchRecordDO::getUserId, userId)
+                            .eq(AttendancePunchRecordDO::getAttendanceGroupShiftItemId, dto.getAttendanceGroupShiftItemId())
+                            .eq(AttendancePunchRecordDO::getWorkType, dto.getWorkType())
+                            .eq(AttendancePunchRecordDO::getActualDayTime, dto.getActualDayTime())
+                            .eq(AttendancePunchRecordDO::getStatus, AttendanceOnTheDayDTO.PUNCH_STATUS_MISS));
+            if (update <= 0) {
+                throw exception(CANNOT_FIND_THE_RECORD_THAT_NEEDS_TO_BE_REPLACED);
+            }
+        } catch (Exception e) {
+            // -- 如果有报错的话 - 那么进行回滚操作 - 并且redis 中的补卡次数也要+1 (redis并不会回滚)
+            String key = "ReplacementCardNum" + "_" + userId + "_" + LocalDateTime.now().format(Constants.REPO_DATE_FORMAT);
+            stringRedisTemplate.opsForValue().increment(key, 1);
+            throw exception(ABNORMAL_CARD_REPLENISHMENT);
+        }
+    }
+
+    @Override
+    public void useReplacementCardNum(Long userId) {
+        userId = userId == null ? getLoginUserId() : userId;
+        String key = "ReplacementCardNum" + "_" + userId + "_" + LocalDateTime.now().format(Constants.REPO_DATE_FORMAT);
+        String value = stringRedisTemplate.opsForValue().get(key);
+        if (StringUtils.isNotEmpty(value)) {
+            if (Integer.parseInt(value) > 0) {
+                stringRedisTemplate.opsForValue().increment(key, -1);
+            } else {
+                throw exception(INSUFFICIENT_NUMBER_OF_CARD_REFILLS);
+            }
+            return;
+        }
+        // -- 如果redis不存在，则从数据库获取
+        Integer num = 0;
+        AttendanceGroupDO group = attendanceGroupService.getByUserId(userId);
+        if (group != null) {
+            num = group.getReplacementCardNum();
+        }
+        if (num > 0) {
+            num = num - 1;
+            stringRedisTemplate.opsForValue().set(key, num.toString(), 32, TimeUnit.DAYS);
+        } else {
+            throw exception(INSUFFICIENT_NUMBER_OF_CARD_REFILLS);
+        }
+    }
+
 
     /**
      * 按日导出