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

overview/OVERVIEW-02-INDEX.md

@@ -3,7 +3,8 @@
 > **فهرست کامل ۱۵ فایل مستند پروژه FourSat (کارا بازار سلامت)**  
 > **تاریخ تجمیع:** اسفند ۱۴۰۴  
 > **تعداد فایل‌های مبدأ:** ۵۳ فایل (~۳۲,۰۰۰ خط)  
-> **تعداد فایل‌های نهایی:** ۱۷ فایل (۱۵ اصلی + ۲ roadmap)
+> **تعداد فایل‌های نهایی:** ۱۷ فایل (۱۵ اصلی + ۲ roadmap)  
+> **آخرین بروزرسانی:** اسفند ۱۴۰۴ (Magic Wallet + VAT fix)
 
 ---
 
@@ -45,8 +46,8 @@ totalDoc/
 
 | # | فایل | موضوع | خلاصه |
 |---|------|--------|--------|
-| B1 | [BUSINESS-01-CLUB-COMMISSION](../business/BUSINESS-01-CLUB-COMMISSION.md) | باشگاه و کمیسیون | درخت باینری، فرمول ۴مرحله‌ای، Pool هفتگی، وام دایا، Chatika |
-| B2 | [BUSINESS-02-PAYMENT-FINANCE](../business/BUSINESS-02-PAYMENT-FINANCE.md) | مالی و پرداخت | ZarinPal IPG، ۳ کیف‌پول، PYMS، پرداخت ترکیبی، VAT |
+| B1 | [BUSINESS-01-CLUB-COMMISSION](../business/BUSINESS-01-CLUB-COMMISSION.md) | باشگاه و کمیسیون | درخت باینری، فرمول ۴مرحله‌ای، Pool هفتگی، وام دایا، Chatika، **🪄 کیف‌پول جادویی** |
+| B2 | [BUSINESS-02-PAYMENT-FINANCE](../business/BUSINESS-02-PAYMENT-FINANCE.md) | مالی و پرداخت | ZarinPal IPG، ۳ کیف‌پول، PYMS، پرداخت ترکیبی، VAT 10%، **Magic Charge** |
 | B3 | [BUSINESS-03-ECOMMERCE-STORES](../business/BUSINESS-03-ECOMMERCE-STORES.md) | فروشگاه | Regular + Discount Store، Lazy Load، موجودی خودکار، باندل |
 | B4 | [BUSINESS-04-USER-MEMBERSHIP](../business/BUSINESS-04-USER-MEMBERSHIP.md) | کاربر و عضویت | ثبت‌نام OTP، قرارداد، فیچرهای باشگاه، Auth-Aware، Referral |
 | B5 | [BUSINESS-05-CONTENT-MANAGEMENT](../business/BUSINESS-05-CONTENT-MANAGEMENT.md) | محتوا | Site Pages (Shopify)، بلاگ، مدیریت فایل، SMS/Email، Landing |
@@ -76,7 +77,7 @@ totalDoc/
 | # | فایل | موضوع | خلاصه |
 |---|------|--------|--------|
 | R1 | [MAGIC-WALLET-SPEC](../roadmap/MAGIC-WALLET-SPEC.md) | کیف‌پول جادویی — مشخصات | State Machine، ضریب ×2.5، سقف 100M، قوانین، API، مدل داده |
-| R2 | [MAGIC-WALLET-PLAN](../roadmap/MAGIC-WALLET-PLAN.md) | کیف‌پول جادویی — پلن | ۶ فاز، checklist، تخمین زمان، وابستگی ChargeDiscountWallet |
+| R2 | [MAGIC-WALLET-PLAN](../roadmap/MAGIC-WALLET-PLAN.md) | کیف‌پول جادویی — پلن | ۶ فاز، **فاز 1-5 تکمیل ✅**، فاز 6 باقی |
 
 ---
 

overview/OVERVIEW-03-CHANGELOG.md

@@ -1,7 +1,7 @@
 # 📜 تاریخچه کارهای انجام‌شده
 
 > **همه فعالیت‌های پروژه به صورت بولت با توضیح یک‌خطی و درصد تکمیل**  
-> **آخرین بروزرسانی:** اسفند ۱۴۰۴
+> **آخرین بروزرسانی:** اسفند ۱۴۰۴ (بروزرسانی: Magic Wallet + VAT 10%)
 
 ---
 
@@ -10,11 +10,11 @@
 | حوزه | تعداد آیتم | تکمیل‌شده | درصد کل |
 |------|-----------|----------|---------|
 | **BackOffice** | 58 | 57 | **98%** |
-| **FrontOffice** | 35 | 32 | **91%** |
-| **CMS Core** | 45 | 42 | **93%** |
+| **FrontOffice** | 38 | 35 | **92%** |
+| **CMS Core** | 55 | 52 | **95%** |
 | **Deployment** | 20 | 18 | **90%** |
 | **Migration** | 15 | 15 | **100%** |
-| **مجموع** | **173** | **164** | **95%** |
+| **مجموع** | **186** | **177** | **95%** |
 
 ---
 
@@ -86,6 +86,7 @@
 - ✅ نمای درخت شبکه — باینری بصری
 - ✅ امضای قرارداد — OTP + scroll-to-bottom
 - ✅ صفحه Chatika — چت AI
