package com.ruoyi.basic.service;
|
|
import com.baomidou.mybatisplus.core.metadata.IPage;
|
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
|
import com.baomidou.mybatisplus.extension.service.IService;
|
import com.ruoyi.basic.dto.CustomerDto;
|
import com.ruoyi.basic.pojo.Customer;
|
import com.ruoyi.basic.vo.CustomerVo;
|
import com.ruoyi.framework.web.domain.R;
|
import com.ruoyi.sales.vo.CustomerTransactionsDetailsVo;
|
import com.ruoyi.sales.vo.CustomerTransactionsVo;
|
import com.ruoyi.sales.vo.CustomerTransactionsProductVo;
|
import com.ruoyi.sales.vo.CustomerTransactionsShipmentVo;
|
import com.ruoyi.sales.vo.CustomerTransactionsSummaryVo;
|
import org.springframework.web.multipart.MultipartFile;
|
|
import java.util.List;
|
import java.util.Map;
|
|
/**
|
* 客户档案Service接口
|
*
|
* @author ruoyi
|
* @date 2025-05-07
|
*/
|
public interface ICustomerService extends IService<Customer> {
|
/**
|
* 查询客户档案
|
*
|
* @param id 客户档案主键
|
* @return 客户档案
|
*/
|
Customer selectCustomerById(Long id);
|
|
/**
|
* 查询客户详情（含跟进记录和附件）
|
*
|
* @param id 客户档案主键
|
* @return 客户详情DTO
|
*/
|
CustomerVo selectCustomerDetailById(Long id);
|
|
/**
|
* 查询客户档案列表
|
*
|
* @param customer 客户档案
|
* @return 客户档案集合
|
*/
|
|
/**
|
* 新增客户档案
|
*
|
* @param customer 客户档案
|
* @return 结果
|
*/
|
int insertCustomer(Customer customer);
|
|
/**
|
* 修改客户档案
|
*
|
* @param customer 客户档案
|
* @return 结果
|
*/
|
int updateCustomer(Customer customer);
|
|
/**
|
* 批量删除客户档案
|
*
|
* @param ids 需要删除的客户档案主键集合
|
* @return 结果
|
*/
|
int deleteCustomerByIds(Long[] ids);
|
|
List<Customer> selectCustomerListByIds(Long[] ids);
|
|
/**
|
* 查询客户信息
|
*
|
* @return 结果
|
*/
|
List<Map<String, Object>> customerList(Customer customer);
|
|
List<CustomerVo> selectCustomerLists(CustomerDto customer);
|
|
R importData(MultipartFile file, Integer type);
|
|
IPage<CustomerVo> selectCustomerList(Page<CustomerDto> page, CustomerDto customer);
|
|
void assignCustomer(CustomerDto customer);
|
|
void recycleCustomer(CustomerDto customer);
|
|
/**
|
* 共享客户给其他用户
|
*
|
* @param customerDto 客户DTO（包含客户ID和共享用户ID列表）
|
*/
|
void together(CustomerDto customerDto);
|
|
Boolean back(Long id);
|
|
/**
|
* 查询客户往来列表
|
* @param page
|
* @param customerName
|
* @return
|
*/
|
IPage<CustomerTransactionsVo> customewTransactions(Page page, String customerName);
|
|
/**
|
* 查询客户往来明细列表
|
* @param page
|
* @param customerId
|
* @return
|
*/
|
IPage<CustomerTransactionsDetailsVo> customewTransactionsDetails(Page page, Long customerId);
|
|
/**
|
* 查询客户往来统计汇总（优化版）
|
* @param customerId 客户ID
|
* @return 统计汇总数据
|
*/
|
CustomerTransactionsSummaryVo getCustomerTransactionsSummary(Long customerId);
|
|
/**
|
* 查询客户往来产品明细
|
* @param page 分页参数
|
* @param customerId 客户ID
|
* @param salesLedgerId 销售台账ID（可选）
|
* @return 产品明细分页数据
|
*/
|
IPage<CustomerTransactionsProductVo> getCustomerTransactionsProducts(Page page, Long customerId, Long salesLedgerId);
|
|
/**
|
* 查询客户往来发货明细
|
* @param page 分页参数
|
* @param customerId 客户ID
|
* @param salesLedgerId 销售台账ID（可选）
|
* @return 发货明细分页数据
|
*/
|
IPage<CustomerTransactionsShipmentVo> getCustomerTransactionsShipments(Page page, Long customerId, Long salesLedgerId);
|
}
|
