namespace TakeoutSaaS.Application.App.Coupons.PunchCard.Dto;

/// <summary>
/// 次卡使用记录项。
/// </summary>
public sealed class PunchCardUsageRecordDto
{
    /// <summary>
    /// 使用记录 ID。
    /// </summary>
    public long Id { get; init; }

    /// <summary>
    /// 使用单号。
    /// </summary>
    public string RecordNo { get; init; } = string.Empty;

    /// <summary>
    /// 次卡模板 ID。
    /// </summary>
    public long PunchCardTemplateId { get; init; }

    /// <summary>
    /// 次卡名称。
    /// </summary>
    public string PunchCardName { get; init; } = string.Empty;

    /// <summary>
    /// 次卡实例 ID。
    /// </summary>
    public long PunchCardInstanceId { get; init; }

    /// <summary>
    /// 会员名称。
    /// </summary>
    public string MemberName { get; init; } = string.Empty;

    /// <summary>
    /// 会员手机号（脱敏）。
    /// </summary>
    public string MemberPhoneMasked { get; init; } = string.Empty;

    /// <summary>
    /// 兑换商品名称。
    /// </summary>
    public string ProductName { get; init; } = string.Empty;

    /// <summary>
    /// 使用时间。
    /// </summary>
    public DateTime UsedAt { get; init; }

    /// <summary>
    /// 本次使用次数。
    /// </summary>
    public int UsedTimes { get; init; }

    /// <summary>
    /// 使用后剩余次数。
    /// </summary>
    public int RemainingTimesAfterUse { get; init; }

    /// <summary>
    /// 总次数。
    /// </summary>
    public int TotalTimes { get; init; }

    /// <summary>
    /// 状态（normal/almost_used_up/used_up/expired）。
    /// </summary>
    public string DisplayStatus { get; init; } = "normal";

    /// <summary>
    /// 超额补差金额。
    /// </summary>
    public decimal? ExtraPayAmount { get; init; }
}
