using MediatR;
using TakeoutSaaS.Application.App.Billings.Dto;

namespace TakeoutSaaS.Application.App.Billings.Queries;

/// <summary>
/// 查询账单统计数据。
/// </summary>
public sealed record GetBillingStatisticsQuery : IRequest<BillingStatisticsDto>
{
    /// <summary>
    /// 租户 ID（可选，默认当前租户；禁止跨租户）。
    /// </summary>
    public long? TenantId { get; init; }

    /// <summary>
    /// 统计开始时间（UTC）。
    /// </summary>
    public DateTime? StartDate { get; init; }

    /// <summary>
    /// 统计结束时间（UTC）。
    /// </summary>
    public DateTime? EndDate { get; init; }

    /// <summary>
    /// 分组方式（Day/Week/Month）。
    /// </summary>
    public string? GroupBy { get; init; }
}
