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

overview/OVERVIEW-01-FLOWCHARTS.md

@@ -1,7 +1,7 @@
 # 📊 فلوچارت‌ها و دیاگرام‌های کلان
 
-> **دید بالا (Big Picture): فلوی کاربر، مالی و داده**  
-> **آخرین بروزرسانی:** اسفند ۱۴۰۴
+> **دید بالا (Big Picture): فلوی کاربر، مالی، داده و کیف‌پول جادویی**  
+> **آخرین بروزرسانی:** اسفند ۱۴۰۴ (بروزرسانی: Magic Wallet + VAT 10%)
 
 ---
 
@@ -24,6 +24,24 @@ flowchart TD
     I --> K["درخت شبکه\nباینری"]
     I --> L["کمیسیون\nهفتگی"]
     I --> M["Chatika AI"]
+    I --> N["🪄 کیف‌پول جادویی\nشارژ ×2.5"]
+```
+
+---
+
+## ۱.۱ فلوی کیف‌پول جادویی (Magic Wallet) ✅
+
+```mermaid
+flowchart TD
+    A["خرید پکیج 56M\nBalance=56M"] --> B["خرید از فروشگاه\nBalance کم می‌شود"]
+    B --> C{"Balance = 0 +\nعضو فعال باشگاه?"}
+    C -->|خیر| B
+    C -->|بله| D["🪄 Magic Mode\nWalletMode = 1"]
+    D --> E["شارژ از درگاه\nواریز × 2.5"]
+    E --> F{"Balance=0 AND\nDeposited≥100M?"}
+    F -->|خیر| G["خرید یا شارژ ادامه"]
+    G --> F
+    F -->|بله| H["خروج از Magic\nخرید مجدد پکیج"]
 ```
 
 ---
@@ -144,7 +162,7 @@ flowchart TD
     D2 --> E2["محاسبه سهم تخفیف\nMaxDiscount% هر محصول"]
     E2 --> F2["محاسبه باقیمانده\ngatewayAmount = total - discountUsed"]
     F2 --> G2{"gatewayAmount > 0?"}
-    G2 -->|بله| H2["کسر DiscountBalance\n+ ZarinPal IPG برای باقیمانده + 9% VAT"]
+    G2 -->|بله| H2["کسر DiscountBalance\n+ ZarinPal IPG برای باقیمانده + 10% VAT"]
     H2 --> I2["Redirect → ZarinPal\nCallback → ثبت سفارش"]
     G2 -->|خیر| J2["فقط کسر از DiscountBalance\nبدون درگاه"]
     J2 --> K2["ثبت سفارش"]
@@ -203,12 +221,22 @@ erDiagram
 
     UserWallet ||--o{ UserWalletChangeLog : logs
 
+    ClubMembership ||--o{ ClubMembershipCycle : has
+
     BlogPost }o--|| Category : belongs_to
 
     UserWallet {
         long Balance
         long NetworkBalance
         long DiscountBalance
+        int WalletMode
+        long MagicTotalDeposited
+        long MagicTotalCredited
+    }
+    ClubMembershipCycle {
+        int CycleNumber
+        datetime PackagePurchasedAt
+        bool IsCurrentCycle
     }
     User {
         Guid NetworkParentId