package com.ruoyi.credit.service;

import java.util.List;
import com.ruoyi.credit.domain.BankInstitution;

/**
 * 银行机构Service接口
 * 
 * @author ruoyi
 * @date 2025-12-24
 */
public interface IBankInstitutionService 
{
    /**
     * 查询银行机构
     * 
     * @param bankId 银行机构主键
     * @return 银行机构
     */
    public BankInstitution selectBankInstitutionByBankId(Long bankId);

    /**
     * 查询银行机构列表
     * 
     * @param bankInstitution 银行机构
     * @return 银行机构集合
     */
    public List<BankInstitution> selectBankInstitutionList(BankInstitution bankInstitution);

    /**
     * 新增银行机构
     * 
     * @param bankInstitution 银行机构
     * @return 结果
     */
    public int insertBankInstitution(BankInstitution bankInstitution);

    /**
     * 修改银行机构
     * 
     * @param bankInstitution 银行机构
     * @return 结果
     */
    public int updateBankInstitution(BankInstitution bankInstitution);

    /**
     * 批量删除银行机构
     * 
     * @param bankIds 需要删除的银行机构主键集合
     * @return 结果
     */
    public int deleteBankInstitutionByBankIds(Long[] bankIds);

    /**
     * 删除银行机构信息
     * 
     * @param bankId 银行机构主键
     * @return 结果
     */
    public int deleteBankInstitutionByBankId(Long bankId);

    /**
     * 根据银行编码查询银行机构
     * 
     * @param bankCode 银行编码
     * @return 银行机构
     */
    public BankInstitution selectBankInstitutionByBankCode(String bankCode);

    /**
     * 查询合作状态为活跃的银行机构列表
     * 
     * @return 银行机构集合
     */
    public List<BankInstitution> selectActiveBankInstitutions();

    /**
     * 根据贷款条件匹配银行机构
     * 
     * @param loanAmount 贷款金额
     * @param loanTermMonths 贷款期限(月)
     * @return 匹配的银行机构集合
     */
    public List<BankInstitution> matchBankInstitutions(java.math.BigDecimal loanAmount, Integer loanTermMonths);

    /**
     * 根据当前用户权限查询银行机构列表 (支持账号过滤)
     * 
     * @param bankInstitution 银行机构查询条件
     * @param currentUserType 当前用户类型
     * @param currentUserName 当前用户名
     * @return 银行机构集合
     */
    public List<BankInstitution> selectBankInstitutionListWithPermission(BankInstitution bankInstitution, String currentUserType, String currentUserName);

    /**
     * 根据创建者账号类型查询银行机构列表
     * 
     * @param creatorAccountType 创建者账号类型
     * @return 银行机构集合
     */
    public List<BankInstitution> selectBankInstitutionsByCreatorAccountType(String creatorAccountType);
}