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

technical/TECH-01-CMS-ARCHITECTURE.md

@@ -1,7 +1,7 @@
 # ⚙️ معماری CMS و زیرساخت فنی
 
 > **منابع ادغام‌شده:** `CMS-README.md`, `ICURRENTUSERSERVICE-IMPLEMENTATION.md`, `FILE-MANAGEMENT-ARCHITECTURE.md`, `FRONTOFFICE-CMS-API-COMPATIBILITY.md`, `BFF-REMOVAL-PLAN.md`, `system-constants.md`  
-> **آخرین بروزرسانی:** اسفند ۱۴۰۴
+> **آخرین بروزرسانی:** اسفند ۱۴۰۴ (بروزرسانی: Magic Wallet entities + gRPC)
 
 ---
 
@@ -139,6 +139,7 @@ public class CreateProductCommandHandler
 | `SitePageService` | sitepage.proto | GetPage, SaveSettings |
 | `CategoryService` | category.proto | GetCategories, Create, Update |
 | `SystemConfigService` | config.proto | GetConfig, UpdateConfig |
+| `UserWalletService` | userwallet.proto | GetCustomerWallet, InitiateMagicCharge, GetMagicWalletStatus |
 
 ### ۴.۲ PaginationState (مشترک)
 
@@ -180,7 +181,8 @@ Engine: MSSQL 2022-CU16, Collation=Arabic_CI_AS
 | SitePages | صفحات سایت | ~10 |
 | UserClubMemberships | عضویت باشگاه | ~500 |
 | UserContracts | قراردادها (SignGuid, SignedPdfFile) | ~500 |
-| UserWallets | کیف‌پول (Balance, NetworkBalance, DiscountBalance) | ~5K |
+| UserWallets | کیف‌پول (Balance, NetworkBalance, DiscountBalance, WalletMode) | ~5K |
+| ClubMembershipCycles | دوره‌های عضویت (CycleNumber, PackagePurchasedAt, IsCurrentCycle) | ~500 |
 | Transactions | تراکنش‌ها | ~5K |
 | SystemConfigurations | تنظیمات | ~30 |
 | ChatMessages | پیام‌های چاتیکا | ~1K |

technical/TECH-02-BACKOFFICE-FRONTOFFICE.md

@@ -1,7 +1,7 @@
 # 🖥️ BackOffice و FrontOffice — معماری UI
 
 > **منابع ادغام‌شده:** `BACKOFFICE-ARCHITECTURE.md`, `BACKOFFICE-STORE-UNIFICATION.md`, `UI-MODERNIZATION-PLAN.md`, `UI-UNIFICATION-PLAN.md`, `PHASE-1-COMPLETE.md`, `PHASE-3-COMPLETE.md`, `PRODUCT-IMAGES-SQUARE.md`  
-> **آخرین بروزرسانی:** اسفند ۱۴۰۴
+> **آخرین بروزرسانی:** اسفند ۱۴۰۴ (بروزرسانی: Magic Wallet UI + ProjectReference)
 
 ---
 
@@ -111,6 +111,9 @@ FrontOffice/src/FrontOffice/
 │   │   ├── Dashboard.razor    ← داشبورد باشگاه
 │   │   ├── NetworkTree.razor  ← نمای درخت
 │   │   └── Contract.razor     ← امضای قرارداد
+│   ├── Profile/
+│   │   ├── Index.razor        ← داشبورد پروفایل + تایل Magic
+│   │   └── MagicWallet.razor  ← 🪄 کیف‌پول جادویی (NEW)
 │   ├── Blog/
 │   ├── Auth/
 │   │   ├── Login.razor
@@ -119,6 +122,8 @@ FrontOffice/src/FrontOffice/
 ├── Services/
 │   ├── ProductService.cs      ← با GetProductsPagedAsync
 │   ├── ClubService.cs
+│   ├── WalletService.cs       ← + MagicWalletStatus, InitiateMagicChargeAsync
+│   ├── VATService.cs          ← VAT 10% از سرور + LocalStorage cache
 │   └── ...
 └── Shared/
     ├── AppImage.razor
@@ -247,6 +252,8 @@ if (user.Identity?.IsAuthenticated == true) {
 | Store Unification | ✅ | 100% |
 | SitePage Typed Editors | ✅ | 100% |
 | RTL Support | ✅ | 100% |
+| Magic Wallet UI | ✅ | 100% |
+| Proto ProjectReference | ✅ | 100% |
 | Mobile Responsive (Phase 7) | ⬜ | 0% |
 | Dark Mode | ⬜ | 0% |
 | PWA | ⬜ | 0% |

technical/TECH-05-API-INTEGRATION.md

@@ -1,7 +1,7 @@
 # 🔌 API، Protobuf و یکپارچه‌سازی خارجی
 
 > **منابع ادغام‌شده:** `FRONTOFFICE-CMS-API-COMPATIBILITY.md`, `REMAINING-TASKS.md`, `chatika-integration.md`, `payment-gateway.md`, `club-feature-management-services.md`  
-> **آخرین بروزرسانی:** اسفند ۱۴۰۴
+> **آخرین بروزرسانی:** اسفند ۱۴۰۴ (بروزرسانی: Magic Wallet gRPC RPCs)
 
 ---
 
@@ -125,6 +125,13 @@ service SystemConfigService {
     rpc UpdateConfig (UpdateConfigRequest) returns (Empty);
     rpc GetAllConfigs (Empty) returns (ConfigListResponse);
 }
+
+// ===== userwallet.proto ===== (NEW — Magic Wallet)
+service UserWalletService {
+    rpc GetCustomerWallet (GetCustomerWalletRequest) returns (GetCustomerWalletResponse);
+    rpc InitiateMagicCharge (InitiateMagicChargeRequest) returns (InitiateMagicChargeResponse);
+    rpc GetMagicWalletStatus (GetMagicWalletStatusRequest) returns (MagicWalletStatusResponse);
+}
 ```
 
 ### ۲.۲ Shared Messages
@@ -299,9 +306,12 @@ flowchart TD
     A["CMS/src/Protos/*.proto"] --> B["pack-protos.sh"]
     B --> C["Foursat.CMSMicroservice.Protobuf.nupkg\nv1.0.x"]
     C --> D["Push to BaGet / Nexus"]
-    D --> E["BackOffice + FrontOffice\nPackageReference"]
+    D --> E["BackOffice\nPackageReference"]
+    D --> F["FrontOffice\nProjectReference ✅"]
 ```
 
+> ⚠️ FrontOffice از NuGet package به **ProjectReference** مستقیم سوییچ شده (برای دسترسی به پروتوهای جدید Magic Wallet)
+
 ---
 
 ## ۶. Remaining Tasks / Integration Gaps