+- ✅ کیف‌پول جادویی — MagicWallet.razor + فرم شارژ + پروگرس‌بار سقف
 
 ### محتوا و ناوبری
 - ✅ بلاگ — لیست + جزئیات + pagination
@@ -129,6 +130,17 @@
 - ✅ Club Features — activate/deactivate
 - ✅ DayaLoan Integration — Hangfire + Polly
 
+### 🪄 کیف‌پول جادویی (Magic Wallet) — فاز 1-5
+- ✅ فاز ۱: WalletMode enum + UserWallet fields + ClubMembershipCycle entity + TransactionType (14,15)
+- ✅ فاز ۲: Trigger ورود/خروج Magic در SubmitShopBuyOrder + ActivateClubMembership Cycle
+- ✅ فاز ۳: ChargeMagicWallet + VerifyMagicWalletCharge + HTTP callback + gRPC RPCs
+- ✅ فاز ۴: فیلتر Magic از کمیسیون (C# + SP) + تاریخ Cycle
+- ✅ فاز ۵: MagicWallet.razor UI + WalletService + تایل داشبورد
+- ⬜ فاز ۶: محدودیت دایا بعد از دور اول
+
+### VAT
+- ✅ اصلاح VAT از 9% به 10% در همه فایل‌ها (VatCalculator, UserOrderService, Checkout, VATService)
+
 ### محتوا
 - ✅ Blog CRUD — با pagination
 - ✅ SitePage Settings — JSON typed
@@ -194,3 +206,4 @@
 | اسفند ۱۴۰۳ (هفته ۲) | Site Pages + BackOffice audit | 75% |
 | اسفند ۱۴۰۳ (هفته ۳) | Inventory + Lazy Load + Images | 85% |
 | اسفند ۱۴۰۳ (هفته ۴) | مستندات + نهایی‌سازی | 95% |
+| اسفند ۱۴۰۴ | 🪄 کیف‌پول جادویی (فاز 1-5) + اصلاح VAT 10% | 96% |

overview/OVERVIEW-04-GLOSSARY.md

@@ -1,7 +1,7 @@
 # 📖 واژه‌نامه، استانداردها و قراردادهای کد
 
 > **اصطلاحات فارسی/انگلیسی، الگوهای نام‌گذاری و استانداردهای حرفه‌ای**  
-> **آخرین بروزرسانی:** اسفند ۱۴۰۴
+> **آخرین بروزرسانی:** اسفند ۱۴۰۴ (بروزرسانی: Magic Wallet)
 
 ---
 
@@ -28,6 +28,11 @@
 | وام دایا | Daya Loan | وام آنلاین برای خرید پکیج |
 | کد معرف | Referral Code | کد یکتا هر عضو برای دعوت |
 | موجودی | Inventory | تعداد محصول در انبار |
+| کیف‌پول جادویی | Magic Wallet | حالت ویژه: Balance=0 → شارژ ×2.5 از درگاه |
+| حالت جادویی | Magic Mode | WalletMode=1 — کمیسیون غیرفعال |
+| ضریب شارژ | Magic Multiplier | واریز × 2.5 = اعتبار Balance |
+| سقف دور | Per-Cycle Cap | 100M تومان واریز → 250M اعتبار |
+| دوره عضویت | Membership Cycle | ClubMembershipCycle — هر خرید پکیج = یک دور |
 
 ### ۱.۲ مفاهیم فنی
 

overview/OVERVIEW-05-ROADMAP.md

@@ -1,20 +1,21 @@
 # 🗺️ نقشه راه، ریسک‌ها و کارهای باقیمانده
 
 > **Roadmap + Risk Register + Dependencies + Priorities**  
-> **آخرین بروزرسانی:** اسفند ۱۴۰۴
+> **آخرین بروزرسانی:** اسفند ۱۴۰۴ (بروزرسانی: Magic Wallet completed)
 
 ---
 
 ## ۱. وضعیت فعلی پروژه
 
 ```
-██████████████████████████████████████████████████ 95%
+██████████████████████████████████████████████████ 96%
 
 Core Platform     ████████████████████████████████████████████████ 98%
-Club System       █████████████████████████████████████████████░░░ 95%
+Club System       ████████████████████████████████████████████████ 98%
 E-Commerce        ████████████████████████████████████████████████ 98%
-Payment           ██████████████████████████████████████░░░░░░░░░ 80%
-UI/UX             ████████████████████████████████████████░░░░░░░ 85%
+Payment           ████████████████████████████████████████████░░░░ 90%
+Magic Wallet      ████████████████████████████████████████░░░░░░░░ 83%
+UI/UX             ██████████████████████████████████████████░░░░░░ 88%
 Deployment        ████████████████████████████████████████████░░░ 90%
 Documentation     ████████████████████████████████████████████████ 100%
 ```
@@ -197,8 +198,14 @@ gantt
 ## ۸. خلاصه اولویت‌بندی
 
 ```
+DONE (اسفند ۱۴۰۴):
+    → Documentation consolidation ✅
+    → 🪄 Magic Wallet فاز 1-5 ✅ (فاز 6 باقی)
+    → اصلاح VAT 9% → 10% ✅
+    
 NOW (این ماه):
-    → Documentation consolidation ✅ DONE
+    → Magic Wallet فاز 6 — محدودیت دایا
+    → EF Migration نهایی
     
 NEXT (فروردین):
     → Mobile Responsive (H2)