package cn.iocoder.yudao.module.system.api.approval;

import java.util.Set;

/**
 * 通用审批配置 API 接口
 *
 * 供各业务模块（ERP / CRM / HRM / MES / 售后）在提交审批、执行审核时调用，
 * 替代原先依赖 BPM（Flowable）流程定义的方式。
 *
 * @author 超级管理员
 */
public interface ApprovalConfigApi {

    /**
     * 校验业务类型已启用审批且配置了有效审批人，并返回审批人编号集合
     *
     * 业务模块在「提交审核」时调用。校验失败时抛出业务异常：
     * 未配置审批 / 未启用审批 / 未配置审批人。
     *
     * @param bizType 业务类型编码
     * @return 审批人用户编号集合
     */
    Set<Long> validateApprovalEnabledAndGetApprovers(String bizType);

    /**
     * 校验指定用户是否为该业务类型的审批人
     *
     * 业务模块在「执行审核」时调用，非审批人将抛出业务异常。
     *
     * @param bizType 业务类型编码
     * @param userId  用户编号
     */
    void validateApprover(String bizType, Long userId);

    /**
     * 获得指定业务类型的审批人编号集合
     *
     * 用于列表页判断是否展示审核按钮，未配置时返回空集合。
     *
     * @param bizType 业务类型编码
     * @return 审批人用户编号集合
     */
    Set<Long> getApproverUserIds(String bizType);

    /**
     * 判断指定用户是否为该业务类型的审批人
     *
     * @param bizType 业务类型编码
     * @param userId  用户编号
     * @return 是否为审批人
     */
    default boolean isApprover(String bizType, Long userId) {
        return userId != null && getApproverUserIds(bizType).contains(userId);
    }

}