TakeoutSaaS.AdminApi/src/Application/TakeoutSaaS.Application/App/Billings/Dto/PaymentDto.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 PaymentDto
{
    /// <summary>
    /// 支付记录 ID（雪花算法，序列化为字符串）。
    /// </summary>
    [JsonConverter(typeof(SnowflakeIdJsonConverter))]
    public long Id { get; init; }

    /// <summary>
    /// 账单 ID（雪花算法，序列化为字符串）。
    /// </summary>
    [JsonConverter(typeof(SnowflakeIdJsonConverter))]
    public long BillingStatementId { get; init; }

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

    /// <summary>
    /// 支付方式。
    /// </summary>
    public TenantPaymentMethod Method { get; init; }

    /// <summary>
    /// 支付状态。
    /// </summary>
    public TenantPaymentStatus Status { get; init; }

    /// <summary>
    /// 交易号。
    /// </summary>
    public string? TransactionNo { get; init; }

    /// <summary>
    /// 支付凭证 URL。
    /// </summary>
    public string? ProofUrl { get; init; }

    /// <summary>
    /// 支付时间。
    /// </summary>
    public DateTime? PaidAt { get; init; }

    /// <summary>
    /// 备注信息。
    /// </summary>
    public string? Notes { get; init; }

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