package cn.iocoder.yudao.module.hrm.service.attendance; import cn.hutool.core.util.StrUtil; import cn.iocoder.yudao.framework.common.pojo.PageResult; import cn.iocoder.yudao.framework.common.util.object.BeanUtils; import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.HrmAttendanceExceptionPageReqVO; import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.HrmAttendanceExceptionSaveReqVO; import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.HrmAttendanceExceptionDO; import cn.iocoder.yudao.module.hrm.dal.mysql.attendance.HrmAttendanceExceptionMapper; import cn.iocoder.yudao.module.system.api.approval.ApprovalConfigApi; import cn.iocoder.yudao.module.system.api.storage.StorageAttachmentApi; import cn.iocoder.yudao.module.system.api.user.AdminUserApi; import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO; import cn.iocoder.yudao.module.hrm.dal.redis.HrmNoRedisDAO; import cn.iocoder.yudao.module.hrm.enums.HrmAttendanceExceptionTypeEnum; import cn.iocoder.yudao.module.hrm.enums.HrmAuditStatusEnum; import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.HrmEmployeeDO; import cn.iocoder.yudao.module.hrm.service.employee.HrmEmployeeService; import jakarta.annotation.Resource; import lombok.extern.slf4j.Slf4j; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; import org.springframework.validation.annotation.Validated; import java.util.Set; import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception; import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId; import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.*; /** * 考勤异常申请 Service 实现类 * * @author 超级管理员 */ @Service @Validated @Slf4j public class HrmAttendanceExceptionServiceImpl implements HrmAttendanceExceptionService { /** * 考勤异常申请审批的业务类型编码 * * 与 system_approval_config.biz_type 对应,审批人在「系统管理 - 审批配置」中维护。 */ private static final String ATTENDANCE_APPROVE_BIZ_TYPE = "hrm_attendance_approve"; @Resource private HrmAttendanceExceptionMapper attendanceExceptionMapper; @Resource private HrmNoRedisDAO noRedisDAO; @Resource private StorageAttachmentApi storageAttachmentApi; @Resource private ApprovalConfigApi approvalConfigApi; @Resource private AdminUserApi adminUserApi; @Resource private HrmEmployeeService employeeService; @Resource private HrmAttendanceRecordService attendanceRecordService; @Override public Long createAttendanceException(HrmAttendanceExceptionSaveReqVO createReqVO) { HrmEmployeeDO employee = employeeService.getEmployeeByUserId( cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId()); if (employee == null) { throw exception(EMPLOYEE_NOT_EXISTS); } HrmAttendanceExceptionDO attendanceException = BeanUtils.toBean(createReqVO, HrmAttendanceExceptionDO.class); attendanceException.setUserId(employee.getId()).setDeptId(employee.getDeptId()); attendanceException.setNo(generateNo()); attendanceException.setStatus(HrmAuditStatusEnum.DRAFT.getStatus()); attendanceExceptionMapper.insert(attendanceException); storageAttachmentApi.bindAttachments("file", "hrm_attendance_exception", attendanceException.getId(), createReqVO.getBlobIds()); return attendanceException.getId(); } private String generateNo() { return noRedisDAO.generate(HrmNoRedisDAO.ATTENDANCE_EXCEPTION_NO_PREFIX, 4); } @Override public void updateAttendanceException(HrmAttendanceExceptionSaveReqVO updateReqVO) { HrmAttendanceExceptionDO attendanceException = validateAttendanceExceptionExists(updateReqVO.getId()); if (!HrmAuditStatusEnum.DRAFT.getStatus().equals(attendanceException.getStatus())) { throw exception(ATTENDANCE_EXCEPTION_UPDATE_FAIL_NOT_DRAFT); } HrmAttendanceExceptionDO updateObj = BeanUtils.toBean(updateReqVO, HrmAttendanceExceptionDO.class); attendanceExceptionMapper.updateById(updateObj); storageAttachmentApi.updateAttachments("file", "hrm_attendance_exception", updateReqVO.getId(), updateReqVO.getBlobIds()); } @Override public void deleteAttendanceException(Long id) { HrmAttendanceExceptionDO attendanceException = validateAttendanceExceptionExists(id); if (!HrmAuditStatusEnum.DRAFT.getStatus().equals(attendanceException.getStatus())) { throw exception(ATTENDANCE_EXCEPTION_DELETE_FAIL_NOT_DRAFT); } storageAttachmentApi.deleteAttachmentsByRecord("hrm_attendance_exception", id); attendanceExceptionMapper.deleteById(id); } private HrmAttendanceExceptionDO validateAttendanceExceptionExists(Long id) { HrmAttendanceExceptionDO attendanceException = attendanceExceptionMapper.selectById(id); if (attendanceException == null) { throw exception(ATTENDANCE_EXCEPTION_NOT_EXISTS); } return attendanceException; } @Override public PageResult getAttendanceExceptionPage(HrmAttendanceExceptionPageReqVO pageReqVO) { return attendanceExceptionMapper.selectPage(pageReqVO); } @Override public HrmAttendanceExceptionDO getAttendanceException(Long id) { return attendanceExceptionMapper.selectById(id); } @Override @Transactional(rollbackFor = Exception.class) public void submitAttendanceException(Long id) { // 1. 校验存在 + 可提交状态(草稿 / 审核不通过) HrmAttendanceExceptionDO exception = validateAttendanceExceptionExists(id); if (!HrmAuditStatusEnum.DRAFT.getStatus().equals(exception.getStatus()) && !HrmAuditStatusEnum.REJECT.getStatus().equals(exception.getStatus())) { throw exception(ATTENDANCE_EXCEPTION_SUBMIT_FAIL_NOT_EDITABLE); } // 2. 校验审批配置已启用且配置了有效审批人(未配置时抛出带明确提示的业务异常) approvalConfigApi.validateApprovalEnabledAndGetApprovers(ATTENDANCE_APPROVE_BIZ_TYPE); // 3. 状态置为审批中,并清空上一轮审核结果,避免残留「审核不通过」的原因 attendanceExceptionMapper.submitAndResetAuditInfo(id, HrmAuditStatusEnum.PROCESS.getStatus()); } @Override public Set getAttendanceExceptionApproverUserIds() { return approvalConfigApi.getApproverUserIds(ATTENDANCE_APPROVE_BIZ_TYPE); } @Override @Transactional(rollbackFor = Exception.class) public void auditAttendanceException(Long id, Boolean pass, String reviewRemark) { // 1. 校验存在 HrmAttendanceExceptionDO exception = validateAttendanceExceptionExists(id); // 2. 校验处于审批中状态 if (!HrmAuditStatusEnum.PROCESS.getStatus().equals(exception.getStatus())) { throw exception(ATTENDANCE_EXCEPTION_AUDIT_FAIL_NOT_PROCESS); } // 3. 校验当前登录用户是该业务类型的审批人(或签:任一人均可审核) Long userId = getLoginUserId(); approvalConfigApi.validateApprover(ATTENDANCE_APPROVE_BIZ_TYPE, userId); // 4. 审核不通过:必须填写原因,状态置为审核不通过,退回提交人修改后可重新提交 if (!Boolean.TRUE.equals(pass)) { if (StrUtil.isBlank(reviewRemark)) { throw exception(ATTENDANCE_EXCEPTION_AUDIT_REJECT_REASON_REQUIRED); } attendanceExceptionMapper.auditAttendanceException(id, HrmAuditStatusEnum.REJECT.getStatus(), userId, getUserNickname(userId), reviewRemark); return; } // 5. 审核通过:记录审核人与审核意见,状态置为审核通过 attendanceExceptionMapper.auditAttendanceException(id, HrmAuditStatusEnum.APPROVE.getStatus(), userId, getUserNickname(userId), reviewRemark); // 6. 审核通过后置业务逻辑:补卡回填上下班时间 / 加班回写加班时长 if (HrmAttendanceExceptionTypeEnum.SUPPLEMENT.getType().equals(exception.getType())) { log.info("[auditAttendanceException] 补卡申请({}) 审批通过,开始更新考勤记录", id); attendanceRecordService.supplementClockIn(exception); } else if (HrmAttendanceExceptionTypeEnum.OVERTIME.getType().equals(exception.getType())) { log.info("[auditAttendanceException] 加班申请({}) 审批通过,开始回写加班时长", id); attendanceRecordService.recordOvertime(exception); } } /** * 获取用户昵称 * * @param userId 用户编号 * @return 昵称,用户不存在时返回 null */ private String getUserNickname(Long userId) { if (userId == null) { return null; } AdminUserRespDTO user = adminUserApi.getUser(userId); return user == null ? null : user.getNickname(); } }