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

import cn.iocoder.yudao.module.finance.controller.admin.statistics.vo.FinStatisticsOverviewRespVO;
import cn.iocoder.yudao.module.finance.controller.admin.statistics.vo.FinStatisticsReqVO;
import cn.iocoder.yudao.module.finance.controller.admin.statistics.vo.FinStatisticsTrendRespVO;
import jakarta.validation.Valid;

import java.util.List;

/**
 * 财务报表 / 会计核算看板 Service 接口
 *
 * 数据来源：
 * 1. 收支、购销金额取自 ERP 模块（收款单、付款单、销售订单、采购订单），
 *    通过 {@link cn.iocoder.yudao.module.erp.api.finance.ErpFinanceStatisticsApi} 取数，不跨模块查表；
 * 2. 资产数据取自本模块的固定资产、无形资产；
 * 3. 凭证数据取自本模块的记账凭证。
 *
 * @author 超级管理员
 */
public interface FinStatisticsService {

    /**
     * 获得会计核算看板总览
     *
     * @param reqVO 查询条件，期间留空时默认本年 1 月至当前月
     * @return 看板总览
     */
    FinStatisticsOverviewRespVO getStatisticsOverview(@Valid FinStatisticsReqVO reqVO);

    /**
     * 获得月度收支趋势
     *
     * @param reqVO 查询条件，期间留空时默认本年 1 月至当前月
     * @return 月度趋势列表，期间内没有数据的月份补 0
     */
    List<FinStatisticsTrendRespVO> getStatisticsTrend(@Valid FinStatisticsReqVO reqVO);

}