feat: Implement Magic Wallet functionality

- Added ClubMembershipCycle entity and DbSet to IApplicationDbContext.
- Updated VAT rate from 9% to 10% in VatCalculator and related areas.
- Introduced Magic Wallet settings in SystemConstants.
- Enhanced UserWallet entity to support Magic Wallet features.
- Updated TransactionType enum to include Magic Wallet transactions.
- Configured UserWallet to handle Magic Wallet properties in ApplicationDbContext.
- Implemented OrmCommissionCalculationStrategy to exclude Magic Wallet users from commission calculations.
- Added Protobuf definitions for Magic Wallet methods and responses.
- Created PaymentCallbackController endpoint for handling Magic Wallet charge callbacks.
- Updated UserOrderService to manage Magic Wallet state transitions.
- Developed UserWalletService to support Magic Wallet operations.
- Created ChargeMagicWalletCommand and its handler for initiating Magic Wallet charges.
- Implemented VerifyMagicWalletChargeCommand and handler for payment verification.
- Added validation for ChargeMagicWalletCommand.
- Established ClubMembershipCycle configuration for EF Core.
- Introduced WalletMode enum to differentiate between Normal and Magic modes.

src/CMSMicroservice.Domain/Common/SystemConstants.cs

@@ -92,6 +92,25 @@ public static class SystemConstants
     
     #endregion
 
+    #region Magic Wallet Settings
+
+    /// <summary>
+    /// ضریب شارژ کیف‌پول جادویی — واریز × 2.5 = اعتبار
+    /// </summary>
+    public const decimal MagicWalletMultiplier = 2.5m;
+
+    /// <summary>
+    /// سقف واریز در هر دور جادویی (ریال) — 100M تومان
+    /// </summary>
+    public const long MagicWalletMaxDeposit = 1_000_000_000;
+
+    /// <summary>
+    /// سقف اعتبار در هر دور جادویی (ریال) — 250M تومان
+    /// </summary>
+    public const long MagicWalletMaxCredit = 2_500_000_000;
+
+    #endregion
+
     #region Shop Settings
     
     /// <summary>
@@ -134,6 +153,11 @@ public static class SystemConstants
             ["System.MaintenanceMode"] = SystemMaintenanceMode,
             ["System.EnableAuditLog"] = SystemEnableAuditLog,
             
+            // Magic Wallet
+            ["MagicWallet.Multiplier"] = MagicWalletMultiplier,
+            ["MagicWallet.MaxDeposit"] = MagicWalletMaxDeposit,
+            ["MagicWallet.MaxCredit"] = MagicWalletMaxCredit,
+            
             // Shop
             ["Shop.VAT"] = ShopVAT,
             ["Shop.VATEnabled"] = ShopVATEnabled
@@ -166,6 +190,11 @@ public static class SystemConstants
             ("System.MaintenanceMode", SystemMaintenanceMode, "حالت تعمیر و نگهداری سیستم"),
             ("System.EnableAuditLog", SystemEnableAuditLog, "فعال‌سازی لاگ تغییرات"),
             
+            // Magic Wallet
+            ("MagicWallet.Multiplier", MagicWalletMultiplier, "ضریب شارژ کیف‌پول جادویی (×2.5)"),
+            ("MagicWallet.MaxDeposit", MagicWalletMaxDeposit, "سقف واریز هر دور جادویی (ریال)"),
+            ("MagicWallet.MaxCredit", MagicWalletMaxCredit, "سقف اعتبار هر دور جادویی (ریال)"),
+            
             // Shop
             ("Shop.VAT", ShopVAT, "مالیات بر ارزش افزوده"),
             ("Shop.VATEnabled", ShopVATEnabled, "مالیات فعال است؟")

src/CMSMicroservice.Domain/Entities/Club/ClubMembership.cs

@@ -55,4 +55,9 @@ public class ClubMembership : BaseAuditableEntity
     /// ClubMembershipHistory Collection Navigation Reference
     /// </summary>
     public virtual ICollection<ClubMembershipHistory>? ClubMembershipHistories { get; set; }
+
+    /// <summary>
+    /// دوره‌های خرید پکیج — هر خرید پکیج یک Cycle جدید
+    /// </summary>
+    public virtual ICollection<ClubMembershipCycle>? Cycles { get; set; }
 }

src/CMSMicroservice.Domain/Entities/Club/ClubMembershipCycle.cs

