feat: implement marketing punch card backend module

src/Domain/TakeoutSaaS.Domain/Coupons/Entities/PunchCardUsageRecord.cs

@@ -0,0 +1,60 @@
+using TakeoutSaaS.Domain.Coupons.Enums;
+using TakeoutSaaS.Shared.Abstractions.Entities;
+
+namespace TakeoutSaaS.Domain.Coupons.Entities;
+
+/// <summary>
+/// 次卡使用记录。
+/// </summary>
+public sealed class PunchCardUsageRecord : MultiTenantEntityBase
+{
+    /// <summary>
+    /// 门店 ID。
+    /// </summary>
+    public long StoreId { get; set; }
+
+    /// <summary>
+    /// 次卡模板 ID。
+    /// </summary>
+    public long PunchCardTemplateId { get; set; }
+
+    /// <summary>
+    /// 次卡实例 ID。
+    /// </summary>
+    public long PunchCardInstanceId { get; set; }
+
+    /// <summary>
+    /// 使用单号。
+    /// </summary>
+    public string RecordNo { get; set; } = string.Empty;
+
+    /// <summary>
+    /// 兑换商品名称。
+    /// </summary>
+    public string ProductName { get; set; } = string.Empty;
+
+    /// <summary>
+    /// 使用时间（UTC）。
+    /// </summary>
+    public DateTime UsedAt { get; set; }
+
+    /// <summary>
+    /// 本次使用次数。
+    /// </summary>
+    public int UsedTimes { get; set; } = 1;
+
+    /// <summary>
+    /// 使用后剩余次数。
+    /// </summary>
+    public int RemainingTimesAfterUse { get; set; }
+
+    /// <summary>
+    /// 本次记录状态。
+    /// </summary>
+    public PunchCardUsageRecordStatus StatusAfterUse { get; set; } = PunchCardUsageRecordStatus.Normal;
+
+    /// <summary>
+    /// 超额补差金额。
+    /// </summary>
+    public decimal? ExtraPayAmount { get; set; }
+}