package cn.iocoder.yudao.module.system.service.approval;
|
|
import cn.iocoder.yudao.framework.common.pojo.PageResult;
|
import cn.iocoder.yudao.module.system.controller.admin.approval.vo.ApprovalConfigPageReqVO;
|
import cn.iocoder.yudao.module.system.controller.admin.approval.vo.ApprovalConfigRespVO;
|
import cn.iocoder.yudao.module.system.controller.admin.approval.vo.ApprovalConfigSaveReqVO;
|
import cn.iocoder.yudao.module.system.dal.dataobject.approval.ApprovalConfigDO;
|
|
import java.util.Set;
|
|
/**
|
* 通用审批配置 Service 接口
|
*
|
* @author 超级管理员
|
*/
|
public interface ApprovalConfigService {
|
|
/**
|
* 保存审批配置（新增或修改）
|
*
|
* 审批人采用整体覆盖方式保存，即传入的 userIds 即为最终结果。
|
*
|
* @param saveReqVO 保存信息
|
* @return 配置编号
|
*/
|
Long saveApprovalConfig(ApprovalConfigSaveReqVO saveReqVO);
|
|
/**
|
* 删除审批配置
|
*
|
* @param id 配置编号
|
*/
|
void deleteApprovalConfig(Long id);
|
|
/**
|
* 获得审批配置
|
*
|
* @param id 配置编号
|
* @return 审批配置
|
*/
|
ApprovalConfigDO getApprovalConfig(Long id);
|
|
/**
|
* 按业务类型获得审批配置
|
*
|
* @param bizType 业务类型编码
|
* @return 审批配置，不存在时返回 null
|
*/
|
ApprovalConfigDO getApprovalConfigByBizType(String bizType);
|
|
/**
|
* 获得审批配置分页，含审批人信息
|
*
|
* @param pageReqVO 分页查询
|
* @return 分页结果
|
*/
|
PageResult<ApprovalConfigRespVO> getApprovalConfigPage(ApprovalConfigPageReqVO pageReqVO);
|
|
/**
|
* 获得指定业务类型的审批人用户编号集合
|
*
|
* @param bizType 业务类型编码
|
* @return 审批人用户编号集合，未配置时返回空集合
|
*/
|
Set<Long> getApproverUserIds(String bizType);
|
|
/**
|
* 校验审批流程可用，并返回审批人集合
|
*
|
* 校验内容：业务类型已启用审批、且已配置至少一个有效审批人。
|
* 供各业务模块在「提交审核」时调用。
|
*
|
* @param bizType 业务类型编码
|
* @return 审批人用户编号集合
|
*/
|
Set<Long> validateApprovalEnabledAndGetApprovers(String bizType);
|
|
/**
|
* 校验指定用户是否为该业务类型的审批人
|
*
|
* 供各业务模块在「审核」时调用。
|
*
|
* @param bizType 业务类型编码
|
* @param userId 用户编号
|
*/
|
void validateApprover(String bizType, Long userId);
|
|
}
|
