147 lines
3.5 KiB
C#
147 lines
3.5 KiB
C#
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 BillingDetailDto
|
||
{
|
||
/// <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>
|
||
/// 账单编号。
|
||
/// </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>
|
||
/// 订阅 ID（可选）。
|
||
/// </summary>
|
||
[JsonConverter(typeof(NullableSnowflakeIdJsonConverter))]
|
||
public long? SubscriptionId { get; init; }
|
||
|
||
/// <summary>
|
||
/// 账单明细 JSON（原始字符串）。
|
||
/// </summary>
|
||
public string? LineItemsJson { get; init; }
|
||
|
||
/// <summary>
|
||
/// 账单明细行项目。
|
||
/// </summary>
|
||
public IReadOnlyList<BillingLineItemDto> LineItems { get; init; } = [];
|
||
|
||
/// <summary>
|
||
/// 支付记录。
|
||
/// </summary>
|
||
public IReadOnlyList<PaymentRecordDto> Payments { get; init; } = [];
|
||
|
||
/// <summary>
|
||
/// 提醒发送时间。
|
||
/// </summary>
|
||
public DateTime? ReminderSentAt { get; init; }
|
||
|
||
/// <summary>
|
||
/// 逾期通知时间。
|
||
/// </summary>
|
||
public DateTime? OverdueNotifiedAt { get; init; }
|
||
|
||
/// <summary>
|
||
/// 备注。
|
||
/// </summary>
|
||
public string? Notes { get; init; }
|
||
|
||
/// <summary>
|
||
/// 创建时间。
|
||
/// </summary>
|
||
public DateTime CreatedAt { get; init; }
|
||
|
||
/// <summary>
|
||
/// 创建人 ID。
|
||
/// </summary>
|
||
[JsonConverter(typeof(NullableSnowflakeIdJsonConverter))]
|
||
public long? CreatedBy { get; init; }
|
||
|
||
/// <summary>
|
||
/// 更新时间。
|
||
/// </summary>
|
||
public DateTime? UpdatedAt { get; init; }
|
||
|
||
/// <summary>
|
||
/// 更新人 ID。
|
||
/// </summary>
|
||
[JsonConverter(typeof(NullableSnowflakeIdJsonConverter))]
|
||
public long? UpdatedBy { get; init; }
|
||
}
|