package cn.iocoder.yudao.module.erp.service.statistics;

import cn.iocoder.yudao.module.erp.controller.admin.statistics.vo.sale.ErpSaleCustomerSummaryRespVO;
import cn.iocoder.yudao.module.erp.controller.admin.statistics.vo.sale.ErpSaleProductSummaryRespVO;

import java.math.BigDecimal;
import java.time.LocalDateTime;
import java.util.List;

/**
 * ERP 销售统计 Service 接口
 *
 * @author 超级管理员
 */
public interface ErpSaleStatisticsService {

    /**
     * 获得销售金额
     *
     * 计算逻辑：销售出库的金额 - 销售退货的金额
     *
     * @param beginTime >= 开始时间
     * @param endTime < 结束时间
     * @return 销售金额
     */
    BigDecimal getSalePrice(LocalDateTime beginTime, LocalDateTime endTime);

    /**
     * 按客户统计销售款（销售额、已收款、未收款）
     *
     * 需求 6.7① 销售款统计、③ 客户销售统计
     *
     * @param customerId 客户编号，为空表示全部客户
     * @param beginTime  下单时间 >= 开始时间
     * @param endTime    下单时间 <= 结束时间
     * @return 客户维度统计列表（已填充客户名称）
     */
    List<ErpSaleCustomerSummaryRespVO> getCustomerSummary(Long customerId, LocalDateTime beginTime, LocalDateTime endTime);

    /**
     * 按产品统计销售量与销售额
     *
     * 需求 6.7② 产品销售统计
     *
     * @param productId 产品编号，为空表示全部产品
     * @param beginTime 下单时间 >= 开始时间
     * @param endTime   下单时间 <= 结束时间
     * @return 产品维度统计列表（已填充产品名称）
     */
    List<ErpSaleProductSummaryRespVO> getProductSummary(Long productId, LocalDateTime beginTime, LocalDateTime endTime);

}