package com.ruoyi.payment.service;

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

import com.ruoyi.payment.domain.EscrowAccount;

/**
 * 资金监管账户服务接口
 * 
 * @author ruoyi
 * @date 2025-12-19
 */
public interface IEscrowAccountService 
{
    /**
     * 创建监管账户
     * 
     * @param applicationId 融资申请ID
     * @param totalAmount 总金额
     * @return 监管账户
     */
    public EscrowAccount createEscrowAccount(Long applicationId, BigDecimal totalAmount);

    /**
     * 资金存入
     * 
     * @param accountId 账户ID
     * @param amount 存入金额
     * @return 存入结果
     */
    public boolean depositFunds(Long accountId, BigDecimal amount);

    /**
     * 资金分配
     * 
     * @param accountId 账户ID
     * @param distributionPlan 分配计划
     * @return 分配结果
     */
    public boolean distributeFunds(Long accountId, Map<String, BigDecimal> distributionPlan);

    /**
     * 资金转账
     * 
     * @param fromAccountId 转出账户ID
     * @param toAccountId 转入账户ID
     * @param amount 转账金额
     * @return 转账结果
     */
    public boolean transferFunds(Long fromAccountId, Long toAccountId, BigDecimal amount);

    /**
     * 冻结资金
     * 
     * @param accountId 账户ID
     * @param amount 冻结金额
     * @return 冻结结果
     */
    public boolean freezeFunds(Long accountId, BigDecimal amount);

    /**
     * 解冻资金
     * 
     * @param accountId 账户ID
     * @param amount 解冻金额
     * @return 解冻结果
     */
    public boolean unfreezeFunds(Long accountId, BigDecimal amount);

    /**
     * 查询账户余额
     * 
     * @param accountId 账户ID
     * @return 账户余额信息
     */
    public Map<String, BigDecimal> getAccountBalance(Long accountId);

    /**
     * 监控账户状态
     * 
     * @param accountId 账户ID
     * @return 账户状态信息
     */
    public Map<String, Object> monitorAccountStatus(Long accountId);

    /**
     * 跟踪资金流向
     * 
     * @param accountId 账户ID
     * @return 资金流向记录
     */
    public List<Map<String, Object>> trackFundFlow(Long accountId);

    /**
     * 查询监管账户
     * 
     * @param accountId 账户ID
     * @return 监管账户
     */
    public EscrowAccount selectEscrowAccountById(Long accountId);

    /**
     * 根据申请ID查询监管账户
     * 
     * @param applicationId 申请ID
     * @return 监管账户
     */
    public EscrowAccount selectEscrowAccountByApplicationId(Long applicationId);

    /**
     * 查询监管账户列表
     * 
     * @param escrowAccount 监管账户
     * @return 监管账户集合
     */
    public List<EscrowAccount> selectEscrowAccountList(EscrowAccount escrowAccount);

    /**
     * 更新账户状态
     * 
     * @param accountId 账户ID
     * @param status 状态
     * @return 更新结果
     */
    public boolean updateAccountStatus(Long accountId, String status);

    /**
     * 生成账户号码
     * 
     * @return 账户号码
     */
    public String generateAccountNumber();

    /**
     * 验证账户余额充足
     * 
     * @param accountId 账户ID
     * @param amount 金额
     * @return 验证结果
     */
    public boolean validateSufficientBalance(Long accountId, BigDecimal amount);
}