TakeoutSaaS.AdminApi/src/Application/TakeoutSaaS.Application/App/Billings/Dto/BillingListDto.cs

using System.Text.Json.Serialization;
using TakeoutSaaS.Domain.Tenants.Enums;
using TakeoutSaaS.Shared.Abstractions.Serialization;

namespace TakeoutSaaS.Application.App.Billings.Dto;

/// <summary>
/// 账单列表 DTO（管理员端列表展示）。
/// </summary>
public sealed record BillingListDto
{
    /// <summary>
    /// 账单 ID。
    /// </summary>
    [JsonConverter(typeof(SnowflakeIdJsonConverter))]
    public long Id { get; init; }

    /// <summary>
    /// 租户 ID。
    /// </summary>
    [JsonConverter(typeof(SnowflakeIdJsonConverter))]
    public long TenantId { get; init; }

    /// <summary>
    /// 租户名称。
    /// </summary>
    public string TenantName { get; init; } = string.Empty;

    /// <summary>
    /// 订阅 ID（可选）。
    /// </summary>
    [JsonConverter(typeof(NullableSnowflakeIdJsonConverter))]
    public long? SubscriptionId { get; init; }

    /// <summary>
    /// 账单编号。
    /// </summary>
    public string StatementNo { get; init; } = string.Empty;

    /// <summary>
    /// 计费周期开始时间（UTC）。
    /// </summary>
    public DateTime PeriodStart { get; init; }

    /// <summary>
    /// 计费周期结束时间（UTC）。
    /// </summary>
    public DateTime PeriodEnd { get; init; }

    /// <summary>
    /// 账单类型。
    /// </summary>
    public BillingType BillingType { get; init; }

    /// <summary>
    /// 账单状态。
    /// </summary>
    public TenantBillingStatus Status { get; init; }

    /// <summary>
    /// 应付金额。
    /// </summary>
    public decimal AmountDue { get; init; }

    /// <summary>
    /// 已支付金额。
    /// </summary>
    public decimal AmountPaid { get; init; }

    /// <summary>
    /// 折扣金额。
    /// </summary>
    public decimal DiscountAmount { get; init; }

    /// <summary>
    /// 税费金额。
    /// </summary>
    public decimal TaxAmount { get; init; }

    /// <summary>
    /// 总金额（应付金额 - 折扣 + 税费）。
    /// </summary>
    public decimal TotalAmount { get; init; }

    /// <summary>
    /// 币种。
    /// </summary>
    public string Currency { get; init; } = "CNY";

    /// <summary>
    /// 到期日。
    /// </summary>
    public DateTime DueDate { get; init; }

    /// <summary>
    /// 创建时间。
    /// </summary>
    public DateTime CreatedAt { get; init; }

    /// <summary>
    /// 更新时间。
    /// </summary>
    public DateTime? UpdatedAt { get; init; }

    /// <summary>
    /// 是否逾期。
    /// </summary>
    public bool IsOverdue { get; init; }

    /// <summary>
    /// 逾期天数（未逾期为 0）。
    /// </summary>
    public int OverdueDays { get; init; }
}