package cn.iocoder.yudao.module.hrm.service.performanceappraise; import cn.hutool.core.collection.CollUtil; import cn.hutool.core.util.ObjUtil; 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.bpm.api.task.BpmProcessInstanceApi; import cn.iocoder.yudao.module.bpm.api.task.dto.BpmProcessInstanceCreateReqDTO; import cn.iocoder.yudao.module.bpm.dal.dataobject.definition.BpmProcessDefinitionInfoDO; import cn.iocoder.yudao.module.bpm.service.definition.BpmCategoryService; import cn.iocoder.yudao.module.bpm.service.definition.BpmProcessDefinitionService; import cn.iocoder.yudao.module.hrm.controller.admin.performanceappraise.vo.*; import cn.iocoder.yudao.module.hrm.dal.dataobject.performanceappraise.*; 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 jakarta.annotation.Resource; import lombok.extern.slf4j.Slf4j; import org.flowable.engine.repository.ProcessDefinition; 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.time.LocalDateTime; 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; import static cn.iocoder.yudao.module.hrm.util.HrmAuditStatusUtils.convertBpmResultToAuditStatus; /** * 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; /** * BPM 绩效考核审批分类编码 */ private static final String APPRAISE_APPROVE_CATEGORY_CODE = "performance_appraise_approve"; @Resource private HrmPerformanceAppraiseMapper appraiseMapper; @Resource private HrmPerformanceAppraiseItemMapper itemMapper; @Resource private HrmPerformanceAppraiseResultMapper resultMapper; @Resource private HrmPerformanceAppraiseResultItemMapper resultItemMapper; @Resource private BpmProcessInstanceApi bpmProcessInstanceApi; @Resource private BpmCategoryService bpmCategoryService; @Resource private BpmProcessDefinitionService bpmProcessDefinitionService; @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())); 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()) .setProcessInstanceId(oldAppraise.getProcessInstanceId())); 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, String processDefinitionKey, Long userId) { // 1. 校验方案是否在草稿状态 HrmPerformanceAppraiseDO appraise = appraiseMapper.selectById(id); if (appraise == null) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_NOT_EXISTS); } if (ObjUtil.notEqual(appraise.getAuditStatus(), HrmAuditStatusEnum.DRAFT.getStatus())) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_SUBMIT_FAIL_NOT_DRAFT); } if (CollUtil.isEmpty(itemMapper.selectListByAppraiseId(id))) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_ITEM_EMPTY); } // 2. 校验审批分类和流程定义是否存在,且传入的流程定义处于激活状态 validateAppraiseApproveCategoryAndProcessDefinition(); ProcessDefinition processDefinition = bpmProcessDefinitionService.getActiveProcessDefinition(processDefinitionKey); if (processDefinition == null) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_BPM_PROCESS_DEFINITION_NOT_EXISTS); } // 3. 创建审批流程实例 String processInstanceId = bpmProcessInstanceApi.createProcessInstance(userId, new BpmProcessInstanceCreateReqDTO().setProcessDefinitionKey(processDefinitionKey) .setBusinessKey(String.valueOf(id))); // 4. 更新方案流程编号与审批状态 appraiseMapper.updateById(new HrmPerformanceAppraiseDO().setId(id).setProcessInstanceId(processInstanceId) .setAuditStatus(HrmAuditStatusEnum.PROCESS.getStatus())); } @Override @Transactional(rollbackFor = Exception.class) public void auditAppraise(HrmPerformanceAppraiseAuditReqVO auditReqVO) { HrmPerformanceAppraiseDO appraise = validateAppraiseExists(auditReqVO.getId()); if (ObjUtil.notEqual(appraise.getAuditStatus(), HrmAuditStatusEnum.PROCESS.getStatus())) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_UPDATE_AUDIT_STATUS_FAIL_NOT_PROCESS); } Integer auditStatus = auditReqVO.getAuditStatus(); if (!Objects.equals(auditStatus, HrmAuditStatusEnum.APPROVE.getStatus()) && !Objects.equals(auditStatus, HrmAuditStatusEnum.REJECT.getStatus())) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_UPDATE_AUDIT_STATUS_FAIL_NOT_PROCESS); } HrmPerformanceAppraiseDO update = new HrmPerformanceAppraiseDO() .setId(appraise.getId()) .setAuditStatus(auditStatus) .setAuditUserId(getLoginUserId()) .setAuditTime(LocalDateTime.now()); if (auditReqVO.getRemark() != null) { update.setAuditRemark(auditReqVO.getRemark()); } // 审批通过 -> 方案发布 if (Objects.equals(auditStatus, HrmAuditStatusEnum.APPROVE.getStatus())) { update.setStatus(STATUS_PUBLISHED); } appraiseMapper.updateById(update); } @Override @Transactional(rollbackFor = Exception.class) public void updateAppraiseAuditStatus(Long id, Integer bpmResult) { // 1.1 校验方案是否存在 HrmPerformanceAppraiseDO appraise = appraiseMapper.selectById(id); if (appraise == null) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_NOT_EXISTS); } // 1.2 只有审批中,可以更新审批结果 if (ObjUtil.notEqual(appraise.getAuditStatus(), HrmAuditStatusEnum.PROCESS.getStatus())) { log.error("[updateAppraiseAuditStatus][appraise({}) 不处于审批中,无法更新审批结果({})]", appraise.getId(), bpmResult); throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_UPDATE_AUDIT_STATUS_FAIL_NOT_PROCESS); } // 2. 更新方案审批结果 Integer auditStatus = convertBpmResultToAuditStatus(bpmResult); HrmPerformanceAppraiseDO update = new HrmPerformanceAppraiseDO().setId(id).setAuditStatus(auditStatus); if (Objects.equals(auditStatus, HrmAuditStatusEnum.APPROVE.getStatus())) { update.setStatus(STATUS_PUBLISHED); } appraiseMapper.updateById(update); } @Override public List> getAppraiseApproveProcessDefinitionList() { // 1. 校验审批分类和流程定义是否存在 validateAppraiseApproveCategoryAndProcessDefinition(); // 2. 获取分类下的流程定义信息 List definitionInfoList = bpmProcessDefinitionService .getProcessDefinitionInfoListByCategory(APPRAISE_APPROVE_CATEGORY_CODE); // 3. 获取流程定义详情 Set processDefinitionIds = convertSet(definitionInfoList, BpmProcessDefinitionInfoDO::getProcessDefinitionId); List processDefinitions = bpmProcessDefinitionService.getProcessDefinitionList(processDefinitionIds); // 4. 过滤:只保留激活状态,且相同 key 只保留最新版本 Map latestVersionMap = new HashMap<>(); for (ProcessDefinition pd : processDefinitions) { if (pd.isSuspended()) { continue; } ProcessDefinition existing = latestVersionMap.get(pd.getKey()); if (existing == null || pd.getVersion() > existing.getVersion()) { latestVersionMap.put(pd.getKey(), pd); } } // 5. 返回流程定义列表 List> result = new ArrayList<>(); for (ProcessDefinition pd : latestVersionMap.values()) { Map item = new HashMap<>(); item.put("id", pd.getId()); item.put("key", pd.getKey()); item.put("name", pd.getName()); item.put("version", pd.getVersion()); result.add(item); } return result; } @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); } // ========== 私有方法 ========== 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; } /** * 校验 BPM 绩效考核审批分类和流程定义是否存在 */ private void validateAppraiseApproveCategoryAndProcessDefinition() { // 1. 校验分类是否存在 Map categoryMap = bpmCategoryService.getCategoryMap(Collections.singletonList(APPRAISE_APPROVE_CATEGORY_CODE)); if (!categoryMap.containsKey(APPRAISE_APPROVE_CATEGORY_CODE)) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_BPM_PROCESS_DEFINITION_NOT_EXISTS); } // 2. 校验分类下是否有可用的流程定义 List definitionInfoList = bpmProcessDefinitionService .getProcessDefinitionInfoListByCategory(APPRAISE_APPROVE_CATEGORY_CODE); if (CollUtil.isEmpty(definitionInfoList)) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_BPM_PROCESS_DEFINITION_NOT_EXISTS); } // 3. 校验是否有激活状态的流程定义 Set processDefinitionIds = convertSet(definitionInfoList, BpmProcessDefinitionInfoDO::getProcessDefinitionId); List processDefinitions = bpmProcessDefinitionService.getProcessDefinitionList(processDefinitionIds); boolean hasActiveDefinition = processDefinitions.stream().anyMatch(pd -> !pd.isSuspended()); if (!hasActiveDefinition) { throw exception(ErrorCodeConstants.PERFORMANCE_APPRAISE_BPM_PROCESS_DEFINITION_NOT_EXISTS); } } }