@@ -0,0 +1,64 @@
+namespace CMSMicroservice.Domain.Entities.Club;
+
+/// <summary>
+/// دوره خرید پکیج — هر بار خرید پکیج ۵۶M یک Cycle جدید ایجاد می‌شود.
+/// برای حل مشکل overwrite شدن ClubMembership.ActivatedAt در محاسبه کمیسیون.
+/// </summary>
+public class ClubMembershipCycle : BaseAuditableEntity
+{
+    /// <summary>
+    /// شناسه کاربر
+    /// </summary>
+    public long UserId { get; set; }
+
+    /// <summary>
+    /// User Navigation Property
+    /// </summary>
+    public virtual User User { get; set; }
+
+    /// <summary>
+    /// شناسه عضویت باشگاه
+    /// </summary>
+    public long ClubMembershipId { get; set; }
+
+    /// <summary>
+    /// ClubMembership Navigation Property
+    /// </summary>
+    public virtual ClubMembership ClubMembership { get; set; }
+
+    /// <summary>
+    /// شماره دور (1, 2, 3, ...)
+    /// </summary>
+    public int CycleNumber { get; set; }
+
+    /// <summary>
+    /// تاریخ خرید پکیج — این فیلد برای محاسبه کمیسیون هفتگی استفاده می‌شود
+    /// (به‌جای ClubMembership.ActivatedAt که overwrite می‌شد)
+    /// </summary>
+    public DateTime PackagePurchasedAt { get; set; }
+
+    /// <summary>
+    /// تاریخ شروع حالت جادویی (وقتی Balance=0 شد)
+    /// </summary>
+    public DateTime? MagicStartedAt { get; set; }
+
+    /// <summary>
+    /// تاریخ پایان حالت جادویی
+    /// </summary>
+    public DateTime? MagicCompletedAt { get; set; }
+
+    /// <summary>
+    /// نحوه خرید پکیج در این دور
+    /// </summary>
+    public PackagePurchaseMethod PurchaseMethod { get; set; }
+
+    /// <summary>
+    /// مبلغ پکیج (ریال)
+    /// </summary>
+    public long PackageAmount { get; set; }
+
+    /// <summary>
+    /// آیا این دور فعلی است؟ فقط یک رکورد true می‌باشد
+    /// </summary>
+    public bool IsCurrentCycle { get; set; }
+}

src/CMSMicroservice.Domain/Entities/UserWallet.cs

@@ -18,7 +18,36 @@ public class UserWallet : BaseAuditableEntity
     /// موجودی تخفیف - فقط برای خرید از فروشگاه باشگاه مشتریان
     /// </summary>
     public long DiscountBalance { get; set; }
-    
+
+    #region Magic Wallet
+
+    /// <summary>
+    /// حالت کیف‌پول — Normal: کمیسیون فعال | Magic: شارژ ×2.5 بدون کمیسیون
+    /// </summary>
+    public WalletMode WalletMode { get; set; } = WalletMode.Normal;
+
+    /// <summary>
+    /// مجموع واریزی واقعی در دور جادویی فعلی (ریال) — سقف: MagicWalletMaxDeposit
+    /// </summary>
+    public long MagicTotalDeposited { get; set; }
+
+    /// <summary>
+    /// مجموع اعتبار داده‌شده در دور جادویی فعلی (ریال) — واریز × 2.5
+    /// </summary>
+    public long MagicTotalCredited { get; set; }
+
+    /// <summary>
+    /// زمان شروع دور جادویی فعلی
+    /// </summary>
+    public DateTime? MagicActivatedAt { get; set; }
+
+    /// <summary>
+    /// زمان پایان دور جادویی فعلی
+    /// </summary>
+    public DateTime? MagicCompletedAt { get; set; }
+
+    #endregion
+
     //UserWalletChangeLog Collection Navigation Reference
     public virtual ICollection<UserWalletChangeLog> UserWalletChangeLogs { get; set; }
 }

src/CMSMicroservice.Domain/Enums/TransactionType.cs

@@ -26,4 +26,14 @@ public enum TransactionType
     /// خرید از فروشگاه تخفیف
     /// </summary>
     DiscountShopPurchase = 13,
+
+    /// <summary>
+    /// واریز از درگاه به کیف‌پول جادویی (مبلغ واقعی)
+    /// </summary>
+    MagicWalletDeposit = 14,
+
+    /// <summary>
+    /// بونوس داخلی کیف‌پول جادویی (مبلغ × 1.5)
+    /// </summary>
+    MagicWalletBonus = 15,
 }

src/CMSMicroservice.Domain/Enums/WalletMode.cs

@@ -0,0 +1,13 @@
+namespace CMSMicroservice.Domain.Enums;
+
+/// <summary>
+/// حالت کیف‌پول — Normal: کمیسیون فعال | Magic: شارژ ×2.5 بدون کمیسیون
+/// </summary>
+public enum WalletMode
+{
+    /// <summary>حالت عادی — کمیسیون و پورسانت فعال</summary>
+    Normal = 0,
+
+    /// <summary>حالت جادویی — شارژ ×2.5، بدون کمیسیون</summary>
+    Magic = 1
+}