using Yi.Framework.AiHub.Application.Contracts.Dtos.UsageStatistics;

namespace Yi.Framework.AiHub.Application.Contracts.IServices;

/// <summary>
/// 使用量统计服务接口
/// </summary>
public interface IUsageStatisticsService
{
    /// <summary>
    /// 获取当前用户近7天的Token消耗统计
    /// </summary>
    /// <returns>每日Token使用量列表</returns>
    Task<List<DailyTokenUsageDto>> GetLast7DaysTokenUsageAsync(UsageStatisticsGetInput input);
    
    /// <summary>
    /// 获取当前用户各个模型的Token消耗量及占比
    /// </summary>
    /// <returns>模型Token使用量列表</returns>
    Task<List<ModelTokenUsageDto>> GetModelTokenUsageAsync(UsageStatisticsGetInput input);

    /// <summary>
    /// 获取当前用户尊享服务Token用量统计
    /// </summary>
    /// <returns>尊享服务Token用量统计</returns>
    Task<PremiumTokenUsageDto> GetPremiumTokenUsageAsync();
}