package com.ruoyi.credit.service;

import java.math.BigDecimal;
import java.util.List;
import java.util.Map;

import com.ruoyi.credit.domain.UnifiedBankData;

/**
 * 统一银行数据服务接口
 * 
 * @author ruoyi
 * @date 2025-12-25
 */
public interface IUnifiedBankService 
{
    /**
     * 获取统一格式的银行列表
     * 
     * @param params 查询参数
     * @return 统一银行数据列表
     */
    List<UnifiedBankData> selectUnifiedBankList(Map<String, Object> params);

    /**
     * 根据银行ID获取统一格式的银行详情
     * 
     * @param bankId 银行ID
     * @return 统一银行数据
     */
    UnifiedBankData selectUnifiedBankById(Long bankId);

    /**
     * 根据贷款条件匹配银行
     * 
     * @param loanAmount 贷款金额
     * @param termMonths 贷款期限（月）
     * @return 匹配的银行列表
     */
    List<UnifiedBankData> matchUnifiedBanks(BigDecimal loanAmount, Integer termMonths);

    /**
     * 获取活跃的银行列表
     * 
     * @return 活跃银行列表
     */
    List<UnifiedBankData> selectActiveUnifiedBanks();

    /**
     * 转换银行管理界面数据为统一格式
     * 
     * @param servicePeriodId 服务周期ID
     * @param contractTermMonths 合同期限
     * @return 统一格式的银行数据
     */
    List<UnifiedBankData> convertFromServicePeriodLoanData(Long servicePeriodId, Integer contractTermMonths);
}