feat: Complete overhaul of FourSat documentation structure and content

- Added FINAL-STATUS.md detailing project completion and key metrics
- Created QUICK-REFERENCE.md for quick access to essential documents
- Updated README.md with project overview and quick start guide
- Established STRUCTURE.md outlining the final documentation structure
- Organized and archived old files, ensuring a clean and efficient directory
- Enhanced documentation quality with comprehensive metrics and checklists

04-FRONTEND/FrontOffice/README.md

@@ -0,0 +1,466 @@
+# 🌐 FrontOffice - پرتال مشتری
+
+> **FrontOffice**: رابط کاربری Blazor Server برای مشتریان نهایی سیستم FourSat
+> 
+> **آخرین بروزرسانی**: ۱۴ آذر ۱۴۰۴
+
+---
+
+## 📊 وضعیت پروژه
+
+| بخش | وضعیت | درصد تکمیل | فایل‌ها |
+|-----|-------|------------|---------|
+| **UI Pages** | ✅ Build موفق | 75% | 24 صفحه |
+| **BFF Handlers** | ⚠️ نیاز به اصلاح | 60% | 12 Handler |
+| **Protobuf Packages** | ❌ ناقص | 40% | 3 Package |
+| **Services** | ⚠️ Mock Data | 50% | 8 Service |
+| **gRPC Connection** | ❌ غیرفعال | 0% | - |
+
+**🎉 آخرین موفقیت**: Build موفق با 0 error و 113 warning (۱۴ آذر)
+
+---
+
+## 🗂️ ساختار پروژه
+
+```
+FrontOffice/
+├── FrontOffice.sln
+└── src/
+    ├── FrontOffice.Main/          # Blazor Server UI
+    │   ├── Pages/
+    │   │   ├── Profile/           # صفحات پروفایل (6 صفحه)
+    │   │   │   ├── Index.razor
+    │   │   │   ├── Tree.razor     # ⚠️ نیاز به بروزرسانی
+    │   │   │   ├── Wallet.razor
+    │   │   │   └── ...
+    │   │   ├── Store/             # فروشگاه (7 صفحه)
+    │   │   ├── Club/              # ✅ باشگاه مشتریان (2 صفحه + 1 component)
+    │   │   │   ├── MembershipPage.razor
+    │   │   │   ├── FeaturesPage.razor
+    │   │   │   └── Components/ActivationSection.razor
+    │   │   ├── Network/           # ✅ شبکه (2 صفحه)
+    │   │   │   ├── NetworkStatisticsPage.razor
+    │   │   │   └── (Tree در Profile است)
+    │   │   └── Commission/        # ✅ کمیسیون (3 صفحه)
+    │   │       ├── CommissionDashboardPage.razor
+    │   │       ├── CommissionHistoryPage.razor
+    │   │       └── WeeklyBalancePage.razor
+    │   └── Utilities/             # Services & DTOs
+    │       ├── ClubMembershipService.cs        # ⚠️ Mock Data
+    │       ├── NetworkMembershipService.cs     # ⚠️ Mock Data
+    │       ├── CommissionService.cs            # ⚠️ Mock Data
+    │       └── WalletService.cs                # ⚠️ 4 متد کامنت شده
+    └── FrontOffice.BFF/           # Backend for Frontend
+        ├── FrontOffice.BFF.sln
+        └── src/
+            ├── FrontOffice.BFF.Application/
+            │   ├── ClubMembershipCQ/           # ⚠️ نیاز به اصلاح
+            │   │   ├── Queries/GetMyClubMembership/
+            │   │   └── Commands/ActivateMyClubMembership/
+            │   ├── NetworkMembershipCQ/        # ⚠️ نیاز به اصلاح
+            │   │   ├── Queries/GetMyNetworkTree/
+            │   │   └── Queries/GetMyNetworkStatistics/
+            │   ├── CommissionCQ/               # ⚠️ نیاز به اصلاح
+            │   │   ├── Queries/GetMyCommissionPayouts/
+            │   │   └── Queries/GetMyWeeklyBalances/
+            │   └── UserWalletCQ/               # ⚠️ ناقص
+            │       └── Queries/GetUserWallet/
+            └── Protobufs/
+                ├── FrontOffice.BFF.Package.Protobuf/
+                ├── FrontOffice.BFF.UserWallet.Protobuf/
+                └── (سایر Protobuf ها...)
+```
+
+---
+
+## 🚀 صفحات موجود (24 صفحه)
+
+### 🏪 Store (7 صفحه - از قبل موجود)
+- ✅ ProductListPage
+- ✅ ProductDetailPage
+- ✅ CartPage
+- ✅ CheckoutPage
+- ✅ OrderHistoryPage
+- ✅ OrderDetailPage
+- ✅ (و سایر صفحات فروشگاه)
+
+### 👤 Profile (6 صفحه)
+- ✅ Index.razor - داشبورد پروفایل
+- ⚠️ Tree.razor - درخت شبکه (نیاز به اتصال واقعی)
+- ✅ Wallet.razor - کیف پول (با Mock DiscountBalance)
+- ✅ EditProfile.razor
+- ✅ ChangePassword.razor
+- ✅ Addresses.razor
+
+### 🎖️ Club (3 صفحه) - **جدید** ✨
+- ✅ **MembershipPage.razor**: نمایش وضعیت عضویت باشگاه
+  - Badge وضعیت (Active/Inactive/Trial)
+  - شمارش روزهای باقی‌مانده
+  - کارت‌های مزایا (تخفیف، امتیاز، ارسال رایگان)
+  - بخش فعال‌سازی (ActivationSection) برای اعضای غیرفعال
+  
+- ✅ **FeaturesPage.razor**: معرفی مزایا و ویژگی‌ها
+  - 6 کارت ویژگی (تخفیف، امتیاز، ارسال، پشتیبانی، درآمد، رویدادها)
+  - MudStepper نمایش فرآیند ثبت‌نام
+  - دکمه CTA برای عضویت
+  
+- ✅ **Components/ActivationSection.razor**: فرم فعال‌سازی عضویت
+  - ورودی PackageId, DurationMonths, ActivationCode
+  - محاسبه خودکار هزینه (56M × ماه)
+  - ولیدیشن فرم و رویداد OnActivationSuccess
+
+### 🌳 Network (2 صفحه)
+- ⚠️ **Tree.razor** (در Profile): نمایش درخت دودویی
+  - از OrganizationChart component استفاده می‌کند
+  - **TODO**: باید به NetworkMembershipService.GetMyNetworkTree متصل شود
+  
+- ✅ **NetworkStatisticsPage.razor**: آمار شبکه **جدید** ✨
+  - 4 کارت آماری (کل، چپ، راست، عمق)
+  - Progress bar برای تعادل پاها
+  - MudChart.Donut برای توزیع
+  - کارت آخرین عضو (آواتار، موقعیت، تاریخ)
+
+### 💰 Commission (3 صفحه) - **جدید** ✨
+- ✅ **CommissionDashboardPage.razor**: داشبورد پرداخت‌ها
+  - فیلترهای هفته و وضعیت
+  - جدول + نمای موبایل (MudHidden responsive)
+  - Pagination با MudPagination
+  - لینک به صفحات تاریخچه و تعادل هفتگی
+  
+- ✅ **CommissionHistoryPage.razor**: تاریخچه کامل پرداخت‌ها
+  - کارت‌های خلاصه (مجموع، تعداد هفته، میانگین)
+  - جدول کامل با FixedHeader
+  - لینک به جزئیات تعادل هر هفته
+  
+- ✅ **WeeklyBalancePage.razor**: جزئیات تعادل هفتگی
+  - انتخابگر هفته با دکمه "هفته جاری"
+  - کارت‌های تعادل چپ/راست با Progress bar
+  - پنل محاسبات (Min balance, Count, Commission)
+  - هشدار Carryover (اگر باشد)
+  - MudChart.Bar مقایسه چپ/راست/Min
+  - پشتیبانی Query parameter (?week=45)
+
+---
+
+## 🛠️ Services (8 سرویس)
+
+### ✅ Services موجود (از قبل)
+1. **AuthService**: احراز هویت JWT
+2. **ProductService**: فراخوانی BFF Products
+3. **CartService**: مدیریت سبد خرید
+4. **OrderService**: ثبت و پیگیری سفارشات
+5. **AddressService**: مدیریت آدرس‌ها
+
+### ✨ Services جدید (Mock Data)
+6. **ClubMembershipService**: مدیریت عضویت باشگاه
+   - `GetMyMembershipAsync()`: بازگشت وضعیت عضویت
+   - `ActivateMembershipAsync(...)`: فعال‌سازی عضویت
+   - **⚠️ فعلا Mock**: بازمی‌گرداند `{ IsActive = false }`
+   
+7. **NetworkMembershipService**: مدیریت شبکه
+   - `GetMyNetworkTreeAsync(maxDepth)`: درخت شبکه تا عمق 10
+   - `GetMyNetworkStatisticsAsync()`: آمار کلی شبکه
+   - **⚠️ فعلا Mock**: 5 نود نمونه، 15 چپ + 12 راست = 27 عضو
+   
+8. **CommissionService**: مدیریت کمیسیون
+   - `GetMyCommissionPayoutsAsync(...)`: لیست پرداخت‌ها با فیلتر و صفحه‌بندی
+   - `GetMyWeeklyBalanceAsync(weekNumber)`: تعادل هفتگی
+   - **⚠️ فعلا Mock**: 50 پرداخت نمونه با وضعیت‌های مختلف
+
+### ⚠️ WalletService (4 متد کامنت شده)
+- ❌ `GetTransactionsAsync()`: TODO GetAllUserWalletChangeLog
+- ❌ `RequestWithdrawalAsync()`: TODO WithdrawBalance
+- ❌ `GetWithdrawalsAsync()`: TODO GetUserWithdrawals
+- ❌ `GetWithdrawalSettingsAsync()`: TODO GetWithdrawalSettings
+
+**📋 مشاهده جزئیات**: [TODO-COMMENTED-CODE.md](./TODO-COMMENTED-CODE.md)
+
+---
+
+## 🔗 BFF Handlers (12 Handler)
+
+### ✅ موجود و پیاده‌سازی شده:
+
+#### 1. ClubMembershipCQ (2 Handler)
+- ✅ **GetMyClubMembership** (Query)
+  - ⚠️ **مشکل**: فیلدها `ActivationDate` و `ExpirationDate` در CMS به `ActivatedAt` و `ExpiresAt` تغییر کرده
+  - ⚠️ **مشکل**: فیلد `Features` اضافه شده که مپ نشده
+  
+- ✅ **ActivateMyClubMembership** (Command)
+  - ⚠️ **مشکل**: Response Mock است، باید از `GetClubMembership` گرفته شود
+
+#### 2. NetworkMembershipCQ (2 Handler)
+- ✅ **GetMyNetworkTree** (Query)
+  - ⚠️ **مشکل بزرگ**: CMS حالا Flat List بر می‌گرداند نه Tree Structure
+  - 🔧 **نیاز**: باید در BFF یک Tree Builder اضافه شود
+  
+- ✅ **GetMyNetworkStatistics** (Query)
+  - ⚠️ **مشکل**: CMS دیگر `UserId` نمی‌گیرد (برای کل شبکه است)
+  - ⚠️ **مشکل**: فیلد `LastMember` وجود ندارد
+  - 🔧 **راه حل**: استفاده از `GetUserNetwork` + `GetNetworkTree`
+
+#### 3. CommissionCQ (2 Handler)
+- ✅ **GetMyCommissionPayouts** (Query)
+  - ⚠️ **مشکل**: `WeekNumber` از `int` به `string` تغییر کرده
+  - ⚠️ **مشکل**: `PageNumber` باید `PageIndex` باشد
+  - ⚠️ **مشکل**: فیلدهای جدید اضافه شده: `ValuePerBalance`, `WithdrawalMethod`, `IbanNumber`, `LastModified`
+  
+- ✅ **GetMyWeeklyBalances** (Query)
+  - ⚠️ **نیاز به بررسی**: باید چک شود نام فیلدها درست است یا خیر
+
+#### 4. UserWalletCQ (5 Handler - 1 کامل، 4 TODO)
+- ✅ **GetUserWallet** (Query) - کامل است
+  - ⚠️ **مشکل جزئی**: `DiscountBalance` در Response نیست (فعلا 0 بر می‌گرداند)
+  
+- ❌ **GetAllUserWalletChangeLog** (Query) - TODO
+- ❌ **WithdrawBalance** (Command) - TODO
+- ❌ **GetUserWithdrawals** (Query) - TODO
+- ❌ **GetWithdrawalSettings** (Query) - TODO
+
+**📋 تحلیل کامل مغایرت‌ها**: [BFF-CMS-PROTOBUF-MISMATCH-ANALYSIS.md](./BFF-CMS-PROTOBUF-MISMATCH-ANALYSIS.md)
+
+---
+
+## 📦 Protobuf Packages
+
+### ✅ موجود (از قبل):
+- `FrontOffice.BFF.Package.Protobuf`
+- `FrontOffice.BFF.UserAddress.Protobuf`
+- `FrontOffice.BFF.ShoppingCart.Protobuf`
+- `FrontOffice.BFF.UserOrder.Protobuf`
+- `FrontOffice.BFF.UserWallet.Protobuf`
+
+### ❌ ناموجود (باید ساخته شوند):
+- ❌ `FrontOffice.BFF.ClubMembership.Protobuf` (0.0.1)
+- ❌ `FrontOffice.BFF.NetworkMembership.Protobuf` (0.0.1)
+- ❌ `FrontOffice.BFF.Commission.Protobuf` (0.0.1)
+
+**زمان تخمینی**: 2-3 ساعت برای هر Package (مجموع 6-9 ساعت)
+
+---
+
+## ⚠️ مشکلات شناسایی شده
+
+### 🔴 اولویت بالا (Blockers)
+
+1. **BFF Handler Mismatches** (تخمین: 7-8 ساعت)
+   - ClubMembership: نام فیلدها و Features مپینگ
+   - NetworkMembership: Tree Builder و UserNetworkStatistics
+   - Commission: نوع داده WeekNumber و فیلدهای جدید
+   
+2. **Missing Protobuf Packages** (تخمین: 6-9 ساعت)
+   - باید 3 Package ساخته و publish شوند
+   - بعد به FrontOffice.Main اضافه شوند
+   
+3. **WalletService Incomplete Methods** (تخمین: 3-4 ساعت)
+   - 4 متد کامنت شده باید پیاده‌سازی شوند
+   - نیاز به Query/Command جدید در BFF
+
+### 🟡 اولویت متوسط
+
+4. **Tree.razor Update** (تخمین: 2 ساعت)
+   - حذف Mock OrganizationChart
+   - اتصال به NetworkMembershipService
+   - افزودن Depth selector و Lazy loading
+
+5. **Mock Data Replacement** (تخمین: 1 ساعت)
+   - بعد از اصلاح BFF، uncomment کردن gRPC calls
+   - حذف Mock data از Services
+
+### 🟢 اولویت پایین
+
+6. **UI Enhancements** (اختیاری)
+   - افزودن PersianCalendar برای تاریخ‌ها
+   - بهبود نمودارها با ApexCharts
+   - افزودن Real-time Notifications با SignalR
+
+---
+
+## 🔧 نحوه اجرا
+
+### پیش‌نیازها
+```bash
+# .NET 9.0 SDK
+dotnet --version
+
+# Packages:
+- MudBlazor 8.14.0
+- Grpc.Net.Client
+- Google.Protobuf
+```
+
+### اجرای FrontOffice.Main
+```bash
+cd /home/masoud/Apps/project/FourSat/FrontOffice/src
+dotnet build FrontOffice.sln
+dotnet run --project FrontOffice.Main
+```
+
+### اجرای FrontOffice.BFF
+```bash
+cd /home/masoud/Apps/project/FourSat/FrontOffice.BFF/src
+dotnet build FrontOffice.BFF.sln
+dotnet run --project FrontOffice.BFF.WebApi
+```
+
+### اجرای CMS (Backend)
+```bash
+cd /home/masoud/Apps/project/FourSat/CMS/src
+dotnet build CMS.sln
+dotnet run --project CMSMicroservice.WebApi
+```
+
+**⚠️ توجه**: فعلا UI با Mock data کار می‌کند و نیازی به BFF/CMS ندارد.
+
+---
+
+## 📚 مستندات مرتبط
+
+### 📁 اسناد موجود در `totalDoc/FrontOffice/`:
+
+1. **[TODO-COMMENTED-CODE.md](./TODO-COMMENTED-CODE.md)** 🔴
+   - لیست کامل کدهای کامنت شده
+   - TODO برای هر متد با راه حل
+   - Checklist اجرایی
+   
+2. **[BFF-CMS-PROTOBUF-MISMATCH-ANALYSIS.md](./BFF-CMS-PROTOBUF-MISMATCH-ANALYSIS.md)** 🔴
+   - تحلیل جامع مغایرت‌های Protobuf
+   - مقایسه BFF Handler ها با CMS Proto ها
+   - راه حل‌های پیشنهادی با کد نمونه
+   - تخمین زمان برای هر مرحله
+   
+3. **[UI-DEVELOPMENT-SUMMARY.md](./UI-DEVELOPMENT-SUMMARY.md)** (در صورت وجود)
+   - خلاصه توسعه UI
+   - لیست صفحات و Component ها
+   - MudBlazor patterns
+
+### 📁 اسناد کلی پروژه:
+- **[INDEX.md](../INDEX.md)**: راهنمای کلی پروژه FourSat
+- **[QUICK-START-DEVELOPMENT.md](../QUICK-START-DEVELOPMENT.md)**: شروع سریع توسعه
+- **[CMS/README.md](../CMS/README.md)**: مستندات CMS Microservice
+
+---
+
+## 🗺️ نقشه راه (Roadmap)
+
+### ✅ فاز 1: UI Skeleton (تکمیل شد - ۱۴ آذر)
+- [x] ساخت صفحات Club (2 صفحه + 1 component)
+- [x] ساخت صفحات Network (1 صفحه)
+- [x] ساخت صفحات Commission (3 صفحه)
+- [x] ساخت Services با Mock data (3 سرویس)
+- [x] بروزرسانی RouteConstants و Navigation
+- [x] Build موفق (0 errors)
+
+### 🔄 فاز 2: BFF Correction (در حال انجام)
+- [ ] اصلاح GetMyClubMembershipQueryHandler
+- [ ] اصلاح ActivateMyClubMembershipCommandHandler
+- [ ] اصلاح GetMyNetworkTreeQueryHandler (Tree Builder)
+- [ ] اصلاح GetMyNetworkStatisticsQueryHandler
+- [ ] اصلاح GetMyCommissionPayoutsQueryHandler
+- [ ] اصلاح GetMyWeeklyBalancesQueryHandler
+
+**زمان تخمینی**: 7-8 ساعت
+
+### ⏳ فاز 3: Protobuf Packages (آینده)
+- [ ] ساخت FrontOffice.BFF.ClubMembership.Protobuf
+- [ ] ساخت FrontOffice.BFF.NetworkMembership.Protobuf
+- [ ] ساخت FrontOffice.BFF.Commission.Protobuf
+- [ ] Publish به NuGet/Local Source
+- [ ] اضافه کردن به FrontOffice.Main
+
+**زمان تخمینی**: 6-9 ساعت
+
+### ⏳ فاز 4: gRPC Connection (آینده)
+- [ ] Uncomment کردن gRPC calls در Services
+- [ ] حذف Mock data
+- [ ] ConfigureServices.cs: اضافه کردن Clients
+- [ ] تست اتصال با BFF
+- [ ] تست داده واقعی در UI
+
+**زمان تخمینی**: 2-3 ساعت
+
+### ⏳ فاز 5: UserWalletCQ Completion (آینده)
+- [ ] پیاده‌سازی GetAllUserWalletChangeLog
+- [ ] پیاده‌سازی WithdrawBalance
+- [ ] پیاده‌سازی GetUserWithdrawals
+- [ ] پیاده‌سازی GetWithdrawalSettings
+- [ ] Uncomment کردن WalletService methods
+
+**زمان تخمینی**: 3-4 ساعت
+
+### ⏳ فاز 6: Tree.razor Update (آینده)
+- [ ] حذف Mock OrganizationChart
+- [ ] اتصال به NetworkMembershipService
+- [ ] Depth selector (1-10)
+- [ ] Lazy loading
+
+**زمان تخمینی**: 2 ساعت
+
+---
+
+## 📊 آمار پروژه
+
+### کد نوشته شده (فاز UI Development):
+- **Razor Pages**: ~3,500 خط
+- **C# Code**: ~1,500 خط
+- **DTOs**: 15 کلاس
+- **Services**: 3 سرویس جدید
+- **Components**: 1 کامپوننت (ActivationSection)
+
+### فایل‌های ایجاد شده (جدید):
+- **Razor Files**: 14 فایل (.razor + .razor.cs)
+- **Service Files**: 6 فایل (3 Service + 3 Dtos)
+- **Component Files**: 2 فایل
+- **Modified Files**: 5 فایل (RouteConstants, ConfigureServices, Profile/Index, Profile/Wallet, WalletService)
+
+### Build نتایج:
+- ✅ **Errors**: 0
+- ⚠️ **Warnings**: 113 (pre-existing, غیرمرتبط با کد جدید)
+- ⏱️ **Build Time**: ~3.5 ثانیه
+
+---
+
+## 🤝 مشارکت
+
+برای توسعه این پروژه:
+
+1. تمام TODO ها در `TODO-COMMENTED-CODE.md` مشاهده کنید
+2. تمام مغایرت‌ها در `BFF-CMS-PROTOBUF-MISMATCH-ANALYSIS.md` بررسی کنید
+3. برای هر تغییر، ابتدا یک Branch جدید بسازید
+4. پس از اصلاح، `dotnet build` را اجرا و تست کنید
+5. TODO ها را به‌روز کنید
+
+---
+
+## 📞 تماس
+
+**توسعه‌دهنده**: GitHub Copilot (Claude Sonnet 4.5)  
+**تاریخ ایجاد**: آذر ۱۴۰۴  
+**آخرین بروزرسانی**: ۱۴ آذر ۱۴۰۴
+
+---
+
+## 📝 یادداشت‌ها
+
+### ✨ نکات مهم برای توسعه‌دهنده بعدی:
+
+1. **MudBlazor Syntax**: حتما `T="string"` برای MudChip/MudSelect/MudRadio
+2. **Reserved Keywords**: از `Value="@("in")"` برای کلمات رزرو شده استفاده کنید
+3. **DI Injections**: _Imports.razor قبلا Snackbar و Navigation را inject کرده
+4. **Using Statements**: فولدرهای جدید نیاز به `@using MudBlazor` دارند
+5. **Protobuf Versioning**: هر تغییر در CMS Proto، نیاز به بروزرسانی BFF Handler دارد
+6. **Mock Data Pattern**: همیشه یک TODO comment بگذارید تا فراموش نشود
+7. **Tree Structure**: CMS حالا Flat List برمی‌گرداند، باید در BFF Tree بسازید
+8. **WeekNumber Type**: در Commission از `string` استفاده می‌شود نه `int`
+
+### 🐛 مشکلات شناخته شده:
+
+- ⚠️ **WalletService**: 4 متد کامنت شده (نیاز به Query/Command جدید در BFF)
+- ⚠️ **Tree.razor**: هنوز Mock data دارد، باید به NetworkMembershipService متصل شود
+- ⚠️ **BFF Handlers**: 6 Handler نیاز به اصلاح دارند (مغایرت با CMS Proto)
+- ⚠️ **Protobuf Packages**: 3 Package هنوز ساخته نشده‌اند
+
+---
+
+**📅 آخرین بروزرسانی**: ۱۴ آذر ۱۴۰۴  
+**👤 توسط**: GitHub Copilot (Claude Sonnet 4.5)

