using TakeoutSaaS.Domain.Tenants.Enums;

namespace TakeoutSaaS.AdminApi.Contracts.Requests;

/// <summary>
/// 租户账单分页查询请求（QueryString 参数）。
/// </summary>
public sealed record SearchTenantBillsRequest
{
    /// <summary>
    /// 账单状态筛选。
    /// </summary>
    public TenantBillingStatus? Status { get; init; }

    /// <summary>
    /// 账单起始时间（UTC）筛选。
    /// </summary>
    public DateTime? From { get; init; }

    /// <summary>
    /// 账单结束时间（UTC）筛选。
    /// </summary>
    public DateTime? To { get; init; }

    /// <summary>
    /// 页码（从 1 开始）。
    /// </summary>
    public int Page { get; init; } = 1;

    /// <summary>
    /// 每页条数。
    /// </summary>
    public int PageSize { get; init; } = 20;
}
