using System.Text.Json.Serialization;
using TakeoutSaaS.Domain.Tenants.Enums;
using TakeoutSaaS.Shared.Abstractions.Serialization;
namespace TakeoutSaaS.Application.App.Billings.Dto;
///
/// 账单列表 DTO(管理员端列表展示)。
///
public sealed record BillingListDto
{
///
/// 账单 ID。
///
[JsonConverter(typeof(SnowflakeIdJsonConverter))]
public long Id { get; init; }
///
/// 租户 ID。
///
[JsonConverter(typeof(SnowflakeIdJsonConverter))]
public long TenantId { get; init; }
///
/// 租户名称。
///
public string TenantName { get; init; } = string.Empty;
///
/// 订阅 ID(可选)。
///
[JsonConverter(typeof(NullableSnowflakeIdJsonConverter))]
public long? SubscriptionId { get; init; }
///
/// 账单编号。
///
public string StatementNo { get; init; } = string.Empty;
///
/// 计费周期开始时间(UTC)。
///
public DateTime PeriodStart { get; init; }
///
/// 计费周期结束时间(UTC)。
///
public DateTime PeriodEnd { get; init; }
///
/// 账单类型。
///
public BillingType BillingType { get; init; }
///
/// 账单状态。
///
public TenantBillingStatus Status { get; init; }
///
/// 应付金额。
///
public decimal AmountDue { get; init; }
///
/// 已支付金额。
///
public decimal AmountPaid { get; init; }
///
/// 折扣金额。
///
public decimal DiscountAmount { get; init; }
///
/// 税费金额。
///
public decimal TaxAmount { get; init; }
///
/// 总金额(应付金额 - 折扣 + 税费)。
///
public decimal TotalAmount { get; init; }
///
/// 币种。
///
public string Currency { get; init; } = "CNY";
///
/// 到期日。
///
public DateTime DueDate { get; init; }
///
/// 创建时间。
///
public DateTime CreatedAt { get; init; }
///
/// 更新时间。
///
public DateTime? UpdatedAt { get; init; }
///
/// 是否逾期。
///
public bool IsOverdue { get; init; }
///
/// 逾期天数(未逾期为 0)。
///
public int OverdueDays { get; init; }
}