04-FRONTEND/FrontOffice/gap-analysis.md

@@ -0,0 +1,981 @@
+<div dir="rtl" align="right">
+
+# 📊 تحلیل جامع FrontOffice - وضعیت فعلی و نقشه راه
+
+**تاریخ تحلیل**: ۱۴ آذر ۱۴۰۴ (بروزرسانی شده)  
+**وضعیت کلی**: ⚠️ **پیاده‌سازی BFF (60%)** - هسته مرکزی آماده، نیاز به UI  
+**اولویت**: 🟡 **متوسط** - BFF Skeleton آماده، فقط UI باقی مانده
+
+---
+
+## 🎯 خلاصه اجرایی
+
+### وضعیت موجود:
+- ✅ **24 صفحه UI** موجود (Store, Profile, Root pages)
+- ✅ **12 ماژول CQ در BFF** (9 قدیمی + 3 جدید: Club, Network, Commission)
+- ✅ **هسته مرکزی BFF کامل** (ClubMembership, NetworkMembership, Commission)
+- ✅ **معماری gRPC** پیاده‌سازی شده + Infrastructure آماده
+- ⚠️ **UI Pages برای Club/Network/Commission غایب** (فقط اسکلت BFF)
+
+### نیازمندی‌های کاربر (7 دسته) - **بروزرسانی شده**:
+1. 🟡 **باشگاه مشتریان** - BFF آماده ✅ | UI غایب ❌
+2. 🟡 **صفحه داشبورد باشگاه** - BFF آماده ✅ | UI غایب ❌
+3. ⚠️ **دیدن اطلاعات در یک نگاه** - Dashboard جامع (نیمه‌کاره)
+4. ⚠️ **فروشگاه معمولی** - نیاز به بهبود UI/UX
+5. ❌ **پرداخت دستی پکیج طلایی** - فرآیند ناقص
+6. 🟡 **گزارش شبکه و کمیسیون** - BFF آماده ✅ | UI غایب ❌
+7. ❓ **موارد اضافی** - نیازمند تحلیل
+
+---
+
+## 📁 ساختار فعلی پروژه
+
+### 1️⃣ FrontOffice UI (Blazor Server)
+
+**مسیر**: `/FrontOffice/src/FrontOffice.Main/Pages/`
+
+#### صفحات موجود (24 صفحه):
+
+**الف. Root Level (7 صفحه):**
+```
+✅ Index.razor              - صفحه اصلی (Hero, Features, Stats)
+✅ About.razor              - درباره ما
+✅ Contact.razor            - تماس با ما
+✅ FAQ.razor                - سوالات متداول
+✅ Checkout.razor           - صفحه پرداخت
+✅ RegisterWizard.razor     - ثبت‌نام کاربر
+✅ PackageDetail.razor      - جزئیات پکیج
+```
+
+**ب. Profile Section (6 صفحه):**
+```
+✅ Profile/Index.razor      - داشبورد پروفایل (نمایش _walletNetwork)
+✅ Profile/Personal.razor   - اطلاعات شخصی
+✅ Profile/Settings.razor   - تنظیمات
+✅ Profile/Wallet.razor     - کیف پول (3 موجودی: Credit, Discount, Network)
+⚠️ Profile/Addresses.razor  - آدرس‌ها (کامل)
+⚠️ Profile/Tree.razor       - شجره‌نامه (Mock data - OrganizationChart component)
+```
+
+**ج. Store Section (7 صفحه):**
+```
+✅ Store/Products.razor         - لیست محصولات
+✅ Store/ProductDetail.razor    - جزئیات محصول
+✅ Store/Cart.razor             - سبد خرید
+✅ Store/Categories.razor       - دسته‌بندی‌ها
+✅ Store/Orders.razor           - سفارشات
+✅ Store/OrderDetail.razor      - جزئیات سفارش
+✅ Store/CheckoutSummary.razor  - خلاصه پرداخت
+```
+
+**د. Shared Components:**
+```
+✅ Shared/MainLayout.razor
+✅ Shared/Footer.razor
+✅ Shared/AuthDialog.razor
+✅ Shared/SimpleOtpDialog.razor
+```
+
+---
+
+### 2️⃣ FrontOffice.BFF (Backend For Frontend)
+
+**مسیر**: `/FrontOffice.BFF/src/`
+
+#### معماری (Clean Architecture):
+```
+FrontOffice.BFF/
+├── Application/          # CQRS Handlers + DTOs
+│   ├── CategoryCQ/                    ✅ قدیمی
+│   ├── PackageCQ/                     ✅ قدیمی
+│   ├── ProductsCQ/                    ✅ قدیمی
+│   ├── ShopingCartCQ/                 ✅ قدیمی
+│   ├── TransactionCQ/                 ✅ قدیمی
+│   ├── UserAddressCQ/                 ✅ قدیمی
+│   ├── UserCQ/                        ✅ قدیمی
+│   ├── UserOrderCQ/                   ✅ قدیمی
+│   ├── UserWalletCQ/                  ✅ قدیمی (DiscountBalance موجود)
+│   ├── ClubMembershipCQ/              🆕 جدید (امروز)
+│   ├── NetworkMembershipCQ/           🆕 جدید (امروز)
+│   └── CommissionCQ/                  🆕 جدید (امروز)
+├── Domain/               # Entities (minimal)
+├── Infrastructure/       # gRPC clients, DB context
+│   ├── Services/
+│   │   └── ApplicationContractContext.cs   ✅ بروز (ClubMemberships, NetworkMemberships)
+│   └── ConfigureGrpcServices.cs            ✅ Auto-register
+└── WebApi/
+    ├── Services/         # gRPC Service Implementations
+    │   ├── CategoriesService.cs
+    │   ├── PackageService.cs
+    │   ├── ProductsService.cs
+    │   ├── ShopingCartService.cs
+    │   ├── TransactionService.cs
+    │   ├── UserAddressService.cs
+    │   ├── UserOrderService.cs
+    │   ├── UserService.cs
+    │   └── UserWalletService.cs
+    └── Protobufs/        # gRPC Proto definitions
+```
+
+#### 12 ماژول موجود (9 قدیمی + 3 جدید):
+
+| ماژول | وضعیت | توضیحات |
+|------|-------|---------|
+| **CategoryCQ** | ✅ کامل | دریافت دسته‌بندی‌ها |
+| **PackageCQ** | ✅ کامل | دریافت پکیج‌ها |
+| **ProductsCQ** | ✅ کامل | محصولات و گالری |
+| **ShopingCartCQ** | ⚠️ ناقص | Add/Update موجود، Delete/Clear غایب |
+| **TransactionCQ** | ✅ کامل | پرداخت و تأیید |
+| **UserAddressCQ** | ✅ کامل | CRUD آدرس‌ها |
+| **UserCQ** | ✅ کامل | OTP, Login, Profile |
+| **UserOrderCQ** | ✅ کامل | CRUD سفارشات |
+| **UserWalletCQ** | ✅ کامل | GetWallet + DiscountBalance موجود ✅ |
+| **🆕 ClubMembershipCQ** | ✅ اسکلت | GetMyClubMembership, ActivateMyClubMembership |
+| **🆕 NetworkMembershipCQ** | ✅ اسکلت | GetMyNetworkTree, GetMyNetworkStatistics |
+| **🆕 CommissionCQ** | ✅ اسکلت | GetMyCommissionPayouts, GetMyWeeklyBalances |
+
+---
+
+## 🔴 تحلیل شکاف‌های بحرانی (Gap Analysis)
+
+### دسته A: ماژول‌های BFF آماده (اسکلت کامل ✅) - نیاز به UI
+
+#### 1️⃣ ClubMembershipCQ - باشگاه مشتریان
+
+**✅ در FrontOffice.BFF**: اسکلت کامل شده (امروز ۱۴ آذر)  
+**❌ در FrontOffice UI**: هیچ صفحه‌ای برای باشگاه وجود ندارد
+
+**✅ در CMS موجود:**
+- Commands: `ActivateClubMembership`, `DeactivateClubMembership`, `AssignClubFeature`
+- Queries: `GetClubMembership`, `GetClubMembershipHistory`, `GetClubStatistics`
+
+**✅ کارهای انجام شده در BFF:**
+
+**الف. BFF Module (FrontOffice.BFF/Application/):**
+```
+✅ ClubMembershipCQ/
+    ✅ Commands/
+        ✅ ActivateMyClubMembership/         # پرداخت 56M
+            - ActivateMyClubMembershipCommand.cs
+            - ActivateMyClubMembershipCommandHandler.cs
+            - ActivateMyClubMembershipResponseDto.cs
+    ✅ Queries/
+        ✅ GetMyClubMembership/              # وضعیت عضویت (Active/Inactive/Trial)
+            - GetMyClubMembershipQuery.cs
+            - GetMyClubMembershipQueryHandler.cs
+            - GetMyClubMembershipResponseDto.cs
+```
+
+**✅ Infrastructure Updates:**
+```csharp
+✅ IApplicationContractContext + Implementation:
+    - ClubMemberships property اضافه شد
+    - NetworkMemberships property اضافه شد
+```
+
+**ج. UI Pages (FrontOffice/Pages/):**
+```
+[ ] Club/
+    [ ] MembershipPage.razor
+        - Badge وضعیت (Active/Inactive/Trial)
+        - دکمه فعال‌سازی (56M تومان)
+        - نمایش تاریخ انقضا
+        - لیست مزایا
+    [ ] FeaturesPage.razor
+        - کارت هر فیچر (Trial vs VIP)
+        - امتیاز لازم (RequiredPoints)
+        - Badge فیچرهای فعال
+    [ ] Components/
+        [ ] ActivationButton.razor         # فرم پرداخت
+        [ ] FeatureCard.razor              # کارت تک فیچر
+```
+
+**💰 اثر بیزینسی:**
+- ❌ کاربر نمی‌تواند عضو باشگاه شود
+- ❌ 56M شارژ Balance/Discount انجام نمی‌شود
+- ❌ دسترسی به فروشگاه تخفیف وجود ندارد
+
+---
+
+#### 2️⃣ NetworkMembershipCQ - شبکه باینری
+
+**❌ در FrontOffice.BFF**: هیچ چیز موجود نیست  
+**⚠️ در FrontOffice UI**: فقط `Profile/Tree.razor` با داده Mock
+
+**✅ در CMS موجود:**
+- Commands: `JoinNetwork`, `MoveInNetwork`, `RemoveFromNetwork`
+- Queries: `GetNetworkTree`, `GetUserNetworkPosition`, `GetNetworkMembershipHistory`, `GetNetworkStatistics`
+
+**📋 کارهای مورد نیاز:**
+
+**الف. BFF Module:**
+```
+[ ] NetworkMembershipCQ/
+    [ ] Commands/
+        [ ] JoinNetwork/                     # عضویت در شبکه
+    [ ] Queries/
+        [ ] GetMyNetworkTree/                # درخت باینری (MaxDepth: 1-10)
+        [ ] GetMyNetworkPosition/            # موقعیت من (Parent, Left, Right)
+        [ ] GetMyNetworkStatistics/          # آمار (تعداد چپ/راست/کل)
+        [ ] GetNetworkHistory/               # تاریخچه جابجایی
+```
+
+**ب. BFF Service:**
+```csharp
+[ ] NetworkMembershipService.cs
+    - GetMyNetworkTree(maxDepth) → CMS.GetNetworkTreeAsync(userId, maxDepth)
+    - GetMyNetworkPosition() → CMS.GetUserNetworkPositionAsync(userId)
+    - GetMyNetworkStatistics() → CMS.GetNetworkStatisticsAsync(userId)
+    - JoinNetwork(parentId, position) → CMS.JoinNetworkAsync()
+```
+
+**ج. UI Updates:**
+```
+[ ] Profile/Tree.razor
+    ✅ Component موجود: OrganizationChart
+    [ ] حذف Mock data
+    [ ] فراخوانی GetMyNetworkTree از BFF
+    [ ] Selector عمق درخت (1-10)
+    [ ] Lazy loading برای زیرشاخه‌ها
+    [ ] دکمه Expand/Collapse
+    
+[ ] Pages/Network/
+    [ ] StatsPage.razor                      # صفحه آمار شبکه
+        - کارت تعداد چپ/راست
+        - کارت کل اعضا
+        - عمق درخت
+        - آخرین عضو جدید
+        - نمودار رشد
+    [ ] JoinPage.razor                       # فرم عضویت
+        - انتخاب Parent (جستجو)
+        - انتخاب Position (Left/Right)
+        - پیش‌نمایش موقعیت
+```
+
+**💰 اثر بیزینسی:**
+- ❌ کاربر نمی‌تواند زیرمجموعه بگیرد
+- ❌ درخت شبکه واقعی نمایش داده نمی‌شود
+- ❌ محاسبه کمیسیون باینری کار نمی‌کند
+
+---
+
+#### 3️⃣ CommissionCQ - کمیسیون و برداشت
+
+**⚠️ در FrontOffice.BFF**: فقط `WithdrawBalance` (کامل - در UserWalletCQ)  
+**❌ در FrontOffice UI**: هیچ صفحه کمیسیون موجود نیست
+
+**✅ در CMS موجود:**
+- Commands: `RequestWithdrawal`, `ApproveWithdrawal`, `ProcessWithdrawal`, `CalculateWeekly*`
+- Queries: `GetUserCommissionPayouts`, `GetUserWeeklyBalances`, `GetWeeklyCommissionPool`, `GetWithdrawalRequests`
+
+**📋 کارهای مورد نیاز:**
+
+**الف. BFF Module:**
+```
+[ ] CommissionCQ/
+    [ ] Queries/
+        [ ] GetMyCommissionPayouts/          # لیست پرداخت‌های کمیسیون
+            - GetMyCommissionPayoutsQuery.cs
+            - GetMyCommissionPayoutsQueryHandler.cs
+            - CommissionPayoutDto.cs (Week, Amount, Status, Date)
+        [ ] GetMyWeeklyBalances/             # تعادل هفتگی
+            - GetMyWeeklyBalancesQuery.cs
+            - GetMyWeeklyBalancesQueryHandler.cs
+            - WeeklyBalanceDto.cs (Left, Right, Weaker, Carryover)
+        [ ] GetWeeklyPoolInfo/               # اطلاعات استخر هفته
+            - GetWeeklyPoolInfoQuery.cs
+            - GetWeeklyPoolInfoQueryHandler.cs
+            - WeeklyPoolDto.cs (TotalPool, BalanceValue)
+        [ ] GetMyWithdrawalHistory/          # تاریخچه برداشت‌ها
+            - GetMyWithdrawalHistoryQuery.cs
+            - GetMyWithdrawalHistoryQueryHandler.cs
+            - WithdrawalHistoryDto.cs
+```
+
+**ب. BFF Service:**
+```csharp
+[ ] CommissionService.cs
+    - GetMyCommissionPayouts(weekNumber?, status?) → CMS.GetUserCommissionPayoutsAsync(userId)
+    - GetMyWeeklyBalances(weekNumber?) → CMS.GetUserWeeklyBalancesAsync(userId)
+    - GetWeeklyPoolInfo(weekNumber?) → CMS.GetWeeklyCommissionPoolAsync(weekNumber)
+    - GetMyWithdrawalHistory() → CMS.GetWithdrawalRequestsAsync(userId)
+```
+
+**توجه**: `WithdrawBalance` در `UserWalletService` قبلاً پیاده‌سازی شده ✅
+
+**ج. UI Pages:**
+```
+[ ] Pages/Commission/
+    [ ] DashboardPage.razor                  # داشبورد کمیسیون
+        - کارت استخر هفته (TotalPool, BalanceValue)
+        - کارت امتیازات من (LesserLegPoints)
+        - پیش‌بینی کمیسیون این هفته
+        - نمودار روند 4 هفته اخیر
+    [ ] HistoryPage.razor                    # تاریخچه پرداخت‌ها
+        - جدول پرداخت‌های گذشته
+        - فیلتر Status (Pending/Calculated/Paid/Withdrawn)
+        - فیلتر هفته
+        - نمودار خطی روند
+    [ ] WithdrawPage.razor                   # صفحه برداشت
+        ✅ قسمتی در Profile/Wallet.razor موجود است
+        [ ] جداسازی به صفحه مستقل
+        - فرم برداشت (PayoutId, Method, IBAN)
+        - نمایش MinWithdrawalAmount
+        - نمایش موجودی قابل برداشت
+        - تاریخچه برداشت‌ها
+    [ ] WeeklyBalancePage.razor              # تعادل هفتگی
+        - تعادل چپ/راست
+        - Carryover از هفته قبل
+        - سقف 300 Balance
+        - نمودار میله‌ای هفته‌ها
+```
+
+**💰 اثر بیزینسی:**
+- ❌ کاربر نمی‌تواند کمیسیون خود را ببیند
+- ✅ برداشت از NetworkBalance کار می‌کند (در Wallet.razor)
+- ❌ تعادل هفتگی و Carryover نامشخص است
+
+---
+
+#### 4️⃣ DayaLoanCQ - وام دایا
+
+**❌ در FrontOffice.BFF**: هیچ چیز موجود نیست  
+**❌ در FrontOffice UI**: هیچ چیز موجود نیست
+
+**✅ در CMS موجود:**
+- Commands: `CheckDayaLoanStatus`, `ProcessDayaLoanApproval`
+- Background Worker: Daily check for loan status
+
+**📋 کارهای مورد نیاز:**
+
+**الف. BFF Module:**
+```
+[ ] DayaLoanCQ/
+    [ ] Queries/
+        [ ] GetMyDayaLoanStatus/
+            - GetMyDayaLoanStatusQuery.cs
+            - GetMyDayaLoanStatusQueryHandler.cs
+            - DayaLoanStatusDto.cs (Status, ContractNumber, LastCheckDate, ApprovalDate)
+```
+
+**ب. BFF Service:**
+```csharp
+[ ] DayaLoanService.cs
+    - GetMyDayaLoanStatus() → CMS.GetDayaLoanStatusAsync(userId)
+```
+
+**ج. UI Pages:**
+```
+[ ] Pages/DayaLoan/
+    [ ] StatusPage.razor
+        - Badge وضعیت (PendingReceive/Received/Rejected)
+        - نمایش شماره قرارداد
+        - تاریخ آخرین بررسی
+        - توضیحات وام (168M = 56M×3)
+    [ ] Components/
+        [ ] StatusBadge.razor
+            - رنگ‌بندی (Warning/Success/Error)
+```
+
+**💰 اثر بیزینسی:**
+- ❌ کاربر نمی‌تواند وضعیت وام دایا را ببیند
+- ❌ 168M شارژ (56M×3) نامشخص است
+- ⚠️ Worker پس‌زمینه فعال است اما UI ندارد
+
+---
+
+### دسته B: ماژول‌های کامل‌شده (100% BFF)
+
+#### 5️⃣ UserWalletCQ - کیف‌پول
+
+**✅ موجود در BFF (کامل):**
+- `GetUserWallet` - دریافت موجودی (✅ DiscountBalance موجود است)
+- `GetAllUserWalletChangeLog` - تاریخچه تراکنش‌ها
+- `WithdrawBalance` - برداشت (✅ کار می‌کند)
+- `GetUserWithdrawals` - لیست برداشت‌ها
+- `GetWithdrawalSettings` - تنظیمات برداشت (MinAmount)
+
+**✅ Response DTO:**
+```csharp
+public class GetUserWalletResponseDto
+{
+    ✅ public long Balance { get; set; }
+    ✅ public long NetworkBalance { get; set; }
+    ✅ public long DiscountBalance { get; set; }  // موجود است
+}
+```
+
+**⚠️ مشکلات جزئی:**
+1. **فیلترهای ناقص**: `GetAllUserWalletChangeLog` فیلتر ندارد
+   - نیاز: Type (Deposit/Withdraw/Purchase), DateRange, ReferenceId
+
+**ب. UI Updates:**
+```
+[ ] Profile/Wallet.razor
+    ✅ نمایش Balance
+    ✅ نمایش NetworkBalance
+    ❌ نمایش DiscountBalance (زرد/نارنجی)
+    [ ] حذف داده Mock (Discount: "در انتظار اتصال CMS...")
+    [ ] افزودن فیلترهای تراکنش:
+        - Select نوع (همه/ورودی/خروجی)
+        - DateRange picker
+        - TextField جستجو ReferenceId
+    [ ] نمایش ChangeValue به جای CurrentBalance
+    [ ] Pagination برای تراکنش‌ها
+```
+
+**💰 اثر بیزینسی:**
+- ⚠️ کاربر DiscountBalance خود را نمی‌بیند (باشگاه)
+- ⚠️ فیلتر تراکنش‌ها محدود است
+
+---
+
+#### 6️⃣ ShopingCartCQ - سبد خرید
+
+**✅ موجود در BFF:**
+- `AddNewUserCart` - افزودن به سبد
+- `UpdateUserCart` - به‌روزرسانی تعداد
+- `GetAllUserCart` - دریافت سبد
+
+**❌ غایب:**
+- `ClearCart` - پاک کردن کل سبد
+- `DeleteUserCarts` - حذف یک آیتم
+- `MergeGuestCart` - ادغام سبد مهمان→ورود
+
+**📋 کارهای مورد نیاز:**
+
+**الف. BFF Commands:**
+```
+[ ] ShopingCartCQ/Commands/
+    [ ] ClearCart/
+        - ClearCartCommand.cs
+        - ClearCartCommandHandler.cs → CMS.ClearUserCartAsync(userId)
+    [ ] DeleteCartItem/
+        - DeleteCartItemCommand.cs (CartId)
+        - DeleteCartItemCommandHandler.cs → CMS.DeleteUserCartsAsync(cartId)
+    [ ] MergeGuestCart/
+        - MergeGuestCartCommand.cs (SessionId)
+        - MergeGuestCartCommandHandler.cs:
+            1. Get guest cart by SessionId
+            2. Get user cart by UserId
+            3. Merge duplicates (sum quantities)
+            4. CMS.AddNewUserCart() for each
+```
+
+**ب. UI Updates:**
+```
+[ ] Store/Cart.razor
+    [ ] دکمه "پاک کردن سبد" (ClearCart)
+    [ ] دکمه حذف (DeleteCartItem) در هر سطر
+    [ ] SessionId handling:
+        - ذخیره در LocalStorage
+        - POST به MergeGuestCart بعد از Login
+        - نمایش پیام "x محصول از سبد قبلی شما اضافه شد"
+```
+
+---
+
+#### 7️⃣ DiscountShopCQ - فروشگاه تخفیف
+
+**❌ در FrontOffice.BFF**: هیچ چیز موجود نیست  
+**❌ در FrontOffice UI**: هیچ صفحه‌ای موجود نیست
+
+**✅ در CMS موجود:**
+- Full CRUD for `DiscountProduct`, `DiscountCategory`, `DiscountOrder`
+- BackOffice UI: 3 pages (Products, Categories, Orders)
+
+**📋 کارهای مورد نیاز:**
+
+**الف. BFF Module:**
+```
+[ ] DiscountShopCQ/
+    [ ] Queries/
+        [ ] GetDiscountProducts/             # محصولات تخفیف
+        [ ] GetDiscountCategories/           # دسته‌بندی‌های تخفیف
+        [ ] GetMyDiscountOrders/             # سفارشات تخفیف من
+    [ ] Commands/
+        [ ] AddToDiscountCart/               # افزودن به سبد تخفیف
+        [ ] PlaceDiscountOrder/              # ثبت سفارش با DiscountBalance
+```
+
+**ب. BFF Service:**
+```csharp
+[ ] DiscountShopService.cs
+    - GetDiscountProducts() → CMS.GetAllDiscountProductsAsync()
+    - GetDiscountCategories() → CMS.GetAllDiscountCategoriesAsync()
+    - GetMyDiscountOrders() → CMS.GetAllDiscountOrdersAsync(userId)
+    - PlaceDiscountOrder(items) → CMS.CreateDiscountOrderAsync()
+```
+
+**ج. UI Pages:**
+```
+[ ] Pages/DiscountShop/
+    [ ] ProductsPage.razor                   # لیست محصولات تخفیف
+        - نمایش DiscountPercent (بادگ)
+        - نمایش MaxDiscountPercentage سقف
+        - فیلتر دسته‌بندی
+        - کارت محصول با قیمت اصلی/تخفیف‌یافته
+    [ ] CartPage.razor                       # سبد تخفیف
+        - نمایش DiscountBalance موجود
+        - محاسبه قیمت نهایی
+        - دکمه Checkout
+    [ ] OrdersPage.razor                     # سفارشات تخفیف
+        - لیست سفارشات با Badge "Club Discount"
+        - جزئیات تخفیف اعمال‌شده
+```
+
+**💰 اثر بیزینسی:**
+- ❌ کاربر باشگاه نمی‌تواند از تخفیف استفاده کند
+- ❌ DiscountBalance کاربرد ندارد
+- ❌ 3 صفحه BackOffice بدون UI مشتری
+
+---
+
+### دسته C: قابلیت‌های جزئی (نیازهای اضافی)
+
+#### 8️⃣ PublicMessageCQ - پیام‌های عمومی
+
+**✅ در BackOffice موجود**: صفحه مدیریت پیام‌ها  
+**❌ در FrontOffice**: هیچ چیز نیست
+
+**📋 کارهای مورد نیاز:**
+```
+[ ] PublicMessageCQ/Queries/GetActivePublicMessages/
+[ ] UI: Pages/Messages/ListPage.razor
+    - لیست پیام‌ها با فیلتر Type (News/Announcement/Promotion)
+    - Badge اولویت
+    - نمایش تاریخ انتشار
+```
+
+---
+
+#### 9️⃣ NotificationCQ - نوتیفیکیشن
+
+**❌ در همه جا موجود نیست**
+
+**پیشنهاد:**
+```
+[ ] NotificationCQ/
+    [ ] Queries/GetMyNotifications/
+    [ ] Commands/MarkAsRead/
+[ ] UI: Bell Icon در Navbar
+    - Badge تعداد جدید
+    - Dropdown لیست نوتیفیکیشن
+```
+
+---
+
+#### 🔟 ReferralLinkCQ - لینک دعوت
+
+**❌ در همه جا موجود نیست**
+
+**پیشنهاد:**
+```
+[ ] ReferralLinkCQ/Queries/GetMyReferralLink/
+[ ] UI: Profile/ReferralPage.razor
+    - نمایش لینک دعوت
+    - دکمه Copy
+    - آمار دعوت‌شده‌ها (تعداد)
+    - QR Code
+```
+
+---
+
+## 📊 خلاصه آماری شکاف‌ها (بروزرسانی شده)
+
+| دسته | تعداد ماژول | وضعیت BFF | وضعیت UI | درصد کل |
+|------|------------|-----------|----------|---------|
+| ✅ کامل (BFF+UI) | 6 | Category, Package, Products, Transaction, UserAddress, UserCQ | موجود | 35% |
+| ✅ BFF آماده | 3 | ClubMembership, NetworkMembership, Commission | **UI غایب** | 20% |
+| ✅ BFF کامل | 2 | UserWallet (DiscountBalance), UserOrder | UI موجود | 15% |
+| ⚠️ نیمه‌کاره | 1 | ShopingCart (Delete/Clear غایب) | UI موجود | 5% |
+| ❌ غایب بحرانی | 1 | DayaLoan | UI غایب | 5% |
+| ❌ غایب اضافی | 4 | DiscountShop, PublicMessage, Notification, ReferralLink | UI غایب | 20% |
+
+**جمع**: 17 ماژول
+**وضعیت BFF**: 60% کامل (12 از 17)
+**وضعیت UI**: 40% کامل (فقط 9 ماژول قدیمی)
+
+---
+
+## 🎯 اولویت‌های باقی‌مانده (بروزرسانی شده)
+
+### فاز 1: UI برای ماژول‌های BFF آماده (اولویت بالا 🔴)
+
+**هدف**: اتصال UI به BFF موجود
+
+```
+[ ] Phase 1A: Club UI (2-3 روز)
+    [ ] Pages/Club/MembershipPage.razor
+    [ ] Pages/Club/FeaturesPage.razor (اختیاری)
+    [ ] Components/Club/ActivationButton.razor
+
+[ ] Phase 1B: Network UI (2 روز)
+    [ ] Update Profile/Tree.razor (حذف Mock + اتصال به BFF)
+    [ ] Pages/Network/StatsPage.razor
+
+[ ] Phase 1C: Commission UI (3 روز)
+    [ ] Pages/Commission/DashboardPage.razor
+    [ ] Pages/Commission/HistoryPage.razor
+    [ ] Pages/Commission/WeeklyBalancePage.razor
+
+[ ] Phase 1D: Wallet UI Update (1 روز)
+    [ ] Update Profile/Wallet.razor (نمایش DiscountBalance - کارت زرد)
+```
+
+**زمان تخمینی**: 8-9 روز
+
+---
+
+### فاز 2: ماژول‌های ثانویه (اولویت متوسط 🟡)
+
+```
+Day 1-2: DiscountShopCQ
+  [ ] BFF Module
+  [ ] Pages/DiscountShop/ProductsPage.razor
+  [ ] Pages/DiscountShop/CartPage.razor
+
+Day 3: ShopingCartCQ Completion
+  [ ] Add DeleteCartItem, ClearCart Commands
+  [ ] Update Store/Cart.razor
+
+Day 4: DayaLoanCQ
+  [ ] BFF Module (Query only)
+  [ ] Pages/DayaLoan/StatusPage.razor
+
+Day 5: PublicMessageCQ
+  [ ] BFF Module
+  [ ] Pages/Messages/ListPage.razor
+```
+
+---
+
+### مرحله 3: بهبودهای UI/UX (1 هفته)
+
+```
+Day 1-2: Store Improvements
+  [ ] Responsive design (mobile-first)
+  [ ] Skeleton loaders
+  [ ] Image lazy loading
+  [ ] Product filters enhancement
+
+Day 3-4: Profile Enhancements
+  [ ] Avatar upload
+  [ ] Settings page completion
+  [ ] ReferralPage.razor (لینک دعوت)
+
+Day 5: Notification System
+  [ ] Bell icon در Navbar
+  [ ] Notification dropdown
+  [ ] Mark as read
+```
+
+---
+
+### مرحله 4: قابلیت‌های اضافی (اختیاری)
+
+```
+[ ] Referral System (لینک دعوت + آمار)
+[ ] Achievement/Rewards System
+[ ] Reports (Excel/PDF export)
+[ ] Advanced Filters (تاریخ، نوع، مبلغ)
+[ ] Mobile App (PWA)
+```
+
+---
+
+## 🛠️ الگوی پیاده‌سازی استاندارد
+
+### الف. BFF Module Template
+
+```
+FrontOffice.BFF/Application/[ModuleName]CQ/
+├── Commands/
+│   └── [ActionName]/
+│       ├── [ActionName]Command.cs
+│       ├── [ActionName]CommandHandler.cs
+│       ├── [ActionName]CommandValidator.cs
+│       └── [ActionName]ResponseDto.cs (optional)
+└── Queries/
+    └── [QueryName]/
+        ├── [QueryName]Query.cs
+        ├── [QueryName]QueryHandler.cs
+        └── [QueryName]ResponseDto.cs
+```
+
+**مثال: GetMyClubMembership**
+
+```csharp
+// GetMyClubMembershipQuery.cs
+public record GetMyClubMembershipQuery : IRequest<ClubMembershipDto>;
+
+// GetMyClubMembershipQueryHandler.cs
+public class GetMyClubMembershipQueryHandler : IRequestHandler<GetMyClubMembershipQuery, ClubMembershipDto>
+{
+    private readonly IApplicationContractContext _context;
+    private readonly ICurrentUserService _currentUser;
+
+    public async Task<ClubMembershipDto> Handle(GetMyClubMembershipQuery request, CancellationToken ct)
+    {
+        var userId = _currentUser.UserId;  // از JWT Token
+        
+        var cmsRequest = new GetClubMembershipRequest { UserId = userId };
+        var result = await _context.ClubMemberships.GetClubMembershipAsync(cmsRequest, cancellationToken: ct);
+        
+        return new ClubMembershipDto
+        {
+            UserId = result.UserId,
+            IsActive = result.IsActive,
+            ActivationDate = result.ActivationDate.ToDateTime(),
+            ExpirationDate = result.ExpirationDate.ToDateTime(),
+            Status = result.Status // Active/Inactive/Trial
+        };
+    }
+}
+```
+
+---
+
+### ب. gRPC Service Template
+
+```csharp
+// FrontOffice.BFF/WebApi/Services/ClubMembershipService.cs
+public class ClubMembershipService : ClubMembershipContract.ClubMembershipContractBase
+{
+    private readonly IDispatchRequestToCQRS _dispatchRequestToCQRS;
+
+    public ClubMembershipService(IDispatchRequestToCQRS dispatchRequestToCQRS)
+    {
+        _dispatchRequestToCQRS = dispatchRequestToCQRS;
+    }
+
+    public override async Task<GetMyClubMembershipResponse> GetMyClubMembership(Empty request, ServerCallContext context)
+    {
+        return await _dispatchRequestToCQRS.Handle<GetMyClubMembershipQuery, GetMyClubMembershipResponse>(context);
+    }
+
+    public override async Task<Empty> ActivateClubMembership(ActivateClubMembershipRequest request, ServerCallContext context)
+    {
+        return await _dispatchRequestToCQRS.Handle<ActivateClubMembershipRequest, ActivateClubMembershipCommand, Empty>(request, context);
+    }
+}
+```
+
+---
+
+### ج. UI Page Template
+
+```razor
+@* Pages/Club/MembershipPage.razor *@
+@page "/club/membership"
+@inject ClubMembershipContract.ClubMembershipContractClient ClubService
+
+<PageTitle>باشگاه مشتریان</PageTitle>
+
+<MudContainer MaxWidth="MaxWidth.Large" Class="py-6">
+    <MudStack Spacing="3">
+        <MudText Typo="Typo.h4">باشگاه مشتریان</MudText>
+
+        @if (_isLoading)
+        {
+            <MudProgressCircular Indeterminate="true" />
+        }
+        else if (_membership != null)
+        {
+            <MudPaper Elevation="2" Class="pa-4">
+                <MudStack Spacing="2">
+                    <MudChip Color="@GetStatusColor()" Variant="Variant.Filled">
+                        @GetStatusText()
+                    </MudChip>
+                    
+                    @if (!_membership.IsActive)
+                    {
+                        <MudButton Variant="Variant.Filled" 
+                                   Color="Color.Primary" 
+                                   OnClick="ActivateMembership">
+                            فعال‌سازی باشگاه (56,000,000 تومان)
+                        </MudButton>
+                    }
+                    else
+                    {
+                        <MudText>تاریخ انقضا: @_membership.ExpirationDate.ToPersianDate()</MudText>
+                    }
+                </MudStack>
+            </MudPaper>
+        }
+    </MudStack>
+</MudContainer>
+
+@code {
+    private ClubMembershipDto? _membership;
+    private bool _isLoading = true;
+
+    protected override async Task OnInitializedAsync()
+    {
+        try
+        {
+            var response = await ClubService.GetMyClubMembershipAsync(new Empty());
+            _membership = response;  // Map to DTO
+        }
+        finally
+        {
+            _isLoading = false;
+        }
+    }
+
+    private async Task ActivateMembership()
+    {
+        // پرداخت 56M
+    }
+
+    private Color GetStatusColor() => _membership?.IsActive == true ? Color.Success : Color.Warning;
+    private string GetStatusText() => _membership?.IsActive == true ? "فعال" : "غیرفعال";
+}
+```
+
+---
+
+## 📋 چک‌لیست شروع توسعه
+
+قبل از شروع هر ماژول:
+
+```
+[ ] CMS Commands/Queries را شناسایی کردم
+[ ] Proto definitions را یافتم (CMS/Protobuf/*.proto)
+[ ] نمونه Handler موجود در BFF را بررسی کردم
+[ ] JWT Token و CurrentUserService را فهمیدم
+[ ] ساختار DTO مشتری‌محور را طراحی کردم
+[ ] Mock data برای UI آماده کردم
+```
+
+---
+
+## 🚨 نکات بحرانی
+
+### 1. تفاوت CMS vs BFF
+
+| جنبه | CMS | FrontOffice.BFF |
+|------|-----|-----------------|
+| **مخاطب** | Admin + System | Customer فقط |
+| **داده** | همه کاربران | کاربر جاری (`UserId` از JWT) |
+| **Response** | DTO کامل + Metadata | DTO ساده (فقط فیلدهای لازم) |
+| **Authorization** | Role-based (Admin/User) | User-only (No Admin) |
+| **Input** | `UserId` required | `UserId` از Token (خودکار) |
+
+### 2. احراز هویت
+
+**JWT Token Structure:**
+```json
+{
+  "sub": "123",                    // UserId
+  "email": "user@example.com",
+  "phone": "09123456789",
+  "IsSignMainContract": "True",
+  "exp": 1234567890
+}
+```
+
+**استخراج UserId:**
+```csharp
+public class GetMyDataQueryHandler
+{
+    private readonly ICurrentUserService _currentUser;
+    
+    public async Task<Response> Handle(Query request, CancellationToken ct)
+    {
+        var userId = _currentUser.UserId;  // از JWT
+        // Call CMS with userId
+    }
+}
+```
+
+### 3. DTO Mapping Pattern
+
+**CMS DTO (خام):**
+```csharp
+public class CommissionPayoutDto
+{
+    public long Id { get; set; }
+    public long UserId { get; set; }
+    public int WeekNumber { get; set; }
+    public long TotalAmount { get; set; }
+    public CommissionPayoutStatus Status { get; set; }
+    // ... 10 فیلد دیگر
+}
+```
+
+**BFF Response DTO (مشتری‌محور):**
+```csharp
+public class MyCommissionPayoutDto
+{
+    public long Id { get; set; }
+    public string WeekLabel { get; set; }        // "هفته 45 - آذر 1403"
+    public string AmountFormatted { get; set; }  // "1,250,000 تومان"
+    public string StatusText { get; set; }       // "پرداخت شده"
+    public string StatusBadgeColor { get; set; } // "success"
+    public string DatePersian { get; set; }      // "25 آذر 1403"
+}
+```
+
+---
+
+## 📞 مسائل و سوالات
+
+### سوالات باز:
+
+1. **پرداخت دستی پکیج طلایی** (نیازمندی #5):
+   - منظور چیست؟ آیا جدا از فعال‌سازی باشگاه (56M) است؟
+   - آیا در CMS Handler مربوطه وجود دارد؟
+
+2. **فروشگاه "معمولی"** (نیازمندی #4):
+   - چه بهبودهای خاصی مدنظر است؟
+   - آیا Discount Shop جداست یا همان Store معمولی؟
+
+3. **Dashboard "در یک نگاه"** (نیازمندی #3):
+   - آیا `Profile/Index.razor` همان Dashboard است؟
+   - یا نیاز به صفحه جداگانه `/dashboard` داریم؟
+
+4. **گزارش شبکه و کمیسیون** (نیازمندی #6):
+   - چه گزارش‌های دقیقی مدنظر است؟
+   - PDF/Excel export لازم است؟
+
+---
+
+## 📈 معیارهای موفقیت (Success Metrics)
+
+### مرحله 1 (بحرانی):
+- [ ] کاربر بتواند عضو باشگاه شود (پرداخت 56M)
+- [ ] کاربر 3 موجودی کیف‌پول را ببیند (Balance, Network, Discount)
+- [ ] کاربر درخت شبکه واقعی خود را ببیند (نه Mock)
+- [ ] کاربر کمیسیون هفتگی خود را ببیند
+- [ ] کاربر بتواند برداشت کند (WithdrawBalance)
+
+### مرحله 2 (ثانویه):
+- [ ] کاربر از فروشگاه تخفیف خرید کند
+- [ ] کاربر وضعیت وام دایا را ببیند
+- [ ] کاربر پیام‌های عمومی را ببیند
+- [ ] سبد خرید: Delete/Clear کار کند
+
+### مرحله 3 (UI/UX):
+- [ ] تمام صفحات Responsive باشند
+- [ ] Skeleton loaders در همه جا
+- [ ] لینک دعوت (Referral) فعال باشد
+- [ ] نوتیفیکیشن Bell icon در Navbar
+
+---
+
+## 🎉 نتیجه‌گیری
+
+**وضعیت فعلی**: 40% تکمیل (9 ماژول پایه)  
+**هدف**: 95% تکمیل (17 ماژول کامل)  
+**زمان تخمینی**: 4 هفته (3 مرحله اصلی + 1 اختیاری)
+
+**اولویت‌های کلیدی**:
+1. 🔴 ClubMembership + Dashboard (هفته 1)
+2. 🔴 Network + Commission (هفته 2)
+3. 🟡 DiscountShop + Enhancements (هفته 3)
+4. 🟢 UI/UX Improvements (هفته 4)
+
+**نکته مهم**: دقت کنیم که هیچ چیزی را جا نیندازیم و خارج از ساختار حرکت نکنیم ✅
+
+</div>

04-FRONTEND/FrontOffice/progress-report.md

@@ -0,0 +1,210 @@
+<div dir="rtl" align="right">
+
+# 🎉 گزارش پیشرفت FrontOffice.BFF - ۱۴ آذر ۱۴۰۴
+
+## ✅ کارهای انجام شده امروز
+
+### 1️⃣ ClubMembershipCQ Module (کامل)
+```
+✅ Application/ClubMembershipCQ/
+   ✅ Commands/ActivateMyClubMembership/
+      - ActivateMyClubMembershipCommand.cs
+      - ActivateMyClubMembershipCommandHandler.cs
+      - ActivateMyClubMembershipResponseDto.cs
+   ✅ Queries/GetMyClubMembership/
+      - GetMyClubMembershipQuery.cs
+      - GetMyClubMembershipQueryHandler.cs
+      - GetMyClubMembershipResponseDto.cs
+```
+
+### 2️⃣ NetworkMembershipCQ Module (کامل)
+```
+✅ Application/NetworkMembershipCQ/
+   ✅ Queries/GetMyNetworkTree/
+      - GetMyNetworkTreeQuery.cs (MaxDepth: 1-10)
+      - GetMyNetworkTreeQueryHandler.cs
+      - GetMyNetworkTreeResponseDto.cs + NetworkNodeDto
+   ✅ Queries/GetMyNetworkStatistics/
+      - GetMyNetworkStatisticsQuery.cs
+      - GetMyNetworkStatisticsQueryHandler.cs
+      - GetMyNetworkStatisticsResponseDto.cs + LastMemberDto
+```
+
+### 3️⃣ CommissionCQ Module (کامل)
+```
+✅ Application/CommissionCQ/
+   ✅ Queries/GetMyCommissionPayouts/
+      - GetMyCommissionPayoutsQuery.cs (Pagination + Filters)
+      - GetMyCommissionPayoutsQueryHandler.cs
+      - GetMyCommissionPayoutsResponseDto.cs + CommissionPayoutDto
+   ✅ Queries/GetMyWeeklyBalances/
+      - GetMyWeeklyBalancesQuery.cs
+      - GetMyWeeklyBalancesQueryHandler.cs
+      - GetMyWeeklyBalancesResponseDto.cs
+```
+
+### 4️⃣ Infrastructure Updates (کامل)
+```
+✅ IApplicationContractContext.cs
+   - اضافه شد: ClubMemberships property
+   - اضافه شد: NetworkMemberships property
+   - اضافه شد: using statements برای Protobuf
+
+✅ ApplicationContractContext.cs (Implementation)
+   - پیاده‌سازی ClubMemberships getter
+   - پیاده‌سازی NetworkMemberships getter
+```
+
+### 5️⃣ بروزرسانی داکیومنت‌ها
+```
+✅ totalDoc/FrontOffice/FRONTOFFICE-ANALYSIS.md
+   - تغییر وضعیت از 40% به 60% (BFF)
+   - بروزرسانی جدول ماژول‌ها (9→12)
+   - تغییر وضعیت Club/Network/Commission از ❌ به 🟡
+   - اضافه کردن بخش "کارهای انجام شده"
+   - بروزرسانی roadmap با وضعیت فعلی
+```
+
+---
+
+## 📊 وضعیت فعلی پروژه
+
+### BFF Modules (12 ماژول):
+| ردیف | ماژول | وضعیت BFF | وضعیت UI |
+|-----|------|-----------|----------|
+| 1 | CategoryCQ | ✅ کامل | ✅ موجود |
+| 2 | PackageCQ | ✅ کامل | ✅ موجود |
+| 3 | ProductsCQ | ✅ کامل | ✅ موجود |
+| 4 | TransactionCQ | ✅ کامل | ✅ موجود |
+| 5 | UserAddressCQ | ✅ کامل | ✅ موجود |
+| 6 | UserCQ | ✅ کامل | ✅ موجود |
+| 7 | UserOrderCQ | ✅ کامل | ✅ موجود |
+| 8 | UserWalletCQ | ✅ کامل | ✅ موجود |
+| 9 | ShopingCartCQ | ⚠️ ناقص | ✅ موجود |
+| 10 | **🆕 ClubMembershipCQ** | **✅ کامل** | **❌ غایب** |
+| 11 | **🆕 NetworkMembershipCQ** | **✅ کامل** | **⚠️ Mock** |
+| 12 | **🆕 CommissionCQ** | **✅ کامل** | **❌ غایب** |
+
+**آمار BFF**: 60% کامل (11 از 12 کامل)  
+**آمار UI**: 40% کامل (9 از 12)
+
+---
+
+## 🎯 مراحل بعدی (اولویت‌بندی شده)
+
+### فاز A: UI برای ماژول‌های آماده BFF (8-9 روز)
+
+#### 1. Club Pages (2-3 روز)
+```
+[ ] Pages/Club/MembershipPage.razor
+    - نمایش وضعیت عضویت (GetMyClubMembership)
+    - دکمه فعال‌سازی (ActivateMyClubMembership)
+    - Badge Active/Inactive/Trial
+    
+[ ] Components/Club/ActivationButton.razor
+    - فرم پرداخت 56M
+    - اتصال به درگاه
+```
+
+#### 2. Network Pages (2 روز)
+```
+[ ] Update Profile/Tree.razor
+    - حذف Mock data (OrganizationChart)
+    - اتصال به GetMyNetworkTree
+    - Selector عمق (1-10)
+    - Lazy loading
+    
+[ ] Pages/Network/StatsPage.razor
+    - نمایش GetMyNetworkStatistics
+    - تعداد چپ/راست
+    - آخرین عضو
+    - نمودار
+```
+
+#### 3. Commission Pages (3 روز)
+```
+[ ] Pages/Commission/DashboardPage.razor
+    - نمایش GetMyCommissionPayouts
+    - کارت هفته جاری
+    - نمودار روند
+    
+[ ] Pages/Commission/HistoryPage.razor
+    - جدول تاریخچه
+    - فیلتر Status/Week
+    
+[ ] Pages/Commission/WeeklyBalancePage.razor
+    - نمایش GetMyWeeklyBalances
+    - تعادل چپ/راست
+    - Carryover
+```
+
+#### 4. Wallet Update (1 روز)
+```
+[ ] Update Profile/Wallet.razor
+    - نمایش DiscountBalance (کارت زرد)
+    - حذف پیام Mock
+```
+
+---
+
+### فاز B: ماژول‌های ثانویه (1 هفته)
+
+```
+[ ] DiscountShopCQ (BFF + UI)
+[ ] ShopingCartCQ تکمیل (Delete/Clear)
+[ ] DayaLoanCQ (BFF + UI)
+[ ] PublicMessageCQ (BFF + UI)
+```
+
+---
+
+### فاز C: امکانات اضافی (اختیاری)
+
+```
+[ ] NotificationCQ
+[ ] ReferralLinkCQ
+[ ] UI/UX Improvements
+```
+
+---
+
+## 🔑 نکات مهم
+
+### 1. معماری فعلی:
+- ✅ gRPC Auto-register کار می‌کند
+- ✅ IApplicationContractContext آماده است
+- ✅ CurrentUserService برای UserId استفاده می‌شود
+- ✅ DTO Mapping الگوی صحیح دارد
+
+### 2. نیازمندی‌های UI:
+- باید از gRPC Client استفاده کند (مثل BackOffice)
+- باید Protobuf نصب باشد
+- باید MudBlazor components استفاده شود
+
+### 3. تست:
+- هنوز تست نشده (نیاز به build + run)
+- CMS باید در حال اجرا باشد
+- gRPC connection باید فعال باشد
+
+---
+
+## 📝 TODO List بعدی
+
+1. **بررسی Build**: `dotnet build FrontOffice.BFF.sln`
+2. **تست Handlers**: نصب Postman/gRPC Client
+3. **شروع UI Phase A**: Club Pages
+4. **اتصال FrontOffice به BFF**: Config gRPC endpoints
+
+---
+
+## 📈 پیشرفت کلی
+
+**قبل از امروز**: 40% (9 ماژول قدیمی)  
+**بعد از امروز**: 60% BFF (12 ماژول)  
+**هدف نهایی**: 95% (17 ماژول با UI کامل)
+
+**باقی‌مانده**: 
+- UI برای 3 ماژول جدید (Club, Network, Commission)
+- 5 ماژول ثانویه (DiscountShop, DayaLoan, PublicMessage, Notification, Referral)
+
+</div>

04-FRONTEND/FrontOffice/todo-commented-code.md

@@ -0,0 +1,407 @@
+# 🔴 TODO: کدهای کامنت شده که باید تکمیل شوند
+
+> تاریخ: ۱۴ آذر ۱۴۰۴
+> 
+> این فایل لیست کامل کدهایی است که برای Build موفق، موقتا کامنت شده‌اند.
+
+---
+
+## ❌ مشکل اصلی: Protobuf ناقص در FrontOffice.BFF
+
+تمام مشکلات زیر به دلیل **عدم وجود Protobuf packages** برای ماژول‌های جدید است.
+
+---
+
+## 1️⃣ WalletService.cs (4 متد کامنت شده)
+
+📁 مسیر: `/FrontOffice/src/FrontOffice.Main/Utilities/WalletService.cs`
+
+### متد 1: GetBalancesAsync() - خط 27
+```csharp
+// TODO: DiscountBalance will be added in BFF protobuf later
+return new WalletBalances(response.Balance, 0 /* response.DiscountBalance */, response.NetworkBalance);
+```
+
+**مشکل**: `GetUserWalletResponse` در protobuf فعلی `DiscountBalance` ندارد
+
+**راه حل**:
+```
+1. به FrontOffice.BFF.UserWallet.Protobuf بروید
+2. فایل userwallet.proto را باز کنید
+3. به message GetUserWalletResponse اضافه کنید:
+   int64 discount_balance = 3;
+4. Protobuf را rebuild و publish کنید
+5. در WalletService uncomment کنید
+```
+
+---
+
+### متد 2: GetTransactionsAsync() - خط 42-75
+```csharp
+// TODO: Implement when BFF protobuf has GetAllUserWalletChangeLog
+await Task.CompletedTask;
+return new List<WalletTransaction>();
+/*
+var request = new GetAllUserWalletChangeLogRequest();
+// ... کد کامل کامنت شده
+*/
+```
+
+**مشکل**: متد `GetAllUserWalletChangeLog` در `UserWalletContract` وجود ندارد
+
+**راه حل**:
+```
+1. به FrontOffice.BFF.Application/UserWalletCQ بروید
+2. Query جدید بسازید: GetAllUserWalletChangeLog
+   - Request: ReferenceId?, IsIncrease?
+   - Response: List<WalletChangeLogDto>
+3. به userwallet.proto اضافه کنید:
+   rpc GetAllUserWalletChangeLog(GetAllUserWalletChangeLogRequest) returns (GetAllUserWalletChangeLogResponse);
+4. Handler را پیاده کنید با فراخوانی CMS
+5. Protobuf را rebuild/publish کنید
+6. در WalletService uncomment کنید
+```
+
+---
+
+### متد 3: RequestWithdrawalAsync() - خط 107-127
+```csharp
+public async Task<bool> RequestWithdrawalAsync(long payoutId, WithdrawalMethodClient method, string? iban)
+{
+    // TODO: Implement when BFF protobuf has WithdrawBalance
+    await Task.CompletedTask;
+    return false;
+    /*
+    var request = new WithdrawBalanceRequest { ... };
+    await _client.WithdrawBalanceAsync(request);
+    */
+}
+```
+
+**مشکل**: متد `WithdrawBalance` در `UserWalletContract` وجود ندارد
+
+**راه حل**:
+```
+1. به FrontOffice.BFF.Application/UserWalletCQ بروید
+2. Command جدید بسازید: WithdrawBalance
+   - Request: PayoutId, WithdrawalMethod, IbanNumber?
+   - Response: Success, Message
+3. به userwallet.proto اضافه کنید:
+   rpc WithdrawBalance(WithdrawBalanceRequest) returns (WithdrawBalanceResponse);
+4. Handler را پیاده کنید با فراخوانی CMS.WithdrawCommissionBalance
+5. Protobuf را rebuild/publish کنید
+6. در WalletService uncomment کنید
+```
+
+---
+
+### متد 4: GetWithdrawalsAsync() - خط 136-160
+```csharp
+// TODO: Implement when BFF protobuf has GetUserWithdrawals
+await Task.CompletedTask;
+return new List<WalletWithdrawal>();
+/*
+var request = new GetUserWithdrawalsRequest();
+var response = await _client.GetUserWithdrawalsAsync(request);
+*/
+```
+
+**مشکل**: متد `GetUserWithdrawals` در `UserWalletContract` وجود ندارد
+
+**راه حل**:
+```
+1. به FrontOffice.BFF.Application/UserWalletCQ بروید
+2. Query جدید بسازید: GetUserWithdrawals
+   - Request: Status?
+   - Response: List<WithdrawalDto>
+3. به userwallet.proto اضافه کنید:
+   rpc GetUserWithdrawals(GetUserWithdrawalsRequest) returns (GetUserWithdrawalsResponse);
+4. Handler را پیاده کنید با فراخوانی CMS
+5. Protobuf را rebuild/publish کنید
+6. در WalletService uncomment کنید
+```
+
+---
+
+### متد 5: GetWithdrawalSettingsAsync() - خط 163-170
+```csharp
+// TODO: Implement when BFF protobuf has GetWithdrawalSettings
+await Task.CompletedTask;
+return new WithdrawalSettings(1_000_000);
+// var response = await _client.GetWithdrawalSettingsAsync(new Empty());
+```
+
+**مشکل**: متد `GetWithdrawalSettings` در `UserWalletContract` وجود ندارد
+
+**راه حل**:
+```
+1. به FrontOffice.BFF.Application/UserWalletCQ بروید
+2. Query جدید بسازید: GetWithdrawalSettings
+   - Request: Empty
+   - Response: MinWithdrawalAmount
+3. به userwallet.proto اضافه کنید:
+   rpc GetWithdrawalSettings(google.protobuf.Empty) returns (GetWithdrawalSettingsResponse);
+4. Handler را پیاده کنید با فراخوانی CMS settings
+5. Protobuf را rebuild/publish کنید
+6. در WalletService uncomment کنید
+```
+
+---
+
+## 2️⃣ ClubMembershipService.cs (Mock Data)
+
+📁 مسیر: `/FrontOffice/src/FrontOffice.Main/Utilities/ClubMembershipService.cs`
+
+### تمام متدها Mock هستند - خط 14-68
+
+```csharp
+// TODO: Replace with actual gRPC call to BFF
+// var request = new GetMyClubMembershipRequest();
+// var response = await _client.GetMyClubMembershipAsync(request);
+```
+
+**مشکل**: هیچ gRPC client وجود ندارد
+
+**راه حل**:
+```
+1. FrontOffice.BFF.ClubMembership.Protobuf ساخته شود
+2. به ConfigureServices.cs اضافه شود:
+   services.AddScoped(CreateAuthenticatedClient<ClubMembershipContract.ClubMembershipContractClient>);
+3. در ClubMembershipService inject شود:
+   private readonly ClubMembershipContract.ClubMembershipContractClient _client;
+4. متدهای Mock جایگزین شوند با gRPC calls
+```
+
+---
+
+## 3️⃣ NetworkMembershipService.cs (Mock Data)
+
+📁 مسیر: `/FrontOffice/src/FrontOffice.Main/Utilities/NetworkMembershipService.cs`
+
+### تمام متدها Mock هستند - خط 14-105
+
+```csharp
+// TODO: Replace with actual gRPC call to BFF
+// var request = new GetMyNetworkTreeRequest { MaxDepth = maxDepth };
+// var response = await _client.GetMyNetworkTreeAsync(request);
+```
+
+**مشکل**: هیچ gRPC client وجود ندارد
+
+**راه حل**:
+```
+1. FrontOffice.BFF.NetworkMembership.Protobuf ساخته شود
+2. به ConfigureServices.cs اضافه شود:
+   services.AddScoped(CreateAuthenticatedClient<NetworkMembershipContract.NetworkMembershipContractClient>);
+3. در NetworkMembershipService inject شود
+4. متدهای Mock جایگزین شوند با gRPC calls
+```
+
+---
+
+## 4️⃣ CommissionService.cs (Mock Data)
+
+📁 مسیر: `/FrontOffice/src/FrontOffice.Main/Utilities/CommissionService.cs`
+
+### تمام متدها Mock هستند - خط 14-119
+
+```csharp
+// TODO: Replace with actual gRPC call to BFF
+// var request = new GetMyCommissionPayoutsRequest { ... };
+// var response = await _client.GetMyCommissionPayoutsAsync(request);
+```
+
+**مشکل**: هیچ gRPC client وجود ندارد
+
+**راه حل**:
+```
+1. FrontOffice.BFF.Commission.Protobuf ساخته شود
+2. به ConfigureServices.cs اضافه شود:
+   services.AddScoped(CreateAuthenticatedClient<CommissionContract.CommissionContractClient>);
+3. در CommissionService inject شود
+4. متدهای Mock جایگزین شوند با gRPC calls
+```
+
+---
+
+## 📋 اولویت‌بندی کارها
+
+### فاز 1: UserWalletCQ (بالاترین اولویت) ⚡
+این ماژول قبلا شروع شده ولی ناقص است:
+
+1. ✅ `GetUserWallet` موجود است
+2. ❌ `DiscountBalance` در Response نیست → **اضافه شود**
+3. ❌ `GetAllUserWalletChangeLog` وجود ندارد → **بساز**
+4. ❌ `WithdrawBalance` وجود ندارد → **بساز**
+5. ❌ `GetUserWithdrawals` وجود ندارد → **بساز**
+6. ❌ `GetWithdrawalSettings` وجود ندارد → **بساز**
+
+**زمان تخمینی**: 4-6 ساعت
+
+---
+
+### فاز 2: Protobuf Packages برای ماژول‌های جدید
+
+#### A. ClubMembershipCQ ✨
+```
+پوشه: FrontOffice.BFF/src/FrontOffice.BFF.ClubMembership.Protobuf/
+فایل: clubmembership.proto
+
+Messages:
+- GetMyClubMembershipRequest (empty)
+- GetMyClubMembershipResponse (UserId, IsActive, Status, DaysRemaining)
+- ActivateMyClubMembershipRequest (PackageId, ActivationCode, DurationMonths)
+- ActivateMyClubMembershipResponse (Success, Message, ActivationDate, AmountPaid)
+
+Service:
+service ClubMembershipContract {
+  rpc GetMyClubMembership(GetMyClubMembershipRequest) returns (GetMyClubMembershipResponse);
+  rpc ActivateMyClubMembership(ActivateMyClubMembershipRequest) returns (ActivateMyClubMembershipResponse);
+}
+```
+
+**Handler Location**: `FrontOffice.BFF.Application/ClubMembershipCQ/`
+- ✅ Queries/GetMyClubMembership (موجود است)
+- ✅ Commands/ActivateMyClubMembership (موجود است)
+
+**زمان تخمینی**: 2 ساعت (فقط Protobuf + publish)
+
+---
+
+#### B. NetworkMembershipCQ 🌳
+```
+پوشه: FrontOffice.BFF/src/FrontOffice.BFF.NetworkMembership.Protobuf/
+فایل: networkmembership.proto
+
+Messages:
+- GetMyNetworkTreeRequest (MaxDepth)
+- NetworkNodeDto (UserId, FullName, Mobile, Avatar, Position, LeftChild, RightChild, Level)
+- GetMyNetworkTreeResponse (RootNode, TotalMembers, CurrentDepth)
+- GetMyNetworkStatisticsRequest (empty)
+- GetMyNetworkStatisticsResponse (LeftLegCount, RightLegCount, TotalMembers, TreeDepth, WeakerLeg, LastMember)
+
+Service:
+service NetworkMembershipContract {
+  rpc GetMyNetworkTree(GetMyNetworkTreeRequest) returns (GetMyNetworkTreeResponse);
+  rpc GetMyNetworkStatistics(GetMyNetworkStatisticsRequest) returns (GetMyNetworkStatisticsResponse);
+}
+```
+
+**Handler Location**: `FrontOffice.BFF.Application/NetworkMembershipCQ/`
+- ✅ Queries/GetMyNetworkTree (موجود است)
+- ✅ Queries/GetMyNetworkStatistics (موجود است)
+
+**زمان تخمینی**: 2-3 ساعت (Protobuf + publish)
+
+---
+
+#### C. CommissionCQ 💰
+```
+پوشه: FrontOffice.BFF/src/FrontOffice.BFF.Commission.Protobuf/
+فایل: commission.proto
+
+Messages:
+- GetMyCommissionPayoutsRequest (WeekNumber?, Status?, PageNumber, PageSize)
+- CommissionPayoutDto (Id, WeekNumber, WeekLabel, BalancesEarned, TotalAmount, AmountFormatted, Status, StatusBadgeColor, DatePersian)
+- GetMyCommissionPayoutsResponse (Payouts[], TotalCount, PageNumber, PageSize)
+- GetMyWeeklyBalancesRequest (WeekNumber?)
+- GetMyWeeklyBalancesResponse (WeekNumber, WeekLabel, LeftBalance, RightBalance, MinBalance, BalanceCount, CalculatedCommission, LeftCarryover, RightCarryover, StartDate, EndDate)
+
+Service:
+service CommissionContract {
+  rpc GetMyCommissionPayouts(GetMyCommissionPayoutsRequest) returns (GetMyCommissionPayoutsResponse);
+  rpc GetMyWeeklyBalances(GetMyWeeklyBalancesRequest) returns (GetMyWeeklyBalancesResponse);
+}
+```
+
+**Handler Location**: `FrontOffice.BFF.Application/CommissionCQ/`
+- ✅ Queries/GetMyCommissionPayouts (موجود است)
+- ✅ Queries/GetMyWeeklyBalances (موجود است)
+
+**زمان تخمینی**: 3 ساعت (Protobuf + publish)
+
+---
+
+## 🔧 دستورات لازم برای هر Protobuf Package
+
+### ساخت Package:
+```bash
+cd FrontOffice.BFF/src/FrontOffice.BFF.ClubMembership.Protobuf
+dotnet pack -c Release
+```
+
+### Publish به NuGet/Local:
+```bash
+# اگر NuGet Server دارید:
+dotnet nuget push bin/Release/Foursat.FrontOffice.BFF.ClubMembership.Protobuf.0.0.1.nupkg -s http://your-nuget-server
+
+# یا اضافه به Local Source:
+dotnet nuget add source /path/to/packages --name LocalPackages
+```
+
+### استفاده در FrontOffice.Main:
+```xml
+<PackageReference Include="Foursat.FrontOffice.BFF.ClubMembership.Protobuf" Version="0.0.1" />
+<PackageReference Include="Foursat.FrontOffice.BFF.NetworkMembership.Protobuf" Version="0.0.1" />
+<PackageReference Include="Foursat.FrontOffice.BFF.Commission.Protobuf" Version="0.0.1" />
+```
+
+---
+
+## ⏱️ تخمین زمان کلی
+
+| مرحله | زمان | اولویت |
+|-------|------|--------|
+| UserWalletCQ تکمیل | 4-6 ساعت | 🔴 بالا |
+| ClubMembership Protobuf | 2 ساعت | 🟡 متوسط |
+| NetworkMembership Protobuf | 2-3 ساعت | 🟡 متوسط |
+| Commission Protobuf | 3 ساعت | 🟡 متوسط |
+| FrontOffice integration | 2 ساعت | 🟢 پایین |
+| **جمع کل** | **13-16 ساعت** | |
+
+---
+
+## 📝 نکات مهم
+
+1. **همه Handler ها در BFF آماده هستند** - فقط Protobuf لازم است
+2. **WalletService اولویت دارد** - زیرا صفحه Wallet قبلا موجود بود
+3. **Mock Data فعلا کافی است** - برای Test UI
+4. **بعد از Protobuf Publish**، فقط uncomment کافی است
+
+---
+
+## ✅ Checklist اجرایی
+
+### مرحله 1: UserWalletCQ
+- [ ] DiscountBalance به GetUserWalletResponse اضافه شود
+- [ ] Query: GetAllUserWalletChangeLog ساخته شود
+- [ ] Command: WithdrawBalance ساخته شود
+- [ ] Query: GetUserWithdrawals ساخته شود
+- [ ] Query: GetWithdrawalSettings ساخته شود
+- [ ] Protobuf rebuild/publish شود
+- [ ] WalletService uncomment شود
+
+### مرحله 2: ClubMembership Protobuf
+- [ ] پوشه Protobuf ساخته شود
+- [ ] clubmembership.proto نوشته شود
+- [ ] csproj تنظیم شود
+- [ ] Build و publish شود
+- [ ] به FrontOffice.Main اضافه شود
+- [ ] ClubMembershipService uncomment شود
+
+### مرحله 3: NetworkMembership Protobuf
+- [ ] پوشه Protobuf ساخته شود
+- [ ] networkmembership.proto نوشته شود
+- [ ] Build و publish شود
+- [ ] NetworkMembershipService uncomment شود
+
+### مرحله 4: Commission Protobuf
+- [ ] پوشه Protobuf ساخته شود
+- [ ] commission.proto نوشته شود
+- [ ] Build و publish شود
+- [ ] CommissionService uncomment شود
+
+---
+
+**📅 آخرین بروزرسانی**: ۱۴ آذر ۱۴۰۴
+**👤 توسط**: GitHub Copilot (Claude Sonnet 4.5)