package com.ruoyi.basic.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.ruoyi.basic.dto.CustomerContractRecordDto;
import com.ruoyi.basic.dto.StorageBlobVO;
import com.ruoyi.basic.pojo.CustomerContractRecord;

import java.util.List;

/**
 * 客户合同记录Service接口
 *
 * @author ruoyi
 * @date 2026-06-24
 */
public interface CustomerContractRecordService extends IService<CustomerContractRecord> {

    /**
     * 查询客户合同记录列表
     *
     * @param customerId 客户ID
     * @return 合同记录列表
     */
    List<CustomerContractRecordDto> selectListByCustomerId(Long customerId);

    /**
     * 查询客户合同记录详情（含附件）
     *
     * @param id 合同记录ID
     * @return 合同记录详情
     */
    CustomerContractRecordDto selectDetailById(Long id);

    /**
     * 新增客户合同记录
     *
     * @param dto 合同记录信息
     * @return 结果
     */
    int insertCustomerContractRecord(CustomerContractRecordDto dto);

    /**
     * 修改客户合同记录
     *
     * @param dto 合同记录信息
     * @return 结果
     */
    int updateCustomerContractRecord(CustomerContractRecordDto dto);

    /**
     * 删除客户合同记录
     *
     * @param id 合同记录ID
     * @return 结果
     */
    int deleteCustomerContractRecord(Long id);

    /**
     * 根据总合同号查询附件列表
     *
     * @param masterContractNo 总合同号
     * @return 附件列表
     */
    List<StorageBlobVO> selectFilesByMasterContractNo(String masterContractNo);
}