package cn.iocoder.yudao.module.crm.api.report;

import cn.iocoder.yudao.framework.common.pojo.CommonResult;
import cn.iocoder.yudao.module.crm.api.report.dto.CrmBusinessAnalyzeRespDTO;
import cn.iocoder.yudao.module.crm.api.report.dto.CrmContractAnalyzeRespDTO;
import cn.iocoder.yudao.module.crm.api.report.dto.CrmCustomerAnalyzeRespDTO;
import cn.iocoder.yudao.module.crm.api.report.dto.CrmSalesFunnelRespDTO;
import cn.iocoder.yudao.module.crm.api.report.dto.CrmSalesPerformanceRespDTO;

import java.time.LocalDateTime;

/**
 * CRM 营销报表 API 接口
 *
 * @author 芋道源码
 */
public interface CrmReportApi {

    String PREFIX = "/rpc-api/crm/report";

    /**
     * 获取客户分析统计
     *
     * @param startTime 开始时间
     * @param endTime   结束时间
     * @return 统计数据
     */
    CommonResult<CrmCustomerAnalyzeRespDTO> getCustomerAnalyze(LocalDateTime startTime, LocalDateTime endTime);

    /**
     * 获取商机分析统计
     *
     * @param startTime 开始时间
     * @param endTime   结束时间
     * @return 统计数据
     */
    CommonResult<CrmBusinessAnalyzeRespDTO> getBusinessAnalyze(LocalDateTime startTime, LocalDateTime endTime);

    /**
     * 获取合同分析统计
     *
     * @param startTime 开始时间
     * @param endTime   结束时间
     * @return 统计数据
     */
    CommonResult<CrmContractAnalyzeRespDTO> getContractAnalyze(LocalDateTime startTime, LocalDateTime endTime);

    /**
     * 获取销售漏斗统计
     *
     * @return 统计数据
     */
    CommonResult<CrmSalesFunnelRespDTO> getSalesFunnel();

    /**
     * 获取销售业绩统计
     *
     * @param startTime 开始时间
     * @param endTime   结束时间
     * @return 统计数据
     */
    CommonResult<CrmSalesPerformanceRespDTO> getSalesPerformance(LocalDateTime startTime, LocalDateTime endTime);

}