package cn.iocoder.yudao.module.erp.dal.mysql.finance;

import cn.iocoder.yudao.module.erp.api.finance.dto.ErpFinanceMonthlyStatisticsRespDTO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

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

/**
 * ERP 财务统计 Mapper
 *
 * 为财务模块的报表、看板提供按月聚合的收款 / 付款 / 销售订单 / 采购订单金额
 *
 * @author 超级管理员
 */
@Mapper
public interface ErpFinanceStatisticsMapper {

    /**
     * 按月统计收款、付款、销售订单、采购订单金额
     *
     * @param approveStatus 已审核状态值
     * @param startTime     开始时间（含）
     * @param endTime       结束时间（不含）
     * @return 月度统计列表，按月份升序
     */
    List<ErpFinanceMonthlyStatisticsRespDTO> selectMonthlyStatistics(@Param("approveStatus") Integer approveStatus,
                                                                     @Param("startTime") LocalDateTime startTime,
                                                                     @Param("endTime") LocalDateTime endTime);

}