using MediatR;
using TakeoutSaaS.Application.App.Coupons.PunchCard.Dto;

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

/// <summary>
/// 写入次卡使用记录命令。
/// </summary>
public sealed class WritePunchCardUsageRecordCommand : IRequest<PunchCardUsageRecordDto>
{
    /// <summary>
    /// 操作门店 ID。
    /// </summary>
    public long StoreId { get; init; }

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

    /// <summary>
    /// 次卡实例 ID（可空）。
    /// </summary>
    public long? InstanceId { get; init; }

    /// <summary>
    /// 次卡实例编号（可空）。
    /// </summary>
    public string? InstanceNo { get; init; }

    /// <summary>
    /// 会员名称（当未指定实例时用于创建实例）。
    /// </summary>
    public string? MemberName { get; init; }

    /// <summary>
    /// 会员手机号（脱敏，当未指定实例时用于创建实例）。
    /// </summary>
    public string? MemberPhoneMasked { get; init; }

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

    /// <summary>
    /// 使用时间（可空，空则取当前 UTC）。
    /// </summary>
    public DateTime? UsedAt { get; init; }

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

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