package cn.iocoder.yudao.module.hrm.service.performanceappraise; import cn.hutool.core.collection.CollUtil; import cn.hutool.core.util.ObjUtil; import cn.hutool.core.util.StrUtil; import cn.hutool.json.JSONUtil; import cn.iocoder.yudao.framework.common.pojo.PageResult; import cn.iocoder.yudao.framework.common.util.object.BeanUtils; import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX; import cn.iocoder.yudao.module.hrm.controller.admin.performanceappraise.vo.*; import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.HrmEmployeeDO; import cn.iocoder.yudao.module.hrm.dal.dataobject.performanceappraise.*; import cn.iocoder.yudao.module.hrm.dal.mysql.employee.HrmEmployeeMapper; import cn.iocoder.yudao.module.hrm.dal.mysql.performanceappraise.*; import cn.iocoder.yudao.module.hrm.enums.HrmAuditStatusEnum; import cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants; import cn.iocoder.yudao.module.system.api.approval.ApprovalConfigApi; import cn.iocoder.yudao.module.system.api.user.AdminUserApi; import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO; 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.math.BigDecimal; import java.math.RoundingMode; import java.util.*; import java.util.stream.Collectors; import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception; import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap; import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet; import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId; /** * HRM 绩效考核方案 Service 实现类 */ @Service @Validated @Slf4j public class HrmPerformanceAppraiseServiceImpl implements HrmPerformanceAppraiseService { /** * 方案状态:0 草稿 / 10 已发布 / 20 进行中 / 30 已完成 */ private static final Integer STATUS_DRAFT = 0; private static final Integer STATUS_PUBLISHED = 10; private static final Integer STATUS_PROCESSING = 20; /** * 档级:1 优秀(≥90) / 2 良好(≥80) / 3 合格(≥60) / 4 待改进(<60) */ private static final BigDecimal GRADE_EXCELLENT = new BigDecimal("90"); private static final BigDecimal GRADE_GOOD = new BigDecimal("80"); private static final BigDecimal GRADE_PASS = new BigDecimal("60"); private static final Integer GRADE_EXCELLENT_CODE = 1; private static final Integer GRADE_GOOD_CODE = 2; private static final Integer GRADE_PASS_CODE = 3; private static final Integer GRADE_IMPROVE_CODE = 4; /** * 评分人类型:1 自评 / 2 上级评 */ private static final Integer SCORER_SELF = 1; private static final Integer SCORER_SUPERIOR = 2; /** * 考核范围类型:1 全部员工 / 2 指定班组 */ private static final Integer SCOPE_ALL = 1; private static final Integer SCOPE_TEAM = 2; /** * 在职员工状态 */ private static final Integer EMPLOYEE_STATUS_ACTIVE = 1; /** * 绩效考核方案审批的业务类型编码 * * 与 system_approval_config.biz_type 对应,审批人在「系统管理 - 审批配置」中维护。 */ private static final String APPRAISE_APPROVE_BIZ_TYPE = "performance_appraise_approve"; @Resource private HrmPerformanceAppraiseMapper appraiseMapper; @Resource private HrmPerformanceAppraiseItemMapper itemMapper; @Resource private HrmPerformanceAppraiseResultMapper resultMapper; @Resource private HrmPerformanceAppraiseResultItemMapper resultItemMapper; @Resource private HrmEmployeeMapper employeeMapper; @Resource private ApprovalConfigApi approvalConfigApi; @Resource private AdminUserApi adminUserApi; @Override @Transactional(rollbackFor = Exception.class) public Long createAppraise(HrmPerformanceAppraiseSaveReqVO createReqVO) { HrmPerformanceAppraiseDO appraise = BeanUtils.toBean(createReqVO, HrmPerformanceAppraiseDO.class, req -> req .setStatus(STATUS_DRAFT) .setAuditStatus(HrmAuditStatusEnum.DRAFT.getStatus())); appraise.setScopeTeamIds(CollUtil.isEmpty(createReqVO.getScopeTeamIds()) ? null : JSONUtil.toJsonStr(createReqVO.getScopeTeamIds())); appraiseMapper.insert(appraise); return appraise.getId(); } @Override @Transactional(rollbackFor = Exception.class) public void updateAppraise(HrmPerformanceAppraiseSaveReqVO updateReqVO) { HrmPerformanceAppraiseDO oldAppraise = validateAppraiseCanModify(updateReqVO.getId()); HrmPerformanceAppraiseDO updateObj = BeanUtils.toBean(updateReqVO, HrmPerformanceAppraiseDO.class, req -> req .setStatus(oldAppraise.getStatus()) .setAuditStatus(oldAppraise.getAuditStatus())); updateObj.setScopeTeamIds(CollUtil.isEmpty(updateReqVO.getScopeTeamIds()) ? null : JSONUtil.toJsonStr(updateReqVO.getScopeTeamIds())); appraiseMapper.updateById(updateObj); } @Override @Transactional(rollbackFor = Exception.class) public void deleteAppraise(Collection ids) { if (CollUtil.isEmpty(ids)) { return; } for (Long id : ids) { validateAppraiseCanModify(id); // 删除指标与结果 itemMapper.deleteByAppraiseId(id); List results = resultMapper.selectList( new LambdaQueryWrapperX() .eq(HrmPerformanceAppraiseResultDO::getAppraiseId, id)); for (HrmPerformanceAppraiseResultDO result : results) { resultItemMapper.deleteByResultId(result.getId()); } resultMapper.deleteByAppraiseId(id); appraiseMapper.deleteById(id); } } @Override public HrmPerformanceAppraiseDO getAppraise(Long id) { return appraiseMapper.selectById(id); } @Override public PageResult getAppraisePage(HrmPerformanceAppraisePageReqVO pageReqVO) { return appraiseMapper.selectPage(pageReqVO); } @Override public List getAppraiseItemList(Long appraiseId) { return itemMapper.selectListByAppraiseId(appraiseId); } @Override @Transactional(rollbackFor = Exception.class) public void saveAppraiseItems(HrmPerformanceAppraiseItemSaveReqVO saveReqVO) { HrmPerformanceAppraiseDO appraise = validateAppraiseCanModify(saveReqVO.getAppraiseId()); // 整表替换 itemMapper.deleteByAppraiseId(appraise.getId()); if (CollUtil.isEmpty(saveReqVO.getItems())) { return; } int sort = 0; for (HrmPerformanceAppraiseItemSaveReqVO.Item item : saveReqVO.getItems()) { Integer itemSort = item.getSort() != null ? item.getSort() : sort++; HrmPerformanceAppraiseItemDO itemDO = BeanUtils.toBean(item, HrmPerformanceAppraiseItemDO.class, req -> req .setAppraiseId(appraise.getId()) .setSort(itemSort)); itemMapper.insert(itemDO); } } @Override @Transactional(rollbackFor = Exception.class) public void submitAppraise(Long id) { // 1. 校验方案存在 + 可提交状态(草稿 / 审核不通过) HrmPerformanceAppraiseDO appraise = appraiseMapper.selectById(id); if (appraise == null) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_NOT_EXISTS); } if (ObjUtil.notEqual(appraise.getAuditStatus(), HrmAuditStatusEnum.DRAFT.getStatus()) && ObjUtil.notEqual(appraise.getAuditStatus(), HrmAuditStatusEnum.REJECT.getStatus())) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_SUBMIT_FAIL_NOT_EDITABLE); } if (CollUtil.isEmpty(itemMapper.selectListByAppraiseId(id))) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_ITEM_EMPTY); } // 2. 校验审批配置已启用且配置了有效审批人(未配置时抛出带明确提示的业务异常) approvalConfigApi.validateApprovalEnabledAndGetApprovers(APPRAISE_APPROVE_BIZ_TYPE); // 3. 审批状态置为审批中,并清空上一轮审核结果,避免残留「审核不通过」的原因 appraiseMapper.submitAndResetAuditInfo(id, HrmAuditStatusEnum.PROCESS.getStatus()); } @Override public Set getAppraiseApproverUserIds() { return approvalConfigApi.getApproverUserIds(APPRAISE_APPROVE_BIZ_TYPE); } @Override @Transactional(rollbackFor = Exception.class) public void auditAppraise(Long id, Boolean pass, String reviewRemark) { // 1. 校验存在 HrmPerformanceAppraiseDO appraise = validateAppraiseExists(id); // 2. 校验处于审批中状态 if (ObjUtil.notEqual(appraise.getAuditStatus(), HrmAuditStatusEnum.PROCESS.getStatus())) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_AUDIT_FAIL_NOT_PROCESS); } // 3. 校验当前登录用户是该业务类型的审批人(或签:任一人均可审核) Long userId = getLoginUserId(); approvalConfigApi.validateApprover(APPRAISE_APPROVE_BIZ_TYPE, userId); // 4. 审核不通过:必须填写原因,审批状态置为审核不通过,退回提交人修改后可重新提交 if (!Boolean.TRUE.equals(pass)) { if (StrUtil.isBlank(reviewRemark)) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_AUDIT_REJECT_REASON_REQUIRED); } // 方案状态保持不变 appraiseMapper.auditAppraise(id, HrmAuditStatusEnum.REJECT.getStatus(), appraise.getStatus(), userId, getUserNickname(userId), reviewRemark); return; } // 5. 审核通过:记录审核人与审核意见,审批状态置为审核通过 // 6. 审核通过后置业务逻辑:方案状态流转为「已发布」 appraiseMapper.auditAppraise(id, HrmAuditStatusEnum.APPROVE.getStatus(), STATUS_PUBLISHED, userId, getUserNickname(userId), reviewRemark); } /** * 获取用户昵称 * * @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(); } @Override @Transactional(rollbackFor = Exception.class) public void saveAppraiseResult(HrmPerformanceAppraiseResultSaveReqVO saveReqVO) { // 1. 校验方案状态允许评分 HrmPerformanceAppraiseDO appraise = appraiseMapper.selectById(saveReqVO.getAppraiseId()); if (appraise == null) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_NOT_EXISTS); } if (!Objects.equals(appraise.getStatus(), STATUS_PUBLISHED) && !Objects.equals(appraise.getStatus(), STATUS_PROCESSING)) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_SCORE_FAIL_STATUS); } // 2. 加载指标集合,校验指标评分是否完整 List items = itemMapper.selectListByAppraiseId(appraise.getId()); if (CollUtil.isEmpty(items)) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_ITEM_EMPTY); } Map itemMap = convertMap(items, HrmPerformanceAppraiseItemDO::getId); if (CollUtil.isEmpty(saveReqVO.getItems()) || saveReqVO.getItems().size() != items.size()) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_RESULT_ITEM_NOT_EXISTS); } for (HrmPerformanceAppraiseResultSaveReqVO.Item score : saveReqVO.getItems()) { if (!itemMap.containsKey(score.getItemId())) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_RESULT_ITEM_NOT_EXISTS); } } // 3. 按员工 upsert 结果 Long resultId; HrmPerformanceAppraiseResultDO oldResult = resultMapper.selectByAppraiseIdAndEmployeeId(appraise.getId(), saveReqVO.getEmployeeId()); if (oldResult != null) { resultId = oldResult.getId(); } else { HrmPerformanceAppraiseResultDO newResult = new HrmPerformanceAppraiseResultDO() .setAppraiseId(appraise.getId()) .setEmployeeId(saveReqVO.getEmployeeId()); resultMapper.insert(newResult); resultId = newResult.getId(); } resultItemMapper.deleteByResultId(resultId); // 4. 计算单指标得分、总分与档级 BigDecimal sumWeight = BigDecimal.ZERO; BigDecimal weightedFinal = BigDecimal.ZERO; BigDecimal weightedSelf = BigDecimal.ZERO; BigDecimal weightedSuperior = BigDecimal.ZERO; for (HrmPerformanceAppraiseResultSaveReqVO.Item score : saveReqVO.getItems()) { HrmPerformanceAppraiseItemDO item = itemMap.get(score.getItemId()); BigDecimal weight = item.getWeight() == null ? BigDecimal.ONE : item.getWeight(); BigDecimal selfScore = score.getSelfScore() == null ? BigDecimal.ZERO : score.getSelfScore(); BigDecimal superiorScore = score.getSuperiorScore() == null ? BigDecimal.ZERO : score.getSuperiorScore(); // 单指标分:1 自评 / 2 上级评 / 其他 两者平均 BigDecimal itemScore; if (Objects.equals(item.getScorerType(), SCORER_SELF)) { itemScore = selfScore; } else if (Objects.equals(item.getScorerType(), SCORER_SUPERIOR)) { itemScore = superiorScore; } else { itemScore = selfScore.add(superiorScore).divide(BigDecimal.valueOf(2), 2, RoundingMode.HALF_UP); } sumWeight = sumWeight.add(weight); weightedFinal = weightedFinal.add(weight.multiply(itemScore)); weightedSelf = weightedSelf.add(weight.multiply(selfScore)); weightedSuperior = weightedSuperior.add(weight.multiply(superiorScore)); // 保存明细 resultItemMapper.insert(new HrmPerformanceAppraiseResultItemDO() .setResultId(resultId) .setItemId(item.getId()) .setItemName(item.getItemName()) .setWeight(weight) .setSelfScore(selfScore) .setSuperiorScore(superiorScore)); } BigDecimal selfTotal = weightedSelf.divide(sumWeight, 1, RoundingMode.HALF_UP); BigDecimal superiorTotal = weightedSuperior.divide(sumWeight, 1, RoundingMode.HALF_UP); BigDecimal finalScore = weightedFinal.divide(sumWeight, 1, RoundingMode.HALF_UP); // 5. 更新结果 resultMapper.updateById(new HrmPerformanceAppraiseResultDO() .setId(resultId) .setSelfScore(selfTotal) .setSuperiorScore(superiorTotal) .setFinalScore(finalScore) .setGrade(calcGrade(finalScore)) .setComment(saveReqVO.getComment())); // 6. 方案状态流转:已发布 -> 进行中 if (Objects.equals(appraise.getStatus(), STATUS_PUBLISHED)) { appraiseMapper.updateById(new HrmPerformanceAppraiseDO().setId(appraise.getId()).setStatus(STATUS_PROCESSING)); } } @Override public PageResult getAppraiseResultPage(HrmPerformanceAppraiseResultPageReqVO pageReqVO) { return resultMapper.selectPage(pageReqVO); } @Override public HrmPerformanceAppraiseResultDO getAppraiseResult(Long appraiseId, Long employeeId) { return resultMapper.selectByAppraiseIdAndEmployeeId(appraiseId, employeeId); } @Override public List getAppraiseResultItems(Long resultId) { return resultItemMapper.selectListByResultId(resultId); } @Override @Transactional(rollbackFor = Exception.class) public Integer generateAppraisees(Long appraiseId) { HrmPerformanceAppraiseDO appraise = validateAppraiseExists(appraiseId); // 1. 按考核范围筛选员工 List employees; if (Objects.equals(appraise.getScopeType(), SCOPE_TEAM)) { List teamIds = StrUtil.isEmpty(appraise.getScopeTeamIds()) ? Collections.emptyList() : JSONUtil.toList(appraise.getScopeTeamIds(), Long.class); if (CollUtil.isEmpty(teamIds)) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_SCOPE_TEAM_EMPTY); } employees = employeeMapper.selectListByTeamIds(teamIds); } else { employees = employeeMapper.selectListByStatus(EMPLOYEE_STATUS_ACTIVE); } if (CollUtil.isEmpty(employees)) { return 0; } // 2. 已存在结果的不再生成(幂等) List existing = resultMapper.selectList( new LambdaQueryWrapperX() .eq(HrmPerformanceAppraiseResultDO::getAppraiseId, appraiseId)); Set existingEmployeeIds = convertSet(existing, HrmPerformanceAppraiseResultDO::getEmployeeId); // 3. 生成空白结果行 int count = 0; for (HrmEmployeeDO employee : employees) { if (existingEmployeeIds.contains(employee.getId())) { continue; } resultMapper.insert(new HrmPerformanceAppraiseResultDO() .setAppraiseId(appraiseId) .setEmployeeId(employee.getId())); count++; } return count; } // ========== 私有方法 ========== private Integer calcGrade(BigDecimal finalScore) { if (finalScore == null) { return null; } if (finalScore.compareTo(GRADE_EXCELLENT) >= 0) { return GRADE_EXCELLENT_CODE; } if (finalScore.compareTo(GRADE_GOOD) >= 0) { return GRADE_GOOD_CODE; } if (finalScore.compareTo(GRADE_PASS) >= 0) { return GRADE_PASS_CODE; } return GRADE_IMPROVE_CODE; } private HrmPerformanceAppraiseDO validateAppraiseExists(Long id) { HrmPerformanceAppraiseDO appraise = appraiseMapper.selectById(id); if (appraise == null) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_NOT_EXISTS); } return appraise; } private HrmPerformanceAppraiseDO validateAppraiseCanModify(Long id) { HrmPerformanceAppraiseDO appraise = validateAppraiseExists(id); if (ObjUtil.notEqual(appraise.getStatus(), STATUS_DRAFT)) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_UPDATE_FAIL_NOT_DRAFT); } return appraise; } }