docs: Magic Wallet + VAT 10% documentation update

- All 14 totalDoc files updated with Magic Wallet additions
- MAGIC-WALLET-PLAN.md: Phase 1-6 checklist fully marked complete
- Business docs: Magic Wallet section, commission filter, new entities
- Payment docs: VAT 9%→10%, TransactionType 14+15, ZarinPal 4th usage
- Technical docs: UserWallet fields, ClubMembershipCycle, gRPC RPCs
- Overview docs: Magic flowchart, ER diagram, changelog, glossary, roadmap

business/BUSINESS-02-PAYMENT-FINANCE.md

@@ -1,7 +1,7 @@
 # 💰 سیستم مالی، پرداخت و درگاه‌ها
 
 > **منابع ادغام‌شده:** `payment-gateway.md`, `payment-architecture-pyms.md`, `daya-loan-integration.md`, `manual-payment-system.md`, `discount-shop-business.md`  
-> **آخرین بروزرسانی:** اسفند ۱۴۰۴
+> **آخرین بروزرسانی:** اسفند ۱۴۰۴ (بروزرسانی: Magic Wallet + VAT 10%)
 
 ---
 
@@ -34,10 +34,11 @@ flowchart TD
 
 ## ۲. درگاه ZarinPal (IPG)
 
-> **⚠️ محل استفاده:** ZarinPal فقط در سه جا استفاده می‌شود:
+> **⚠️ محل استفاده:** ZarinPal فقط در چهار جا استفاده می‌شود:
 > 1. **فروشگاه تخفیفی** — باقیمانده بعد از کسر DiscountBalance (اگر > 0)
 > 2. **شارژ کیف‌پول** — واریز مستقیم از پروفایل کاربر
 > 3. **خرید پکیج** — (فعلاً غیرفعال: "درگاه پرداخت متصل نیست")
+> 4. **شارژ کیف‌پول جادویی** — واریز با ضریب ×2.5 (فقط در حالت Magic)
 >
 > ❌ **فروشگاه عادی (Regular Store) از ZarinPal استفاده نمی‌کند** — فقط کسر از Balance کیف‌پول
 
@@ -148,7 +149,7 @@ flowchart TD
     C --> D["سهم تخفیف = MIN(قیمت×MaxDiscount%, DiscountBalance)"]
     D --> E["باقیمانده = مجموع - سهم تخفیف"]
     E --> F{"باقیمانده > 0?"}
-    F -->|بله| G["کسر DiscountBalance\n+ Redirect → ZarinPal IPG\nباقیمانده + 9% VAT"]
+    F -->|بله| G["کسر DiscountBalance\n+ Redirect → ZarinPal IPG\nباقیمانده + 10% VAT"]
     F -->|خیر| H["فقط کسر از DiscountBalance\nبدون درگاه → ثبت مستقیم"]
 ```
 
@@ -187,20 +188,21 @@ service PaymentService {
 | WalletCharge | 5 | شارژ مستقیم کیف‌پول |
 | ActivationFee | 6 | هزینه فعالسازی |
 | DayaLoanCharge | 7 | شارژ از وام دایا |
+| MagicWalletDeposit | 14 | واریز به کیف‌پول جادویی |
+| MagicWalletBonus | 15 | بونوس ضریب ×2.5 کیف‌پول جادویی |
 
 ---
 
 ## ۷. مالیات و VAT
 
 ```
-هر دو فروشگاه از نرخ 9% استفاده می‌کنند:
+هر دو فروشگاه از نرخ 10% استفاده می‌کنند:
 
-  Regular Store  → const vatRate = 0.09m  (hardcoded در SubmitShopBuyOrderCommandHandler)
-  Discount Store → VatCalculator.VAT_RATE = 0.09m
+  Regular Store  → const vatRate = 0.10m  (hardcoded در SubmitShopBuyOrderCommandHandler)
+  Discount Store → VatCalculator.VAT_RATE = 0.10m
+  SystemConstants.ShopVAT = 0.1 (10%)
 
-  ⚠️ SystemConstants.ShopVAT = 0.1 (10%) — تعریف‌شده ولی استفاده نمی‌شود (stale constant)
-
-قیمت نمایشی = قیمت پایه × (1 + 0.09)
+قیمت نمایشی = قیمت پایه × (1 + 0.10)
 در صورتحساب: قیمت پایه + مالیات جداگانه نمایش داده می‌شود
 ```
 
@@ -216,3 +218,4 @@ service PaymentService {
 | Pool هفتگی | ✅ کامل | SP + Hangfire |
 | پرداخت دستی | ⬜ طراحی | نیاز به تصمیم مدیریت |
 | Refund | ⬜ طراحی | فقط در PYMS تعریف‌شده |
+| کیف‌پول جادویی (Magic) | ✅ کامل | فاز 1-5 پیاده‌سازی شده |