package com.ruoyi.cwgl.service;

import java.util.List;
import com.ruoyi.cwgl.domain.ReceivableFeeManagement;
import com.ruoyi.cwgl.domain.vo.ReceivableFeeStatisticsVo;
import com.ruoyi.cwgl.domain.vo.ReceivableBillCreateVo;
import com.baomidou.mybatisplus.extension.service.IService;
/**
 * 应收费用管理Service接口
 * 
 * @author ruoyi
 * @date 2025-12-17
 */
public interface IReceivableFeeManagementService extends IService<ReceivableFeeManagement>
{
    /**
     * 查询应收费用管理
     * 
     * @param id 应收费用管理ID
     * @return 应收费用管理
     */
    public ReceivableFeeManagement selectReceivableFeeManagementById(Integer id);

    /**
     * 查询应收费用管理 记录数
     *
     * @param receivableFeeManagement 应收费用管理
     * @return 应收费用管理集合
     */
    public int selectReceivableFeeManagementCount(ReceivableFeeManagement receivableFeeManagement);

    /**
     * 查询应收费用管理列表
     * 
     * @param receivableFeeManagement 应收费用管理
     * @return 应收费用管理集合
     */
    public List<ReceivableFeeManagement> selectReceivableFeeManagementList(ReceivableFeeManagement receivableFeeManagement);

    /**
     * 查询应收费用管理列表 异步 导出
     *
     * @param receivableFeeManagement 应收费用管理
     * @param exportKey 导出功能的唯一标识
     * @return 应收费用管理集合
     */
    public void export(ReceivableFeeManagement receivableFeeManagement, String exportKey) ;


    /**
     * 新增应收费用管理
     * 
     * @param receivableFeeManagement 应收费用管理
     * @return 结果
     */
    public int insertReceivableFeeManagement(ReceivableFeeManagement receivableFeeManagement);

    /**
     * 新增应收费用管理[批量]
     *
     * @param receivableFeeManagements 应收费用管理
     * @return 结果
     */
    public int insertReceivableFeeManagementBatch(List<ReceivableFeeManagement> receivableFeeManagements);

    /**
     * 修改应收费用管理
     * 
     * @param receivableFeeManagement 应收费用管理
     * @return 结果
     */
    public int updateReceivableFeeManagement(ReceivableFeeManagement receivableFeeManagement);

    /**
     * 修改应收费用管理[批量]
     *
     * @param receivableFeeManagements 应收费用管理
     * @return 结果
     */
    public int updateReceivableFeeManagementBatch(List<ReceivableFeeManagement> receivableFeeManagements);
    /**
     * 批量删除应收费用管理
     * 
     * @param ids 需要删除的数据ID
     * @return 结果
     */
    public int deleteReceivableFeeManagementByIds(String ids);

    /**
     * 批量删除应收费用管理
     *
     * @param ids 需要删除的数据ID
     * @return 结果
     */
    public int deleteReceivableFeeManagementByIds(Integer[] ids);

    /**
     * 删除应收费用管理信息
     * 
     * @param id 应收费用管理ID
     * @return 结果
     */
    public int deleteReceivableFeeManagementById(Integer id);

    public ReceivableFeeStatisticsVo getReceivableFeeStatistics(Integer[] ids);

    /**
     * 根据统计数据创建应收账单
     * 
     * @param billCreateVo 包含统计数据和账单类型的请求对象
     * @return 创建的应收账单ID
     */
    public Integer createReceivableBill(ReceivableBillCreateVo billCreateVo);
    
    /**
     * 作废应收费用管理记录
     * 
     * @param id 应收费用管理ID
     * @return 结果
     */
    public int voidReceivableFeeManagement(Integer id);
    
    /**
     * 根据关联账单编号批量更新应收费用管理记录
     * 清除关联账单编号并将状态改为0（待生成账单）
     * 
     * @param relatedBillNo 关联账单编号
     * @return 结果
     */
    public int updateReceivableFeeManagementByRelatedBillNo(String relatedBillNo);

    /**
     * 导入应收费用管理数据（包含明细数据）
     * 
     * @param receivableFeeList 应收费用管理数据列表（包含明细数据）
     * @param operName 操作用户
     * @return 结果
     */
    public String importReceivableFee(List<ReceivableFeeManagement> receivableFeeList, String operName);

    /**
     * 下载导入模板
     * 
     * @param exportKey 导出功能的唯一标识
     */
    public void importTemplate(String exportKey);
}