// Copyright (c) 2022-Now 少林寺驻北固山办事处大神父王喇嘛
//
// SimpleAdmin 基于 Apache License Version 2.0 协议发布，可用于商业项目，但必须遵守以下补充条款:
// 1.请不要删除和修改根目录下的LICENSE文件。
// 2.请不要删除和修改SimpleAdmin源码头部的版权声明。
// 3.分发源码时候，请注明软件出处 https://gitee.com/dotnetmoyu/SimpleAdmin

namespace SimpleAdmin.Application.Services.Statistics
{
    /// <summary>
    /// 统计分析 Service 接口
    /// </summary>
    public interface IStatisticsService : ITransient
    {
        /// <summary>
        /// 获取全量总览数据（不区分年份，含剩余药材库存价值）
        /// </summary>
        Task<TotalOverviewDto> GetTotalOverview();

        /// <summary>
        /// 获取指定年份的年度汇总统计数据（含同比趋势）
        /// </summary>
        /// <param name="year">年份，如 2025</param>
        Task<YearlyStatisticsDto> GetYearlyStatistics(int year);

        /// <summary>
        /// 获取指定年份的逐月明细数据（返回 12 条，无数据月份补零）
        /// </summary>
        /// <param name="year">年份，如 2025</param>
        Task<List<MonthlyDetailDto>> GetMonthlyDetails(int year);
    }
}