云
2026-10-25 d54fbc9d4f8981fa0f7f613b33a28a8cd4f764ea
yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performanceappraise/HrmPerformanceAppraiseService.java
@@ -9,7 +9,7 @@
import java.util.Collection;
import java.util.List;
import java.util.Map;
import java.util.Set;
/**
 * HRM 绩效考核方案 Service 接口
@@ -37,24 +37,42 @@
    void saveAppraiseItems(HrmPerformanceAppraiseItemSaveReqVO saveReqVO);
    /**
     * 提交绩效考核方案审批
     * 提交绩效考核方案审批(草稿 / 审核不通过 → 审批中)
     *
     * 审批人由「系统管理 - 审批配置」按业务类型统一指定,提交时无需选择。
     *
     * @param id 方案编号
     */
    void submitAppraise(Long id, String processDefinitionKey, Long userId);
    void submitAppraise(Long id);
    /**
     * 审批绩效考核方案(通过/驳回,manual)
     * 获得绩效考核方案的审批人编号集合,供前端判断是否展示审核按钮
     *
     * @return 审批人用户编号集合
     */
    void auditAppraise(HrmPerformanceAppraiseAuditReqVO auditReqVO);
    Set<Long> getAppraiseApproverUserIds();
    /**
     * 更新绩效考核方案审批状态(BPM 监听回调)
     * 审核绩效考核方案(审批中 → 审核通过 / 审核不通过)
     *
     * 审核通过时方案状态流转为「已发布」。
     *
     * @param id           方案编号
     * @param pass         是否通过
     * @param reviewRemark 审核意见(不通过时必填)
     */
    void updateAppraiseAuditStatus(Long id, Integer bpmResult);
    void auditAppraise(Long id, Boolean pass, String reviewRemark);
    /**
     * 获得绩效考核方案审批流程定义列表
     * 根据 BPM 审批结果回写绩效考核方案审批状态
     *
     * 审批通过时方案状态流转为「已发布」。
     *
     * @param id        方案编号
     * @param bpmStatus BPM 任务状态(2-通过 3-不通过 4-取消)
     * @param reason    审批意见 / 取消原因
     */
    List<Map<String, Object>> getAppraiseApproveProcessDefinitionList();
    void updateAppraiseAuditStatus(Long id, Integer bpmStatus, String reason);
    /**
     * 保存员工考核结果(按员工逐指标打分,自动计算综合得分与档级)
@@ -84,4 +102,14 @@
     */
    Integer generateAppraisees(Long appraiseId);
    /**
     * 导入绩效考核方案列表(导入的均为草稿)
     *
     * @param importList   导入列表
     * @param importReqVO  导入请求参数
     * @return 导入结果
     */
    HrmPerformanceAppraiseImportRespVO importAppraiseList(List<HrmPerformanceAppraiseImportExcelVO> importList,
                                                          HrmPerformanceAppraiseImportReqVO importReqVO);
}