docs: add session log for 2026-05-13 (guest browsing + top-seller landing sections)

Co-authored-by: Cursor <cursoragent@cursor.com>
Add comprehensive database integrity audit report and fix critical bugs in commission pool charging flow
2026-05-13 19:50:15 +03:30 · 2026-05-01 00:07:25 +03:30 · 2026-02-27 22:33:35 +03:30 · 2026-02-27 20:56:00 +03:30 · 2026-02-27 09:05:50 +03:30 · 2026-02-27 06:50:07 +03:30
119 changed files with 11115 additions and 223802 deletions
@@ -1,492 +0,0 @@
-# 📚 FourSat Project - فهرست جامع مستندات (نسخه تجمیع شده)
-
-> **آخرین بروزرسانی**: ۲۸ آذر ۱۴۰۴ (18 دسامبر 2025)  
-> **وضعیت**: ✅ بروزرسانی شده با Session امروز  
-> **تحلیلگر**: GitHub Copilot (Claude Opus 4.5)
-
---
-
-## 🆕 تغییرات امروز (۲۸ آذر) - Session 2
-
-### ✅ سیستم مدیریت موجودی محصولات
- **CMS**: چک موجودی در `SubmitShopBuyOrderCommandHandler`
- **کاهش خودکار موجودی**: بعد از تکمیل سفارش `RemainingCount` کم می‌شود
- **افزایش SaleCount**: همزمان با کاهش موجودی
- **FrontOffice**: نمایش وضعیت موجودی در صفحه محصول
- **محدودیت خرید**: حداکثر تعداد = موجودی انبار
-
-### ✅ ویژگی‌های باشگاه مشتریان (ClubFeatures)
- **حذف فیلدهای اضافی**: `DetailedDescriptionHtml`, `Icon`, `Color` از `UserClubFeature`
- **معماری صحیح**: داده‌های قالب در `ClubFeature`، داده‌های کاربر در `UserClubFeature`
- **FeaturesPage**: بازطراحی با لیست ساده (آیکون تیک + عنوان + دکمه جزئیات)
- **MembershipPage**: مزایای عضویت اصلاح شده (کیف پول ۵۶ میلیون، شبکه بازاریابی، جذب زیرمجموعه)
-
-### ✅ بهبود مدال آدرس‌ها
- **رفع خطای Snackbar**: حذف inject تکراری (global در `_Imports.razor`)
- **رفع NullReferenceException**: اضافه کردن null check برای `dialog.Result`
-
-### ✅ VAT Service
- **نرخ پیش‌فرض**: 9.99% برای تشخیص داده سرور از local
- **استفاده یکپارچه**: در تمام صفحات از `VATService` استفاده می‌شود
-
-### ✅ CartService Authentication
- **EnsureInitializedAsync**: لود سبد خرید فقط برای کاربران لاگین‌شده
- **IsAuthenticatedAsync**: چک توکن در LocalStorage
-
---
-
-## 🆕 تغییرات قبلی (۲۸ آذر) - Session 1
-
-### ✅ نمودار درختی شبکه با d3-org-chart (FrontOffice)
- **کتابخانه**: d3-org-chart v3 + d3.js v7 + d3-flextree
- **OrganizationChart.razor**: بازنویسی کامل با JS Interop
- **امکانات**:
-  - نمایش درختی باینری شبکه
-  - کلیک روی نود → نمایش زیرمجموعه‌ها
-  - دکمه‌های بازگشت و "درخت من"
-  - انتخاب عمق درخت (2-10 سطح)
-  - طراحی ریسپانسیو با MudBlazor
-
-### ✅ API جدید: GetSubordinateTree
- **Proto**: `GetSubordinateTreeRequest` در `networkmembership.proto`
- **BFF Handler**: `GetSubordinateTreeQueryHandler`
- **Frontend Service**: `GetSubordinateTreeAsync(targetUserId, maxDepth)`
-
-### ✅ بهبود Entity Configuration برای فارسی (CMS)
- **Geography Tables**: Country, State, City
- **تغییرات**: `nvarchar` با `Persian_100_CI_AI` collation
- **Migration**: `FixPersianCollation_Geography`
-
---
-
-## 🆕 تغییرات قبلی (۲۲ آذر)
-
-### ✅ تبدیل تاریخ‌ها به شمسی در UI
- **PersianDateTimeService**: سرویس تبدیل تاریخ میلادی به شمسی
- **3 صفحه آپدیت شده**: Dashboard, UserPayouts, WorkerControl
- **معماری**: تبدیل فقط در لایه نمایش، Backend میلادی باقی ماند
-
-### ✅ بهبود سرویس اطلاعات شبکه
- **28+ فیلد جدید** در GetUserNetworkPosition
- **آمار کامل شبکه**: TotalNetworkSize, MaxDepth, ActiveMembers
- **آمار مالی**: کمیسیون کسب شده، پرداخت شده، در انتظار
- **UI بازنویسی شده**: 6 کارت اطلاعاتی با آیکون و رنگ‌بندی
-
-### ✅ یکپارچه‌سازی محاسبه شماره هفته
- **Saturday-based**: همه سیستم‌ها از شنبه شروع می‌کنند
- **C# & SQL هماهنگ**: الگوریتم یکسان در GetWeekNumber
- **رفع Bug**: هفته 50 → هفته 49 (صحیح)
-
-**📄 مستند کامل**: [SESSION-2025-12-12-PERSIAN-DATE-AND-NETWORK-INFO-IMPROVEMENTS.md](SESSION-2025-12-12-PERSIAN-DATE-AND-NETWORK-INFO-IMPROVEMENTS.md)
-
---
-
-## 📊 وضعیت کلی پروژه (بروزرسانی لحظه‌ای)
-
-### **بررسی صحت مستندات موجود:**
-
-#### ✅ مستندات معتبر و به‌روز:
- `CMS/implementation-progress.md` ✅ (3060 خط - تا 12 دسامبر 2025)
-  - Phase 9: Club Discount Shop ✅ Complete (100%)
-  - Phase 12: Package Purchase System ✅ Complete (100%)
-  - **بیلد موفق**: 0 error, 465 warnings
-  - **جدید**: GetUserNetworkPosition با 42 فیلد
-  
- `BackOffice/development-plan.md` ✅ (1462 خط - 12 دسامبر 2025)
-  - 23 صفحه UI کامل
-  - 35 Handler در BFF
-  - **جدید**: PersianDateTimeService برای نمایش شمسی
-  - **Production Ready**: 100%
-  
- `SESSION-2025-12-12-PERSIAN-DATE-AND-NETWORK-INFO-IMPROVEMENTS.md` ⭐ جدید
-  - تبدیل تاریخ شمسی (3 صفحه)
-  - بهبود سرویس شبکه (28+ فیلد)
-  - یکپارچه‌سازی محاسبه هفته
-
-#### ⚠️ مستندات نیاز به بروزرسانی:
- `REMAINING-TASKS-CONSOLIDATED.md` - آخرین بروزرسانی: 2 دسامبر
-  - **نیاز**: بروزرسانی با Phase 9 و 12
-  - **نیاز**: افزودن TODO های FrontOffice
-
- `INDEX.md` - آخرین بروزرسانی: 1 دسامبر
-  - **نیاز**: افزودن اسناد FrontOffice جدید
-  - **نیاز**: بروزرسانی وضعیت Phase ها
-
-#### 🔴 مستندات منسوخ/تکراری:
- `REMAINING-TASKS.md` ❌ (خود این فایل می‌گوید منسوخ است)
-  - محتوا مشابه REMAINING-TASKS-CONSOLIDATED.md
-  - **اقدام**: انتقال به ARCHIVE
-
---
-
-## 🗂️ ساختار جدید پیشنهادی
-
-```
-totalDoc/
-├── 00-INDEX.md                          # این فایل (فهرست اصلی)
-├── 01-BUSINESS/                         # 📊 منطق تجاری
-│   ├── club-membership-business.md      # باشگاه مشتریان
-│   ├── network-binary-tree.md           # شبکه دودویی
-│   ├── commission-system.md             # سیستم کمیسیون
-│   ├── discount-shop-business.md        # فروشگاه تخفیف
-│   ├── package-purchase-system.md       # خرید پکیج طلایی
-│   └── daya-loan-integration.md         # قرض‌الحسنه دایا
-│
-├── 02-ARCHITECTURE/                     # 🏗️ معماری
-│   ├── system-overview.md               # نمای کلی سیستم
-│   ├── microservices-structure.md       # ساختار Microservice
-│   ├── bff-pattern.md                   # الگوی BFF
-│   └── database-schema.md               # طراحی دیتابیس
-│
-├── 03-BACKEND/                          # ⚙️ Backend
-│   ├── CMS/
-│   │   ├── README.md                    # نمای کلی + Quick Start
-│   │   ├── implementation-status.md     # وضعیت پیاده‌سازی (95%)
-│   │   ├── api-coverage.md              # پوشش API
-│   │   └── entity-guide.md              # راهنمای Entity ها
-│   ├── BackOffice.BFF/
-│   │   ├── README.md                    # نمای کلی
-│   │   ├── handlers-status.md           # 35 Handler
-│   │   └── cms-integration.md           # یکپارچه‌سازی با CMS
-│   └── FrontOffice.BFF/
-│       ├── README.md                    # نمای کلی
-│       ├── handlers-status.md           # 12 Handler
-│       └── protobuf-mismatch.md         # مغایرت Proto با CMS
-│
-├── 04-FRONTEND/                         # 🎨 Frontend
-│   ├── BackOffice/
-│   │   ├── README.md                    # نمای کلی (23 صفحه)
-│   │   └── ui-status.md                 # وضعیت صفحات
-│   └── FrontOffice/
-│       ├── README.md                    # نمای کلی (24 صفحه)
-│       ├── ui-pages-guide.md            # راهنمای صفحات
-│       └── todo-commented-code.md       # کدهای کامنت شده
-│
-├── 05-TASKS/                            # ✅ وظایف
-│   ├── CURRENT-SPRINT.md                # اسپرینت جاری
-│   ├── BACKLOG.md                       # کارهای آینده
-│   ├── COMPLETED.md                     # انجام شده
-│   └── BLOCKERS.md                      # موانع
-│
-├── 06-DEPLOYMENT/                       # 🚀 استقرار
-│   ├── quick-start.md                   # راهنمای شروع سریع
-│   ├── delivery-readiness.md            # آمادگی تحویل
-│   └── monitoring-alerts.md             # مانیتورینگ و هشدارها
-│
-└── 99-ARCHIVE/                          # 📦 آرشیو
-    ├── ARCHIVE-INDEX.md                 # فهرست آرشیو با دلیل
-    └── old-docs/                        # اسناد قدیمی
-```
-
---
-
-## 📋 گزارش تحلیل اولیه
-
-### 1️⃣ اسناد موجود (42 فایل .md)
-
-#### دسته‌بندی بر اساس موضوع:
-
-**A. Business Logic (8 فایل):**
- ✅ `CMS/network-club-commission-system-v1.1.md` (آخرین نسخه)
- ⚠️ `CMS/network-club-commission-system.md` (نسخه قدیمی - **آرشیو**)
- ✅ `CMS/discount-shop-system.md`
- ✅ `CMS/package-purchase-system.md`
- ✅ `CMS/balance-calculation-carryover-logic.md`
- ✅ `CMS/daya-loan-integration.md`
- ✅ `CMS/manual-payment-system.md`
- ✅ `CMS/binary-tree-registration-guide.md`
-
-**B. Implementation Status (5 فایل):**
- ✅ `CMS/implementation-progress.md` (اصلی - 3060 خط)
- ⚠️ `CMS/implementation-progress-fa.md` (تکراری - **ادغام**)
- ✅ `BackOffice/development-plan.md` (1462 خط)
- ✅ `FrontOffice/README.md` (جدید)
- ✅ `FrontOffice/BFF-CMS-PROTOBUF-MISMATCH-ANALYSIS.md`
-
-**C. Configuration & Guide (6 فایل):**
- ✅ `CMS/email-sms-configuration-guide.md`
- ✅ `CMS/migration-network-parent-guide.md`
- ✅ `CMS/payment-gateway-integration.md`
- ✅ `CMS/payment-architecture-pyms.md`
- ✅ `BackOffice.BFF/cms-integration.md`
- ✅ `BackOffice.BFF/discount-shop-integration-plan.md`
-
-**D. Analysis & Reports (5 فایل):**
- ✅ `CMS/ANALYSIS-CONTRADICTIONS-AND-ISSUES.md`
- ⚠️ `CMS/monitoring-alerts-implementation-report.md` (تکراری)
- ⚠️ `CMS/monitoring-alerts-consolidated-report.md` (ادغام شده)
- ✅ `FrontOffice/FRONTOFFICE-ANALYSIS.md`
- ✅ `FrontOffice/PROGRESS-REPORT-1404-09-14.md`
-
-**E. Tasks & Planning (4 فایل):**
- ⚠️ `REMAINING-TASKS.md` ❌ (منسوخ)
- ✅ `REMAINING-TASKS-CONSOLIDATED.md` (اصلی)
- ✅ `BUSINESS-VERIFICATION-TEMPLATE.md`
- ✅ `DELIVERY-READINESS-REPORT.md`
-
-**F. General (5 فایل):**
- ⚠️ `README.md` (ساده - نیاز به بروزرسانی)
- ⚠️ `INDEX.md` (نیاز به بروزرسانی)
- ✅ `QUICK-START-DEVELOPMENT.md`
- ✅ `CMS-API-COVERAGE.md`
- ✅ `BACKOFFICE-UI-STATUS.md`
-
-**G. Others (9 فایل):**
- `BackOffice/README.md`
- `BackOffice.BFF/README.md`
- `FrontOffice.BFF/README.md`
- `FrontOffice/TODO-COMMENTED-CODE.md`
- `FrontOffice/mudblazor_classes.md`
- `CMS/README.md`
- `CMS/cms-data-and-business.md`
- `CMS/ENTITY-NAMING-REFACTORING-PLAN.md`
- `BackOffice.BFF/.github/git-commit-instructions.md`
-
---
-
-### 2️⃣ یافته‌های کلیدی از بررسی
-
-#### ✅ موارد تایید شده:
-
-1. **CMS: 95% تکمیل**
-   - Phase 1-12 تکمیل شده (به جز Testing)
-   - 0 خطا در Build
-   - Phase 9 (Discount Shop) ✅
-   - Phase 12 (Package Purchase) ✅
-
-2. **BackOffice: 100% Production Ready**
-   - 23 صفحه UI کامل
-   - 35 Handler در BFF
-   - 5 gRPC Service
-
-3. **FrontOffice: 60% BFF / 40% UI**
-   - 12 Handler در BFF (3 جدید امروز)
-   - 24 صفحه UI موجود
-   - **Gap**: UI برای Club/Network/Commission
-
-#### ⚠️ موارد نیازمند توجه:
-
-1. **مستندات تکراری**:
-   - `implementation-progress.md` (EN) vs `implementation-progress-fa.md` (FA)
-   - `monitoring-alerts-*.md` (2 نسخه)
-   - `network-club-commission-system.md` vs `v1.1.md`
-
-2. **TODO های پراکنده**:
-   - در `FrontOffice/TODO-COMMENTED-CODE.md`: 5 متد کامنت شده
-   - در `FrontOffice.BFF/`: 27 Handler TODO
-   - در `REMAINING-TASKS-CONSOLIDATED.md`: Task ها قدیمی
-
-3. **اسناد بدون تاریخ**:
-   - برخی فایل‌ها تاریخ آخرین بروزرسانی ندارند
-   - نیاز به Metadata یکپارچه
-
---
-
-### 3️⃣ اولویت‌های تجمیع
-
-#### فاز 1: تجمیع Business Logic (اولویت بالا 🔴)
-```
-[ ] ادغام network-club-commission-system.md + v1.1.md
-    → 01-BUSINESS/network-commission-system.md (نسخه نهایی)
-
-[ ] استخراج Club از implementation-progress.md
-    → 01-BUSINESS/club-membership-business.md
-
-[ ] استخراج Discount Shop
-    → 01-BUSINESS/discount-shop-business.md
-
-[ ] استخراج Package Purchase
-    → 01-BUSINESS/package-purchase-system.md
-
-[ ] نگه‌داشتن:
-    - daya-loan-integration.md
-    - balance-calculation-carryover-logic.md
-    - manual-payment-system.md
-```
-
-#### فاز 2: تجمیع Backend Docs (اولویت بالا 🔴)
-```
-[ ] CMS/
-    - implementation-progress.md → implementation-status.md
-    - ادغام implementation-progress-fa.md
-    - cms-data-and-business.md → entity-guide.md
-    - CMS-API-COVERAGE.md → api-coverage.md
-
-[ ] BackOffice.BFF/
-    - development-plan.md → handlers-status.md
-    - cms-integration.md (بدون تغییر)
-
-[ ] FrontOffice.BFF/
-    - README.md (جدید)
-    - BFF-CMS-PROTOBUF-MISMATCH-ANALYSIS.md → protobuf-mismatch.md
-```
-
-#### فاز 3: تجمیع Frontend Docs (اولویت متوسط 🟡)
-```
-[ ] BackOffice/
-    - BACKOFFICE-UI-STATUS.md → ui-status.md
-    - README.md (به‌روزرسانی)
-
-[ ] FrontOffice/
-    - README.md (جدید - امروز)
-    - FRONTOFFICE-ANALYSIS.md → ui-analysis.md
-    - TODO-COMMENTED-CODE.md (بدون تغییر)
-```
-
-#### فاز 4: تجمیع Tasks (اولویت بالا 🔴)
-```
-[ ] CURRENT-SPRINT.md (جدید)
-    - استخراج از REMAINING-TASKS-CONSOLIDATED.md
-    - TODO های فعال FrontOffice
-    - TODO های باقی‌مانده CMS
-
-[ ] BACKLOG.md
-    - Feature های آینده (RBAC, VAT, etc.)
-    - بهبودهای اختیاری
-
-[ ] COMPLETED.md
-    - Phase 1-12 CMS
-    - BackOffice UI (23 صفحه)
-    - FrontOffice BFF (12 Handler)
-```
-
-#### فاز 5: آرشیو (اولویت پایین 🟢)
-```
-[ ] انتقال به 99-ARCHIVE/:
-    - REMAINING-TASKS.md (منسوخ)
-    - network-club-commission-system.md (نسخه قدیمی)
-    - implementation-progress-fa.md (ادغام شد)
-    - monitoring-alerts-implementation-report.md (ادغام شد)
-    - PROGRESS-REPORT-1404-09-14.md (گزارش موقت)
-```
-
---
-
-## 🔍 صحت‌سنجی محتوا (Validation)
-
-### چک‌لیست برای هر سند:
-
-```
-✅ implementation-progress.md:
-    - تاریخ: 2024-12-04 ✅
-    - Phase 9: Complete ✅
-    - Phase 12: Complete ✅
-    - Build Status: 0 error ✅
-    - **نتیجه**: معتبر و به‌روز
-
-✅ development-plan.md:
-    - تاریخ: 2025-12-01 ✅
-    - 23 صفحه: تایید شده ✅
-    - 35 Handler: تایید شده ✅
-    - **نتیجه**: معتبر و به‌روز
-
-✅ FrontOffice/README.md:
-    - تاریخ: امروز ✅
-    - 24 صفحه: تایید شده ✅
-    - 12 Handler: تایید شده ✅
-    - Build: 0 error ✅
-    - **نتیجه**: معتبر و به‌روز
-
-⚠️ REMAINING-TASKS-CONSOLIDATED.md:
-    - تاریخ: 2024-12-02 ⚠️
-    - Phase 9: ذکر نشده ❌
-    - Phase 12: ذکر نشده ❌
-    - **نتیجه**: نیاز به بروزرسانی
-
-⚠️ INDEX.md:
-    - تاریخ: 2025-12-01 ⚠️
-    - FrontOffice docs: ناقص ❌
-    - **نتیجه**: نیاز به بروزرسانی
-```
-
---
-
-## 📊 آمار نهایی
-
-### اسناد موجود:
- **کل**: 42 فایل .md
- **معتبر**: 32 فایل ✅
- **نیاز به بروزرسانی**: 5 فایل ⚠️
- **منسوخ/تکراری**: 5 فایل ❌
-
-### پس از تجمیع (تخمین):
- **01-BUSINESS**: 6 فایل
- **02-ARCHITECTURE**: 4 فایل
- **03-BACKEND**: 9 فایل (3 + 3 + 3)
- **04-FRONTEND**: 6 فایل (3 + 3)
- **05-TASKS**: 4 فایل
- **06-DEPLOYMENT**: 3 فایل
- **99-ARCHIVE**: 5 فایل
-
-**جمع جدید**: ~30-35 فایل فعال
-
---
-
-## ⏱️ تخمین زمان تجمیع کامل
-
-| فاز | مدت زمان | وضعیت |
-|-----|---------|-------|
-| فاز 1: Business Logic | 3-4 ساعت | ⏳ در انتظار |
-| فاز 2: Backend Docs | 2-3 ساعت | ⏳ در انتظار |
-| فاز 3: Frontend Docs | 2 ساعت | ⏳ در انتظار |
-| فاز 4: Tasks | 2-3 ساعت | ⏳ در انتظار |
-| فاز 5: آرشیو | 1 ساعت | ⏳ در انتظار |
-| فاز 6: INDEX جامع | 1-2 ساعت | ⏳ در انتظار |
-| **جمع کل** | **11-15 ساعت** | |
-
---
-
-## 🚀 مراحل بعدی پیشنهادی
-
-### مرحله A: تایید ساختار (15 دقیقه)
-```
-[ ] بررسی ساختار پیشنهادی (01-BUSINESS, 02-ARCHITECTURE, ...)
-[ ] تایید نام‌گذاری پوشه‌ها
-[ ] تایید اولویت‌بندی
-```
-
-### مرحله B: شروع تجمیع (3 ساعت)
-```
-[ ] فاز 1: Business Logic
-[ ] فاز 2: Backend Docs (CMS)
-```
-
-### مرحله C: ادامه تجمیع (4 ساعت)
-```
-[ ] فاز 2: Backend Docs (BFFs)
-[ ] فاز 3: Frontend Docs
-```
-
-### مرحله D: TODO ها (3 ساعت)
-```
-[ ] فاز 4: Tasks (CURRENT-SPRINT, BACKLOG, COMPLETED)
-[ ] بروزرسانی با TODO های FrontOffice
-```
-
-### مرحله E: نهایی‌سازی (2 ساعت)
-```
-[ ] فاز 5: آرشیو
-[ ] فاز 6: INDEX جامع با لینک‌ها
-[ ] تست تمام لینک‌ها
-```
-
---
-
-## ❓ سوالات برای تایید
-
-قبل از ادامه، لطفا تایید کنید:
-
-1. ✅ آیا ساختار پیشنهادی (01-BUSINESS, ..., 99-ARCHIVE) مناسب است؟
-2. ✅ آیا اولویت‌بندی (Business → Backend → Frontend → Tasks) درست است؟
-3. ✅ آیا فایل‌های شناسایی شده برای آرشیو صحیح هستند؟
-4. ✅ آیا می‌خواهید همه را همین الان انجام دهم یا گام به گام؟
-
---
-
-**📝 نتیجه**: 
-
-این سند یک نقشه راه کامل برای تجمیع و بازسازی مستندات است. 
-پس از تایید شما، من می‌توانم شروع به اجرای مرحله به مرحله کنم.
-
-**منتظر دستور شما هستم** 🎯
-
@@ -1,290 +0,0 @@
-# 📚 FourSat Project - فهرست جامع مستندات
-
-> **نسخه**: 2.1  
-> **آخرین بروزرسانی**: ۲۹ آذر ۱۴۰۴ (December 19, 2025)  
-> **وضعیت**: ✅ تجمیع و بازسازی کامل
-
---
-
-## 🎯 راهنمای سریع (Quick Navigation)
-
-### برای توسعه‌دهندگان:
- 🚀 **شروع سریع**: [`06-DEPLOYMENT/quick-start.md`](06-DEPLOYMENT/quick-start.md)
- 📋 **کارهای جاری**: [`05-TASKS/CURRENT-SPRINT.md`](05-TASKS/CURRENT-SPRINT.md)
- 🐛 **TODO های کد**: [`04-FRONTEND/FrontOffice/todo-commented-code.md`](04-FRONTEND/FrontOffice/todo-commented-code.md)
-
-### برای معماران:
- 🏗️ **معماری سیستم**: [`02-ARCHITECTURE/`](02-ARCHITECTURE/)
- 📊 **Business Logic**: [`01-BUSINESS/`](01-BUSINESS/)
-
-### برای مدیران:
- ✅ **وضعیت تحویل**: [`06-DEPLOYMENT/delivery-readiness.md`](06-DEPLOYMENT/delivery-readiness.md)
- 📈 **گزارش پیشرفت**: [`03-BACKEND/CMS/implementation-status.md`](03-BACKEND/CMS/implementation-status.md)
-
---
-
-## 📊 وضعیت کلی پروژه
-
-### Backend Services:
-| سرویس | وضعیت | تکمیل | فایل مرجع |
-|-------|------|------|-----------|
-| **CMS Microservice** | ✅ Production Ready | 95% | [`03-BACKEND/CMS/implementation-status.md`](03-BACKEND/CMS/implementation-status.md) |
-| **BackOffice.BFF** | ✅ Production Ready | 100% | [`03-BACKEND/BackOffice.BFF/handlers-status.md`](03-BACKEND/BackOffice.BFF/handlers-status.md) |
-| **FrontOffice.BFF** | 🚧 In Progress | 60% | [`03-BACKEND/FrontOffice.BFF/README.md`](03-BACKEND/FrontOffice.BFF/README.md) |
-
-### Frontend Applications:
-| اپلیکیشن | وضعیت | تکمیل | فایل مرجع |
-|---------|------|------|-----------|
-| **BackOffice UI** | ✅ Production Ready | 100% | [`04-FRONTEND/BackOffice/ui-status.md`](04-FRONTEND/BackOffice/ui-status.md) |
-| **FrontOffice UI** | 🚧 In Progress | 75% | [`04-FRONTEND/FrontOffice/README.md`](04-FRONTEND/FrontOffice/README.md) |
-
-### آخرین دستاوردها (۱۴ آذر):
- ✅ **FrontOffice UI**: 7 صفحه جدید (Club, Network, Commission)
- ✅ **FrontOffice.BFF**: 3 ماژول جدید (ClubMembership, NetworkMembership, Commission)
- ✅ **Build**: موفق با 0 خطا
- ✅ **Documentation**: بازسازی کامل ساختار
-
---
-
-## 🗂️ ساختار مستندات
-
-### 📊 01-BUSINESS/ - منطق تجاری
-
-قوانین کسب‌وکار، فرآیندها، و محاسبات مالی:
-
-| فایل | موضوع | خلاصه |
-|------|-------|-------|
-| [`network-commission-system.md`](01-BUSINESS/network-commission-system.md) | شبکه + کمیسیون | Binary MLM Tree, Flash Out, Weekly Pool |
-| [`discount-shop-business.md`](01-BUSINESS/discount-shop-business.md) | فروشگاه تخفیف | محصولات تخفیف‌دار، محدودیت DiscountBalance |
-| [`package-purchase-system.md`](01-BUSINESS/package-purchase-system.md) | خرید پکیج طلایی | فعال‌سازی باشگاه، پرداخت 56M |
-| [`daya-loan-integration.md`](01-BUSINESS/daya-loan-integration.md) | قرض‌الحسنه دایا | خرید الماس، انتقال NetworkBalance |
-| [`balance-calculation-rules.md`](01-BUSINESS/balance-calculation-rules.md) | محاسبه موجودی | Carryover Logic, تعادل‌های باقیمانده |
-| [`binary-tree-guide.md`](01-BUSINESS/binary-tree-guide.md) | ثبت‌نام در شبکه | قرارگیری در دست چپ/راست، Placement |
-
-**کاربرد**: تحلیلگران کسب‌وکار، توسعه‌دهندگان Backend، تست‌نویس‌ها
-
---
-
-### 🏗️ 02-ARCHITECTURE/ - معماری سیستم
-
-**⚠️ در حال توسعه** - فعلاً به اسناد موجود در `CMS/` مراجعه کنید:
- معماری کلی: Clean Architecture (Domain → Application → Infrastructure)
- الگوی BFF: Backend for Frontend
- Microservices: CMS ↔ BFF ↔ UI
-
-**Roadmap**: 
- [ ] System Overview Diagram
- [ ] Microservices Communication Flow
- [ ] Database Schema (ERD)
- [ ] Security Architecture
-
---
-
-### ⚙️ 03-BACKEND/ - Backend Services
-
-#### 📦 CMS Microservice (Core Business Logic)
-
-| فایل | موضوع | خلاصه |
-|------|-------|-------|
-| [`README.md`](03-BACKEND/CMS/README.md) | نمای کلی CMS | معرفی، تکنولوژی‌ها، Quick Start |
-| [`implementation-status.md`](03-BACKEND/CMS/implementation-status.md) | پیشرفت پیاده‌سازی | Phase 1-12، 98% Complete، Daya API ✅ |
-| [`entity-guide.md`](03-BACKEND/CMS/entity-guide.md) | راهنمای Entity ها | Domain Entities، Relations، Validations |
-| [`commission-system.md`](03-BACKEND/CMS/commission-system.md) | ✨ سیستم کمیسیون | Entities, Proto Models, WeekDefinitionId Migration |
-| [`api-coverage.md`](03-BACKEND/CMS/api-coverage.md) | پوشش API | لیست تمام gRPC Services و Handlers |
-| [`email-sms-configuration.md`](03-BACKEND/CMS/email-sms-configuration.md) | Email & SMS | Kavenegar, MailKit, Templates |
-| [`payment-gateway.md`](03-BACKEND/CMS/payment-gateway.md) | درگاه پرداخت | ZarinPal, Daya Integration |
-| [`daya-api-implementation.md`](03-BACKEND/CMS/daya-api-implementation.md) | ✨ Daya API Guide | Complete Real API Implementation (Dec 6) |
-| [`club-membership-migration.md`](03-BACKEND/CMS/club-membership-migration.md) | ✨ Migration Scripts | اسکریپت‌های مهاجرت باشگاه مشتریان (Dec 9) |
-
-**Key Stats**:
- **Entities**: 50+ Domain Entities
- **Commands**: 120+ CQRS Commands
- **Queries**: 80+ CQRS Queries
- **gRPC RPCs**: 150+ Remote Procedures
- **Build**: ✅ 0 errors, 287 warnings (pre-existing)
-
-#### 🔌 BackOffice.BFF (Admin Gateway)
-
-| فایل | موضوع | خلاصه |
-|------|-------|-------|
-| [`README.md`](03-BACKEND/BackOffice.BFF/README.md) | نمای کلی BFF | معماری، Communication با CMS |
-| [`handlers-status.md`](03-BACKEND/BackOffice.BFF/handlers-status.md) | وضعیت Handler ها | 35 CQRS Handler، 100% Complete |
-| [`cms-integration.md`](03-BACKEND/BackOffice.BFF/cms-integration.md) | یکپارچه‌سازی CMS | Protobuf, gRPC Client Configuration |
-| [`discount-shop-integration.md`](03-BACKEND/BackOffice.BFF/discount-shop-integration.md) | ادغام فروشگاه تخفیف | 19 Handler برای مدیریت محصولات تخفیف |
-
-**Key Stats**:
- **Handlers**: 35 CQRS (100% Production Ready)
- **gRPC Clients**: 5 Services
- **Pages Served**: 23 Blazor Pages
-
-#### 🔌 FrontOffice.BFF (User Gateway)
-
-| فایل | موضوع | خلاصه |
-|------|-------|-------|
-| [`README.md`](03-BACKEND/FrontOffice.BFF/README.md) | نمای کلی BFF | معماری، 12 Handler (9 + 3 new) |
-| [`protobuf-mismatch.md`](03-BACKEND/FrontOffice.BFF/protobuf-mismatch.md) | ⚠️ مغایرت Proto | 6 Handler با مشکل، راهکارها |
-
-**Key Stats**:
- **Handlers**: 12 CQRS (60% Complete)
- **New Today**: ClubMembership, NetworkMembership, Commission (3 modules)
- **Blockers**: Protobuf field name mismatches
-
---
-
-### 🎨 04-FRONTEND/ - Frontend Applications
-
-#### 🖥️ BackOffice (Admin Panel)
-
-| فایل | موضوع | خلاصه |
-|------|-------|-------|
-| [`README.md`](04-FRONTEND/BackOffice/README.md) | نمای کلی BackOffice | Blazor Server، MudBlazor 8.14.0 |
-| [`ui-status.md`](04-FRONTEND/BackOffice/ui-status.md) | وضعیت صفحات | 23 Pages + 8 Dialogs، 100% Complete |
-
-**Pages**: Dashboard, User Management, Order Management, Commission Reports, Network Stats, Club Management, Discount Shop Management, Payment Gateways, Worker Control
-
-#### 👤 FrontOffice (User Portal)
-
-| فایل | موضوع | خلاصه |
-|------|-------|-------|
-| [`README.md`](04-FRONTEND/FrontOffice/README.md) | نمای کلی FrontOffice | 24 Pages، 75% Complete |
-| [`gap-analysis.md`](04-FRONTEND/FrontOffice/gap-analysis.md) | تحلیل Gap | 12 Module، 7 نیاز به API واقعی |
-| [`todo-commented-code.md`](04-FRONTEND/FrontOffice/todo-commented-code.md) | ⚠️ TODO های کد | 5 متد WalletService + 3 Mock Service |
-| [`progress-report.md`](04-FRONTEND/FrontOffice/progress-report.md) | گزارش پیشرفت امروز | 7 صفحه + 3 سرویس + 3 BFF module |
-
-**New Pages (Today)**:
- **Club**: `ClubInfo.razor`, `ActivateClub.razor`, `ClubFeatures.razor`
- **Network**: `Tree.razor`, `NetworkStats.razor`
- **Commission**: `WeeklyReport.razor`, `PayoutHistory.razor`
-
-**Status**: Mock services → Need real API integration
-
---
-
-### ✅ 05-TASKS/ - مدیریت وظایف
-
-| فایل | موضوع | خلاصه |
-|------|-------|-------|
-| [`CURRENT-SPRINT.md`](05-TASKS/CURRENT-SPRINT.md) | اسپرینت جاری | TODO های High/Medium/Low Priority |
-| [`BACKLOG.md`](05-TASKS/BACKLOG.md) | Backlog | کارهای آینده، Feature Requests |
-| [`verification-template.md`](05-TASKS/verification-template.md) | چک‌لیست QA | تست‌های Business Verification |
-
-**Current Sprint Highlights**:
- 🔥 **High Priority**: FrontOffice UI Integration (7 صفحه)
- 🔥 **High Priority**: Protobuf Mismatch Fixes (3 Handler)
- 🟡 **Medium**: WalletService Implementation (5 متد)
- 🟡 **Medium**: Package Purchase UI (4 صفحه)
-
---
-
-### 🚀 06-DEPLOYMENT/ - استقرار و عملیات
-
-| فایل | موضوع | خلاصه |
-|------|-------|-------|
-| [`quick-start.md`](06-DEPLOYMENT/quick-start.md) | راهنمای شروع | Setup محیط توسعه، Build، Run |
-| [`delivery-readiness.md`](06-DEPLOYMENT/delivery-readiness.md) | آمادگی تحویل | چک‌لیست Production، Deployment Steps |
-
-**Requirements**:
- .NET 9 SDK
- SQL Server 2019+
- Visual Studio 2022 / Rider
- Node.js (برای Frontend tooling)
-
---
-
-### 📦 99-ARCHIVE/ - آرشیو اسناد قدیمی
-
-فایل‌های منسوخ شده که دیگر استفاده نمی‌شوند:
-
-| فایل | دلیل آرشیو | جایگزین |
-|------|-----------|---------|
-| `REMAINING-TASKS-OLD-2024-12-02.md` | منسوخ شده | `05-TASKS/BACKLOG.md` |
-| `network-club-commission-system-OLD.md` | نسخه قدیمی | `01-BUSINESS/network-commission-system.md` |
-| `implementation-progress-fa-OLD.md` | ترجمه ناقص | `03-BACKEND/CMS/implementation-status.md` |
-| `monitoring-alerts-partial-OLD.md` | گزارش ناقص | در CMS موجود |
-
-**راهنما**: [`99-ARCHIVE/ARCHIVE-INDEX.md`](99-ARCHIVE/ARCHIVE-INDEX.md)
-
---
-
-## 🔍 جستجوی سریع
-
-### موضوعات کلیدی:
-
-| موضوع | فایل‌های مرتبط |
-|-------|---------------|
-| **باشگاه مشتریان** | `01-BUSINESS/network-commission-system.md`, `03-BACKEND/CMS/implementation-status.md` (Phase 9) |
-| **شبکه باینری** | `01-BUSINESS/network-commission-system.md`, `01-BUSINESS/binary-tree-guide.md` |
-| **کمیسیون هفتگی** | `01-BUSINESS/network-commission-system.md`, `03-BACKEND/CMS/implementation-status.md` (Phase 4) |
-| **فروشگاه تخفیف** | `01-BUSINESS/discount-shop-business.md`, `03-BACKEND/CMS/implementation-status.md` (Phase 9) |
-| **خرید پکیج** | `01-BUSINESS/package-purchase-system.md`, `03-BACKEND/CMS/implementation-status.md` (Phase 12) |
-| **کیف پول سه‌گانه** | `01-BUSINESS/balance-calculation-rules.md`, `04-FRONTEND/FrontOffice/todo-commented-code.md` |
-| **درگاه پرداخت** | `03-BACKEND/CMS/payment-gateway.md`, `01-BUSINESS/daya-loan-integration.md` |
-| **Email & SMS** | `03-BACKEND/CMS/email-sms-configuration.md` |
-| **gRPC Integration** | `03-BACKEND/BackOffice.BFF/cms-integration.md`, `03-BACKEND/FrontOffice.BFF/protobuf-mismatch.md` |
-
---
-
-## 📈 آمار کلی مستندات
-
-### قبل از تجمیع:
- **تعداد فایل**: 42 فایل .md
- **حجم کل**: ~33,000 خط
- **ساختار**: پراکنده در پوشه‌های مختلف
-
-### بعد از تجمیع:
- **تعداد فایل فعال**: ~28 فایل
- **تعداد آرشیو شده**: 4 فایل
- **ساختار**: دسته‌بندی شده در 7 پوشه اصلی
- **کاهش تکرار**: ~16%
-
-### پوشش مستندات:
- ✅ **Business Logic**: 6 سند جامع
- ✅ **Backend**: 12 سند (CMS + BFFs)
- ✅ **Frontend**: 7 سند (BackOffice + FrontOffice)
- ✅ **Tasks**: 3 سند (Sprint, Backlog, Verification)
- ✅ **Deployment**: 2 سند (Quick Start, Delivery)
- ⏳ **Architecture**: در حال توسعه
-
---
-
-## 🤝 مشارکت در مستندات
-
-### به‌روزرسانی مستندات:
-1. هر تغییر در کد → بروزرسانی سند مربوطه
-2. TODO جدید → افزودن به `05-TASKS/CURRENT-SPRINT.md`
-3. Feature جدید → ایجاد سند در پوشه مناسب
-4. Bug Critical → ثبت در `CURRENT-SPRINT.md` با Priority 🔥
-
-### قوانین نام‌گذاری:
- استفاده از `kebab-case` برای نام فایل‌ها
- زبان فارسی برای Business Docs
- زبان انگلیسی برای Technical Docs
- Emoji برای دسته‌بندی سریع (✅ 🚧 ⚠️ 🔥)
-
---
-
-## 📞 پشتیبانی
-
-برای سوالات و مشکلات:
- **مستندات فنی**: Backend Team
- **مستندات Business**: Product Owner
- **مستندات UI/UX**: Frontend Team
-
---
-
-## 📝 تاریخچه تغییرات
-
-### نسخه 2.0 (۱۴ آذر ۱۴۰۴):
- ✅ بازسازی کامل ساختار مستندات
- ✅ تجمیع اسناد تکراری
- ✅ آرشیو اسناد منسوخ
- ✅ ایجاد CURRENT-SPRINT.md
- ✅ به‌روزرسانی با کارهای امروز (7 صفحه + 3 BFF module)
-
-### نسخه 1.0 (1 دسامبر 2025):
- INDEX.md اولیه با 24 فایل
-
---
-
-**🎯 این مستندات همواره در حال به‌روزرسانی هستند. آخرین نسخه را از Git دریافت کنید.**
-
@@ -1,380 +0,0 @@
-# 📊 مثال‌های عملی محاسبه تعادل - 5 لول عمقی
-
-**تاریخ**: 2025-12-09  
-**وضعیت**: مثال‌های کامل و تایید شده  
-**هدف**: نمایش محاسبات واقعی برای درخت باینری تا 5 لول
-
---
-
-## 🌳 ساختار درخت نمونه
-
-```
-                    User1 (Level 0)
-                    /              \
-            User2 (L1-L)          User3 (L1-R)
-            /         \           /         \
-    User4(L2-LL)  User5(L2-LR)  User6(L2-RL)  User7(L2-RR)
-    /     \       /     \       /     \        /     \
-U8(L3)  U9(L3) U10(L3) U11(L3) U12(L3) U13(L3) U14(L3) U15(L3)
-/  \    /  \   /  \    /  \    /  \    /  \    /  \    /  \
-U16-U31 (Level 4 - 16 users)
-/\  /\  /\  /\  /\  /\  /\  /\  /\  /\  /\  /\  /\  /\  /\  /\
-U32-U63 (Level 5 - 32 users)
-```
-
---
-
-## 📋 داده‌های ورودی
-
-### فرضیات:
- **هفته فعلی**: 2025-W50
- **سقف امتیاز**: 300
- **تعداد کل کاربران**: 63 نفر (6 لول: 1+2+4+8+16+32)
- **وضعیت**: همه کاربران فعال هستند (عضو باشگاه)
-
---
-
-## 🎯 محاسبات Level 5 (پایین‌ترین سطح)
-
-### User 32-63 (32 کاربر Leaf):
-```
-هیچ زیرمجموعه‌ای ندارند
-چپ = 0، راست = 0
-تعادل = MIN(0, 0) = 0
-امتیاز = 0
-باقیمانده چپ = 0
-باقیمانده راست = 0
-فلش = 0
-```
-
-**خلاصه Level 5**: تمام 32 کاربر → 0 امتیاز
-
---
-
-## 🎯 محاسبات Level 4 (User 16-31)
-
-### User 16:
-**زیرمجموعه**:
- چپ: User 32 (1 نفر)
- راست: User 33 (1 نفر)
-
-**محاسبات**:
-```
-چپ = 1، راست = 1
-تعادل اولیه = MIN(1, 1) = 1
-باقیمانده چپ = 1 - 1 = 0
-باقیمانده راست = 1 - 1 = 0
-امتیاز نهایی = MIN(1, 300) = 1 ✅
-فلش = 0
-```
-
-### User 17:
-**زیرمجموعه**:
- چپ: User 34 (1 نفر)
- راست: User 35 (1 نفر)
-
-**محاسبات**: مشابه User 16
-```
-امتیاز = 1 ✅
-```
-
-### User 18-31 (14 کاربر دیگه):
-همه مشابه User 16 → هر کدام 1 امتیاز
-
-**خلاصه Level 4**: تمام 16 کاربر → هر کدام 1 امتیاز = **16 امتیاز**
-
---
-
-## 🎯 محاسبات Level 3 (User 8-15)
-
-### User 8:
-**زیرمجموعه**:
- چپ: User 16 (1 نفر)
- راست: User 17 (1 نفر)
-
-**محاسبات**:
-```
-چپ = 1، راست = 1
-تعادل = MIN(1, 1) = 1
-امتیاز = 1 ✅
-```
-
-### User 9:
-**زیرمجموعه**:
- چپ: User 18 (1 نفر)
- راست: User 19 (1 نفر)
-
-**محاسبات**: مشابه User 8
-```
-امتیاز = 1 ✅
-```
-
-### User 10-15 (6 کاربر دیگه):
-همه مشابه → هر کدام 1 امتیاز
-
-**خلاصه Level 3**: تمام 8 کاربر → هر کدام 1 امتیاز = **8 امتیاز**
-
---
-
-## 🎯 محاسبات Level 2 (User 4-7)
-
-### User 4:
-**زیرمجموعه**:
- چپ: User 8 (1 نفر)
- راست: User 9 (1 نفر)
-
-**محاسبات**:
-```
-چپ = 1، راست = 1
-تعادل = MIN(1, 1) = 1
-امتیاز = 1 ✅
-```
-
-### User 5:
-**زیرمجموعه**:
- چپ: User 10 (1 نفر)
- راست: User 11 (1 نفر)
-
-**محاسبات**: مشابه User 4
-```
-امتیاز = 1 ✅
-```
-
-### User 6, 7:
-همه مشابه → هر کدام 1 امتیاز
-
-**خلاصه Level 2**: تمام 4 کاربر → هر کدام 1 امتیاز = **4 امتیاز**
-
---
-
-## 🎯 محاسبات Level 1 (User 2-3)
-
-### User 2:
-**زیرمجموعه**:
- چپ: User 4 (1 نفر)
- راست: User 5 (1 نفر)
-
-**محاسبات**:
-```
-چپ = 1، راست = 1
-تعادل = MIN(1, 1) = 1
-امتیاز = 1 ✅
-```
-
-### User 3:
-**زیرمجموعه**:
- چپ: User 6 (1 نفر)
- راست: User 7 (1 نفر)
-
-**محاسبات**: مشابه User 2
-```
-امتیاز = 1 ✅
-```
-
-**خلاصه Level 1**: تمام 2 کاربر → هر کدام 1 امتیاز = **2 امتیاز**
-
---
-
-## 🎯 محاسبات Level 0 (User 1 - Root)
-
-### User 1:
-**زیرمجموعه**:
- چپ: User 2 (1 نفر)
- راست: User 3 (1 نفر)
-
-**محاسبات**:
-```
-چپ = 1، راست = 1
-تعادل = MIN(1, 1) = 1
-امتیاز = 1 ✅
-```
-
-**خلاصه Level 0**: User 1 → **1 امتیاز**
-
---
-
-## 📊 جمع کل سیستم
-
-| Level | تعداد کاربران | امتیاز هر کاربر | جمع امتیازهای Level |
-|-------|---------------|-----------------|---------------------|
-| 5 | 32 | 0 | 0 |
-| 4 | 16 | 1 | 16 |
-| 3 | 8 | 1 | 8 |
-| 2 | 4 | 1 | 4 |
-| 1 | 2 | 1 | 2 |
-| 0 | 1 | 1 | 1 |
-| **جمع** | **63** | - | **31 امتیاز** |
-
---
-
-## 💰 محاسبه صندوق
-
-### داده‌های ورودی:
-```
-تعداد کاربران فعال شده این هفته: 63 نفر
-هزینه فعال‌سازی هر نفر: 25,000,000 ریال
-درصد سهم استخر: 20%
-
-جمع ورودی استخر = 63 × 25,000,000 × 20%
-                  = 63 × 5,000,000
-                  = 315,000,000 ریال
-```
-
-### محاسبه ارزش هر امتیاز:
-```
-مجموع امتیازهای سیستم = 31
-جمع استخر = 315,000,000 ریال
-
-ارزش هر امتیاز = 315,000,000 ÷ 31
-               = 10,161,290 ریال (تقریباً)
-```
-
-### توزیع کمیسیون:
-```
-User 1: 1 × 10,161,290 = 10,161,290 ریال
-User 2: 1 × 10,161,290 = 10,161,290 ریال
-User 3: 1 × 10,161,290 = 10,161,290 ریال
-User 4-7: 4 × 10,161,290 = 40,645,160 ریال
-User 8-15: 8 × 10,161,290 = 81,290,320 ریال
-User 16-31: 16 × 10,161,290 = 162,580,640 ریال
-User 32-63: 0 ریال (امتیازی ندارند)
-
-جمع کل پرداختی = 315,000,000 ریال ✅
-```
-
---
-
-## 🔥 مثال پیچیده‌تر: سناریو نامتعادل
-
-### تغییر ساختار:
-```
-User 1:
-  چپ: 500 نفر (عمق زیاد)
-  راست: 600 نفر (عمق بیشتر)
-```
-
-### محاسبات User 1:
-```
-مرحله 1️⃣: تعادل اولیه
-  چپ = 500، راست = 600
-  تعادل = MIN(500, 600) = 500
-
-مرحله 2️⃣: باقیمانده
-  باقی چپ = 500 - 500 = 0
-  باقی راست = 600 - 500 = 100 → هفته بعد
-
-مرحله 3️⃣: اعمال سقف
-  امتیاز = MIN(500, 300) = 300 ✅
-
-مرحله 4️⃣: فلش
-  فلش از چپ = 500 - 300 = 200
-  فلش از راست = 500 - 300 = 200
-  جمع فلش = 400 (از بین می‌رود)
-```
-
-### نتیجه:
-```
-✅ امتیاز User 1: 300
-✅ باقیمانده راست: 100 (می‌رود هفته بعد)
-✅ باقیمانده چپ: 0
-✅ فلش شده: 400 (از بین رفته)
-```
-
---
-
-## 🔄 مثال با Carryover (هفته بعد)
-
-### فرض: User 1 در هفته 2025-W51:
-```
-باقیمانده هفته قبل:
-  چپ: 0
-  راست: 100
-
-جدیدهای این هفته:
-  چپ: 250
-  راست: 150
-```
-
-### محاسبات:
-```
-مرحله 1️⃣: جمع با هفته قبل
-  چپ کل = 0 + 250 = 250
-  راست کل = 100 + 150 = 250
-
-مرحله 2️⃣: تعادل
-  تعادل = MIN(250, 250) = 250
-
-مرحله 3️⃣: باقیمانده
-  باقی چپ = 250 - 250 = 0
-  باقی راست = 250 - 250 = 0
-
-مرحله 4️⃣: امتیاز
-  امتیاز = MIN(250, 300) = 250 ✅
-
-مرحله 5️⃣: فلش
-  فلش = 0 (چون 250 < 300)
-```
-
---
-
-## 📈 مثال سقف: User با شبکه بزرگ
-
-### User A:
-```
-چپ: 800 نفر
-راست: 900 نفر
-```
-
-### محاسبات:
-```
-تعادل = MIN(800, 900) = 800
-باقی چپ = 800 - 800 = 0
-باقی راست = 900 - 800 = 100
-
-امتیاز = MIN(800, 300) = 300 ✅
-
-فلش:
-  از چپ: 800 - 300 = 500
-  از راست: 800 - 300 = 500
-  جمع: 1000 (از بین می‌رود)
-```
-
-**نتیجه**: حتی با 800 تعادل، فقط **300 امتیاز** می‌گیرد!
-
---
-
-## 🎯 جمع‌بندی قوانین
-
-### ✅ قوانین کلیدی:
-1. **تعادل** = MIN(چپ، راست)
-2. **باقیمانده** = طرفی که بیشتر است (قبل از سقف)
-3. **امتیاز** = MIN(تعادل، 300)
-4. **فلش** = (تعادل - 300) از هر دو طرف (اگر > 300)
-5. **محاسبه مستقل** = هر کاربر جداگانه
-6. **جمع صندوق** = مجموع امتیازهای همه
-
-### ✅ نکات مهم:
- باقیمانده **جداگانه** ذخیره می‌شود (چپ و راست)
- فلش از **هر دو طرف** اتفاق می‌افتد
- سقف 300 روی **امتیاز نهایی** اعمال می‌شود
- هر کاربر مستقل از دیگران محاسبه می‌شود
-
---
-
-## 📊 جدول مقایسه سناریوها
-
-| سناریو | چپ | راست | تعادل | امتیاز | باقی چپ | باقی راست | فلش کل |
-|--------|-----|-------|--------|--------|---------|-----------|---------|
-| متعادل کوچک | 50 | 50 | 50 | 50 | 0 | 0 | 0 |
-| متعادل متوسط | 200 | 200 | 200 | 200 | 0 | 0 | 0 |
-| نامتعادل کوچک | 100 | 150 | 100 | 100 | 0 | 50 | 0 |
-| نامتعادل متوسط | 250 | 350 | 250 | 250 | 0 | 100 | 0 |
-| **سقف ساده** | **350** | **350** | **350** | **300** | **0** | **0** | **100** |
-| **سقف نامتعادل** | **500** | **600** | **500** | **300** | **0** | **100** | **400** |
-| سقف بزرگ | 800 | 900 | 800 | 300 | 0 | 100 | 1000 |
-
---
-
-**پایان مثال‌های عملی**
-
-این مستند تمام حالات ممکن محاسبه تعادل را با مثال‌های عددی واقعی نشان می‌دهد.
@@ -1,546 +0,0 @@
-# Balance Calculation with Carryover Logic - Complete Guide
-
-**Date**: 2025-12-01  
-**Last Updated**: 2025-12-09 (✅ اصلاح نهایی: محاسبات تعادل و فلش)  
-**Status**: ✅ Fully Implemented & Verified  
-**Migration**: `UpdateNetworkWeeklyBalanceWithCarryover`
-
---
-
-## ✅ آخرین به‌روزرسانی (2025-12-09)
-
-### تغییرات اعمال شده:
-کد محاسبه تعادل با توضیحات دقیق بیزینس تطبیق داده شد:
-
-1. ✅ **ترتیب محاسبات اصلاح شد**:
-   - اول تعادل اولیه محاسبه می‌شود
-   - بعد باقیمانده (برای هفته بعد)
-   - سپس سقف 300 اعمال می‌شود
-   - در نهایت فلش محاسبه می‌شود
-
-2. ✅ **فلش از هر دو طرف**:
-   - اگر تعادل > 300 باشد
-   - از چپ: (تعادل - 300) فلش می‌شود
-   - از راست: (تعادل - 300) فلش می‌شود
-   - جمع فلش = (تعادل - 300) × 2
-
-3. ✅ **باقیمانده جداگانه ذخیره می‌شود**:
-   - `LeftLegRemainder`: باقیمانده دست چپ
-   - `RightLegRemainder`: باقیمانده دست راست
-
---
-
-## 📋 قوانین اصلی بیزینس
-
-| توضیح | منطق فعلی (اشتباه) | منطق صحیح |
-|-------|---------------------|-----------|
-| سقف | 300 کل | 300 برای هر دست |
-| حداکثر تعادل | 300 | MIN(300, 300) = 300 |
-| حداکثر کل | 300 | 300 + 300 = 600 (مجموع دو دست) |
-
-### تفاوت در محاسبه:
-
-**منطق فعلی (اشتباه):**
-```csharp
-totalBalances = MIN(leftTotal, rightTotal)
-cappedBalances = MIN(totalBalances, 300)  // ← سقف روی کل
-```
-
-**منطق صحیح:**
-```csharp
-cappedLeftTotal = MIN(leftTotal, 300)   // ← سقف روی هر دست
-cappedRightTotal = MIN(rightTotal, 300)
-totalBalances = MIN(cappedLeftTotal, cappedRightTotal)
-```
-
-### مثال عملی:
-
-| سناریو | چپ | راست | منطق فعلی | منطق صحیح |
-|--------|-----|-------|-----------|-----------|
-| 1 | 200 | 250 | 200 | 200 |
-| 2 | 350 | 400 | **300** ❌ | **300** ✅ |
-| 3 | 500 | 600 | **300** ❌ | **300** ✅ |
-
-**توجه:** در مثال‌های بالا نتیجه یکسان است چون حداکثر یک تعادل همیشه MIN(300,300)=300 است. تفاوت در **باقیمانده** است:
-
-**مثال با چپ=500، راست=600:**
-
-| روش | تعادل | باقیمانده چپ | باقیمانده راست |
-|-----|--------|--------------|----------------|
-| فعلی | 300 | 500 - 150 = 350 | 600 - 150 = 450 |
-| صحیح | 300 | **200** (500-300) | **300** (600-300) |
-
-### تغییرات Configuration:
-
-```csharp
-// ✅ تغییر نام و مقدار:
-// قدیمی:
-Key = "Commission.MaxWeeklyBalancesPerUser", Value = "300"
-
-// جدید:
-Key = "Commission.MaxWeeklyBalancesPerLeg", Value = "300"
-```
-
---
-
-## 📋 Configuration-Based Calculation
-
-### **System Configurations Used:**
-
-```csharp
-// تمام مقادیر از جدول SystemConfigurations خوانده می‌شوند
-Club.ActivationFee = 25,000,000 ریال (هزینه فعال‌سازی)
-Commission.WeeklyPoolContributionPercent = 20% (سهم استخر)
-Commission.MaxWeeklyBalancesPerLeg = 300 (✅ سقف امتیاز نهایی)
-```
-
-**نکته مهم**: سقف 300 روی **امتیاز نهایی** اعمال می‌شود، نه روی تعادل اولیه!
-
-### **Pool Contribution Calculation:**
-
-```csharp
-totalNewMembers = leftNewMembers + rightNewMembers
-weeklyPoolContribution = totalNewMembers × activationFee × poolPercent
-                       = totalNewMembers × 25,000,000 × 20%
-                       = totalNewMembers × 5,000,000
-```
-
-**مثال:**  
-اگر 10 نفر جدید جذب شوند: `10 × 5,000,000 = 50,000,000` ریال به استخر اضافه می‌شود.
-
---
-
-## 🚫 MaxWeeklyBalances Cap (محدودیت سقف 300)
-
-### **Logic صحیح (به‌روز شده 2025-12-09):**
-
-```csharp
-// ✅ مرحله 1: محاسبه تعادل اولیه (بدون سقف)
-totalBalances = MIN(leftTotal, rightTotal)
-
-// ✅ مرحله 2: محاسبه باقیمانده برای هفته بعد
-leftRemainder = leftTotal - totalBalances
-rightRemainder = rightTotal - totalBalances
-
-// ✅ مرحله 3: اعمال سقف 300 (برای امتیاز نهایی)
-cappedBalances = MIN(totalBalances, 300)
-
-// ✅ مرحله 4: محاسبه فلش (از هر دو طرف)
-flushedPerSide = totalBalances - cappedBalances
-totalFlushed = flushedPerSide × 2
-```
-
-### **Example (مثال کامل):**
-
-```
-leftTotal = 500, rightTotal = 600
-
-مرحله 1️⃣: تعادل اولیه
-  totalBalances = MIN(500, 600) = 500 ✅
-
-مرحله 2️⃣: باقیمانده برای هفته بعد
-  leftRemainder = 500 - 500 = 0 ✅
-  rightRemainder = 600 - 500 = 100 ✅
-
-مرحله 3️⃣: اعمال سقف
-  cappedBalances = MIN(500, 300) = 300 ✅
-
-مرحله 4️⃣: محاسبه فلش
-  flushedPerSide = 500 - 300 = 200
-  از چپ: 200 فلش می‌شود
-  از راست: 200 فلش می‌شود
-  totalFlushed = 200 × 2 = 400 ✅
-
-نتیجه نهایی:
-  ✅ امتیاز این هفته: 300
-  ✅ باقیمانده چپ: 0
-  ✅ باقیمانده راست: 100
-  ✅ جمع فلش: 400 (از بین می‌رود)
-```
-
-### **مقایسه منطق قدیم vs جدید:**
-
-```
-// ❌ منطق قدیم (اشتباه):
-cappedBalances = MIN(totalBalances, 300)  // سقف روی کل
-balancesConsumedPerSide = cappedBalances / 2
-leftRemainder = leftTotal - balancesConsumedPerSide
-
-// ✅ منطق جدید (صحیح):
-cappedLeftTotal = MIN(leftTotal, 300)     // سقف روی هر دست
-cappedRightTotal = MIN(rightTotal, 300)
-totalBalances = MIN(cappedLeftTotal, cappedRightTotal)
-leftRemainder = leftTotal - cappedLeftTotal  // باقیمانده از سقف هر دست
-```
-
---
-
-## 📊 Problem Statement
-
-### ❌ **Previous (Incorrect) Logic:**
-
-```csharp
-// محاسبه تعداد کل اعضا در هر پا
-## ✅ **Current (Correct) Logic - Updated 2025-12-09:**
-
-### **Formula (4 مرحله):**
-```
-// مرحله 1: جمع با هفته قبل
-leftTotal = leftNewMembers + leftCarryover
-rightTotal = rightNewMembers + rightCarryover
-
-// مرحله 2: محاسبه تعادل اولیه
-totalBalances = MIN(leftTotal, rightTotal)
-
-// مرحله 3: محاسبه باقیمانده برای هفته بعد
-leftRemainder = leftTotal - totalBalances
-rightRemainder = rightTotal - totalBalances
-
-// مرحله 4: اعمال سقف 300
-cappedBalances = MIN(totalBalances, 300)
-flushedPerSide = totalBalances - cappedBalances
-totalFlushed = flushedPerSide × 2
-```
-
-### **Key Principles:**
-1. **Only count NEW members** activated in current week
-2. **Add carryover** from previous week (جداگانه چپ و راست)
-3. **Calculate remainder** for next week (قبل از سقف)
-4. **Apply cap 300** on final score (بعد از تعادل)
-5. **Flush from both sides** if balance > 300
-6. **Recursive counting** through entire tree structure
-leftTotal = leftNewMembers + leftCarryover
-rightTotal = rightNewMembers + rightCarryover
-
-TotalBalances = MIN(leftTotal, rightTotal)
-
-leftRemainder = leftTotal - TotalBalances
-rightRemainder = rightTotal - TotalBalances
-```
-
-### **Key Principles:**
-1. **Only count NEW members** activated in current week
-2. **Add carryover** from previous week
-3. **Calculate remainder** for next week
-4. **Recursive counting** through entire tree structure
-
---
-
-## 🔢 Example Calculations
-
-### **Week 1 (2025-W48):**
-
-**Tree Structure:**
-```
-User A (Activated this week - 25M to pool)
-├─ Left: User B (Activated this week - 25M)
-└─ Right: User C (Activated this week - 25M)
-```
-
-**Calculations:**
-```
-User A:
-  leftNewMembers = 1 (User B activated)
-  rightNewMembers = 1 (User C activated)
-  leftCarryover = 0 (first week)
-  rightCarryover = 0 (first week)
-  
-  leftTotal = 1 + 0 = 1
-  rightTotal = 1 + 0 = 1
-  
-  TotalBalances = MIN(1, 1) = 1
-  
-  leftRemainder = 1 - 1 = 0
-  rightRemainder = 1 - 1 = 0
-
-User B: TotalBalances = 0 (no children)
-User C: TotalBalances = 0 (no children)
-```
-
-**Pool Calculation:**
-```
-Total Pool = 75M (3 activations × 25M)
-Total Balances = 1 (only User A)
-Value Per Balance = 75M ÷ 1 = 75M
-
-Commission:
-  User A = 1 × 75M = 75M
-```
-
---
-
-### **Week 2 (2025-W49):**
-
-**Tree Structure:**
-```
-User A
-├─ Left: User B
-│   ├─ Left: User D (NEW - activated this week - 25M)
-│   └─ Right: User E (NEW - activated this week - 25M)
-└─ Right: User C
-    ├─ Left: User F (NEW - activated this week - 25M)
-    └─ Right: User G (NEW - activated this week - 25M)
-```
-
-**Calculations:**
-```
-User B:
-  leftNewMembers = 1 (User D)
-  rightNewMembers = 1 (User E)
-  leftCarryover = 0
-  rightCarryover = 0
-  
-  leftTotal = 1 + 0 = 1
-  rightTotal = 1 + 0 = 1
-  TotalBalances = MIN(1, 1) = 1
-
-User C:
-  leftNewMembers = 1 (User F)
-  rightNewMembers = 1 (User G)
-  leftCarryover = 0
-  rightCarryover = 0
-  
-  leftTotal = 1 + 0 = 1
-  rightTotal = 1 + 0 = 1
-  TotalBalances = MIN(1, 1) = 1
-
-User A:
-  leftNewMembers = 2 (D & E through B)
-  rightNewMembers = 2 (F & G through C)
-  leftCarryover = 0 (from week 1)
-  rightCarryover = 0 (from week 1)
-  
-  leftTotal = 2 + 0 = 2
-  rightTotal = 2 + 0 = 2
-  TotalBalances = MIN(2, 2) = 2 ✅
-  
-  leftRemainder = 2 - 2 = 0
-  rightRemainder = 2 - 2 = 0
-```
-
-**Pool Calculation:**
-```
-Total Pool = 100M (4 new activations × 25M)
-Total Balances = 4 (A=2, B=1, C=1)
-Value Per Balance = 100M ÷ 4 = 25M
-
-Commission:
-  User A = 2 × 25M = 50M ✅ (not 33.33M!)
-  User B = 1 × 25M = 25M
-  User C = 1 × 25M = 25M
-```
-
---
-
-### **Week 3 (2025-W50) - With Carryover:**
-
-**Tree Structure:**
-```
-User A
-├─ Left: User B
-│   ├─ Left: User D
-│   │   └─ Left: User H (NEW - 25M)
-│   └─ Right: User E
-└─ Right: User C
-    ├─ Left: User F
-    └─ Right: User G
-```
-
-**Calculations:**
-```
-User D:
-  leftNewMembers = 1 (User H)
-  rightNewMembers = 0
-  leftCarryover = 0
-  rightCarryover = 0
-  
-  leftTotal = 1 + 0 = 1
-  rightTotal = 0 + 0 = 0
-  TotalBalances = MIN(1, 0) = 0
-  
-  leftRemainder = 1 - 0 = 1 ⚠️ (saved for next week)
-  rightRemainder = 0 - 0 = 0
-
-User B:
-  leftNewMembers = 1 (H through D)
-  rightNewMembers = 0
-  leftCarryover = 0 (from week 2)
-  rightCarryover = 0
-  
-  leftTotal = 1 + 0 = 1
-  rightTotal = 0 + 0 = 0
-  TotalBalances = MIN(1, 0) = 0
-  
-  leftRemainder = 1 - 0 = 1 ⚠️ (saved for next week)
-  rightRemainder = 0 - 0 = 0
-
-User A:
-  leftNewMembers = 1 (H through B→D)
-  rightNewMembers = 0
-  leftCarryover = 0 (from week 2)
-  rightCarryover = 0
-  
-  leftTotal = 1 + 0 = 1
-  rightTotal = 0 + 0 = 0
-  TotalBalances = MIN(1, 0) = 0
-  
-  leftRemainder = 1 - 0 = 1 ⚠️ (saved for next week)
-  rightRemainder = 0 - 0 = 0
-```
-
-**Pool Calculation:**
-```
-Total Pool = 25M (1 new activation)
-Total Balances = 0 (no balanced pairs)
-Value Per Balance = N/A
-
-Commission: None this week
-Carryover: User A, B, D each have 1 leftRemainder for week 4
-```
-
---
-
-## 🔄 Database Schema
-
-### **NetworkWeeklyBalance Table:**
-
-```sql
-ALTER TABLE NetworkWeeklyBalances ADD:
-  -- New members this week
-  LeftLegNewMembers INT NOT NULL DEFAULT 0,
-  RightLegNewMembers INT NOT NULL DEFAULT 0,
-  
-  -- Carryover from previous week
-  LeftLegCarryover INT NOT NULL DEFAULT 0,
-  RightLegCarryover INT NOT NULL DEFAULT 0,
-  
-  -- Totals (new + carryover)
-  LeftLegTotal INT NOT NULL DEFAULT 0,
-  RightLegTotal INT NOT NULL DEFAULT 0,
-  
-  -- Remainder for next week
-  LeftLegRemainder INT NOT NULL DEFAULT 0,
-  RightLegRemainder INT NOT NULL DEFAULT 0
-```
-
-**Deprecated Fields:**
- `LeftLegBalances` (still exists for backward compatibility)
- `RightLegBalances` (still exists for backward compatibility)
-
---
-
-## 💻 Implementation
-
-### **Handler: CalculateWeeklyBalancesCommandHandler.cs**
-
-```csharp
-public async Task<int> Handle(CalculateWeeklyBalancesCommand request, CancellationToken cancellationToken)
-{
-    // 1. Load previous week's carryover
-    var previousWeekNumber = GetPreviousWeekNumber(request.WeekNumber);
-    var previousWeekCarryovers = await _context.NetworkWeeklyBalances
-        .Where(x => x.WeekNumber == previousWeekNumber)
-        .ToDictionaryAsync(x => x.UserId, x => new { x.LeftLegRemainder, x.RightLegRemainder });
-
-    // 2. For each user in network
-    foreach (var user in usersInNetwork)
-    {
-        // Get carryover
-        var leftCarryover = previousWeekCarryovers.ContainsKey(user.Id) 
-            ? previousWeekCarryovers[user.Id].LeftLegRemainder : 0;
-        var rightCarryover = previousWeekCarryovers.ContainsKey(user.Id) 
-            ? previousWeekCarryovers[user.Id].RightLegRemainder : 0;
-
-        // Count NEW members (activated in this week)
-        var leftNewMembers = await CountNewMembersInLeg(user.Id, NetworkLeg.Left, request.WeekNumber);
-        var rightNewMembers = await CountNewMembersInLeg(user.Id, NetworkLeg.Right, request.WeekNumber);
-
-        // Calculate totals
-        var leftTotal = leftNewMembers + leftCarryover;
-        var rightTotal = rightNewMembers + rightCarryover;
-
-        // Calculate balance (min)
-        var totalBalances = Math.Min(leftTotal, rightTotal);
-
-        // Calculate remainder
-        var leftRemainder = leftTotal - totalBalances;
-        var rightRemainder = rightTotal - totalBalances;
-
-        // Save to database
-        var balance = new NetworkWeeklyBalance
-        {
-            UserId = user.Id,
-            WeekNumber = request.WeekNumber,
-            LeftLegNewMembers = leftNewMembers,
-            RightLegNewMembers = rightNewMembers,
-            LeftLegCarryover = leftCarryover,
-            RightLegCarryover = rightCarryover,
-            LeftLegTotal = leftTotal,
-            RightLegTotal = rightTotal,
-            TotalBalances = totalBalances,
-            LeftLegRemainder = leftRemainder,
-            RightLegRemainder = rightRemainder,
-            // ...
-        };
-    }
-}
-
-private async Task<int> CountNewMembersRecursive(long userId, NetworkLeg leg, DateTime startDate, DateTime endDate)
-{
-    var child = await _context.Users
-        .FirstOrDefaultAsync(x => x.NetworkParentId == userId && x.LegPosition == leg);
-
-    if (child == null) return 0;
-
-    var count = 0;
-
-    // Check if activated in this week
-    var membership = await _context.ClubMemberships
-        .FirstOrDefaultAsync(x => x.UserId == child.Id && x.IsActive);
-
-    if (membership?.ActivatedAt >= startDate && membership?.ActivatedAt <= endDate)
-    {
-        count = 1;
-    }
-
-    // Recursively count children
-    var childLeft = await CountNewMembersRecursive(child.Id, NetworkLeg.Left, startDate, endDate);
-    var childRight = await CountNewMembersRecursive(child.Id, NetworkLeg.Right, startDate, endDate);
-
-    return count + childLeft + childRight;
-}
-```
-
---
-
-## 📝 Key Points
-
-1. ✅ **Only NEW activations count** - filtered by `ActivatedAt` date
-2. ✅ **Carryover persists** - unused balances roll over to next week
-3. ✅ **Recursive counting** - includes entire subtree under each leg
-4. ✅ **Week date ranges** - ISO 8601 week format (Saturday to Friday)
-5. ✅ **Idempotent** - can recalculate with `ForceRecalculate` flag
-
---
-
-## 🚀 Benefits
-
-1. **Fair commission distribution** - rewards balanced growth
-2. **No lost balances** - carryover ensures nothing is wasted
-3. **Accurate tracking** - distinguishes new vs existing members
-4. **Scalable** - works for large networks with recursive algorithm
-5. **Auditable** - full history of calculations in database
-
---
-
-## 📞 Reference
-
- **Source Code**: `CMSMicroservice.Application/CommissionCQ/Commands/CalculateWeeklyBalances/`
- **Migration**: `20251201144400_UpdateNetworkWeeklyBalanceWithCarryover`
- **Entity**: `CMSMicroservice.Domain/Entities/Network/NetworkWeeklyBalance.cs`
- **Discussion**: Telegram chat with Dr. Seif (2025-12-01)
-
---
-
-**Status**: ✅ Production Ready  
-**Last Updated**: 2025-12-01
@@ -1,656 +0,0 @@
-# Base Package Payment System - سیستم پرداخت پکیج پایه
-
-**تاریخ ایجاد:** 2024-12-16  
-**تاریخ آخرین به‌روزرسانی:** 2024-12-16  
-**وضعیت:** ✅ پیاده‌سازی شده  
-**اولویت:** 🔴 بسیار بالا
-
---
-
-## 📋 فهرست
-
-1. [خلاصه سیستم](#خلاصه-سیستم)
-2. [Business Requirements](#business-requirements)
-3. [معماری سیستم](#معماری-سیستم)
-4. [Implementation Details](#implementation-details)
-5. [Club Membership Contract System](#club-membership-contract-system)
-6. [API Endpoints](#api-endpoints)
-7. [Flow Diagram](#flow-diagram)
-8. [نکات مهم](#نکات-مهم)
-
---
-
-## 🎯 خلاصه سیستم
-
-سیستم پرداخت پکیج پایه امکان پرداخت **56 میلیون تومان** را برای کاربران فراهم می‌کند تا بتوانند:
-1. کیف پول خود را شارژ کنند (Balance + DiscountBalance)
-2. **امضای قرارداد باشگاه مشتریان** (گام الزامی بعد از پرداخت)
-3. **فعالسازی لینک دعوت** (Referral Link) - تنها بعد از امضای قرارداد
-4. دسترسی کامل به امکانات باشگاه مشتریان
-
-### دو روش پرداخت:
-1. **پرداخت مستقیم (Direct Payment)** - از طریق درگاه بانکی (زرین‌پال)
-2. **اعتبار الماسی دایا (Daya Loan)** - از طریق سایت دایا
-
---
-
-## 📊 Business Requirements
-
-### شرایط نمایش لینک دعوت:
-```
-CanShowReferralLink = HasPurchasedPackage && IsClubMemberActive
-```
-
- **HasPurchasedPackage**: کاربر پکیج پایه را خریداری کرده (PackagePurchaseMethod != None)
- **IsClubMemberActive**: قرارداد باشگاه مشتریان امضا شده (ClubMembership.IsActive = true)
-
-⚠️ **نکته مهم**: پرداخت پکیج به تنهایی کافی نیست! کاربر باید قرارداد باشگاه مشتریان را نیز امضا کند.
-
-### مقدار پکیج:
- **مبلغ**: 56,000,000 تومان
- **شارژ Balance**: 56,000,000 تومان
- **شارژ DiscountBalance**: 56,000,000 تومان
-
-### PackagePurchaseMethod Enum:
-```csharp
-public enum PackagePurchaseMethod
-{
-    None = 0,           // هنوز خرید نکرده
-    DirectPurchase = 1, // پرداخت مستقیم
-    DayaLoan = 2        // اعتبار دایا
-}
-```
-
-### ContractType Enum:
-```csharp
-public enum ContractType
-{
-    Main = 0,           // قرارداد ثبت‌نام اولیه
-    ClubMembership = 1, // قرارداد باشگاه مشتریان
-}
-```
-
---
-
-## 🏗️ معماری سیستم
-
-### Architecture Pattern:
-```
-Frontend (Blazor)
-    ↓
-BFF (Backend For Frontend)
-    ↓ ↘
-CMS     PYMS (Payment Gateway)
-```
-
-### Layer Responsibilities:
-
-#### 1️⃣ Frontend (Blazor)
- نمایش UI برای انتخاب روش پرداخت
- فراخوانی BFF برای شروع پرداخت
- مدیریت Callback از درگاه
- نمایش نتیجه پرداخت
- **Modal غیرقابل بسته شدن برای امضای قرارداد باشگاه** (جدید ✨)
-
-#### 2️⃣ BFF (Middle Layer)
- **InitiateBasePackagePayment**: هماهنگی بین CMS و PYMS
-  - فراخوانی CMS برای ثبت Transaction + Order
-  - فراخوانی PYMS برای دریافت URL درگاه
-  - برگرداندن URL به Frontend
-
- **VerifyBasePackagePayment**: تأیید پرداخت
-  - فراخوانی PYMS برای Verify
-  - فراخوانی CMS برای شارژ یا Reject
-
- **RequestClubContractOtp**: ارسال OTP برای امضای قرارداد (جدید ✨)
- **AcceptClubMembershipContract**: امضای قرارداد و فعالسازی باشگاه (جدید ✨)
-
-#### 3️⃣ CMS (Core Business)
- **InitiateBasePackagePayment**: ثبت Transaction + Order با Pending
- **VerifyBasePackagePayment**: شارژ کیف پول یا Reject بر اساس نتیجه
- **AcceptClubMembershipContract**: ثبت UserContract و فعالسازی ClubMembership (جدید ✨)
-
-#### 4️⃣ PYMS (Payment Gateway Service)
- **PaymentRequest**: دریافت URL درگاه زرین‌پال
- **PaymentVerification**: تأیید پرداخت از بانک
-
---
-
-## 💻 Implementation Details
-
-### CMS Layer
-
-#### Commands:
-1. **InitiateBasePackagePaymentCommand**
-   ```csharp
-   // Input
-   public record InitiateBasePackagePaymentCommand
-   {
-       public long UserId { get; init; }
-   }
-   
-   // Output
-   public class InitiateBasePackagePaymentResponseDto
-   {
-       public bool Success { get; set; }
-       public string Message { get; set; }
-       public long OrderId { get; set; }
-       public long TransactionId { get; set; }
-       public long Amount { get; set; } // 56,000,000
-   }
-   ```
-
-   **Handler Logic:**
-   - بررسی عدم خرید قبلی: `user.PackagePurchaseMethod == None`
-   - بررسی عدم Order Pending قبلی
-   - ایجاد Transaction با PaymentStatus.Pending
-   - ایجاد UserOrder با PackageId=4, PaymentStatus.Pending
-   - Return OrderId + TransactionId
-
-2. **VerifyBasePackagePaymentCommand**
-   ```csharp
-   // Input
-   public record VerifyBasePackagePaymentCommand
-   {
-       public long OrderId { get; init; }
-       public long TransactionId { get; init; }
-       public bool PaymentSuccess { get; init; } // از BFF می‌آید
-       public string? RefId { get; init; }
-       public string? Message { get; init; }
-   }
-   
-   // Output
-   public class VerifyBasePackagePaymentResponseDto
-   {
-       public bool Success { get; set; }
-       public string Message { get; set; }
-       public long OrderId { get; set; }
-       public long TransactionId { get; set; }
-       public string? ReferenceCode { get; set; }
-       public long WalletBalance { get; set; }
-       public long DiscountBalance { get; set; }
-   }
-   ```
-
-   **Handler Logic (Success):**
-   - شارژ `wallet.Balance += 56,000,000`
-   - شارژ `wallet.DiscountBalance += 56,000,000`
-   - ثبت Transaction با PaymentStatus.Success
-   - ثبت UserWalletChangeLog (Balance + Discount)
-   - Update Order: PaymentStatus.Success, PaymentMethod.IPG
-   - Update User: PackagePurchaseMethod.DirectPurchase
-   
-   **Handler Logic (Failed):**
-   - Update Transaction: PaymentStatus.Reject
-   - Update Order: PaymentStatus.Reject
-
-#### Proto Definition:
-```protobuf
-// package.proto
-service PackageContract {
-    rpc InitiateBasePackagePayment(InitiateBasePackagePaymentRequest) 
-        returns (InitiateBasePackagePaymentResponse);
-    
-    rpc VerifyBasePackagePayment(VerifyBasePackagePaymentRequest) 
-        returns (VerifyBasePackagePaymentResponse);
-}
-
-message InitiateBasePackagePaymentRequest {
-    int64 user_id = 1;
-}
-
-message InitiateBasePackagePaymentResponse {
-    bool success = 1;
-    string message = 2;
-    int64 order_id = 3;
-    int64 transaction_id = 4;
-    int64 amount = 5;
-}
-
-message VerifyBasePackagePaymentRequest {
-    int64 order_id = 1;
-    int64 transaction_id = 2;
-    bool payment_success = 3;
-    google.protobuf.StringValue ref_id = 4;
-    google.protobuf.StringValue message = 5;
-}
-
-message VerifyBasePackagePaymentResponse {
-    bool success = 1;
-    string message = 2;
-    int64 order_id = 3;
-    int64 transaction_id = 4;
-    google.protobuf.StringValue reference_code = 5;
-    int64 wallet_balance = 6;
-    int64 discount_balance = 7;
-}
-```
-
-#### Files Created/Modified:
-```
-CMS/src/CMSMicroservice.Application/PackageCQ/Commands/
-├── InitiateBasePackagePayment/
-│   ├── InitiateBasePackagePaymentCommand.cs
-│   ├── InitiateBasePackagePaymentCommandValidator.cs
-│   └── InitiateBasePackagePaymentCommandHandler.cs
-└── VerifyBasePackagePayment/
-    ├── VerifyBasePackagePaymentCommand.cs
-    ├── VerifyBasePackagePaymentCommandValidator.cs
-    └── VerifyBasePackagePaymentCommandHandler.cs
-
-CMS/src/CMSMicroservice.Protobuf/Protos/
-└── package.proto (updated)
-
-CMS/src/CMSMicroservice.WebApi/
-├── Services/PackageService.cs (updated)
-└── Common/Mappings/PackageProfile.cs (updated)
-```
-
---
-
-### BFF Layer
-
-#### Commands:
-1. **InitiateBasePackagePaymentCommand**
-   ```csharp
-   // Input (UserId از CurrentUserService گرفته می‌شود)
-   public record InitiateBasePackagePaymentCommand
-   {
-       public string CallbackUrl { get; init; }
-   }
-   
-   // Output
-   public class InitiateBasePackagePaymentResponseDto
-   {
-       public bool Success { get; set; }
-       public string Message { get; set; }
-       public long OrderId { get; set; }
-       public long TransactionId { get; set; }
-       public long Amount { get; set; }
-       public string PaymentGatewayUrl { get; set; }
-       public string Authority { get; set; }
-   }
-   ```
-
-   **Handler Logic:**
-   ```csharp
-   // 1. فراخوانی CMS
-   var cmsResponse = await _context.Package.InitiateBasePackagePaymentAsync(
-       new InitiateBasePackagePaymentRequest {
-           UserId = _currentUserService.UserId.Value
-       });
-   
-   // 2. فراخوانی PYMS
-   var paymentResponse = await _context.ZarinTransactions.PaymentRequestAsync(
-       new PaymentRequestRequest {
-           MerchantId = "...",
-           Amount = cmsResponse.Amount * 10, // تبدیل به ریال
-           CallbackUrl = $"{request.CallbackUrl}?orderId={...}&transactionId={...}",
-           Description = "پرداخت پکیج پایه",
-           Currency = CurrencyEnum.Irr,
-           Type = TransactionTypeEnum.Real
-       });
-   
-   // 3. Return URL + Authority
-   return new InitiateBasePackagePaymentResponseDto {
-       PaymentGatewayUrl = paymentResponse.PaymentGWUrl,
-       Authority = ExtractAuthorityFromUrl(paymentResponse.PaymentGWUrl),
-       ...
-   };
-   ```
-
-2. **VerifyBasePackagePaymentCommand**
-   ```csharp
-   // Input
-   public record VerifyBasePackagePaymentCommand
-   {
-       public long OrderId { get; init; }
-       public long TransactionId { get; init; }
-       public string Authority { get; init; }
-       public string Status { get; init; } // OK یا NOK
-   }
-   ```
-
-   **Handler Logic:**
-   ```csharp
-   // 1. بررسی Status
-   if (request.Status != "OK") {
-       await NotifyCmsPaymentFailed(...);
-       return Failed;
-   }
-   
-   // 2. Verify از PYMS
-   var verifyResponse = await _context.ZarinTransactions
-       .PaymentVerificationAsync(...);
-   
-   // 3. فراخوانی CMS
-   if (verifyResponse.PaymentStatus) {
-       var cmsResponse = await _context.Package.VerifyBasePackagePaymentAsync(
-           new VerifyBasePackagePaymentRequest {
-               OrderId = request.OrderId,
-               TransactionId = request.TransactionId,
-               PaymentSuccess = true,
-               RefId = verifyResponse.RefId,
-               Message = verifyResponse.Message
-           });
-       return Success;
-   } else {
-       await NotifyCmsPaymentFailed(...);
-       return Failed;
-   }
-   ```
-
-#### Proto Definition:
-```protobuf
-// package.proto
-service PackageContract {
-    rpc InitiateBasePackagePayment(InitiateBasePackagePaymentRequest) 
-        returns (InitiateBasePackagePaymentResponse) {
-        option (google.api.http) = {
-            post: "/InitiateBasePackagePayment"
-            body: "*"
-        };
-    };
-    
-    rpc VerifyBasePackagePayment(VerifyBasePackagePaymentRequest) 
-        returns (VerifyBasePackagePaymentResponse) {
-        option (google.api.http) = {
-            post: "/VerifyBasePackagePayment"
-            body: "*"
-        };
-    };
-}
-
-message InitiateBasePackagePaymentRequest {
-    string callback_url = 1;
-    // UserId از JWT token گرفته می‌شود
-}
-
-message InitiateBasePackagePaymentResponse {
-    bool success = 1;
-    string message = 2;
-    int64 order_id = 3;
-    int64 transaction_id = 4;
-    int64 amount = 5;
-    string payment_gateway_url = 6;
-    string authority = 7;
-}
-
-message VerifyBasePackagePaymentRequest {
-    int64 order_id = 1;
-    int64 transaction_id = 2;
-    string authority = 3;
-    string status = 4;
-}
-
-message VerifyBasePackagePaymentResponse {
-    bool success = 1;
-    string message = 2;
-    int64 order_id = 3;
-    int64 transaction_id = 4;
-    google.protobuf.StringValue ref_id = 5;
-    int64 wallet_balance = 6;
-    int64 discount_balance = 7;
-}
-```
-
-#### Files Created/Modified:
-```
-FrontOffice.BFF/src/FrontOffice.BFF.Application/PackageCQ/Commands/
-├── InitiateBasePackagePayment/
-│   ├── InitiateBasePackagePaymentCommand.cs
-│   ├── InitiateBasePackagePaymentCommandValidator.cs
-│   └── InitiateBasePackagePaymentCommandHandler.cs
-└── VerifyBasePackagePayment/
-    ├── VerifyBasePackagePaymentCommand.cs
-    ├── VerifyBasePackagePaymentCommandValidator.cs
-    └── VerifyBasePackagePaymentCommandHandler.cs
-
-FrontOffice.BFF/src/Protobufs/FrontOffice.BFF.Package.Protobuf/Protos/
-└── package.proto (updated)
-
-FrontOffice.BFF/src/FrontOffice.BFF.WebApi/
-├── Services/PackageService.cs (updated)
-└── Common/Mappings/PackageProfile.cs (updated)
-
-FrontOffice.BFF/src/FrontOffice.BFF.Domain/
-└── FrontOffice.BFF.Domain.csproj (updated - added CMS Proto reference)
-```
-
---
-
-### Frontend Layer
-
-#### Pages:
-1. **Profile/Index.razor.cs**
-   - نمایش دکمه "خرید پکیج پایه"
-   - Bottom Sheet با دو گزینه: پرداخت مستقیم / اعتبار الماسی
-   - فراخوانی BFF.InitiateBasePackagePayment
-
-   ```csharp
-   private async Task DirectPayment()
-   {
-       var callbackUrl = $"{Navigation.BaseUri}profile/payment-callback";
-       
-       var response = await PackageContract.InitiateBasePackagePaymentAsync(
-           new InitiateBasePackagePaymentRequest {
-               CallbackUrl = callbackUrl
-           });
-       
-       if (response.Success) {
-           Navigation.NavigateTo(response.PaymentGatewayUrl, forceLoad: true);
-       }
-   }
-   ```
-
-2. **Profile/PaymentCallback.razor**
-   - دریافت Query Parameters: orderId, transactionId, Authority, Status
-   - فراخوانی BFF.VerifyBasePackagePayment
-   - نمایش نتیجه (موفق/ناموفق)
-
-   ```csharp
-   protected override async Task OnAfterRenderAsync(bool firstRender)
-   {
-       if (firstRender) {
-           var response = await PackageContract.VerifyBasePackagePaymentAsync(
-               new VerifyBasePackagePaymentRequest {
-                   OrderId = OrderId,
-                   TransactionId = TransactionId,
-                   Authority = Authority,
-                   Status = Status
-               });
-           
-           // نمایش نتیجه
-       }
-   }
-   ```
-
-#### Files Created/Modified:
-```
-FrontOffice/src/FrontOffice.Main/Pages/Profile/
-├── Index.razor.cs (updated)
-└── PaymentCallback.razor (new)
-
-FrontOffice/src/FrontOffice.Main/Utilities/
-├── UserAuthInfo.cs (updated - added UserId)
-└── AuthService.cs (updated - extract UserId from JWT)
-
-FrontOffice/src/FrontOffice.Main/
-└── FrontOffice.Main.csproj (updated - added BFF Package Proto reference)
-```
-
---
-
-## 🔌 API Endpoints
-
-### BFF Endpoints (gRPC-Web + HTTP):
-
-```
-POST /InitiateBasePackagePayment
-Body: {
-  "callback_url": "https://example.com/profile/payment-callback"
-}
-
-Response: {
-  "success": true,
-  "message": "...",
-  "order_id": 123,
-  "transaction_id": 456,
-  "amount": 56000000,
-  "payment_gateway_url": "https://www.zarinpal.com/pg/StartPay/...",
-  "authority": "A00000000000000000000000000123456"
-}
-```
-
-```
-POST /VerifyBasePackagePayment
-Body: {
-  "order_id": 123,
-  "transaction_id": 456,
-  "authority": "A00000000000000000000000000123456",
-  "status": "OK"
-}
-
-Response: {
-  "success": true,
-  "message": "پرداخت با موفقیت تایید شد",
-  "order_id": 123,
-  "transaction_id": 456,
-  "ref_id": "789",
-  "wallet_balance": 56000000,
-  "discount_balance": 56000000
-}
-```
-
---
-
-## 📊 Flow Diagram
-
-### Complete Payment Flow:
-
-```mermaid
-sequenceDiagram
-    participant User as کاربر
-    participant FE as Frontend
-    participant BFF as BFF
-    participant CMS as CMS
-    participant PYMS as PYMS
-    participant Bank as درگاه بانک
-
-    User->>FE: کلیک "پرداخت مستقیم"
-    FE->>BFF: InitiateBasePackagePayment(CallbackUrl)
-    BFF->>BFF: استخراج UserId از JWT
-    BFF->>CMS: InitiateBasePackagePayment(UserId)
-    CMS->>CMS: ثبت Transaction (Pending)
-    CMS->>CMS: ثبت Order (Pending)
-    CMS-->>BFF: OrderId, TransactionId, Amount
-    
-    BFF->>PYMS: PaymentRequest(Amount, Callback)
-    PYMS-->>BFF: PaymentGWUrl, Authority
-    BFF-->>FE: PaymentGWUrl, OrderId, TransactionId
-    
-    FE->>Bank: Redirect to PaymentGWUrl
-    User->>Bank: پرداخت
-    Bank-->>FE: Redirect to Callback?Authority=...&Status=OK
-    
-    FE->>BFF: VerifyBasePackagePayment(OrderId, TransactionId, Authority, Status)
-    BFF->>PYMS: PaymentVerification(Authority)
-    PYMS-->>BFF: PaymentStatus, RefId
-    
-    alt پرداخت موفق
-        BFF->>CMS: VerifyBasePackagePayment(PaymentSuccess=true, RefId)
-        CMS->>CMS: شارژ Balance (56M)
-        CMS->>CMS: شارژ DiscountBalance (56M)
-        CMS->>CMS: ثبت Transaction (Success)
-        CMS->>CMS: ثبت WalletChangeLog
-        CMS->>CMS: Update Order (Success)
-        CMS->>CMS: Update User.PackagePurchaseMethod
-        CMS-->>BFF: Success, WalletBalance, DiscountBalance
-        BFF-->>FE: Success
-        FE-->>User: نمایش پیام موفقیت + موجودی
-    else پرداخت ناموفق
-        BFF->>CMS: VerifyBasePackagePayment(PaymentSuccess=false)
-        CMS->>CMS: Update Transaction (Reject)
-        CMS->>CMS: Update Order (Reject)
-        CMS-->>BFF: Failed
-        BFF-->>FE: Failed
-        FE-->>User: نمایش پیام خطا
-    end
-```
-
---
-
-## ⚠️ نکات مهم
-
-### Security:
-1. **UserId از JWT گرفته می‌شود** نه از Request - امنیت بالاتر
-2. **Validation در هر لایه** انجام می‌شود
-3. **Transaction Idempotency** - چک می‌شود که Order Pending قبلی وجود نداشته باشد
-
-### Business Logic:
-1. کاربر **فقط یک بار** می‌تواند پکیج پایه بخرد
-2. **شارژ هم‌زمان** Balance و DiscountBalance انجام می‌شود
-3. **PackagePurchaseMethod** بعد از پرداخت موفق به `DirectPurchase` تغییر می‌کند
-4. برای فعالسازی لینک دعوت، باید **هم پکیج خریداری شود هم باشگاه فعال شود**
-
-### Error Handling:
-1. اگر CMS خطا برگرداند، به درگاه نمی‌رویم
-2. اگر PYMS URL ندهد، Transaction در CMS باقی می‌ماند (Pending)
-3. اگر Callback با Status=NOK بیاید، مستقیماً Reject می‌شود
-4. اگر Verification ناموفق باشد، Transaction و Order به Reject تغییر می‌کند
-
-### Project References:
-برای development، از Project Reference استفاده می‌شود:
- BFF → CMS.Protobuf (Project Reference)
- Frontend → BFF.Package.Protobuf (Project Reference)
-
-برای production، باید به NuGet Package تبدیل شوند.
-
---
-
-## ✅ Checklist پیاده‌سازی
-
-### CMS:
- [x] InitiateBasePackagePaymentCommand
- [x] InitiateBasePackagePaymentCommandValidator
- [x] InitiateBasePackagePaymentCommandHandler
- [x] VerifyBasePackagePaymentCommand
- [x] VerifyBasePackagePaymentCommandValidator
- [x] VerifyBasePackagePaymentCommandHandler
- [x] Proto messages و RPCs
- [x] PackageService implementation
- [x] Mapster mappings
-
-### BFF:
- [x] InitiateBasePackagePaymentCommand
- [x] InitiateBasePackagePaymentCommandValidator
- [x] InitiateBasePackagePaymentCommandHandler
- [x] VerifyBasePackagePaymentCommand
- [x] VerifyBasePackagePaymentCommandValidator
- [x] VerifyBasePackagePaymentCommandHandler
- [x] Proto messages و RPCs
- [x] PackageService implementation
- [x] Mapster mappings
- [x] CurrentUserService integration
-
-### Frontend:
- [x] Bottom Sheet UI برای انتخاب روش پرداخت
- [x] DirectPayment method
- [x] PaymentCallback page
- [x] UserAuthInfo.UserId
- [x] AuthService extract UserId
- [x] Navigation to payment gateway
- [x] Display payment result
-
-### Testing:
- [ ] Test پرداخت موفق
- [ ] Test پرداخت ناموفق
- [ ] Test لغو پرداخت توسط کاربر
- [ ] Test خرید مجدد (باید خطا دهد)
- [ ] Test شارژ کیف پول
- [ ] Test فعالسازی لینک دعوت
-
---
-
-**تاریخ آخرین به‌روزرسانی:** 2024-12-16  
-**نگارنده:** Development Team
@@ -1,546 +0,0 @@
-# محاسبات پلن باینری (Binary Plan Calculations)
-
-## مستندات فرمول‌های محاسبه کمیسیون باینری
-
-این سند فرمول‌های محاسباتی سیستم کمیسیون باینری را که از فایل اکسل استخراج شده، توضیح می‌دهد.
-
---
-
-## متغیرها و تعاریف
-
-### ورودی‌های هفته قبل (Last Week Remainders)
-
-| نام فارسی | نماد | توضیحات |
-|-----------|------|---------|
-| **باقیمانده هفته قبل چپ** | `LL` (Last Left) | باقیمانده‌ای که از هفته قبل در پای چپ باقی مانده |
-| **باقیمانده هفته قبل راست** | `LR` (Last Right) | باقیمانده‌ای که از هفته قبل در پای راست باقی مانده |
-
-**مثال از اکسل:**
- `LL = 200` (میلیون ریال)
- `LR = 0`
-
---
-
-### ورودی‌های هفته جدید (New Week Values)
-
-| نام فارسی | نماد | توضیحات |
-|-----------|------|---------|
-| **هفته جدید چپ** | `NL` (New Left) | مجموع فروش/شارژ پای چپ در هفته جاری |
-| **هفته جدید راست** | `NR` (New Right) | مجموع فروش/شارژ پای راست در هفته جاری |
-
-**مثال از اکسل:**
- `NL = 400` (میلیون ریال)
- `NR = 500` (میلیون ریال)
-
---
-
-### پارامتر سیستم (System Parameter)
-
-| نام فارسی | نماد | توضیحات |
-|-----------|------|---------|
-| **ماکسیمم تعادل** | `MX` (Maximum Balance) | حداکثر مقداری که در یک هفته می‌تواند به عنوان تعادل (کمیسیون) محاسبه شود |
-
-**مثال از اکسل:**
- `MX = 300` (میلیون ریال)
-
-**نکته مهم:** این مقدار معمولاً بر اساس سطح کاربر یا پکیج خریداری شده تعیین می‌شود.
-
---
-
-## فرمول‌های محاسباتی
-
-### 1️⃣ محاسبه مجموع پا چپ (Sum Left Total)
-
-```
-SLT = LL + NL
-```
-
-**توضیح:**
- `SLT` (Sum Left Total) = مجموع کل پای چپ
- باقیمانده هفته قبل + فروش هفته جدید
-
-**مثال:**
-```
-SLT = 200 + 400 = 600
-```
-
---
-
-### 2️⃣ محاسبه مجموع پا راست (Sum Right Total)
-
-```
-SRT = LR + NR
-```
-
-**توضیح:**
- `SRT` (Sum Right Total) = مجموع کل پای راست
- باقیمانده هفته قبل + فروش هفته جدید
-
-**مثال:**
-```
-SRT = 0 + 500 = 500
-```
-
---
-
-### 3️⃣ محاسبه کمترین کل (Minimum Total)
-
-```
-MinT = MIN(SLT, SRT)
-```
-
-**توضیح:**
- `MinT` = کوچکترین مقدار بین دو پا
- این مقدار نشان‌دهنده حداکثر تعادل بالقوه است
-
-**مثال:**
-```
-MinT = MIN(600, 500) = 500
-```
-
---
-
-### 4️⃣ محاسبه باقیمانده هفته بعد چپ (Remainder Next Week Left)
-
-```
-RNWL = SLT - MinT
-```
-
-**توضیح:**
- `RNWL` (Remainder Next Week Left) = باقیمانده‌ای که به هفته بعد منتقل می‌شود
- مازاد پای چپ که برای تعادل استفاده نشد
-
-**مثال:**
-```
-RNWL = 600 - 500 = 100
-```
-
---
-
-### 5️⃣ محاسبه باقیمانده هفته بعد راست (Remainder Next Week Right)
-
-```
-RNWR = SRT - MinT
-```
-
-**توضیح:**
- `RNWR` (Remainder Next Week Right) = باقیمانده‌ای که به هفته بعد منتقل می‌شود
- مازاد پای راست که برای تعادل استفاده نشد
-
-**مثال:**
-```
-RNWR = 500 - 500 = 0
-```
-
-**نکته:** یکی از دو باقیمانده همیشه صفر است (چون MinT کوچکترین است).
-
---
-
-### 6️⃣ محاسبه فلش چپ (Flush Left)
-
-```
-FL = SLT - MX - RNWL
-```
-
-**توضیح:**
- `FL` (Flush Left) = مقداری که از ماکسیمم هم بیشتر بود و باید دور ریخته شود
- این مقدار نشان‌دهنده سرریز (overflow) است که نمی‌تواند به هفته بعد منتقل شود
-
-**مثال:**
-```
-FL = 600 - 300 - 100 = 200
-```
-
-**معنی:** از 600 میلیون پای چپ:
- 300 به عنوان کمیسیون استفاده شد (تا حد MX)
- 100 به هفته بعد منتقل شد
- **200 فلش شد (از دست رفت)** ❌
-
---
-
-### 7️⃣ محاسبه فلش راست (Flush Right)
-
-```
-FR = SRT - MX - RNWR
-```
-
-**توضیح:**
- `FR` (Flush Right) = مقداری که از پای راست دور ریخته می‌شود
-
-**مثال:**
-```
-FR = 500 - 300 - 0 = 200
-```
-
-**معنی:** از 500 میلیون پای راست:
- 300 به عنوان کمیسیون استفاده شد
- 0 به هفته بعد منتقل شد
- **200 فلش شد (از دست رفت)** ❌
-
---
-
-### 8️⃣ محاسبه کل تعادل (Total Balance / Commission)
-
-```
-TB = IF(MinT > MX, MX, MinT)
-```
-
-یا به زبان ساده‌تر:
-```
-TB = MIN(MinT, MX)
-```
-
-**توضیح:**
- `TB` (Total Balance) = مقدار واقعی کمیسیونی که به کاربر تعلق می‌گیرد
- نمی‌تواند از ماکسیمم تعادل (`MX`) بیشتر شود
-
-**مثال:**
-```
-TB = MIN(500, 300) = 300
-```
-
-**معنی:** هرچند تعادل واقعی 500 بود، اما به دلیل محدودیت `MX`، فقط 300 به عنوان کمیسیون پرداخت می‌شود.
-
---
-
-## خلاصه جریان محاسبات
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│ ورودی‌ها                                                     │
-├─────────────────────────────────────────────────────────────┤
-│ LL = 200     باقیمانده هفته قبل چپ                         │
-│ LR = 0       باقیمانده هفته قبل راست                       │
-│ NL = 400     هفته جدید چپ                                  │
-│ NR = 500     هفته جدید راست                                │
-│ MX = 300     ماکسیمم تعادل                                  │
-└─────────────────────────────────────────────────────────────┘
-                          ↓
-┌─────────────────────────────────────────────────────────────┐
-│ گام 1: محاسبه مجموع دو پا                                  │
-├─────────────────────────────────────────────────────────────┤
-│ SLT = LL + NL = 200 + 400 = 600                             │
-│ SRT = LR + NR = 0 + 500 = 500                               │
-└─────────────────────────────────────────────────────────────┘
-                          ↓
-┌─────────────────────────────────────────────────────────────┐
-│ گام 2: محاسبه کمترین کل                                    │
-├─────────────────────────────────────────────────────────────┤
-│ MinT = MIN(SLT, SRT) = MIN(600, 500) = 500                  │
-└─────────────────────────────────────────────────────────────┘
-                          ↓
-┌─────────────────────────────────────────────────────────────┐
-│ گام 3: محاسبه کمیسیون واقعی (با اعمال Cap)                │
-├─────────────────────────────────────────────────────────────┤
-│ TB = MIN(MinT, MX) = MIN(500, 300) = 300  ✅ کمیسیون        │
-└─────────────────────────────────────────────────────────────┘
-                          ↓
-┌─────────────────────────────────────────────────────────────┐
-│ گام 4: محاسبه باقیمانده هفته بعد                           │
-├─────────────────────────────────────────────────────────────┤
-│ RNWL = SLT - MinT = 600 - 500 = 100  → هفته بعد            │
-│ RNWR = SRT - MinT = 500 - 500 = 0    → هفته بعد            │
-└─────────────────────────────────────────────────────────────┘
-                          ↓
-┌─────────────────────────────────────────────────────────────┐
-│ گام 5: محاسبه فلش (از دست رفته)                            │
-├─────────────────────────────────────────────────────────────┤
-│ FL = SLT - MX - RNWL = 600 - 300 - 100 = 200  ❌ فلش        │
-│ FR = SRT - MX - RNWR = 500 - 300 - 0 = 200    ❌ فلش        │
-└─────────────────────────────────────────────────────────────┘
-```
-
---
-
-## تحلیل نتایج
-
-### 📊 خروجی‌های نهایی
-
-| مقدار | توضیح | وضعیت |
-|-------|-------|-------|
-| **TB = 300** | کمیسیون پرداختی این هفته | ✅ پرداخت می‌شود |
-| **RNWL = 100** | باقیمانده پای چپ برای هفته بعد | ⏭️ منتقل می‌شود |
-| **RNWR = 0** | باقیمانده پای راست برای هفته بعد | ⏭️ منتقل می‌شود |
-| **FL = 200** | فلش پای چپ | ❌ از دست می‌رود |
-| **FR = 200** | فلش پای راست | ❌ از دست می‌رود |
-
---
-
-### 🔍 تفسیر کسب‌وکار
-
-#### کمیسیون محاسبه شده
-```
-کمیسیون = 300 میلیون ریال
-```
- به دلیل محدودیت `MX = 300`، از تعادل بالقوه 500، فقط 300 قابل برداشت است
- این یک مکانیزم کنترل هزینه است
-
-#### باقیمانده به هفته بعد
-```
-هفته بعد LL = 100 (از پای چپ)
-هفته بعد LR = 0 (از پای راست)
-```
- 100 میلیون از پای چپ به هفته بعد منتقل می‌شود
- این باقیمانده در محاسبات هفته آینده دوباره استفاده خواهد شد
-
-#### فلش (Flush) - نکته مهم ⚠️
-```
-فلش کل = 400 میلیون ریال (200 چپ + 200 راست)
-```
-
-**چرا فلش رخ می‌دهد؟**
-1. مجموع دو پا = 1100 میلیون (600 + 500)
-2. کمیسیون محاسبه شده = 300 میلیون
-3. باقیمانده منتقل شده = 100 میلیون
-4. فلش = 1100 - 300 - 100 = 700 میلیون ❌
-
-**توضیح:**
- فلش نشان‌دهنده مقداری است که به دلیل **عدم تعادل** و **محدودیت Cap** از دست می‌رود
- این یک ضرر برای کاربر است که می‌تواند با متعادل کردن دو پا کاهش یابد
-
---
-
-## پیاده‌سازی در C#
-
-### کلاس مدل
-
-```csharp
-public class BinaryPlanCalculationInput
-{
-    // ورودی‌های هفته قبل
-    public decimal LastLeftRemainder { get; set; }      // LL
-    public decimal LastRightRemainder { get; set; }     // LR
-    
-    // ورودی‌های هفته جاری
-    public decimal NewLeftVolume { get; set; }          // NL
-    public decimal NewRightVolume { get; set; }         // NR
-    
-    // تنظیمات سیستم
-    public decimal MaximumBalance { get; set; }         // MX
-}
-
-public class BinaryPlanCalculationResult
-{
-    // محاسبات واسط
-    public decimal SumLeftTotal { get; set; }           // SLT
-    public decimal SumRightTotal { get; set; }          // SRT
-    public decimal MinimumTotal { get; set; }           // MinT
-    
-    // باقیمانده‌ها
-    public decimal RemainderNextWeekLeft { get; set; }  // RNWL
-    public decimal RemainderNextWeekRight { get; set; } // RNWR
-    
-    // فلش
-    public decimal FlushLeft { get; set; }              // FL
-    public decimal FlushRight { get; set; }             // FR
-    
-    // نتیجه نهایی
-    public decimal TotalBalance { get; set; }           // TB - کمیسیون واقعی
-    public decimal TotalFlush { get; set; }             // مجموع فلش
-}
-```
-
---
-
-### متد محاسبه
-
-```csharp
-public static BinaryPlanCalculationResult Calculate(BinaryPlanCalculationInput input)
-{
-    var result = new BinaryPlanCalculationResult();
-    
-    // گام 1: محاسبه مجموع دو پا
-    result.SumLeftTotal = input.LastLeftRemainder + input.NewLeftVolume;
-    result.SumRightTotal = input.LastRightRemainder + input.NewRightVolume;
-    
-    // گام 2: محاسبه کمترین کل
-    result.MinimumTotal = Math.Min(result.SumLeftTotal, result.SumRightTotal);
-    
-    // گام 3: محاسبه کمیسیون واقعی (با اعمال Cap)
-    result.TotalBalance = Math.Min(result.MinimumTotal, input.MaximumBalance);
-    
-    // گام 4: محاسبه باقیمانده هفته بعد
-    result.RemainderNextWeekLeft = result.SumLeftTotal - result.MinimumTotal;
-    result.RemainderNextWeekRight = result.SumRightTotal - result.MinimumTotal;
-    
-    // گام 5: محاسبه فلش
-    result.FlushLeft = result.SumLeftTotal - input.MaximumBalance - result.RemainderNextWeekLeft;
-    result.FlushRight = result.SumRightTotal - input.MaximumBalance - result.RemainderNextWeekRight;
-    
-    // محاسبه مجموع فلش
-    result.TotalFlush = result.FlushLeft + result.FlushRight;
-    
-    // اطمینان از عدم منفی شدن فلش
-    result.FlushLeft = Math.Max(0, result.FlushLeft);
-    result.FlushRight = Math.Max(0, result.FlushRight);
-    result.TotalFlush = Math.Max(0, result.TotalFlush);
-    
-    return result;
-}
-```
-
---
-
-### مثال استفاده
-
-```csharp
-var input = new BinaryPlanCalculationInput
-{
-    LastLeftRemainder = 200_000_000,   // 200 میلیون
-    LastRightRemainder = 0,
-    NewLeftVolume = 400_000_000,       // 400 میلیون
-    NewRightVolume = 500_000_000,      // 500 میلیون
-    MaximumBalance = 300_000_000       // 300 میلیون
-};
-
-var result = Calculate(input);
-
-Console.WriteLine($"کمیسیون قابل پرداخت: {result.TotalBalance:N0} ریال");
-// Output: کمیسیون قابل پرداخت: 300,000,000 ریال
-
-Console.WriteLine($"باقیمانده چپ هفته بعد: {result.RemainderNextWeekLeft:N0} ریال");
-// Output: باقیمانده چپ هفته بعد: 100,000,000 ریال
-
-Console.WriteLine($"باقیمانده راست هفته بعد: {result.RemainderNextWeekRight:N0} ریال");
-// Output: باقیمانده راست هفته بعد: 0 ریال
-
-Console.WriteLine($"فلش کل: {result.TotalFlush:N0} ریال");
-// Output: فلش کل: 400,000,000 ریال
-```
-
---
-
-## نکات مهم برای پیاده‌سازی
-
-### 1️⃣ ذخیره باقیمانده‌ها
-```csharp
-// باید در دیتابیس ذخیره شود
-await SaveWeeklyRemainders(userId, weekId, new WeeklyRemainders
-{
-    LeftRemainder = result.RemainderNextWeekLeft,
-    RightRemainder = result.RemainderNextWeekRight
-});
-```
-
-### 2️⃣ لاگ فلش برای تحلیل
-```csharp
-if (result.TotalFlush > 0)
-{
-    await LogFlush(userId, weekId, new FlushLog
-    {
-        FlushLeft = result.FlushLeft,
-        FlushRight = result.FlushRight,
-        Reason = "Cap limitation and imbalance"
-    });
-}
-```
-
-### 3️⃣ تعیین MaximumBalance
-```csharp
-// بر اساس سطح کاربر
-decimal GetMaximumBalance(User user)
-{
-    return user.MembershipLevel switch
-    {
-        MembershipLevel.Bronze => 100_000_000,
-        MembershipLevel.Silver => 300_000_000,
-        MembershipLevel.Gold => 500_000_000,
-        MembershipLevel.Platinum => 1_000_000_000,
-        _ => 50_000_000
-    };
-}
-```
-
-### 4️⃣ واحد پول
-```csharp
-// همه مقادیر باید در واحد ریال ذخیره شوند
-// برای نمایش می‌توان به میلیون یا تومان تبدیل کرد
-decimal DisplayInMillions(decimal rials) => rials / 1_000_000;
-decimal DisplayInTomans(decimal rials) => rials / 10;
-```
-
---
-
-## سناریوهای مختلف
-
-### سناریو 1: تعادل کامل
-```
-LL = 0, LR = 0, NL = 300, NR = 300, MX = 500
-→ TB = 300, RNWL = 0, RNWR = 0, FL = 0, FR = 0
-```
-**نتیجه:** کمیسیون کامل بدون فلش ✅
-
---
-
-### سناریو 2: یک پا خیلی بیشتر
-```
-LL = 0, LR = 0, NL = 1000, NR = 100, MX = 500
-→ TB = 100, RNWL = 900, RNWR = 0, FL = 400, FR = 0
-```
-**نتیجه:** کمیسیون کم + فلش زیاد ❌
-
---
-
-### سناریو 3: باقیمانده قبلی موثر
-```
-LL = 400, LR = 0, NL = 100, NR = 400, MX = 300
-→ SLT = 500, SRT = 400
-→ TB = 300, RNWL = 100, RNWR = 0, FL = 100, FR = 100
-```
-**نتیجه:** باقیمانده قبلی در محاسبه کمیسیون موثر است ✅
-
---
-
-## تفاوت با کد فعلی
-
-### در کد فعلی (`CalculateWeeklyBalancesCommandHandler.cs`):
-
-```csharp
-// 1. ابتدا Cap اعمال می‌شود
-var cappedLeft = Math.Min(leftLegTotal, maxBalance);
-var cappedRight = Math.Min(rightLegTotal, maxBalance);
-
-// 2. سپس تعادل محاسبه می‌شود
-var balance = Math.Min(cappedLeft, cappedRight);
-
-// 3. باقیمانده‌ها محاسبه می‌شوند
-var leftRemainder = leftLegTotal - balance;
-var rightRemainder = rightLegTotal - balance;
-```
-
-### در فرمول اکسل:
-```csharp
-// 1. ابتدا تعادل کامل محاسبه می‌شود
-var minTotal = Math.Min(leftLegTotal, rightLegTotal);
-
-// 2. سپس Cap اعمال می‌شود
-var balance = Math.Min(minTotal, maxBalance);
-
-// 3. باقیمانده‌ها بر اساس minTotal محاسبه می‌شوند
-var leftRemainder = leftLegTotal - minTotal;
-var rightRemainder = rightLegTotal - minTotal;
-
-// 4. فلش محاسبه می‌شود
-var flushLeft = leftLegTotal - maxBalance - leftRemainder;
-var flushRight = rightLegTotal - maxBalance - rightRemainder;
-```
-
-**تفاوت کلیدی:** 
- کد فعلی Cap را ابتدا اعمال می‌کند (می‌تواند باقیمانده‌های بیشتری ایجاد کند)
- فرمول اکسل ابتدا تعادل را محاسبه می‌کند، سپس Cap اعمال می‌شود (فلش دقیق‌تر محاسبه می‌شود)
-
---
-
-## نتیجه‌گیری
-
-این فرمول‌ها نشان می‌دهند که:
-
-1. ✅ **تعادل اهمیت دارد** - هرچه دو پا متعادل‌تر باشند، فلش کمتر است
-2. ✅ **Cap محدودیت ایجاد می‌کند** - حتی با تعادل کامل، بیش از MX کمیسیون داده نمی‌شود
-3. ✅ **باقیمانده‌ها منتقل می‌شوند** - برای هفته بعد ذخیره می‌شوند
-4. ❌ **فلش ضرر است** - مقداری که به دلیل عدم تعادل یا Cap از دست می‌رود
-
-**توصیه:** برای افزایش کمیسیون، کاربران باید:
- دو پای خود را متعادل نگه دارند
- سطح عضویت خود را ارتقا دهند (برای افزایش MX)
- از باقیمانده‌ها در هفته‌های بعد استفاده کنند
@@ -1,281 +0,0 @@
-# 🌳 Binary Tree Network Registration Guide
-
-## 📋 Overview
-
-از این پس، هر کاربر جدید که در سیستم ثبت می‌شود، **هم‌زمان** در دو ساختار قرار می‌گیرد:
-
-1. **Old System**: `User.ParentId` (برای Backward Compatibility)
-2. **New Binary Tree System**: `User.NetworkParentId` + `User.LegPosition` (Left/Right)
-
-این تغییر تضمین می‌کند که:
- ✅ کاربران جدید بلافاصله در محاسبات Commission شرکت می‌کنند
- ✅ نیازی به Migration اضافی نیست
- ✅ Binary Tree Constraint رعایت می‌شود (حداکثر 2 فرزند)
-
---
-
-## 🔧 Changes in Registration Flow
-
-### قبل از تغییر:
-
-```csharp
-var entity = request.Adapt<User>();
-entity.ReferralCode = UtilExtensions.Generate(digits: 10);
-await _context.Users.AddAsync(entity, cancellationToken);
-```
-
-**مشکل**: فقط `ParentId` Set می‌شد، `NetworkParentId` و `LegPosition` خالی می‌ماند.
-
---
-
-### بعد از تغییر:
-
-```csharp
-var entity = request.Adapt<User>();
-entity.ReferralCode = UtilExtensions.Generate(digits: 10);
-
-// === محاسبه موقعیت در Binary Tree ===
-if (request.ParentId.HasValue)
-{
-    var legPosition = await _networkPlacementService.CalculateLegPositionAsync(
-        request.ParentId.Value, cancellationToken);
-
-    if (legPosition.HasValue)
-    {
-        entity.NetworkParentId = request.ParentId.Value;
-        entity.LegPosition = legPosition.Value; // Left یا Right
-    }
-    else
-    {
-        // Parent پر است! Auto-Placement یا Error
-        var availableParent = await _networkPlacementService.FindAvailableParentAsync(
-            request.ParentId.Value, cancellationToken);
-        
-        // ... Set کردن NetworkParentId و LegPosition با Parent جدید
-    }
-}
-
-await _context.Users.AddAsync(entity, cancellationToken);
-```
-
-**مزایا**:
- ✅ `NetworkParentId` و `LegPosition` به صورت خودکار محاسبه می‌شود
- ✅ Binary Tree Constraint چک می‌شود
- ✅ اگر Parent پر باشد، Auto-Placement انجام می‌شود
-
---
-
-## 📐 Binary Tree Logic
-
-### قوانین:
-1. هر Parent فقط **2 فرزند** می‌تواند داشته باشد (Left & Right)
-2. فرزند اول: `LegPosition = Left`
-3. فرزند دوم: `LegPosition = Right`
-4. اگر Parent پر باشد، سیستم به صورت BFS دنبال Parent خالی می‌گردد
-
-### مثال:
-
-```
-        User1 (Root)
-        /          \
-    User2 (L)    User3 (R)
-    /      \
-User4(L)  User5(R)
-```
-
- User2 → Parent=User1, Leg=Left
- User3 → Parent=User1, Leg=Right
- User4 → Parent=User2, Leg=Left
- User5 → Parent=User2, Leg=Right
-
-اگر کاربر جدید با `ParentId=User1` بیاید:
- User1 پر است! (دو فرزند دارد)
- سیستم به User2 می‌رود (BFS)
- User2 هم پر است!
- به User3 می‌رود → User3 خالی است
- کاربر جدید → Parent=User3, Leg=Left
-
---
-
-## 🛠️ NetworkPlacementService API
-
-### 1. CalculateLegPositionAsync
-محاسبه موقعیت (Left/Right) برای کاربر جدید زیر یک Parent مشخص.
-
-```csharp
-var legPosition = await _networkPlacementService.CalculateLegPositionAsync(parentId);
-```
-
-**Return Values**:
- `NetworkLeg.Left`: اگر Parent فرزند چپ ندارد
- `NetworkLeg.Right`: اگر Parent فرزند راست ندارد
- `null`: اگر Parent پر است (دو فرزند دارد)
-
---
-
-### 2. CanAcceptChildAsync
-بررسی اینکه آیا Parent می‌تواند فرزند جدید بپذیرد.
-
-```csharp
-bool canAccept = await _networkPlacementService.CanAcceptChildAsync(parentId);
-```
-
-**Return Values**:
- `true`: اگر Parent کمتر از 2 فرزند دارد
- `false`: اگر Parent پر است
-
---
-
-### 3. FindAvailableParentAsync (Auto-Placement)
-پیدا کردن اولین Parent خالی در Binary Tree با استفاده از BFS.
-
-```csharp
-long? availableParentId = await _networkPlacementService.FindAvailableParentAsync(rootParentId);
-```
-
-**Use Case**:
- زمانی که Parent مورد نظر پر است
- سیستم به صورت خودکار Parent جایگزین پیدا می‌کند
- از BFS استفاده می‌کند (Level-by-Level)
-
-**Return Values**:
- `long`: شناسه Parent مناسب
- `null`: اگر هیچ Parent خالی پیدا نشد (تمام Binary Tree پر است!)
-
---
-
-## ⚠️ Error Handling
-
-### Scenario 1: Parent پر است و Auto-Placement موفق
-
-```csharp
-// Parent اصلی پر است
-// سیستم Parent جدید پیدا می‌کند
-_logger.LogWarning("Parent {ParentId} is full. Auto-placing under {NewParentId}");
-```
-
-**نتیجه**: کاربر با موفقیت در جای دیگری قرار می‌گیرد.
-
---
-
-### Scenario 2: کل Binary Tree پر است
-
-```csharp
-throw new InvalidOperationException(
-    $"شبکه Parent با شناسه {parentId} پر است و نمی‌تواند کاربر جدید بپذیرد.");
-```
-
-**نتیجه**: Exception پرتاب می‌شود، ثبت کاربر انجام نمی‌شود.
-
-**راه حل**:
- افزایش سطح Binary Tree
- یا تخصیص دستی Parent
-
---
-
-### Scenario 3: Parent وجود ندارد
-
-```csharp
-var parentExists = await _context.Users.AnyAsync(u => u.Id == parentId);
-if (!parentExists)
-{
-    return null; // Parent نامعتبر
-}
-```
-
-**نتیجه**: `null` برگردانده می‌شود، Exception پرتاب می‌شود.
-
---
-
-## 📊 Logging & Monitoring
-
-سیستم Log های زیر را می‌نویسد:
-
-### Success:
-```
-User 123 placed in Binary Tree: Parent=45, Leg=Left
-```
-
-### Warning (Auto-Placement):
-```
-Parent 45 has no available leg! Finding alternative parent...
-User 123 auto-placed under alternative Parent=67, Leg=Right
-```
-
-### Error (Binary Tree Full):
-```
-No available parent found in network for ParentId=45
-```
-
---
-
-## 🧪 Testing Scenarios
-
-### Test 1: کاربر اول (Root)
-```csharp
-var command = new CreateNewUserCommand { Mobile = "09121234567" }; // No ParentId
-// Result: ParentId=null, NetworkParentId=null, LegPosition=null
-```
-
---
-
-### Test 2: فرزند اول
-```csharp
-var command = new CreateNewUserCommand { Mobile = "09121234568", ParentId = 1 };
-// Result: ParentId=1, NetworkParentId=1, LegPosition=Left
-```
-
---
-
-### Test 3: فرزند دوم
-```csharp
-var command = new CreateNewUserCommand { Mobile = "09121234569", ParentId = 1 };
-// Result: ParentId=1, NetworkParentId=1, LegPosition=Right
-```
-
---
-
-### Test 4: فرزند سوم (Parent پر است)
-```csharp
-var command = new CreateNewUserCommand { Mobile = "09121234570", ParentId = 1 };
-// Result: Auto-Placement → ParentId=1, NetworkParentId=2 (یا 3), LegPosition=Left
-```
-
---
-
-## 🔗 Related Files
-
- **Service Interface**: `CMSMicroservice.Application/Common/Interfaces/INetworkPlacementService.cs`
- **Service Implementation**: `CMSMicroservice.Infrastructure/Services/NetworkPlacementService.cs`
- **Handler**: `CMSMicroservice.Application/UserCQ/Commands/CreateNewUser/CreateNewUserCommandHandler.cs`
- **DI Registration**: `CMSMicroservice.Infrastructure/ConfigureServices.cs` (خط 23)
-
---
-
-## ✅ Checklist
-
- [x] `INetworkPlacementService` اضافه شد
- [x] `NetworkPlacementService` پیاده‌سازی شد
- [x] DI Container تنظیم شد
- [x] `CreateNewUserCommandHandler` اصلاح شد
- [ ] Unit Tests نوشته شود
- [ ] Integration Tests انجام شود
- [ ] Manual Testing با Postman/gRPC Client
-
---
-
-## 🚀 Next Steps
-
-1. **Test کردن**: ثبت چند کاربر با Parent مشابه و بررسی LegPosition
-2. **Load Testing**: بررسی Performance با 10,000 کاربر
-3. **Edge Cases**: تست Binary Tree Full scenario
-4. **Documentation**: Update کردن API Docs
-
---
-
-## 📞 Support
-
-اگر مشکلی پیش آمد:
- Log های `NetworkPlacementService` را بررسی کنید
- چک کنید که DI به درستی تنظیم شده باشد
- از `CanAcceptChildAsync` برای Pre-Validation استفاده کنید
@@ -1,380 +0,0 @@
-# ✅ اصلاح محاسبه کمیسیون هفتگی - تحلیل و پیاده‌سازی
-
-**تاریخ شروع**: ۱۴ آذر ۱۴۰۴ (2025-12-04)  
-**تاریخ تکمیل**: ۱۴ آذر ۱۴۰۴  
-**وضعیت**: ✅ تکمیل شد  
-**اولویت**: 🔴 بحرانی - تأثیر مستقیم بر بیزینس
-
---
-
-## 📊 خلاصه مشکلات
-
-### مشکل ۱: محدودیت لول (Max Network Level) پیاده‌سازی نشده
- **مشکل**: شمارش اعضا بدون محدودیت عمق انجام می‌شود
- **انتظار**: فقط تا ۱۵ لول پایین‌تر باید شمارش شود
- **راه‌حل**: اضافه کردن پارامتر `maxLevel` به متد بازگشتی و خواندن از Config
-
-### مشکل ۲: تعادل شخص vs تعادل شبکه (بحرانی)
- **مشکل**: کمیسیون بر اساس تعادل شخصی محاسبه می‌شود (نه مجموع زیرمجموعه)
- **انتظار**: کمیسیون = (تعادل شخص + تعادل زیرمجموعه تا ۱۵ لول) × ارزش هر تعادل
- **راه‌حل**: محاسبه تعادل‌های زیرمجموعه در ProcessUserPayouts
-
---
-
-## 🎯 قانون صحیح کمیسیون (بیزینس)
-
-### فرمول محاسبه کمیسیون هفتگی:
-
-```
-1️⃣ محاسبه تعادل هر شخص:
-   - تعادل_شخص = MIN(چپ، راست)
-   - سقف هر دست = 300
-   - حداکثر تعادل شخصی = 300
-
-2️⃣ محاسبه کل تعادل‌های شبکه:
-   - کل_تعادل_شبکه = SUM(تعادل_شخصی همه اعضا)
-
-3️⃣ محاسبه صندوق:
-   - صندوق_هفتگی = SUM(سهم_استخر همه اعضا)
-   - سهم_استخر هر عضو = تعداد_زیرمجموعه_جدید × هزینه_فعال‌سازی × ۲۰%
-
-4️⃣ ارزش هر تعادل:
-   - ارزش_هر_تعادل = صندوق_هفتگی ÷ کل_تعادل_شبکه
-
-5️⃣ کمیسیون هر شخص:
-   - مجموع_تعادل = تعادل_شخص + SUM(تعادل_زیرمجموعه تا 15 لول)
-   - کمیسیون = مجموع_تعادل × ارزش_هر_تعادل
-```
-
-### مثال عملی:
-
-```
-شبکه:
-User A
-├─ Left: User B (تعادل: 5)
-│   ├─ Left: User D (تعادل: 2)
-│   └─ Right: User E (تعادل: 1)
-└─ Right: User C (تعادل: 3)
-    └─ Left: User F (تعادل: 1)
-
-فرض: تعادل شخصی User A = 10
-
-محاسبه مجموع تعادل User A (تا 15 لول):
-  = 10 + 5 + 2 + 1 + 3 + 1 = 22 تعادل
-
-اگر ارزش هر تعادل = 1,000,000 ریال:
-  کمیسیون User A = 22 × 1,000,000 = 22,000,000 ریال
-```
-
---
-
-## 🔍 تحلیل کد فعلی
-
-### فایل‌های تأثیرپذیر:
-
-| # | فایل | وضعیت فعلی | نیاز به تغییر |
-|---|------|------------|---------------|
-| 1 | `ApplicationDbContextInitialiser.cs` | ندارد `MaxNetworkLevel` | ✅ اضافه Config |
-| 2 | `CalculateWeeklyBalancesCommandHandler.cs` | بدون محدودیت لول | ✅ اضافه maxLevel |
-| 3 | `ProcessUserPayoutsCommandHandler.cs` | فقط تعادل شخص | ✅ جمع زیرمجموعه |
-| 4 | `NetworkWeeklyBalance.cs` | Entity | ⚪ نیاز ندارد |
-| 5 | `UserCommissionPayout.cs` | Entity | 🟡 شاید فیلد جدید |
-
-### کد فعلی `ProcessUserPayoutsCommandHandler`:
-
-```csharp
-// ❌ مشکل: فقط تعادل شخصی
-foreach (var balance in weeklyBalances)
-{
-    var totalAmount = (long)(balance.TotalBalances * pool.ValuePerBalance);
-    // ...
-}
-```
-
-### کد صحیح باید باشد:
-
-```csharp
-// ✅ صحیح: تعادل شخصی + زیرمجموعه تا 15 لول
-foreach (var balance in weeklyBalances)
-{
-    // محاسبه مجموع تعادل‌های زیرمجموعه
-    var subordinateBalances = await CalculateSubordinateBalances(
-        balance.UserId, 
-        request.WeekNumber,
-        maxNetworkLevel, // از Config
-        cancellationToken
-    );
-    
-    var totalBalancesWithSubordinates = balance.TotalBalances + subordinateBalances;
-    var totalAmount = (long)(totalBalancesWithSubordinates * pool.ValuePerBalance);
-    // ...
-}
-```
-
---
-
-## 📋 تسک‌های اجرایی
-
-### فاز ۱: Configuration (نیم روز)
-
-#### تسک ۱.۱: اضافه کردن MaxNetworkLevel به Seed Data
-```csharp
-// ApplicationDbContextInitialiser.cs
-new SystemConfiguration
-{
-    Key = "Commission.MaxNetworkLevel",
-    Value = "15",
-    Description = "حداکثر عمق شبکه برای محاسبه کمیسیون (تعداد لول)",
-    Scope = ConfigurationScope.Commission,
-    IsActive = true
-}
-```
-
-#### تسک ۱.۲: Migration (در صورت نیاز)
- اگر دیتابیس موجود دارید، یک SQL Script یا Migration
-
---
-
-### فاز ۲: اصلاح CalculateWeeklyBalances (نیم روز)
-
-#### تسک ۲.۱: خواندن MaxNetworkLevel از Config
-```csharp
-// در Handle method
-var maxNetworkLevel = int.Parse(configs.GetValueOrDefault("Commission.MaxNetworkLevel", "15"));
-```
-
-#### تسک ۲.۲: اضافه کردن محدودیت لول به متد بازگشتی
-```csharp
-private async Task<int> CountNewMembersRecursive(
-    long userId, 
-    NetworkLeg leg, 
-    DateTime startDate, 
-    DateTime endDate, 
-    int currentLevel,    // ← جدید
-    int maxLevel,        // ← جدید
-    CancellationToken cancellationToken)
-{
-    // ⬅️ محدودیت عمق
-    if (currentLevel >= maxLevel) 
-        return 0;
-
-    var child = await _context.Users
-        .FirstOrDefaultAsync(x => x.NetworkParentId == userId && x.LegPosition == leg, cancellationToken);
-
-    if (child == null)
-        return 0;
-
-    // ... محاسبه count ...
-
-    // ⬅️ افزایش سطح
-    var childLeft = await CountNewMembersRecursive(child.Id, NetworkLeg.Left, startDate, endDate, currentLevel + 1, maxLevel, cancellationToken);
-    var childRight = await CountNewMembersRecursive(child.Id, NetworkLeg.Right, startDate, endDate, currentLevel + 1, maxLevel, cancellationToken);
-
-    return count + childLeft + childRight;
-}
-```
-
---
-
-### فاز ۳: اصلاح ProcessUserPayouts (۱ روز)
-
-#### تسک ۳.۱: اضافه کردن متد محاسبه تعادل زیرمجموعه
-```csharp
-/// <summary>
-/// محاسبه مجموع تعادل‌های زیرمجموعه یک کاربر تا N لول
-/// </summary>
-private async Task<int> CalculateSubordinateBalancesAsync(
-    long userId,
-    string weekNumber,
-    int maxLevel,
-    CancellationToken cancellationToken)
-{
-    var totalSubordinateBalances = 0;
-    
-    // پیدا کردن همه زیرمجموعه‌ها تا maxLevel
-    var subordinates = await GetSubordinatesRecursive(userId, 1, maxLevel, cancellationToken);
-    
-    // جمع تعادل‌های آنها
-    foreach (var subordinateId in subordinates)
-    {
-        var balance = await _context.NetworkWeeklyBalances
-            .Where(x => x.UserId == subordinateId && x.WeekNumber == weekNumber)
-            .Select(x => x.TotalBalances)
-            .FirstOrDefaultAsync(cancellationToken);
-            
-        totalSubordinateBalances += balance;
-    }
-    
-    return totalSubordinateBalances;
-}
-
-/// <summary>
-/// پیدا کردن بازگشتی زیرمجموعه‌ها
-/// </summary>
-private async Task<List<long>> GetSubordinatesRecursive(
-    long userId, 
-    int currentLevel, 
-    int maxLevel, 
-    CancellationToken cancellationToken)
-{
-    if (currentLevel > maxLevel)
-        return new List<long>();
-        
-    var result = new List<long>();
-    
-    // پیدا کردن فرزندان مستقیم
-    var children = await _context.Users
-        .Where(x => x.NetworkParentId == userId)
-        .Select(x => x.Id)
-        .ToListAsync(cancellationToken);
-        
-    result.AddRange(children);
-    
-    // بازگشت برای هر فرزند
-    foreach (var childId in children)
-    {
-        var grandChildren = await GetSubordinatesRecursive(childId, currentLevel + 1, maxLevel, cancellationToken);
-        result.AddRange(grandChildren);
-    }
-    
-    return result;
-}
-```
-
-#### تسک ۳.۲: اصلاح Handle method
-```csharp
-public async Task<int> Handle(ProcessUserPayoutsCommand request, CancellationToken cancellationToken)
-{
-    // ... کدهای موجود ...
-    
-    // خواندن MaxNetworkLevel از Config
-    var maxNetworkLevel = await _context.SystemConfigurations
-        .Where(x => x.Key == "Commission.MaxNetworkLevel" && x.IsActive)
-        .Select(x => x.Value)
-        .FirstOrDefaultAsync(cancellationToken);
-    var maxLevel = int.Parse(maxNetworkLevel ?? "15");
-
-    foreach (var balance in weeklyBalances)
-    {
-        // ✅ محاسبه تعادل شخص + زیرمجموعه
-        var subordinateBalances = await CalculateSubordinateBalancesAsync(
-            balance.UserId, 
-            request.WeekNumber,
-            maxLevel,
-            cancellationToken
-        );
-        
-        var totalBalancesWithSubordinates = balance.TotalBalances + subordinateBalances;
-        var totalAmount = (long)(totalBalancesWithSubordinates * pool.ValuePerBalance);
-
-        var payout = new UserCommissionPayout
-        {
-            UserId = balance.UserId,
-            WeekNumber = request.WeekNumber,
-            WeeklyPoolId = pool.Id,
-            BalancesEarned = totalBalancesWithSubordinates, // ← شامل زیرمجموعه
-            ValuePerBalance = pool.ValuePerBalance,
-            TotalAmount = totalAmount,
-            // ...
-        };
-        // ...
-    }
-}
-```
-
-#### تسک ۳.۳ (اختیاری): اضافه کردن فیلد به Entity
-```csharp
-// UserCommissionPayout.cs
-/// <summary>
-/// تعادل شخصی (بدون زیرمجموعه)
-/// </summary>
-public int PersonalBalances { get; set; }
-
-/// <summary>
-/// تعادل زیرمجموعه‌ها
-/// </summary>
-public int SubordinateBalances { get; set; }
-
-/// <summary>
-/// مجموع (PersonalBalances + SubordinateBalances)
-/// </summary>
-public int BalancesEarned { get; set; } // ← قبلاً هم بود
-```
-
---
-
-### فاز ۴: تست و Build (نیم روز)
-
-#### تسک ۴.۱: Build و رفع خطاها
-```bash
-cd CMS/src && dotnet build
-```
-
-#### تسک ۴.۲: تست با سناریوهای مختلف
- کاربر بدون زیرمجموعه
- کاربر با ۵ لول زیرمجموعه
- کاربر با ۲۰ لول (باید ۱۵ تا بشمارد)
- کاربر با سقف ۳۰۰ در هر دست
-
---
-
-## ⏱️ زمان‌بندی
-
-| فاز | تسک | زمان | مجموع |
-|-----|-----|------|-------|
-| ۱ | Config + Seed | 0.5 روز | 0.5 روز |
-| ۲ | اصلاح CalculateWeeklyBalances | 0.5 روز | 1 روز |
-| ۳ | اصلاح ProcessUserPayouts | 1 روز | 2 روز |
-| ۴ | تست و Build | 0.5 روز | 2.5 روز |
-
-**مجموع**: ۲.۵ روز کاری
-
---
-
-## ⚠️ نکات مهم
-
-1. **تغییرات Breaking نیست**: ساختار Entity تغییر نمی‌کند (فقط مقادیر)
-2. **Backward Compatible**: فیلد `BalancesEarned` قبلاً هم بود
-3. **Idempotent**: با `ForceRecalculate` می‌توان دوباره حساب کرد
-4. **Performance**: متد بازگشتی ممکن است کند باشد - بهینه‌سازی در فاز بعد
-5. **Migration**: فقط اگر فیلد جدید به Entity اضافه شود
-
---
-
-## ✅ وضعیت پیاده‌سازی - تکمیل شده
-
-**تاریخ تکمیل**: ۱۴ آذر ۱۴۰۴
-
-| فاز | شرح | وضعیت |
-|-----|-----|------|
-| 1 | Config: `Commission.MaxNetworkLevel = 15` | ✅ تکمیل |
-| 2 | CalculateWeeklyBalances: محدودیت ۱۵ لول | ✅ تکمیل |
-| 3 | ProcessUserPayouts: جمع تعادل زیرمجموعه | ✅ تکمیل |
-| 4 | Build Test: 0 Errors | ✅ تکمیل |
-
-### تغییرات انجام شده:
-
-**Seed Data:**
- ✅ `Commission.MaxNetworkLevel = 15`
-
-**CalculateWeeklyBalancesCommandHandler:**
- ✅ خواندن `maxNetworkLevel` از Config
- ✅ پارامتر `maxLevel` به `CountNewMembersInLeg`
- ✅ پارامتر `currentLevel` و `maxLevel` به `CountNewMembersRecursive`
- ✅ شرط توقف در عمق ۱۵
-
-**ProcessUserPayoutsCommandHandler:**
- ✅ متد جدید `SumSubordinateBalancesAsync`
- ✅ متد کمکی `GetChildUserIdAsync`
- ✅ محاسبه `subordinateBalances` برای هر کاربر
- ✅ کمیسیون = (شخص + زیرمجموعه) × ارزش هر تعادل
-
---
-
-## 🎉 نتیجه نهایی
-
-```
-✅ Build Succeeded - 0 Errors
-✅ همه فازها تکمیل شدند
-✅ منطق کمیسیون اصلاح شد
-```
@@ -1,317 +0,0 @@
-# اصلاحات سیستم کمیسیون هفتگی
-
-## 📋 خلاصه تغییرات
-
-سیستم کمیسیون هفتگی از **3 مرحله به 2 مرحله** ساده‌سازی شد:
-
-### ❌ قبل (3 مرحله):
-1. `CalculateWeeklyBalances` - محاسبه تعادل‌ها
-2. `CalculateWeeklyCommissionPool` - محاسبه استخر
-3. `ProcessUserPayouts` - پردازش پرداخت‌ها (تکراری!)
-
-### ✅ بعد (2 مرحله):
-1. `CalculateWeeklyBalances` - محاسبه تعادل‌ها تا 15 لول
-2. `CalculateWeeklyCommissionPool` - محاسبه استخر + پردازش پرداخت‌ها
-
---
-
-## 🔧 تغییرات جزئی
-
-### 1️⃣ اضافه شدن فیلدها به `NetworkWeeklyBalance`
-
-**فیلدهای جدید:**
-```csharp
-/// <summary>
-/// مقدار فلش هر طرف (بعد از اعمال Cap)
-/// </summary>
-public int FlushedPerSide { get; set; }
-
-/// <summary>
-/// مجموع فلش از دو طرف (از دست رفته)
-/// </summary>
-public int TotalFlushed { get; set; }
-```
-
-**Migration:** `AddFlushedFieldsToNetworkWeeklyBalance`
-
---
-
-### 2️⃣ اصلاح `CalculateWeeklyBalances`
-
-**تغییرات:**
- ✅ فیلدهای `FlushedPerSide` و `TotalFlushed` ذخیره می‌شوند
- ✅ `WeeklyPoolContribution = 0` (دیگر در این مرحله محاسبه نمیشه)
- ✅ محدودیت 15 لول قبلاً موجود بود و درست کار می‌کند
-
-**کد:**
-```csharp
-// محاسبه فلش
-var flushedPerSide = totalBalances - cappedBalances;
-var totalFlushed = flushedPerSide * 2;
-
-// ذخیره
-balance.FlushedPerSide = flushedPerSide;
-balance.TotalFlushed = totalFlushed;
-balance.WeeklyPoolContribution = 0; // Pool در مرحله بعد محاسبه میشه
-```
-
---
-
-### 3️⃣ اصلاح کامل `CalculateWeeklyCommissionPool`
-
-**منطق جدید Pool:**
-```csharp
-// 1. Pool از فعالسازی‌های باشگاه این هفته میاد (نه از تعادل‌ها)
-var newClubMembersCount = await _context.ClubMemberships
-    .Where(c => c.ActivatedAt >= startDate && c.ActivatedAt <= endDate)
-    .CountAsync();
-
-var totalPoolAmount = newClubMembersCount * activationFee;
-
-// 2. ارزش هر امتیاز
-var totalBalancesInNetwork = weeklyBalances.Sum(x => x.TotalBalances);
-var valuePerBalance = totalPoolAmount / totalBalancesInNetwork;
-```
-
-**افزوده شدن محاسبه تعادل زیرمجموعه:**
-```csharp
-// برای هر کاربر:
-// 1. تعادل خودش
-var directBalances = balance.TotalBalances;
-
-// 2. تعادل زیرمجموعه (تا 15 لول)
-var subordinateBalances = await CalculateSubordinateBalancesAsync(
-    balance.UserId, 
-    request.WeekNumber, 
-    maxLevels: 15
-);
-
-var totalBalancesForUser = directBalances + subordinateBalances;
-```
-
-**ایجاد UserCommissionPayout:**
-```csharp
-var payout = new UserCommissionPayout
-{
-    UserId = balance.UserId,
-    WeekNumber = request.WeekNumber,
-    WeeklyPoolId = existingPool.Id,
-    BalancesEarned = totalBalancesForUser,
-    ValuePerBalance = valuePerBalance,
-    TotalAmount = totalBalancesForUser * valuePerBalance,
-    Status = CommissionPayoutStatus.Pending,
-    // ... subordinate fields
-};
-```
-
-**ثبت تاریخچه:**
-```csharp
-var history = new CommissionPayoutHistory
-{
-    UserId = payout.UserId,
-    PayoutId = payout.Id,
-    Amount = payout.TotalAmount,
-    Status = CommissionPayoutStatus.Pending,
-    ChangeReason = "محاسبه اولیه کمیسیون هفتگی"
-};
-```
-
---
-
-### 4️⃣ ساده‌سازی `TriggerWeeklyCalculation`
-
-**قبل:**
-```csharp
-// Step 1
-await _mediator.Send(new CalculateWeeklyBalancesCommand { ... });
-
-// Step 2
-await _mediator.Send(new CalculateWeeklyCommissionPoolCommand { ... });
-
-// Step 3
-await _mediator.Send(new ProcessUserPayoutsCommand { ... });
-```
-
-**بعد:**
-```csharp
-// Step 1: محاسبه تعادل‌ها
-if (!request.SkipBalances)
-{
-    await _mediator.Send(new CalculateWeeklyBalancesCommand { ... });
-}
-
-// Step 2: محاسبه Pool و پرداخت‌ها
-if (!request.SkipPayouts)
-{
-    await _mediator.Send(new CalculateWeeklyCommissionPoolCommand { ... });
-}
-```
-
-**حذف شد:**
- ❌ `SkipPool` flag
- ❌ Step 3 کاملاً حذف شد
-
---
-
-## 🎯 فرآیند نهایی
-
-### مرحله 1: محاسبه تعادل‌ها
-```
-1. برای هر کاربر در شبکه
-2. تا 15 لول پایین‌تر شمارش کن
-3. محاسبه تعادل (MIN of left/right)
-4. محاسبه باقیمانده
-5. محاسبه فلش
-6. ذخیره در NetworkWeeklyBalance
-```
-
-### مرحله 2: محاسبه Pool و توزیع
-```
-1. شمارش فعالسازی‌های باشگاه این هفته
-2. Pool = تعداد × ActivationFee
-3. ارزش هر امتیاز = Pool ÷ مجموع تعادل‌ها
-4. برای هر کاربر:
-   a. تعادل خودش + تعادل زیرمجموعه (تا 15 لول)
-   b. سهم = تعادل × ارزش
-   c. ثبت در UserCommissionPayout
-   d. ثبت تاریخچه
-```
-
---
-
-## 📊 جداول درگیر
-
-### `NetworkWeeklyBalance` (فیلدهای جدید)
-```sql
-ALTER TABLE [Network].[NetworkWeeklyBalances]
-ADD [FlushedPerSide] INT NOT NULL DEFAULT 0,
-    [TotalFlushed] INT NOT NULL DEFAULT 0;
-```
-
-### `WeeklyCommissionPool`
-```
- TotalPoolAmount: از فعالسازی‌های باشگاه
- TotalBalances: مجموع تعادل‌های شبکه
- ValuePerBalance: Pool ÷ TotalBalances
-```
-
-### `UserCommissionPayout`
-```
- BalancesEarned: تعادل خودش + زیرمجموعه
- DirectBalances: فقط تعادل خودش
- SubordinateBalances: فقط زیرمجموعه
- TotalAmount: BalancesEarned × ValuePerBalance
- Status: Pending
-```
-
-### `CommissionPayoutHistory`
-```
- PayoutId: شناسه UserCommissionPayout
- Status: Pending (در این مرحله)
- ChangeReason: "محاسبه اولیه کمیسیون هفتگی"
-```
-
---
-
-## ✅ مزایا
-
-1. **ساده‌تر**: 2 مرحله به جای 3
-2. **بدون تکرار**: دیگر UserCommissionPayout دوبار ساخته نمیشه
-3. **واضح‌تر**: Pool از کجا میاد مشخصه
-4. **قابل نگهداری**: منطق مشابه یکجا هست
-5. **کامل**: تاریخچه + subordinate balances همه جا هست
-
---
-
-## 🔄 مراحل بعدی (اختیاری)
-
-### مرحله 3: پرداخت واقعی (جدا از محاسبه)
-
-می‌توان یک Command جدید داشت که:
-1. `UserCommissionPayout` با status=Pending رو بخونه
-2. به کیف پول واریز کنه
-3. Status رو به Paid تغییر بده
-4. تاریخچه اضافه کنه
-
-این مرحله **جدا از محاسبات** است و می‌تواند:
- دستی توسط ادمین اجرا شود
- یا به صورت خودکار بعد از تایید
-
---
-
-## 📝 نکات مهم
-
-### Pool چطور پُر میشه؟
-```
-1. کاربر عضو Club میشه
-2. در ActivateClubMembership مبلغی کسر میشه
-3. این مبلغ به Pool اضافه **نمیشه** (فقط شمارش میشه)
-4. در محاسبه Pool: تعداد × ActivationFee
-```
-
-### چرا subordinate balances؟
-```
-در سیستم باینری، کاربر از تعادل زیرمجموعه‌های خود 
-(تا 15 لول پایین‌تر) هم کمیسیون می‌گیرد.
-```
-
-### چرا 15 لول؟
-```
-محدودیت عمق برای جلوگیری از بارگذاری بیش از حد 
-و تشویق به ایجاد شبکه متعادل
-```
-
---
-
-## 🧪 تست
-
-### تست مرحله 1
-```csharp
-// 1. ایجاد کاربران در شبکه
-// 2. فعالسازی Club برای برخی
-// 3. اجرای CalculateWeeklyBalances
-// 4. بررسی NetworkWeeklyBalance
-//    - TotalBalances
-//    - FlushedPerSide
-//    - TotalFlushed
-```
-
-### تست مرحله 2
-```csharp
-// 1. اجرای مرحله 1
-// 2. اجرای CalculateWeeklyCommissionPool
-// 3. بررسی WeeklyCommissionPool
-//    - TotalPoolAmount = تعداد فعالسازی‌ها × ActivationFee
-//    - ValuePerBalance صحیح باشد
-// 4. بررسی UserCommissionPayout
-//    - برای هر کاربر ایجاد شده
-//    - BalancesEarned شامل subordinate هم هست
-//    - TotalAmount = BalancesEarned × ValuePerBalance
-// 5. بررسی CommissionPayoutHistory
-//    - برای هر پرداخت ثبت شده
-```
-
---
-
-## 📚 فایل‌های تغییر یافته
-
-1. ✅ `NetworkWeeklyBalance.cs` - اضافه شدن فیلدها
-2. ✅ `CalculateWeeklyBalancesCommandHandler.cs` - ذخیره فلش
-3. ✅ `CalculateWeeklyCommissionPoolCommandHandler.cs` - منطق کامل جدید
-4. ✅ `TriggerWeeklyCalculationCommandHandler.cs` - حذف مرحله 3
-5. ✅ `TriggerWeeklyCalculationCommand.cs` - حذف SkipPool flag
-6. ✅ Migration: `AddFlushedFieldsToNetworkWeeklyBalance`
-
---
-
-## 🎉 نتیجه
-
-سیستم کمیسیون هفتگی حالا:
- ✅ **ساده‌تر** و قابل فهم‌تر
- ✅ **بدون تکرار** در کد
- ✅ **Pool از منبع صحیح** (فعالسازی‌های Club)
- ✅ **تعادل زیرمجموعه** محاسبه میشه
- ✅ **تاریخچه کامل** ثبت میشه
- ✅ **فلش دقیق** ذخیره میشه
-
-آماده برای استفاده در Production! 🚀
@@ -1,689 +0,0 @@
-# Daya Loan Integration System (سیستم یکپارچه‌سازی وام دایا)
-
-## 📌 Overview
-
-سیستم یکپارچه‌سازی با سرویس وام دایا برای شارژ خودکار کیف پول کاربران که وام دایا دریافت کرده‌اند.
-
-**مقادیر شارژ:**
- **کیف پول اصلی (Balance)**: 56,000,000 تومان
- **کیف پول شبکه/کارمزد (NetworkBalance)**: 56,000,000 تومان  
- **کیف پول تخفیف (DiscountBalance)**: 56,000,000 تومان
- **مجموع**: 168,000,000 تومان
-
-**نکته مهم:** کیف پول باشگاه (ClubWallet) باید توسط کاربر در فرانت‌آفیس به صورت دستی شارژ شود.
-
---
-
-## 🗂️ Architecture
-
-### Domain Layer
-
-#### **DayaLoanStatus Enum**
-```csharp
-public enum DayaLoanStatus
-{
-    NotRequested = 0,    // درخواست نشده
-    PendingReceive = 1,  // در انتظار دریافت وام (فعال شده)
-    Received = 2,        // وام دریافت شده
-    Rejected = 3,        // رد شده
-    UnderReview = 4      // در حال بررسی
-}
-```
-
-#### **DayaLoanContract Entity**
-```csharp
-public class DayaLoanContract : BaseAuditableEntity
-{
-    public long UserId { get; set; }
-    public string NationalCode { get; set; }
-    public string? ContractNumber { get; set; }
-    public DayaLoanStatus Status { get; set; }
-    public bool IsProcessed { get; set; }
-    public DateTime? LastCheckDate { get; set; }
-    public DateTime? ProcessedDate { get; set; }
-    public long? TransactionId { get; set; }
-    
-    // Navigation Properties
-    public virtual User User { get; set; }
-    public virtual Transactions? Transaction { get; set; }
-}
-```
-
-#### **User Entity Extensions**
-```csharp
-public class User : BaseAuditableEntity
-{
-    // ... existing properties ...
-    
-    public bool HasReceivedDayaCredit { get; set; }
-    public DateTime? DayaCreditReceivedAt { get; set; }
-    public virtual ICollection<DayaLoanContract>? DayaLoanContracts { get; set; }
-}
-```
-
---
-
-### Application Layer
-
-#### **Commands**
-
-##### 1. ProcessDayaLoanApprovalCommand
-شارژ کیف پول کاربر بعد از تایید وام دایا
-
-**Request:**
-```csharp
-public record ProcessDayaLoanApprovalCommand : IRequest<ProcessDayaLoanApprovalResponseDto>
-{
-    public long UserId { get; init; }
-    public string ContractNumber { get; init; }
-    public long WalletAmount { get; init; } = 56_000_000;
-    public long LockedWalletAmount { get; init; } = 56_000_000;
-    public long DiscountWalletAmount { get; init; } = 56_000_000;
-}
-```
-
-**Response:**
-```csharp
-public class ProcessDayaLoanApprovalResponseDto
-{
-    public long UserId { get; set; }
-    public long TransactionId { get; set; }
-    public string ContractNumber { get; set; }
-    public long MainWalletBalance { get; set; }
-    public long LockedWalletBalance { get; set; }
-    public long DiscountWalletBalance { get; set; }
-    public string Message { get; set; }
-}
-```
-
-**Business Logic:**
-1. بررسی اینکه کاربر قبلاً اعتبار دایا را دریافت نکرده باشد
-2. ایجاد Transaction با:
-   - Type: DepositExternal1
-   - Amount: 168M تومان
-   - RefId: شماره قرارداد دایا
-3. شارژ سه نوع کیف پول (Balance, NetworkBalance, DiscountBalance)
-4. ثبت UserWalletChangeLog برای Balance و NetworkBalance (⚠️ DiscountBalance لاگ ندارد)
-5. به‌روزرسانی فلگ‌های کاربر (HasReceivedDayaCredit, DayaCreditReceivedAt)
-6. انتشار DayaLoanApprovedEvent
-
-##### 2. CheckDayaLoanStatusCommand
-استعلام وضعیت وام از سرویس دایا
-
-**Request:**
-```csharp
-public record CheckDayaLoanStatusCommand : IRequest<CheckDayaLoanStatusResponseDto>
-{
-    public List<string> NationalCodes { get; init; }
-}
-```
-
-**Response:**
-```csharp
-public class CheckDayaLoanStatusResponseDto
-{
-    public List<DayaLoanCheckResult> Results { get; set; }
-    public int TotalChecked { get; set; }
-    public int SuccessCount { get; set; }
-}
-
-public class DayaLoanCheckResult
-{
-    public string NationalCode { get; set; }
-    public DayaLoanStatus Status { get; set; }
-    public string? ContractNumber { get; set; }
-}
-```
-
-**✅ Current Status:** این Command کاملاً پیاده‌سازی شده و به API واقعی Daya متصل است.
-
-#### **API Integration Details:**
- **Endpoint**: `POST /api/merchant/contracts`
- **Base URL**: `https://testdaya.tadbirandishan.com`
- **Authentication**: `merchant-permission-key` header
- **Request Body**:
-  ```json
-  {
-    "nationalCodes": ["1234567890", "0987654321"]
-  }
-  ```
- **Response Structure**:
-  ```json
-  {
-    "succeed": true,
-    "code": 200,
-    "message": "Success",
-    "data": [
-      {
-        "nationalCode": "1234567890",
-        "contractNumber": "DAYA-12345",
-        "statusDescription": "فعال شده (در انتظار تسویه)",
-        "dateTime": "2024-12-06T10:30:00"
-      }
-    ]
-  }
-  ```
- **Status Mapping**:
-  - "فعال شده (در انتظار تسویه)" → PendingReceive
-  - "تایید شده" → Received
-  - "رد شده" → Rejected
-  - Default → UnderReview
- **Cache Duration**: 20 minutes (per Daya API spec)
- **Multiple Contracts**: If user has multiple contracts, system takes the latest one by DateTime
-
---
-
-### Infrastructure Layer
-
-#### **IDayaLoanApiService Implementations**
-
-**1. MockDayaLoanApiService** (Testing):
- Returns mock data based on NationalCode patterns
- Instant response for fast testing
- No external dependencies
-
-**2. DayaLoanApiService** (Production):
- ✅ Fully implemented with HttpClient
- Posts to `/api/merchant/contracts` endpoint
- Handles API errors gracefully
- Maps Persian status descriptions to enum values
- Returns empty results on error (prevents worker crashes)
-
-**Configuration** (`appsettings.json`):
-```json
-{
-  "DayaApi": {
-    "UseMock": false,
-    "BaseAddress": "https://testdaya.tadbirandishan.com",
-    "MerchantPermissionKey": "14752708$Db5Wk5h...",
-    "CacheDurationMinutes": 20
-  }
-}
-```
-
-**Service Registration** (`ConfigureServices.cs`):
- Reads `DayaApi:UseMock` from configuration
- If `true`: Uses MockDayaLoanApiService
- If `false`: Uses DayaLoanApiService with HttpClient
- HttpClient configured with BaseAddress, headers, and 30s timeout
-
-#### **Background Worker: DayaLoanCheckWorker**
-Worker خودکار که هر 15 دقیقه کاربران با وام pending را چک می‌کند.
-
-**Location:** `CMSMicroservice.WebApi/Workers/DayaLoanCheckWorker.cs`
-
-**Schedule:** `*/15 * * * *` (هر 15 دقیقه)
-
-**Logic:**
-1. Query کاربرانی که `HasReceivedDayaCredit == false` و دارای `NationalCode` هستند
-2. فراخوانی `CheckDayaLoanStatusCommand` با لیست کدملی‌ها
-3. برای هر نتیجه با Status=PendingReceive و ContractNumber موجود:
-   - فراخوانی `ProcessDayaLoanApprovalCommand`
-   - لاگ نتیجه عملیات
-4. Retry خودکار در صورت خطا (Hangfire AutomaticRetry)
-
-**Registration:** در `Program.cs` ثبت شده است:
-```csharp
-DayaLoanCheckWorker.Schedule(recurringJobManager);
-```
-
---
-
-## 🔄 Process Flow
-
-```
-1. کاربر درخواست وام دایا می‌دهد (خارج از سیستم)
-   ↓
-2. Worker هر 15 دقیقه کاربران pending را چک می‌کند
-   ↓
-3. CheckDayaLoanStatusCommand → فراخوانی API دایا
-   ↓
-4. اگر Status = PendingReceive و ContractNumber موجود بود:
-   ↓
-5. ProcessDayaLoanApprovalCommand اجرا می‌شود:
-   - ایجاد Transaction (168M تومان)
-   - شارژ Balance (+56M)
-   - شارژ NetworkBalance (+56M)
-   - شارژ DiscountBalance (+56M)
-   - ثبت WalletChangeLog (برای Balance و NetworkBalance)
-   - تنظیم HasReceivedDayaCredit = true
-   ↓
-6. DayaLoanApprovedEvent منتشر می‌شود
-   ↓
-7. EventHandler می‌تواند عملیات جانبی انجام دهد (مثل ارسال اطلاع‌رسانی)
-```
-
---
-
-## 💾 Database Schema
-
-### DayaLoanContracts Table
-```sql
-CREATE TABLE [CMS].[DayaLoanContracts] (
-    [Id] bigint IDENTITY(1,1) PRIMARY KEY,
-    [UserId] bigint NOT NULL FOREIGN KEY REFERENCES Users(Id),
-    [NationalCode] nvarchar(max) NOT NULL,
-    [ContractNumber] nvarchar(max) NULL,
-    [Status] int NOT NULL,
-    [IsProcessed] bit NOT NULL,
-    [LastCheckDate] datetime2 NULL,
-    [ProcessedDate] datetime2 NULL,
-    [TransactionId] bigint NULL FOREIGN KEY REFERENCES Transactionss(Id),
-    [Created] datetime2 NOT NULL,
-    [CreatedBy] nvarchar(max) NULL,
-    [LastModified] datetime2 NULL,
-    [LastModifiedBy] nvarchar(max) NULL,
-    [IsDeleted] bit NOT NULL
-);
-```
-
-### User Table Extensions
-```sql
-ALTER TABLE [CMS].[Users]
-ADD [HasReceivedDayaCredit] bit NOT NULL DEFAULT 0,
-    [DayaCreditReceivedAt] datetime2 NULL;
-```
-
-**Migration:** `20251201191716_AddDayaLoanIntegration.cs`
-
---
-
-## ⚠️ Important Notes
-
-### ⚠️ CRITICAL: Don't Remove Business Logic on Errors!
- **وقتی با خطا مواجه شدیم، NEVER پاک نکنید بخشی از بیزینس را**
- **اول 5 بار تلاش کنید که خطا را برطرف کنید**
- اگر خطا برطرف نشد، آن را به حال خود رها کنید (Comment + TODO)
- Developer دستی خطا را بررسی و حل خواهد کرد
-
-**مثال درست:**
-```csharp
-// TODO: این قسمت خطا دارد - نیاز به بررسی
-// Error: CS1234 - Type not found
-// var discountLog = new UserWalletChangeLog { ... };
-// await _context.UserWalletChangeLogs.AddAsync(discountLog);
-```
-
-**مثال غلط (ممنوع!):**
-```csharp
-// ❌ پاک کردن لاگ DiscountBalance برای حل خطا - WRONG!
-// این کار باعث از دست رفتن بخشی از بیزینس می‌شود
-```
-
-### 1. UserWalletChangeLog Limitation
- فیلدهای موجود: `CurrentBalance`, `ChangeValue`, `CurrentNetworkBalance`, `ChangeNerworkValue`
- **مشکل:** فیلدی برای `DiscountBalance` وجود ندارد
- **راه‌حل فعلی:** تغییرات DiscountBalance در لاگ ثبت نمی‌شود، فقط در جدول UserWallets ذخیره می‌شود
- **پیشنهاد آینده:** اضافه کردن فیلدهای `CurrentDiscountBalance` و `ChangeDiscountValue` به UserWalletChangeLog
-
-### 2. Daya API Integration
- **وضعیت فعلی:** CheckDayaLoanStatusCommandHandler یک skeleton است
- **TODO:** پیاده‌سازی API واقعی دایا در Handler
- **Placeholder Code:**
-  ```csharp
-  // TODO: فراخوانی سرویس دایا
-  // در حال حاضر داده Mock برمی‌گردانیم
-  ```
-
-### 3. Transaction Type
- از `TransactionType.DepositExternal1` استفاده می‌شود
- `RefId` = شماره قرارداد دایا
- این اطلاعات برای پیگیری و تطبیق با دایا ضروری است
-
-### 4. One-Time Credit
- هر کاربر فقط **یک بار** می‌تواند اعتبار دایا دریافت کند
- بررسی توسط `HasReceivedDayaCredit` flag
- تلاش برای دریافت مجدد با خطا مواجه می‌شود
-
---
-
-## 🧪 Testing
-
-### Manual Testing via Hangfire Dashboard
-1. به Hangfire Dashboard بروید: `/hangfire`
-2. در بخش "Recurring Jobs" job با نام `daya-loan-check` را پیدا کنید
-3. دکمه "Trigger now" را بزنید
-4. در بخش "Jobs" می‌توانید لاگ‌ها را ببینید
-
-### Testing Commands via gRPC (آینده)
-```bash
-# فراخوانی ProcessDayaLoanApproval
-grpcurl -d '{
-  "userId": 123,
-  "contractNumber": "DAYA-12345"
-}' localhost:5001 ProcessDayaLoanApproval
-
-# فراخوانی CheckDayaLoanStatus
-grpcurl -d '{
-  "nationalCodes": ["1234567890"]
-}' localhost:5001 CheckDayaLoanStatus
-```
-
---
-
-## ✅ Completed Implementation
-
-### High Priority (All Done)
- ✅ پیاده‌سازی API واقعی دایا در DayaLoanApiService (December 6, 2025)
-  - HTTP POST to `/api/merchant/contracts`
-  - Request/Response models with JSON serialization
-  - Status description mapping (Persian → Enum)
-  - Error handling and logging
-  - Configurable via appsettings.json
- ✅ Conditional service registration (Mock vs Real)
- ✅ HttpClient configuration with authentication
- ✅ Worker fully operational with real API
-
-### Low Priority (Optional)
- [ ] اضافه کردن Proto definitions برای Daya commands
- [ ] Admin UI for Daya contract management
- [ ] Unit tests for API service
- [ ] اضافه کردن gRPC service endpoints
- [ ] تست Worker در محیط development
-
-### Medium Priority
- [ ] ایجاد BFF handlers برای عملیات دایا
- [ ] ایجاد صفحات BackOffice برای مدیریت وام دایا
- [ ] اضافه کردن فیلتر برای مشاهده کاربران با وام دایا
- [ ] نمایش تاریخچه Daya Loan Contracts
-
-### Low Priority
- [ ] اضافه کردن Unit Tests برای ProcessDayaLoanApprovalCommand
- [ ] اضافه کردن Integration Tests برای DayaLoanCheckWorker
- [ ] اضافه کردن Monitoring/Alerting برای خطاهای API دایا
- [ ] بهینه‌سازی Query برای یافتن کاربران pending
- [ ] اضافه کردن فیلدهای DiscountBalance به UserWalletChangeLog
-
---
-
-## 🔗 Related Files
-
-### Domain
- `CMSMicroservice.Domain/Enums/DayaLoanStatus.cs`
- `CMSMicroservice.Domain/Entities/DayaLoanContract.cs`
- `CMSMicroservice.Domain/Entities/User.cs` (updated)
- `CMSMicroservice.Domain/Events/DayaLoanApprovedEvent.cs`
-
-### Application
- `CMSMicroservice.Application/DayaLoanCQ/Commands/ProcessDayaLoanApproval/`
-  - ProcessDayaLoanApprovalCommand.cs
-  - ProcessDayaLoanApprovalCommandHandler.cs
-  - ProcessDayaLoanApprovalCommandValidator.cs
-  - ProcessDayaLoanApprovalResponseDto.cs
- `CMSMicroservice.Application/DayaLoanCQ/Commands/CheckDayaLoanStatus/`
-  - CheckDayaLoanStatusCommand.cs
-  - CheckDayaLoanStatusCommandHandler.cs
-  - CheckDayaLoanStatusResponseDto.cs
- `CMSMicroservice.Application/DayaLoanCQ/EventHandlers/`
-  - DayaLoanApprovedEventHandler.cs
-
-### Infrastructure
- `CMSMicroservice.Infrastructure/Persistence/ApplicationDbContext.cs` (updated)
- `CMSMicroservice.Infrastructure/Persistence/Migrations/20251201191716_AddDayaLoanIntegration.cs`
-
-### WebApi
- `CMSMicroservice.WebApi/Workers/DayaLoanCheckWorker.cs`
- `CMSMicroservice.WebApi/Program.cs` (updated)
-
---
-
-## 🧪 Testing
-
-### Manual Testing
-
-#### 1. ایجاد کاربر تست با کدملی شروع شده با "1"
-```sql
-- کاربری که Mock Service برایش وام تایید می‌کند
-INSERT INTO CMS.Users (NationalCode, FirstName, LastName, Mobile, HasReceivedDayaCredit)
-VALUES ('1234567890', 'Test', 'User', '09121234567', 0);
-```
-
-#### 2. اجرای دستی Worker از Hangfire Dashboard
- باز کردن: `https://localhost:5001/hangfire`
- انتخاب Job: `daya-loan-check`
- کلیک روی "Trigger now"
-
-#### 3. بررسی Logs
-```bash
-# در Console پروژه CMS
-[INFO] DayaLoanCheckWorker started at 2024-12-02 10:30:00
-[INFO] Found 1 users with pending Daya loan status
-[WARN] ⚠️ Using MOCK Daya API Service - Replace with real implementation!
-[INFO] Mock Daya API returned 1 results
-[INFO] Daya loan processed for user 123. Contract: MOCK-DAYA-1234567890-638123456789
-[INFO] DayaLoanCheckWorker completed. Checked: 1, Processed: 1
-```
-
-#### 4. بررسی Database
-```sql
-- چک کردن DayaLoanContract
-SELECT * FROM CMS.DayaLoanContracts WHERE NationalCode = '1234567890';
-
-- چک کردن UserWallet
-SELECT * FROM CMS.UserWallets WHERE UserId = 123;
-- Balance باید 56,000,000 باشد
-- NetworkBalance باید 56,000,000 باشد
-- DiscountBalance باید 56,000,000 باشد
-
-- چک کردن Transaction
-SELECT * FROM CMS.Transactionss WHERE RefId LIKE 'MOCK-DAYA-%';
-- Amount باید 168,000,000 باشد
-
-- چک کردن User Flag
-SELECT HasReceivedDayaCredit, DayaCreditReceivedAt FROM CMS.Users WHERE Id = 123;
-- HasReceivedDayaCredit باید 1 باشد
-```
-
-#### 5. تست Mock Service Scenarios
-```csharp
-// کدملی شروع با "1" → PendingReceive + ContractNumber
-// کدملی شروع با "2" → Rejected
-// سایر کدملی‌ها → PendingReceive (بدون ContractNumber)
-```
-
-### Integration Testing با Real API
-
-زمانی که API واقعی دایا آماده شد:
-
-1. **تغییر ConfigureServices:**
-```csharp
-// در CMSMicroservice.Infrastructure/ConfigureServices.cs
-services.AddScoped<IDayaLoanApiService, DayaLoanApiService>(); // Real
-// services.AddScoped<IDayaLoanApiService, MockDayaLoanApiService>(); // Mock - حذف شود
-```
-
-2. **تنظیم HttpClient:**
-```csharp
-services.AddHttpClient<IDayaLoanApiService, DayaLoanApiService>(client =>
-{
-    client.BaseAddress = new Uri(configuration["DayaApi:BaseUrl"]);
-    client.Timeout = TimeSpan.FromSeconds(30);
-});
-```
-
-3. **اضافه کردن به appsettings.json:**
-```json
-{
-  "DayaApi": {
-    "BaseUrl": "https://api.daya.ir",
-    "ApiKey": "YOUR_API_KEY_HERE"
-  }
-}
-```
-
---
-
-## 🐛 Troubleshooting
-
-### مشکل: Worker اجرا نمی‌شود
-
-**علت احتمالی:** Hangfire Server شروع نشده
-
-**راه حل:**
-```csharp
-// در Program.cs چک کنید که این خط وجود دارد:
-builder.Services.AddHangfireServer();
-```
-
---
-
-### مشکل: کاربران پیدا نمی‌شوند
-
-**علت احتمالی:** همه کاربران قبلاً اعتبار دریافت کرده‌اند
-
-**راه حل:**
-```sql
-- Reset کردن وضعیت کاربران برای تست
-UPDATE CMS.Users SET HasReceivedDayaCredit = 0, DayaCreditReceivedAt = NULL;
-```
-
---
-
-### مشکل: کیف پول شارژ نمی‌شود
-
-**علت احتمالی:** کاربر کیف پول ندارد
-
-**راه حل:**
-```csharp
-// کد Handler خودکار UserWallet می‌سازد اگر موجود نباشد:
-if (wallet == null)
-{
-    wallet = new UserWallet { UserId = request.UserId, Balance = 0, ... };
-    await _context.UserWallets.AddAsync(wallet, cancellationToken);
-}
-```
-
---
-
-### مشکل: Mock API همیشه نتیجه یکسان برمی‌گرداند
-
-**راه حل:** کدملی کاربر را تغییر دهید:
- کدملی شروع با **"1"** → وام تایید می‌شود ✅
- کدملی شروع با **"2"** → وام رد می‌شود ❌
- سایر → در انتظار (بدون ContractNumber) ⏳
-
---
-
-### مشکل: Exception در ProcessDayaLoanApproval
-
-**خطای احتمالی:** `User has already received Daya credit`
-
-**علت:** کاربر قبلاً اعتبار دریافت کرده
-
-**راه حل:**
-```sql
-- فقط برای محیط Development
-UPDATE CMS.Users SET HasReceivedDayaCredit = 0 WHERE Id = 123;
-```
-
---
-
-### مشکل: Migration اعمال نمی‌شود
-
-**راه حل:**
-```bash
-cd CMS/src/CMSMicroservice.WebApi
-dotnet ef database update
-```
-
-یا در Package Manager Console:
-```powershell
-Update-Database
-```
-
---
-
-## 📊 Monitoring
-
-### Hangfire Dashboard
-
-**URL:** `https://localhost:5001/hangfire`
-
-**Metrics:**
- Succeeded jobs
- Failed jobs
- Processing jobs
- Scheduled jobs
-
-**Job Details:**
- Job ID: `daya-loan-check`
- Schedule: `*/15 * * * *` (Every 15 minutes)
- Next Run: نمایش داده می‌شود در Dashboard
-
-### Application Logs
-
-**Successful Run:**
-```
-[INFO] DayaLoanCheckWorker started at {Time}
-[INFO] Found {Count} users with pending Daya loan status
-[INFO] Daya loan processed for user {UserId}. Contract: {ContractNumber}
-[INFO] DayaLoanCheckWorker completed. Checked: {Total}, Processed: {Success}
-```
-
-**Error Scenarios:**
-```
-[ERROR] Error processing Daya loan for user {UserId}
-[ERROR] Error calling Daya API service
-[ERROR] Error in DayaLoanCheckWorker
-```
-
---
-
-## 🔒 Security Considerations
-
-1. **API Key Management:**
-   - هرگز API Key را در کد Commit نکنید
-   - از User Secrets برای Development استفاده کنید
-   - از Azure Key Vault یا مشابه برای Production استفاده کنید
-
-2. **Rate Limiting:**
-   - Worker هر 15 دقیقه اجرا می‌شود → حداکثر 96 بار در روز
-   - اگر API دایا محدودیت دارد، باید تنظیم شود
-
-3. **Data Validation:**
-   - کدملی باید 10 رقمی باشد
-   - فقط یک بار برای هر کاربر پردازش می‌شود
-
---
-
-## 📈 Performance Optimization
-
-### Batch Processing
-
-اگر تعداد کاربران زیاد باشد، می‌توان Query را بهینه کرد:
-
-```csharp
-// پردازش دسته‌ای (100 کاربر در هر بار)
-var pendingUsers = await _context.Users
-    .Where(u => u.HasReceivedDayaCredit == false && u.NationalCode != null)
-    .Take(100) // Limit
-    .Select(u => new { u.Id, u.NationalCode })
-    .ToListAsync();
-```
-
-### Caching
-
-می‌توان نتایج API را برای مدت کوتاهی Cache کرد:
-
-```csharp
-// Cache result for 5 minutes
-[MemoryCache]
-public async Task<List<DayaLoanStatusResult>> CheckLoanStatusAsync(...)
-```
-
---
-
-## 📚 References
-
- [Hangfire Documentation](https://docs.hangfire.io/)
- [MediatR Pattern](https://github.com/jbogard/MediatR)
- [Clean Architecture](https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html)
-
---
-
-**Created:** 2024-12-01  
-**Last Updated:** 2024-12-02  
-**Status:** ✅ 100% Implemented (Mock API in use - Real API integration pending)  
-**Migration:** `20251201191716_AddDayaLoanIntegration`  
-**Test Coverage:** Manual testing documented  
-**Next Steps:** Replace MockDayaLoanApiService with real API implementation when available
@@ -1,750 +0,0 @@
-# Club Discount Shop System - سیستم فروشگاه باشگاه مشتریان با تخفیف ترکیبی
-
-**تاریخ ایجاد:** 2024-12-02  
-**تاریخ آپدیت:** 2024-12-02  
-**وضعیت:** طراحی (Phase 9)  
-**اولویت:** 🔴 بالا (یکی از دو فاز باقیمانده)
-
---
-
-## 📋 فهرست
-
-1. [مقدمه](#مقدمه)
-2. [مفهوم اصلی: پرداخت ترکیبی](#مفهوم-اصلی-پرداخت-ترکیبی)
-3. [تفاوت با Regular Shop](#تفاوت-با-regular-shop)
-4. [معماری جداسازی](#معماری-جداسازی)
-5. [Entity Design](#entity-design)
-6. [Business Rules](#business-rules)
-7. [تسک‌های پیاده‌سازی](#تسک-های-پیاده-سازی)
-
---
-
-## 🎯 مقدمه
-
-### هدف:
-ایجاد **فروشگاه باشگاه مشتریان** که در آن کاربران می‌توانند با **پرداخت ترکیبی** خرید کنند:
-
-**🔑 قانون اصلی**: 
- کاربر **نمی‌تواند** کل محصول را فقط با `DiscountBalance` بخرد
- کاربر می‌تواند **درصدی از قیمت** را با `DiscountBalance` پرداخت کند
- **مابقی مبلغ** باید از طریق **درگاه پرداخت واقعی در Gateway/PYMS** پرداخت شود (نه در CMS)
-
-### مثال عملی:
-```
-قیمت محصول: 1,000,000 تومان
-حداکثر تخفیف مجاز: 30%
-DiscountBalance کاربر: 500,000 تومان
-
-محاسبه:
- حداکثر تخفیف قابل استفاده: 1,000,000 × 30% = 300,000 تومان
- DiscountBalance کاربر: 500,000 تومان (بیشتر از 300,000)
- مبلغ تخفیف نهایی: 300,000 تومان (محدود به 30%)
- مبلغ قابل پرداخت از درگاه: 1,000,000 - 300,000 = 700,000 تومان
-
-نتیجه:
-✅ کسر از DiscountBalance: 300,000 تومان
-✅ پرداخت از درگاه: 700,000 تومان
-✅ DiscountBalance باقیمانده: 200,000 تومان
-```
-
---
-
-## 🔄 مفهوم اصلی: پرداخت ترکیبی
-
-### Flow خرید:
-
-```
-1. کاربر محصول را انتخاب می‌کند
-2. سیستم چک می‌کند:
-   - قیمت محصول: X تومان
-   - حداکثر تخفیف مجاز: Y%
-   - DiscountBalance کاربر: Z تومان
-   
-3. محاسبه تخفیف:
-   MaxDiscountAmount = X × (Y / 100)
-   ActualDiscountAmount = Min(Z, MaxDiscountAmount)
-   
-4. محاسبه مبلغ درگاه:
-   GatewayAmount = X - ActualDiscountAmount
-   
-5. ریدایرکت به درگاه پرداخت (GatewayAmount)
-
-6. بعد از بازگشت موفق از درگاه:
-   - Verify payment از درگاه
-   - کسر ActualDiscountAmount از DiscountBalance
-   - ثبت سفارش با دو مبلغ جدا
-   - ارسال اطلاعیه به کاربر
-```
-
-### مزایا:
-✅ کاربر نمی‌تواند کل محصول را با تخفیف بخرد (محدودیت درصد)  
-✅ کاربر می‌تواند از موجودی تخفیف خود استفاده کند  
-✅ فروشنده مطمئن است مبلغی واقعی دریافت می‌کند  
-✅ سیستم از سوء‌استفاده جلوگیری می‌کند  
-
---
-
-## 🔄 تفاوت با Regular Shop
-
-| ویژگی | فروشگاه عادی (Regular) | فروشگاه تخفیفی (Club Discount) |
-|-------|------------------------|---------------------------|
-| **نوع کیف پول** | `UserWallet.Balance` | `UserWallet.DiscountBalance` + درگاه |
-| **نحوه پرداخت** | 100% از Balance یا IPG | **ترکیبی**: X% از DiscountBalance + مابقی از IPG |
-| **محدودیت تخفیف** | ندارد | **دارد** (MaxDiscountPercent per product) |
-| **نحوه شارژ** | خرید پکیج طلایی (56M) | کمیسیون برداشت Diamond |
-| **ارتباط با باشگاه** | ✅ دارد | ✅ دارد (اعضای باشگاه) |
-| **محصولات** | `Products` | `DiscountProduct` (یا flag در Products) |
-| **سفارش** | `UserOrder` | `DiscountOrder` (با دو مبلغ جدا) |
-| **پرداخت** | یک مرحله‌ای | **دو مرحله‌ای**: 1) Verify IPG، 2) Deduct DiscountBalance |
-| **TransactionType** | `DepositIpg` | `DiscountPurchase` (hybrid) |
-
---
-
-## 🏗️ معماری جداسازی
-
-### اصل طراحی:
-> **"همه چیز جدا، جز درگاه پرداخت و کیف پول"**
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                         User                                     │
-│  - Id                                                            │
-│  - FirstName, LastName, Mobile                                  │
-│  - PackagePurchaseMethod                                        │
-└────────────┬────────────────────────────────────────────────────┘
-             │
-             ├──────────────────────────────────────────┐
-             │                                          │
-             ▼                                          ▼
-┌────────────────────────────┐          ┌──────────────────────────┐
-│       UserWallet           │          │    Transactions (مشترک)  │
-│  - Balance                 │          │  - Type                  │
-│  - DiscountBalance         │          │  - RefId                 │
-│  - NetworkBalance          │          │  - Amount                │
-└────────────┬───────────────┘          └──────────────────────────┘
-             │
-             ├──────────────────────────────────────────┐
-             │                                          │
-             ▼                                          ▼
-┌────────────────────────────┐          ┌──────────────────────────┐
-│    Regular Shop            │          │    Discount Shop         │
-│  - Products                │          │  - DiscountProduct       │
-│  - Category                │          │  - DiscountCategory      │
-│  - UserCarts               │          │  - DiscountShoppingCart  │
-│  - UserOrder               │          │  - DiscountOrder         │
-│  - FactorDetails           │          │  - DiscountOrderDetail   │
-└────────────────────────────┘          └──────────────────────────┘
-```
-
---
-
-## 🗄️ Entity Design
-
-### 1️⃣ `DiscountProduct`
-
-```csharp
-namespace CMSMicroservice.Domain.Entities.DiscountShop;
-
-/// <summary>
-/// محصول فروشگاه تخفیفی
-/// </summary>
-public class DiscountProduct : BaseAuditableEntity
-{
-    /// <summary>
-    /// عنوان محصول
-    /// </summary>
-    public string Title { get; set; }
-    
-    /// <summary>
-    /// توضیحات مختصر
-    /// </summary>
-    public string ShortInfomation { get; set; }
-    
-    /// <summary>
-    /// توضیحات کامل
-    /// </summary>
-    public string FullInformation { get; set; }
-    
-    /// <summary>
-    /// قیمت (ریال)
-    /// </summary>
-    public long Price { get; set; }
-    
-    /// <summary>
-    /// درصد تخفیف
-    /// </summary>
-    public int DiscountPercent { get; set; }
-    
-    /// <summary>
-    /// امتیاز (0 تا 5)
-    /// </summary>
-    public int Rate { get; set; }
-    
-    /// <summary>
-    /// آدرس تصویر اصلی
-    /// </summary>
-    public string ImagePath { get; set; }
-    
-    /// <summary>
-    /// آدرس تصویر کوچک
-    /// </summary>
-    public string ThumbnailPath { get; set; }
-    
-    /// <summary>
-    /// تعداد فروش
-    /// </summary>
-    public int SaleCount { get; set; }
-    
-    /// <summary>
-    /// تعداد بازدید
-    /// </summary>
-    public int ViewCount { get; set; }
-    
-    /// <summary>
-    /// موجودی انبار
-    /// </summary>
-    public int RemainingCount { get; set; }
-    
-    /// <summary>
-    /// وضعیت فعال/غیرفعال
-    /// </summary>
-    public bool IsActive { get; set; }
-    
-    // Navigation Properties
-    public virtual ICollection<DiscountShoppingCart> ShoppingCarts { get; set; }
-    public virtual ICollection<DiscountOrderDetail> OrderDetails { get; set; }
-    public virtual ICollection<DiscountProductCategory> ProductCategories { get; set; }
-}
-```
-
---
-
-### 2️⃣ `DiscountCategory`
-
-```csharp
-namespace CMSMicroservice.Domain.Entities.DiscountShop;
-
-/// <summary>
-/// دسته‌بندی فروشگاه تخفیفی
-/// </summary>
-public class DiscountCategory : BaseAuditableEntity
-{
-    /// <summary>
-    /// نام لاتین (برای URL)
-    /// </summary>
-    public string Name { get; set; }
-    
-    /// <summary>
-    /// عنوان فارسی
-    /// </summary>
-    public string Title { get; set; }
-    
-    /// <summary>
-    /// توضیحات
-    /// </summary>
-    public string? Description { get; set; }
-    
-    /// <summary>
-    /// آدرس تصویر
-    /// </summary>
-    public string? ImagePath { get; set; }
-    
-    /// <summary>
-    /// شناسه والد (برای دسته‌بندی چند سطحی)
-    /// </summary>
-    public long? ParentId { get; set; }
-    
-    /// <summary>
-    /// Parent Navigation Property
-    /// </summary>
-    public virtual DiscountCategory? Parent { get; set; }
-    
-    /// <summary>
-    /// فعال/غیرفعال
-    /// </summary>
-    public bool IsActive { get; set; }
-    
-    /// <summary>
-    /// ترتیب نمایش
-    /// </summary>
-    public int SortOrder { get; set; }
-    
-    // Navigation Properties
-    public virtual ICollection<DiscountCategory> Children { get; set; }
-    public virtual ICollection<DiscountProductCategory> ProductCategories { get; set; }
-}
-```
-
---
-
-### 3️⃣ `DiscountProductCategory` (Many-to-Many)
-
-```csharp
-namespace CMSMicroservice.Domain.Entities.DiscountShop;
-
-/// <summary>
-/// رابطه محصول و دسته‌بندی در فروشگاه تخفیفی
-/// </summary>
-public class DiscountProductCategory : BaseAuditableEntity
-{
-    public long DiscountProductId { get; set; }
-    public virtual DiscountProduct DiscountProduct { get; set; }
-    
-    public long DiscountCategoryId { get; set; }
-    public virtual DiscountCategory DiscountCategory { get; set; }
-}
-```
-
---
-
-### 4️⃣ `DiscountShoppingCart`
-
-```csharp
-namespace CMSMicroservice.Domain.Entities.DiscountShop;
-
-/// <summary>
-/// سبد خرید فروشگاه تخفیفی
-/// </summary>
-public class DiscountShoppingCart : BaseAuditableEntity
-{
-    /// <summary>
-    /// شناسه کاربر
-    /// </summary>
-    public long UserId { get; set; }
-    
-    /// <summary>
-    /// User Navigation Property
-    /// </summary>
-    public virtual User User { get; set; }
-    
-    /// <summary>
-    /// شناسه محصول
-    /// </summary>
-    public long DiscountProductId { get; set; }
-    
-    /// <summary>
-    /// DiscountProduct Navigation Property
-    /// </summary>
-    public virtual DiscountProduct DiscountProduct { get; set; }
-    
-    /// <summary>
-    /// تعداد
-    /// </summary>
-    public int Count { get; set; }
-    
-    /// <summary>
-    /// قیمت واحد در زمان افزودن به سبد
-    /// </summary>
-    public long UnitPrice { get; set; }
-}
-```
-
---
-
-### 5️⃣ `DiscountOrder`
-
-```csharp
-namespace CMSMicroservice.Domain.Entities.DiscountShop;
-
-/// <summary>
-/// سفارش از فروشگاه تخفیفی
-/// </summary>
-public class DiscountOrder : BaseAuditableEntity
-{
-    /// <summary>
-    /// شناسه کاربر
-    /// </summary>
-    public long UserId { get; set; }
-    
-    /// <summary>
-    /// User Navigation Property
-    /// </summary>
-    public virtual User User { get; set; }
-    
-    /// <summary>
-    /// مبلغ کل سفارش
-    /// </summary>
-    public long TotalAmount { get; set; }
-    
-    /// <summary>
-    /// مبلغ تخفیف
-    /// </summary>
-    public long DiscountAmount { get; set; }
-    
-    /// <summary>
-    /// مبلغ قابل پرداخت
-    /// </summary>
-    public long PayableAmount { get; set; }
-    
-    /// <summary>
-    /// وضعیت پرداخت
-    /// </summary>
-    public PaymentStatus PaymentStatus { get; set; }
-    
-    /// <summary>
-    /// تاریخ پرداخت
-    /// </summary>
-    public DateTime? PaymentDate { get; set; }
-    
-    /// <summary>
-    /// شناسه تراکنش (اگر پرداخت موفق باشد)
-    /// </summary>
-    public long? TransactionId { get; set; }
-    
-    /// <summary>
-    /// Transaction Navigation Property
-    /// </summary>
-    public virtual Transactions? Transaction { get; set; }
-    
-    /// <summary>
-    /// شناسه آدرس کاربر
-    /// </summary>
-    public long UserAddressId { get; set; }
-    
-    /// <summary>
-    /// UserAddress Navigation Property
-    /// </summary>
-    public virtual UserAddress UserAddress { get; set; }
-    
-    /// <summary>
-    /// وضعیت ارسال
-    /// </summary>
-    public DeliveryStatus DeliveryStatus { get; set; }
-    
-    /// <summary>
-    /// کد رهگیری مرسوله
-    /// </summary>
-    public string? TrackingCode { get; set; }
-    
-    /// <summary>
-    /// توضیحات وضعیت ارسال
-    /// </summary>
-    public string? DeliveryDescription { get; set; }
-    
-    // Navigation Properties
-    public virtual ICollection<DiscountOrderDetail> OrderDetails { get; set; }
-}
-```
-
---
-
-### 6️⃣ `DiscountOrderDetail`
-
-```csharp
-namespace CMSMicroservice.Domain.Entities.DiscountShop;
-
-/// <summary>
-/// جزئیات سفارش از فروشگاه تخفیفی
-/// </summary>
-public class DiscountOrderDetail : BaseAuditableEntity
-{
-    /// <summary>
-    /// شناسه سفارش
-    /// </summary>
-    public long DiscountOrderId { get; set; }
-    
-    /// <summary>
-    /// DiscountOrder Navigation Property
-    /// </summary>
-    public virtual DiscountOrder DiscountOrder { get; set; }
-    
-    /// <summary>
-    /// شناسه محصول
-    /// </summary>
-    public long DiscountProductId { get; set; }
-    
-    /// <summary>
-    /// DiscountProduct Navigation Property
-    /// </summary>
-    public virtual DiscountProduct DiscountProduct { get; set; }
-    
-    /// <summary>
-    /// تعداد
-    /// </summary>
-    public int Quantity { get; set; }
-    
-    /// <summary>
-    /// قیمت واحد در زمان ثبت سفارش
-    /// </summary>
-    public long UnitPrice { get; set; }
-    
-    /// <summary>
-    /// درصد تخفیف در زمان ثبت سفارش
-    /// </summary>
-    public int DiscountPercent { get; set; }
-    
-    /// <summary>
-    /// مبلغ کل این آیتم (بعد از تخفیف)
-    /// </summary>
-    public long TotalPrice { get; set; }
-}
-```
-
---
-
-## 📐 Business Rules
-
-### قانون 1: خرید از Discount Shop فقط با DiscountBalance
-
-```csharp
-// در زمان Checkout از Discount Shop:
-var wallet = await _context.UserWallets
-    .FirstOrDefaultAsync(w => w.UserId == userId);
-
-if (wallet.DiscountBalance < order.PayableAmount)
-{
-    throw new ValidationException(
-        $"موجودی کیف پول تخفیفی شما کافی نیست. " +
-        $"موجودی فعلی: {wallet.DiscountBalance:N0} تومان، " +
-        $"مبلغ مورد نیاز: {order.PayableAmount:N0} تومان"
-    );
-}
-```
-
---
-
-### قانون 2: خرید از Regular Shop فقط با Balance
-
-```csharp
-// در زمان Checkout از Regular Shop:
-var wallet = await _context.UserWallets
-    .FirstOrDefaultAsync(w => w.UserId == userId);
-
-if (wallet.Balance < order.Amount)
-{
-    throw new ValidationException(
-        $"موجودی کیف پول اصلی شما کافی نیست. " +
-        $"موجودی فعلی: {wallet.Balance:N0} تومان، " +
-        $"مبلغ مورد نیاز: {order.Amount:N0} تومان"
-    );
-}
-```
-
---
-
-### قانون 3: شارژ DiscountBalance از طریق درگاه
-
-```csharp
-// در VerifyDiscountWalletChargeCommand:
-wallet.DiscountBalance += amount;
-
-var transaction = new Transactions
-{
-    Type = TransactionType.DiscountWalletCharge,
-    Amount = amount,
-    RefId = verifyResult.RefId
-};
-```
-
---
-
-### قانون 4: محصولات Discount Shop جدا از Regular Shop
-
- یک محصول **نمی‌تواند** هم در `Products` باشد، هم در `DiscountProduct`
- Admin باید محصولات را جداگانه مدیریت کند
- هیچ رابطه‌ای بین `Products` و `DiscountProduct` نیست
-
---
-
-## 🔄 Flow Diagram: خرید از Discount Shop
-
-```
-کاربر → مشاهده محصولات Discount Shop
-  ↓
-افزودن به DiscountShoppingCart
-  ↓
-Checkout (بررسی DiscountBalance)
-  ↓
-ثبت DiscountOrder (PaymentStatus: Pending)
-  ↓
-کم کردن DiscountBalance از کیف پول
-  ↓
-ثبت Transaction (Type: Buy) ← این تراکنش برای خرید است
-  ↓
-ثبت DiscountOrderDetail برای هر محصول
-  ↓
-به‌روزرسانی DiscountOrder (PaymentStatus: Success)
-  ↓
-خالی کردن DiscountShoppingCart
-  ↓
-نمایش پیام موفقیت + کد رهگیری
-```
-
-**نکته:** در این فلو از درگاه استفاده **نمی‌شود** چون موجودی از قبل شارژ شده است.
-
---
-
-## 📝 تسک‌های پیاده‌سازی
-
-### Phase 1: Entity Creation (2 روز)
-
-1. **ایجاد namespace جدید**:
-   - `CMSMicroservice.Domain/Entities/DiscountShop/`
-
-2. **ایجاد Entity‌ها**:
-   - `DiscountProduct`
-   - `DiscountCategory`
-   - `DiscountProductCategory`
-   - `DiscountShoppingCart`
-   - `DiscountOrder`
-   - `DiscountOrderDetail`
-
-3. **ایجاد Configuration‌ها**:
-   - `DiscountProductConfiguration`
-   - `DiscountCategoryConfiguration`
-   - و غیره...
-
-4. **به‌روزرسانی `DbContext`**:
-   ```csharp
-   public DbSet<DiscountProduct> DiscountProducts { get; set; }
-   public DbSet<DiscountCategory> DiscountCategories { get; set; }
-   // ...
-   ```
-
-5. **ایجاد Migration**:
-   ```bash
-   dotnet ef migrations add AddDiscountShopTables
-   ```
-
---
-
-### Phase 2: Commands & Queries (3 روز)
-
-#### DiscountProduct CRUD:
- `CreateDiscountProductCommand`
- `UpdateDiscountProductCommand`
- `DeleteDiscountProductCommand`
- `GetDiscountProductByIdQuery`
- `GetDiscountProductsListQuery`
-
-#### DiscountCategory CRUD:
- `CreateDiscountCategoryCommand`
- `UpdateDiscountCategoryCommand`
- `DeleteDiscountCategoryCommand`
- `GetDiscountCategoriesTreeQuery`
-
-#### Shopping Cart:
- `AddToDiscountCartCommand`
- `RemoveFromDiscountCartCommand`
- `GetDiscountCartQuery`
-
-#### Order:
- `CreateDiscountOrderCommand` (Checkout)
- `GetDiscountOrderByIdQuery`
- `GetMyDiscountOrdersQuery` (برای کاربر)
- `UpdateDiscountOrderDeliveryCommand` (برای Admin)
-
---
-
-### Phase 3: BackOffice.BFF APIs (1 روز)
-
-**Proto file**: `DiscountShopContract.proto`
-
-```protobuf
-service DiscountShopContract {
-  // Product
-  rpc CreateDiscountProduct(CreateDiscountProductRequest) returns (CreateDiscountProductResponse);
-  rpc UpdateDiscountProduct(UpdateDiscountProductRequest) returns (UpdateDiscountProductResponse);
-  rpc GetDiscountProducts(GetDiscountProductsRequest) returns (GetDiscountProductsResponse);
-  
-  // Category
-  rpc CreateDiscountCategory(CreateDiscountCategoryRequest) returns (CreateDiscountCategoryResponse);
-  rpc GetDiscountCategoriesTree(Empty) returns (GetDiscountCategoriesTreeResponse);
-  
-  // Orders
-  rpc GetDiscountOrders(GetDiscountOrdersRequest) returns (GetDiscountOrdersResponse);
-  rpc UpdateDiscountOrderDelivery(UpdateDiscountOrderDeliveryRequest) returns (UpdateDiscountOrderDeliveryResponse);
-}
-```
-
---
-
-### Phase 4: FrontOffice.BFF APIs (1 روز)
-
-**Proto file**: `DiscountShopContract.proto` (در FrontOffice.BFF)
-
-```protobuf
-service DiscountShopContract {
-  // Browse
-  rpc GetDiscountProducts(GetDiscountProductsRequest) returns (GetDiscountProductsResponse);
-  rpc GetDiscountProductById(GetDiscountProductByIdRequest) returns (GetDiscountProductByIdResponse);
-  
-  // Cart
-  rpc AddToDiscountCart(AddToDiscountCartRequest) returns (AddToDiscountCartResponse);
-  rpc GetMyDiscountCart(Empty) returns (GetMyDiscountCartResponse);
-  rpc RemoveFromDiscountCart(RemoveFromDiscountCartRequest) returns (RemoveFromDiscountCartResponse);
-  
-  // Order
-  rpc CheckoutDiscountCart(CheckoutDiscountCartRequest) returns (CheckoutDiscountCartResponse);
-  rpc GetMyDiscountOrders(Empty) returns (GetMyDiscountOrdersResponse);
-}
-```
-
---
-
-### Phase 5: BackOffice UI (3 روز)
-
-**صفحات مدیریت:**
-1. **لیست محصولات تخفیفی** + CRUD
-2. **دسته‌بندی‌ها** (Tree View) + CRUD
-3. **سفارشات تخفیفی** + تغییر وضعیت ارسال
-4. **گزارش فروش** Discount Shop
-
---
-
-### Phase 6: FrontOffice UI (3 روز)
-
-**صفحات کاربر:**
-1. **لیست محصولات تخفیفی** (با فیلتر دسته‌بندی)
-2. **جزئیات محصول تخفیفی**
-3. **سبد خرید تخفیفی**
-4. **Checkout** (با نمایش `DiscountBalance`)
-5. **لیست سفارشات تخفیفی کاربر**
-
---
-
-### Phase 7: Unit Tests (2 روز)
-
-1. تست **CRUD محصولات تخفیفی**
-2. تست **AddToDiscountCart**
-3. تست **CheckoutDiscountCart**:
-   - کاربر با موجودی کافی → موفق
-   - کاربر با موجودی ناکافی → خطا
-
---
-
-### Phase 8: Documentation (0.5 روز)
-
- به‌روزرسانی `implementation-progress.md`
- لینک از `REMAINING-TASKS-CONSOLIDATED.md`
-
---
-
-## 📊 خلاصه Timeline
-
-| Phase | عنوان | زمان |
-|-------|-------|------|
-| 1 | Entity Creation | 2 روز |
-| 2 | Commands & Queries (CMS) | 3 روز |
-| 3 | BackOffice.BFF APIs | 1 روز |
-| 4 | FrontOffice.BFF APIs | 1 روز |
-| 5 | BackOffice UI | 3 روز |
-| 6 | FrontOffice UI | 3 روز |
-| 7 | Unit Tests | 2 روز |
-| 8 | Documentation | 0.5 روز |
-| **جمع** | | **15.5 روز** (~3 هفته) |
-
---
-
-## 🔗 مراجع
-
- [Package Purchase System](./package-purchase-system.md)
- [Manual Payment System](./manual-payment-system.md)
- [Implementation Progress](./implementation-progress.md)
- [REMAINING-TASKS](../REMAINING-TASKS-CONSOLIDATED.md)
-
---
-
-**تاریخ آخرین به‌روزرسانی:** 2024-12-02  
-**نویسنده:** GitHub Copilot  
-**وضعیت:** ✅ تایید شده توسط کاربر
@@ -1,548 +0,0 @@
-# Manual Payment System (سیستم پرداخت دستی مشتریان)
-
-## 📌 Overview
-
-سیستم پرداخت دستی برای مشتریانی که **بدون خرید وام دایا** می‌خواهند مستقیماً 56 میلیون تومان پرداخت کنند و همان مزایا را دریافت کنند.
-
-### 🎯 سناریوها
-
-#### سناریو 1: پرداخت آنلاین (درگاه پرداخت)
-```
-کاربر → انتخاب گزینه "پرداخت دستی" در فرانت‌آفیس
-  ↓
-ایجاد Transaction با Type=ManualPaymentOnline, Amount=56M, Status=Pending
-  ↓
-ریدایرکت به درگاه پرداخت (Zarinpal/Mellat/...)
-  ↓
-Callback از درگاه با RefId
-  ↓
-VerifyManualPaymentCommand → تایید تراکنش
-  ↓
-شارژ کیف‌پول‌ها (Balance=56M, NetworkBalance=56M, DiscountBalance=56M)
-  ↓
-فعال‌سازی عضویت باشگاه (ClubMembership)
-```
-
-#### سناریو 2: کارت‌به‌کارت با تایید ادمین
-```
-کاربر → کارت‌به‌کارت 56 میلیون + ارسال تصویر رسید
-  ↓
-CreateManualPaymentRequestCommand → ثبت درخواست با Status=PendingAdminApproval
-  - تصویر رسید + کد پیگیری استخراج شده توسط کاربر
-  ↓
-ادمین → بررسی درخواست در BackOffice
-  ↓
-ApproveManualPaymentCommand یا RejectManualPaymentCommand
-  ↓
-در صورت تایید: 
-  - ایجاد Transaction با RefId=کد پیگیری
-  - شارژ کیف‌پول‌ها
-  - فعال‌سازی عضویت باشگاه
-  ↓
-در صورت رد:
-  - ثبت دلیل رد
-  - اطلاع‌رسانی به کاربر
-```
-
---
-
-## 🗂️ Architecture
-
-### Domain Layer
-
-> **وضعیت فعلی پیاده‌سازی (CMS)**  
-> در نسخه‌ای که الآن در CMS داریم، سناریوی «درخواست پرداخت دستی توسط کاربر» (ManualPaymentRequest + Verify از درگاه) هنوز پیاده‌سازی نشده و فقط بخش **پرداخت دستی توسط Admin/SuperAdmin** با Entity ساده‌تر `ManualPayment` و Enumهای `ManualPaymentType` و `ManualPaymentStatus` (Pending/Approved/Rejected/Cancelled) اجرا شده است.  
-> بخش‌های زیر که با `ManualPaymentRequest`، `ManualPaymentMethod` و Verify/ProcessManualPayment توضیح داده شده‌اند، طراحی کامل سیستم هستند و برای فاز بعدی (FrontOffice + OnlineGateway/CardToCard) استفاده خواهند شد.
-
-#### **ManualPaymentStatus Enum (طراحی کامل – برای Requestها)**
-```csharp
-public enum ManualPaymentStatus
-{
-    PendingAdminApproval = 0,  // در انتظار تایید ادمین (کارت‌به‌کارت)
-    PendingPayment = 1,         // در انتظار پرداخت (درگاه آنلاین)
-    PaymentVerified = 2,        // پرداخت تایید شده (از درگاه)
-    AdminApproved = 3,          // تایید شده توسط ادمین
-    AdminRejected = 4,          // رد شده توسط ادمین
-    Completed = 5,              // تکمیل شده (کیف‌پول شارژ شده)
-    Failed = 6                  // خطا در پردازش
-}
-```
-
-#### **ManualPaymentMethod Enum**
-```csharp
-public enum ManualPaymentMethod
-{
-    OnlineGateway = 0,     // درگاه آنلاین
-    CardToCard = 1         // کارت‌به‌کارت
-}
-```
-
-#### **ManualPaymentRequest Entity (طراحی کامل – هنوز پیاده نشده)**
-```csharp
-public class ManualPaymentRequest : BaseAuditableEntity
-{
-    public long UserId { get; set; }
-    public ManualPaymentMethod Method { get; set; }
-    public ManualPaymentStatus Status { get; set; }
-    public long Amount { get; set; } = 56_000_000; // مبلغ ثابت
-    
-    // آنلاین Gateway
-    public string? GatewayName { get; set; }        // Zarinpal, Mellat, etc.
-    public string? GatewayTrackingCode { get; set; } // کد پیگیری درگاه
-    public DateTime? GatewayPaymentDate { get; set; }
-    
-    // کارت‌به‌کارت
-    public string? ReceiptImageUrl { get; set; }     // مسیر تصویر رسید
-    public string? UserProvidedTrackingCode { get; set; } // کد پیگیری که کاربر داده
-    public DateTime? CardToCardDate { get; set; }
-    
-    // تایید/رد ادمین
-    public long? ApprovedByAdminId { get; set; }
-    public DateTime? AdminDecisionDate { get; set; }
-    public string? AdminNotes { get; set; }         // توضیحات ادمین (دلیل رد)
-    
-    // تراکنش نهایی
-    public long? TransactionId { get; set; }
-    public bool IsProcessed { get; set; }
-    public DateTime? ProcessedDate { get; set; }
-    
-    // Navigation Properties
-    public virtual User User { get; set; }
-    public virtual User? ApprovedByAdmin { get; set; }
-    public virtual Transactions? Transaction { get; set; }
-}
-```
-
---
-
-### Application Layer
-
-#### **Commands**
-
-##### 1. CreateManualPaymentRequestCommand (FrontOffice)
-ایجاد درخواست پرداخت دستی توسط کاربر
-
-**Request:**
-```csharp
-public record CreateManualPaymentRequestCommand : IRequest<CreateManualPaymentRequestResponseDto>
-{
-    public long UserId { get; init; }
-    public ManualPaymentMethod Method { get; init; }
-    
-    // برای OnlineGateway
-    public string? GatewayName { get; init; }
-    public string? ReturnUrl { get; init; } // URL بازگشت بعد از پرداخت
-    
-    // برای CardToCard
-    public IFormFile? ReceiptImage { get; init; }     // فایل تصویر رسید
-    public string? TrackingCode { get; init; }         // کد پیگیری
-    public DateTime? TransactionDate { get; init; }
-}
-```
-
-**Response:**
-```csharp
-public class CreateManualPaymentRequestResponseDto
-{
-    public long RequestId { get; set; }
-    public ManualPaymentStatus Status { get; set; }
-    
-    // برای OnlineGateway: URL پرداخت
-    public string? PaymentUrl { get; set; }
-    
-    // برای CardToCard: پیام موفقیت
-    public string Message { get; set; }
-}
-```
-
-**Business Logic:**
-1. بررسی اینکه کاربر قبلاً درخواست Pending ندارد
-2. اگر Method=OnlineGateway:
-   - ایجاد ManualPaymentRequest با Status=PendingPayment
-   - فراخوانی Gateway Service برای دریافت URL پرداخت
-   - ذخیره GatewayName و کد درخواست
-   - برگرداندن PaymentUrl به کاربر
-3. اگر Method=CardToCard:
-   - آپلود تصویر رسید به Storage
-   - ایجاد ManualPaymentRequest با Status=PendingAdminApproval
-   - ذخیره UserProvidedTrackingCode و CardToCardDate
-   - ارسال نوتیفیکیشن به ادمین‌ها
-
-##### 2. VerifyManualPaymentCommand (Callback از درگاه)
-تایید پرداخت آنلاین بعد از بازگشت از درگاه
-
-**Request:**
-```csharp
-public record VerifyManualPaymentCommand : IRequest<VerifyManualPaymentResponseDto>
-{
-    public long RequestId { get; init; }
-    public string GatewayTrackingCode { get; init; }
-    public string? Authority { get; init; } // پارامتر درگاه
-}
-```
-
-**Business Logic:**
-1. یافتن ManualPaymentRequest با Status=PendingPayment
-2. فراخوانی Gateway Service برای Verify کردن تراکنش
-3. اگر تایید شد:
-   - به‌روزرسانی Status → PaymentVerified
-   - ذخیره GatewayTrackingCode و GatewayPaymentDate
-   - فراخوانی ProcessManualPaymentCommand برای شارژ کیف‌پول
-4. اگر رد شد:
-   - به‌روزرسانی Status → Failed
-
-##### 3. ApproveManualPaymentCommand (Admin)
-تایید درخواست کارت‌به‌کارت توسط ادمین
-
-**Request:**
-```csharp
-public record ApproveManualPaymentCommand : IRequest<ApproveManualPaymentResponseDto>
-{
-    public long RequestId { get; init; }
-    public long AdminUserId { get; init; }
-    public string? AdminNotes { get; init; }
-}
-```
-
-**Business Logic:**
-1. بررسی RequestId موجود با Status=PendingAdminApproval
-2. بررسی دسترسی ادمین
-3. به‌روزرسانی:
-   - Status → AdminApproved
-   - ApprovedByAdminId, AdminDecisionDate, AdminNotes
-4. فراخوانی ProcessManualPaymentCommand برای شارژ کیف‌پول
-
-##### 4. RejectManualPaymentCommand (Admin)
-رد درخواست کارت‌به‌کارت توسط ادمین
-
-**Request:**
-```csharp
-public record RejectManualPaymentCommand : IRequest<RejectManualPaymentResponseDto>
-{
-    public long RequestId { get; init; }
-    public long AdminUserId { get; init; }
-    public string RejectionReason { get; init; } // الزامی
-}
-```
-
-**Business Logic:**
-1. بررسی RequestId موجود
-2. به‌روزرسانی:
-   - Status → AdminRejected
-   - ApprovedByAdminId, AdminDecisionDate
-   - AdminNotes = RejectionReason
-3. ارسال نوتیفیکیشن به کاربر با دلیل رد
-
-##### 5. ProcessManualPaymentCommand (Internal)
-شارژ کیف‌پول‌ها بعد از تایید پرداخت
-
-**این Command داخلی است و فقط توسط Verify یا Approve فراخوانی می‌شود.**
-
-**Business Logic:**
-1. ایجاد Transaction:
-   - Type: DepositManual
-   - Amount: 56M
-   - RefId: GatewayTrackingCode یا UserProvidedTrackingCode
-2. شارژ Balance: +56M
-3. شارژ NetworkBalance: +56M
-4. شارژ DiscountBalance: +56M
-5. فعال‌سازی ClubMembership (اگر غیرفعال باشد)
-6. ثبت UserWalletChangeLog
-7. به‌روزرسانی ManualPaymentRequest:
-   - Status → Completed
-   - TransactionId, IsProcessed=true, ProcessedDate
-8. ارسال نوتیفیکیشن موفقیت به کاربر
-
-##### 6. GetUserManualPaymentHistoryQuery
-دریافت تاریخچه پرداخت‌های دستی کاربر
-
-**Request:**
-```csharp
-public record GetUserManualPaymentHistoryQuery : IRequest<List<ManualPaymentHistoryDto>>
-{
-    public long UserId { get; init; }
-}
-```
-
-##### 7. GetPendingManualPaymentsQuery (Admin)
-دریافت لیست درخواست‌های در انتظار تایید
-
-**Request:**
-```csharp
-public record GetPendingManualPaymentsQuery : IRequest<List<PendingManualPaymentDto>>
-{
-    public ManualPaymentStatus? StatusFilter { get; init; } = ManualPaymentStatus.PendingAdminApproval;
-    public int PageNumber { get; init; } = 1;
-    public int PageSize { get; init; } = 20;
-}
-```
-
---
-
-## 💾 Database Schema
-
-### ManualPaymentRequests Table
-```sql
-CREATE TABLE [CMS].[ManualPaymentRequests] (
-    [Id] bigint IDENTITY(1,1) PRIMARY KEY,
-    [UserId] bigint NOT NULL FOREIGN KEY REFERENCES Users(Id),
-    [Method] int NOT NULL,
-    [Status] int NOT NULL,
-    [Amount] bigint NOT NULL DEFAULT 56000000,
-    
-    -- آنلاین Gateway
-    [GatewayName] nvarchar(50) NULL,
-    [GatewayTrackingCode] nvarchar(200) NULL,
-    [GatewayPaymentDate] datetime2 NULL,
-    
-    -- کارت‌به‌کارت
-    [ReceiptImageUrl] nvarchar(500) NULL,
-    [UserProvidedTrackingCode] nvarchar(200) NULL,
-    [CardToCardDate] datetime2 NULL,
-    
-    -- تایید ادمین
-    [ApprovedByAdminId] bigint NULL FOREIGN KEY REFERENCES Users(Id),
-    [AdminDecisionDate] datetime2 NULL,
-    [AdminNotes] nvarchar(max) NULL,
-    
-    -- تراکنش
-    [TransactionId] bigint NULL FOREIGN KEY REFERENCES Transactionss(Id),
-    [IsProcessed] bit NOT NULL DEFAULT 0,
-    [ProcessedDate] datetime2 NULL,
-    
-    -- Audit
-    [Created] datetime2 NOT NULL,
-    [CreatedBy] nvarchar(max) NULL,
-    [LastModified] datetime2 NULL,
-    [LastModifiedBy] nvarchar(max) NULL,
-    [IsDeleted] bit NOT NULL DEFAULT 0
-);
-
-CREATE INDEX IX_ManualPaymentRequests_UserId ON ManualPaymentRequests(UserId);
-CREATE INDEX IX_ManualPaymentRequests_Status ON ManualPaymentRequests(Status);
-CREATE INDEX IX_ManualPaymentRequests_TransactionId ON ManualPaymentRequests(TransactionId);
-```
-
---
-
-## 🔄 Process Flows
-
-### Flow 1: پرداخت آنلاین
-```mermaid
-sequenceDiagram
-    participant User as کاربر
-    participant FrontOffice as FrontOffice
-    participant CMS as CMS API
-    participant Gateway as درگاه پرداخت
-    
-    User->>FrontOffice: انتخاب "پرداخت دستی"
-    FrontOffice->>CMS: CreateManualPaymentRequest (Method=OnlineGateway)
-    CMS->>Gateway: ایجاد درخواست پرداخت
-    Gateway-->>CMS: PaymentUrl
-    CMS-->>FrontOffice: PaymentUrl
-    FrontOffice->>Gateway: ریدایرکت کاربر
-    User->>Gateway: پرداخت 56M
-    Gateway->>CMS: Callback (RefId, Authority)
-    CMS->>Gateway: Verify Payment
-    Gateway-->>CMS: تایید پرداخت
-    CMS->>CMS: ProcessManualPayment (شارژ کیف‌پول)
-    CMS-->>FrontOffice: موفقیت
-    FrontOffice-->>User: پرداخت موفق
-```
-
-### Flow 2: کارت‌به‌کارت
-```mermaid
-sequenceDiagram
-    participant User as کاربر
-    participant FrontOffice as FrontOffice
-    participant CMS as CMS API
-    participant Admin as ادمین (BackOffice)
-    
-    User->>User: کارت‌به‌کارت 56M
-    User->>FrontOffice: آپلود رسید + کد پیگیری
-    FrontOffice->>CMS: CreateManualPaymentRequest (Method=CardToCard)
-    CMS->>CMS: ذخیره تصویر + Status=PendingAdminApproval
-    CMS-->>Admin: نوتیفیکیشن (درخواست جدید)
-    Admin->>CMS: GetPendingManualPayments
-    CMS-->>Admin: لیست درخواست‌ها
-    Admin->>Admin: بررسی رسید و کد پیگیری
-    
-    alt تایید
-        Admin->>CMS: ApproveManualPayment
-        CMS->>CMS: ProcessManualPayment (شارژ کیف‌پول)
-        CMS-->>User: نوتیفیکیشن موفقیت
-    else رد
-        Admin->>CMS: RejectManualPayment (دلیل رد)
-        CMS-->>User: نوتیفیکیشن رد با دلیل
-    end
-```
-
---
-
-## 🧪 Testing Scenarios
-
-### Test 1: پرداخت آنلاین موفق
-```bash
-# Step 1: ایجاد درخواست
-POST /api/manualpayment/create
-{
-  "userId": 123,
-  "method": 0,
-  "gatewayName": "Zarinpal",
-  "returnUrl": "https://example.com/callback"
-}
-
-# Response: PaymentUrl
-
-# Step 2: کاربر پرداخت می‌کند (Mock Gateway)
-
-# Step 3: Callback
-POST /api/manualpayment/verify
-{
-  "requestId": 456,
-  "gatewayTrackingCode": "ZP-12345",
-  "authority": "A00000000..."
-}
-
-# Result: کیف‌پول شارژ شده، باشگاه فعال
-```
-
-### Test 2: کارت‌به‌کارت با تایید ادمین
-```bash
-# Step 1: ایجاد درخواست کاربر
-POST /api/manualpayment/create
-{
-  "userId": 123,
-  "method": 1,
-  "receiptImage": <file>,
-  "trackingCode": "REF-98765",
-  "transactionDate": "2024-12-01T10:00:00Z"
-}
-
-# Step 2: ادمین بررسی می‌کند
-GET /api/admin/manualpayment/pending
-
-# Step 3: ادمین تایید می‌کند
-POST /api/admin/manualpayment/approve
-{
-  "requestId": 456,
-  "adminUserId": 1,
-  "adminNotes": "رسید معتبر است"
-}
-
-# Result: کیف‌پول شارژ شده
-```
-
---
-
-## 📋 Implementation Tasks
-
-### CMS Microservice
-
-#### Domain Layer
- [ ] ایجاد `ManualPaymentStatus` enum
- [ ] ایجاد `ManualPaymentMethod` enum
- [ ] ایجاد `ManualPaymentRequest` entity
- [ ] اضافه کردن به `ApplicationDbContext`
-
-#### Application Layer
- [ ] `CreateManualPaymentRequestCommand` + Handler + Validator
- [ ] `VerifyManualPaymentCommand` + Handler
- [ ] `ApproveManualPaymentCommand` + Handler
- [ ] `RejectManualPaymentCommand` + Handler
- [ ] `ProcessManualPaymentCommand` + Handler (Internal)
- [ ] `GetUserManualPaymentHistoryQuery` + Handler
- [ ] `GetPendingManualPaymentsQuery` + Handler
- [ ] Interface: `IPaymentGatewayService`
- [ ] Interface: `IFileStorageService` (برای آپلود تصویر)
-
-#### Infrastructure Layer
- [ ] `ZarinpalGatewayService` : IPaymentGatewayService
- [ ] `LocalFileStorageService` : IFileStorageService
- [ ] Migration: `AddManualPaymentSystem`
-
-#### WebApi Layer (Protobuf/gRPC)
- [ ] Proto definitions: `ManualPayment.proto`
- [ ] gRPC Service: `ManualPaymentService`
-
-### FrontOffice
-
-#### Components
- [ ] `ManualPaymentPage.razor` - صفحه انتخاب روش پرداخت
- [ ] `OnlinePaymentForm.razor` - فرم پرداخت آنلاین
- [ ] `CardToCardForm.razor` - فرم کارت‌به‌کارت (آپلود رسید)
- [ ] `PaymentCallbackPage.razor` - صفحه بازگشت از درگاه
- [ ] `PaymentHistoryPage.razor` - تاریخچه پرداخت‌های کاربر
-
-#### Services
- [ ] `ManualPaymentService.cs` - فراخوانی BFF
-
-### FrontOffice.BFF
-
-#### Application Layer
- [ ] CQRS Handlers برای مپ کردن gRPC به REST
- [ ] DTOs برای API های REST
-
-#### WebApi Layer
- [ ] `ManualPaymentController.cs` - REST endpoints
-
-### BackOffice
-
-#### Components
- [ ] `PendingPaymentsPage.razor` - لیست درخواست‌های در انتظار
- [ ] `PaymentRequestDetailsModal.razor` - جزئیات + نمایش رسید
- [ ] `ApproveRejectButtons.razor` - دکمه‌های تایید/رد
-
-#### Services
- [ ] `ManualPaymentAdminService.cs` - فراخوانی BFF
-
-### BackOffice.BFF
-
-#### Application Layer
- [ ] Admin CQRS Handlers
- [ ] Admin DTOs
-
-#### WebApi Layer
- [ ] `AdminManualPaymentController.cs` - REST endpoints برای ادمین
-
---
-
-## ⚠️ Important Notes
-
-### 1. Transaction Type
- برای پرداخت دستی از `TransactionType.DepositManual` استفاده شود
- RefId = GatewayTrackingCode (آنلاین) یا UserProvidedTrackingCode (کارت‌به‌کارت)
-
-### 2. Security
- تایید پرداخت درگاه باید با Signature Verification انجام شود
- تصاویر رسید باید با Validation بارگذاری شوند (حجم، فرمت، محتوا)
- فقط ادمین‌ها حق تایید/رد کارت‌به‌کارت دارند
-
-### 3. Idempotency
- نباید کاربر بتواند چند درخواست همزمان Pending داشته باشد
- هر RequestId فقط یک بار قابل Verify است
-
-### 4. Notifications
- SMS/Email به کاربر بعد از:
-  - ایجاد درخواست کارت‌به‌کارت
-  - تایید/رد ادمین
-  - موفقیت پرداخت آنلاین
-
-### 5. File Storage
- تصاویر رسید باید با GUID ذخیره شوند
- مسیر: `/uploads/receipts/{year}/{month}/{guid}.jpg`
- حداکثر حجم: 2MB
- فرمت‌های مجاز: JPG, PNG, PDF
-
---
-
-## 🔗 Related Documentation
-
- [daya-loan-integration.md](./daya-loan-integration.md) - سیستم وام دایا
- [network-club-commission-system-v1.1.md](./network-club-commission-system-v1.1.md) - بیزینس کلی
-
---
-
-**Created:** 2024-12-01  
-**Status:** ⚠️ Not Implemented Yet (Design Complete)  
-**Priority:** High (برای کاربران بدون وام دایا ضروری است)
@@ -1,905 +0,0 @@
-# سیستم باشگاه مشتریان و محاسبه کمیسیون شبکه
-
-## خلاصه اجرایی
-این سند تحلیل جامع و معماری پیشنهادی برای پیاده‌سازی سیستم باشگاه مشتریان (Club Membership) و محاسبه کمیسیون شبکه‌ای (MLM Binary Plan) را ارائه می‌دهد. این سیستم امکان مدیریت سه نوع کیف پول، فروشگاه اختصاصی با تخفیف، و توزیع عادلانه کمیسیون بر اساس تعادل شبکه را فراهم می‌کند.
-
---
-
-## ۱. مفاهیم کلیدی
-
-### ۱.۱ کیف پول‌های سه‌گانه
-هر کاربر سه نوع کیف پول دارد:
-
-1. **کیف پول اصلی (Balance)**: برای خرید از فروشگاه عمومی بازار
-2. **کیف پول تخفیف (DiscountBalance)**: فقط برای خرید از فروشگاه باشگاه مشتریان (محدود به درصد تخفیف محصولات)
-3. **کیف پول طلایی/کارمزد (NetworkBalance)**: دریافتی از کمیسیون شبکه‌ای - قابل برداشت نقدی یا خرید الماس از دایا
-
-### ۱.۲ فعال‌سازی عضویت
- کاربر ۵۶ میلیون تومان پرداخت می‌کند (از طریق دایا یا درگاه)
- سیستم به صورت خودکار:
-  - `Balance += 56M` (کیف پول اصلی)
-  - `DiscountBalance += 56M` (کیف پول تخفیف)
- کاربر دکمه «عضویت در باشگاه» را می‌زند:
-  - `25M` به استخر کمیسیون هفتگی اضافه می‌شود
-  - کاربر در شبکه باینری (Binary Tree) قرار می‌گیرد
-
-### ۱.۳ شبکه باینری (Binary MLM Plan)
- هر کاربر حداکثر دو زیرمجموعه دارد: **دست راست** و **دست چپ**
- تعادل (Balance): زمانی که هر دو شاخه دارای اعضای جدید شوند، یک تعادل ایجاد می‌شود
- **فرمول تعادل**: `UserBalances = MIN(LeftLegBalances, RightLegBalances)`
- تعادل‌ها به صورت هفتگی محاسبه و بعد از توزیع کمیسیون، ریست می‌شوند
-
-### ۱.۴ محاسبه کمیسیون هفتگی
-```text
-مبلغ ریالی هر امتیاز = (مجموع مبالغ استخر) ÷ (مجموع تعادل‌های کل سیستم)
-کمیسیون هر کاربر = (تعداد تعادل کاربر) × (مبلغ ریالی هر امتیاز)
-```
-
-**مثال**:
- کاربر A: خودش ۱ تعادل + زیرمجموعه‌هایش ۲ تعادل = **۳ امتیاز**
- استخر هفتگی: `175M`
- مجموع امتیازهای سیستم: `5`
- ارزش هر امتیاز: `175M ÷ 5 = 35M`
- کمیسیون کاربر A: `3 × 35M = 105M`
-
---
-
-## ۲. موجودیت‌های جدید (Domain Entities)
-
-### ۲.۱ `ClubMembership` (عضویت باشگاه مشتریان)
-```csharp
-public class ClubMembership : BaseAuditableEntity
-{
-    public long UserId { get; set; }
-    public virtual User User { get; set; }
-
-    public bool IsActive { get; set; }
-    public DateTime? ActivatedAt { get; set; }
-
-    // مبلغ اولیه پرداختی برای فعال‌سازی (معمولاً ۲۵ میلیون)
-    public long InitialContribution { get; set; }
-
-    // مجموع درآمد کارمزد تاکنون
-    public long TotalEarned { get; set; }
-
-    public virtual ICollection<UserClubFeature> UserClubFeatures { get; set; }
-}
-```
-
-### ۲.۲ `ClubFeature` (امکانات باشگاه)
-```csharp
-public class ClubFeature : BaseAuditableEntity
-{
-    public string Title { get; set; }
-    public string? Description { get; set; }
-
-    public bool IsActive { get; set; }
-
-    public int? RequiredPoints { get; set; }
-    public int SortOrder { get; set; }
-
-    public virtual ICollection<UserClubFeature> UserClubFeatures { get; set; }
-}
-```
-
-### ۲.۳ `UserClubFeature` (امتیاز/فیچرهای فعال برای کاربر)
-```csharp
-public class UserClubFeature : BaseAuditableEntity
-{
-    public long UserId { get; set; }
-    public virtual User User { get; set; }
-
-    public long ClubFeatureId { get; set; }
-    public virtual ClubFeature ClubFeature { get; set; }
-
-    public DateTime GrantedAt { get; set; }
-    public string? Notes { get; set; }
-}
-```
-
-### ۲.۴ `NetworkWeeklyBalance` (تعادل هفتگی شبکه)
-```csharp
-public class NetworkWeeklyBalance : BaseAuditableEntity
-{
-    public long UserId { get; set; }
-    public virtual User User { get; set; }
-
-    // مثلاً "2025-W48"
-    public string WeekNumber { get; set; }
-
-    public int LeftLegBalances { get; set; }
-    public int RightLegBalances { get; set; }
-    public int TotalBalances { get; set; }
-
-    // مبلغی که این کاربر همان هفته به استخر اضافه کرده (معمولاً InitialContribution)
-    public long WeeklyPoolContribution { get; set; }
-
-    public DateTime? CalculatedAt { get; set; }
-    public bool IsExpired { get; set; }
-}
-```
-
-### ۲.۵ `WeeklyCommissionPool` (استخر کمیسیون هفتگی)
-```csharp
-public class WeeklyCommissionPool : BaseAuditableEntity
-{
-    public string WeekNumber { get; set; }
-
-    public long TotalPoolAmount { get; set; }
-    public int TotalBalances { get; set; }
-    public long ValuePerBalance { get; set; }
-
-    public bool IsCalculated { get; set; }
-    public DateTime? CalculatedAt { get; set; }
-
-    public virtual ICollection<UserCommissionPayout> UserCommissionPayouts { get; set; }
-}
-```
-
-### ۲.۶ `UserCommissionPayout` (پرداخت کمیسیون به کاربر)
-```csharp
-public class UserCommissionPayout : BaseAuditableEntity
-{
-    public long UserId { get; set; }
-    public virtual User User { get; set; }
-
-    public string WeekNumber { get; set; }
-
-    public long WeeklyPoolId { get; set; }
-    public virtual WeeklyCommissionPool WeeklyPool { get; set; }
-
-    public int BalancesEarned { get; set; }
-    public long ValuePerBalance { get; set; }
-    public long TotalAmount { get; set; }
-
-    public CommissionPayoutStatus Status { get; set; }
-
-    public DateTime? PaidAt { get; set; }
-
-    public WithdrawalMethod? WithdrawalMethod { get; set; }
-    public string? IbanNumber { get; set; }
-    public DateTime? WithdrawnAt { get; set; }
-}
-```
-
---
-
-### ۲.۷ موجودیت‌های History (جداول لاگ)
-
-#### ۲.۷.۱ `ClubMembershipHistory`
-لاگ تغییرات مهم روی عضویت باشگاه (فعال‌سازی، غیرفعال‌سازی، ویرایش):
-
-```csharp
-public class ClubMembershipHistory : BaseAuditableEntity
-{
-    public long ClubMembershipId { get; set; }
-    public long UserId { get; set; }
-
-    public bool OldIsActive { get; set; }
-    public bool NewIsActive { get; set; }
-
-    public long? OldInitialContribution { get; set; }
-    public long? NewInitialContribution { get; set; }
-
-    // Activated / Deactivated / Updated / ManualFix
-    public string Action { get; set; }
-    public string? Reason { get; set; }
-}
-```
-
-#### ۲.۷.۲ `NetworkMembershipHistory`
-برای اینکه همیشه بدانیم «چه کسی زیرمجموعه‌ی کی شده، چه زمانی، و اگر بعداً جابه‌جا شد چه اتفاقی افتاده»:
-
-```csharp
-public class NetworkMembershipHistory : BaseAuditableEntity
-{
-    public long UserId { get; set; }
-
-    public long? OldParentId { get; set; }
-    public long? NewParentId { get; set; }
-
-    public NetworkLeg? OldLegPosition { get; set; }
-    public NetworkLeg? NewLegPosition { get; set; }
-
-    // Join / Move / Remove
-    public string Action { get; set; }
-    public string? Reason { get; set; }
-}
-```
-
- هر بار `RecordNetworkJoin` یا `UpdateNetworkPosition` صدا زده می‌شود، باید یک رکورد در این جدول نوشته شود.
- این جدول مرجع اصلی برای بازسازی درخت شبکه در زمان‌های گذشته است.
-
-#### ۲.۷.۳ `CommissionPayoutHistory`
-برای لاگ کامل همه‌ی تغییرات روی پرداخت کمیسیون‌ها (ایجاد، ویرایش دستی، تغییر وضعیت، برداشت و ...):
-
-```csharp
-public class CommissionPayoutHistory : BaseAuditableEntity
-{
-    public long UserCommissionPayoutId { get; set; }
-    public long UserId { get; set; }
-    public string WeekNumber { get; set; }
-
-    public long AmountBefore { get; set; }
-    public long AmountAfter { get; set; }
-
-    public CommissionPayoutStatus OldStatus { get; set; }
-    public CommissionPayoutStatus NewStatus { get; set; }
-
-    // Created / Paid / WithdrawRequested / Withdrawn / Cancelled / ManualFix
-    public string Action { get; set; }
-    public string? PerformedBy { get; set; } // UserId یا System
-    public string? Reason { get; set; }
-}
-```
-
- اگر بعداً بفهمیم یک پرداخت اشتباه بوده و اصلاحش کنیم، اینجا قابل ردیابی است.
- برای گزارش‌گیری Audit کامل پرداخت‌ها، این جدول استفاده می‌شود.
-
-#### ۲.۷.۴ `SystemConfigurationHistory`
-تاریخچه تغییرات تنظیمات (Config) برای این‌که بعداً بدانیم در هر زمان چه محدودیتی فعال بوده:
-
-```csharp
-public class SystemConfigurationHistory : BaseAuditableEntity
-{
-    public long ConfigurationId { get; set; }
-
-    public ConfigurationScope Scope { get; set; }
-    public string Key { get; set; }
-
-    public string OldValue { get; set; }
-    public string NewValue { get; set; }
-
-    public string? Reason { get; set; }
-}
-```
-
---
-
-### ۲.۸ موجودیت‌های Configuration (تنظیمات پویا)
-
-#### ۲.۸.۱ `ConfigurationScope` (Enum)
-```csharp
-public enum ConfigurationScope
-{
-    System = 0,
-    Network = 1,
-    Club = 2,
-    Commission = 3
-}
-```
-
-#### ۲.۸.۲ `SystemConfiguration`
-جدولی برای نگهداری تنظیمات پویا. هم تنظیمات عمومی سیستم، هم تنظیمات مخصوص شبکه، باشگاه و کمیسیون:
-
-```csharp
-public class SystemConfiguration : BaseAuditableEntity
-{
-    public ConfigurationScope Scope { get; set; } // System / Network / Club / Commission
-
-    // مثل: "MaxWeeklyBalancesPerUser", "MinContributionAmount", ...
-    public string Key { get; set; }
-
-    // مقدار به‌صورت رشته - تفسیر در لایه Application
-    public string Value { get; set; }
-
-    // برای UI و Validation (Int / Decimal / Bool / String / Json)
-    public string? DataType { get; set; }
-
-    public string? Description { get; set; }
-    public bool IsActive { get; set; }
-}
-```
-
-**مثال کانفیگ‌های مرتبط با شبکه:**
-
- `Scope = Network`, `Key = "MaxWeeklyBalancesPerUser"`, `Value = "300"`
- `Scope = Network`, `Key = "MaxChildrenPerLeg"`, `Value = "1"`
- `Scope = Commission`, `Key = "DefaultInitialContribution"`, `Value = "25000000"`
-
-> نکته: هر بار که مقدار `SystemConfiguration` تغییر می‌کند، یک رکورد در `SystemConfigurationHistory` ثبت می‌شود تا تنظیمات گذشته قابل ردیابی باشد.
-
---
-
-### ۲.۹ Enums جدید
-```csharp
-public enum CommissionPayoutStatus
-{
-    Pending = 0,
-    Paid = 1,
-    WithdrawRequested = 2,
-    Withdrawn = 3,
-    Cancelled = 4
-}
-
-public enum WithdrawalMethod
-{
-    Cash = 0,
-    Diamond = 1
-}
-
-public enum NetworkLeg
-{
-    Left = 0,
-    Right = 1
-}
-```
-
---
-
-## ۳. تغییرات در موجودیت‌های موجود
-
-### ۳.۱ `User`
-افزودن فیلدهای مربوط به شبکه باینری و ناوبری:
-
-```csharp
-public class User : BaseAuditableEntity
-{
-    // ...
-
-    public long? NetworkParentId { get; set; }
-    public virtual User? NetworkParent { get; set; }
-
-    public NetworkLeg? LegPosition { get; set; }
-
-    public virtual ICollection<User> NetworkChildren { get; set; }
-
-    public virtual ClubMembership? ClubMembership { get; set; }
-    public virtual ICollection<NetworkWeeklyBalance> NetworkWeeklyBalances { get; set; }
-    public virtual ICollection<UserCommissionPayout> CommissionPayouts { get; set; }
-
-    public virtual ICollection<UserClubFeature> UserClubFeatures { get; set; }
-}
-```
-
-### ۳.۲ `UserWallet`
-```csharp
-public class UserWallet : BaseAuditableEntity
-{
-    // موجودی ریالی اصلی
-    public long Balance { get; set; }
-
-    // موجودی شبکه/کارمزد (کیف پول طلایی)
-    public long NetworkBalance { get; set; }
-
-    // موجودی تخفیف (فقط برای خرید از فروشگاه باشگاه)
-    public long DiscountBalance { get; set; }
-
-    // ...
-}
-```
-
-### ۳.۳ `Products`
-```csharp
-public class Product : BaseAuditableEntity
-{
-    // ...
-
-    // آیا این محصول فقط در فروشگاه باشگاه موجود است
-    public bool IsClubExclusive { get; set; }
-
-    // درصد تخفیف باشگاه (0 تا 100)
-    public int ClubDiscountPercent { get; set; }
-
-    // ...
-}
-```
-
-### ۳.۴ `UserWalletChangeLog`
-افزودن نوع جدید تراکنش:
-```csharp
-public enum TransactionType
-{
-    // ...
-
-    NetworkCommission = 10,    // دریافت کمیسیون شبکه
-    ClubActivation = 11,       // فعال‌سازی عضویت باشگاه
-    DiscountWalletCharge = 12, // شارژ کیف پول تخفیف
-}
-```
-
---
-
-## ۴. معماری ماژول‌های جدید (Application / CQRS)
-
-### ۴.۱ `ClubMembershipCQ/`
-#### Commands
- **ActivateClubMembership**: فعال‌سازی عضویت باشگاه (کسر ۲۵ میلیون و اضافه به استخر)
- **DeactivateClubMembership**: غیرفعال‌سازی عضویت
- **UpdateClubMembership**: به‌روزرسانی اطلاعات عضویت
-
-#### Queries
- **GetUserClubStatus**: دریافت وضعیت عضویت کاربر
- **GetAllClubMembersByFilter**: لیست اعضای باشگاه با فیلتر
-
-### ۴.۲ `ClubFeatureCQ/`
-#### Commands
- **CreateClubFeature**: ایجاد فیچر جدید
- **UpdateClubFeature**: ویرایش فیچر
- **DeleteClubFeature**: حذف فیچر
- **GrantFeatureToUser**: فعال‌سازی فیچر برای کاربر
- **RevokeFeatureFromUser**: غیرفعال‌سازی فیچر از کاربر
-
-#### Queries
- **GetAllClubFeatures**: لیست تمام فیچرها
- **GetUserClubFeatures**: لیست فیچرهای فعال یک کاربر
-
-### ۴.۳ `NetworkBalanceCQ/`
-#### Commands
- **RecordNetworkJoin**: ثبت ورود کاربر به شبکه باینری (تعیین والد و شاخه)  
-  - حتماً باید یک رکورد در `NetworkMembershipHistory` ایجاد کند.
- **UpdateNetworkPosition**: تغییر موقعیت در شبکه (مدیریتی)  
-  - هر تغییر، یک رکورد History.
- **CalculateWeeklyBalances**: محاسبه تعادل‌های هفتگی (فراخوانی از Worker)
-
-#### Queries
- **GetUserNetworkTree**: دریافت درخت زیرمجموعه‌های کاربر (چند سطح)
- **GetUserWeeklyBalances**: دریافت تعادل‌های هفتگی یک کاربر
- **GetNetworkStatistics**: آمار کلی شبکه (تعداد اعضا، عمق، تعادل)
-
-### ۴.۴ `CommissionPoolCQ/`
-#### Commands
- **InitializeWeeklyPool**: ایجاد استخر جدید برای هفته
- **AddToWeeklyPool**: افزودن مبلغ به استخر هفتگی (هنگام فعال‌سازی عضویت)
- **CalculatePoolValue**: محاسبه ارزش هر امتیاز
- **DistributeCommissions**: توزیع کمیسیون‌ها به کاربران (Worker)
- **CloseWeeklyPool**: بستن استخر پس از توزیع
-
-#### Queries
- **GetCurrentWeekPool**: دریافت اطلاعات استخر هفته جاری
- **GetPoolHistory**: تاریخچه استخرهای قبلی با فیلتر
-
-### ۴.۵ `CommissionPayoutCQ/`
-#### Commands
- **CreatePayoutRecord**: ثبت پرداخت کمیسیون (اتوماتیک از Worker)  
-  - همراه با ایجاد رکورد در `CommissionPayoutHistory` (Action = Created).
- **RequestWithdrawal**: درخواست برداشت کمیسیون (نقدی یا الماس)  
-  - History با Action = WithdrawRequested.
- **ProcessWithdrawal**: پردازش درخواست برداشت (تایید/رد ادمین)  
-  - تغییر Status + History.
- **CancelPayout**: لغو پرداخت
-
-#### Queries
- **GetUserCommissionHistory**: تاریخچه کمیسیون‌های دریافتی کاربر
- **GetPendingWithdrawals**: لیست درخواست‌های برداشت در انتظار (برای ادمین)
- **GetCommissionSummary**: خلاصه درآمد کمیسیون (مجموع، ماهانه، سالانه)
-
-### ۴.۶ `ConfigurationCQ/`
-#### Commands
- **SetConfigurationValue**: ثبت/ویرایش یک تنظیم (SystemConfiguration)  
-  - هر تغییر باید در `SystemConfigurationHistory` ثبت شود.
- **DeactivateConfiguration**: غیرفعال‌سازی یک تنظیم
-
-#### Queries
- **GetConfigurationValue**: دریافت مقدار یک Key
- **GetConfigurationByScope**: لیست تنظیمات یک Scope (مثلاً Network)
-
---
-
-## ۵. Background Worker/Job (محاسبات هفتگی)
-
-### ۵.۱ `WeeklyNetworkCommissionWorker`
-**زمان‌بندی**: هر یکشنبه ساعت ۲۳:۵۹ (یا دوشنبه ۰۰:۰۱)
-
-**مراحل اجرایی (High-level):**
-
-#### گام ۱: بستن هفته قبل و ایجاد استخر جدید
-```csharp
-var currentWeek = GetCurrentWeekNumber(); // مثلاً "2025-W48"
-var previousWeek = GetPreviousWeekNumber();
-
-await CloseWeeklyPool(previousWeek);
-await InitializeWeeklyPool(currentWeek);
-```
-
-#### گام ۲: محاسبه تعادل‌های شبکه
-```csharp
-var maxBalancesPerUser = GetConfig<int>("MaxWeeklyBalancesPerUser", scope: ConfigurationScope.Network);
-
-var activeMembers = await GetActiveClubMembers();
-
-foreach (var member in activeMembers)
-{
-    var leftBalances = await CalculateLegBalances(member.UserId, NetworkLeg.Left, previousWeek);
-    var rightBalances = await CalculateLegBalances(member.UserId, NetworkLeg.Right, previousWeek);
-
-    var totalBalances = Math.Min(leftBalances, rightBalances);
-
-    // اعمال محدودیت کانفیگ (مثلاً حداکثر 300 تعادل برای هر کاربر)
-    if (totalBalances > maxBalancesPerUser)
-        totalBalances = maxBalancesPerUser;
-
-    await RecordWeeklyBalance(new NetworkWeeklyBalance {
-        UserId = member.UserId,
-        WeekNumber = previousWeek,
-        LeftLegBalances = leftBalances,
-        RightLegBalances = rightBalances,
-        TotalBalances = totalBalances,
-        WeeklyPoolContribution = member.InitialContribution,
-        CalculatedAt = DateTime.UtcNow
-    });
-}
-```
-
-#### الگوریتم بازگشتی محاسبه تعادل شاخه
-```csharp
-private async Task<int> CalculateLegBalances(long userId, NetworkLeg leg, string weekNumber)
-{
-    var children = await GetNetworkChildren(userId, leg);
-    int totalBalances = 0;
-
-    foreach (var child in children)
-    {
-        var childMembership = await GetClubMembership(child.Id);
-        if (childMembership != null && IsInWeek(childMembership.ActivatedAt, weekNumber))
-        {
-            totalBalances++;
-        }
-
-        var childLeftBalances = await CalculateLegBalances(child.Id, NetworkLeg.Left, weekNumber);
-        var childRightBalances = await CalculateLegBalances(child.Id, NetworkLeg.Right, weekNumber);
-
-        totalBalances += Math.Min(childLeftBalances, childRightBalances);
-    }
-
-    return totalBalances;
-}
-```
-
-#### گام ۳: محاسبه استخر و ارزش امتیاز
-```csharp
-var totalPoolAmount = await SumPoolContributions(previousWeek);
-var totalBalances = await SumTotalBalances(previousWeek);
-
-var valuePerBalance = totalBalances > 0 ? totalPoolAmount / totalBalances : 0;
-
-await UpdatePoolValue(previousWeek, totalPoolAmount, totalBalances, valuePerBalance);
-```
-
-#### گام ۴: توزیع کمیسیون‌ها
-```csharp
-var weeklyBalances = await GetWeeklyBalances(previousWeek);
-
-foreach (var balance in weeklyBalances.Where(b => b.TotalBalances > 0))
-{
-    var payoutAmount = balance.TotalBalances * valuePerBalance;
-
-    var payout = new UserCommissionPayout {
-        UserId = balance.UserId,
-        WeekNumber = previousWeek,
-        BalancesEarned = balance.TotalBalances,
-        ValuePerBalance = valuePerBalance,
-        TotalAmount = payoutAmount,
-        Status = CommissionPayoutStatus.Pending
-    };
-    await CreatePayoutRecord(payout); // داخلش CommissionPayoutHistory هم ثبت می‌شود
-
-    await AddToNetworkBalance(balance.UserId, payoutAmount);
-
-    await RecordWalletChange(new UserWalletChangeLog {
-        WalletId = balance.UserId,
-        // PreviousBalance / AfterBalance پر می‌شود
-        Amount = payoutAmount,
-        TransactionType = TransactionType.NetworkCommission,
-        ReferenceId = payout.Id.ToString()
-    });
-
-    payout.Status = CommissionPayoutStatus.Paid;
-    payout.PaidAt = DateTime.UtcNow;
-    await UpdatePayout(payout);
-
-    await AddCommissionHistory(payout, "Paid");
-}
-```
-
-#### گام ۵: ریست تعادل‌ها
-```csharp
-await ExpireWeeklyBalances(previousWeek);
-```
-
---
-
-## ۶. لاجیک فروشگاه و سبد خرید
-
-### ۶.۱ نمایش محصولات
-```csharp
-var query = _context.Products.Where(p => !p.IsDeleted);
-
-if (!user.ClubMembership?.IsActive ?? true)
-{
-    query = query.Where(p => !p.IsClubExclusive);
-}
-
-// اگر کاربر عضو است، قیمت با تخفیف باشگاه محاسبه می‌شود
-```
-
-### ۶.۲ استفاده از کیف پول تخفیف در Checkout
-(خلاصه‌سازی شده – در کد اصلی از DiscountBalance استفاده می‌شود و ChangeLog ثبت می‌گردد.)
-
---
-
-## ۷. سناریوی کامل فعال‌سازی عضویت
-
-### مرحله ۱: شارژ اولیه
-```text
-کاربر → پرداخت ۵۶ میلیون (دایا/درگاه)
-  ↓
-UserWallet.Balance += 56,000,000
-UserWallet.DiscountBalance += 56,000,000
-```
-
-### مرحله ۲: فعال‌سازی عضویت
-```text
-کاربر → کلیک روی دکمه «عضویت در باشگاه»
-  ↓
-API: ActivateClubMembership
-  ↓
-1. ایجاد رکورد ClubMembership:
-   - IsActive = true
-   - InitialContribution = 25,000,000
-
-2. افزودن به استخر هفتگی:
-   - WeeklyCommissionPool.TotalPoolAmount += 25,000,000
-
-3. تعیین موقعیت در شبکه:
-   - User.NetworkParentId = والد
-   - User.LegPosition = Left یا Right
-
-4. ثبت ChangeLog برای استخر:
-   - TransactionType = ClubActivation
-
-5. ثبت ClubMembershipHistory:
-   - Action = "Activated"
-```
-
-### مرحله ۳: محاسبه هفتگی (Worker)
-(مطابق بخش ۵)
-
-### مرحله ۴: برداشت کمیسیون
-```text
-کاربر → درخواست برداشت
-  ↓
-API: RequestWithdrawal (Cash یا Diamond)
-  ↓
-ادمین → تایید درخواست
-  ↓
-1. اگر Cash:
-   - واریز به حساب بانکی
-   - NetworkBalance -= مبلغ
-
-2. اگر Diamond:
-   - خرید الماس از دایا
-   - NetworkBalance -= مبلغ
-```
-
-همراه با ثبت رکورد در `CommissionPayoutHistory` (Action = WithdrawRequested / Withdrawn).
-
---
-
-## ۸. پروتوباف و gRPC Services
-
-### ۸.۱ `clubmembership.proto`
-```protobuf
-syntax = "proto3";
-import "google/protobuf/timestamp.proto";
-
-package clubmembership;
-
-service ClubMembershipService {
-  rpc ActivateMembership (ActivateMembershipRequest) returns (ActivateMembershipResponse);
-  rpc GetClubStatus (GetClubStatusRequest) returns (GetClubStatusResponse);
-  rpc GrantFeature (GrantFeatureRequest) returns (GrantFeatureResponse);
-  rpc GetUserFeatures (GetUserFeaturesRequest) returns (GetUserFeaturesResponse);
-}
-
-message ActivateMembershipRequest {
-  int64 user_id = 1;
-  int64 contribution_amount = 2;
-  int64 network_parent_id = 3;
-  NetworkLeg leg_position = 4;
-}
-
-message ActivateMembershipResponse {
-  bool success = 1;
-  string message = 2;
-  ClubMembershipDto membership = 3;
-}
-
-message GetClubStatusRequest {
-  int64 user_id = 1;
-}
-
-message GetClubStatusResponse {
-  bool is_member = 1;
-  ClubMembershipDto membership = 2;
-}
-
-message ClubMembershipDto {
-  int64 id = 1;
-  int64 user_id = 2;
-  bool is_active = 3;
-  google.protobuf.Timestamp activated_at = 4;
-  int64 initial_contribution = 5;
-  int64 total_earned = 6;
-}
-
-enum NetworkLeg {
-  LEFT = 0;
-  RIGHT = 1;
-}
-```
-
-### ۸.۲ `networkbalance.proto`
-```protobuf
-syntax = "proto3";
-
-package networkbalance;
-
-service NetworkBalanceService {
-  rpc GetNetworkTree (GetNetworkTreeRequest) returns (GetNetworkTreeResponse);
-  rpc GetWeeklyBalances (GetWeeklyBalancesRequest) returns (GetWeeklyBalancesResponse);
-  rpc GetNetworkStats (GetNetworkStatsRequest) returns (GetNetworkStatsResponse);
-}
-
-message GetNetworkTreeRequest {
-  int64 user_id = 1;
-  int32 max_depth = 2;
-}
-
-message GetNetworkTreeResponse {
-  NetworkNodeDto root = 1;
-}
-
-message NetworkNodeDto {
-  int64 user_id = 1;
-  string full_name = 2;
-  NetworkLeg leg_position = 3;
-  bool is_active = 4;
-  repeated NetworkNodeDto children = 5;
-}
-
-message GetWeeklyBalancesRequest {
-  int64 user_id = 1;
-  string week_number = 2;
-}
-
-message GetWeeklyBalancesResponse {
-  int32 left_leg_balances = 1;
-  int32 right_leg_balances = 2;
-  int32 total_balances = 3;
-  int64 pool_contribution = 4;
-}
-```
-
-### ۸.۳ `commissionpayout.proto`
-```protobuf
-syntax = "proto3";
-import "google/protobuf/timestamp.proto";
-
-package commissionpayout;
-
-service CommissionPayoutService {
-  rpc RequestWithdrawal (RequestWithdrawalRequest) returns (RequestWithdrawalResponse);
-  rpc GetCommissionHistory (GetCommissionHistoryRequest) returns (GetCommissionHistoryResponse);
-  rpc GetPendingWithdrawals (GetPendingWithdrawalsRequest) returns (GetPendingWithdrawalsResponse);
-  rpc ProcessWithdrawal (ProcessWithdrawalRequest) returns (ProcessWithdrawalResponse);
-}
-
-message RequestWithdrawalRequest {
-  int64 user_id = 1;
-  int64 amount = 2;
-  WithdrawalMethod method = 3;
-  string iban_number = 4;
-}
-
-message RequestWithdrawalResponse {
-  bool success = 1;
-  string message = 2;
-  int64 request_id = 3;
-}
-
-message GetCommissionHistoryRequest {
-  int64 user_id = 1;
-  int32 page_number = 2;
-  int32 page_size = 3;
-}
-
-message GetCommissionHistoryResponse {
-  repeated CommissionPayoutDto payouts = 1;
-  int32 total_count = 2;
-}
-
-message CommissionPayoutDto {
-  int64 id = 1;
-  string week_number = 2;
-  int32 balances_earned = 3;
-  int64 value_per_balance = 4;
-  int64 total_amount = 5;
-  CommissionPayoutStatus status = 6;
-  google.protobuf.Timestamp paid_at = 7;
-  WithdrawalMethod withdrawal_method = 8;
-}
-
-enum WithdrawalMethod {
-  CASH = 0;
-  DIAMOND = 1;
-}
-
-enum CommissionPayoutStatus {
-  PENDING = 0;
-  PAID = 1;
-  WITHDRAW_REQUESTED = 2;
-  WITHDRAWN = 3;
-  CANCELLED = 4;
-}
-```
-
---
-
-## ۹. نکات حیاتی و بهترین رویه‌ها
-
-### ۹.۱ یکپارچگی شبکه باینری
- هر کاربر حداکثر دو فرزند (یکی Left، یکی Right)
- هنگام اضافه کردن فرزند، کنترل Race Condition
- حذف کاربر نباید ساختار شبکه را خراب کند
-
-### ۹.۲ Transaction Management
- Worker باید تمام مراحل را در یک TransactionScope انجام دهد
- در صورت شکست، Rollback کامل
-
-### ۹.۳ Idempotency
- محاسبه هفتگی برای یک WeekNumber فقط یک‌بار
- بررسی `WeeklyCommissionPool.IsCalculated` قبل از شروع
-
-### ۹.۴ Performance
- Caching درخت شبکه برای کاربران پرحجم
- Index روی `WeekNumber`, `UserId`, `NetworkParentId`
-
-### ۹.۵ Audit و Compliance
- همه تغییرات کیف پول در `UserWalletChangeLog`
- همه پرداخت‌های کمیسیون در `UserCommissionPayout` + `CommissionPayoutHistory`
- تغییرات شبکه در `NetworkMembershipHistory`
- تغییرات تنظیمات در `SystemConfigurationHistory`
-
-### ۹.۶ Security
- محدودیت تعداد درخواست برداشت
- تایید دو مرحله‌ای برای برداشت‌های بالا
- Audit Log برای عملیات حساس
-
---
-
-## ۱۰. مراحل پیاده‌سازی (Roadmap)
-(مطابق نسخه قبلی – فاز ۱ تا ۶)
-
---
-
-## ۱۱. متریک‌های کلیدی (KPIs)
- تعداد اعضای فعال باشگاه
- مجموع کمیسیون‌های پرداختی هر ماه
- میانگین تعادل هر کاربر در هفته
- نرخ تبدیل به عضویت باشگاه
- زمان اجرای Worker، تعداد خطاها، عمق درخت، حجم داده History و …
-
---
-
-## ۱۲. سوالات متداول (FAQ)
-(همان سوالات قبلی + می‌توان سوالات مربوط به سقف تعادل و تنظیمات را اضافه کرد.)
-
---
-
-## ۱۳. ضمیمه: مثال عددی کامل
-(مثال دو هفته‌ای A, B, C, D, E, F, G مثل نسخه قبلی.)
-
---
-
-## ۱۴. مسیرهای مرتبط
- Domain: `CMS/src/CMSMicroservice.Domain/Entities/`
- Application: `CMS/src/CMSMicroservice.Application/ClubMembershipCQ/`, `NetworkBalanceCQ/`, `CommissionPoolCQ/`, `CommissionPayoutCQ/`, `ConfigurationCQ/`
- Protobuf: `CMS/src/CMSMicroservice.Protobuf/Protos/`
- Worker: `CMS/src/CMSMicroservice.Infrastructure/BackgroundJobs/`
- مستند حاضر: `CMS/docs/network-club-commission-system.md`
-
-**نسخه**: 1.1  
-**تاریخ**: 2025-11-29  
-**نویسنده**: تیم توسعه CMS  
-**وضعیت**: آماده پیاده‌سازی (با History و Config)
@@ -1,329 +0,0 @@
-# توضیحات جدید بیزینس - 2025-12-08
-
-**تاریخ دریافت**: 2025-12-08  
-**وضعیت**: نیاز به تطبیق با کد و داکیومنت موجود  
-**منبع**: توضیحات شفاهی از صاحب پروژه
-
---
-
-## 1️⃣ فعال‌سازی کاربر و نمایش لینک معرفی
-
-### قوانین فعال‌سازی:
-کاربر زمانی می‌تواند **لینک معرفی** خود را ببیند که:
- ✅ وام خود را از **دایا** گرفته باشه
- ✅ یا **پرداخت مستقیم 56 میلیون تومان** انجام داده باشه
-
-### عضویت باشگاه مشتریان (الزامی):
-در هر دو حالت بالا:
-1. کاربر **اجباراً** باید عضو باشگاه مشتریان بشه
-2. دیالوگ باشگاه مشتریان و امضای قرارداد **الزامی** است
-3. **تا زمانی که این کار انجام نشه** → لینک معرفی نمایش داده نمی‌شود
-
-### فرآیند:
-```
-کاربر ثبت نام می‌کنه
-     ↓
-پرداخت 56M (دایا یا مستقیم)
-     ↓
-دیالوگ باشگاه مشتریان (الزامی) ← امضای قرارداد
-     ↓
-لینک معرفی نمایش داده می‌شود
-```
-
---
-
-## 2️⃣ محاسبه تعادل (Balance) شبکه
-
-### قانون اصلی:
-**هر نود شبکه = یک تعادل**
-
-```
-تعداد تعادل = MIN(دست راست، دست چپ)
-```
-
-### حالت عادی (زیر 300 تعادل):
- اگر دست راست = 200 نفر و دست چپ = 150 نفر
-  - ✅ تعادل = MIN(200, 150) = **150 امتیاز**
-  - ✅ باقیمانده راست = 200 - 150 = **50** → برای هفته بعد
-
-### حالت بالای 300 تعادل (سقف):
-اگر مجموع کاربران جفت دست یک نفر **بیشتر از 600 نفر** باشد:
-
-#### مثال:
-```
-دست راست = 600 نفر
-دست چپ = 400 نفر
-```
-
-**مرحله 1: محاسبه تعادل اولیه**
- تعادل = MIN(600, 400) = 400
-
-**مرحله 2: محاسبه باقیمانده اولیه**
- باقیمانده راست = 600 - 400 = 200 → **می‌رود برای هفته بعد**
-
-**مرحله 3: اعمال سقف 300**
- چون تعادل (400) > 300 → فقط **300 امتیاز** حساب می‌شود
- از دست راست: 100 نفر فلش می‌شود
- از دست چپ: 100 نفر فلش می‌شود
- **مجموع 200 نفر فلش می‌شود** (دیگه هیچ جا حساب نمی‌شن)
-
-**نتیجه نهایی:**
- امتیاز این هفته: **300**
- باقیمانده راست برای هفته بعد: **200** (این مجزا از فلش است)
- فلش شده (از بین رفته): **200** (100 چپ + 100 راست)
-
-### نکته مهم:
-> باقیمانده‌ای که از هفته قبل می‌آید **فلش نمی‌شود**، فقط اضافه‌ای که بزرگتر از 300 تعادل است فلش می‌شود.
-
---
-
-## 3️⃣ محاسبه تعادل بازگشتی (Recursive Balance)
-
-### قانون مهم:
-**هر نفر تعداد تعادل‌هاش فقط برای خودش حساب می‌شه**
-
-### مثال درخت:
-```
-        کاربر 1
-        /      \
-   کاربر 2    کاربر 3
-   /      \
-کاربر 4  کاربر 5
-```
-
-### محاسبات:
-1. **کاربر 2**:
-   - جذب کرده: کاربر 4 و کاربر 5
-   - تعادل کاربر 2 = MIN(1, 1) = **1 تعادل**
-
-2. **کاربر 1**:
-   - دست راست: کاربر 2 = 1 نفر
-   - دست چپ: کاربر 3 = 1 نفر
-   - تعادل کاربر 1 = MIN(1, 1) = **1 تعادل**
-
-### ⚠️ نکته کلیدی:
-**کاربر 1 پورسانت کاربر 4 و 5 را نمی‌گیرد!**
-
-چرا؟ چون:
- کاربر 3 کسی را جذب نکرده
- برای اینکه کاربر 1 از تعادل کاربر 4 و 5 بهره‌مند شود
- کاربر 3 حتماً باید **دو نفر** جذب کند
-
-### مثال تصحیح شده:
-```
-        کاربر 1
-        /      \
-   کاربر 2    کاربر 3
-   /      \    /      \
-کاربر 4  5  کاربر 6  7
-```
-
-حالا:
- کاربر 3: تعادل = MIN(1, 1) = 1
- کاربر 2: تعادل = MIN(1, 1) = 1
- **کاربر 1**: تعادل = MIN(2, 2) = **2 تعادل** ✅
-
---
-
-## 4️⃣ ارزش امتیاز و توزیع کمیسیون
-
-### فرمول:
-```
-ارزش هر امتیاز = (مجموع مبلغ صندوق) ÷ (تعداد کل تعادل‌ها)
-```
-
-### مبلغ صندوق:
-هر کاربری که 56 میلیون تومان واریز می‌کند:
- **25 میلیون تومان** وارد صندوق می‌شود
-
-### مثال محاسبه:
-```
-صندوق هفته = 175 میلیون تومان (7 نفر × 25M)
-مجموع تعادل‌های سیستم = 50 امتیاز
-
-ارزش هر امتیاز = 175,000,000 ÷ 50 = 3,500,000 ریال
-```
-
-اگر یک کاربر **5 تعادل** داشته باشد:
-```
-کمیسیون = 5 × 3,500,000 = 17,500,000 ریال
-```
-
---
-
-## 5️⃣ حذف خودکار کاربران غیرفعال (Worker جدید مورد نیاز)
-
-### قانون:
-کاربری که تا **2 هفته** بعد از ثبت نام:
- ❌ وام دایا را نگرفته
- ❌ 56 میلیون تومان مستقیم واریز نکرده
-
-→ **به صورت اتوماتیک حذف می‌شود**
-
-### Worker مورد نیاز:
-```csharp
-// نام پیشنهادی: DeleteInactiveUsersWorker
-// زمان اجرا: روزانه یک بار (مثلاً 3 صبح)
-
-شبه‌کد:
-1. کاربرانی که CreatedAt < (Now - 14 روز)
-2. IsActive == false (یعنی نه دایا گرفته، نه پرداخت مستقیم)
-3. ClubMembershipId == null
-4. حذف کاربر
-5. آزاد کردن جایگاه در شبکه برای معرف
-```
-
-### هدف:
- معرفی که این کاربر را جذب کرده بود، یکی از دست‌هایش آزاد می‌شود
- می‌تواند **کاربر جدید** جذب کند
- امکان **تعادل متعادل** دست چپ و راست فراهم می‌شود
-
---
-
-## 6️⃣ محدودیت تعداد زیرمجموعه
-
-### قانون سخت:
-**هر کاربر فقط 2 نفر می‌تواند جذب کند** (دست چپ + دست راست)
-
-### سناریو خطا:
-```
-کاربر A: دو نفر زیرمجموعه فعال دارد
-کاربر B: با کد معرف کاربر A ثبت نام می‌کند
-
-→ ❌ پیغام خطا:
-"این کاربر تعداد زیرمجموعه‌هاش پر شده و شما نمی‌تونید جزو زیرمجموعه این آدم بشید"
-```
-
-### نکته:
-**فعال** یعنی:
- وام دایا گرفته یا پرداخت مستقیم کرده
- عضو باشگاه مشتریان شده
-
---
-
-## 7️⃣ فرآیند کامل ثبت نام تا فعال‌سازی
-
-```
-1. ثبت نام با کد معرف
-   ↓
-2. بررسی ظرفیت معرف (حداکثر 2 نفر)
-   ↓ (اگر پر بود → خطا)
-   ↓
-3. درخواست وام دایا یا پرداخت مستقیم (56M)
-   ↓
-4. تأیید پرداخت 56M
-   ↓
-5. شارژ کیف پول‌ها:
-   - کیف پول اصلی: +56M
-   - کیف پول تخفیفی: +56M
-   ↓
-6. **دیالوگ الزامی باشگاه مشتریان**
-   - امضای قرارداد
-   - تخصیص 25M به صندوق
-   ↓
-7. کاربر فعال می‌شود
-   ↓
-8. لینک معرفی نمایش داده می‌شود
-   ↓
-9. ورود به فرآیند محاسبه کمیسیون هفتگی
-```
-
---
-
-## 8️⃣ خرید از فروشگاه‌ها
-
-### دو نوع فروشگاه:
-
-1. **فروشگاه اصلی**:
-   - از کیف پول اصلی کسر می‌شود
-
-2. **فروشگاه تخفیفی** (باشگاه مشتریان):
-   - از کیف پول تخفیفی کسر می‌شود
-   - به مقداری که تخفیف دارد
-
---
-
-## 9️⃣ جمع‌بندی تعادل و فلش
-
-### سناریو کامل:
-
-```
-هفته 1:
- چپ = 500، راست = 600
- تعادل = MIN(500, 600) = 500
-
-چون 500 > 300:
- امتیاز این هفته = 300
- فلش چپ = 500 - 300 = 200
- فلش راست = 600 - 300 = 300
- جمع فلش = 500 (از بین رفت)
-```
-
-### قوانین فلش:
-1. ❌ باقیمانده‌ای که از هفته قبل می‌آید فلش **نمی‌شود**
-2. ✅ فقط اضافه‌ای که بزرگتر از 300 است فلش می‌شود
-3. ✅ هر دو طرف (چپ و راست) فلش می‌شوند
-4. ❌ **نمی‌تواند** فقط یک طرف فلش شود
-
-### مثال فلش:
-```
-هفته قبل باقیمانده راست = 200
-هفته جدید راست = 400
-مجموع راست = 600
-
-سقف = 300
-فلش راست = 600 - 300 = 300 ✅ (نه 200)
-```
-
---
-
-## 🔟 نکات مهم اضافی
-
-### چرخش هفتگی:
- محاسبات هر هفته صورت می‌گیرد
- تعادل‌های استفاده شده **ریست** می‌شوند
- فقط **باقیمانده** به هفته بعد منتقل می‌شود
- فلش‌ها **هیچ جا حساب نمی‌شوند**
-
-### محدودیت‌های عمق شبکه:
- **تا همه کاربرها** در زیر شبکه حساب می‌شوند
- **بدون محدودیت عمق** (تا سطح آخر درخت)
-
-### اولویت محاسبه:
-1. محاسبه تعادل اولیه
-2. محاسبه باقیمانده
-3. اعمال سقف 300
-4. محاسبه فلش
-5. ذخیره باقیمانده برای هفته بعد
-
---
-
-## 📊 جدول مقایسه حالات مختلف
-
-| چپ | راست | تعادل اولیه | سقف 300 | امتیاز | باقی چپ | باقی راست | فلش کل |
-|-----|-------|-------------|---------|--------|---------|-----------|---------|
-| 200 | 250 | 200 | 200 | 200 | 0 | 50 | 0 |
-| 400 | 350 | 350 | 300 | 300 | 100 | 50 | 100 |
-| 500 | 600 | 500 | 300 | 300 | 200 | 300 | 400 |
-| 150 | 280 | 150 | 150 | 150 | 0 | 130 | 0 |
-| 350 | 350 | 350 | 300 | 300 | 50 | 50 | 100 |
-
-**توضیح ستون‌ها:**
- **تعادل اولیه**: MIN(چپ، راست)
- **سقف 300**: MIN(تعادل اولیه، 300)
- **امتیاز**: همان سقف 300 (امتیاز نهایی)
- **باقی چپ**: چپ - سقف چپ (300)
- **باقی راست**: راست - سقف راست (300)
- **فلش کل**: (چپ - 300) + (راست - 300) اگر > 0
-
---
-
-## ✅ وضعیت پیاده‌سازی فعلی
-
-این سند نیاز به **تطبیق کامل** با:
-1. ✅ کد موجود در `CalculateWeeklyBalancesCommandHandler`
-2. ✅ داکیومنت‌های موجود در `totalDoc/01-BUSINESS/`
-3. ✅ Entity ها در Domain Layer
-4. ✅ Worker های پس‌زمینه
-
-→ در مرحله بعد مقایسه و شناسایی تفاوت‌ها انجام می‌شود.
@@ -1,967 +0,0 @@
-# Package Purchase System - سیستم خرید پکیج طلایی
-
-**تاریخ ایجاد:** 2024-12-02  
-**وضعیت:** در حال طراحی  
-**اولویت:** 🔴 بسیار بالا
-
---
-
-## 📋 فهرست
-
-1. [مقدمه](#مقدمه)
-2. [سه سناریوی اصلی](#سه-سناریوی-اصلی)
-3. [Entity Changes](#entity-changes)
-4. [Business Rules](#business-rules)
-5. [Flow Diagrams](#flow-diagrams)
-6. [Commands & Handlers](#commands--handlers)
-7. [تسک‌های پیاده‌سازی](#تسک-های-پیاده-سازی)
-
---
-
-## 🎯 مقدمه
-
-سیستم خرید پکیج طلایی سه سناریوی مختلف دارد که باید به درستی از هم تفکیک شوند:
-
-### هدف کلی:
- **سناریو 1 و 2**: خرید پکیج طلایی (56 میلیون تومان) → امکان فعالسازی باشگاه مشتریان
- **سناریو 3**: شارژ عادی کیف پول تخفیفی → فقط برای خرید از فروشگاه تخفیفی
-
-### نکات کلیدی:
-1. کاربر فقط **یک بار** می‌تواند پکیج طلایی خریداری کند (سناریو 1 یا 2)
-2. بعد از خرید پکیج، کاربر **باید خودش** دکمه فعالسازی باشگاه را بزند
-3. فعالسازی باشگاه **نیاز به تایید Admin ندارد**
-4. عضویت در شبکه (NetworkMembership) **جدا** از عضویت در باشگاه (ClubMembership) است
-5. کمیسیون‌ها **فقط بعد** از فعالسازی باشگاه محاسبه می‌شوند
-
---
-
-## 🔄 سه سناریوی اصلی
-
-### 📌 سناریو 1: دریافت وام دایا (DayaLoan)
-
-```
-کاربر → درخواست وام از دایا → دایا وام را تایید می‌کند
-  ↓
-شارژ Balance در UserWallet (56,000,000 تومان)
-  ↓
-ثبت UserWalletChangeLog (Amount: +56M, Type: DepositExternal1)
-  ↓
-ثبت Transaction (Type: DepositExternal1, RefId: شماره قرارداد دایا)
-  ↓
-ثبت UserOrder (PackageId: پکیج طلایی, TransactionId: xxx, Amount: 56M)
-  ↓
-کاربر می‌تواند با این 56M از فروشگاه عادی خرید کند
-  ↓
-[کاربر باید خودش دکمه "فعالسازی باشگاه مشتریان" را بزند]
-  ↓
-ثبت/به‌روزرسانی ClubMembership (IsActive: true, PurchaseMethod: DayaLoan)
-  ↓
-شروع محاسبه کمیسیون‌ها
-```
-
-**نکات:**
- `Transaction.Type` = `DepositExternal1` (وام دایا)
- `Transaction.RefId` = شماره قرارداد دایا
- `UserOrder.PackageId` پر می‌شود
- `User.PackagePurchaseMethod` = `DayaLoan`
-
---
-
-### 📌 سناریو 2: خرید پکیج طلایی از درگاه (Direct Purchase)
-
-```
-کاربر → انتخاب پکیج طلایی (56M) → کلیک "پرداخت"
-  ↓
-ثبت UserOrder (PackageId: پکیج طلایی, Amount: 56M, PaymentStatus: Pending)
-  ↓
-Redirect به درگاه بانکی (IPG)
-  ↓
-کاربر پرداخت می‌کند و بر می‌گردد
-  ↓
-Verify پرداخت با بانک
-  ↓
-شارژ Balance در UserWallet (56,000,000 تومان)
-  ↓
-ثبت UserWalletChangeLog (Amount: +56M, Type: DepositIpg)
-  ↓
-ثبت Transaction (Type: DepositIpg, RefId: کد پیگیری بانک)
-  ↓
-به‌روزرسانی UserOrder (TransactionId: xxx, PaymentStatus: Success)
-  ↓
-کاربر می‌تواند با این 56M از فروشگاه عادی خرید کند
-  ↓
-[کاربر باید خودش دکمه "فعالسازی باشگاه مشتریان" را بزند]
-  ↓
-ثبت/به‌روزرسانی ClubMembership (IsActive: true, PurchaseMethod: DirectPurchase)
-  ↓
-شروع محاسبه کمیسیون‌ها
-```
-
-**نکات:**
- `Transaction.Type` = `DepositIpg` (پرداخت از درگاه)
- `Transaction.RefId` = کد پیگیری بانک
- `UserOrder.PackageId` پر می‌شود
- `User.PackagePurchaseMethod` = `DirectPurchase`
-
---
-
-### 📌 سناریو 3: شارژ عادی کیف پول تخفیفی (Regular Wallet Charge)
-
-```
-کاربر → انتخاب مبلغ دلخواه → کلیک "شارژ کیف پول"
-  ↓
-Redirect به درگاه بانکی (IPG)
-  ↓
-کاربر پرداخت می‌کند و بر می‌گردد
-  ↓
-Verify پرداخت با بانک
-  ↓
-شارژ DiscountBalance در UserWallet (مبلغ دلخواه)
-  ↓
-ثبت UserWalletChangeLog (Amount: +xxx, Type: DiscountWalletCharge)
-  ↓
-ثبت Transaction (Type: DiscountWalletCharge, RefId: کد پیگیری بانک)
-  ↓
-کاربر می‌تواند فقط از فروشگاه تخفیفی خرید کند
-  ↓
-[هیچ ارتباطی با باشگاه مشتریان ندارد]
-```
-
-**نکات:**
- `Transaction.Type` = `DiscountWalletCharge`
- `Transaction.RefId` = کد پیگیری بانک
- **PackageId در هیچ جا ثبت نمی‌شود**
- فقط `DiscountBalance` شارژ می‌شود، نه `Balance`
- هیچ `UserOrder` با `PackageId` ثبت نمی‌شود
-
---
-
-## 🗄️ Entity Changes
-
-### 1️⃣ **Enum جدید: `PackagePurchaseMethod`**
-
-```csharp
-namespace CMSMicroservice.Domain.Enums;
-
-/// <summary>
-/// نحوه خرید پکیج طلایی توسط کاربر
-/// </summary>
-public enum PackagePurchaseMethod
-{
-    /// <summary>
-    /// هنوز پکیج خریداری نکرده
-    /// </summary>
-    None = 0,
-    
-    /// <summary>
-    /// از طریق وام دایا
-    /// </summary>
-    DayaLoan = 1,
-    
-    /// <summary>
-    /// از طریق پرداخت مستقیم درگاه بانکی
-    /// </summary>
-    DirectPurchase = 2
-}
-```
-
-**محل:** `CMS/src/CMSMicroservice.Domain/Enums/PackagePurchaseMethod.cs`
-
---
-
-### 2️⃣ **تغییرات `User` Entity**
-
-```csharp
-// اضافه کردن این فیلد به User.cs:
-
-/// <summary>
-/// نحوه خرید پکیج طلایی (برای جلوگیری از خرید مجدد)
-/// </summary>
-public PackagePurchaseMethod PackagePurchaseMethod { get; set; } = PackagePurchaseMethod.None;
-```
-
-**منطق:**
- وقتی کاربر سناریو 1 یا 2 را انجام می‌دهد، این فیلد تغییر می‌کند
- اگر `PackagePurchaseMethod != None` باشد، کاربر نمی‌تواند دوباره پکیج خریداری کند
-
---
-
-### 3️⃣ **تغییرات `ClubMembership` Entity**
-
-```csharp
-// اضافه کردن این فیلد به ClubMembership.cs:
-
-/// <summary>
-/// نحوه خرید پکیج که منجر به فعالسازی باشگاه شد
-/// </summary>
-public PackagePurchaseMethod PurchaseMethod { get; set; }
-```
-
-**منطق:**
- وقتی کاربر دکمه "فعالسازی باشگاه" را می‌زند، این فیلد از `User.PackagePurchaseMethod` کپی می‌شود
- برای گزارش‌گیری و تحلیل: چند نفر از طریق وام دایا و چند نفر از طریق خرید مستقیم عضو شدند
-
---
-
-### 4️⃣ **تغییرات `TransactionType` Enum**
-
-```csharp
-// فعلاً موجود است:
-public enum TransactionType
-{
-    Buy = 0,
-    DepositIpg = 1,            // پرداخت از درگاه (سناریو 2)
-    DepositExternal1 = 2,      // وام دایا (سناریو 1)
-    Withdraw = 3,
-    NetworkCommission = 10,
-    ClubActivation = 11,
-    DiscountWalletCharge = 12  // شارژ کیف پول تخفیفی (سناریو 3) ✅
-}
-```
-
-**نکته:** `DiscountWalletCharge` از قبل وجود دارد، پس نیازی به تغییر نیست.
-
---
-
-## 📐 Business Rules
-
-### قانون 1: یک کاربر فقط یک بار می‌تواند پکیج طلایی خریداری کند
-
-```csharp
-// Check قبل از خرید پکیج:
-if (user.PackagePurchaseMethod != PackagePurchaseMethod.None)
-{
-    throw new ValidationException("شما قبلاً پکیج طلایی را خریداری کرده‌اید.");
-}
-```
-
---
-
-### قانون 2: فعالسازی باشگاه فقط با موجودی اصلی (Balance) امکان‌پذیر است
-
-```csharp
-// Check موقع فعالسازی باشگاه:
-var userWallet = await _context.UserWallets
-    .FirstOrDefaultAsync(w => w.UserId == userId);
-
-if (userWallet.Balance < 56_000_000)
-{
-    throw new ValidationException("برای فعالسازی باشگاه مشتریان باید حداقل 56 میلیون تومان موجودی اصلی داشته باشید.");
-}
-```
-
---
-
-### قانون 3: فعالسازی باشگاه فقط برای کسانی که پکیج خریده‌اند
-
-```csharp
-// Check موقع فعالسازی باشگاه:
-if (user.PackagePurchaseMethod == PackagePurchaseMethod.None)
-{
-    throw new ValidationException("برای فعالسازی باشگاه مشتریان ابتدا باید پکیج طلایی خریداری کنید.");
-}
-
-// پیدا کردن UserOrder مربوط به پکیج:
-var packageOrder = await _context.UserOrders
-    .FirstOrDefaultAsync(o => 
-        o.UserId == userId && 
-        o.PackageId != null &&
-        o.PaymentStatus == PaymentStatus.Success
-    );
-
-if (packageOrder == null)
-{
-    throw new ValidationException("سفارش پکیج طلایی یافت نشد.");
-}
-
-// پیدا کردن Transaction مربوطه:
-var transaction = await _context.Transactions
-    .FirstOrDefaultAsync(t => t.Id == packageOrder.TransactionId);
-
-if (transaction == null || 
-    (transaction.Type != TransactionType.DepositIpg && 
-     transaction.Type != TransactionType.DepositExternal1))
-{
-    throw new ValidationException("تراکنش معتبر برای فعالسازی باشگاه یافت نشد.");
-}
-```
-
---
-
-### قانون 4: NetworkMembership جدا از ClubMembership است
-
- **NetworkMembership**: موقع ثبت‌نام کاربر خودکار ایجاد می‌شود (با `ParentId`)
- **ClubMembership**: فقط وقتی کاربر دکمه "فعالسازی باشگاه" را بزند ایجاد می‌شود
- کاربر می‌تواند زیرمجموعه بگیرد بدون اینکه جزو باشگاه باشد (ولی سیاست‌گذاری می‌کنیم که قبل از گرفتن زیرمجموعه باید باشگاه را فعال کرده باشد)
-
---
-
-### قانون 5: محاسبه کمیسیون فقط بعد از فعالسازی باشگاه
-
-```csharp
-// در محاسبه کمیسیون:
-var clubMembership = await _context.ClubMemberships
-    .FirstOrDefaultAsync(c => c.UserId == userId && c.IsActive);
-
-if (clubMembership == null)
-{
-    // این کاربر کمیسیون نمی‌گیرد چون جزو باشگاه نیست
-    return;
-}
-
-// ادامه محاسبه کمیسیون...
-```
-
---
-
-## 📊 Flow Diagrams
-
-### 🔹 Flow 1: خرید پکیج از درگاه (سناریو 2)
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                  FrontOffice UI (کاربر)                     │
-└──────────────────────┬──────────────────────────────────────┘
-                       │
-                       ▼
-         ┌─────────────────────────┐
-         │ انتخاب پکیج طلایی (56M) │
-         └────────────┬─────────────┘
-                      │
-                      ▼
-   ┌──────────────────────────────────────┐
-   │ PurchaseGoldenPackageCommand          │
-   │ - بررسی User.PackagePurchaseMethod   │
-   │ - ثبت UserOrder (Pending)            │
-   │ - Redirect به درگاه                  │
-   └────────────┬─────────────────────────┘
-                │
-                ▼
-   ┌──────────────────────────────────────┐
-   │         درگاه بانکی (IPG)            │
-   │     کاربر پرداخت می‌کند              │
-   └────────────┬─────────────────────────┘
-                │
-                ▼
-   ┌──────────────────────────────────────┐
-   │ VerifyGoldenPackagePurchaseCommand    │
-   │ - Verify با بانک                     │
-   │ - شارژ UserWallet.Balance (56M)      │
-   │ - ثبت Transaction (DepositIpg)       │
-   │ - ثبت UserWalletChangeLog            │
-   │ - Set User.PackagePurchaseMethod     │
-   │   = DirectPurchase                    │
-   │ - به‌روزرسانی UserOrder (Success)     │
-   └────────────┬─────────────────────────┘
-                │
-                ▼
-   ┌──────────────────────────────────────┐
-   │  کاربر می‌تواند از فروشگاه عادی    │
-   │       خرید کند (با Balance)          │
-   └──────────────────────────────────────┘
-```
-
---
-
-### 🔹 Flow 2: فعالسازی باشگاه مشتریان
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│            FrontOffice UI (کاربر وارد شده)                  │
-│         کاربر دکمه "فعالسازی باشگاه" را می‌زند             │
-└──────────────────────┬──────────────────────────────────────┘
-                       │
-                       ▼
-   ┌──────────────────────────────────────┐
-   │ ActivateClubMembershipCommand         │
-   │                                       │
-   │ 1. بررسی User.PackagePurchaseMethod  │
-   │    → باید != None باشد               │
-   │                                       │
-   │ 2. بررسی UserWallet.Balance          │
-   │    → باید >= 56M باشد                │
-   │                                       │
-   │ 3. پیدا کردن UserOrder با PackageId  │
-   │    → PaymentStatus = Success         │
-   │                                       │
-   │ 4. پیدا کردن Transaction             │
-   │    → Type = DepositIpg یا            │
-   │             DepositExternal1         │
-   │                                       │
-   │ 5. ثبت/به‌روزرسانی ClubMembership     │
-   │    - IsActive = true                 │
-   │    - ActivatedAt = DateTime.Now      │
-   │    - PurchaseMethod = کپی از User    │
-   │                                       │
-   └────────────┬─────────────────────────┘
-                │
-                ▼
-   ┌──────────────────────────────────────┐
-   │   کاربر جزو باشگاه مشتریان شد       │
-   │   کمیسیون‌ها شروع به محاسبه می‌کنند │
-   └──────────────────────────────────────┘
-```
-
---
-
-### 🔹 Flow 3: شارژ کیف پول تخفیفی (سناریو 3)
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                  FrontOffice UI (کاربر)                     │
-└──────────────────────┬──────────────────────────────────────┘
-                       │
-                       ▼
-         ┌─────────────────────────┐
-         │ انتخاب مبلغ دلخواه      │
-         │ (برای فروشگاه تخفیفی)   │
-         └────────────┬─────────────┘
-                      │
-                      ▼
-   ┌──────────────────────────────────────┐
-   │ ChargeDiscountWalletCommand           │
-   │ - Redirect به درگاه                  │
-   └────────────┬─────────────────────────┘
-                │
-                ▼
-   ┌──────────────────────────────────────┐
-   │         درگاه بانکی (IPG)            │
-   │     کاربر پرداخت می‌کند              │
-   └────────────┬─────────────────────────┘
-                │
-                ▼
-   ┌──────────────────────────────────────┐
-   │ VerifyDiscountWalletChargeCommand     │
-   │ - Verify با بانک                     │
-   │ - شارژ UserWallet.DiscountBalance    │
-   │ - ثبت Transaction                    │
-   │   (Type: DiscountWalletCharge)        │
-   │ - ثبت UserWalletChangeLog            │
-   └────────────┬─────────────────────────┘
-                │
-                ▼
-   ┌──────────────────────────────────────┐
-   │  کاربر می‌تواند از فروشگاه تخفیفی  │
-   │    خرید کند (با DiscountBalance)     │
-   └──────────────────────────────────────┘
-```
-
-**نکته:** در این سناریو هیچ `UserOrder` با `PackageId` ثبت نمی‌شود.
-
---
-
-## 💻 Commands & Handlers
-
-### 1️⃣ `PurchaseGoldenPackageCommand`
-
-**مسئولیت:** ایجاد سفارش پکیج طلایی و Redirect به درگاه
-
-```csharp
-public class PurchaseGoldenPackageCommand : IRequest<PaymentInitiateResult>
-{
-    public long UserId { get; set; }
-}
-
-public class PurchaseGoldenPackageCommandHandler 
-    : IRequestHandler<PurchaseGoldenPackageCommand, PaymentInitiateResult>
-{
-    private readonly IApplicationDbContext _context;
-    private readonly IPaymentGatewayService _paymentGateway;
-
-    public async Task<PaymentInitiateResult> Handle(
-        PurchaseGoldenPackageCommand request, 
-        CancellationToken cancellationToken)
-    {
-        // 1. بررسی User
-        var user = await _context.Users
-            .FirstOrDefaultAsync(u => u.Id == request.UserId, cancellationToken);
-        
-        if (user == null)
-            throw new NotFoundException(nameof(User), request.UserId);
-        
-        // 2. بررسی اینکه قبلاً پکیج نخریده باشد
-        if (user.PackagePurchaseMethod != PackagePurchaseMethod.None)
-        {
-            throw new ValidationException("شما قبلاً پکیج طلایی را خریداری کرده‌اید.");
-        }
-        
-        // 3. پیدا کردن پکیج طلایی
-        var goldenPackage = await _context.Packages
-            .FirstOrDefaultAsync(p => p.Title.Contains("طلایی"), cancellationToken);
-        
-        if (goldenPackage == null)
-            throw new NotFoundException("پکیج طلایی یافت نشد.");
-        
-        // 4. ایجاد UserOrder
-        var order = new UserOrder
-        {
-            UserId = user.Id,
-            PackageId = goldenPackage.Id,
-            Amount = goldenPackage.Price, // 56,000,000
-            PaymentStatus = PaymentStatus.Pending,
-            DeliveryStatus = DeliveryStatus.None,
-            UserAddressId = 0 // پکیج نیاز به آدرس ندارد
-        };
-        
-        _context.UserOrders.Add(order);
-        await _context.SaveChangesAsync(cancellationToken);
-        
-        // 5. Redirect به درگاه
-        var paymentRequest = new PaymentRequest
-        {
-            Amount = order.Amount,
-            OrderId = order.Id.ToString(),
-            CallbackUrl = "https://yourdomain.com/verify-golden-package",
-            Description = $"خرید پکیج طلایی"
-        };
-        
-        var result = await _paymentGateway.InitiatePaymentAsync(paymentRequest);
-        
-        return result;
-    }
-}
-```
-
---
-
-### 2️⃣ `VerifyGoldenPackagePurchaseCommand`
-
-**مسئولیت:** Verify پرداخت و شارژ کیف پول
-
-```csharp
-public class VerifyGoldenPackagePurchaseCommand : IRequest<bool>
-{
-    public long OrderId { get; set; }
-    public string Authority { get; set; } // از درگاه
-}
-
-public class VerifyGoldenPackagePurchaseCommandHandler 
-    : IRequestHandler<VerifyGoldenPackagePurchaseCommand, bool>
-{
-    private readonly IApplicationDbContext _context;
-    private readonly IPaymentGatewayService _paymentGateway;
-
-    public async Task<bool> Handle(
-        VerifyGoldenPackagePurchaseCommand request, 
-        CancellationToken cancellationToken)
-    {
-        // 1. پیدا کردن Order
-        var order = await _context.UserOrders
-            .Include(o => o.Package)
-            .Include(o => o.User)
-            .FirstOrDefaultAsync(o => o.Id == request.OrderId, cancellationToken);
-        
-        if (order == null)
-            throw new NotFoundException(nameof(UserOrder), request.OrderId);
-        
-        // 2. Verify با بانک
-        var verifyResult = await _paymentGateway.VerifyPaymentAsync(
-            request.Authority, 
-            order.Amount
-        );
-        
-        if (!verifyResult.IsSuccess)
-        {
-            order.PaymentStatus = PaymentStatus.Failed;
-            await _context.SaveChangesAsync(cancellationToken);
-            return false;
-        }
-        
-        // 3. شارژ کیف پول
-        var wallet = await _context.UserWallets
-            .FirstOrDefaultAsync(w => w.UserId == order.UserId, cancellationToken);
-        
-        wallet.Balance += order.Amount; // 56,000,000
-        
-        // 4. ثبت Transaction
-        var transaction = new Transactions
-        {
-            Amount = order.Amount,
-            Description = "خرید پکیج طلایی از درگاه",
-            PaymentStatus = PaymentStatus.Success,
-            PaymentDate = DateTime.Now,
-            RefId = verifyResult.RefId,
-            Type = TransactionType.DepositIpg
-        };
-        
-        _context.Transactions.Add(transaction);
-        await _context.SaveChangesAsync(cancellationToken);
-        
-        // 5. ثبت ChangeLog
-        var changeLog = new UserWalletChangeLog
-        {
-            UserId = order.UserId,
-            Amount = order.Amount,
-            ChangeType = WalletChangeType.Deposit,
-            Description = "شارژ موجودی از پکیج طلایی",
-            BalanceBefore = wallet.Balance - order.Amount,
-            BalanceAfter = wallet.Balance
-        };
-        
-        _context.UserWalletChangeLogs.Add(changeLog);
-        
-        // 6. به‌روزرسانی Order
-        order.TransactionId = transaction.Id;
-        order.PaymentStatus = PaymentStatus.Success;
-        order.PaymentDate = DateTime.Now;
-        order.PaymentMethod = PaymentMethod.Online;
-        
-        // 7. تغییر User.PackagePurchaseMethod
-        order.User.PackagePurchaseMethod = PackagePurchaseMethod.DirectPurchase;
-        
-        await _context.SaveChangesAsync(cancellationToken);
-        
-        return true;
-    }
-}
-```
-
---
-
-### 3️⃣ `ActivateClubMembershipCommand`
-
-**مسئولیت:** فعالسازی عضویت در باشگاه مشتریان
-
-```csharp
-public class ActivateClubMembershipCommand : IRequest<bool>
-{
-    public long UserId { get; set; }
-}
-
-public class ActivateClubMembershipCommandHandler 
-    : IRequestHandler<ActivateClubMembershipCommand, bool>
-{
-    private readonly IApplicationDbContext _context;
-
-    public async Task<bool> Handle(
-        ActivateClubMembershipCommand request, 
-        CancellationToken cancellationToken)
-    {
-        // 1. بررسی User
-        var user = await _context.Users
-            .FirstOrDefaultAsync(u => u.Id == request.UserId, cancellationToken);
-        
-        if (user == null)
-            throw new NotFoundException(nameof(User), request.UserId);
-        
-        // 2. بررسی اینکه پکیج خریده باشد
-        if (user.PackagePurchaseMethod == PackagePurchaseMethod.None)
-        {
-            throw new ValidationException(
-                "برای فعالسازی باشگاه مشتریان ابتدا باید پکیج طلایی خریداری کنید."
-            );
-        }
-        
-        // 3. بررسی موجودی
-        var wallet = await _context.UserWallets
-            .FirstOrDefaultAsync(w => w.UserId == user.Id, cancellationToken);
-        
-        if (wallet.Balance < 56_000_000)
-        {
-            throw new ValidationException(
-                "برای فعالسازی باشگاه مشتریان باید حداقل 56 میلیون تومان موجودی اصلی داشته باشید."
-            );
-        }
-        
-        // 4. بررسی UserOrder
-        var packageOrder = await _context.UserOrders
-            .FirstOrDefaultAsync(o => 
-                o.UserId == user.Id && 
-                o.PackageId != null &&
-                o.PaymentStatus == PaymentStatus.Success,
-                cancellationToken
-            );
-        
-        if (packageOrder == null)
-        {
-            throw new ValidationException("سفارش پکیج طلایی یافت نشد.");
-        }
-        
-        // 5. بررسی Transaction
-        var transaction = await _context.Transactions
-            .FirstOrDefaultAsync(t => t.Id == packageOrder.TransactionId, cancellationToken);
-        
-        if (transaction == null || 
-            (transaction.Type != TransactionType.DepositIpg && 
-             transaction.Type != TransactionType.DepositExternal1))
-        {
-            throw new ValidationException("تراکنش معتبر برای فعالسازی باشگاه یافت نشد.");
-        }
-        
-        // 6. بررسی اینکه قبلاً فعال نکرده باشد
-        var existingMembership = await _context.ClubMemberships
-            .FirstOrDefaultAsync(c => c.UserId == user.Id, cancellationToken);
-        
-        if (existingMembership != null && existingMembership.IsActive)
-        {
-            throw new ValidationException("شما قبلاً عضو باشگاه مشتریان هستید.");
-        }
-        
-        // 7. ثبت یا به‌روزرسانی ClubMembership
-        if (existingMembership == null)
-        {
-            existingMembership = new ClubMembership
-            {
-                UserId = user.Id,
-                IsActive = true,
-                ActivatedAt = DateTime.Now,
-                InitialContribution = 56_000_000,
-                TotalEarned = 0,
-                PurchaseMethod = user.PackagePurchaseMethod
-            };
-            
-            _context.ClubMemberships.Add(existingMembership);
-        }
-        else
-        {
-            existingMembership.IsActive = true;
-            existingMembership.ActivatedAt = DateTime.Now;
-            existingMembership.PurchaseMethod = user.PackagePurchaseMethod;
-        }
-        
-        await _context.SaveChangesAsync(cancellationToken);
-        
-        return true;
-    }
-}
-```
-
---
-
-### 4️⃣ `ChargeDiscountWalletCommand` (سناریو 3)
-
-**مسئولیت:** شارژ کیف پول تخفیفی
-
-```csharp
-public class ChargeDiscountWalletCommand : IRequest<PaymentInitiateResult>
-{
-    public long UserId { get; set; }
-    public long Amount { get; set; }
-}
-
-public class ChargeDiscountWalletCommandHandler 
-    : IRequestHandler<ChargeDiscountWalletCommand, PaymentInitiateResult>
-{
-    private readonly IApplicationDbContext _context;
-    private readonly IPaymentGatewayService _paymentGateway;
-
-    public async Task<PaymentInitiateResult> Handle(
-        ChargeDiscountWalletCommand request, 
-        CancellationToken cancellationToken)
-    {
-        // 1. بررسی User
-        var user = await _context.Users
-            .FirstOrDefaultAsync(u => u.Id == request.UserId, cancellationToken);
-        
-        if (user == null)
-            throw new NotFoundException(nameof(User), request.UserId);
-        
-        // 2. بررسی مبلغ (حداقل 10,000 تومان)
-        if (request.Amount < 10_000)
-        {
-            throw new ValidationException("حداقل مبلغ شارژ 10,000 تومان است.");
-        }
-        
-        // 3. Redirect به درگاه
-        var paymentRequest = new PaymentRequest
-        {
-            Amount = request.Amount,
-            OrderId = $"DISCOUNT_{user.Id}_{DateTime.Now:yyyyMMddHHmmss}",
-            CallbackUrl = "https://yourdomain.com/verify-discount-wallet",
-            Description = $"شارژ کیف پول تخفیفی"
-        };
-        
-        var result = await _paymentGateway.InitiatePaymentAsync(paymentRequest);
-        
-        return result;
-    }
-}
-```
-
---
-
-### 5️⃣ `VerifyDiscountWalletChargeCommand` (سناریو 3)
-
-**مسئولیت:** Verify و شارژ DiscountBalance
-
-```csharp
-public class VerifyDiscountWalletChargeCommand : IRequest<bool>
-{
-    public long UserId { get; set; }
-    public long Amount { get; set; }
-    public string Authority { get; set; }
-}
-
-public class VerifyDiscountWalletChargeCommandHandler 
-    : IRequestHandler<VerifyDiscountWalletChargeCommand, bool>
-{
-    private readonly IApplicationDbContext _context;
-    private readonly IPaymentGatewayService _paymentGateway;
-
-    public async Task<bool> Handle(
-        VerifyDiscountWalletChargeCommand request, 
-        CancellationToken cancellationToken)
-    {
-        // 1. پیدا کردن User
-        var user = await _context.Users
-            .FirstOrDefaultAsync(u => u.Id == request.UserId, cancellationToken);
-        
-        if (user == null)
-            throw new NotFoundException(nameof(User), request.UserId);
-        
-        // 2. Verify با بانک
-        var verifyResult = await _paymentGateway.VerifyPaymentAsync(
-            request.Authority, 
-            request.Amount
-        );
-        
-        if (!verifyResult.IsSuccess)
-        {
-            return false;
-        }
-        
-        // 3. شارژ DiscountBalance
-        var wallet = await _context.UserWallets
-            .FirstOrDefaultAsync(w => w.UserId == user.Id, cancellationToken);
-        
-        wallet.DiscountBalance += request.Amount;
-        
-        // 4. ثبت Transaction
-        var transaction = new Transactions
-        {
-            Amount = request.Amount,
-            Description = "شارژ کیف پول تخفیفی",
-            PaymentStatus = PaymentStatus.Success,
-            PaymentDate = DateTime.Now,
-            RefId = verifyResult.RefId,
-            Type = TransactionType.DiscountWalletCharge
-        };
-        
-        _context.Transactions.Add(transaction);
-        await _context.SaveChangesAsync(cancellationToken);
-        
-        // 5. ثبت ChangeLog
-        var changeLog = new UserWalletChangeLog
-        {
-            UserId = user.Id,
-            Amount = request.Amount,
-            ChangeType = WalletChangeType.Deposit,
-            Description = "شارژ موجودی تخفیفی",
-            BalanceBefore = wallet.DiscountBalance - request.Amount,
-            BalanceAfter = wallet.DiscountBalance
-        };
-        
-        _context.UserWalletChangeLogs.Add(changeLog);
-        
-        await _context.SaveChangesAsync(cancellationToken);
-        
-        return true;
-    }
-}
-```
-
---
-
-## 📝 تسک‌های پیاده‌سازی
-
-### Phase 1: Entity Changes (1 روز)
-
-1. **ایجاد `PackagePurchaseMethod` Enum**
-   - محل: `CMSMicroservice.Domain/Enums/PackagePurchaseMethod.cs`
-   - مقادیر: None, DayaLoan, DirectPurchase
-
-2. **اضافه کردن فیلد به `User`**
-   - فیلد: `PackagePurchaseMethod PackagePurchaseMethod`
-   - مقدار پیش‌فرض: `PackagePurchaseMethod.None`
-
-3. **اضافه کردن فیلد به `ClubMembership`**
-   - فیلد: `PackagePurchaseMethod PurchaseMethod`
-
-4. **ایجاد Migration**
-   ```bash
-   dotnet ef migrations add AddPackagePurchaseMethod
-   ```
-
---
-
-### Phase 2: Commands (2 روز)
-
-1. **`PurchaseGoldenPackageCommand`**
-   - بررسی `User.PackagePurchaseMethod`
-   - ثبت `UserOrder` با `PackageId`
-   - Redirect به درگاه
-
-2. **`VerifyGoldenPackagePurchaseCommand`**
-   - Verify پرداخت
-   - شارژ `Balance`
-   - ثبت `Transaction` (DepositIpg)
-   - Set `User.PackagePurchaseMethod = DirectPurchase`
-
-3. **`ActivateClubMembershipCommand`**
-   - چک‌های امنیتی (UserOrder + Transaction)
-   - ثبت/به‌روزرسانی `ClubMembership`
-
-4. **`ChargeDiscountWalletCommand` + `VerifyDiscountWalletChargeCommand`**
-   - شارژ `DiscountBalance`
-   - ثبت `Transaction` (DiscountWalletCharge)
-
---
-
-### Phase 3: به‌روزرسانی DayaLoan Flow (0.5 روز)
-
- تغییر `ProcessDayaLoanCommandHandler`:
-  ```csharp
-  user.PackagePurchaseMethod = PackagePurchaseMethod.DayaLoan;
-  ```
-
---
-
-### Phase 4: Unit Tests (1 روز)
-
-1. تست `PurchaseGoldenPackageCommand`:
-   - کاربری که قبلاً پکیج خریده → باید خطا بدهد
-   - کاربر جدید → باید Order ایجاد شود
-
-2. تست `ActivateClubMembershipCommand`:
-   - کاربر بدون پکیج → خطا
-   - کاربر با موجودی کمتر از 56M → خطا
-   - کاربر معتبر → موفق
-
-3. تست `VerifyDiscountWalletChargeCommand`:
-   - پرداخت موفق → `DiscountBalance` افزایش یابد
-   - پرداخت ناموفق → هیچ تغییری نکند
-
---
-
-### Phase 5: Documentation (0.5 روز)
-
- به‌روزرسانی `implementation-progress.md`
- لینک از `REMAINING-TASKS-CONSOLIDATED.md`
-
---
-
-## 📊 خلاصه Timeline
-
-| Phase | عنوان | زمان |
-|-------|-------|------|
-| 1 | Entity Changes | 1 روز |
-| 2 | Commands & Handlers | 2 روز |
-| 3 | DayaLoan Flow Update | 0.5 روز |
-| 4 | Unit Tests | 1 روز |
-| 5 | Documentation | 0.5 روز |
-| **جمع** | | **5 روز** |
-
---
-
-## 🔗 مراجع
-
- [DayaLoan Integration](./daya-loan-integration.md)
- [Manual Payment System](./manual-payment-system.md)
- [Implementation Progress](./implementation-progress.md)
- [REMAINING-TASKS](../REMAINING-TASKS-CONSOLIDATED.md)
-
---
-
-**تاریخ آخرین به‌روزرسانی:** 2024-12-02  
-**نویسنده:** GitHub Copilot  
-**وضعیت:** ✅ تایید شده توسط کاربر
@@ -1,59 +0,0 @@
-# 🏗️ Architecture Documentation
-
-> **وضعیت**: 🚧 در حال توسعه  
-> **اولویت**: Medium
-
---
-
-## 📋 محتویات آینده
-
-این پوشه برای مستندات معماری سیستم در نظر گرفته شده است:
-
-### 1. System Overview
- [ ] نمودار کلی معماری
- [ ] تعامل بین سرویس‌ها
- [ ] Data Flow Diagram
-
-### 2. Microservices Architecture
- [ ] CMS Microservice Architecture
- [ ] BFF Pattern (Backend for Frontend)
- [ ] Communication Protocols (gRPC, HTTP)
-
-### 3. Database Design
- [ ] Entity Relationship Diagram (ERD)
- [ ] Database Schema
- [ ] Migration Strategy
-
-### 4. Security Architecture
- [ ] Authentication & Authorization
- [ ] API Security (JWT, API Keys)
- [ ] Data Encryption
-
-### 5. Scalability & Performance
- [ ] Load Balancing Strategy
- [ ] Caching Strategy
- [ ] Performance Optimization
-
---
-
-## 🔗 مراجع موجود
-
-تا زمان تکمیل این پوشه، به اسناد زیر مراجعه کنید:
-
- **Clean Architecture**: توضیحات در `03-BACKEND/CMS/README.md`
- **Domain Entities**: `03-BACKEND/CMS/entity-guide.md`
- **gRPC Integration**: `03-BACKEND/BackOffice.BFF/cms-integration.md`
-
---
-
-## 📝 مشارکت
-
-اگر می‌خواهید به این بخش کمک کنید:
-1. Diagram ها را با draw.io یا Mermaid بسازید
-2. فایل‌ها را در این پوشه قرار دهید
-3. INDEX اصلی را بروز کنید
-
---
-
-**تاریخ ایجاد**: ۱۴ آذر ۱۴۰۴  
-**مسئول**: Architecture Team
@@ -1,86 +0,0 @@
-# BackOffice.BFF
-
-> Backend For Frontend layer برای BackOffice UI
-
-## 📋 خلاصه
-
-BackOffice.BFF لایه واسط بین BackOffice UI و CMS microservices است که:
- درخواست‌های UI را aggregate می‌کند
- قراردادهای gRPC اختصاصی ارائه می‌دهد
- منطق سطح BFF را پیاده‌سازی می‌کند
-
-## 🏗️ معماری
-
-### Protobuf Projects (Own Contracts)
-
-BackOffice.BFF از قراردادهای Protobuf **اختصاصی خودش** استفاده می‌کند:
-
-| Project | Version | Namespace | Purpose |
-|---------|---------|-----------|----------|
-| BackOffice.BFF.ClubMembership.Protobuf | 0.0.6 | Foursat.BackOffice.BFF.ClubMembership.Protos | باشگاه مشتریان |
-| BackOffice.BFF.Commission.Protobuf | 0.0.6 | Foursat.BackOffice.BFF.Commission.Protos | کمیسیون |
-| BackOffice.BFF.Configuration.Protobuf | 1.0.6 | Foursat.BackOffice.BFF.Configuration.Protos | تنظیمات |
-| BackOffice.BFF.NetworkMembership.Protobuf | 0.0.6 | Foursat.BackOffice.BFF.NetworkMembership.Protos | شبکه |
-
-**تغییر معماری (۱۷ آذر ۱۴۰۴)**:
- ❌ **قبلا**: استفاده مستقیم از `CMSMicroservice.Protobuf` (Anti-Pattern)
- ✅ **حالا**: Protobuf اختصاصی با namespace مجزا
- ✅ **مزایا**: جدایی concerns، versioning مستقل، کاهش coupling
-
-### GrpcServices Mode
-
-همه پروژه‌های Protobuf با `GrpcServices="Both"` پیکربندی شده‌اند:
- **Server**: Base classes برای پیاده‌سازی در BFF
- **Client**: Client classes برای استفاده در BackOffice UI
-
-### HTTP Annotations (Swagger)
-
-همه 33 endpoint با HTTP annotations پیاده‌سازی شده‌اند:
-```protobuf
-import "google/api/annotations.proto";
-
-rpc GetClubMembershipById(GetClubMembershipByIdRequest) returns (GetClubMembershipByIdResponse) {
-    option (google.api.http) = { get: "/GetClubMembershipById" };
-}
-```
-
-**Package**: Google.Api.CommonProtos v2.10.0
-
-## 🔧 Mapster Configuration
-
-### Immutable Type Handling
-
-Protobuf messages دارای فیلدهای immutable هستند. از `MapWith()` استفاده کنید:
-
-```csharp
-config.NewConfig<GetNetworkTreeResponseDto, GetNetworkTreeResponse>()
-    .MapWith(src => new GetNetworkTreeResponse {
-        Items = { src.Items.Select(x => new NetworkTreeNodeModel {
-            UserId = x.UserId,
-            FirstName = x.FirstName,
-            // ...
-        }) }
-    });
-```
-
-**Profiles**:
- NetworkMembershipProfile.cs
- ProductsProfile.cs
-
-## 📦 Package Publishing
-
-برای publish به GitLab registry:
-
-```bash
-cd BackOffice.BFF.{Module}.Protobuf
-dotnet pack -c Release
-# Auto-push via PushToFourSat target
-```
-
-**Registry**: https://git.afrino.co/api/packages/FourSat/nuget
-
-## 🔗 Related Docs
-
- [Architecture Patterns](../../../02-ARCHITECTURE/README.md)
- [API Coverage](api-coverage.md)
- [Protobuf Dependencies](protobuf-dependencies.md)
@@ -1,593 +0,0 @@
-# BackOffice.BFF - CMS Integration Documentation
-
-**Date**: 2025-11-30  
-**Status**: ✅ Integrated  
-**CMS Package Version**: 0.0.140  
-
---
-
-## 📋 Overview
-
-BackOffice.BFF به CMS Microservice متصل شد و حالا می‌تواند به سرویس‌های Network-Club-Commission دسترسی داشته باشد.
-
-این Integration به BackOffice امکان می‌دهد:
- مدیریت کامیسیون‌های کاربران
- مشاهده ساختار شبکه Binary Tree
- فعال/غیرفعال کردن عضویت باشگاه
- مشاهده گزارشات هفتگی کمیسیون
-
---
-
-## 🏗️ Architecture
-
-```
-┌─────────────────────────────────────────────────────────┐
-│              BackOffice.BFF (API Gateway)                │
-│                                                           │
-│  ┌──────────────────────────────────────────────────┐   │
-│  │      IApplicationContractContext                 │   │
-│  │  - Users (existing)                              │   │
-│  │  - Products (existing)                           │   │
-│  │  - Orders (existing)                             │   │
-│  │  ✨ Commissions (NEW)                            │   │
-│  │  ✨ NetworkMemberships (NEW)                     │   │
-│  │  ✨ ClubMemberships (NEW)                        │   │
-│  └──────────────────────────────────────────────────┘   │
-│                          ↓ gRPC                          │
-└─────────────────────────────────────────────────────────┘
-                          ↓
-┌─────────────────────────────────────────────────────────┐
-│                  CMS Microservice                        │
-│             https://cms.kbs1.ir                          │
-│                                                           │
-│  ┌─────────────────────┐  ┌─────────────────────────┐  │
-│  │ CommissionContract  │  │ NetworkMembershipContract│  │
-│  │ - GetWeeklyPool     │  │ - GetUserNetworkInfo    │  │
-│  │ - GetUserPayouts    │  │ - GetNetworkTree        │  │
-│  │ - ProcessWithdrawal │  │ - CalculateLegBalances  │  │
-│  └─────────────────────┘  └─────────────────────────┘  │
-│                                                           │
-│  ┌─────────────────────┐                                 │
-│  │ ClubMembershipContract│                               │
-│  │ - ActivateClub      │                                 │
-│  │ - DeactivateClub    │                                 │
-│  │ - GetClubStatus     │                                 │
-│  └─────────────────────┘                                 │
-└─────────────────────────────────────────────────────────┘
-```
-
---
-
-## 📦 Integration Details
-
-### 1️⃣ NuGet Package
-
-**Package**: `Foursat.CMSMicroservice.Protobuf`  
-**Version**: `0.0.140` (Updated from 0.0.137)
-
-**File**: `/BackOffice.BFF/src/BackOffice.BFF.Domain/BackOffice.BFF.Domain.csproj`
-
-```xml
-<PackageReference Include="Foursat.CMSMicroservice.Protobuf" Version="0.0.140" />
-```
-
-**What's New in 0.0.140**:
- ✨ `commission.proto` - Commission system contracts
- ✨ `networkmembership.proto` - Binary tree network contracts
- ✨ `clubmembership.proto` - Club membership contracts
- ✨ `configuration.proto` - System configuration contracts
-
---
-
-### 2️⃣ Interface Definition
-
-**File**: `/BackOffice.BFF/src/BackOffice.BFF.Application/Common/Interfaces/IApplicationContractContext.cs`
-
-```csharp
-public interface IApplicationContractContext
-{
-    // ... existing services ...
-    
-    // Network & Commission System (NEW)
-    CommissionContract.CommissionContractClient Commissions { get; }
-    NetworkMembershipContract.NetworkMembershipContractClient NetworkMemberships { get; }
-    ClubMembershipContract.ClubMembershipContractClient ClubMemberships { get; }
-}
-```
-
---
-
-### 3️⃣ Implementation
-
-**File**: `/BackOffice.BFF/src/BackOffice.BFF.Infrastructure/Services/ApplicationContractContext.cs`
-
-```csharp
-public class ApplicationContractContext : IApplicationContractContext
-{
-    // ... existing implementations ...
-    
-    // Network & Commission System
-    public CommissionContract.CommissionContractClient Commissions 
-        => GetService<CommissionContract.CommissionContractClient>();
-    
-    public NetworkMembershipContract.NetworkMembershipContractClient NetworkMemberships 
-        => GetService<NetworkMembershipContract.NetworkMembershipContractClient>();
-    
-    public ClubMembershipContract.ClubMembershipContractClient ClubMemberships 
-        => GetService<ClubMembershipContract.ClubMembershipContractClient>();
-}
-```
-
---
-
-### 4️⃣ gRPC Configuration
-
-**File**: `/BackOffice.BFF/src/BackOffice.BFF.WebApi/appsettings.json`
-
-```json
-{
-  "GrpcChannelOptions": {
-    "FMSMSAddress": "https://dl.afrino.co",
-    "CMSMSAddress": "https://cms.kbs1.ir"
-  }
-}
-```
-
-**Auto-Registration**: 
- gRPC clients به صورت خودکار توسط `ConfigureGrpcServices.BatchRegisterGrpcClients()` ثبت می‌شوند
- بر اساس نام Assembly (`CMSMicroservice.Protobuf`)
- با Address مشخص شده در `appsettings.json`
-
---
-
-## 🔌 Available Services
-
-### 1️⃣ CommissionContract
-
-**Namespace**: `CMSMicroservice.Protobuf.Protos.Commission`
-
-#### Commands:
-```csharp
-// محاسبه بالانس های هفتگی
-await _context.Commissions.CalculateWeeklyBalancesAsync(
-    new CalculateWeeklyBalancesRequest { WeekNumber = "2025-W48" });
-
-// محاسبه Pool هفتگی
-await _context.Commissions.CalculateWeeklyCommissionPoolAsync(
-    new CalculateWeeklyCommissionPoolRequest { WeekNumber = "2025-W48" });
-
-// پردازش Payout های کاربران
-await _context.Commissions.ProcessUserPayoutsAsync(
-    new ProcessUserPayoutsRequest { WeekNumber = "2025-W48" });
-
-// درخواست برداشت توسط کاربر
-await _context.Commissions.RequestWithdrawalAsync(
-    new RequestWithdrawalRequest 
-    { 
-        UserId = 123, 
-        Amount = 500000 
-    });
-
-// پردازش برداشت (توسط Admin)
-await _context.Commissions.ProcessWithdrawalAsync(
-    new ProcessWithdrawalRequest 
-    { 
-        PayoutId = 456, 
-        Status = WithdrawalStatus.Approved 
-    });
-```
-
-#### Queries:
-```csharp
-// دریافت Pool هفتگی
-var pool = await _context.Commissions.GetWeeklyCommissionPoolAsync(
-    new GetWeeklyCommissionPoolRequest { WeekNumber = "2025-W48" });
-
-// دریافت Payout های یک کاربر
-var payouts = await _context.Commissions.GetUserPayoutsAsync(
-    new GetUserPayoutsRequest 
-    { 
-        UserId = 123,
-        PageNumber = 1,
-        PageSize = 10 
-    });
-
-// دریافت تاریخچه Withdrawal ها
-var withdrawals = await _context.Commissions.GetWithdrawalHistoryAsync(
-    new GetWithdrawalHistoryRequest 
-    { 
-        UserId = 123,
-        Status = WithdrawalStatus.Pending 
-    });
-```
-
---
-
-### 2️⃣ NetworkMembershipContract
-
-**Namespace**: `CMSMicroservice.Protobuf.Protos.NetworkMembership`
-
-#### Queries:
-```csharp
-// دریافت اطلاعات شبکه یک کاربر
-var networkInfo = await _context.NetworkMemberships.GetUserNetworkInfoAsync(
-    new GetUserNetworkInfoRequest { UserId = 123 });
-
-// دریافت درخت شبکه (Binary Tree)
-var tree = await _context.NetworkMemberships.GetNetworkTreeAsync(
-    new GetNetworkTreeRequest 
-    { 
-        RootUserId = 123,
-        MaxDepth = 5 
-    });
-
-// دریافت بالانس های هفتگی
-var balances = await _context.NetworkMemberships.GetUserWeeklyBalancesAsync(
-    new GetUserWeeklyBalancesRequest 
-    { 
-        UserId = 123,
-        WeekNumber = "2025-W48" 
-    });
-
-// محاسبه بالانس Leg های یک کاربر
-var legBalances = await _context.NetworkMemberships.CalculateLegBalancesAsync(
-    new CalculateLegBalancesRequest { UserId = 123 });
-```
-
---
-
-### 3️⃣ ClubMembershipContract
-
-**Namespace**: `CMSMicroservice.Protobuf.Protos.ClubMembership`
-
-#### Commands:
-```csharp
-// فعال کردن عضویت باشگاه
-await _context.ClubMemberships.ActivateClubMembershipAsync(
-    new ActivateClubMembershipRequest 
-    { 
-        UserId = 123,
-        ActivationDate = Timestamp.FromDateTime(DateTime.UtcNow) 
-    });
-
-// غیرفعال کردن عضویت باشگاه
-await _context.ClubMemberships.DeactivateClubMembershipAsync(
-    new DeactivateClubMembershipRequest 
-    { 
-        UserId = 123,
-        Reason = "User request" 
-    });
-```
-
-#### Queries:
-```csharp
-// دریافت وضعیت عضویت باشگاه
-var status = await _context.ClubMemberships.GetClubMembershipStatusAsync(
-    new GetClubMembershipStatusRequest { UserId = 123 });
-
-// لیست تمام اعضای باشگاه
-var members = await _context.ClubMemberships.GetAllClubMembersAsync(
-    new GetAllClubMembersRequest 
-    { 
-        IsActive = true,
-        PageNumber = 1,
-        PageSize = 20 
-    });
-```
-
---
-
-## 📝 Usage Example in BFF
-
-### Example 1: Create Commission Query Handler
-
-**File**: `/BackOffice.BFF/src/BackOffice.BFF.Application/CommissionCQ/Queries/GetUserPayouts/GetUserPayoutsQuery.cs`
-
-```csharp
-public record GetUserPayoutsQuery : IRequest<GetUserPayoutsResponseDto>
-{
-    public long UserId { get; init; }
-    public int PageNumber { get; init; } = 1;
-    public int PageSize { get; init; } = 10;
-}
-
-public class GetUserPayoutsQueryHandler 
-    : IRequestHandler<GetUserPayoutsQuery, GetUserPayoutsResponseDto>
-{
-    private readonly IApplicationContractContext _context;
-
-    public GetUserPayoutsQueryHandler(IApplicationContractContext context)
-    {
-        _context = context;
-    }
-
-    public async Task<GetUserPayoutsResponseDto> Handle(
-        GetUserPayoutsQuery request, 
-        CancellationToken cancellationToken)
-    {
-        var response = await _context.Commissions.GetUserPayoutsAsync(
-            request.Adapt<GetUserPayoutsRequest>(), 
-            cancellationToken: cancellationToken);
-
-        return response.Adapt<GetUserPayoutsResponseDto>();
-    }
-}
-```
-
---
-
-### Example 2: Create Network Tree Query Handler
-
-**File**: `/BackOffice.BFF/src/BackOffice.BFF.Application/NetworkCQ/Queries/GetNetworkTree/GetNetworkTreeQuery.cs`
-
-```csharp
-public record GetNetworkTreeQuery : IRequest<GetNetworkTreeResponseDto>
-{
-    public long RootUserId { get; init; }
-    public int MaxDepth { get; init; } = 5;
-}
-
-public class GetNetworkTreeQueryHandler 
-    : IRequestHandler<GetNetworkTreeQuery, GetNetworkTreeResponseDto>
-{
-    private readonly IApplicationContractContext _context;
-
-    public GetNetworkTreeQueryHandler(IApplicationContractContext context)
-    {
-        _context = context;
-    }
-
-    public async Task<GetNetworkTreeResponseDto> Handle(
-        GetNetworkTreeQuery request, 
-        CancellationToken cancellationToken)
-    {
-        var response = await _context.NetworkMemberships.GetNetworkTreeAsync(
-            request.Adapt<GetNetworkTreeRequest>(), 
-            cancellationToken: cancellationToken);
-
-        return response.Adapt<GetNetworkTreeResponseDto>();
-    }
-}
-```
-
---
-
-### Example 3: Create Club Activation Command Handler
-
-**File**: `/BackOffice.BFF/src/BackOffice.BFF.Application/ClubCQ/Commands/ActivateClub/ActivateClubCommand.cs`
-
-```csharp
-public record ActivateClubCommand : IRequest<Unit>
-{
-    public long UserId { get; init; }
-    public DateTimeOffset? ActivationDate { get; init; }
-}
-
-public class ActivateClubCommandHandler 
-    : IRequestHandler<ActivateClubCommand, Unit>
-{
-    private readonly IApplicationContractContext _context;
-
-    public ActivateClubCommandHandler(IApplicationContractContext context)
-    {
-        _context = context;
-    }
-
-    public async Task<Unit> Handle(
-        ActivateClubCommand request, 
-        CancellationToken cancellationToken)
-    {
-        await _context.ClubMemberships.ActivateClubMembershipAsync(
-            request.Adapt<ActivateClubMembershipRequest>(), 
-            cancellationToken: cancellationToken);
-
-        return Unit.Value;
-    }
-}
-```
-
---
-
-## 🔐 Authentication & Authorization
-
-**JWT Token**:
- BackOffice.BFF به CMS با JWT Token متصل می‌شود
- Token از `ITokenProvider` گرفته می‌شود
- در Header با کلید `Authorization: Bearer {token}` ارسال می‌شود
-
-**Implementation در `ConfigureGrpcServices.cs`**:
-```csharp
-private static async Task CallCredentials(
-    AuthInterceptorContext context, 
-    Metadata metadata,
-    IServiceProvider serviceProvider)
-{
-    var provider = serviceProvider.GetRequiredService<ITokenProvider>();
-    var token = await provider.GetTokenAsync();
-    metadata.Add("Authorization", $"Bearer {token}");
-}
-```
-
---
-
-## 🧪 Testing
-
-### Test Connection:
-
-```csharp
-// در یک Controller یا Handler:
-var pool = await _context.Commissions.GetWeeklyCommissionPoolAsync(
-    new GetWeeklyCommissionPoolRequest { WeekNumber = "2025-W48" });
-
-Console.WriteLine($"Total Pool Value: {pool.TotalPoolValue}");
-Console.WriteLine($"Active Members: {pool.ActiveMembersCount}");
-```
-
-**Expected Output**:
-```
-Total Pool Value: 50000000
-Active Members: 120
-```
-
---
-
-### Test with Postman/Swagger:
-
-1. Start BackOffice.BFF:
-   ```bash
-   cd /home/masoud/Apps/project/FourSat/BackOffice.BFF/src
-   dotnet run --project BackOffice.BFF.WebApi
-   ```
-
-2. Call API endpoint (example):
-   ```http
-   GET /api/commission/weekly-pool?weekNumber=2025-W48
-   Authorization: Bearer {your-token}
-   ```
-
-3. Expected Response:
-   ```json
-   {
-     "weekNumber": "2025-W48",
-     "totalPoolValue": 50000000,
-     "activeMembersCount": 120,
-     "isCalculated": true
-   }
-   ```
-
---
-
-## 📊 Status & Metrics
-
-| Component | Status | Version | Notes |
-|-----------|--------|---------|-------|
-| **CMS Protobuf Package** | ✅ Active | 0.0.140 | With Network-Club-Commission |
-| **gRPC Connection** | ✅ Configured | - | https://cms.kbs1.ir |
-| **Auto-Registration** | ✅ Active | - | Via BatchRegisterGrpcClients |
-| **Commission Client** | ✅ Ready | - | All commands & queries available |
-| **Network Client** | ✅ Ready | - | Binary tree queries available |
-| **Club Client** | ✅ Ready | - | Activation/Deactivation available |
-| **Authentication** | ✅ Configured | JWT | Via ITokenProvider |
-
---
-
-## 🔗 Related Documentation
-
-### CMS Side:
- **Implementation Progress**: `/CMS/docs/implementation-progress.md`
- **Network System Design**: `/CMS/docs/network-club-commission-system.md`
- **Monitoring Setup**: `/CMS/docs/monitoring-alerts-consolidated-report.md`
- **Migration Guide**: `/CMS/docs/migration-network-parent-guide.md`
- **Binary Tree Registration**: `/CMS/docs/binary-tree-registration-guide.md`
-
-### BFF Side:
- **This Document**: `/BackOffice.BFF/docs/cms-integration.md`
- **README**: `/BackOffice.BFF/README.md`
-
---
-
-## 🚀 Next Steps
-
-### Immediate:
-1. ✅ Integration completed
-2. ⏳ Create Commission/Network/Club CQRS handlers in BFF
-3. ⏳ Add API endpoints in BackOffice.BFF.WebApi
-4. ⏳ Test integration with real data
-
-### Short-term:
-5. ⏳ Add Swagger documentation for new endpoints
-6. ⏳ Implement error handling for gRPC calls
-7. ⏳ Add logging for commission operations
-8. ⏳ Create admin dashboard for network visualization
-
-### Long-term:
-9. ⏳ Add real-time notifications (SignalR) for commission updates
-10. ⏳ Implement caching for frequently accessed data
-11. ⏳ Add reporting/analytics endpoints
-12. ⏳ Performance optimization for large network trees
-
---
-
-## 📞 Troubleshooting
-
-### Issue 1: gRPC Connection Failed
-
-**Error**: `Status(StatusCode="Unavailable", Detail="...")`
-
-**Solutions**:
-1. Check CMS service is running: `https://cms.kbs1.ir`
-2. Verify network connectivity
-3. Check firewall settings
-4. Verify SSL certificate is valid
-
---
-
-### Issue 2: Authentication Failed
-
-**Error**: `Status(StatusCode="Unauthenticated", Detail="...")`
-
-**Solutions**:
-1. Verify `ITokenProvider` is registered in DI
-2. Check JWT token is valid and not expired
-3. Verify token has correct claims/permissions
-4. Check Authorization header is being sent
-
---
-
-### Issue 3: Package Version Mismatch
-
-**Error**: `The type or namespace 'CommissionContract' could not be found`
-
-**Solutions**:
-1. Update package version in `.csproj`:
-   ```xml
-   <PackageReference Include="Foursat.CMSMicroservice.Protobuf" Version="0.0.140" />
-   ```
-2. Run `dotnet restore`
-3. Clean and rebuild solution
-
---
-
-### Issue 4: Method Not Found
-
-**Error**: `Method 'GetWeeklyPool' not found on service 'CommissionContract'`
-
-**Solutions**:
-1. Verify CMS service has the latest code deployed
-2. Check Protobuf contract matches between CMS and BFF
-3. Update both CMS and BFF to latest versions
-4. Restart both services
-
---
-
-## 🎯 Summary
-
-### ✅ Completed:
- CMS Protobuf package updated to 0.0.140
- 3 new gRPC clients added to BFF:
-  * CommissionContract (8+ methods)
-  * NetworkMembershipContract (6+ methods)
-  * ClubMembershipContract (4+ methods)
- Auto-registration configured
- Authentication via JWT configured
- Build successful (0 errors)
-
-### ⏳ Pending:
- Create CQRS handlers for Commission operations
- Create CQRS handlers for Network operations
- Create CQRS handlers for Club operations
- Add API Controllers/Endpoints
- Add Swagger documentation
- Integration testing
-
-### 🔑 Key Points:
- **No manual registration needed**: gRPC clients auto-register via `BatchRegisterGrpcClients()`
- **Authentication handled**: JWT token automatically added to all requests
- **Type-safe**: All Protobuf contracts are strongly typed
- **Easy to use**: Simple interface via `IApplicationContractContext`
-
---
-
-**Last Updated**: 2025-11-30  
-**Build Status**: ✅ Success  
-**Ready for**: Handler implementation & API endpoint creation
@@ -1,603 +0,0 @@
-# BackOffice.BFF - Discount Shop Integration Plan
-
-**تاریخ ایجاد**: 1403/09/13 (2024-12-04)  
-**آخرین بروزرسانی**: 1403/09/14 (2024-12-05)  
-**وضعیت**: ✅ پیاده‌سازی شده (Plan اجرا شده است)  
-**اولویت در زمان طراحی**: 🔴 بالا  
-
---
-
-## 📊 خلاصه وضعیت
-
-### ✅ تکمیل شده در CMS
- **Phase 9: Club Discount Shop System** - 100% ✅
-  - 6 Entities (Category, Product, Cart, Order)
-  - 13 Commands + 6 Queries + 9 Validators
-  - 4 Proto Files (19 gRPC RPCs)
-  - 4 gRPC Services
-  - Migration: AddDiscountShopSystem
-
-### ⏳ وضعیت در BackOffice.BFF (به‌روزرسانی)
- **19 Handler** برای 4 سرویس جدید → ✅ پیاده‌سازی و متصل به CMS
- **4 Client Interface** در `IApplicationContractContext` → ✅ اضافه و در `ApplicationContractContext` پیاده‌سازی شده
- **Test و Validation** → ✅ در BackOffice UI (DiscountShop صفحات و سرویس‌ها) در حال استفاده عملی  
-
-> این سند به‌عنوان **طرح اولیه** نگه‌داری می‌شود؛ برای وضعیت نهایی به `totalDoc/05-TASKS/BACKLOG.md` (بخش Discount Shop - BackOffice Integration ✅) و `totalDoc/04-FRONTEND/BackOffice/ui-status.md` مراجعه شود.
-
---
-
-## 🎯 امکانات جدید برای Admin Panel
-
-### 1️⃣ مدیریت محصولات فروشگاه تخفیفی (5 API)
-
-**سرویس**: `DiscountProductContract`
-
-#### الف. ایجاد محصول جدید
- **Handler**: `CreateDiscountProductHandler`
- **Request**: 
-  ```csharp
-  - Title (عنوان محصول)
-  - ShortInfomation (توضیحات کوتاه)
-  - FullInformation (توضیحات کامل)
-  - Price (قیمت به تومان)
-  - MaxDiscountPercent (حداکثر درصد تخفیف قابل استفاده از کیف پول تخفیف - 0 تا 100)
-  - ImagePath (مسیر تصویر اصلی)
-  - ThumbnailPath (مسیر تصویر کوچک)
-  - InitialCount (تعداد اولیه موجودی)
-  - SortOrder (ترتیب نمایش)
-  - IsActive (فعال/غیرفعال)
-  - CategoryIds (لیست شناسه دسته‌بندی‌ها)
-  ```
- **Response**: ProductId (شناسه محصول ایجاد شده)
- **کاربرد Admin**: ایجاد محصول جدید در فروشگاه تخفیفی
-
-#### ب. ویرایش محصول
- **Handler**: `UpdateDiscountProductHandler`
- **Request**: همان فیلدهای بالا + ProductId
- **کاربرد Admin**: ویرایش اطلاعات محصول موجود
-
-#### ج. حذف محصول
- **Handler**: `DeleteDiscountProductHandler`
- **Request**: ProductId
- **کاربرد Admin**: حذف محصول از فروشگاه
-
-#### د. دریافت جزئیات محصول
- **Handler**: `GetDiscountProductByIdHandler`
- **Request**: ProductId
- **Response**: تمام اطلاعات محصول + لیست دسته‌بندی‌ها + موجودی باقی‌مانده
- **کاربرد Admin**: مشاهده جزئیات کامل یک محصول
-
-#### ه. لیست محصولات با فیلتر
- **Handler**: `GetDiscountProductsHandler`
- **Request**:
-  ```csharp
-  - CategoryId (nullable - فیلتر بر اساس دسته‌بندی)
-  - SearchQuery (nullable - جستجو در عنوان و توضیحات)
-  - MinPrice (nullable - حداقل قیمت)
-  - MaxPrice (nullable - حداکثر قیمت)
-  - IsActive (nullable - فیلتر فعال/غیرفعال)
-  - InStock (nullable - فقط موجود در انبار)
-  - PageNumber (شماره صفحه)
-  - PageSize (تعداد آیتم در صفحه)
-  ```
- **Response**: 
-  ```csharp
-  - MetaData (اطلاعات صفحه‌بندی)
-  - Models (لیست محصولات)
-  ```
- **کاربرد Admin**: مدیریت و جستجوی محصولات
-
---
-
-### 2️⃣ مدیریت دسته‌بندی محصولات (4 API)
-
-**سرویس**: `DiscountCategoryContract`
-
-#### الف. ایجاد دسته‌بندی جدید
- **Handler**: `CreateDiscountCategoryHandler`
- **Request**:
-  ```csharp
-  - Name (نام لاتین برای URL)
-  - Title (عنوان فارسی)
-  - Description (nullable - توضیحات)
-  - ImagePath (nullable - تصویر دسته‌بندی)
-  - ParentCategoryId (nullable - دسته‌بندی والد برای ساختار درختی)
-  - SortOrder (ترتیب نمایش)
-  - IsActive (فعال/غیرفعال)
-  ```
- **Response**: CategoryId
- **کاربرد Admin**: ایجاد دسته‌بندی جدید (با قابلیت ساختار چند سطحی)
-
-#### ب. ویرایش دسته‌بندی
- **Handler**: `UpdateDiscountCategoryHandler`
- **Request**: همان فیلدهای بالا + CategoryId
- **کاربرد Admin**: ویرایش دسته‌بندی موجود
-
-#### ج. حذف دسته‌بندی
- **Handler**: `DeleteDiscountCategoryHandler`
- **Request**: CategoryId
- **Response**: Success/Failure
- **Logic**: 
-  - چک می‌کند اگر این دسته‌بندی زیرمجموعه دارد → خطا
-  - چک می‌کند اگر محصولی به این دسته‌بندی متصل است → خطا
-  - در غیر این صورت حذف می‌شود
- **کاربرد Admin**: حذف ایمن دسته‌بندی
-
-#### د. دریافت درخت دسته‌بندی‌ها
- **Handler**: `GetDiscountCategoriesHandler`
- **Request**:
-  ```csharp
-  - ParentCategoryId (nullable)
-    * اگر null باشد: دسته‌بندی‌های ریشه (Root) برگردانده می‌شود
-    * اگر مقدار داشته باشد: زیرمجموعه‌های آن دسته‌بندی برگردانده می‌شود
-  - IsActive (nullable - فیلتر فعال/غیرفعال)
-  ```
- **Response**: 
-  ```csharp
-  - List<DiscountCategoryDto> (ساختار recursive با Children)
-  ```
- **کاربرد Admin**: مشاهده ساختار درختی دسته‌بندی‌ها
-
---
-
-### 3️⃣ مدیریت سبد خرید کاربران (5 API)
-
-**سرویس**: `DiscountShoppingCartContract`
-
-> **توجه**: این APIها در Admin Panel کمتر استفاده می‌شوند، اما برای Support و Troubleshooting مفید هستند.
-
-#### الف. افزودن به سبد خرید (Support)
- **Handler**: `AddToCartHandler`
- **Request**: UserId, ProductId, Count
- **کاربرد Admin**: کمک به کاربر در افزودن محصول به سبد (Support)
-
-#### ب. حذف از سبد خرید (Support)
- **Handler**: `RemoveFromCartHandler`
- **Request**: UserId, ProductId
- **کاربرد Admin**: کمک به کاربر در حذف آیتم از سبد
-
-#### ج. تغییر تعداد آیتم (Support)
- **Handler**: `UpdateCartItemCountHandler`
- **Request**: UserId, ProductId, NewCount
- **کاربرد Admin**: اصلاح تعداد آیتم در سبد کاربر
-
-#### د. مشاهده سبد خرید کاربر
- **Handler**: `GetUserCartHandler`
- **Request**: UserId
- **Response**:
-  ```csharp
-  - List<CartItemDto>
-    * ProductId
-    * ProductTitle
-    * ProductImagePath
-    * UnitPrice (قیمت واحد)
-    * MaxDiscountPercent
-    * Count (تعداد)
-    * TotalPrice (قیمت کل = UnitPrice × Count)
-    * DiscountAmount (مقدار تخفیف قابل استفاده)
-    * FinalPrice (قیمت نهایی بعد از تخفیف)
-    * ProductRemainingCount (موجودی باقی‌مانده)
-  - TotalPrice (مجموع قیمت کل سبد)
-  - TotalDiscountAmount (مجموع تخفیف قابل استفاده)
-  - FinalPrice (مجموع قیمت نهایی)
-  ```
- **کاربرد Admin**: بررسی سبد خرید کاربر برای Support
-
-#### ه. پاک کردن سبد خرید
- **Handler**: `ClearCartHandler`
- **Request**: UserId
- **کاربرد Admin**: پاک کردن کامل سبد خرید کاربر (در صورت نیاز)
-
---
-
-### 4️⃣ مدیریت سفارشات فروشگاه تخفیفی (5 API)
-
-**سرویس**: `DiscountOrderContract`
-
-#### الف. ثبت سفارش (کمتر استفاده می‌شود در Admin)
- **Handler**: `PlaceOrderHandler`
- **Request**:
-  ```csharp
-  - UserId
-  - UserAddressId
-  - DiscountBalanceToUse (مقدار کیف پول تخفیف برای استفاده)
-  - Notes (nullable - یادداشت)
-  ```
- **Response**:
-  ```csharp
-  - Success
-  - Message
-  - OrderId
-  - GatewayAmount (مبلغ باقی‌مانده برای پرداخت از طریق درگاه)
-  - PaymentUrl (nullable - لینک پرداخت)
-  ```
- **کاربرد Admin**: ثبت سفارش دستی برای کاربر (نادر)
-
-#### ب. تکمیل پرداخت سفارش (کمتر استفاده می‌شود)
- **Handler**: `CompleteOrderPaymentHandler`
- **Request**: OrderId, TransactionId, PaymentSuccess
- **کاربرد Admin**: تایید دستی پرداخت (در صورت مشکل)
-
-#### ج. تغییر وضعیت ارسال سفارش ⭐ **مهم**
- **Handler**: `UpdateOrderStatusHandler`
- **Request**:
-  ```csharp
-  - OrderId
-  - NewStatus (enum: Pending, Processing, Shipped, Delivered, Cancelled)
-  - TrackingCode (nullable - کد رهگیری پست)
-  - AdminNotes (nullable - یادداشت ادمین)
-  ```
- **Response**: Success, Message
- **کاربرد Admin**: 
-  - تغییر وضعیت سفارش به "در حال پردازش"
-  - ثبت کد رهگیری پست
-  - تغییر وضعیت به "ارسال شده"
-  - تایید تحویل
-  - لغو سفارش
-
-#### د. مشاهده جزئیات سفارش ⭐ **مهم**
- **Handler**: `GetOrderByIdHandler`
- **Request**: OrderId
- **Response**:
-  ```csharp
-  - OrderId
-  - UserId
-  - UserName (nullable)
-  - Address (AddressInfo)
-    * Title
-    * Address
-    * PostalCode
-  - OrderItems (List)
-    * ProductId
-    * ProductTitle
-    * ProductPrice (قیمت اسنپ‌شات در زمان خرید)
-    * MaxDiscountPercent
-    * Count
-    * TotalPrice
-    * DiscountAmount
-    * FinalPrice
-  - TotalPrice (مجموع قیمت)
-  - DiscountBalanceUsed (مقدار استفاده شده از کیف پول تخفیف)
-  - GatewayAmount (مبلغ پرداخت شده از درگاه)
-  - PaymentTransactionId (nullable)
-  - DeliveryStatus (enum)
-  - TrackingCode (nullable)
-  - AdminNotes (nullable)
-  - Notes (یادداشت کاربر)
-  - OrderDate
-  - PaymentDate (nullable)
-  ```
- **کاربرد Admin**: بررسی کامل سفارش
-
-#### ه. لیست سفارشات کاربر ⭐ **مهم**
- **Handler**: `GetUserOrdersHandler`
- **Request**:
-  ```csharp
-  - UserId
-  - PageNumber
-  - PageSize
-  ```
- **Response**:
-  ```csharp
-  - MetaData (صفحه‌بندی)
-  - Models (List<OrderSummaryDto>)
-    * OrderId
-    * TotalPrice
-    * DiscountBalanceUsed
-    * GatewayAmount
-    * DeliveryStatus
-    * ItemsCount (تعداد آیتم‌های سفارش)
-    * OrderDate
-  ```
- **کاربرد Admin**: مشاهده تاریخچه سفارشات کاربر
-
---
-
-## 📋 لیست کامل Handlerهای مورد نیاز
-
-### ✅ موجود در BackOffice.BFF (35 Handler)
-1. User Management (7)
-2. Product Management (5)
-3. Order Management (5)
-4. Category/Tag (4)
-5. Role & Permission (3)
-6. Commission System (4)
-7. Network Membership (3)
-8. Club Membership (4)
-
-### ⏳ نیاز به ایجاد (19 Handler)
-
-#### گروه 1: Discount Product (5 Handlers)
-1. ✅ `CreateDiscountProductHandler`
-2. ✅ `UpdateDiscountProductHandler`
-3. ✅ `DeleteDiscountProductHandler`
-4. ✅ `GetDiscountProductByIdHandler`
-5. ✅ `GetDiscountProductsHandler`
-
-#### گروه 2: Discount Category (4 Handlers)
-6. ✅ `CreateDiscountCategoryHandler`
-7. ✅ `UpdateDiscountCategoryHandler`
-8. ✅ `DeleteDiscountCategoryHandler`
-9. ✅ `GetDiscountCategoriesHandler`
-
-#### گروه 3: Discount Shopping Cart (5 Handlers)
-10. ✅ `AddToCartHandler` (برای Support)
-11. ✅ `RemoveFromCartHandler` (برای Support)
-12. ✅ `UpdateCartItemCountHandler` (برای Support)
-13. ✅ `GetUserCartHandler` ⭐
-14. ✅ `ClearCartHandler`
-
-#### گروه 4: Discount Order (5 Handlers)
-15. ✅ `PlaceOrderHandler` (کمتر استفاده می‌شود)
-16. ✅ `CompleteOrderPaymentHandler` (کمتر استفاده می‌شود)
-17. ✅ `UpdateOrderStatusHandler` ⭐⭐⭐ **خیلی مهم**
-18. ✅ `GetOrderByIdHandler` ⭐⭐⭐ **خیلی مهم**
-19. ✅ `GetUserOrdersHandler` ⭐⭐ **مهم**
-
---
-
-## 🏗️ تغییرات مورد نیاز در BackOffice.BFF
-
-### 1️⃣ آپدیت IApplicationContractContext
-
-**فایل**: `/BackOffice.BFF/src/BackOffice.BFF.Application/Common/Interfaces/IApplicationContractContext.cs`
-
-```csharp
-public interface IApplicationContractContext
-{
-    // ... existing services ...
-    
-    // Discount Shop System (NEW - Phase 9)
-    DiscountProductContract.DiscountProductContractClient DiscountProducts { get; }
-    DiscountCategoryContract.DiscountCategoryContractClient DiscountCategories { get; }
-    DiscountShoppingCartContract.DiscountShoppingCartContractClient DiscountShoppingCarts { get; }
-    DiscountOrderContract.DiscountOrderContractClient DiscountOrders { get; }
-}
-```
-
-### 2️⃣ پیاده‌سازی در ApplicationContractContext
-
-**فایل**: `/BackOffice.BFF/src/BackOffice.BFF.Infrastructure/Persistence/ApplicationContractContext.cs`
-
-```csharp
-public class ApplicationContractContext : IApplicationContractContext
-{
-    // ... existing implementations ...
-    
-    // Discount Shop System (NEW)
-    public DiscountProductContract.DiscountProductContractClient DiscountProducts { get; }
-    public DiscountCategoryContract.DiscountCategoryContractClient DiscountCategories { get; }
-    public DiscountShoppingCartContract.DiscountShoppingCartContractClient DiscountShoppingCarts { get; }
-    public DiscountOrderContract.DiscountOrderContractClient DiscountOrders { get; }
-    
-    public ApplicationContractContext(GrpcChannel channel)
-    {
-        // ... existing initializations ...
-        
-        // Discount Shop System
-        DiscountProducts = new DiscountProductContract.DiscountProductContractClient(channel);
-        DiscountCategories = new DiscountCategoryContract.DiscountCategoryContractClient(channel);
-        DiscountShoppingCarts = new DiscountShoppingCartContract.DiscountShoppingCartContractClient(channel);
-        DiscountOrders = new DiscountOrderContract.DiscountOrderContractClient(channel);
-    }
-}
-```
-
-### 3️⃣ ایجاد Handlerها
-
-**ساختار فولدر**:
-```
-BackOffice.BFF.Application/
-└── DiscountShop/
-    ├── Products/
-    │   ├── CreateDiscountProduct/
-    │   │   ├── CreateDiscountProductCommand.cs
-    │   │   └── CreateDiscountProductHandler.cs
-    │   ├── UpdateDiscountProduct/
-    │   ├── DeleteDiscountProduct/
-    │   ├── GetDiscountProductById/
-    │   └── GetDiscountProducts/
-    ├── Categories/
-    │   ├── CreateDiscountCategory/
-    │   ├── UpdateDiscountCategory/
-    │   ├── DeleteDiscountCategory/
-    │   └── GetDiscountCategories/
-    ├── Cart/
-    │   ├── AddToCart/
-    │   ├── RemoveFromCart/
-    │   ├── UpdateCartItemCount/
-    │   ├── GetUserCart/
-    │   └── ClearCart/
-    └── Orders/
-        ├── PlaceOrder/
-        ├── CompleteOrderPayment/
-        ├── UpdateOrderStatus/
-        ├── GetOrderById/
-        └── GetUserOrders/
-```
-
---
-
-## 🎨 UI Pages مورد نیاز در BackOffice
-
-### صفحات جدید (6 صفحه)
-
-1. **صفحه لیست محصولات فروشگاه تخفیفی** (2 روز)
-   - `Pages/DiscountShop/Products/ProductsList.razor`
-   - DataGrid با فیلترها
-   - دکمه‌های Create, Edit, Delete
-   - نمایش موجودی و MaxDiscountPercent
-
-2. **صفحه ایجاد/ویرایش محصول** (1 روز)
-   - `Pages/DiscountShop/Products/ProductForm.razor`
-   - فرم کامل با تمام فیلدها
-   - انتخاب چندتایی دسته‌بندی
-   - آپلود تصویر
-
-3. **صفحه مدیریت دسته‌بندی‌ها** (1.5 روز)
-   - `Pages/DiscountShop/Categories/CategoriesList.razor`
-   - نمایش درختی (Tree View)
-   - قابلیت Drag & Drop برای تغییر Parent
-   - Dialog ایجاد/ویرایش
-
-4. **صفحه لیست سفارشات فروشگاه** (2 روز)
-   - `Pages/DiscountShop/Orders/OrdersList.razor`
-   - DataGrid با فیلترها (Status, Date Range, User)
-   - نمایش خلاصه: TotalPrice, DiscountUsed, GatewayAmount
-   - دکمه View Details
-
-5. **صفحه جزئیات سفارش** (1.5 روز)
-   - `Pages/DiscountShop/Orders/OrderDetails.razor`
-   - نمایش کامل اطلاعات سفارش
-   - لیست آیتم‌های سفارش
-   - **تغییر وضعیت ارسال** (Dropdown)
-   - ثبت کد رهگیری
-   - یادداشت ادمین
-
-6. **صفحه مشاهده سبد خرید کاربر** (1 روز)
-   - `Pages/DiscountShop/Support/UserCart.razor`
-   - برای Support و Troubleshooting
-   - نمایش محاسبات تخفیف
-   - قابلیت اصلاح (Add/Remove/Update)
-
-**جمع زمان UI**: **9 روز**
-
---
-
-## 📊 گزارشات مالی جدید (اختیاری - اولویت متوسط)
-
-### گزارشات پیشنهادی:
-
-1. **گزارش فروش فروشگاه تخفیفی**
-   - مجموع فروش (TotalPrice)
-   - مجموع تخفیف استفاده شده (DiscountBalanceUsed)
-   - مجموع پرداخت از درگاه (GatewayAmount)
-   - تفکیک بر اساس تاریخ، محصول، دسته‌بندی
-
-2. **گزارش محبوب‌ترین محصولات**
-   - تعداد فروش هر محصول
-   - مجموع درآمد
-   - میانگین استفاده از تخفیف
-
-3. **گزارش وضعیت موجودی**
-   - محصولات کم موجودی (RemainingCount < حد آستانه)
-   - هشدار اتمام موجودی
-
-4. **گزارش استفاده از کیف پول تخفیف**
-   - کاربران برتر در استفاده از تخفیف
-   - میانگین درصد استفاده از تخفیف
-   - مقایسه با فروش کل
-
---
-
-## ⏱️ تخمین زمان پیاده‌سازی
-
-### BackOffice.BFF (Backend)
-| مرحله | زمان | توضیحات |
-|-------|------|---------|
-| آپدیت Interface & Context | 30 دقیقه | اضافه کردن 4 Client |
-| ایجاد 19 Handler | 3 روز | ~20 دقیقه هر Handler |
-| Test & Debug | 1 روز | تست تمام Handlerها |
-| **جمع** | **4 روز** | |
-
-### BackOffice UI (Frontend)
-| مرحله | زمان | توضیحات |
-|-------|------|---------|
-| صفحات محصولات (2 صفحه) | 3 روز | List + Form |
-| صفحات دسته‌بندی (1 صفحه) | 1.5 روز | Tree View |
-| صفحات سفارشات (2 صفحه) | 3.5 روز | List + Details |
-| صفحه Support (سبد خرید) | 1 روز | |
-| **جمع** | **9 روز** | |
-
-### **جمع کل**: **13 روز کاری** (~2.5 هفته)
-
---
-
-## 🚀 اولویت‌بندی پیاده‌سازی
-
-### فاز 1: حداقل قابل استفاده (MVP) - 5 روز
-✅ **اولویت بالا**
-1. Handlerهای مدیریت محصولات (5)
-2. Handlerهای مدیریت دسته‌بندی (4)
-3. Handler مشاهده جزئیات سفارش (1)
-4. Handler تغییر وضعیت سفارش (1)
-5. صفحه لیست محصولات + فرم
-6. صفحه لیست سفارشات + جزئیات
-
-### فاز 2: قابلیت‌های Support - 3 روز
-🟡 **اولویت متوسط**
-1. Handlerهای سبد خرید (5)
-2. Handler لیست سفارشات کاربر (1)
-3. صفحه مدیریت دسته‌بندی
-4. صفحه Support سبد خرید
-
-### فاز 3: گزارشات و آمار - 5 روز
-🟢 **اولویت پایین** (می‌تواند بعداً اضافه شود)
-1. گزارشات مالی
-2. داشبورد فروش فروشگاه
-3. چارت‌های تحلیلی
-
---
-
-## 📝 نکات مهم
-
-### ⚠️ نکته 1: MaxDiscountPercent
-این فیلد بسیار مهم است:
- مشخص می‌کند کاربر حداکثر چند درصد از قیمت محصول را می‌تواند با کیف پول تخفیف پرداخت کند
- مثال: قیمت = 1,000,000 تومان، MaxDiscountPercent = 70%
-  - حداکثر تخفیف: 700,000 تومان
-  - مبلغ باقی‌مانده (300,000 تومان) باید از درگاه پرداخت شود
-
-### ⚠️ نکته 2: Snapshot محصول
-وقتی سفارش ثبت می‌شود، اطلاعات محصول (عنوان، قیمت، MaxDiscountPercent) در جدول `DiscountOrderItem` ذخیره می‌شود:
- این اطلاعات Snapshot هستند و حتی اگر محصول بعداً ویرایش شود، سفارش تغییر نمی‌کند
- برای گزارش‌گیری دقیق مالی ضروری است
-
-### ⚠️ نکته 3: Hybrid Payment Flow
-جریان پرداخت ترکیبی:
-1. کاربر سفارش ثبت می‌کند → `PlaceOrder`
-2. CMS محاسبه می‌کند چقدر از کیف پول تخفیف استفاده شود
-3. مبلغ باقی‌مانده (GatewayAmount) به کاربر نمایش داده می‌شود
-4. کاربر به درگاه پرداخت می‌رود
-5. بعد از بازگشت از درگاه → `CompleteOrderPayment`
-6. CMS تراکنش را Verify می‌کند و DiscountBalance را کم می‌کند
-
-### ⚠️ نکته 4: Stock Management
- هنگام `PlaceOrder`: RemainingCount کم می‌شود (Reserve)
- اگر پرداخت ناموفق باشد: باید موجودی برگردانده شود (در CompleteOrderPayment)
- Admin باید بتواند موجودی را دستی تغییر دهد
-
---
-
-## 📚 مستندات مرتبط
-
- [CMS Implementation Progress](../CMS/implementation-progress.md) - Phase 9 Details
- [REMAINING-TASKS-CONSOLIDATED](../REMAINING-TASKS-CONSOLIDATED.md) - Overall Project Status
- [BackOffice.BFF CMS Integration](./cms-integration.md) - Existing Integration Guide
-
---
-
-## ✅ Checklist پیاده‌سازی
-
-### Backend (BackOffice.BFF)
- [ ] آپدیت IApplicationContractContext (4 Client)
- [ ] آپدیت ApplicationContractContext (Implementation)
- [ ] ایجاد 5 Handler محصولات
- [ ] ایجاد 4 Handler دسته‌بندی
- [ ] ایجاد 5 Handler سبد خرید
- [ ] ایجاد 5 Handler سفارشات
- [ ] تست تمام Handlerها
- [ ] آپدیت مستندات cms-integration.md
-
-### Frontend (BackOffice UI)
- [ ] صفحه لیست محصولات
- [ ] صفحه فرم محصول (Create/Edit)
- [ ] صفحه مدیریت دسته‌بندی‌ها
- [ ] صفحه لیست سفارشات
- [ ] صفحه جزئیات سفارش
- [ ] صفحه Support سبد خرید
- [ ] تست UI با داده واقعی
-
---
-
-**آماده شروع پیاده‌سازی؟** 🚀
@@ -1,32 +0,0 @@
-# 📁 BackOffice.BFF - Design Files
-
-این پوشه شامل فایل‌های طراحی BackOffice.BFF است.
-
---
-
-## 📊 فایل‌ها
-
-### Database Models:
- **`model.ndm2`** - طراحی دیتابیس BackOffice.BFF
-  - ابزار: Navicat Data Modeler
-  - محتوا: ساختار Entity ها و روابط
-
---
-
-## 🔧 نحوه استفاده
-
-```bash
-# باز کردن با Navicat Data Modeler
-navicat-data-modeler model.ndm2
-```
-
---
-
-## 🔗 مراجع
-
- **Handlers Status**: [`../handlers-status.md`](../handlers-status.md)
- **CMS Integration**: [`../cms-integration.md`](../cms-integration.md)
-
---
-
-**تاریخ ایجاد**: ۱ دسامبر ۲۰۲۵
@@ -1,264 +0,0 @@
-# CMS Microservice - Network & Club Commission System
-
-[![Status](https://img.shields.io/badge/Status-Production%20Ready-success)]()
-[![Progress](https://img.shields.io/badge/Progress-85%25-blue)]()
-[![MVP](https://img.shields.io/badge/MVP-100%25%20Complete-brightgreen)]()
-
-## 📊 Project Status (2025-12-18)
-
-**Overall Progress**: 85% Complete (7/10 phases)  
-**Production Readiness**: 95%  
-**MVP Status**: ✅ 100% Complete
-
-### ✅ Completed Phases (7)
-1. ✅ Domain Layer (Entities, Enums, Value Objects)
-2. ✅ Club Membership System
-3. ✅ Binary Network Tree
-4. ✅ **Commission Calculation & Background Worker** (MVP)
-5. ✅ Protobuf gRPC Services
-6. ✅ History & Configuration Management
-7. ✅ Database Migration & Seed Data
-
-### 🟡 Partially Complete (1)
- Phase 10: Withdrawal & Settlement (40%)
-  - ✅ Commands & Database
-  - ❌ Payment Gateway Integration
-
-### ❌ Not Started (1)
- Phase 9: Club Shop & Product Integration (0%)
-
-### ⏸️ Postponed (1)
- Phase 7: Testing (Unit, Integration, Load tests)
-
---
-
-## 🚀 Recent Updates (2025-12-18 / ۲۸ آذر)
-
-### Entity Configuration - Persian Encoding Fix ✅
- ✅ **Geography Entities**: Country, State, City
- ✅ **Change**: All string columns now `NVARCHAR` with `Persian_100_CI_AI` collation
- ✅ **Migration**: `FixPersianCollation_Geography`
- ✅ **Fixes**: Persian characters display correctly in Geography tables
-
-### Previous Updates (2025-12-01)
- ✅ **MailKit 4.14.1** for Email (SMTP with HTML templates)
- ✅ **Kavenegar 1.2.5** for SMS (Iranian SMS gateway)
- ✅ User.Email field added with migration
- ✅ 3 notification types: Commission, Club activation, Errors
- ✅ Persian RTL templates with rich formatting
- ✅ Production configuration guide created
-
-### Hangfire Job Scheduling - COMPLETED ✅
- ✅ Dashboard UI at `/hangfire`
- ✅ Cron schedule: Sunday 00:05 UTC
- ✅ SQL Server persistence
- ✅ Manual trigger API endpoints
- ✅ Distributed execution support
-
-### Infrastructure Enhancements - COMPLETED ✅
- ✅ Health Check endpoints (`/health`, `/health/ready`, `/health/live`)
- ✅ AlertService (structured logging for Sentry/Slack)
- ✅ Retry logic (Polly 8.5.0 with exponential backoff)
- ✅ WorkerExecutionLog (database audit trail)
- ✅ CurrentUserService (JWT authentication context)
-
---
-
-## 🏗️ Architecture
-
-**Clean Architecture** with 4 layers:
-```
-CMSMicroservice.Domain/          # Entities, Enums, Interfaces
-CMSMicroservice.Application/     # CQRS (Commands, Queries, MediatR)
-CMSMicroservice.Infrastructure/  # DbContext, Services, Background Jobs
-CMSMicroservice.WebApi/          # gRPC Services, Controllers
-CMSMicroservice.Protobuf/        # Protocol Buffers definitions
-```
-
-**Technology Stack**:
- .NET 9.0
- Entity Framework Core 9.0.11
- gRPC + JSON Transcoding
- Hangfire 1.8.22 (Job Scheduling)
- MediatR 13.0.0 (CQRS)
- Polly 8.5.0 (Resilience)
- MailKit 4.14.1 (Email)
- Kavenegar 1.2.5 (SMS)
- SQL Server
-
---
-
-## 📖 Documentation
-
- **[Implementation Progress](docs/implementation-progress.md)** - Detailed phase-by-phase progress
- **[Email/SMS Configuration Guide](docs/email-sms-configuration-guide.md)** - Production setup instructions
- **[Balance Calculation Logic](docs/balance-calculation-carryover-logic.md)** - Commission algorithm details
- **[Binary Tree Registration](docs/binary-tree-registration-guide.md)** - Network tree guide
- **[Network Club Commission System](docs/network-club-commission-system-v1.1.md)** - Full system specification
-
---
-
-## 🚀 Quick Start
-
-### Prerequisites
- .NET 9.0 SDK
- SQL Server (local or remote)
- (Optional) Gmail account for Email
- (Optional) Kavenegar account for SMS
-
-### 1. Clone & Build
-```bash
-cd /home/masoud/Apps/project/FourSat/CMS/src
-dotnet build
-```
-
-### 2. Configure Database
-Update `appsettings.json` with your SQL Server connection:
-```json
-"ConnectionStrings": {
-  "DefaultConnection": "Server=YOUR_SERVER;Database=Foursat_CMS;..."
-}
-```
-
-### 3. Apply Migrations
-```bash
-cd CMSMicroservice.WebApi
-dotnet ef database update
-```
-
-### 4. Configure Notifications (Optional)
-See [Email/SMS Configuration Guide](docs/email-sms-configuration-guide.md)
-
-### 5. Run
-```bash
-dotnet run --urls="http://localhost:5133"
-```
-
-### 6. Access Endpoints
- **Health**: http://localhost:5133/health
- **Hangfire Dashboard**: http://localhost:5133/hangfire
- **gRPC**: localhost:5133 (HTTP/2)
-
---
-
-## 🔧 Configuration
-
-### Email (SMTP)
-```json
-"Email": {
-  "Enabled": true,
-  "SmtpHost": "smtp.gmail.com",
-  "SmtpPort": 587,
-  "SmtpUsername": "your-email@gmail.com",
-  "SmtpPassword": "your-gmail-app-password",
-  "FromEmail": "noreply@foursat.com",
-  "FromName": "FourSat CMS",
-  "EnableSsl": true
-}
-```
-
-### SMS (Kavenegar)
-```json
-"Sms": {
-  "Enabled": true,
-  "Provider": "Kavenegar",
-  "KavenegarApiKey": "YOUR_API_KEY",
-  "Sender": "10008663"
-}
-```
-
-### Background Worker
-```csharp
-// Cron: "5 0 * * 0" = Every Sunday at 00:05 UTC
-RecurringJob.AddOrUpdate<WeeklyCommissionJob>(
-    "weekly-commission-calculation",
-    job => job.ExecuteAsync(CancellationToken.None),
-    "5 0 * * 0");
-```
-
---
-
-## 🧪 Testing
-
-### Manual Trigger (via API)
-```bash
-# Trigger weekly calculation immediately
-curl -X POST http://localhost:5133/api/admin/trigger-weekly-calculation
-
-# Trigger recurring job now
-curl -X POST http://localhost:5133/api/admin/trigger-recurring-job-now
-
-# Get recurring jobs status
-curl http://localhost:5133/api/admin/recurring-jobs-status
-```
-
-### Health Checks
-```bash
-curl http://localhost:5133/health         # Overall health
-curl http://localhost:5133/health/ready   # Readiness probe (K8s)
-curl http://localhost:5133/health/live    # Liveness probe (K8s)
-```
-
---
-
-## 📊 What's Remaining?
-
-### High Priority
-1. **Payment Gateway Integration** (Phase 10 - 1 week)
-   - Daya API integration (فقط برای Payout)
-   - IBAN transfer automation
-   - Admin approval UI in BackOffice
-
-2. **Production Configuration** (30 minutes)
-   - Gmail App Password setup
-   - Kavenegar API key registration
-   - Update `appsettings.Production.json`
-
-### Medium Priority
-3. **Club Shop Integration** (Phase 9 - 2 weeks)
-   - Product catalog for club memberships
-   - Shopping cart integration
-   - Auto-activation on purchase
-
-### Low Priority
-4. **Testing** (Phase 7 - Postponed)
-   - Unit tests for business logic
-   - Integration tests for API
-   - Load testing for background worker
-
-### Optional Enhancements
- Redis distributed locks (multi-server deployment)
- Sentry error tracking (API key needed)
- Slack notifications (webhook needed)
- FCM push notifications
-
---
-
-## 🎯 MVP Features (100% Complete)
-
-✅ Binary network tree with automatic placement  
-✅ Club membership (Member/Trial) with different commission rates  
-✅ Weekly commission calculation (Lesser Leg algorithm)  
-✅ Background worker with Hangfire (cron scheduling)  
-✅ Balance carryover logic (rollover unused volumes)  
-✅ MaxWeeklyBalances cap enforcement  
-✅ Health check endpoints (Kubernetes-ready)  
-✅ Manual trigger API (admin control)  
-✅ Email + SMS notifications (MailKit + Kavenegar)  
-✅ Retry logic with exponential backoff (Polly)  
-✅ Audit trail (WorkerExecutionLog, History tables)  
-✅ Structured logging (AlertService for Sentry/Slack)  
-✅ JWT authentication context (CurrentUserService)  
-
---
-
-## 👥 Team
-
-**Development**: FourSat Team  
-**Last Updated**: 2025-12-01
-
---
-
-## 📝 License
-
-Proprietary - FourSat Company
@@ -1,411 +0,0 @@
-# CMS API Coverage - مقایسه CMS با BackOffice.BFF
-
-**تاریخ بررسی**: 2025-12-01  
-**هدف**: شناسایی APIهای CMS که در BackOffice.BFF پوشش داده نشده‌اند
-
---
-
-## 📊 خلاصه وضعیت
-
-| دسته | تعداد Proto در CMS | پوشش در BFF | وضعیت |
-|------|-------------------|--------------|--------|
-| **User Management** | 1 | ✅ کامل | 100% |
-| **Network & Tree** | 1 | ✅ کامل | 100% |
-| **Club Membership** | 1 | ✅ کامل | 100% |
-| **Commission & Wallet** | 3 | ✅ کامل | 100% |
-| **Products** | 6 | ⚠️ جزئی | 70% |
-| **Orders** | 2 | ⚠️ جزئی | 60% |
-| **Configuration** | 1 | ✅ کامل | 100% |
-| **Roles & Permissions** | 2 | ✅ کامل | 100% |
-| **Cart** | 1 | ❌ خیر | 0% |
-| **Transactions** | 1 | ❌ خیر | 0% |
-| **Contracts** | 2 | ❌ خیر | 0% |
-| **OTP** | 1 | ✅ کامل | 100% |
-| **Public Messages** | 1 | ❌ خیر | 0% |
-
---
-
-## ✅ APIهای کامل پوشش داده شده (در BFF موجود است)
-
-### 1. User Management (`user.proto`)
- ✅ CreateNewUserCommand
- ✅ UpdateUserCommand
- ✅ DeleteUserCommand
- ✅ GetAllUserByFilterQuery
- ✅ GetUserQuery
- ✅ SendOtpCommand
- ✅ VerifyOtpCodeCommand
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: همه عملیات
- Admin: Create, Update, GetAll, Get (بدون Delete)
- Inspector: فقط GetAll, Get
-
---
-
-### 2. Network Management (`networkmembership.proto`)
- ✅ GetNetworkTreeQuery
- ✅ GetNetworkHistoryQuery
- ✅ GetNetworkStatisticsQuery
- ✅ GetUserNetworkInfoQuery
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: همه
- Admin: همه
- Inspector: فقط مشاهده (همه)
-
---
-
-### 3. Club Membership (`clubmembership.proto`)
- ✅ ActivateClubCommand
- ✅ GetAllClubMembersQuery
- ✅ GetClubStatisticsQuery
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: همه
- Admin: ActivateClub, GetAll, Get
- Inspector: فقط GetAll, Get
-
---
-
-### 4. Commission & Balance (`commission.proto`, `userwallet.proto`, `userwalletchangelog.proto`)
- ✅ GetAllWeeklyPoolsQuery
- ✅ GetWeeklyPoolQuery
- ✅ GetUserWeeklyBalancesQuery
- ✅ GetUserPayoutsQuery
- ✅ ApproveWithdrawalCommand
- ✅ RejectWithdrawalCommand
- ✅ ProcessWithdrawalCommand
- ✅ GetWithdrawalRequestsQuery
- ✅ TriggerWeeklyCalculationCommand (Worker)
- ✅ GetWorkerStatusQuery
- ✅ GetWorkerExecutionLogsQuery
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: همه عملیات + Trigger Worker
- Admin: Approve/Reject Withdrawal, GetAll queries
- Inspector: فقط Get queries (بدون Approve/Reject)
-
---
-
-### 5. Configuration (`configuration.proto`)
- ✅ CreateOrUpdateConfigurationCommand
- ✅ DeactivateConfigurationCommand
- ✅ GetAllConfigurationsQuery
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: همه عملیات
- Admin: فقط GetAll (بدون Update)
- Inspector: فقط GetAll
-
---
-
-### 6. Roles & Permissions (`role.proto`, `userrole.proto`)
- ✅ CreateNewRoleCommand
- ✅ UpdateRoleCommand
- ✅ DeleteRoleCommand
- ✅ GetAllRoleByFilterQuery
- ✅ GetRoleQuery
- ✅ CreateNewUserRoleCommand
- ✅ UpdateUserRoleCommand
- ✅ DeleteUserRoleCommand
- ✅ GetAllUserRoleByFilterQuery
- ✅ GetUserRoleQuery
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: همه عملیات
- Admin: ❌ هیچ دسترسی (فقط SuperAdmin)
- Inspector: ❌ هیچ دسترسی
-
---
-
-## ⚠️ APIهای جزئی پوشش داده شده
-
-### 7. Products (`products.proto`, `category.proto`, `tag.proto`, `package.proto`, `productgallerys.proto`, `productimages.proto`)
-
-#### ✅ موجود در BFF:
- CreateNewProductsCommand
- UpdateProductsCommand
- DeleteProductsCommand
- GetAllProductsByFilterQuery
- GetProductsQuery
- GetProductsForCategoryQuery
- AddProductImageCommand
- RemoveProductImageCommand
- GetProductGalleryQuery
-
-#### ⚠️ موجود در CMS ولی نه در BFF:
-```
-Products:
-  - BulkUpdateProductsCommand (به‌روزرسانی دسته‌ای)
-  - GetProductBySkuQuery (جستجو با SKU)
-  - ToggleProductStatusCommand (فعال/غیرفعال)
-  - GetLowStockProductsQuery (محصولات کم موجودی)
-
-Category:
-  - CreateNewCategoryCommand ✅
-  - UpdateCategoryCommand ✅
-  - DeleteCategoryCommand ✅
-  - GetAllCategoryByFilterQuery ✅
-  - GetCategoriesQuery ✅
-  - GetCategoryQuery ✅
-  - UpdateCategoryProductsCommand ✅ (ارتباط Product-Category)
-  - UpdateProductCategoriesCommand ✅
-
-Tags:
-  - CreateTagCommand ❌
-  - UpdateTagCommand ❌
-  - DeleteTagCommand ❌
-  - GetAllTagsQuery ❌
-  - AssignTagToProductCommand ❌ (ارتباط Product-Tag)
-
-Package (بسته‌بندی):
-  - CreateNewPackageCommand ✅
-  - UpdatePackageCommand ✅
-  - DeletePackageCommand ✅
-  - GetAllPackageByFilterQuery ✅
-  - GetPackageQuery ✅
-```
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: همه عملیات
- Admin: همه عملیات محصولات (Create, Update, Delete)
- Inspector: فقط Get queries
-
---
-
-### 8. Orders (`userorder.proto`, `factordetails.proto`)
-
-#### ✅ موجود در BFF:
- CreateNewUserOrderCommand
- UpdateUserOrderCommand
- DeleteUserOrderCommand
- GetAllUserOrderByFilterQuery
- GetUserOrderQuery
-
-#### ⚠️ موجود در CMS ولی نه در BFF:
-```
-UserOrder:
-  - CancelOrderCommand (لغو سفارش)
-  - UpdateOrderStatusCommand (تغییر وضعیت)
-  - GetOrderByInvoiceNumberQuery (جستجو با شماره فاکتور)
-  - GetOrdersByDateRangeQuery (گزارش بازه زمانی)
-  - CalculateOrderPVQuery (محاسبه PV سفارش)
-  - ApplyDiscountToOrderCommand (اعمال تخفیف)
-
-FactorDetails:
-  - GetFactorDetailsQuery (جزئیات کامل فاکتور)
-  - UpdateFactorDetailCommand (ویرایش آیتم فاکتور)
-  - RemoveFactorDetailCommand (حذف آیتم فاکتور)
-```
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: همه عملیات
- Admin: همه عملیات (Create, Update, Cancel, Status)
- Inspector: فقط Get queries
-
---
-
-## ❌ APIهای بدون پوشش (باید اضافه شوند)
-
-### 9. Shopping Cart (`usercarts.proto`)
-**وضعیت**: هیچ Handler در BFF وجود ندارد
-
-```
-باید اضافه شود:
-  - AddToCartCommand
-  - UpdateCartItemCommand
-  - RemoveFromCartCommand
-  - GetUserCartQuery
-  - ClearCartCommand
-  - MergeCartCommand (برای کاربران مهمان → لاگین)
-```
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: مشاهده سبد همه کاربران
- Admin: مشاهده سبد همه کاربران
- Inspector: مشاهده فقط (بدون ویرایش)
-
-**اولویت**: 🟡 متوسط (برای فروشگاه ضروری است)
-
---
-
-### 10. Transactions (`transactions.proto`)
-**وضعیت**: هیچ Handler در BFF وجود ندارد
-
-```
-باید اضافه شود:
-  - CreateTransactionCommand (ثبت تراکنش پرداخت)
-  - GetTransactionQuery
-  - GetAllTransactionsByFilterQuery
-  - GetTransactionByReferenceQuery (جستجو با شماره پیگیری)
-  - GetUserTransactionsQuery (تراکنش‌های یک کاربر)
-  - VerifyTransactionCommand (تأیید پرداخت از درگاه)
-  - RefundTransactionCommand (بازگشت وجه)
-```
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: همه عملیات + Refund
- Admin: مشاهده تراکنش‌ها (بدون Refund)
- Inspector: فقط مشاهده
-
-**اولویت**: 🔴 بالا (برای درگاه پرداخت ضروری است)
-
---
-
-### 11. Contracts (`contract.proto`, `usercontract.proto`)
-**وضعیت**: هیچ Handler در BFF وجود ندارد
-
-```
-باید اضافه شود:
-Contract:
-  - CreateContractCommand
-  - UpdateContractCommand
-  - DeleteContractCommand
-  - GetAllContractsQuery
-  - GetContractQuery
-  - ActivateContractCommand
-  - DeactivateContractCommand
-
-UserContract:
-  - AssignContractToUserCommand
-  - GetUserContractsQuery
-  - GetContractUsersQuery
-  - RevokeUserContractCommand
-```
-
-**توضیح**: Contracts احتمالاً برای قراردادهای عضویت یا خریدهای خاص است.
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: همه عملیات
- Admin: Assign, Get queries
- Inspector: فقط Get queries
-
-**اولویت**: 🟢 پایین (در صورت نیاز بیزینسی)
-
---
-
-### 12. Public Messages (`public_messages.proto`)
-**وضعیت**: هیچ Handler در BFF وجود ندارد
-
-```
-باید اضافه شود:
-  - CreatePublicMessageCommand (ایجاد اعلان عمومی)
-  - UpdatePublicMessageCommand
-  - DeletePublicMessageCommand
-  - GetAllPublicMessagesQuery
-  - GetPublicMessageQuery
-  - PublishMessageCommand (انتشار اعلان)
-  - ArchiveMessageCommand (بایگانی)
-```
-
-**توضیح**: پیام‌های عمومی برای اطلاع‌رسانی به تمام کاربران
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: همه عملیات
- Admin: Create, Update, Publish
- Inspector: فقط Get queries
-
-**اولویت**: 🟡 متوسط
-
---
-
-### 13. User Address (`useraddress.proto`)
-**وضعیت**: در BFF موجود است ✅
-
- ✅ CreateNewUserAddressCommand
- ✅ UpdateUserAddressCommand
- ✅ DeleteUserAddressCommand
- ✅ GetAllUserAddressByFilterQuery
- ✅ GetUserAddressQuery
-
---
-
-## 📋 خلاصه کارهای باقی‌مانده در CMS
-
-### 🔴 اولویت بالا (برای Launch ضروری):
-1. **Transactions** - درگاه پرداخت
-   - زمان: 3 روز
-   - Commands: 7 مورد
-   - ✅ داکیومنت: در `REMAINING-TASKS.md`
-
-### 🟡 اولویت متوسط (برای فروشگاه):
-2. **Shopping Cart**
-   - زمان: 2 روز
-   - Commands: 6 مورد
-   
-3. **Public Messages**
-   - زمان: 1 روز
-   - Commands: 6 مورد
-   
-4. **Products (تکمیل)**
-   - Tags Management
-   - Bulk Operations
-   - Low Stock Alerts
-   - زمان: 2 روز
-
-5. **Orders (تکمیل)**
-   - Cancel/Status/Discount
-   - Reports
-   - زمان: 2 روز
-
-### 🟢 اولویت پایین:
-6. **Contracts** (در صورت نیاز بیزینسی)
-   - زمان: 2 روز
-
---
-
-## 🎯 نقشه راه پیشنهادی
-
-### هفته 1: Transaction System (درگاه پرداخت)
- CMS: 7 Command/Query
- BFF: 7 Handler
- BackOffice: صفحه تراکنش‌ها
- ✅ داکیومنت
-
-### هفته 2: Shopping Cart
- CMS: 6 Command/Query
- BFF: 6 Handler
- BackOffice: صفحه مدیریت سبدهای خرید کاربران
- ✅ داکیومنت
-
-### هفته 3: Products & Orders تکمیل
- Tags Management
- Bulk Operations
- Order Cancel/Status
- ✅ داکیومنت
-
-### هفته 4: Public Messages
- Create/Publish Messages
- Notification System
- ✅ داکیومنت
-
---
-
-## 📊 تخمین زمان کل
-
-| فیچر | CMS | BFF | BackOffice | جمع |
-|------|-----|-----|------------|-----|
-| Transactions | 3 روز | 2 روز | 2 روز | **1 هفته** |
-| Shopping Cart | 2 روز | 1 روز | 2 روز | **1 هفته** |
-| Products/Orders تکمیل | 2 روز | 1 روز | 2 روز | **1 هفته** |
-| Public Messages | 1 روز | 1 روز | 1 روز | **3 روز** |
-| **جمع کل** | | | | **3.5 هفته** |
-
---
-
-## ✅ چک‌لیست قبل از شروع هر فیچر
-
- [ ] بیزینس در `network-club-commission-system-v1.1.md` مستند شده؟
- [ ] Proto file در CMS تعریف شده؟
- [ ] Commands/Queries در CMS پیاده‌سازی شده؟
- [ ] Migration اجرا شده؟
- [ ] Handlers در BFF اضافه شده؟
- [ ] Controllers در BFF تعریف شده؟
- [ ] صفحات در BackOffice ایجاد شده؟
- [ ] تست‌های دستی انجام شده؟
- [ ] ✅ داکیومنت نهایی (مقایسه کد با داکیومنت)
-
---
-
-**آخرین به‌روزرسانی**: 2025-12-01
@@ -1,281 +0,0 @@
-# Club Membership Migration Scripts
-
-**Created**: 2025-12-09  
-**Purpose**: مهاجرت کاربران موجود به سیستم باشگاه مشتریان  
-**Location**: `/dbbkup/`
-
---
-
-## 📋 Overview
-
-این اسکریپت‌ها کاربرانی که قبل از راه‌اندازی سیستم باشگاه مشتریان، مبلغ 56 میلیون ریال شارژ کرده‌اند را به‌طور خودکار عضو باشگاه می‌کنند.
-
---
-
-## 📄 Scripts
-
-### 1. MigrateUsersToClubMembership.sql (نسخه کامل)
-
-**Path**: `/dbbkup/MigrateUsersToClubMembership.sql`
-
-**Features**:
- ✅ بررسی `UserWalletChangeLogs` برای محاسبه مجموع شارژ‌ها
- ✅ Fallback به `Transactions` اگر Logs خالی بود
- ✅ ثبت تاریخ دقیق اولین شارژ به‌عنوان `ActivatedAt`
- ✅ Skip کاربرانی که قبلاً عضو باشگاه هستند
- ✅ Transaction-safe (هر کاربر یک transaction جداگانه)
- ✅ گزارش کامل (موفقیت‌ها + خطاها)
-
-**What It Does**:
-```sql
-- برای هر کاربر با شارژ >= 56M:
-1. INSERT INTO ClubMemberships (UserId, ActivatedAt=FirstChargeDate, InitialContribution=25M)
-2. INSERT INTO ClubMembershipHistories (Action=0, Reason='فعال‌سازی خودکار - مهاجرت')
-3. INSERT INTO UserClubFeatures (ClubFeatureId IN (1,2,3,4), Notes='اعطا شده خودکار')
-```
-
-**Sample Output**:
-```
-╔═══════════════════════════════════════════════════════════════╗
-║      شروع فرآیند انتقال کاربران به باشگاه مشتریان           ║
-╚═══════════════════════════════════════════════════════════════╝
-
-تاریخ و زمان اجرا: 2025-12-09 16:30:00.0000000
-مبلغ سهم استخر: 25,000,000 ریال
-
-─────────────────────────────────────────────────────────────────
-📊 تعداد کاربران کاندید: 45
-─────────────────────────────────────────────────────────────────
-🔄 شروع ثبت عضویت‌ها...
-
-✓ کاربر 1001 (علی محمدی - 1234567890): عضویت با ID 501 ایجاد شد.
-✓ کاربر 1002 (سارا احمدی - 0987654321): عضویت با ID 502 ایجاد شد.
-...
-
-─────────────────────────────────────────────────────────────────
-╔═══════════════════════════════════════════════════════════════╗
-║                    گزارش نهایی مهاجرت                        ║
-╚═══════════════════════════════════════════════════════════════╝
-
-تعداد کل کاندیدها: 45
-تعداد قبلاً عضو: 0
-تعداد پردازش شده: 45
-تعداد خطا: 0
-مجموع سهم استخر: 1,125,000,000 ریال
-
-✓ فرآیند مهاجرت با موفقیت به پایان رسید.
-```
-
---
-
-### 2. MigrateUsersToClubMembership_Simple.sql (نسخه ساده)
-
-**Path**: `/dbbkup/MigrateUsersToClubMembership_Simple.sql`
-
-**Features**:
- ✅ بررسی موجودی فعلی (`UserWallets.Balance` >= 56M)
- ✅ سریع‌تر از نسخه کامل
- ✅ برای سیستم‌هایی که تاریخچه شارژ ندارند
- ✅ همان Transaction safety
-
-**Difference**:
-```sql
-- نسخه کامل:
-SUM(uwcl.ChangeValue) >= 56000000  -- از تاریخچه
-
-- نسخه ساده:
-uw.Balance >= 56000000             -- از موجودی فعلی
-```
-
---
-
-## 🔧 Technical Details
-
-### Transaction Strategy
-
-**قبلی (اشتباه)**:
-```sql
-BEGIN TRANSACTION;  -- یک transaction بزرگ
-  -- 100 INSERT...
-COMMIT TRANSACTION;
-```
-❌ با cursor سازگار نیست! → `log file overflow`
-
-**فعلی (صحیح)**:
-```sql
-WHILE @@FETCH_STATUS = 0
-BEGIN
-    BEGIN TRANSACTION;     -- transaction جداگانه
-      INSERT ClubMemberships;
-      INSERT ClubMembershipHistories;
-      INSERT UserClubFeatures (4 rows);
-    COMMIT TRANSACTION;    -- برای هر کاربر
-END
-```
-✅ هر کاربر مستقل → اگر یکی خطا داد، بقیه commit می‌شوند
-
---
-
-### Schema Compatibility
-
-**تغییرات از Schema واقعی**:
-1. ❌ حذف `User.ClubMembershipId` (این ستون وجود نداره!)
-2. ✅ رابطه: `ClubMemberships.UserId → Users.Id` (یک‌طرفه)
-3. ✅ `Action` از نوع `INT` است (نه `NVARCHAR`):
-   - `0` = Activated
-   - `1` = Deactivated
-
-**Unicode Encoding**:
-```sql
-- اشتباه (encoding خراب):
-N'فارسی'  -- در SELECT باز هم خراب می‌شه!
-
-- درست:
-CAST(N'فعال‌سازی خودکار' AS NVARCHAR(500))
-```
-
---
-
-## 📊 Data Flow
-
-```
-┌─────────────────────────────────────────────────────────┐
-│  1. Query: Users with TotalCharge >= 56M               │
-│     Sources: UserWalletChangeLogs OR Transactions      │
-└─────────────────────────────────────────────────────────┘
-                        ↓
-┌─────────────────────────────────────────────────────────┐
-│  2. Filter: Skip users already in ClubMemberships      │
-└─────────────────────────────────────────────────────────┘
-                        ↓
-┌─────────────────────────────────────────────────────────┐
-│  3. For Each User (in cursor):                         │
-│     BEGIN TRANSACTION                                   │
-│     ├─ INSERT ClubMembership                           │
-│     │    (UserId, ActivatedAt=FirstCharge,             │
-│     │     InitialContribution=25M)                     │
-│     ├─ INSERT ClubMembershipHistory                    │
-│     │    (Action=0, Reason='مهاجرت داده‌ها')           │
-│     └─ INSERT UserClubFeatures (x4)                    │
-│         (ClubFeatureId IN (1,2,3,4))                   │
-│     COMMIT TRANSACTION                                  │
-└─────────────────────────────────────────────────────────┘
-                        ↓
-┌─────────────────────────────────────────────────────────┐
-│  4. Report: Success count, Errors, Summary             │
-└─────────────────────────────────────────────────────────┘
-```
-
---
-
-## ⚙️ Configuration Variables
-
-```sql
-DECLARE @InitialContribution BIGINT = 25000000;  -- 25M به صندوق
-DECLARE @ChargeAmount BIGINT = 56000000;         -- 56M شارژ
-DECLARE @CurrentDateTime DATETIME2(7) = SYSDATETIME();
-```
-
-**Adjustable**:
- `@ChargeAmount`: تغییر حداقل مبلغ شارژ
- `@InitialContribution`: تغییر سهم استخر
-
---
-
-## 🧪 Testing Queries
-
-### 1. شمارش کاربران واجد شرایط
-
-```sql
-- نسخه کامل:
-SELECT COUNT(DISTINCT u.Id)
-FROM [CMS].[Users] u
-INNER JOIN [CMS].[UserWallets] uw ON uw.UserId = u.Id
-INNER JOIN [CMS].[UserWalletChangeLogs] uwcl ON uwcl.WalletId = uw.Id
-WHERE u.IsDeleted = 0
-  AND uwcl.IsIncrease = 1
-  AND uwcl.ChangeValue > 0
-GROUP BY u.Id
-HAVING SUM(uwcl.ChangeValue) >= 56000000;
-
-- نسخه ساده:
-SELECT COUNT(*)
-FROM [CMS].[Users] u
-INNER JOIN [CMS].[UserWallets] uw ON uw.UserId = u.Id
-LEFT JOIN [CMS].[ClubMemberships] cm ON cm.UserId = u.Id
-WHERE u.IsDeleted = 0
-  AND cm.Id IS NULL
-  AND uw.Balance >= 56000000;
-```
-
-### 2. تأیید ویژگی‌های ثبت شده
-
-```sql
-SELECT 
-    cm.Id AS MembershipId,
-    cm.UserId,
-    u.FirstName + ' ' + u.LastName AS FullName,
-    cm.ActivatedAt,
-    COUNT(ucf.Id) AS FeaturesCount
-FROM [CMS].[ClubMemberships] cm
-INNER JOIN [CMS].[Users] u ON u.Id = cm.UserId
-LEFT JOIN [CMS].[UserClubFeatures] ucf ON ucf.ClubMembershipId = cm.Id
-WHERE cm.Created >= '2025-12-09'  -- امروز
-GROUP BY cm.Id, cm.UserId, u.FirstName, u.LastName, cm.ActivatedAt
-HAVING COUNT(ucf.Id) != 4;  -- باید 4 تا باشه!
-```
-
-### 3. چک کردن History
-
-```sql
-SELECT 
-    h.UserId,
-    u.FirstName + ' ' + u.LastName AS FullName,
-    h.Action,
-    h.Reason,
-    h.Created
-FROM [CMS].[ClubMembershipHistories] h
-INNER JOIN [CMS].[Users] u ON u.Id = h.UserId
-WHERE h.CreatedBy = 'MigrationScript'
-ORDER BY h.Created DESC;
-```
-
---
-
-## 🚨 Error Handling
-
-**Script Behavior**:
- ✅ هر transaction جداگانه → اگر یک کاربر fail شد، بقیه commit می‌شوند
- ✅ خطاها در `@ProcessLog` ذخیره می‌شوند
- ✅ گزارش نهایی شامل لیست کامل خطاها
-
-**Common Errors**:
-1. **"Invalid column 'UserName'"** → ستون وجود نداره (باید `FirstName + LastName`)
-2. **"Invalid column 'ClubMembershipId'"** → در جدول `Users` نیست
-3. **"Conversion failed 'Activated'"** → باید `0` باشه نه `'Activated'`
-4. **"Transaction cannot be committed"** → نباید `SET XACT_ABORT ON` باشه با cursor
-
---
-
-## 📝 Notes
-
-1. **Idempotent**: اجرای مجدد اسکریپت، کاربران قبلی را skip می‌کند
-2. **Rollback-Safe**: اگر کل script fail شد، چیزی commit نمی‌شه
-3. **Performance**: برای 1000+ کاربر، ممکنه 5-10 دقیقه طول بکشه
-4. **Logging**: تمام عملیات‌ها با `CreatedBy = 'MigrationScript'` قابل شناسایی هستند
-
---
-
-## 🎯 Post-Migration Checklist
-
- [ ] شمارش کاربران مهاجرت شده = تعداد موردانتظار
- [ ] تمام اعضای جدید 4 ویژگی دارند (`UserClubFeatures.Count = 4`)
- [ ] همه `ClubMembershipHistories` با `Action = 0` ثبت شده‌اند
- [ ] مجموع `InitialContribution` با `ClubMemberships.Count × 25M` برابره
- [ ] هیچ خطایی در گزارش نهایی نیست (`@ErrorCount = 0`)
-
---
-
-**Last Updated**: 2025-12-09  
-**Author**: Migration Script Generator  
-**Version**: 1.0
@@ -1,310 +0,0 @@
-# مستندات سیستم کمیسیون (Commission System)
-
-> **آخرین بروزرسانی**: ۲۹ آذر ۱۴۰۴ (19 December 2025)
-
---
-
-## 📋 خلاصه
-
-سیستم کمیسیون مسئول محاسبه، ذخیره و پرداخت کمیسیون‌های کاربران بر اساس ساختار شبکه بازاریابی است.
-
---
-
-## 🗄️ موجودیت‌ها (Entities)
-
-### WeekDefinition
-جدول مرجع برای تعریف هفته‌های مالی:
-
-```csharp
-public class WeekDefinition : BaseAuditableEntity
-{
-    public int WeekOrder { get; set; }        // شماره ترتیبی هفته
-    public int Year { get; set; }             // سال میلادی
-    public int PersianYear { get; set; }      // سال شمسی
-    public DateTime StartDate { get; set; }    // تاریخ شروع
-    public DateTime EndDate { get; set; }      // تاریخ پایان
-    public string StartDatePersian { get; set; }  // تاریخ شروع شمسی
-    public string EndDatePersian { get; set; }    // تاریخ پایان شمسی
-    public bool IsActive { get; set; }         // آیا هفته جاری است
-}
-```
-
-### NetworkWeeklyBalance
-تعادل هفتگی شاخه چپ و راست کاربر:
-
-```csharp
-public class NetworkWeeklyBalance : BaseAuditableEntity
-{
-    public long UserId { get; set; }
-    public long WeekDefinitionId { get; set; }  // FK به WeekDefinition
-    public long LeftBalance { get; set; }       // امتیاز شاخه چپ
-    public long RightBalance { get; set; }      // امتیاز شاخه راست
-    
-    // Navigation Properties
-    public virtual User User { get; set; }
-    public virtual WeekDefinition WeekDefinition { get; set; }
-}
-```
-
-**Index**: `(UserId, WeekDefinitionId)` - Unique
-
-### WeeklyCommissionPool
-استخر کمیسیون هفتگی:
-
-```csharp
-public class WeeklyCommissionPool : BaseAuditableEntity
-{
-    public long WeekDefinitionId { get; set; }  // FK به WeekDefinition
-    public long TotalPoolAmount { get; set; }   // مجموع استخر
-    public long DistributedAmount { get; set; } // مقدار توزیع شده
-    public int TotalBalances { get; set; }      // تعداد کل تعادل‌ها
-    public long PerBalanceAmount { get; set; }  // مبلغ هر تعادل
-    public bool IsFinalized { get; set; }       // آیا نهایی شده
-    
-    // Navigation Property
-    public virtual WeekDefinition WeekDefinition { get; set; }
-}
-```
-
-### UserCommissionPayout
-رکورد پرداخت کمیسیون به کاربر:
-
-```csharp
-public class UserCommissionPayout : BaseAuditableEntity
-{
-    public long UserId { get; set; }
-    public long WeekDefinitionId { get; set; }  // FK به WeekDefinition
-    public int BalancesEarned { get; set; }     // تعداد تعادل‌های کسب شده
-    public long Amount { get; set; }            // مبلغ کمیسیون
-    public CommissionPayoutStatus Status { get; set; }  // وضعیت پرداخت
-    public DateTime? PaidAt { get; set; }       // تاریخ پرداخت
-    
-    // Navigation Properties
-    public virtual User User { get; set; }
-    public virtual WeekDefinition WeekDefinition { get; set; }
-}
-```
-
-**وضعیت‌ها (Status)**:
- `Created` - ایجاد شده
- `Paid` - پرداخت به کیف پول
- `WithdrawalRequested` - درخواست برداشت
- `Withdrawn` - برداشت شده
- `Cancelled` - لغو شده
-
-### CommissionPayoutHistory
-تاریخچه تغییرات وضعیت پرداخت:
-
-```csharp
-public class CommissionPayoutHistory : BaseAuditableEntity
-{
-    public long UserCommissionPayoutId { get; set; }
-    public long WeekDefinitionId { get; set; }  // FK به WeekDefinition
-    public CommissionPayoutStatus FromStatus { get; set; }
-    public CommissionPayoutStatus ToStatus { get; set; }
-    public string? Notes { get; set; }
-    
-    // Navigation Properties
-    public virtual UserCommissionPayout UserCommissionPayout { get; set; }
-    public virtual WeekDefinition WeekDefinition { get; set; }
-}
-```
-
-### WorkerExecutionLog
-لاگ اجرای Worker های محاسبه کمیسیون:
-
-```csharp
-public class WorkerExecutionLog : BaseAuditableEntity
-{
-    public string WorkerName { get; set; }       // نام Worker
-    public long? WeekDefinitionId { get; set; }  // FK به WeekDefinition (nullable)
-    public DateTime StartedAt { get; set; }       // زمان شروع
-    public DateTime? CompletedAt { get; set; }    // زمان پایان
-    public bool IsSuccess { get; set; }           // موفقیت
-    public string? ErrorMessage { get; set; }     // پیام خطا
-    public int ProcessedCount { get; set; }       // تعداد پردازش شده
-    
-    // Navigation Property
-    public virtual WeekDefinition? WeekDefinition { get; set; }
-}
-```
-
---
-
-## 🔗 روابط (Relationships)
-
-```
-WeekDefinition (1) ─────┬──── (*) NetworkWeeklyBalance
-                        ├──── (*) WeeklyCommissionPool
-                        ├──── (*) UserCommissionPayout
-                        ├──── (*) CommissionPayoutHistory
-                        └──── (*) WorkerExecutionLog
-
-User (1) ───────────────┬──── (*) NetworkWeeklyBalance
-                        └──── (*) UserCommissionPayout
-
-UserCommissionPayout (1) ──── (*) CommissionPayoutHistory
-```
-
---
-
-## 📡 Proto Models
-
-### UserCommissionPayoutModel
-```protobuf
-message UserCommissionPayoutModel {
-    int64 id = 1;
-    int64 user_id = 2;
-    string user_full_name = 3;
-    int64 week_definition_id = 4;      // شناسه هفته
-    int32 balances_earned = 5;          // تعداد تعادل
-    int64 amount = 6;                   // مبلغ
-    int32 status = 7;                   // وضعیت
-    google.protobuf.Timestamp paid_at = 8;
-    google.protobuf.Timestamp created = 9;
-    string mobile = 10;
-    string week_display_name = 11;      // نام نمایشی هفته
-}
-```
-
-### UserWeeklyBalanceModel
-```protobuf
-message UserWeeklyBalanceModel {
-    int64 user_id = 1;
-    int64 week_definition_id = 2;       // شناسه هفته
-    int64 left_balance = 3;
-    int64 right_balance = 4;
-    string start_date_persian = 5;
-    string end_date_persian = 6;
-    int32 year = 7;
-    int32 week_order = 8;
-    bool is_active = 9;
-    string week_display_name = 10;      // نام نمایشی هفته
-}
-```
-
---
-
-## 🎯 نام‌گذاری فیلدها
-
-### قبل از مایگریشن (Legacy)
-```
-WeekNumber: "2025-01" (string)
-GregorianWeekNumber: "2025-01" (string)
-PersianWeekNumber: "1403-40" (string)
-WeekLabel: "هفته 1 - 1403/10/01"
-```
-
-### بعد از مایگریشن (Current)
-```
-WeekDefinitionId: 42 (long)           // FK به جدول WeekDefinition
-WeekDisplayName: "هفته 1 - 1403/10/01" // ساخته شده از WeekDefinition
-```
-
-**فرمول WeekDisplayName**:
-```csharp
-$"هفته {WeekDefinition.WeekOrder} - {WeekDefinition.StartDatePersian}"
-```
-
---
-
-## 📊 Query Examples
-
-### دریافت کمیسیون‌های کاربر
-```csharp
-var payouts = await _context.UserCommissionPayouts
-    .Include(p => p.WeekDefinition)
-    .Where(p => p.UserId == userId)
-    .OrderByDescending(p => p.WeekDefinition.WeekOrder)
-    .Select(p => new {
-        p.Id,
-        p.WeekDefinitionId,
-        WeekDisplayName = $"هفته {p.WeekDefinition.WeekOrder} - {p.WeekDefinition.StartDatePersian}",
-        p.BalancesEarned,
-        p.Amount,
-        p.Status
-    })
-    .ToListAsync();
-```
-
-### دریافت تعادل هفتگی
-```csharp
-var balance = await _context.NetworkWeeklyBalances
-    .Include(b => b.WeekDefinition)
-    .Where(b => b.UserId == userId && b.WeekDefinitionId == weekDefinitionId)
-    .Select(b => new {
-        b.WeekDefinitionId,
-        WeekDisplayName = $"هفته {b.WeekDefinition.WeekOrder} - {b.WeekDefinition.StartDatePersian}",
-        b.LeftBalance,
-        b.RightBalance,
-        b.WeekDefinition.StartDatePersian,
-        b.WeekDefinition.EndDatePersian
-    })
-    .FirstOrDefaultAsync();
-```
-
---
-
-## ⚠️ ملاحظات مایگریشن
-
-### EF Migration
-```bash
-# ایجاد migration
-dotnet ef migrations add MigrateWeekNumberToWeekDefinitionId \
-    -p CMSMicroservice.Infrastructure \
-    -s CMSMicroservice.WebApi
-
-# اجرای migration
-dotnet ef database update \
-    -p CMSMicroservice.Infrastructure \
-    -s CMSMicroservice.WebApi
-```
-
-### Data Migration Script
-```sql
-- Step 1: Add new column
-ALTER TABLE NetworkWeeklyBalances ADD WeekDefinitionId BIGINT NULL;
-
-- Step 2: Populate from WeekDefinitions
-UPDATE nwb
-SET nwb.WeekDefinitionId = wd.Id
-FROM NetworkWeeklyBalances nwb
-INNER JOIN WeekDefinitions wd ON 
-    CONCAT(wd.Year, '-', RIGHT('0' + CAST(wd.WeekOrder AS VARCHAR), 2)) = nwb.WeekNumber;
-
-- Step 3: Add FK constraint
-ALTER TABLE NetworkWeeklyBalances 
-ADD CONSTRAINT FK_NetworkWeeklyBalances_WeekDefinitions 
-FOREIGN KEY (WeekDefinitionId) REFERENCES WeekDefinitions(Id);
-
-- Step 4: Drop old column (after verification)
-ALTER TABLE NetworkWeeklyBalances DROP COLUMN WeekNumber;
-```
-
---
-
-## 📝 تغییرات API
-
-### Request Changes
-```
-// قبل
-GET /api/commission/payouts?weekNumber=2025-01
-
-// بعد
-GET /api/commission/payouts?weekDefinitionId=42
-```
-
-### Response Changes
-```json
-// قبل
-{
-  "weekNumber": "2025-01",
-  "weekLabel": "هفته 1 - 1403/10/01"
-}
-
-// بعد
-{
-  "weekDefinitionId": 42,
-  "weekDisplayName": "هفته 1 - 1403/10/01"
-}
-```
@@ -1,344 +0,0 @@
-# Daya Loan API Implementation - Complete Guide
-
-**تاریخ تکمیل**: December 6, 2025  
-**وضعیت**: ✅ 100% Complete - Production Ready  
-**نسخه**: Real API v1.0
-
---
-
-## 📋 خلاصه تغییرات
-
-### قبل از این به‌روزرسانی:
- ❌ CheckDayaLoanStatusCommandHandler: Skeleton با TODO
- ❌ DayaLoanApiService: NotImplementedException
- ✅ MockDayaLoanApiService: فقط برای تست
-
-### بعد از این به‌روزرسانی:
- ✅ DayaLoanApiService: کاملاً پیاده‌سازی شده
- ✅ HttpClient configuration: با authentication و timeout
- ✅ Status mapping: Persian descriptions → Enum
- ✅ Error handling: کامل با fallback
- ✅ Configuration: Switchable Mock/Real via appsettings
-
---
-
-## 🔧 فایل‌های تغییر یافته
-
-### 1. DayaLoanApiService.cs
-**مسیر**: `CMS/src/CMSMicroservice.Infrastructure/Services/DayaLoanApiService.cs`
-
-**تغییرات**:
-```csharp
-// BEFORE:
-public async Task<List<DayaLoanCheckResult>> CheckLoanStatusAsync(...)
-{
-    throw new NotImplementedException("TODO: Implement real Daya API");
-}
-
-// AFTER: (~250 lines of implementation)
- Request/Response Models با JsonPropertyName
- HTTP POST به /api/merchant/contracts
- Status mapping logic
- Error handling با empty results
- Multiple contracts handling (takes latest)
-```
-
-**Models اضافه شده**:
- `DayaContractsRequest`: NationalCodes list
- `DayaContractsResponse`: Succeed, Code, Message, Data
- `DayaContractData`: NationalCode, ContractNumber, StatusDescription, DateTime
-
-**متدهای کلیدی**:
- `CheckLoanStatusAsync`: Main entry point
- `MapApiResponseToResults`: Convert API response to domain results
- `MapStatusDescription`: Persian text → DayaLoanStatus enum
- `CreateEmptyResults`: Fallback for errors
-
---
-
-### 2. ConfigureServices.cs
-**مسیر**: `CMS/src/CMSMicroservice.Infrastructure/ConfigureServices.cs`
-
-**تغییرات**:
-```csharp
-// BEFORE:
-services.AddScoped<IDayaLoanApiService, MockDayaLoanApiService>();
-
-// AFTER:
-var useMock = configuration.GetValue<bool>("DayaApi:UseMock");
-if (useMock)
-{
-    services.AddScoped<IDayaLoanApiService, MockDayaLoanApiService>();
-}
-else
-{
-    services.AddHttpClient<IDayaLoanApiService, DayaLoanApiService>((sp, client) =>
-    {
-        var config = sp.GetRequiredService<IConfiguration>();
-        client.BaseAddress = new Uri(config["DayaApi:BaseAddress"]!);
-        client.DefaultRequestHeaders.Add("merchant-permission-key", 
-            config["DayaApi:MerchantPermissionKey"]);
-        client.Timeout = TimeSpan.FromSeconds(30);
-    })
-    .SetHandlerLifetime(TimeSpan.FromMinutes(5));
-}
-```
-
-**ویژگی‌های HttpClient**:
- BaseAddress: Dynamic from config
- Authentication: merchant-permission-key header
- Timeout: 30 seconds
- Handler Lifetime: 5 minutes (connection pooling)
-
---
-
-### 3. appsettings.json
-**مسیر**: `CMS/src/CMSMicroservice.WebApi/appsettings.json`
-
-**بخش اضافه شده**:
-```json
-{
-  "DayaApi": {
-    "UseMock": false,
-    "BaseAddress": "https://testdaya.tadbirandishan.com",
-    "MerchantPermissionKey": "14752708$Db5Wk5hnhKO4FGuoKBUZIvHW5WO1NpCxYNy_sy8epfQ-d6n6vjeZJa6EnTq876cq",
-    "CacheDurationMinutes": 20
-  }
-}
-```
-
-**توضیح پارامترها**:
- `UseMock`: اگر true باشد، MockDayaLoanApiService استفاده می‌شود
- `BaseAddress`: URL سرویس Daya (Test یا Production)
- `MerchantPermissionKey`: کلید احراز هویت
- `CacheDurationMinutes`: مدت cache در سمت Daya (فقط اطلاعاتی)
-
---
-
-### 4. DayaLoanStatus.cs
-**مسیر**: `CMS/src/CMSMicroservice.Domain/Enums/DayaLoanStatus.cs`
-
-**تغییرات**:
-```csharp
-// BEFORE:
-public enum DayaLoanStatus
-{
-    PendingReceive = 0,
-    Received = 1,
-    Rejected = 2
-}
-
-// AFTER:
-public enum DayaLoanStatus
-{
-    NotRequested = 0,    // جدید
-    PendingReceive = 1,  // عدد تغییر کرد
-    Received = 2,        // عدد تغییر کرد
-    Rejected = 3,        // عدد تغییر کرد
-    UnderReview = 4      // جدید
-}
-```
-
-**⚠️ توجه**: این یک Breaking Change است اگر دیتابیس از قبل داده دارد.
-
---
-
-## 🔄 جریان کامل سیستم
-
-```
-1. Hangfire Worker (هر 15 دقیقه)
-   ↓
-2. Query Users with HasReceivedDayaCredit = false
-   ↓
-3. CheckDayaLoanStatusCommand
-   ↓
-4. DayaLoanApiService.CheckLoanStatusAsync
-   ↓
-5. HTTP POST /api/merchant/contracts
-   ↓
-6. Daya API Response (JSON)
-   ↓
-7. MapApiResponseToResults
-   ↓
-8. برای هر کاربر با Status = PendingReceive:
-   ↓
-9. ProcessDayaLoanApprovalCommand
-   ↓
-10. شارژ 3 کیف پول (Balance, NetworkBalance, DiscountBalance)
-    ↓
-11. Set HasReceivedDayaCredit = true
-    ↓
-12. DayaLoanApprovedEvent published
-```
-
---
-
-## 🧪 تست و اعتبارسنجی
-
-### تست با Mock (Development):
-```json
-// appsettings.json
-{
-  "DayaApi": {
-    "UseMock": true
-  }
-}
-```
-
-### تست با Real API (Staging):
-```json
-{
-  "DayaApi": {
-    "UseMock": false,
-    "BaseAddress": "https://testdaya.tadbirandishan.com",
-    "MerchantPermissionKey": "YOUR_TEST_KEY"
-  }
-}
-```
-
-### نحوه تست دستی:
-1. به Hangfire Dashboard بروید: `/hangfire`
-2. Job `daya-loan-check` را پیدا کنید
-3. دکمه "Trigger Now" را بزنید
-4. در Logs بررسی کنید:
-   - Request body
-   - API response
-   - Mapped results
-   - ProcessDayaLoanApproval results
-
---
-
-## 📊 Status Mapping Logic
-
-### API Response → Enum:
-| StatusDescription (API) | DayaLoanStatus (Enum) | توضیح |
-|------------------------|----------------------|-------|
-| "فعال شده (در انتظار تسویه)" | PendingReceive (1) | قرارداد فعال، منتظر واریز |
-| "تایید شده" | Received (2) | وام دریافت شده |
-| "رد شده" | Rejected (3) | درخواست رد شده |
-| سایر موارد | UnderReview (4) | در حال بررسی یا نامشخص |
-
-### کد Mapping:
-```csharp
-private DayaLoanStatus MapStatusDescription(string? description)
-{
-    if (string.IsNullOrEmpty(description))
-        return DayaLoanStatus.UnderReview;
-
-    return description switch
-    {
-        "فعال شده (در انتظار تسویه)" => DayaLoanStatus.PendingReceive,
-        "تایید شده" => DayaLoanStatus.Received,
-        "رد شده" => DayaLoanStatus.Rejected,
-        _ => DayaLoanStatus.UnderReview
-    };
-}
-```
-
---
-
-## 🐛 Error Handling
-
-### سناریوهای خطا:
-
-1. **API Unreachable** (Network error):
-   - Log: "Error calling Daya API"
-   - Return: Empty list
-   - Worker continues
-
-2. **401 Unauthorized**:
-   - Log: "Invalid merchant-permission-key"
-   - Return: Empty list
-   - Check configuration
-
-3. **API Returns succeed=false**:
-   - Log: "Daya API error: {message}"
-   - Return: Empty list
-   - Check Daya service status
-
-4. **Multiple Contracts for User**:
-   - Behavior: Takes latest by DateTime
-   - Log: "User has {count} contracts, taking latest"
-
-5. **No ContractNumber**:
-   - Skip user (won't trigger ProcessDayaLoanApproval)
-   - Only create/update DayaLoanContract record
-
---
-
-## 🚀 Deployment Checklist
-
-### Pre-Production:
- [ ] Replace test `MerchantPermissionKey` with production key
- [ ] Change `BaseAddress` to production URL
- [ ] Set `UseMock: false` in appsettings.Production.json
- [ ] Test with real Daya API in staging environment
- [ ] Verify Worker schedule (*/15 * * * *)
- [ ] Check Hangfire Dashboard access
-
-### Monitoring:
- [ ] Setup alerts for Worker failures
- [ ] Monitor API call duration (should be < 30s)
- [ ] Track ProcessDayaLoanApproval success rate
- [ ] Verify no duplicate credits (HasReceivedDayaCredit flag)
-
-### Security:
- [ ] MerchantPermissionKey stored in Azure Key Vault (not appsettings)
- [ ] HTTPS only for API calls
- [ ] Rate limiting on Worker (currently 15 min is safe)
- [ ] Audit log for all credit approvals
-
---
-
-## 📝 نکات مهم
-
-### 1. Cache Duration
- Daya API caches results for 20 minutes
- Worker runs every 15 minutes → Some overlap acceptable
- No need to implement client-side caching
-
-### 2. Multiple Contracts
- System supports users with multiple contracts
- Always takes the latest one (by DateTime)
- Old contracts ignored (not deleted from API)
-
-### 3. One-Time Credit
- `HasReceivedDayaCredit` flag ensures one-time credit only
- Even if API returns multiple PendingReceive, only first processes
- Idempotency guaranteed
-
-### 4. Transaction Record
- Type: `DepositExternal1`
- Amount: 168,000,000 (total of 3 wallets)
- RefId: Daya contract number
- Use for reconciliation with Daya
-
-### 5. DiscountBalance Logging
- ⚠️ UserWalletChangeLog doesn't have DiscountBalance fields
- Only Balance and NetworkBalance logged
- DiscountBalance changes only in UserWallet table
- Consider adding fields in future migration
-
---
-
-## 🔗 مستندات مرتبط
-
- **Business Logic**: `totalDoc/01-BUSINESS/daya-loan-integration.md`
- **Implementation Status**: `totalDoc/03-BACKEND/CMS/implementation-status.md` (Phase 11)
- **API Spec**: `totalDoc/MerchantService.md` (Daya Documentation)
- **Worker Guide**: `CMS/src/CMSMicroservice.WebApi/Workers/DayaLoanCheckWorker.cs`
-
---
-
-## ✅ تاییدیه نهایی
-
- ✅ Build successful: 0 errors
- ✅ Real API integration complete
- ✅ Mock/Real switchable
- ✅ Worker operational
- ✅ Error handling robust
- ✅ Configuration flexible
- ✅ Status mapping accurate
- ✅ Documentation complete
-
-**Status**: 🟢 Ready for Production
@@ -1,71 +0,0 @@
-# 📁 CMS - Database & Design Files
-
-این پوشه شامل فایل‌های طراحی و اسکریپت‌های دیتابیس CMS است.
-
---
-
-## 📊 فایل‌ها
-
-### Database Models (.ndm2):
- **`model.ndm2`** - طراحی اصلی دیتابیس CMS
-  - حجم: 2.4 MB
-  - آخرین بروزرسانی: 1 دسامبر 2025
-  - ابزار: Navicat Data Modeler
-
- **`model1.ndm2`** - نسخه 2 طراحی (احتمالاً با تغییرات Network/Club)
-  - حجم: 2.2 MB
-  - آخرین بروزرسانی: 1 دسامبر 2025
-
-### SQL Scripts:
- **`update-pool-percent.sql`** - اسکریپت بروزرسانی درصد Pool کمیسیون
-  - حجم: 2 KB
-  - استفاده: Update درصدهای استخر هفتگی
-
-### Documentation:
- **`network_crm_calculate.txt`** - محاسبات CRM شبکه
-  - حجم: 28 KB
-  - محتوا: فرمول‌های محاسباتی، قوانین کسب‌وکار
-
---
-
-## 🔧 نحوه استفاده
-
-### باز کردن Database Models:
-```bash
-# باز کردن با Navicat Data Modeler
-navicat-data-modeler model.ndm2
-```
-
-### اجرای SQL Scripts:
-```bash
-# اجرا در SQL Server
-sqlcmd -S localhost -d CMS_Database -i update-pool-percent.sql
-
-# یا در Azure Data Studio / SSMS
-```
-
-### مشاهده محاسبات:
-```bash
-cat network_crm_calculate.txt | less
-```
-
---
-
-## 📝 نکات مهم
-
- ⚠️ **Backup**: قبل از اجرای اسکریپت‌ها، حتماً از دیتابیس backup بگیرید
- 📊 **ERD**: برای مشاهده Entity Relationship Diagram از Navicat استفاده کنید
- 🔄 **Sync**: این مدل‌ها باید با Entity ها در کد همگام باشند
-
---
-
-## 🔗 مراجع
-
- **Entity Guide**: [`../entity-guide.md`](../entity-guide.md)
- **Implementation Status**: [`../implementation-status.md`](../implementation-status.md)
- **Business Logic**: [`../../../01-BUSINESS/`](../../../01-BUSINESS/)
-
---
-
-**تاریخ ایجاد**: ۱ دسامبر ۲۰۲۵  
-**آخرین بروزرسانی**: ۱۴ آذر ۱۴۰۴
@@ -1,94 +0,0 @@
-سیستم کر مرکزی خب سیستم کارگزاری کیف پول داره که کیف پولی که اینا میرن خرید میکنن از دایا برمی‌گردن وامشون واریز میشه این کیف پول شارژ میشه ۵۶ تومان حالا بازار یه فروشگاه داره یه فروشگاه اینترنتی داره که با این ۵۶ تومن که فعلا امتیازی که باید برن حتما از دایا خرید کنن برگردن بعدا قراره خودشون نقدی کیف پولشون رو شارژ کنن یعنی با سلیقه درگاه بیان کیف پولشونو شارژ کنن. تو هر دوتا حالتش از این فروشگاه می‌تونن خرید کنن حالا بعد اینکه کیف پولشون شارژ میشه حالا از طریق دایه‌ها یا از هر طریق دیگه به اون اندازه‌ای که ما متوجه بشیم که این شارژ کیف پول به دلیل عضویت در باشگاه مشتریان بوده 
-برتری ممکنه طرف بیاد یه میلیون کیف پولشو شارژ کنه اون یه میلیونه مثلا ما یه باشگاه مشتریانم جدا داریم یعنی آره خود باشگاه مشتری که فعال فعال میشه ۱. الان فعلاً در حال حاضر دایا خرید کنی وام بگیری خب وامشو بگیری هم باز باید واسم یه قسمتشو انگار مثلاً یه دکمه باید بزنی اختصاص بده به باشگاه مشتری یا نه دقیقاً یعنی یه دکمه میزنی این اختصاص داده میشه یعنی توی خود کارا بازار یه دکمه‌ای وجود داره میزنی و بعد از اینکه پرداختتون انجام دادی که پولتو شارژ کردی این دکمه رو میزنی و شما عضو باشگاه مشتریان میشی یعنی ما می‌سنجیم ببینیم اینکه تو. پرداختیتو انجام دادی اول بعد باشگاه مشتریان میشی حدوداً ۲۰ ۲۵ میلیونش از این ۵۶ میلیونی که تامین اعتبار میشه 
-جدا میشه جدا میشه میره تو باشگاه مشتری میره تو باشگاه مشتریان که از اونجا دیگه مدیریت اون محاسبه پورسانته دقیقاً انجام حالا باشگاه مشتریان چی داره باشگاه مشتریان خودش خودش برای خودش به صورت مجزا یه فروشگاه تور داره که تو اون فروشگاهه صرفا یه سری تخفیف وجود داره یعنی متفاوت با این فروشگاه اصلی اون فروشگاه یه سری تخفیف داره. ‏a۵۵ ۳۰ درصد تخفیف این ۳۰ درصد تخفیف تو چجوری میتونی استفاده کنی حالتی که رفته باشی کیف پول اصلی تو کیف پول اصلیتو شارژ کرده باشی حالا از طریق دایه یا نقدی کیف پول اصلیتو شارژ کرده باشی یه ۵۶ تومان که به کیف پول اصلیت واریز میشه 
-هیچ یه ۵۶ تومان هم به کیف پول تخفیف تو باشگاه مشتریان اضافه میشه که اون گوشی ۵۵ که مثلا ۳۰ درصد تخفیف داره رو ۵۶ تومن واریز میشه ۵۶ تومن واریز میشه. به کیف پول تخفیفت یعنی اون یه ۲۵ میلیون برای باشگاه مشتریانه وقتی باشگاه مشتری فعال می‌کنی ۵۶ میلیون اعتبار تخفیف برات فعال میشه که از اون فروشگاه دوم میتونی خرید کنی ولی چه جوری میتونی خرید کنی فقط همون درصد تخفیف رو میتونی از این ۵۶ تومان استفاده میشه اوکی پس چی شد اگه گوشی مثلا. ۲۰ درصدش تخفیف خورده اون ۲۰% رو می‌تونی از این ۵۶ تومانه استفاده کنی مابقیشو باید نقدی اینجوری میفهمم من باید یه تیبل داشته باشم کسایی که میان 
-میرن جز باشگاه مشتریان میشن رو اونجا ثبت بکنم یعنی وصل به تیبل یوزرمون بعد اونجا ثبت میشه آها این شخص جز باشگاه مشتری حالا خود باشگاه مشتریان یادته که دکتر گفتش که آقا یه سری لیست داره که اونا فعال میشن فعال شده شماره بیمه چیه یا اگه مثلا فلان چی فعال شده برات این چیه خب مثلا من. تو ذهنم اینجوری بود که خیلی ساده که آپشنای باشگاه مشتریانه اول که میگیم آقا این کاربر جز باشه مشتریان شده است یا خیر ۱ فیلدی که میگه شده است یا خیر یه تیبل دیگه است که میگه آقا این فیچرهایی که از این باشگاه مشتری گرفته کدوماشو گرفته یه تیبل دیگه هست که فیچرها رو اون تو میزنیم باشگاه مشتری داریم آره یه تیبل واسطه مشتریان و یوزر داریم که آقا این یوزر این فیچر براش باز شده با این توضیحات دقیقا اوکی حالا. بعد من علاوه بر این یه کیف پول تخفیف هم باید به کیف به فیلدهای ولتم اضافه کنم یعنی الان یه تیبل ولت دارم یه موجودی شبکه داره یه موجودی خالص داره یه موجودی تخفیف هم باید داشته باشه یعنی سه تا موجودی باید داشته باشه درسته حالا این سه تا موجودی زمانی موجودی تخفیف فعال میشه که کاربر جزو باشگاه مشتریان شده 
-باشه خب بعد از این فروشگاه یعنی ممکنه محصولاتشم حتی فرق داشته فعال بکنه که آقا من میخوام از. کیف پول تخفیفی بخرم تخفیفا رو نمایش بده اگه نه می‌خوام از تخفیفیم نخرم هادیا رو نمایشگاه باید ایمپلیمنت باشه حالا این پس این باشگاه مشتریان که من میتونم جزئیات باشگاه مشتری خیلی جالبه این فروشگاه رو تو مثلا یه گوشی با یه لپ تاپ میخری گوشی ۲۰ درصد تخفیف داره لپ تاپ ۵۰ درصد تخفیف داره تو اون ۲۰% ۵۰% رو از این کیف پول تخفیفت میتونی استفاده کنی شارژ شده مابقیش هم نقدی میره مستقیم برو نقدی پرداخت کن. ما به صورت هفتگی محاسبه کارمزد داریم یعنی به صورت هفتگی کارم محاسبه می‌کنیم 
-پلن نتورک این شبکه هم پلن باینره که یه تعادلی ایجاد میشه فقط هم دو نفره دیگه فقط دو نفر بله دو نفر یعنی شما یه دست راست داری یه دست چپ داری بیشتر از اون نداری یعنی سه تا دست و چهار تا دست نداریم ما الان دو تا دست داریم یعنی من. یوزر یه دست راست دارم یه دست چپ دست راستم مثلاً آقای ایکس دست چپم خانم یعنی هیچ چیز اضافه تری نداره ما یه حالا ما توی محاسبه پورسان با کدوم یک از این اعتبارا کار دارم فقط ۵۰ میلیون تومن ۵۶ میلیون تومن تو کیف پول اصلی واریز میشه یه ۵۶ میلیون تومن توی کیف پول تخفیف واریز میشه یه دونه ۲۵ میلیون تومان هم میره توی کارمزد نتورک میره اونجا که بخواد کارمزدش محاسبه بشه. 
-آخر هفته ما محاسبه میکنیم میگیم مثلا میثم مقدم دو نفر زیر مجموعه داره مثلا ایکس و ایگرگ آقای ایکس و خانم ایگرگ این دو نفر زیر مجموعه هر کدوم اومدن ۵۶ تومان خرید کردن خب خودمم که ۵۶ تومان همون اول خرید کرده بودم یعنی پکیج خریده بودم سرمایه گذاری کرده بودم. این ۵۶ تومان با این ۵۶ تومان میشه حدوداً صد و ۱۱۲ تومن با ۵۶ تومان خودم میشه ۱۶۸ تومن درسته ۱۶۸ تومن توی مخزنمون هست خب ۱۶۸ تومن تو مخزنمون هست حالا بذار من این چیزمو نگاه کنم خب نگاه کن ما به ازای هر تعادلی که ایجاد میشه یک امتیاز به. الان مثلاً من گفتم آقای ایکس و خانم دیگه خب یه تعادل ایجاد کردم درسته یعنی امتیازمون یعنی امتیاز من چنده یه دونه تعادل ایجاد کردم تو هر هفته تعداد تعادل رو محاسبه میکنیم اوکی تعداد تعادل های هر نفر را محاسبه. حالا ده تا تعادل یعنی چی من که یه دونه بیشتر تعادل نمیتونم بزنم اگه من زیر مجموعهم یه تعادل بزنه برای من حساب میشه 
-بله خب نه نگاه کن الان من زیر مجموعه سمت راستم یه تعادل زده یعنی دو نفرو جذب کرده این میشه خب همین یه طرف هم میشه اگه اون طرف هم تعادل همون دیگه یعنی من هرچقدر سطحم میره پایین تر تعداد تعادل باید ضربدر دو بشه. یعنی من توی لول اول خودم اگه یه دونه دو نفرو جذب بکنم میشه یه تعادل ولی اگه می‌خوام دومین تعادلو داشته باشم بعد سمت راستم یه تعادل یعنی یه دو نفر جذب بکنه سمت چپم یه دو نفر جذب بکنه سمت راست سمت چپت بعد هر کدوم یه دونه جذب بکنه هر کدومشون باید یه تعادل بزنند که برای تو دوتا تعادل حساب بشه 
-یعنی نگاه کن تو خودت که الان فرض میکنیم تو هفته اول یه اتفاقی افتاده اتفاقی اینه تو خودت دو نفرو جذب کردی یعنی میثم مقدم آقای ایکس و خانم ایگرگ رو جذب کرده آقای ایکس دو نفرو جذب کرده. خانم ایگرگم دو نفرو جذب کرده خب تو دوتا تعادل یه دونه تعادل که خودت زدی چون آقای ایکس خانم ایگرگ رو جذب کردی یه دونه تعادل اینورت زده یه دونه تعادل جمع میشه چند تا تعادل سه تا تعادل تو زدی درست شد نشد دیگه گفتیم دوتا تعادل میشه نه دیگه چرا دوتا تعادل گفتی که آقا من وقتی که توازن برقرار بشه بهش میگیم یه تعادل دیگه خب خب من وقتی که خودم یه دو نفر جذب می کنم میشه 
-تعادل وقتی زیر مجموعه تعادل جذب میکنه هنوز برای من تعادل نیست چون زیر مجموعه دوم هم باید تعادل بزنه دیگه. تعادل هر کدوم نفری براشون یه تعادل ولی برای تو تعادل اونا که حساب نمیشه برای تو یه تعادل از یه سطح بالاتر حساب میشه دیگه اینجوری نیست مگه نه اونجوری که تو همیشه یه تعادل دوتا تعادل میتونی داشته باشی نه چون دو تا دست داری اینا هر کدوم تعادل تعادل تعادل بزنن یه دونه تعاد. مبلغ کیف پوله مگه شرط نیست اون چیزی که تو صندوق جمع شده مگه شرط نیست نه به اون کاری نداریم الان تعداد تعادل چگونه محاسبه میشود چه جوری ما حساب میکنیم تو چند تا تعادل زدی تو یه دستت یه تعادل بزنه یه دسته دیگه هم یه تعادل تو دو تا تعادل زدی متوجه شدی تو تونستی دوتا دوتا جذب کنی خب دو تا تعادل حالا بگذریم از همون خیلی ساده‌شو 
-بگیریم من میثم مقدم دو نفرو جذب کردم آقای ایگرگ خانم ایکس درسته. امتیاز تو شد ۱ به تعداد تعادل مساوی با امتیاز یعنی تعداد تعادل مساوی است با امتیاز تعداد تعادل هر شخص مساوی است با امتیاز اون شخص حالا هرچی که مبلغ توی صندوق جمع شده یعنی من خودم ۵۶ تومن دادم دست راستم ۵۶ تومن داده دست داده درسته البته که اینا که دارم میگم اشتباهه. ۵۶ تومنه یکیش واسه کیف پول تخفیفه یکیش واسه کیف پول اصلیه ما اینجا ۲۵ تومان داریم دست خودم ۲۵ تومان آوردم تو باشگاه مشتریان دست راستم ۲۵ تومان آورده دست چپم ۲۵ تومان آورده جمعاً میشه ۷۵ تومان یعنی ۷۵ میلیون تومن تو صندوق جمع شده 
-درسته من چه امتیازی دارم ۱ درسته دست راستم چه امتیازی داره صفر دست چپم چه امتیازی داره صفر درسته ما با اونا کار نداریم الان مبلغ پورسانت من چی میشه من یک امتیاز دارم اون ۷۵ تومن تقسیم بر یک. اون دوتا که صفر بودن دیگه اگه اون دوتا نفر یک بودن میشد مثلا تقسیم بر سه خب میشه مبلغ ریالی هر امتیاز یعنی مجموع کل امتیازهایی که همه کاربرها جمع کردن و مجموعه کل امتیازها اینا رو یه دست نگهدار این عددی که تو صندوق جمع شده تقسیم بر مجموعه کل امتیازها یعنی عددی که تو صندوق جمع شده تقسیم بر کل تعداد تعادل‌های این هفته مساوی است با مبلغ ریالی هر امتیاز حالا تو چند امتیاز داشتم ۷۵ میلیون تقسیم بر ۱. یعنی مبلغ ریالی هر امتیاز میشه ۷۵ میلیون درسته حالا من چند امتیاز داشتم ۱ پس ۷۵ میلیون ضربدر یک میشه 
-یعنی ۷۵ میلیون تومان باید کارمزد بگیرم یه لول میاد پایین تر خب من اگر این هفته جدید تعادل جدیدی ثبت نکنم که دیگه برام تعادل حساب نمیشه یعنی من وقتی تعادل زدم پولشم گرفتم دیگه اون تعادل پاک میشه اون تعادل دیگه پاک میشه دیگه برای تو تعادل جدید حساب نمیشه خب. حالا من توی شبکه هم دست چپ و راستم رفتی یه لول پایین تر اونا هم یه دونه مثلاً شده هفته بعد اونا هم یه تعادل دیگه زدن برای من دوتا تعادل حساب میشه برای خودشون چند تا هر کدوم نفری یه دونه درسته هفته اول دیگه چون خود من دو نفر جذب کردم میشه ۱ درسته اونا هر کدوم دو نفر جذب کردن ۱ ۱ برای من میشه سه. هفته اوله حالا شده ۵ هرچی که تو صندوق از اون ۲۵ میلیون ۲۵ میلیون جدید درسته یعنی اونایی که دیگه همش هفته اول همش جدیده دیگه ثبت شده 
-تقسیم میشه بین اون امتیازها حالا کی چقدر امتیاز داره همون پول میگیره درسته چه اتفاقی افتاده من ۲۵ میلیون دست راستم ۲۵ میلیون ۷۵. هر کدوم از اونا نفری دو نفرو جذب کردن که دو تا ۲۵ میلیون اونور ۵۰ ۵۰ ۱۰۰ میلیون ۱۰۰ میلیون با ۷۵ میلیون میشه ۱۷۵ میلیون ۱۷۵ میلیون تقسیم بر ۵ میشه حدوداً ۳۵ میلیون یعنی ۳۵ میلیون ارزش ریالی هر امتیازه بعد حالا هر کی چقدر امتیاز داره همونقدر بهش تعلق می‌گیره من چقدر امتیاز دارم ۳ امتیاز دارم ۳۵ میلیون ضربدر ۳ ۳ تا ۳۵ میلیون هم باید بگیرم یه دونه ۳۵ میلیون دست راستم باید بگیره یه ۳۵ میلیون دست چپم باید بگیره خب من مثلا میتونم یه تیبل داشته باشم خب که. هر کسی هر هفته‌ای که تعادل میزنه خب اونو اونجا ثبت بشه 
-تعداد تعادل‌های هر شخص توی هر هفته باید ثبت بشه خب تعداد تعادل‌های هر شخص تو هر هفته باید ثبت بشه یعنی اگه اون مثلاً من زیر مجموعه‌هام هزار تا ۲۰۰۰ نفر بشه اون پایینم یه نفر یه تعادل بزنه برای من یه تعادل ثبت میشه حالا اگه یه دستم یه تعادل بزنه بازم برای من یه تعادل ثبت میشه یعنی من نباید تلاش کنم چرا دست دوم باید همونقدر تعادل بزنه یعنی اگه مساوی بزنن تعادل حساب میشه. هفته اولم باشه فقط آقای ایکس یه تعادل بزنه من برای خودش تعادل حساب میشه پس من باید توازن داشته باشم دیگه باز خب اگر توازن داشته باشم یعنی مثلا من حالا مثلا یه لول رفته 
-جلوتر سه تا تعادل این دستم زده دو تا تعادل این دستم زده برای من ۲ حساب میشه دو اینور دو این ور میشه چهار یعنی من هر موقعی که یه تعادلی شکل میگیره باید برم دست مقابل اونم نگاه کنم ببینم تعادلی وجود داره تازه میشه یه تعاد. تعادل بعدی اگه اونور وجود داشت که هیچی اگر وجود نداشت اگه وجود داشت که خب دیگه تعادله اگه وجود نداشتم که هیچی این دست نگاه کنم ببینم که مثلاً این دست که حالت تعادل زده این دستش یه تعادل داره در هر صورت بخوام یه فرمول کلی بگم تو دست چپت تو اعماق اصلا ده لول ۱۵ رفته پایین این نتورک تا لول ۱۵ رفته 
-پایین دست چپت اون پایین مایا چهار تا تعادل میزنه دست راستتم حداقل باید چهار تا تعادل بزنه تا بره تو یه چیزی محاسبه بشه یعنی اگه دست. چپ تو خوب دوتا تعادل زده دست راستت چهار تا تعادل زده دو تا تعادل واسه تو حساب میشه دوتا اینور دوتا اونور جمع میشه چهار تا اگه دست راستتو پنج تا تعادل زده دست چپتو هیچ تعادلی نزده پس در نتیجه هیچ تعادلی واسه تو حساب نمیشه اگه دست راستتو دو تا تعادل زده دست چپتم دو تا تعادل زده دقیقا حالا با همدیگه مساوی چهار تا تعادل اگه دست راست تو ده تا تعادل زده ۱۰۰ تا تعادل زده ولی دست چپت دوتا تعادل زده کلاً دو تا تعادل حساب میشه دو تا راست دو تا چپ میشه 
-چهار تا. تعادل یه نفر حساب کنی این شکلی باید حساب کنیم خب من الان مثلا اون تیبلی که میزارم باید چه شکلی باشه یعنی همون لحظه که یه نفر ثبت نام میکنه من کسی که عضو باشگاه مشتریان میشه تو یه جا ثبت کن که آقا این نفر عضو باشگاه مشتریان شد حالا آخر هفته محاسبه می‌کنی اون نفری که عضو باشگاه مشتری اینا شده والدش کی بوده والدش کی بوده والد والت همینجوری تا آخر آیا تعادل خورده است یا خیر یعنی تو هفتگی باید حساب کنی تو این هفته ورودی های این هفته رو باید حساب کنی. خب من نمی‌تونم مثلاً وقتی که یه نفر جزو باشگاه مشتریان میشه 
-همون لحظه تعادل همه بالا سریاشو حساب کنم نه شاید تعادل بیشتر بزنه خب باشه وقتی بیشتر زد دوباره افزایش نمی‌دونم شاید بشه بعد اینو حساب کتاب کنی بعد با دکترم جلسه بذاری که ببینی دقیقاً این چه جوریه مثلا هفته پیش یه نفر یه تعادل زده این هفته کلاً پوچ میشه تعادلاش چون من تا جایی که یادمه باید سعی کنه طرف تو هفته دو تا تعادل این دستشو بزنه وگرنه پوچ میشه یعنی از دست دادتش. حله و در مجموع پس هر کدوم من میگم اون تیبلی که دارم حتما باید یه چیزی تحت عنوان امتیاز باشه اگه همون تعداد تعادل خب بعد عددی که جمع میشه هم یه جا باید من یه جا نگهش دارم عددی که تو این هفته جمع میشه 
-تعداد تعادل این هفته و مبلغی که تو این هفته تو باشگاه مشتریان جمع شده حالا این تقسیم برای امتیاز هرکی به نسبت امتیازی که داره یه مبلغی براش ثبت میشه که اون مبلغ در نهایت میره تو کیف پول شبکه یا کیف پول کارمزد اصلا کیف پول نذاریم بذاریم کارمزد کمیسیون. یه چیزی باید باشه ولی یه مخزنی هست دیگه یه جایی هستش که تو هر هفته مبلغی که با استفاده از اون پلن شبکت دریافت کردی میره اونجا واریز میشه حالا این مبلغی که توی کیف پول شبکه یا کیف پول کارمزد هست یا کیف پول طلایی اسمشو بذاریم چون اسم این امتیازها امتیازهای طلاییه اسم اون کیف پوله رو بذاریم کیف پول طلایی چون سه تا کیف پول شد یک کیف پول اصلی که تو میتونی بری از فروشگاه بازار خرید کنی مستقیمه دو کیف پول تخفیف که تو میتونی بری از فروشگاه که بعد از باش 
-مشتریان این اتفاق. یکی هم کیف پول طلاییت یا همون کیف پول کارمزدت این میشه سه تا کیف پول حالا کیف پول کارمزد چه جوری میتونی برداشت کنی دو طریق داره یک نقدی برداشت کنید یعنی شماره شبا بدیم و نقدی برات پرداخت کنیم ۲ بری از دایا الماس بخری حالا یه چیزی من الان ۵۶ میلیون تومنو یعنی ما الماس بهت بدیم اوکی ما الان ۵۶ میلیون تومنو آوردیم توی کیف پول که میتونه بره خرید بکنه اگه باشگاه مشتری اینو بزنیم ۲۵ میلیون ازش کم میشه دیگه کم میشه دیگه. میلیون تومن توی باشگاه مشتریان شارژ میشه جدای از این یعنی میشه چی میشه یه ۵۶ میلیون تومن توی کیف پول اصلی یعنی ۵۶ میلیون تومن تو کیف پول ۲۵ میلیون تومان توی خود باشگاه اوکی حالا بذارید تحلیل بکنم ببینم چی میتونم در بیارم. 
-
-
-masoud moghaddam, [11/29/25 6:23 AM]
-کاربر A: فعال‌سازی (۲۵M به استخر)
-  ├─ فرزند Left: کاربر B (فعال‌سازی ۲۵M)
-  └─ فرزند Right: کاربر C (فعال‌سازی ۲۵M)
-
-استخر هفته اول: ۷۵M
-تعادل کاربر A: MIN(1, 1) = 1
-تعادل کاربر B: 0
-تعادل کاربر C: 0
-
-مجموع تعادل‌ها: 1
-ارزش هر امتیاز: 75M ÷ 1 = 75M
-
-کمیسیون کاربر A: 1 × 75M = 75M
-
-کاربر B: جذب دو نفر (D و E) → تعادل ۱
-کاربر C: جذب دو نفر (F و G) → تعادل ۱
-
-استخر هفته دوم: ۴ × ۲۵M = ۱۰۰M
-تعادل کاربر A: MIN(1, 1) = 1 (از B و C)
-تعادل کاربر B: 1
-تعادل کاربر C: 1
-
-مجموع تعادل‌ها: 3
-ارزش هر امتیاز: 100M ÷ 3 ≈ 33.33M
-
-کمیسیون کاربر A: 1 × 33.33M = 33.33M
-کمیسیون کاربر B: 1 × 33.33M = 33.33M
-کمیسیون کاربر C: 1 × 33.33M = 33.33M
-
-masoud moghaddam, [11/29/25 6:24 AM]
-این نوع محاسبه درسته ؟
-Doctor
-
-Doctor Seif, [12/1/25 4:37 PM]
-سلام
-نصفش درسته، نصفش نه
-
-Doctor Seif, [12/1/25 4:42 PM]
-کاربر A: فعال‌سازی (۲۵M به استخر)
-  ├─ فرزند Left: کاربر B (فعال‌سازی ۲۵M)
-  └─ فرزند Right: کاربر C (فعال‌سازی ۲۵M)
-
-استخر هفته اول: ۷۵M
-تعادل کاربر A: MIN(1, 1) = 1
-تعادل کاربر B: 0
-تعادل کاربر C: 0
-
-مجموع تعادل‌ها: 1
-ارزش هر امتیاز: 75M ÷ 1 = 75M
-
-کمیسیون کاربر A: 1 × 75M = 75M
-
-کاربر B: جذب دو نفر (D و E) → تعادل ۱
-کاربر C: جذب دو نفر (F و G) → تعادل ۱
-
-استخر هفته دوم: ۴ × ۱۰۰M = ۲۵M
-تعادل کاربر A: MIN(2, 2)=2 = 1 (از B و C)
-تعادل کاربر B: 1
-تعادل کاربر C: 1
-
-مجموع تعادل‌ها: 4
-ارزش هر امتیاز: 100M ÷ 4 = 25M
-
-کمیسیون کاربر A: 2 × 25M = 50M
-کمیسیون کاربر B: 1 × 25M = 25M
-کمیسیون کاربر C: 1 × 25M = 25M
-
- قصه محاسبه تعادل اینه که اون کاربر بالایی وقتی که کاربرهای پایینیش یعنی ای و بی تعادلش رو می‌گیرند خط تعادل اون که بین کاربر ای و بیه این سمتش دو نفر وارد میشه اون سمتش دو نفر یعنی دو تا یک به یک پس تعادل دوش فعال می‌شه برای اون دیگه تعادل یک نیست همونطور که زمانی که توی سمت بین همون که داری میگی مثلا شش نفر سمت ای باشن پنج نفر سمت بی تعادلش میشه ۵ یه نفر از اونایی که سمت ای اند. باقی میمونه برای محاسبات هفته آینده‌اش یعنی شما باید اون خط مرکز را بکشی و بعد به نسبت تعداد افراد سمت چپ که ای یا ای و تعداد افراد سمت بی اون نسبت رو می‌گیری اون میشه 
-تعداد تعادل اون فرد بالا برای بقیه افراد هم همینه یعنی هر فردی یک سازمان ای و یک سازمان بی داره تعداد تعادل‌ها می‌شه مجموع افراد ورودی هفته جدید به اضافه باقی مانده‌های هفته قبلی اگر باقی مانده توی اون سمتش مونده تعادلشون با مجموع تعداد افراد ورودی جدید. به اضافه باز باقیمانده‌های هفته قبلی اگر باقیمانده از هفته قبلی مونده جمع این دو تا پایین‌ترین عددش میشه میزان تعادل اون پایین‌ترین عدد منهای اون تعداد میشه باقیمانده تو هر دستی که بود چه ای بود چه بی بود میره سیو میشه برای هفته بعدی. 
@@ -1,51 +0,0 @@
-- Script to update WeeklyPoolContributionPercent from 10% to 20%
-- این script فقط در صورتی که رکورد وجود داشته باشد، آن را آپدیت می‌کند
-
-- بررسی وجود جدول SystemConfigurations
-IF OBJECT_ID('SystemConfigurations', 'U') IS NOT NULL
-BEGIN
-    PRINT 'جدول SystemConfigurations یافت شد. در حال آپدیت...'
-    
-    -- آپدیت رکورد (در صورت وجود)
-    UPDATE SystemConfigurations 
-    SET 
-        Value = '20',
-        Description = N'درصد مشارکت در استخر هفتگی از کل فعال‌سازی‌های جدید شبکه (20%)',
-        LastModified = GETUTCDATE()
-    WHERE [Key] = 'Commission.WeeklyPoolContributionPercent'
-    
-    -- اگر رکوردی وجود نداشت، اضافه کن
-    IF @@ROWCOUNT = 0
-    BEGIN
-        PRINT 'رکورد Configuration یافت نشد. در حال ایجاد...'
-        
-        INSERT INTO SystemConfigurations 
-            ([Key], Value, Description, Scope, IsActive, DataType, Created)
-        VALUES 
-            ('Commission.WeeklyPoolContributionPercent', '20', 
-             N'درصد مشارکت در استخر هفتگی از کل فعال‌سازی‌های جدید شبکه (20%)', 
-             2, -- ConfigurationScope.Commission = 2
-             1, -- IsActive = true
-             'Int',
-             GETUTCDATE())
-    END
-    ELSE
-    BEGIN
-        PRINT 'رکورد با موفقیت آپدیت شد.'
-    END
-END
-ELSE
-BEGIN
-    PRINT 'جدول SystemConfigurations هنوز ایجاد نشده است.'
-    PRINT 'لطفاً ابتدا سرویس را یکبار اجرا کنید تا جداول Seed شوند.'
-END
-
-- نمایش وضعیت فعلی
-IF OBJECT_ID('SystemConfigurations', 'U') IS NOT NULL
-BEGIN
-    PRINT ''
-    PRINT 'وضعیت فعلی:'
-    SELECT [Key], Value, Description, Scope, IsActive
-    FROM SystemConfigurations
-    WHERE [Key] = 'Commission.WeeklyPoolContributionPercent'
-END
@@ -1,131 +0,0 @@
-# راهنمای پیکربندی Email و SMS
-
-## تنظیمات Email (Gmail)
-
-### مرحله 1: ایجاد App Password در Gmail
-
-1. به [Google Account Security](https://myaccount.google.com/security) بروید
-2. گزینه "2-Step Verification" را فعال کنید
-3. به بخش "App passwords" بروید
-4. یک App Password جدید با نام "FourSat CMS" ایجاد کنید
-5. پسورد 16 رقمی را در `appsettings.Production.json` در فیلد `SmtpPassword` قرار دهید
-
-### مرحله 2: تنظیم appsettings.Production.json
-
-```json
-"Email": {
-  "Enabled": true,
-  "SmtpHost": "smtp.gmail.com",
-  "SmtpPort": 587,
-  "SmtpUsername": "your-email@gmail.com",  // ایمیل Gmail خود
-  "SmtpPassword": "your-16-digit-app-password",  // App Password از مرحله 1
-  "FromEmail": "noreply@foursat.com",  // ایمیل فرستنده (می‌تواند همان Gmail باشد)
-  "FromName": "FourSat CMS",
-  "EnableSsl": true
-}
-```
-
-### سایر سرویس‌های SMTP:
-
-#### Outlook/Microsoft 365:
-```json
-"SmtpHost": "smtp.office365.com",
-"SmtpPort": 587
-```
-
-#### Yahoo Mail:
-```json
-"SmtpHost": "smtp.mail.yahoo.com",
-"SmtpPort": 587
-```
-
---
-
-## تنظیمات SMS (کاوه نگار)
-
-### مرحله 1: ثبت‌نام در کاوه نگار
-
-1. به [Kavenegar.com](https://panel.kavenegar.com/client/membership/register) بروید
-2. ثبت‌نام کنید و حساب خود را تأیید کنید
-3. از پنل، API Key خود را کپی کنید
-
-### مرحله 2: تنظیم appsettings.Production.json
-
-```json
-"Sms": {
-  "Enabled": true,
-  "Provider": "Kavenegar",
-  "KavenegarApiKey": "YOUR_KAVENEGAR_API_KEY",  // API Key از پنل کاوه نگار
-  "Sender": "10008663"  // شماره ارسال‌کننده (از پنل کاوه نگار)
-}
-```
-
-### نکات مهم:
- شماره `Sender` باید از پنل کاوه نگار تهیه شود
- برای تست می‌توانید از شماره‌های رایگان استفاده کنید
- هزینه هر پیامک بسته به نوع خط متفاوت است
-
---
-
-## تست کردن
-
-### تست Email:
-```bash
-# در محیط Development
-curl -X POST "http://localhost:5133/api/admin/trigger-weekly-calculation"
-```
-
-### تست SMS:
-همان دستور بالا را اجرا کنید. سیستم به صورت خودکار:
- Email ارسال می‌کند (اگر User.Email پر باشد)
- SMS ارسال می‌کند (اگر User.Mobile پر باشد)
-
-### بررسی Log ها:
-```bash
-# در ترمینال سرویس CMS
-# پیام‌های زیر را مشاهده کنید:
-# 📧 Email sent to {Email}: {Subject}
-# 📱 SMS sent to {PhoneNumber}: {MessageId}
-```
-
---
-
-## امنیت
-
-### ⚠️ مهم:
-1. فایل `appsettings.Production.json` را به Git اضافه نکنید
-2. از Environment Variables یا Azure Key Vault استفاده کنید
-3. API Key ها را هرگز در کد سورس قرار ندهید
-
-### استفاده از Environment Variables:
-
-```bash
-# Linux/Mac
-export Email__SmtpPassword="your-app-password"
-export Sms__KavenegarApiKey="your-api-key"
-
-# Windows
-set Email__SmtpPassword=your-app-password
-set Sms__KavenegarApiKey=your-api-key
-```
-
---
-
-## خطایابی (Troubleshooting)
-
-### Email ارسال نمی‌شود:
-1. App Password را صحیح وارد کرده‌اید؟
-2. 2-Step Verification در Gmail فعال است؟
-3. Port 587 باز است؟
-4. `EnableSsl: true` تنظیم شده؟
-
-### SMS ارسال نمی‌شود:
-1. API Key صحیح است؟
-2. اعتبار حساب کاوه نگار کافی است؟
-3. شماره `Sender` معتبر است؟
-4. فرمت شماره موبایل صحیح است؟ (09xxxxxxxxx)
-
-### Log ها را بررسی کنید:
-```bash
-tail -f /tmp/cms_run.log
-```
@@ -1,123 +0,0 @@
-# مستندات داده و بیزینس مایکروسرویس CMS
-
-## معماری و لایه‌ها
- **پشته فنی**: ‎.NET 9‎ + ASP.NET Core WebAPI، MediatR برای پیاده‌سازی CQRS، EF Core برای دسترسی داده، Mapster برای مپینگ DTO و gRPC/Protobuf برای قرارداد سرویس بین BFF ها و FrontOffice.
- **ساختار پروژه**: لایه‌های Domain (موجودیت و قواعد)، Application (CQRS Commands/Queries، ولیدیشن، DTO)، Infrastructure (EF Core + سرویس‌های جانبی) و WebApi (ورودی HTTP/gRPC) به همراه پروژه مستقل Protobuf جهت به‌اشتراک‌گذاری قراردادها.
- **الگوی کلی**: هر درخواست ورودی از طریق WebApi به MediatR ارسال و Handler مربوطه داده را از DbContext می‌خواند/می‌نویسد. تمام موجودیت‌ها از `BaseAuditableEntity` ارث می‌برند و ستون‌های `Id`, `Created`, `CreatedBy`, `LastModified`, `IsDeleted` را به صورت یکپارچه فراهم می‌کنند.
- **ملاحظات مقیاس‌پذیری**: Handler ها stateless هستند و می‌توانند افقی مقیاس شوند. کنترل تراکنش‌ها توسط EF Core انجام می‌شود و در عملیات چندمرحله‌ای (مثلاً ثبت سفارش) تغییرات داخل یک `TransactionScope` واحد اعمال می‌شود تا سازگاری داده حفظ شود.
- **پایش و ردگیری**: رفتارهای `Common/Behaviours` برای لاگ‌گیری و اعتبارسنجی فعال‌اند و برای هر درخواست یک شناسه ردگیری تولید می‌کنند تا ارتباط بین لاگ BackOffice و FrontOffice حفظ گردد.
-
-## مدل داده
-برای فهم بهتر بیزینس، موجودیت‌ها در پنج خوشه اصلی (هویت، کاتالوگ، سفارش، کیف پول، قرارداد) دسته‌بندی شده‌اند و هر خوشه قواعد و قیود مخصوص خود را دارد.
-### لایه کاربر و هویت
- **User**: اطلاعات هویتی، وضعیت تایید موبایل، تنظیمات اعلان، کد ارجاع و رابطه والد/فرزند. ارتباط یک‌به‌چند با آدرس‌ها، نقش‌ها، سفارش‌ها، قراردادها، کیف پول و سبد خرید.
- **Role / UserRole**: تعریف نقش‌های سیستمی و نگاشت چند-به-چند کاربر به نقش. جهت کنترل دسترسی BackOffice.
- **OtpToken**: ذخیره توکن‌های OTP با هش کد، هدف (Purpose)، زمان انقضا، تعداد تلاش و وضعیت مصرف برای جریان لاگین/ثبت‌نام.
-
-### لایه محتوا و کاتالوگ محصول
- **Category**: ساختار درختی دسته‌بندی با عنوان، توضیحات، تصویر، ترتیب نمایش و وضعیت فعال بودن. `ParentId` برای تو در تویی و ارتباط با `PruductCategory`.
- **Tag / PruductTag**: برچسب‌های قابل جستجو برای محصولات با وضعیت فعال و ترتیب. جدول واسط `PruductTag` اتصال چند-به-چند محصول و تگ را نگه می‌دارد.
- **Products**: جزئیات کامل محصول شامل توضیحات کوتاه/طولانی، قیمت، تخفیف، نرخ، تصاویر اصلی/Thumbnail، آمار فروش و موجودی. ارتباط با سبد، گالری، فاکتور، دسته و تگ.
- **ProductImages / ProductGallerys**: مدیریت دارایی‌های تصویری. `ProductImages` مشخصات فایل را نگه می‌دارد و `ProductGallerys` رابطه هر تصویر با یک محصول را ثبت می‌کند تا چیدمان گالری قابل کنترل باشد.
- **Package**: باندل یا سرویس قابل فروش با عنوان، توضیح، تصویر و قیمت ثابت که می‌تواند داخل سفارش کاربر قرار گیرد.
- **Category–Product Pivot (`PruductCategory`)**: ردیف‌های عضویت محصول در دسته‌های متعدد. هر ردیف شامل `ProductId` و `CategoryId` است.
-
-### لایه سفارش و تراکنش
- **UserCarts**: آیتم‌های سبد خرید کاربر، شامل شناسه محصول، کاربر و تعداد. منبع اصلی عملیات افزودن/حذف سبد در FrontOffice.
- **UserAddress**: آدرس‌های پستی کاربران با عنوان، متن آدرس، کد پستی، شهر، وضعیت پیش‌فرض و ارتباط با سفارش‌ها.
- **UserOrder**: سفارش نهایی شامل مبلغ، ارجاع به پکیج/تراکنش، وضعیت و تاریخ پرداخت، روش پرداخت، وضعیت ارسال، کد رهگیری و توضیحات ارسال. همچنین به آدرس کاربر و آیتم‌های فاکتور (`FactorDetails`) متصل است.
- **FactorDetails**: اقلام درون سفارش؛ هر ردیف به محصول و سفارش اشاره دارد و تعداد، قیمت واحد، تخفیف و وضعیت تغییر قیمت را نگه می‌دارد.
- **Transactions**: لاگ مالی سطح درگاه با مبلغ، توضیح، وضعیت/تاریخ پرداخت، شناسه مرجع درگاه و نوع تراکنش (Persistent در Enum `TransactionType`). سفارش‌ها می‌توانند به یک تراکنش اشاره کنند.
-
-### لایه کیف پول و تسویه
- **UserWallet**: کیف پول ریالی/شبکه‌ای هر کاربر با موجودی جاری و موجودی شبکه (`NetworkBalance`).
- **UserWalletChangeLog**: ژورنال تغییرات کیف پول شامل موجودی قبل/بعد، مقدار تغییر، تغییر شبکه، اینکه افزایش یا کاهش بوده و شناسه مرجع (مثلاً تراکنش یا سفارش). ستون `Created` منبع اصلی timestamp فاکتور کیف پول است.
-
-### لایه قرارداد و رعایت الزامات
- **Contract**: قالب قراردادها با عنوان، توضیحات، متن HTML و نوع قرارداد (`ContractType`).
- **UserContract**: سوابق موافقت کاربر با قراردادها، شامل فایل PDF امضا شده و `SignGuid` برای ردیابی امضا.
-
-## ماژول‌ها و بیزینس مفصل
-### کاربران و هویت
- **ثبت‌نام**: با دریافت موبایل، رکورد `User` ساخته و OTP برای تایید ارسال می‌شود. شرط یکتایی موبایل در سطح پایگاه داده enforced است و در Handler نیز بررسی می‌شود.
- **تکمیل پروفایل**: کاربر می‌تواند نام، کد ملی، تاریخ تولد و تنظیمات اعلان را تکمیل کند. فعال‌سازی اعلان‌ها به BFF اطلاع می‌دهد تا Subscription در سرویس پوش ثبت شود.
- **مدیریت نقش**: Admin می‌تواند از API `UserRoleCQ` برای افزودن نقش جدید استفاده کند؛ در صورت حذف نقش، ابتدا باید عضویت‌های فعال کاربر قطع شود.
-
-### کاتالوگ و محتوا
- **دسته‌بندی درختی**: سطح بی‌نهایت تو در تو پشتیبانی می‌شود. حذف یک دسته زمانی مجاز است که هیچ `Categorys` فرزند و هیچ `PruductCategory` فعالی نداشته باشد؛ در غیر این صورت باید انتقال انجام شود.
- **چرخه محصول**: ایجاد محصول شامل ثبت داده متنی، بارگذاری تصویر شاخص، تعریف قیمت و تعیین تخفیف است. تغییر قیمت در Handler ثبت شده و قوانین جلوگیری از عدد منفی یا Discount بزرگ‌تر از 100٪ اعمال می‌شود.
- **گالری و تصاویر**: ابتدا تصویر در `ProductImages` ثبت و سپس با `ProductGallerys` به محصول متصل می‌شود تا یک تصویر بتواند در چند محصول استفاده شود. حذف تصویر اگر در گالری فعال باشد ممنوع است.
- **پکیج‌ها**: برای فروش سرویس اشتراکی یا باندل؛ فیلد `Price` مبنای محاسبه سفارش‌های نوع Package است و تغییر قیمت روی سفارش‌های ثبت‌شده تاثیر ندارد زیرا مبلغ در `UserOrder.Amount` ذخیره می‌شود.
-
-### سفارش، پرداخت و لجستیک
- **سبد خرید**: عملیات Add/Update/Delete روی `UserCarts` انجام می‌شود. در هر لحظه برای ترکیب (User, Product) تنها یک رکورد وجود دارد. اگر Count صفر شود، رکورد حذف منطقی می‌شود تا تاریخچه حفظ گردد.
- **Checkout**: Handler `SubmitShopBuyOrder` اقلام سبد را قفل خوش‌بینانه کرده، سفارش (`UserOrder`) و اقلام فاکتور (`FactorDetails`) را می‌سازد، آدرس پیش‌فرض را نگاشت و وضعیت پرداخت را Pending می‌گذارد.
- **پرداخت آنلاین**: پس از هدایت به درگاه، سیستم CallBack در `TransactionsCQ` را دریافت می‌کند؛ شناسه مرجع (`RefId`) و مبلغ تطبیق داده می‌شود. در صورت موفقیت، `PaymentStatus` سفارش و تراکنش Success شده و `PaymentDate` ذخیره می‌شود. در صورت Reject، سبد به حالت قبل بازگردانده می‌شود.
- **پرداخت با کیف پول**: اگر موجودی کافی باشد، به صورت اتمیک از کیف پول کسر و سفارش Success می‌شود؛ نیازی به تراکنش درگاه نیست.
- **لجستیک**: فیلدهای `DeliveryStatus`, `TrackingCode`, `DeliveryDescription` وضعیت ارسال را پوشش می‌دهند. هر تغییر وضعیت می‌تواند Notification برای کاربر یا تیم پشتیبانی ایجاد کند.
-
-### کیف پول و تسویه داخلی
- **ساخت کیف پول**: همزمان با ثبت‌نام یا اولین تراکنش، رکورد `UserWallet` ساخته می‌شود. موجودی شبکه برای پشتیبانی از دارایی‌های خارج از پلتفرم است.
- **ChangeLog**: هر تغییر موجودی همراه با مقدار قبل/بعد، مقدار شبکه، نوع عملیات (Increase/Decrease) و `ReferenceId` ثبت می‌شود تا audit کافی فراهم گردد. Handler ها Idempotency را با بررسی ReferenceId رعایت می‌کنند.
- **واریز**: می‌تواند از طریق درگاه آنلاین یا عملیات دستی ادمین باشد. پس از تایید بانک، مبلغ به `Balance` افزوده و ChangeLog با نوع Deposit ذخیره می‌شود.
- **برداشت/تسویه**: درخواست Withdrawal ابتدا به صف تایید دستی می‌رود (Business Rule). پس از تایید، مبلغ از `Balance` کم و اگر نیاز به ارسال به شبکه بلاکچین باشد، `NetworkBalance` نیز به‌روزرسانی می‌شود.
- **بازپرداخت سفارش**: در صورت لغو سفارش پرداخت‌شده، مقدار پرداختی با ChangeLog نوع Refund به کیف پول برمی‌گردد تا کاربر بتواند مجدد خرید کند یا برداشت انجام دهد.
-
-### قرارداد و انطباق
- **مدیریت نسخه**: هر بار که متن قرارداد تغییر کند، رکورد جدیدی در `Contract` ساخته می‌شود. `UserContract` با نگه داشتن `ContractId` مشخص می‌کند کاربر کدام نسخه را امضا کرده است.
- **فرآیند امضا**: برای امضای دیجیتال، سیستم `SignGuid` را به سرویس امضای بیرونی ارسال می‌کند. پس از تکمیل، فایل PDF در فضای ذخیره‌سازی آپلود و مسیر آن در `UserContract.SignedPdfFile` ثبت می‌شود.
- **کنترل پذیرش قوانین**: فیلدهای `IsRulesAccepted` و `RulesAcceptedAt` در موجودیت User نیز نگهداری می‌شوند تا بتوان دفعات قبول قوانین عمومی را از قراردادهای اختصاصی تفکیک کرد.
-
-### گزارش و مانیتورینگ
- تمام Queries دارای پارامترهای Paging و Sorting هستند تا BackOffice بتواند داشبورد مدیریتی بسازد.
- به کمک Mapster Projection فقط ستون‌های مورد نیاز خوانده می‌شود؛ در موارد خاص (مثل تاریخ تراکنش کیف پول) Projection دستی به DTO اعمال شده است.
- ساختار CQRS اجازه می‌دهد که در آینده Event Handler یا Outbox برای همگام‌سازی با سرویس‌های دیگر اضافه شود.
-
-## فرایندهای بیزینسی کلیدی
-### 1. احراز هویت و ورود
-1. کاربر شماره موبایل را ارسال می‌کند؛ `OtpTokenCQ` یک رکورد جدید با کد هش‌شده، زمان انقضا و شمارش تلاش‌ها می‌سازد. درصورت وجود رکورد فعال، ابتدا Attempts چک و درصورت عبور از سقف، خطای تجاری برگردانده می‌شود.
-2. کاربر کد را ارسال می‌کند؛ سیستم hash تولید می‌کند و با `CodeHash` مقایسه می‌شود. در صورت موفقیت، `IsUsed` و `IsMobileVerified` تنظیم می‌شوند و تاریخ تایید موبایل ذخیره می‌گردد.
-3. اگر کاربر برای اولین‌بار وارد شود، کیف پول و Role پیش‌فرض ایجاد می‌شود. سپس سرویس JWT توکن امضا شده (همراه با Claims نقش‌ها) را برمی‌گرداند.
-
-### 2. مدیریت کاتالوگ و محتوای فروش
- اپراتور BackOffice از طریق دسته‌ها، تگ‌ها و محصولات API های `CategoryCQ`, `ProductsCQ`, `TagCQ` و … اقلام را CRUD می‌کند.
- تصاویر از طریق `ProductImagesCQ` ثبت و سپس با `ProductGallerysCQ` به محصولات لینک می‌شوند تا ترتیب نمایش قابل تغییر باشد.
- باندل‌های اشتراکی یا خدمات از طریق `PackageCQ` تعریف می‌شوند و در سفارش‌ها استفاده می‌شوند.
- قوانین کیفیت داده: عنوان و توضیح محصول نمی‌تواند خالی باشد، تصویر شاخص باید پیش از انتشار محصول مشخص شود و حداقل یک دسته فعال برای محصول الزامی است.
- وضعیت فعال/غیرفعال دسته‌ها در API لیست محصولات اعمال می‌شود تا محصولات دسته غیرفعال نمایش داده نشوند.
-
-### 3. تجربه خرید (Cart → Order → Transaction)
-1. FrontOffice اقلام را در `UserCarts` ثبت/ویرایش می‌کند.
-2. هنگام تسویه، Handler های `UserOrderCQ` سفارش و اقلام `FactorDetails` را می‌سازند، آدرس پیش‌فرض UserAddress را ضمیمه می‌کنند و وضعیت پرداخت را `Pending` قرار می‌دهند.
-3. پس از موفقیت درگاه، سرویس تراکنش (`TransactionsCQ`) شناسه مرجع را ذخیره و `PaymentStatus` سفارش و تراکنش را `Success` می‌کند؛ تاریخ پرداخت نیز ست می‌شود.
-4. وضعیت ارسال (`DeliveryStatus`) در طول فرایند Fulfillment آپدیت شده و کد رهگیری پستی داخل سفارش نگه‌داری می‌شود.
- سناریو شکست درگاه: اگر درگاه خطا دهد، سفارش در حالت Pending باقی می‌ماند و Job زمان‌بندی شده این سفارش‌ها را بعد از زمان مشخص لغو می‌کند تا سبد دوباره آزاد شود.
- امکان پرداخت ترکیبی (کیف پول + درگاه) وجود دارد؛ ابتدا از کیف پول برداشت و سپس باقی‌مانده به درگاه ارسال می‌شود.
-
-### 4. کیف پول و صورتحساب داخلی
- هر کاربر دقیقا یک کیف پول فعال دارد (`UserWalletCQ`).
- واریز/برداشت (چه ناشی از پرداخت آنلاین چه عملیات دستی) همیشه یک رکورد در `UserWalletChangeLog` ایجاد می‌کند تا موجودی قبلی، مقدار تغییر و منبع (ReferenceId) مشخص باشد.
- FrontOffice برای نمایش تاریخ دقیق تراکنش‌ها از `Created` لاگ استفاده می‌کند؛ بنابراین Handler های `UserWalletChangeLogCQ` حتما `CreatedAt` را به DTO و gRPC پاسخ اضافه می‌کنند.
- ChangeLog ها قابلیت فیلتر بر اساس نوع عملیات، بازه تاریخی و ReferenceId دارند و مقادیر در DTO به timestamp یونیکس هم تبدیل می‌شود تا فرانت به راحتی فرمت کند.
- عملیات دستی ادمین حتما توضیح (Description) و شناسه اپراتور را ثبت می‌کند تا audit کامل باشد.
-
-### 5. قراردادها و انطباق
- محتوای قرارداد (Term of Service، قرارداد نمایندگی و …) در `Contract` نگه‌داری می‌شود.
- هنگام امضا، یک `UserContract` شامل فایل PDF امضا شده و `SignGuid` ایجاد می‌گردد تا سوابق حقوقی نگهداری شود. این اطلاعات در درخواست‌های بعدی احراز می‌شوند تا از کاربران فقط یکبار امضا گرفته شود.
- در صورت به‌روزرسانی متن قرارداد، کاربران باید مجدداً آن را تایید کنند؛ FrontOffice هنگام ورود این شرط را بررسی و کاربر را به صفحه امضا هدایت می‌کند.
- سیستم گزارش می‌دهد چه تعداد کاربر هر نسخه را امضا کرده‌اند تا تیم حقوقی مطمئن شود پوشش قانونی کامل است.
-
-## نکات پیاده‌سازی و توسعه
- **CQRS پوشه‌بندی**: هر ماژول (مثلاً `UserWalletCQ`) شامل زیرپوشه‌های Commands و Queries است. درخواست‌های gRPC از پروژه Protobuf با DTO های Application نگاشت می‌شوند.
- **همگام‌سازی قراردادها**: هر زمان فیلد جدیدی به موجودیت اضافه شود باید DTO، Handler و قرارداد Protobuf متناظر نیز به‌روزرسانی و `dotnet build` برای تولید مجدد stubs اجرا شود. سپس BFF ها باید پکیج جدید را دریافت کنند.
- **اتصال با BFF**: CMS WebApi سرویس‌های gRPC را در پورت تعریف شده در `appsettings` اکسپوز می‌کند. BFF ها با استفاده از Channel مطمئن (TLS داخلی) به آن متصل می‌شوند و Mapster را برای تبدیل به مدل‌های فرانت استفاده می‌کنند.
- **Dependency Injection**: تمام Handler ها و سرویس‌ها در `CMSMicroservice.Application/ConfigureServices.cs` و `CMSMicroservice.Infrastructure/ConfigureServices.cs` ثبت می‌شوند تا تست‌پذیری افزایش یابد.
- **اعتبارسنجی و لاگ**: Behaviour های مشترک (LoggingBehaviour, ValidationBehaviour) روی Pipeline MediatR نشسته‌اند تا قبل از اجرای Handler، ورودی‌ها چک و لاگ ساختارمند تولید شود.
- **زمان‌بندی تمیزکاری**: ستون `IsDeleted` برای Soft Delete به‌کار می‌رود. Handler هایی که لیست می‌دهند معمولا فیلتر `!IsDeleted` را اعمال می‌کنند؛ برای نمایش آرشیو باید صراحتاً flag درخواست شود.
- **Enums مهم**: `PaymentStatus`, `PaymentMethod`, `DeliveryStatus`, `ContractType`, `TransactionType` طیف وضعیت‌های مالی/قراردادی را استاندارد می‌کنند و باید بین FrontOffice و BackOffice همسو نگه داشته شوند.
- **آیتم‌های Idempotent**: عملیات حساس مثل واریز کیف پول یا ثبت سفارش از ReferenceId استفاده می‌کنند تا در تکرار درخواست‌ها نتیجه‌ی تکراری ایجاد نشود.
-
-## مسیرهای مرتبط
- ساختار کد: `CMS/src/CMSMicroservice.Domain/Entities`, `CMSMicroservice.Application/*CQ`, `CMSMicroservice.Protobuf/Protos`.
- مستند حاضر: `CMS/docs/cms-data-and-business.md`
- نقاط تماس بیرونی: gRPC Endpoint های `CMSMicroservice.WebApi` به صورت داخلی مصرف می‌شوند و از طریق FrontOffice/BackOffice BFF در اختیار UI قرار می‌گیرند.
@@ -1,225 +0,0 @@
-# 🔄 Migration Guide: ParentId → NetworkParentId
-
-## 📋 Overview
-
-در سیستم قدیمی، کاربران با استفاده از `User.ParentId` به هم متصل می‌شدند (Parent-Child relationship).  
-سیستم جدید **Network-Club-Commission** از یک **Binary Tree** استفاده می‌کند که نیاز به:
- `User.NetworkParentId` (شناسه پدر در شبکه باینری)
- `User.LegPosition` (Left یا Right)
-
-برای اجرای صحیح Worker و محاسبات، **باید** تمام کاربران قدیمی Migrate شوند.
-
---
-
-## ⚠️ Critical Issues
-
-### مشکل 1: Binary Tree Constraint
- هر Parent فقط می‌تواند **2 فرزند** داشته باشد (Left & Right)
- اگر کاربری در سیستم قدیمی بیشتر از 2 فرزند دارد، Migration فقط **2 فرزند اول** را می‌گیرد
-
-### مشکل 2: Orphaned Nodes
- اگر `ParentId` اشاره به یک کاربر نامعتبر (حذف شده) باشد، آن User **Orphaned** است
- Orphaned nodes در Binary Tree نادیده گرفته می‌شوند
-
---
-
-## 🚀 Migration Methods
-
-### روش 1: Automatic (Seeder - توصیه می‌شود)
-
-Migration به صورت خودکار در `Program.cs` در حالت **Development** اجرا می‌شود:
-
-```csharp
-// در Program.cs
-var migrationSeeder = new NetworkParentIdMigrationSeeder(dbContext, logger);
-await migrationSeeder.SeedAsync();
-```
-
-**مزایا:**
- ✅ Idempotent (می‌توان چندین بار اجرا کرد، فقط یکبار تاثیر می‌گذارد)
- ✅ Validation اتوماتیک
- ✅ Logging کامل
-
-**کجا اجرا می‌شود؟**
- فقط در **Development** environment
- هر بار که پروژه Run شود
-
---
-
-### روش 2: Manual (Command)
-
-اگر نیاز به اجرای دستی دارید:
-
-```csharp
-// درخواست از طریق MediatR
-var result = await _mediator.Send(new MigrateNetworkParentIdCommand());
-
-if (result.Success)
-{
-    Console.WriteLine($"Migrated: {result.MigratedCount}");
-    Console.WriteLine($"Skipped: {result.SkippedCount}");
-}
-else
-{
-    Console.WriteLine($"Error: {result.Message}");
-}
-```
-
---
-
-### روش 3: SQL Script
-
-برای Production یا اجرای مستقیم روی Database:
-
-```bash
-# فایل: CMSMicroservice.Infrastructure/Migrations/Scripts/20250601_MigrateParentIdToNetworkParentId.sql
-```
-
-**نکته مهم:**  
-قبل از اجرا، **حتماً** بررسی کنید که آیا کاربری بیش از 2 فرزند دارد:
-
-```sql
-SELECT 
-    ParentId, 
-    COUNT(*) as ChildCount,
-    STRING_AGG(CAST(Id AS VARCHAR), ', ') as ChildIds
-FROM Users
-WHERE ParentId IS NOT NULL
-GROUP BY ParentId
-HAVING COUNT(*) > 2;
-```
-
---
-
-## 📊 Validation After Migration
-
-### 1. بررسی تعداد کاربران Migrate شده
-
-```csharp
-var stats = await _context.Users
-    .GroupBy(u => 1)
-    .Select(g => new
-    {
-        TotalUsers = g.Count(),
-        UsersWithNetworkParent = g.Count(u => u.NetworkParentId != null),
-        LeftChildren = g.Count(u => u.LegPosition == NetworkLeg.Left),
-        RightChildren = g.Count(u => u.LegPosition == NetworkLeg.Right)
-    })
-    .FirstOrDefaultAsync();
-```
-
-### 2. بررسی Orphaned Nodes
-
-```sql
-SELECT Id, NetworkParentId
-FROM Users
-WHERE NetworkParentId IS NOT NULL
-  AND NetworkParentId NOT IN (SELECT Id FROM Users);
-```
-
-### 3. بررسی Binary Tree Violation
-
-```sql
-SELECT NetworkParentId, COUNT(*) as ChildCount
-FROM Users
-WHERE NetworkParentId IS NOT NULL
-GROUP BY NetworkParentId
-HAVING COUNT(*) > 2;
-```
-
---
-
-## ⚙️ Algorithm Details
-
-### مراحل Migration:
-
-1. **Find Users**: یافتن کاربران با `ParentId != NULL` و `NetworkParentId == NULL`
-2. **Group by Parent**: گروه‌بندی بر اساس ParentId
-3. **Check Constraint**: اگر Parent بیش از 2 فرزند دارد، فقط 2 تا اول را بگیر
-4. **Assign Values**:
-   ```csharp
-   child.NetworkParentId = parentId;
-   child.LegPosition = (i == 0) ? NetworkLeg.Left : NetworkLeg.Right;
-   ```
-5. **Save & Validate**: ذخیره و اعتبارسنجی Binary Tree
-
---
-
-## 🐛 Troubleshooting
-
-### مشکل: Parent has more than 2 children
-
-**راه حل:**  
-تصمیم دستی بگیرید که کدام 2 فرزند را نگه دارید:
-
-```sql
-- بررسی کنید که کدام Parent مشکل دارد
-SELECT ParentId, COUNT(*) as ChildCount
-FROM Users
-WHERE ParentId = 123
-GROUP BY ParentId;
-
-- لیست فرزندان را ببینید
-SELECT Id, FullName, CreatedAt
-FROM Users
-WHERE ParentId = 123
-ORDER BY CreatedAt;
-
-- دستی NetworkParentId را برای 2 فرزند انتخابی Set کنید
-UPDATE Users
-SET NetworkParentId = 123, LegPosition = 0 -- Left
-WHERE Id = 456;
-
-UPDATE Users
-SET NetworkParentId = 123, LegPosition = 1 -- Right
-WHERE Id = 789;
-```
-
---
-
-### مشکل: Orphaned Nodes (Parent doesn't exist)
-
-**راه حل:**  
-ParentId را NULL کنید یا به یک Parent معتبر متصل کنید:
-
-```sql
-- گزینه 1: NULL کردن (Root شدن)
-UPDATE Users
-SET ParentId = NULL, NetworkParentId = NULL
-WHERE ParentId = 999; -- 999 وجود ندارد
-
-- گزینه 2: اتصال به Parent دیگر
-UPDATE Users
-SET ParentId = 1, NetworkParentId = 1
-WHERE ParentId = 999;
-```
-
---
-
-## ✅ Checklist Before Production
-
- [ ] Migration در Development اجرا شده؟
- [ ] Validation Errors بررسی شد؟
- [ ] Orphaned Nodes رفع شدند؟
- [ ] Binary Tree Violations رفع شدند؟
- [ ] Backup از Database گرفته شده؟
- [ ] Migration Script برای Production آماده است؟
- [ ] Testing کامل انجام شده؟
-
---
-
-## 🔗 Related Files
-
- **Seeder**: `CMSMicroservice.Infrastructure/Data/Seeding/NetworkParentIdMigrationSeeder.cs`
- **Command**: `CMSMicroservice.Application/UserCQ/Commands/MigrateNetworkParentId/`
- **SQL Script**: `CMSMicroservice.Infrastructure/Migrations/Scripts/20250601_MigrateParentIdToNetworkParentId.sql`
- **Entity**: `CMSMicroservice.Domain/Entities/User.cs` (خطوط 16, 45, 49)
-
---
-
-## 📞 Support
-
-اگر مشکل خاصی با Migration پیدا کردید:
-1. Log های Seeder را بررسی کنید
-2. ValidationErrors را چک کنید
-3. SQL Script را به صورت دستی اجرا کنید
@@ -1,642 +0,0 @@
-# Network Tree - Activation Week Feature
-
-## نمای کلی (Overview)
-
-این سند تغییرات مربوط به افزودن قابلیت فیلتر و نمایش هفته فعال‌سازی در درخت شبکه را توضیح می‌دهد.
-
-**تاریخ پیاده‌سازی:** دسامبر 2025
-
-**تغییرات کلیدی:**
- اضافه شدن فیلد `IsActivatedInTargetWeek` برای flagging (به جای filtering)
- حذف فیلتر سمت Backend و انتقال به UI
- نمایش بصری وضعیت فعال‌سازی در درخت
-
---
-
-## منطق کسب‌وکار (Business Logic)
-
-### رویکرد قبلی (❌ Removed)
- فیلتر می‌کرد و فقط نودهایی که در هفته هدف فعال شده‌اند نمایش داده می‌شدند
- مشکل: کاربران نمی‌توانستند کل ساختار شبکه را ببینند
-
-### رویکرد جدید (✅ Current)
- **همه نودها نمایش داده می‌شوند** (بدون فیلتر در دیتابیس)
- هر نود یک flag دارد: `IsActivatedInTargetWeek`
- UI از این flag برای نمایش بصری استفاده می‌کند
-
-### محاسبه هفته فعال‌سازی
-
-```csharp
-private static int CalculateWeekNumber(DateTimeOffset date)
-{
-    var persianCalendar = new PersianCalendar();
-    int year = persianCalendar.GetYear(date.DateTime);
-    int dayOfYear = persianCalendar.GetDayOfYear(date.DateTime);
-    int weekNumber = (dayOfYear - 1) / 7 + 1;
-    
-    return int.Parse($"{year}{weekNumber:D2}");
-    // مثال: 140352 = سال 1403، هفته 52
-}
-```
-
---
-
-## تغییرات Backend
-
-### 1. DTO Changes
-
-**فایل:** `CMSMicroservice.Application/NetworkMembershipCQ/Queries/GetNetworkTree/NetworkTreeDto.cs`
-
-```csharp
-public class NetworkTreeDto
-{
-    // ... existing fields
-    public string? ActivationWeekNumber { get; set; }
-    public bool IsActivatedInTargetWeek { get; set; }  // ✅ NEW
-    public DateTimeOffset UserCreated { get; set; }
-    public NetworkTreeDto? LeftChild { get; set; }
-    public NetworkTreeDto? RightChild { get; set; }
-}
-```
-
-### 2. Query Handler Changes
-
-**فایل:** `CMSMicroservice.Application/NetworkMembershipCQ/Queries/GetNetworkTree/GetNetworkTreeQueryHandler.cs`
-
-#### تغییر در BuildTree Method
-
-```csharp
-private NetworkTreeDto BuildTree(
-    User user, 
-    int currentDepth, 
-    int maxDepth, 
-    string? requestActivationWeekNumber)  // ✅ پارامتر اضافه شد
-{
-    // محاسبه هفته فعال‌سازی
-    string? activationWeekNumber = null;
-    bool isActivatedInTargetWeek = false;
-    
-    if (user.ClubMembership?.ActivatedAt != null)
-    {
-        activationWeekNumber = CalculateWeekNumber(user.ClubMembership.ActivatedAt.Value)
-            .ToString();
-        
-        // چک کردن اینکه آیا در هفته هدف فعال شده
-        if (!string.IsNullOrEmpty(requestActivationWeekNumber))
-        {
-            isActivatedInTargetWeek = activationWeekNumber == requestActivationWeekNumber;
-        }
-    }
-
-    var node = new NetworkTreeDto
-    {
-        // ... existing fields
-        ActivationWeekNumber = activationWeekNumber,
-        IsActivatedInTargetWeek = isActivatedInTargetWeek,  // ✅ تنظیم flag
-    };
-
-    // ... recursive calls
-}
-```
-
-#### حذف فیلتر از GetFilteredChildren
-
-**قبل (❌):**
-```csharp
-private IEnumerable<User> GetFilteredChildren(
-    IEnumerable<User> children, 
-    bool? isClubActive, 
-    string? activationWeekNumber)
-{
-    var query = children.AsQueryable();
-
-    if (isClubActive.HasValue)
-    {
-        query = query.Where(u => u.ClubMembership != null && 
-                                 u.ClubMembership.IsActive == isClubActive.Value);
-    }
-
-    if (!string.IsNullOrEmpty(activationWeekNumber))
-    {
-        // ❌ فیلتر می‌کرد
-        query = query.Where(u => /* filter logic */);
-    }
-
-    return query.ToList();
-}
-```
-
-**بعد (✅):**
-```csharp
-private IEnumerable<User> GetFilteredChildren(
-    IEnumerable<User> children, 
-    bool? isClubActive)
-{
-    var query = children.AsQueryable();
-
-    // فقط فیلتر IsClubActive باقی ماند
-    if (isClubActive.HasValue)
-    {
-        query = query.Where(u => u.ClubMembership != null && 
-                                 u.ClubMembership.IsActive == isClubActive.Value);
-    }
-
-    return query.ToList();
-}
-```
-
-### 3. Proto Definition
-
-**فایل:** `CMSMicroservice.Protobuf/Protos/networkmembership.proto`
-
-```protobuf
-message NetworkTreeNodeModel {
-    int64 user_id = 1;
-    string user_name = 2;
-    optional int64 parent_id = 3;
-    optional int32 network_leg = 4;
-    optional int32 network_level = 5;
-    optional bool is_active = 6;
-    optional google.protobuf.Timestamp joined_at = 7;
-    optional google.protobuf.Timestamp club_activated_at = 8;
-    bool is_club_active = 9;
-    string activation_week_number = 10;
-    bool is_activated_in_target_week = 11;  // ✅ NEW
-    google.protobuf.Timestamp user_created = 12;
-}
-```
-
-### 4. Mapping
-
-**فایل:** `CMSMicroservice.WebApi/Common/Mappings/NetworkMembershipProfile.cs`
-
-```csharp
-var protoNode = new NetworkTreeNodeModel
-{
-    UserId = node.UserId,
-    UserName = node.UserName,
-    ParentId = node.ParentId,
-    NetworkLeg = node.NetworkLeg,
-    NetworkLevel = node.NetworkLevel,
-    IsActive = node.IsActive,
-    JoinedAt = node.JoinedAt.HasValue 
-        ? Timestamp.FromDateTime(DateTime.SpecifyKind(node.JoinedAt.Value, DateTimeKind.Utc)) 
-        : null,
-    ClubActivatedAt = node.ClubActivatedAt.HasValue
-        ? Timestamp.FromDateTime(DateTime.SpecifyKind(node.ClubActivatedAt.Value, DateTimeKind.Utc))
-        : null,
-    IsClubActive = node.IsClubActive,
-    ActivationWeekNumber = node.ActivationWeekNumber ?? string.Empty,
-    IsActivatedInTargetWeek = node.IsActivatedInTargetWeek,  // ✅ NEW
-    UserCreated = Timestamp.FromDateTime(DateTime.SpecifyKind(node.UserCreated, DateTimeKind.Utc))
-};
-```
-
---
-
-## تغییرات BFF
-
-### Proto & Mapping
-
-همان تغییرات در CMS در BFF هم اعمال شد:
-
-**فایل‌ها:**
- `BackOffice.BFF.Application/NetworkMembershipCQ/Queries/GetNetworkTree/GetNetworkTreeResponseDto.cs`
- `BackOffice.BFF.WebApi/Common/Mappings/NetworkMembershipProfile.cs`
- `Protobufs/networkmembership.proto`
-
-```csharp
-public class NetworkTreeNodeDto
-{
-    // ... existing properties
-    public bool IsActivatedInTargetWeek { get; set; }  // ✅ NEW
-    public string ActivationWeekNumber { get; set; } = string.Empty;
-}
-```
-
---
-
-## تغییرات Frontend
-
-### 1. Razor Component
-
-**فایل:** `BackOffice/Pages/Network/NetworkTreeViewer.razor`
-
-#### تغییر در ستون "وضعیت"
-
-**قبل (❌):**
-```razor
-<PropertyColumn Property="x => x.IsActive" Title="وضعیت">
-    <CellTemplate>
-    @if (context.Item.IsActive!=null) {
-        <MudChip Color="@((bool)context.Item.IsActive ? Color.Success : Color.Error)">
-            @((bool)context.Item.IsActive ? "فعال" : "غیرفعال")
-        </MudChip>
-    }
-    </CellTemplate>
-</PropertyColumn>
-```
-
-**بعد (✅):**
-```razor
-<PropertyColumn Property="x => x.IsClubActive" Title="وضعیت">
-    <CellTemplate>
-        <MudChip T="string"
-                 Color="@(context.Item.IsClubActive ? Color.Success : Color.Error)"
-                 Size="Size.Small">
-            @(context.Item.IsClubActive ? "فعال" : "غیرفعال")
-        </MudChip>
-    </CellTemplate>
-</PropertyColumn>
-```
-
-#### ارسال داده به JavaScript
-
-```csharp
-private async Task RenderTree()
-{
-    if (_treeData == null || !_treeData.Nodes.Any()) return;
-
-    var jsNodes = _treeData.Nodes.Select(n => new
-    {
-        userId = n.UserId,
-        userName = n.UserName,
-        parentId = n.ParentId,
-        networkLevel = n.NetworkLevel,
-        networkLeg = n.NetworkLeg,
-        isActive = n.IsClubActive,  // ✅ تغییر به IsClubActive
-        isClubActive = n.IsClubActive,
-        isActivatedInTargetWeek = n.IsActivatedInTargetWeek,  // ✅ NEW
-        activationWeekNumber = _activationWeekFilter ?? "",  // ✅ فیلتر UI
-        clubActivatedAt = n.ClubActivatedAt?.ToDateTime().ToLocalTime().ToString("yyyy/MM/dd") ?? "",
-        userCreated = n.UserCreated?.ToDateTime().ToLocalTime().ToString("yyyy/MM/dd") ?? ""
-    }).ToArray();
-
-    await JS.InvokeVoidAsync("NetworkTreeViewer.initialize", "network-tree-container", jsNodes);
-}
-```
-
-**نکته مهم:** `activationWeekNumber` از فیلتر UI گرفته می‌شود (`_activationWeekFilter`) نه از Backend.
-
-### 2. JavaScript Visualization
-
-**فایل:** `BackOffice/wwwroot/js/network-tree.js`
-
-#### منطق رنگ نود (دایره)
-
-```javascript
-node.append('circle')
-    .attr('r', 8)
-    .style('fill', d => {
-        // اگر هفته‌ای انتخاب نشده، همه سبز
-        if (!d.data.activationWeekNumber || d.data.activationWeekNumber === '') {
-            return '#4caf50';
-        }
-        // اگر در هفته هدف فعال شده، سبز، وگرنه قرمز
-        return d.data.isActivatedInTargetWeek ? '#4caf50' : '#f44336';
-    })
-    .style('stroke', '#fff')
-    .style('stroke-width', 2)
-    .style('cursor', 'pointer');
-```
-
-#### منطق رنگ تایتل (نام کاربر)
-
-```javascript
-node.append('text')
-    .attr('dy', -15)
-    .attr('text-anchor', 'middle')
-    .style('font-size', '12px')
-    .style('font-weight', 'bold')
-    .style('fill', d => d.data.isClubActive ? '#424242' : '#9e9e9e')
-    .text(d => d.data.userName || `User ${d.data.userId}`);
-```
-
-#### اضافه کردن فیلدها به buildHierarchy
-
-```javascript
-buildHierarchy: function(nodes) {
-    // ...
-    const nodeMap = new Map();
-    nodes.forEach(node => {
-        nodeMap.set(node.userId, {
-            userId: node.userId,
-            userName: node.userName,
-            parentId: node.parentId,
-            level: node.networkLevel,
-            networkLeg: node.networkLeg,
-            isActive: node.isActive,
-            isClubActive: node.isClubActive,  // ✅ NEW
-            isActivatedInTargetWeek: node.isActivatedInTargetWeek,  // ✅ NEW
-            activationWeekNumber: node.activationWeekNumber,  // ✅ NEW
-            clubActivatedAt: node.clubActivatedAt,
-            userCreated: node.userCreated,
-            children: []
-        });
-    });
-    // ...
-}
-```
-
-#### Legend (راهنمای رنگ‌ها)
-
-```javascript
-// Legend for title colors (club status)
-legend.append('text')
-    .attr('x', 0)
-    .attr('y', 0)
-    .style('font-size', '12px')
-    .style('font-weight', 'bold')
-    .style('fill', '#424242')
-    .text('باشگاه فعال');
-
-legend.append('text')
-    .attr('x', 0)
-    .attr('y', 20)
-    .style('font-size', '12px')
-    .style('font-weight', 'bold')
-    .style('fill', '#9e9e9e')
-    .text('باشگاه غیرفعال');
-
-// Legend for circles (week status)
-legend.append('circle')
-    .attr('cx', 0)
-    .attr('cy', 50)
-    .attr('r', 6)
-    .style('fill', '#4caf50');
-
-legend.append('text')
-    .attr('x', 12)
-    .attr('y', 54)
-    .style('font-size', '12px')
-    .text('فعال در هفته هدف');
-
-legend.append('circle')
-    .attr('cx', 0)
-    .attr('cy', 75)
-    .attr('r', 6)
-    .style('fill', '#f44336');
-
-legend.append('text')
-    .attr('x', 12)
-    .attr('y', 79)
-    .style('font-size', '12px')
-    .text('خارج از هفته هدف');
-```
-
---
-
-## رفتار UI
-
-### حالت 1: بدون فیلتر هفته
-
-**وضعیت:** `_activationWeekFilter` خالی است
-
-**رفتار:**
- **دایره‌ها:** همه سبز (#4caf50)
- **تایتل:** مشکی (#424242) برای باشگاه فعال، خاکستری (#9e9e9e) برای باشگاه غیرفعال
-
-### حالت 2: با فیلتر هفته
-
-**وضعیت:** مثلاً `_activationWeekFilter = "140352"`
-
-**رفتار:**
- **دایره‌ها:**
-  - سبز (#4caf50) → کاربران فعال شده در هفته 52 سال 1403
-  - قرمز (#f44336) → کاربران فعال شده در هفته‌های دیگر
- **تایتل:** همچنان بر اساس `isClubActive`
-
-### حالت 3: فیلتر IsClubActive
-
-این فیلتر در سمت Backend اعمال می‌شود و نودهای غیرفعال را حذف می‌کند.
-
---
-
-## Flow Diagram
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                         User Interface                       │
-│  ┌────────────────┐  ┌──────────────────┐                  │
-│  │ IsClubActive   │  │ActivationWeek    │                  │
-│  │ Filter         │  │ Filter           │                  │
-│  └────────┬───────┘  └────────┬─────────┘                  │
-└───────────┼──────────────────┼────────────────────────────┘
-            │                   │
-            ▼                   ▼
-┌─────────────────────────────────────────────────────────────┐
-│                    Backend (CMS)                            │
-│  ┌──────────────────────────────────────────────────────┐  │
-│  │ GetNetworkTreeQueryHandler                           │  │
-│  │                                                       │  │
-│  │  1. GetFilteredChildren (IsClubActive filter only)   │  │
-│  │  2. BuildTree (calculate IsActivatedInTargetWeek)    │  │
-│  │  3. Return ALL nodes with flags                      │  │
-│  └──────────────────────────────────────────────────────┘  │
-└───────────────────────────┬─────────────────────────────────┘
-                            │
-                            ▼
-┌─────────────────────────────────────────────────────────────┐
-│                         BFF Layer                            │
-│  - Proto mapping                                            │
-│  - Pass-through to Frontend                                 │
-└───────────────────────────┬─────────────────────────────────┘
-                            │
-                            ▼
-┌─────────────────────────────────────────────────────────────┐
-│                   Frontend (Blazor)                         │
-│  ┌──────────────────────────────────────────────────────┐  │
-│  │ NetworkTreeViewer.razor                              │  │
-│  │                                                       │  │
-│  │  - Prepare data with UI filter (_activationWeekFilter)│ │
-│  │  - Send to JavaScript                                │  │
-│  └──────────────────────────────────────────────────────┘  │
-└───────────────────────────┬─────────────────────────────────┘
-                            │
-                            ▼
-┌─────────────────────────────────────────────────────────────┐
-│                    JavaScript (D3.js)                       │
-│  ┌──────────────────────────────────────────────────────┐  │
-│  │ network-tree.js                                       │  │
-│  │                                                       │  │
-│  │  - Apply visual logic:                               │  │
-│  │    * Circle color by activationWeekNumber + flag     │  │
-│  │    * Title color by isClubActive                     │  │
-│  └──────────────────────────────────────────────────────┘  │
-└─────────────────────────────────────────────────────────────┘
-```
-
---
-
-## Data Model
-
-### Request
-
-```csharp
-public class GetNetworkTreeRequest
-{
-    public long UserId { get; set; }
-    public int? MaxDepth { get; set; }
-    public bool? IsClubActive { get; set; }          // Backend filter
-    public string? ActivationWeekNumber { get; set; }  // For flag calculation only
-}
-```
-
-### Response
-
-```csharp
-public class NetworkTreeDto
-{
-    public long UserId { get; set; }
-    public string UserName { get; set; }
-    public long? ParentId { get; set; }
-    public int? NetworkLeg { get; set; }
-    public int? NetworkLevel { get; set; }
-    public bool? IsActive { get; set; }  // Deprecated
-    public DateTime? JoinedAt { get; set; }
-    public DateTime? ClubActivatedAt { get; set; }
-    public bool IsClubActive { get; set; }  // ✅ Use this
-    public string? ActivationWeekNumber { get; set; }
-    public bool IsActivatedInTargetWeek { get; set; }  // ✅ NEW
-    public DateTimeOffset UserCreated { get; set; }
-    public NetworkTreeDto? LeftChild { get; set; }
-    public NetworkTreeDto? RightChild { get; set; }
-}
-```
-
---
-
-## Testing Scenarios
-
-### Test 1: بدون فیلتر
-**Input:**
- `IsClubActive`: null
- `ActivationWeekNumber`: null
-
-**Expected:**
- همه نودها نمایش داده شوند
- همه دایره‌ها سبز
- تایتل‌ها بر اساس IsClubActive
-
-### Test 2: فیلتر باشگاه فعال
-**Input:**
- `IsClubActive`: true
- `ActivationWeekNumber`: null
-
-**Expected:**
- فقط نودهای با باشگاه فعال
- همه دایره‌ها سبز
- همه تایتل‌ها مشکی
-
-### Test 3: فیلتر هفته
-**Input:**
- `IsClubActive`: null
- `ActivationWeekNumber`: "140352"
-
-**Expected:**
- همه نودها نمایش داده شوند
- دایره سبز: فعال شده در هفته 52
- دایره قرمز: فعال شده در هفته‌های دیگر
- تایتل‌ها بر اساس IsClubActive
-
-### Test 4: ترکیب فیلترها
-**Input:**
- `IsClubActive`: true
- `ActivationWeekNumber`: "140352"
-
-**Expected:**
- فقط نودهای با باشگاه فعال
- دایره سبز: فعال شده در هفته 52
- دایره قرمز: فعال شده در هفته‌های دیگر
- همه تایتل‌ها مشکی (چون همه باشگاه فعال دارند)
-
---
-
-## Performance Considerations
-
-### Database Query
- ✅ فیلتر `ActivationWeekNumber` از Query حذف شد
- ✅ فقط فیلتر `IsClubActive` در سمت دیتابیس
- ⚠️ ممکن است تعداد نودهای بیشتری بازگردانده شود
-
-### Memory
- Backend همه نودها را می‌فرستد
- Frontend/JavaScript فیلتر بصری اعمال می‌کند
- برای درخت‌های بسیار بزرگ (>1000 نود) ممکن است نیاز به pagination باشد
-
-### UI Rendering
- D3.js برای درخت‌های متوسط (<500 نود) عملکرد خوبی دارد
- برای بهبود عملکرد می‌توان از virtualization استفاده کرد
-
---
-
-## Migration Notes
-
-### Breaking Changes
- ❌ `IsActive` deprecated است → استفاده از `IsClubActive`
- ✅ فیلد جدید `IsActivatedInTargetWeek` اضافه شد
-
-### Backward Compatibility
- Proto field numbers حفظ شده‌اند
- Response structure تغییر نکرده (فقط فیلد جدید اضافه شده)
-
-### Deployment Steps
-1. Deploy Backend (CMS) با Proto جدید
-2. Deploy BFF با Proto جدید
-3. Deploy Frontend با visualization جدید
-4. تست تمام scenarios
-
---
-
-## نکات مهم (Key Points)
-
-### ✅ Do's
- از `IsClubActive` برای وضعیت باشگاه استفاده کنید
- `IsActivatedInTargetWeek` فقط برای نمایش بصری است
- فیلتر UI را از Razor به JS بفرستید (`_activationWeekFilter`)
-
-### ❌ Don'ts
- از `IsActive` استفاده نکنید (deprecated)
- `ActivationWeekNumber` را از Backend برای UI filtering استفاده نکنید
- فیلتر `ActivationWeekNumber` را در Query اعمال نکنید
-
-### 💡 Best Practices
- همیشه فیلتر UI و Backend flag را sync نگه دارید
- برای درخت‌های بزرگ از lazy loading استفاده کنید
- Legend را همیشه با منطق UI sync کنید
-
---
-
-## فایل‌های تغییر یافته
-
-### Backend (CMS)
- ✅ `NetworkTreeDto.cs` - اضافه `IsActivatedInTargetWeek`
- ✅ `GetNetworkTreeQueryHandler.cs` - محاسبه flag + حذف فیلتر
- ✅ `networkmembership.proto` - اضافه field 11
- ✅ `NetworkMembershipProfile.cs` - mapping فیلد جدید
-
-### BFF
- ✅ `GetNetworkTreeResponseDto.cs` - اضافه property
- ✅ `NetworkMembershipProfile.cs` - mapping
- ✅ `networkmembership.proto` - sync با CMS
-
-### Frontend
- ✅ `NetworkTreeViewer.razor` - تغییر `IsActive` → `IsClubActive`
- ✅ `NetworkTreeViewer.razor` - اضافه `isActivatedInTargetWeek` به jsNodes
- ✅ `network-tree.js` - منطق رنگ نود بر اساس flag
- ✅ `network-tree.js` - منطق رنگ تایتل بر اساس `isClubActive`
- ✅ `network-tree.js` - Legend جدید
-
---
-
-## مراجع (References)
-
- [Binary Tree Guide](../../01-BUSINESS/binary-tree-guide.md)
- [Network Commission System](../../01-BUSINESS/network-commission-system.md)
- [CMS API Coverage](./api-coverage.md)
-
---
-
-**تاریخ ایجاد:** 14 دسامبر 2025
-**آخرین به‌روزرسانی:** 14 دسامبر 2025
-**نویسنده:** Development Team
@@ -1,410 +0,0 @@
-# Payment Architecture with PYMS Microservice
-
-**تاریخ**: 2024-12-02  
-**وضعیت**: Architecture Document  
-**اولویت**: 🔴 بالا (اطلاعات مهم برای Phase 9)
-
---
-
-## 📋 خلاصه
-
-**درگاه پرداخت** در این پروژه از طریق **مایکروسرویس PYMS** (`Afrino.PYMSMicroservice.Protobuf`) مدیریت می‌شود.
-
-**CMS Microservice** فقط **نتیجه نهایی پرداخت** را ثبت می‌کند و خودش درگاه پرداخت را پیاده‌سازی نمی‌کند.
-
---
-
-## 🏗️ معماری کلی
-
-```
-[User Frontend] 
-      ↓
-[FrontOffice.BFF]  ← درخواست خرید از اینجا شروع می‌شود
-      ↓
-[PYMS Microservice] ← مدیریت درگاه پرداخت (Afrino.PYMSMicroservice.Protobuf)
-      ↓
-[Payment Gateway: در PYMS/Gateway - نه CMS]
-      ↓ (Callback)
-[PYMS Microservice] ← تایید پرداخت
-      ↓
-[CMS Microservice] ← **فقط ثبت نتیجه** (Transaction با RefId)
-```
-
-### توضیح جریان:
-
-1. **کاربر** محصول را در Frontend انتخاب می‌کند
-2. **FrontOffice.BFF** درخواست خرید را به **PYMS Microservice** می‌فرستد
-3. **PYMS/Gateway** با درگاه پرداخت (بانک) ارتباط برقرار می‌کند و پرداخت را انجام می‌دهد
-4. **Gateway** نتیجه پرداخت را به **CMS Callback** می‌فرستد
-5. **CMS** تراکنش را تایید و عملیات بعدی (فعال‌سازی، اضافه PV، Wallet) را انجام می‌دهد
-4. **PYMS** URL درگاه را برمی‌گرداند
-5. کاربر به درگاه ریدایرکت می‌شود و پرداخت می‌کند
-6. بعد از پرداخت، **Callback** به **PYMS** برمی‌گردد
-7. **PYMS** پرداخت را Verify می‌کند
-8. **FrontOffice.BFF** نتیجه را به **CMS** می‌فرستد
-9. **CMS** Transaction را با RefId و وضعیت نهایی ثبت می‌کند
-
---
-
-## 📦 Package: `Afrino.PYMSMicroservice.Protobuf`
-
-**Version**: 0.0.11  
-**Type**: gRPC Protobuf Client  
-**Namespace**: `PYMSMicroservice.Protobuf.Protos.Transaction`
-
-### Dependencies:
- Google.Protobuf (3.23.3)
- Grpc.Core.Api (2.54.0)
- FluentValidation (11.2.2)
- Google.Api.CommonProtos (2.10.0)
-
---
-
-## 🔧 TransactionContract Service
-
-### Client Class:
-```csharp
-using PYMSMicroservice.Protobuf.Protos.Transaction;
-using Grpc.Core;
-
-var client = new TransactionContract.TransactionContractClient(channel);
-```
-
-### Available Methods:
-
-#### 1. **PaymentRequest** (شروع پرداخت)
-```csharp
-// Request
-var request = new PaymentRequestRequest
-{
-    MerchantId = "YOUR_MERCHANT_ID",        // شناسه فروشنده
-    Amount = 100000,                         // مبلغ به ریال (یا تومان - بستگی به Currency)
-    CallbackUrl = "https://yoursite.com/payment/callback",
-    Description = "خرید بسته طلایی",
-    Mobile = "09123456789",                  // اختیاری
-    Email = "user@example.com",              // اختیاری
-    Currency = CurrencyEnum.Irt,             // IRR (ریال) یا IRT (تومان)
-    Type = TransactionTypeEnum.Real,         // Real یا Sandbox
-    OrderId = "ORDER_123456"                 // اختیاری - شناسه سفارش خودمان
-};
-
-// Call
-var response = await client.PaymentRequestAsync(request);
-
-// Response
-Console.WriteLine(response.PaymentGWUrl); 
-// مثال: "https://bpm.shaparak.ir/pgwchannel/startpay.mellat?RefId=123456"
-```
-
-**Response Fields**:
- `PaymentGWUrl` (string): URL درگاه پرداخت که کاربر باید به آن ریدایرکت شود
-
-#### 2. **PaymentVerification** (تایید پرداخت)
-```csharp
-// Request
-var request = new PaymentVerificationRequest
-{
-    Authority = "AUTHORITY_FROM_CALLBACK",   // Authority که از callback می‌آید
-    Status = "OK"                             // Status که از callback می‌آید (OK/NOK)
-};
-
-// Call
-var response = await client.PaymentVerificationAsync(request);
-
-// Response
-if (response.PaymentStatus)
-{
-    Console.WriteLine($"پرداخت موفق!");
-    Console.WriteLine($"RefId: {response.RefId}");
-    Console.WriteLine($"OrderId: {response.OrderId}");
-    Console.WriteLine($"Message: {response.Message}");
-    Console.WriteLine($"VerificationStatusCode: {response.VerificationStatusCode}");
-}
-else
-{
-    Console.WriteLine($"پرداخت ناموفق: {response.Message}");
-}
-```
-
-**Response Fields**:
- `Id` (long): شناسه تراکنش در سیستم PYMS
- `PaymentStatus` (bool): وضعیت پرداخت (true = موفق، false = ناموفق)
- `Message` (string): پیام وضعیت
- `RefId` (string): شناسه مرجع از درگاه پرداخت
- `OrderId` (string): شناسه سفارش که در PaymentRequest ارسال شده
- `VerificationStatusCode` (int): کد وضعیت تایید
-
-#### 3. **CreateNewTransaction** (ثبت تراکنش جدید)
-```csharp
-var request = new CreateNewTransactionRequest
-{
-    MerchantId = "...",
-    Amount = 100000,
-    CallbackUrl = "...",
-    Description = "...",
-    Currency = CurrencyEnum.Irt,
-    PaymentStatus = false,  // false در ابتدا
-    Type = TransactionTypeEnum.Real
-};
-
-var response = await client.CreateNewTransactionAsync(request);
-Console.WriteLine($"Transaction Id: {response.Id}");
-```
-
-#### 4. **UpdateTransaction** (به‌روزرسانی تراکنش)
-```csharp
-var request = new UpdateTransactionRequest
-{
-    Id = transactionId,
-    PaymentStatus = true,  // بعد از verify
-    RefId = "...",
-    VerificationStatusCode = 100,
-    VerificationStatusMessage = "تراکنش موفق"
-};
-
-await client.UpdateTransactionAsync(request);
-```
-
-#### 5. **GetTransaction** (دریافت تراکنش)
-```csharp
-var request = new GetTransactionRequest
-{
-    Id = transactionId,
-    // یا
-    Authority = "AUTHORITY_FROM_CALLBACK"
-};
-
-var response = await client.GetTransactionAsync(request);
-```
-
-#### 6. **GetAllTransactionByFilter** (لیست تراکنش‌ها)
-```csharp
-var request = new GetAllTransactionByFilterRequest
-{
-    PaginationState = new PaginationState { PageNumber = 1, PageSize = 10 },
-    Filter = new GetAllTransactionByFilterFilter
-    {
-        MerchantId = "...",
-        PaymentStatus = true
-    }
-};
-
-var response = await client.GetAllTransactionByFilterAsync(request);
-// response.Models: لیست تراکنش‌ها
-// response.MetaData: اطلاعات صفحه‌بندی
-```
-
---
-
-## 🔑 Enums
-
-### CurrencyEnum
-```csharp
-public enum CurrencyEnum
-{
-    Irr = 0,  // ریال
-    Irt = 1   // تومان
-}
-```
-
-### TransactionTypeEnum
-```csharp
-public enum TransactionTypeEnum
-{
-    Real = 0,     // تراکنش واقعی
-    Sandbox = 1   // تراکنش تستی
-}
-```
-
---
-
-## 💡 نکات مهم برای CMS
-
-### 1. **CMS فقط نتیجه را ثبت می‌کند**
-CMS نباید خودش با درگاه پرداخت ارتباط برقرار کند. این کار توسط **PYMS Microservice** انجام می‌شود.
-
-### 2. **Flow پیشنهادی برای Phase 9 (Club Discount Shop)**:
-
-#### در FrontOffice.BFF:
-```csharp
-// 1. کاربر محصول را انتخاب می‌کند
-var product = await cmsClient.GetProductAsync(productId);
-
-// 2. محاسبه تخفیف
-var userWallet = await cmsClient.GetUserWalletAsync(userId);
-var maxDiscountAmount = product.Price * (product.MaxDiscountPercent / 100);
-var actualDiscountAmount = Math.Min(userWallet.DiscountBalance, maxDiscountAmount);
-var gatewayAmount = product.Price - actualDiscountAmount;
-
-// 3. ثبت Order در CMS با وضعیت Pending
-var order = await cmsClient.CreateDiscountOrderAsync(new CreateDiscountOrderRequest
-{
-    UserId = userId,
-    ProductId = productId,
-    TotalAmount = product.Price,
-    DiscountAmount = actualDiscountAmount,
-    GatewayAmount = gatewayAmount,
-    Status = OrderStatus.Pending
-});
-
-// 4. درخواست پرداخت از PYMS
-var paymentResponse = await pymsClient.PaymentRequestAsync(new PaymentRequestRequest
-{
-    MerchantId = "YOUR_MERCHANT_ID",
-    Amount = (long)gatewayAmount,  // مبلغی که باید از درگاه پرداخت شود
-    CallbackUrl = $"https://yoursite.com/payment/verify?orderId={order.Id}",
-    Description = $"خرید {product.Title}",
-    Currency = CurrencyEnum.Irt,
-    Type = TransactionTypeEnum.Real,
-    OrderId = order.Id.ToString()
-});
-
-// 5. ریدایرکت به درگاه
-return Redirect(paymentResponse.PaymentGWUrl);
-```
-
-#### در Callback (بعد از بازگشت از درگاه):
-```csharp
-// 1. دریافت Authority و Status از Query String
-var authority = Request.Query["Authority"];
-var status = Request.Query["Status"];
-var orderId = Request.Query["orderId"];
-
-// 2. تایید پرداخت از PYMS
-var verifyResponse = await pymsClient.PaymentVerificationAsync(new PaymentVerificationRequest
-{
-    Authority = authority,
-    Status = status
-});
-
-// 3. ثبت نتیجه در CMS
-if (verifyResponse.PaymentStatus)
-{
-    // 3.1. کسر DiscountBalance
-    await cmsClient.DeductDiscountBalanceAsync(new DeductDiscountBalanceRequest
-    {
-        UserId = userId,
-        Amount = order.DiscountAmount,
-        Description = $"خرید محصول {product.Title}",
-        RefId = verifyResponse.RefId
-    });
-
-    // 3.2. ثبت Transaction در CMS
-    await cmsClient.CreateTransactionAsync(new CreateTransactionRequest
-    {
-        UserId = userId,
-        Type = TransactionType.DiscountPurchase,
-        Amount = order.TotalAmount,
-        DiscountAmount = order.DiscountAmount,
-        GatewayAmount = order.GatewayAmount,
-        RefId = verifyResponse.RefId,
-        Status = TransactionStatus.Completed,
-        Description = $"خرید {product.Title}"
-    });
-
-    // 3.3. تغییر وضعیت Order به Completed
-    await cmsClient.CompleteDiscountOrderAsync(new CompleteDiscountOrderRequest
-    {
-        OrderId = orderId,
-        RefId = verifyResponse.RefId
-    });
-
-    return View("PaymentSuccess");
-}
-else
-{
-    // 3.4. تغییر وضعیت Order به Failed
-    await cmsClient.FailDiscountOrderAsync(new FailDiscountOrderRequest
-    {
-        OrderId = orderId,
-        ErrorMessage = verifyResponse.Message
-    });
-
-    return View("PaymentFailed", verifyResponse.Message);
-}
-```
-
-### 3. **Entity های مورد نیاز در CMS**:
-
-```csharp
-// Domain/Entities/DiscountOrder.cs
-public class DiscountOrder
-{
-    public long Id { get; set; }
-    public long UserId { get; set; }
-    public long ProductId { get; set; }
-    public decimal TotalAmount { get; set; }
-    public decimal DiscountAmount { get; set; }  // مبلغ از DiscountBalance
-    public decimal GatewayAmount { get; set; }    // مبلغ از درگاه
-    public OrderStatus Status { get; set; }       // Pending/Completed/Failed
-    public string? RefId { get; set; }            // RefId از PYMS
-    public string? ErrorMessage { get; set; }
-    public DateTime CreatedAt { get; set; }
-    public DateTime? CompletedAt { get; set; }
-    
-    // Navigation
-    public User User { get; set; }
-    public Product Product { get; set; }
-}
-
-// Domain/Enums/OrderStatus.cs
-public enum OrderStatus
-{
-    Pending = 0,      // در انتظار پرداخت
-    Completed = 1,    // پرداخت موفق
-    Failed = 2        // پرداخت ناموفق
-}
-```
-
-### 4. **Commands مورد نیاز در CMS**:
-
- `CreateDiscountOrderCommand`: ثبت سفارش اولیه
- `CompleteDiscountOrderCommand`: تکمیل سفارش بعد از پرداخت موفق
- `FailDiscountOrderCommand`: شکست سفارش
- `DeductDiscountBalanceCommand`: کسر از DiscountBalance
-
---
-
-## ✅ مزایای این معماری
-
-1. ✅ **Separation of Concerns**: CMS فقط روی business logic خودش تمرکز دارد
-2. ✅ **Single Responsibility**: PYMS مسئول پرداخت است، CMS مسئول ثبت نتیجه
-3. ✅ **Easy Testing**: می‌توان PYMS را با Mock جایگزین کرد
-4. ✅ **Scalability**: هر microservice به‌صورت مستقل scale می‌شود
-5. ✅ **Maintainability**: تغییرات در درگاه پرداخت فقط در PYMS انجام می‌شود
-
---
-
-## ⚠️ نکات امنیتی
-
-1. **همیشه Verify کنید**: حتی اگر Status=OK باشد، حتماً PaymentVerification را صدا بزنید
-2. **Callback را Validate کنید**: مطمئن شوید request واقعاً از درگاه آمده (IP whitelisting)
-3. **OrderId را Validate کنید**: مطمئن شوید OrderId متعلق به همان کاربری است که لاگین کرده
-4. **مبلغ را چک کنید**: مبلغ پرداخت شده با مبلغ سفارش مطابقت داشته باشد
-5. **Idempotency**: از ثبت تکراری تراکنش جلوگیری کنید (با RefId)
-
---
-
-## 📚 مثال کامل برای Phase 9
-
-در فاز 9، باید:
-1. ✅ **FrontOffice.BFF** درخواست پرداخت را به **PYMS** بفرستد
-2. ✅ **PYMS** URL درگاه را برگرداند
-3. ✅ بعد از بازگشت، **FrontOffice.BFF** verify کند
-4. ✅ نتیجه را به **CMS** بفرستد تا:
-   - DiscountBalance کسر شود
-   - Transaction ثبت شود
-   - Order تکمیل شود
-
---
-
-**نتیجه‌گیری**: 
- ✅ **Payment Gateway Service** (فقط DayaPaymentService برای Payout) **فقط برای پرداخت به کاربران است**
- ✅ **Transaction System در CMS** برای دریافت نتیجه پرداخت از Gateway و ادامه عملیات:
-  - Entity: `Transaction` (ReferenceId, Amount, Status, Gateway)
-  - Commands: `CreateTransaction`, `VerifyTransaction` (Callback), `RefundTransaction`
-  - Queries: `GetTransactions`, `GetUserTransactions`
-  - جریان: User → Gateway (پرداخت) → Callback به CMS → CMS (فعال‌سازی)
- ✅ این سرویس‌ها فقط برای **مستندسازی** و **درک معماری** نوشته شدند
- ✅ در عمل، **PYMS Microservice** مسئول ارتباط با درگاه است
- ✅ **CMS فقط نتیجه را ثبت می‌کند**
@@ -1,777 +0,0 @@
-# Payment Gateway Integration Guide
-
-## 📋 Overview
-
-## 🔄 جریان پرداخت در سیستم
-
-### 1️⃣ دریافت پول از کاربر (Payment IN)
-```
-کاربر → Gateway/PYMS → بانک → پرداخت موفق
-                              ↓
-                      Callback به CMS
-                              ↓
-          CMS: VerifyTransaction + فعال‌سازی عضویت
-```
-**توضیح**: 
- درگاه اینترنتی در **Gateway/PYMS** است (نه CMS)
- CMS فقط **نتیجه پرداخت را دریافت** می‌کند (از طریق Callback)
- سپس عملیات بعدی (فعال‌سازی، اضافه PV، Wallet) را انجام می‌دهد
- **Transaction System** در CMS برای این کار طراحی شده
-
-### 2️⃣ پرداخت به کاربر (Payout)
-```
-ادمین تایید برداشت → CMS → DayaPaymentService → واریز به حساب کاربر
-```
-**توضیح**:
- این سند فقط برای **Payout** است
- سیستم از دو پیاده‌سازی پشتیبانی می‌کند:
-
-1. **MockPaymentGatewayService** - برای Development و Testing
-2. **DayaPaymentService** - API واقعی Daya (برای واریز به حساب کاربران)
-
---
-
-## 🏗️ Architecture
-
-### Interface Design
-
-```csharp
-public interface IPaymentGatewayService
-{
-    // پرداخت (خرید بسته)
-    Task<PaymentInitiateResult> InitiatePaymentAsync(
-        PaymentRequest request, 
-        CancellationToken cancellationToken = default);
-
-    // تایید پرداخت (Callback)
-    Task<PaymentVerificationResult> VerifyPaymentAsync(
-        string refId, 
-        string verificationToken, 
-        CancellationToken cancellationToken = default);
-
-    // برداشت/پرداخت به کاربر (Withdrawal)
-    Task<PayoutResult> ProcessPayoutAsync(
-        PayoutRequest request, 
-        CancellationToken cancellationToken = default);
-}
-```
-
-### DTO Models
-
-#### PaymentRequest
-```csharp
-public class PaymentRequest
-{
-    public long UserId { get; set; }
-    public string Mobile { get; set; }
-    public decimal Amount { get; set; }
-    public string Description { get; set; }
-    public string CallbackUrl { get; set; }
-}
-```
-
-#### PaymentInitiateResult
-```csharp
-public class PaymentInitiateResult
-{
-    public bool IsSuccess { get; set; }
-    public string? RefId { get; set; }
-    public string? GatewayUrl { get; set; }
-    public string? ErrorMessage { get; set; }
-}
-```
-
-#### PaymentVerificationResult
-```csharp
-public class PaymentVerificationResult
-{
-    public bool IsSuccess { get; set; }
-    public string RefId { get; set; }
-    public string? TrackingCode { get; set; }
-    public decimal Amount { get; set; }
-    public string? Message { get; set; }
-}
-```
-
-#### PayoutRequest
-```csharp
-public class PayoutRequest
-{
-    public long UserId { get; set; }
-    public string Iban { get; set; }
-    public decimal Amount { get; set; }
-    public string? Description { get; set; }
-}
-```
-
-#### PayoutResult
-```csharp
-public class PayoutResult
-{
-    public bool IsSuccess { get; set; }
-    public string? TransactionId { get; set; }
-    public string Message { get; set; }
-    public DateTime ProcessedAt { get; set; }
-}
-```
-
---
-
-## 🔧 Implementation Details
-
-### 1. MockPaymentGatewayService
-
-**Purpose**: Development و Testing بدون نیاز به API واقعی
-
-**Features**:
- ✅ IBAN validation (IR prefix, 26 characters)
- ✅ Amount validation (min 10,000 Toman)
- ✅ Mock RefId generation (MockRef_{timestamp})
- ✅ Simulated network delay (500ms)
- ✅ Comprehensive logging
- ✅ Gateway URL generation (mock://payment)
-
-**Usage**:
-```json
-{
-  "UseRealPaymentGateway": false
-}
-```
-
-**Example**:
-```csharp
-var result = await _paymentGateway.InitiatePaymentAsync(new PaymentRequest
-{
-    UserId = 123,
-    Mobile = "09123456789",
-    Amount = 100000,
-    Description = "خرید بسته طلایی",
-    CallbackUrl = "https://yoursite.com/payment/callback"
-});
-
-// result.IsSuccess = true
-// result.RefId = "MockRef_1701619200"
-// result.GatewayUrl = "mock://payment/MockRef_1701619200"
-```
-
---
-
-### 2. DayaPaymentService
-
-**Purpose**: یکپارچه‌سازی با API واقعی Daya برای پرداخت و برداشت
-
-**Configuration**:
-```json
-{
-  "UseRealPaymentGateway": true,
-  "PaymentProvider": "Daya",
-  "DayaPayment": {
-    "BaseUrl": "https://api.daya.ir",
-    "ApiKey": "YOUR_DAYA_API_KEY"
-  }
-}
-```
-
-**API Endpoints**:
-
-#### Initiate Payment
-```http
-POST {BaseUrl}/api/v1/payment/initiate
-Content-Type: application/json
-X-API-Key: {ApiKey}
-
-{
-  "userId": 123,
-  "mobile": "09123456789",
-  "amount": 100000,
-  "description": "خرید بسته طلایی",
-  "callbackUrl": "https://yoursite.com/payment/callback"
-}
-
-Response:
-{
-  "success": true,
-  "refId": "DAYA123456789",
-  "gatewayUrl": "https://gateway.daya.ir/pay/DAYA123456789",
-  "errorMessage": null
-}
-```
-
-#### Verify Payment
-```http
-POST {BaseUrl}/api/v1/payment/verify
-Content-Type: application/json
-X-API-Key: {ApiKey}
-
-{
-  "refId": "DAYA123456789",
-  "token": "DAYA123456789"
-}
-
-Response:
-{
-  "success": true,
-  "refId": "DAYA123456789",
-  "trackingCode": "TRACK987654321",
-  "amount": 100000,
-  "message": "تراکنش موفق"
-}
-```
-
-#### Process Payout
-```http
-POST {BaseUrl}/api/v1/payout/process
-Content-Type: application/json
-X-API-Key: {ApiKey}
-
-{
-  "userId": 123,
-  "iban": "IR123456789012345678901234",
-  "amount": 50000,
-  "description": "برداشت کمیسیون"
-}
-
-Response:
-{
-  "success": true,
-  "transactionId": "TXN_123456789",
-  "message": "پرداخت با موفقیت انجام شد",
-  "processedAt": "2024-12-02T10:30:00Z"
-}
-```
-
-**Error Handling**:
-```csharp
-try
-{
-    var response = await _httpClient.PostAsJsonAsync(url, request, cancellationToken);
-    
-    if (!response.IsSuccessStatusCode)
-    {
-        _logger.LogError("Daya API error: StatusCode={StatusCode}", response.StatusCode);
-        return new PaymentInitiateResult
-        {
-            IsSuccess = false,
-            ErrorMessage = $"خطا در ارتباط با سرویس پرداخت: {response.StatusCode}"
-        };
-    }
-    
-    var result = await response.Content.ReadFromJsonAsync<DayaInitiateResponse>(cancellationToken);
-    // Process result...
-}
-catch (Exception ex)
-{
-    _logger.LogError(ex, "Error in InitiatePaymentAsync");
-    return new PaymentInitiateResult
-    {
-        IsSuccess = false,
-        ErrorMessage = "خطای غیرمنتظره در برقراری ارتباط با سرویس پرداخت"
-    };
-}
-```
-
---
-
-### 3. BankMellatPaymentService
-
-**Purpose**: یکپارچه‌سازی با IPG بانک ملت (SOAP Web Service)
-
-**Configuration**:
-```json
-{
-  "UseRealPaymentGateway": true,
-  "PaymentProvider": "BankMellat",
-  "BankMellat": {
-    "ServiceUrl": "https://bpm.shaparak.ir/pgwchannel/services/pgw",
-    "TerminalId": "YOUR_TERMINAL_ID",
-    "Username": "YOUR_USERNAME",
-    "Password": "YOUR_PASSWORD"
-  }
-}
-```
-
-**SOAP Operations**:
-
-#### bpPayRequest (Initiate Payment)
-```xml
-<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
-               xmlns:ns="http://interfaces.core.sw.bps.com/">
-    <soap:Body>
-        <ns:bpPayRequest>
-            <terminalId>{TERMINAL_ID}</terminalId>
-            <userName>{USERNAME}</userName>
-            <userPassword>{PASSWORD}</userPassword>
-            <orderId>{ORDER_ID}</orderId>
-            <amount>{AMOUNT_IN_RIALS}</amount>
-            <localDate>{yyyyMMdd}</localDate>
-            <localTime>{HHmmss}</localTime>
-            <additionalData>{DESCRIPTION}</additionalData>
-            <callBackUrl>{CALLBACK_URL}</callBackUrl>
-            <payerId>0</payerId>
-        </ns:bpPayRequest>
-    </soap:Body>
-</soap:Envelope>
-```
-
-**Response**:
-```xml
-<soap:Envelope>
-    <soap:Body>
-        <ns:bpPayRequestResponse>
-            <return>{REF_ID}</return>  <!-- Success: positive number, Error: negative number -->
-        </ns:bpPayRequestResponse>
-    </soap:Body>
-</soap:Envelope>
-```
-
-#### bpVerifyRequest (Verify Payment)
-```xml
-<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
-               xmlns:ns="http://interfaces.core.sw.bps.com/">
-    <soap:Body>
-        <ns:bpVerifyRequest>
-            <terminalId>{TERMINAL_ID}</terminalId>
-            <userName>{USERNAME}</userName>
-            <userPassword>{PASSWORD}</userPassword>
-            <orderId>{ORDER_ID}</orderId>
-            <saleOrderId>{ORDER_ID}</saleOrderId>
-            <saleReferenceId>{REF_ID}</saleReferenceId>
-        </ns:bpVerifyRequest>
-    </soap:Body>
-</soap:Envelope>
-```
-
-#### bpSettleRequest (Settle Payment)
-```xml
-<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
-               xmlns:ns="http://interfaces.core.sw.bps.com/">
-    <soap:Body>
-        <ns:bpSettleRequest>
-            <terminalId>{TERMINAL_ID}</terminalId>
-            <userName>{USERNAME}</userName>
-            <userPassword>{PASSWORD}</userPassword>
-            <orderId>{ORDER_ID}</orderId>
-            <saleOrderId>{ORDER_ID}</saleOrderId>
-            <saleReferenceId>{REF_ID}</saleReferenceId>
-        </ns:bpSettleRequest>
-    </soap:Body>
-</soap:Envelope>
-```
-
-**Error Codes**:
-
-| Code | Description (Persian) |
-|------|----------------------|
-| 0 | تراکنش موفق |
-| 11 | شماره کارت نامعتبر است |
-| 12 | موجودی کافی نیست |
-| 13 | رمز نادرست است |
-| 14 | تعداد دفعات وارد کردن رمز بیش از حد مجاز است |
-| 15 | کارت نامعتبر است |
-| 17 | کاربر از انجام تراکنش منصرف شده است |
-| 18 | تاریخ انقضای کارت گذشته است |
-| 21 | پذیرنده نامعتبر است |
-| 23 | خطای امنیتی رخ داده است |
-| 24 | اطلاعات کاربری پذیرنده نامعتبر است |
-| 25 | مبلغ نامعتبر است |
-| 41 | شماره درخواست تکراری است |
-| 43 | قبلا درخواست Verify داده شده است |
-| 51 | تراکنش تکراری است |
-
-**Limitations**:
- ⚠️ Direct payout (ProcessPayoutAsync) **not supported** by Bank Mellat IPG
- ℹ️ For withdrawals, use **Shaparak Paya** or third-party services like Fanapay, IPG.ir
-
---
-
-## ⚙️ Service Registration (ConfigureServices.cs)
-
-```csharp
-// Payment Gateway Service - برای Development از Mock استفاده می‌شود
-var useRealPaymentGateway = configuration.GetValue<bool>("UseRealPaymentGateway", false);
-
-if (useRealPaymentGateway)
-{
-    var paymentProvider = configuration.GetValue<string>("PaymentProvider", "BankMellat");
-    
-    if (paymentProvider == "Daya")
-    {
-        services.AddHttpClient<IPaymentGatewayService, DayaPaymentService>()
-            .SetHandlerLifetime(TimeSpan.FromMinutes(5));
-    }
-    else if (paymentProvider == "BankMellat")
-    {
-        services.AddHttpClient<IPaymentGatewayService, BankMellatPaymentService>()
-            .SetHandlerLifetime(TimeSpan.FromMinutes(5));
-    }
-    else
-    {
-        throw new InvalidOperationException($"Invalid PaymentProvider: {paymentProvider}");
-    }
-}
-else
-{
-    // Mock برای Development و Testing
-    services.AddScoped<IPaymentGatewayService, MockPaymentGatewayService>();
-}
-```
-
---
-
-## 📝 Usage Examples
-
-### Purchase Package (InitiatePaymentAsync)
-
-```csharp
-// In Command Handler
-public class PurchaseGoldenPackageCommandHandler : IRequestHandler<PurchaseGoldenPackageCommand, long>
-{
-    private readonly IPaymentGatewayService _paymentGateway;
-
-    public async Task<long> Handle(PurchaseGoldenPackageCommand request, CancellationToken ct)
-    {
-        // Initiate payment
-        var paymentResult = await _paymentGateway.InitiatePaymentAsync(new PaymentRequest
-        {
-            UserId = request.UserId,
-            Mobile = user.Mobile,
-            Amount = packagePrice,
-            Description = "خرید بسته طلایی",
-            CallbackUrl = "https://yoursite.com/payment/callback"
-        }, ct);
-
-        if (!paymentResult.IsSuccess)
-        {
-            throw new InvalidOperationException(paymentResult.ErrorMessage);
-        }
-
-        // Create transaction record
-        var transaction = new Transaction
-        {
-            UserId = request.UserId,
-            Type = TransactionType.PackagePurchase,
-            Amount = packagePrice,
-            Status = TransactionStatus.Pending,
-            RefId = paymentResult.RefId,
-            Description = "خرید بسته طلایی"
-        };
-
-        await _context.Transactions.AddAsync(transaction, ct);
-        await _context.SaveChangesAsync(ct);
-
-        // Redirect user to gateway
-        return transaction.Id; // Return transaction ID for frontend to track
-    }
-}
-```
-
-### Verify Payment (Callback)
-
-```csharp
-public class VerifyGoldenPackagePurchaseCommandHandler : IRequestHandler<VerifyGoldenPackagePurchaseCommand>
-{
-    private readonly IPaymentGatewayService _paymentGateway;
-
-    public async Task Handle(VerifyGoldenPackagePurchaseCommand request, CancellationToken ct)
-    {
-        // Verify payment
-        var verifyResult = await _paymentGateway.VerifyPaymentAsync(
-            request.Authority, 
-            request.Authority, 
-            ct);
-
-        if (!verifyResult.IsSuccess)
-        {
-            transaction.Status = TransactionStatus.Failed;
-            transaction.ErrorMessage = verifyResult.Message;
-            throw new InvalidOperationException(verifyResult.Message);
-        }
-
-        // Update transaction
-        transaction.Status = TransactionStatus.Completed;
-        transaction.CompletedAt = DateTime.UtcNow;
-
-        // Activate club membership
-        var clubMembership = new ClubMembership
-        {
-            UserId = transaction.UserId,
-            Status = ClubMembershipStatus.Active,
-            StartDate = DateTime.UtcNow,
-            EndDate = DateTime.UtcNow.AddMonths(1),
-            PurchaseMethod = PackagePurchaseMethod.DirectPurchase
-        };
-
-        await _context.ClubMemberships.AddAsync(clubMembership, ct);
-        await _context.SaveChangesAsync(ct);
-    }
-}
-```
-
-### Process Withdrawal (ProcessPayoutAsync)
-
-```csharp
-public class ProcessWithdrawalCommandHandler : IRequestHandler<ProcessWithdrawalCommand>
-{
-    private readonly IPaymentGatewayService _paymentGateway;
-
-    public async Task Handle(ProcessWithdrawalCommand request, CancellationToken ct)
-    {
-        if (request.IsApproved)
-        {
-            if (payout.WithdrawalMethod == WithdrawalMethod.Diamond)
-            {
-                // Credit user wallet
-                userWallet.DiscountBalance += payout.TotalAmount;
-            }
-            else if (payout.WithdrawalMethod == WithdrawalMethod.Cash)
-            {
-                // Process bank transfer
-                var payoutResult = await _paymentGateway.ProcessPayoutAsync(new PayoutRequest
-                {
-                    UserId = payout.UserId,
-                    Iban = payout.Iban,
-                    Amount = payout.TotalAmount,
-                    Description = $"برداشت کمیسیون هفته {payout.WeekNumber}"
-                }, ct);
-
-                if (payoutResult.IsSuccess)
-                {
-                    payout.Status = CommissionStatus.Withdrawn;
-                    payout.CompletedAt = DateTime.UtcNow;
-                    payout.TransactionId = payoutResult.TransactionId;
-                }
-                else
-                {
-                    payout.Status = CommissionStatus.PaymentFailed;
-                    payout.ErrorMessage = payoutResult.Message;
-                }
-            }
-
-            // Record history
-            await _context.CommissionPayoutHistories.AddAsync(new CommissionPayoutHistory
-            {
-                PayoutId = payout.Id,
-                TransactionType = payout.Status == CommissionStatus.Withdrawn 
-                    ? TransactionType.Withdrawn 
-                    : TransactionType.PaymentFailed,
-                Amount = payout.TotalAmount,
-                ProcessedBy = _currentUserService.UserId,
-                ProcessedAt = DateTime.UtcNow
-            }, ct);
-
-            await _context.SaveChangesAsync(ct);
-        }
-    }
-}
-```
-
---
-
-## 🧪 Testing Guide
-
-### Unit Testing with Mock
-
-```csharp
-[Fact]
-public async Task InitiatePayment_Should_Return_Success_With_Valid_Data()
-{
-    // Arrange
-    var mockLogger = new Mock<ILogger<MockPaymentGatewayService>>();
-    var service = new MockPaymentGatewayService(mockLogger.Object);
-    
-    var request = new PaymentRequest
-    {
-        UserId = 123,
-        Mobile = "09123456789",
-        Amount = 100000,
-        Description = "Test payment",
-        CallbackUrl = "https://test.com/callback"
-    };
-
-    // Act
-    var result = await service.InitiatePaymentAsync(request);
-
-    // Assert
-    Assert.True(result.IsSuccess);
-    Assert.NotNull(result.RefId);
-    Assert.StartsWith("MockRef_", result.RefId);
-    Assert.NotNull(result.GatewayUrl);
-}
-
-[Fact]
-public async Task ProcessPayout_Should_Fail_With_Invalid_IBAN()
-{
-    // Arrange
-    var mockLogger = new Mock<ILogger<MockPaymentGatewayService>>();
-    var service = new MockPaymentGatewayService(mockLogger.Object);
-    
-    var request = new PayoutRequest
-    {
-        UserId = 123,
-        Iban = "INVALID_IBAN",
-        Amount = 50000,
-        Description = "Test payout"
-    };
-
-    // Act
-    var result = await service.ProcessPayoutAsync(request);
-
-    // Assert
-    Assert.False(result.IsSuccess);
-    Assert.Contains("فرمت شماره شبا نامعتبر", result.Message);
-}
-```
-
-### Integration Testing
-
-```csharp
-public class PaymentGatewayIntegrationTests : IClassFixture<WebApplicationFactory<Program>>
-{
-    private readonly HttpClient _client;
-
-    public PaymentGatewayIntegrationTests(WebApplicationFactory<Program> factory)
-    {
-        _client = factory.CreateClient();
-    }
-
-    [Fact]
-    public async Task PurchaseGoldenPackage_Should_Initiate_Payment()
-    {
-        // Arrange
-        var command = new PurchaseGoldenPackageCommand
-        {
-            UserId = 123,
-            PaymentMethod = PackagePurchaseMethod.DirectPurchase
-        };
-
-        // Act
-        var response = await _client.PostAsJsonAsync("/api/package/purchase", command);
-
-        // Assert
-        response.EnsureSuccessStatusCode();
-        var transactionId = await response.Content.ReadFromJsonAsync<long>();
-        Assert.True(transactionId > 0);
-    }
-}
-```
-
---
-
-## 🔒 Security Best Practices
-
-1. **Configuration Security**:
-   - ✅ Store API keys in `appsettings.json` (excluded from git)
-   - ✅ Use Azure Key Vault or AWS Secrets Manager in production
-   - ✅ Never hardcode credentials in code
-
-2. **HTTPS Only**:
-   - ✅ Enforce HTTPS for all payment callbacks
-   - ✅ Validate SSL certificates
-
-3. **Amount Validation**:
-   - ✅ Validate min/max amounts before API call
-   - ✅ Verify amounts match on callback
-
-4. **IBAN Validation**:
-   - ✅ Format: IR + 24 digits = 26 characters
-   - ✅ Validate before payout processing
-
-5. **Idempotency**:
-   - ✅ Use unique OrderId for each payment
-   - ✅ Store RefId to prevent duplicate processing
-
-6. **Error Handling**:
-   - ✅ Never expose internal errors to users
-   - ✅ Log detailed errors for debugging
-   - ✅ Return user-friendly error messages
-
---
-
-## 📊 Monitoring & Logging
-
-### Recommended Logs
-
-```csharp
-// Success
-_logger.LogInformation(
-    "Payment initiated successfully: UserId={UserId}, Amount={Amount}, RefId={RefId}",
-    request.UserId, request.Amount, result.RefId);
-
-// Failure
-_logger.LogError(
-    "Payment initiation failed: UserId={UserId}, Amount={Amount}, Error={Error}",
-    request.UserId, request.Amount, result.ErrorMessage);
-
-// API Error
-_logger.LogError(
-    "Payment gateway API error: StatusCode={StatusCode}, Response={Response}",
-    response.StatusCode, responseContent);
-```
-
-### Sentry Integration
-
-```csharp
-try
-{
-    var result = await _paymentGateway.InitiatePaymentAsync(request, ct);
-}
-catch (Exception ex)
-{
-    SentrySdk.CaptureException(ex, scope =>
-    {
-        scope.SetTag("payment_provider", "Daya");
-        scope.SetExtra("user_id", request.UserId);
-        scope.SetExtra("amount", request.Amount);
-    });
-    throw;
-}
-```
-
---
-
-## 🚀 Production Deployment Checklist
-
- [ ] Obtain Daya API credentials (BaseUrl + ApiKey)
- [ ] Obtain Bank Mellat credentials (TerminalId, Username, Password)
- [ ] Test in sandbox environment
- [ ] Update `appsettings.Production.json` with credentials
- [ ] Set `UseRealPaymentGateway = true`
- [ ] Configure HTTPS callback URLs
- [ ] Set up monitoring (Sentry/Application Insights)
- [ ] Configure retry policies (Polly)
- [ ] Test full payment flow (Initiate → Callback → Verify)
- [ ] Test withdrawal flow (Request → Approve → Payout)
- [ ] Document production URLs and credentials (secure location)
-
---
-
-## 📞 Support & Troubleshooting
-
-### Common Issues
-
-**Issue**: "Payment gateway API error: 401 Unauthorized"
- **Solution**: Check API key in `appsettings.json`, verify credentials
-
-**Issue**: "IBAN validation failed"
- **Solution**: Ensure IBAN starts with "IR" and is exactly 26 characters
-
-**Issue**: "Bank Mellat returns negative RefId"
- **Solution**: Check error code mapping, verify TerminalId/Username/Password
-
-**Issue**: "HttpClient timeout"
- **Solution**: Increase timeout in `ConfigureServices.cs`, check network connectivity
-
---
-
-## 📚 References
-
- [Daya API Documentation](https://api.daya.ir/docs) (placeholder)
- [Bank Mellat IPG Guide](https://bpm.shaparak.ir/) (official)
- [Shaparak Paya Documentation](https://www.shaparak.ir/)
- [ISO 8601 Week Numbering](https://en.wikipedia.org/wiki/ISO_8601)
-
---
-
-**Last Updated**: 2024-12-02  
-**Version**: 1.0  
-**Status**: ✅ Production Ready
@@ -1,112 +0,0 @@
-# FrontOffice.BFF
-
-## Overview
-FrontOffice.BFF (Backend-For-Frontend) is a gRPC-based API gateway that serves the FrontOffice web application. It communicates with the CMS microservice via gRPC and exposes APIs to the frontend.
-
-## Architecture
-```
-Frontend (FrontOffice) → FrontOffice.BFF → CMS Microservice
-```
-
-## Project Structure
-```
-FrontOffice.BFF/
-├── src/
-│   ├── FrontOffice.BFF.Application/     # CQRS handlers, DTOs, interfaces
-│   ├── FrontOffice.BFF.Domain/          # Domain entities
-│   ├── FrontOffice.BFF.Infrastructure/  # gRPC clients, DI config
-│   ├── FrontOffice.BFF.WebApi/          # gRPC services, mappings
-│   └── Protobufs/                       # Proto definitions for frontend
-│       ├── FrontOffice.BFF.Category.Protobuf/
-│       ├── FrontOffice.BFF.DiscountShop.Protobuf/  # NEW
-│       ├── FrontOffice.BFF.Package.Protobuf/
-│       ├── FrontOffice.BFF.Products.Protobuf/
-│       ├── FrontOffice.BFF.ShopingCart.Protobuf/
-│       ├── FrontOffice.BFF.Transaction.Protobuf/
-│       ├── FrontOffice.BFF.User.Protobuf/
-│       ├── FrontOffice.BFF.UserAddress.Protobuf/
-│       ├── FrontOffice.BFF.UserOrder.Protobuf/
-│       └── FrontOffice.BFF.UserWallet.Protobuf/
-```
-
-## Feature Modules
-
-### DiscountShopCQ (New - Jan 2025)
-فروشگاه تخفیفی برای اعضای باشگاه مشتریان
-
-**Queries:**
- `GetDiscountProducts` - لیست محصولات تخفیفی
- `GetDiscountCategories` - دسته‌بندی‌های فروشگاه
- `GetMyDiscountCart` - سبد خرید تخفیفی کاربر
- `GetMyDiscountOrders` - سفارشات تخفیفی کاربر
-
-**Commands:**
- `AddToDiscountCart` - افزودن به سبد خرید
- `RemoveFromDiscountCart` - حذف از سبد خرید
- `PlaceDiscountOrder` - ثبت سفارش
-
-### CommissionCQ
-سیستم کمیسیون شبکه‌ای
-
-**Queries:**
- `GetMyCommissionPayouts` - لیست پرداخت‌های کمیسیون
- `GetMyWeeklyBalances` - بالانس‌های هفتگی
-
-### NetworkMembershipCQ
-عضویت شبکه‌ای و درخت باینری
-
-**Queries:**
- `GetMyNetworkPosition` - موقعیت کاربر در شبکه
- `GetMyNetworkStatistics` - آمار شبکه
- `GetMyNetworkTree` - درخت شبکه
- `GetSubordinateTree` - درخت زیرمجموعه (NEW - ۲۸ آذر)
-
-### ClubMembershipCQ
-عضویت باشگاه مشتریان
-
-**Queries:**
- `GetMyClubMembership` - وضعیت عضویت
-
-**Commands:**
- `ActivateMyClubMembership` - فعال‌سازی عضویت
-
-### UserWalletCQ
-کیف پول کاربر
-
-**Queries:**
- `GetUserWallet` - موجودی کیف پول
- `GetAllUserWalletChangeLog` - تاریخچه تراکنش‌ها
-
-**Commands:**
- `WithdrawBalance` - درخواست برداشت
- `TransferUserWalletBallance` - انتقال موجودی (TODO: needs CMS proto)
- `DeleteUser` - حذف کاربر
-
-## gRPC Clients (CMS Connection)
-Defined in `IApplicationContractContext.cs`:
-
- `ProductContract` - محصولات
- `CategoryContract` - دسته‌بندی‌ها
- `ShopingCartContract` - سبد خرید
- `TransactionContract` - تراکنش‌ها
- `UserWalletContract` - کیف پول
- `UserContract` - کاربران
- `UserOrderContract` - سفارشات
- `NetworkMembershipContract` - عضویت شبکه
- `CommissionContract` - کمیسیون
- `ClubMembershipContract` - باشگاه مشتریان
- `DiscountProductContract` - محصولات تخفیفی (NEW)
- `DiscountCategoryContract` - دسته‌بندی تخفیفی (NEW)
- `DiscountShoppingCartContract` - سبد خرید تخفیفی (NEW)
- `DiscountOrderContract` - سفارش تخفیفی (NEW)
-
-## Build & Run
-```bash
-cd FrontOffice.BFF/src
-dotnet build
-dotnet run --project FrontOffice.BFF.WebApi
-```
-
-## Last Updated
- **28 آذر ۱۴۰۴**: Added `GetSubordinateTree` handler for viewing subordinate network trees
- **January 2025**: Added DiscountShop integration (4 gRPC clients, 7 handlers, Proto service)
@@ -1,44 +0,0 @@
-# 📁 FrontOffice.BFF - Design & Database Files
-
-این پوشه شامل فایل‌های طراحی و دیتابیس FrontOffice.BFF است.
-
---
-
-## 📊 فایل‌ها
-
-### Database Models:
- **`model.ndm2`** - طراحی دیتابیس FrontOffice.BFF
-  - ابزار: Navicat Data Modeler
-  - محتوا: ساختار Entity ها و روابط
-
-### SQL Scripts:
- **`CMS.sql`** - اسکریپت‌های مربوط به CMS
-  - محتوا: Query ها یا Schema های مورد نیاز
-
---
-
-## 🔧 نحوه استفاده
-
-### Database Model:
-```bash
-# باز کردن با Navicat Data Modeler
-navicat-data-modeler model.ndm2
-```
-
-### SQL Scripts:
-```bash
-# اجرا در SQL Server
-sqlcmd -S localhost -d CMS_Database -i CMS.sql
-```
-
---
-
-## 🔗 مراجع
-
- **FrontOffice.BFF README**: [`../README.md`](../README.md)
- **Protobuf Mismatch**: [`../protobuf-mismatch.md`](../protobuf-mismatch.md)
- **FrontOffice UI**: [`../../../04-FRONTEND/FrontOffice/`](../../../04-FRONTEND/FrontOffice/)
-
---
-
-**تاریخ ایجاد**: ۱ دسامبر ۲۰۲۵
@@ -1,851 +0,0 @@
-# 🔴 تحلیل مغایرت Protobuf بین FrontOffice.BFF و CMS
-
-> تاریخ: ۱۴ آذر ۱۴۰۴
-> 
-> این سند تمام مغایرت‌های موجود بین Handler های BFF و Protobuf های CMS را تحلیل می‌کند.
-
---
-
-## 📊 خلاصه مشکلات
-
-| ماژول | Handler های BFF | Proto های CMS | وضعیت | اولویت |
-|------|-----------------|---------------|-------|--------|
-| **ClubMembership** | ✅ 2 Handler | ⚠️ 7 RPC | نیاز به اصلاح | 🔴 بالا |
-| **NetworkMembership** | ✅ 2 Handler | ⚠️ 7 RPC | نیاز به اصلاح | 🔴 بالا |
-| **Commission** | ✅ 2 Handler | ⚠️ 16 RPC | نیاز به اصلاح | 🔴 بالا |
-| **UserWallet** | ⚠️ 5 Handler | ✅ CMS API | نیاز به Query جدید | 🟡 متوسط |
-
---
-
-## 1️⃣ ClubMembership - مغایرت‌ها
-
-### 🟢 BFF Handlers (2 عدد - موجود)
-```
-✅ GetMyClubMembership (Query)
-✅ ActivateMyClubMembership (Command)
-```
-
-### 📋 CMS Protobuf (clubmembership.proto)
-```protobuf
-service ClubMembershipContract {
-    // Commands
-    rpc ActivateClubMembership(ActivateClubMembershipRequest) returns (Empty);
-    rpc DeactivateClubMembership(DeactivateClubMembershipRequest) returns (Empty);
-    rpc AssignFeatureToMembership(AssignFeatureToMembershipRequest) returns (Empty);
-    
-    // Queries
-    rpc GetClubMembership(GetClubMembershipRequest) returns (GetClubMembershipResponse);
-    rpc GetAllClubMemberships(GetAllClubMembershipsRequest) returns (GetAllClubMembershipsResponse);
-    rpc GetClubMembershipHistory(GetClubMembershipHistoryRequest) returns (GetClubMembershipHistoryResponse);
-    rpc GetClubStatistics(GetClubStatisticsRequest) returns (GetClubStatisticsResponse);
-}
-```
-
---
-
-### ❌ مشکل 1: GetMyClubMembershipQueryHandler
-
-**فایل**: `FrontOffice.BFF/src/FrontOffice.BFF.Application/ClubMembershipCQ/Queries/GetMyClubMembership/GetMyClubMembershipQueryHandler.cs`
-
-**کد فعلی**:
-```csharp
-var response = await _context.ClubMemberships.GetClubMembershipAsync(cmsRequest, cancellationToken: cancellationToken);
-
-// استفاده از فیلدهای قدیمی:
-var activationDate = response.ActivationDate?.ToDateTime();  // ❌ ActivationDate
-var expirationDate = response.ExpirationDate?.ToDateTime();  // ❌ ExpirationDate
-```
-
-**CMS Proto**:
-```protobuf
-message GetClubMembershipResponse
-{
-    int64 id = 1;
-    int64 user_id = 2;
-    int64 package_id = 3;
-    string package_name = 4;
-    string activation_code = 5;
-    google.protobuf.Timestamp activated_at = 6;  // ✅ activated_at (نام جدید)
-    google.protobuf.Timestamp expires_at = 7;    // ✅ expires_at (نام جدید)
-    bool is_active = 8;
-    google.protobuf.Timestamp created = 9;
-    repeated MembershipFeatureModel features = 10;
-}
-```
-
-**🔧 راه حل**:
-```csharp
-// تغییر نام فیلدها:
-var activationDate = response.ActivatedAt?.ToDateTime();  // ✅ ActivatedAt
-var expirationDate = response.ExpiresAt?.ToDateTime();    // ✅ ExpiresAt
-```
-
-**⚠️ نکته مهم**: CMS حالا یک **لیست features** نیز بر می‌گرداند که باید به Response DTO اضافه شود:
-```csharp
-public class GetMyClubMembershipResponseDto
-{
-    // ... فیلدهای موجود
-    public List<MembershipFeatureDto>? Features { get; set; }  // ✅ جدید
-}
-
-public class MembershipFeatureDto
-{
-    public long ProductId { get; set; }
-    public string ProductName { get; set; }
-    public int Quantity { get; set; }
-    public DateTime? ExpiresAt { get; set; }
-    public bool IsActive { get; set; }
-}
-```
-
---
-
-### ✅ ActivateMyClubMembershipCommandHandler
-
-**وضعیت**: این Handler صحیح است، اما Response نیاز به بررسی دارد.
-
-**کد فعلی**:
-```csharp
-await _context.ClubMemberships.ActivateClubMembershipAsync(grpcRequest, cancellationToken: cancellationToken);
-
-// ❌ Response Mock است:
-return new ActivateMyClubMembershipResponseDto
-{
-    Success = true,
-    Message = "عضویت باشگاه با موفقیت فعال شد",
-    ActivationDate = DateTime.UtcNow,
-    ExpirationDate = activationDate.AddMonths(request.DurationMonths),
-    AmountPaid = 56_000_000 // ❌ Hardcoded
-};
-```
-
-**مشکل**: CMS فقط `Empty` بر می‌گرداند، اطلاعات واقعی باید از `GetClubMembership` گرفته شود.
-
-**🔧 راه حل**:
-```csharp
-// بعد از فعال‌سازی، GetClubMembership را صدا بزن:
-await _context.ClubMemberships.ActivateClubMembershipAsync(grpcRequest, cancellationToken);
-
-var membershipRequest = new GetClubMembershipRequest { UserId = userId };
-var membership = await _context.ClubMemberships.GetClubMembershipAsync(membershipRequest, cancellationToken);
-
-return new ActivateMyClubMembershipResponseDto
-{
-    Success = true,
-    Message = "عضویت باشگاه با موفقیت فعال شد",
-    ActivationDate = membership.ActivatedAt?.ToDateTime(),
-    ExpirationDate = membership.ExpiresAt?.ToDateTime(),
-    AmountPaid = CalculatePackageCost(membership.PackageId, request.DurationMonths)  // محاسبه واقعی
-};
-```
-
---
-
-## 2️⃣ NetworkMembership - مغایرت‌ها
-
-### 🟢 BFF Handlers (2 عدد - موجود)
-```
-✅ GetMyNetworkTree (Query)
-✅ GetMyNetworkStatistics (Query)
-```
-
-### 📋 CMS Protobuf (networkmembership.proto)
-```protobuf
-service NetworkMembershipContract {
-    // Commands
-    rpc JoinNetwork(JoinNetworkRequest) returns (Empty);
-    rpc ChangeNetworkParent(ChangeNetworkParentRequest) returns (Empty);
-    rpc RemoveFromNetwork(RemoveFromNetworkRequest) returns (Empty);
-    
-    // Queries
-    rpc GetUserNetwork(GetUserNetworkRequest) returns (GetUserNetworkResponse);
-    rpc GetNetworkTree(GetNetworkTreeRequest) returns (GetNetworkTreeResponse);
-    rpc GetNetworkMembershipHistory(GetNetworkMembershipHistoryRequest) returns (GetNetworkMembershipHistoryResponse);
-    rpc GetNetworkStatistics(GetNetworkStatisticsRequest) returns (GetNetworkStatisticsResponse);
-}
-```
-
---
-
-### ❌ مشکل 2: GetMyNetworkTreeQueryHandler
-
-**فایل**: `FrontOffice.BFF/src/FrontOffice.BFF.Application/NetworkMembershipCQ/Queries/GetMyNetworkTree/GetMyNetworkTreeQueryHandler.cs`
-
-**کد فعلی**:
-```csharp
-var response = await _context.NetworkMemberships.GetNetworkTreeAsync(cmsRequest, cancellationToken);
-
-// استفاده از فیلد RootNode:
-return new GetMyNetworkTreeResponseDto
-{
-    RootNode = MapToNetworkNode(response.RootNode, 0),  // ❌ RootNode
-    TotalMembers = CountNodes(response.RootNode),
-    CurrentDepth = CalculateDepth(response.RootNode)
-};
-```
-
-**CMS Proto**:
-```protobuf
-message GetNetworkTreeResponse
-{
-    repeated NetworkTreeNodeModel nodes = 1;  // ✅ Flat list (نه Tree)
-}
-
-message NetworkTreeNodeModel
-{
-    int64 user_id = 1;
-    string user_name = 2;
-    google.protobuf.Int64Value parent_id = 3;
-    int32 network_leg = 4;
-    int32 network_level = 5;
-    bool is_active = 6;
-    google.protobuf.Timestamp joined_at = 7;
-}
-```
-
-**🚨 مشکل بزرگ**: CMS حالا **Flat List** بر می‌گرداند نه **Tree Structure**!
-
-**🔧 راه حل**: باید در BFF یک Tree Builder بسازیم:
-
-```csharp
-public async Task<GetMyNetworkTreeResponseDto> Handle(GetMyNetworkTreeQuery request, CancellationToken cancellationToken)
-{
-    var userId = _currentUserService.UserId ?? throw new UnauthorizedAccessException();
-
-    var cmsRequest = new GetNetworkTreeRequest
-    {
-        RootUserId = userId,
-        MaxDepth = Math.Clamp(request.MaxDepth, 1, 10)
-    };
-
-    var response = await _context.NetworkMemberships.GetNetworkTreeAsync(cmsRequest, cancellationToken);
-
-    // ✅ ساخت Tree از Flat List:
-    var rootNode = BuildTreeFromFlatList(response.Nodes, userId);
-
-    return new GetMyNetworkTreeResponseDto
-    {
-        RootNode = rootNode,
-        TotalMembers = response.Nodes.Count,
-        CurrentDepth = response.Nodes.Any() ? response.Nodes.Max(n => n.NetworkLevel) : 0
-    };
-}
-
-private NetworkNodeDto? BuildTreeFromFlatList(IEnumerable<NetworkTreeNodeModel> nodes, long rootUserId)
-{
-    var nodeDict = nodes.ToDictionary(n => n.UserId);
-    
-    if (!nodeDict.ContainsKey(rootUserId))
-        return null;
-
-    NetworkNodeDto BuildNode(long userId, int level)
-    {
-        var cmsNode = nodeDict[userId];
-        
-        var node = new NetworkNodeDto
-        {
-            UserId = cmsNode.UserId,
-            FullName = cmsNode.UserName,
-            Mobile = string.Empty,  // CMS ندارد
-            Avatar = null,
-            Position = cmsNode.NetworkLeg == 0 ? "Left" : "Right",
-            Level = level
-        };
-
-        // پیدا کردن children
-        var leftChild = nodes.FirstOrDefault(n => n.ParentId == userId && n.NetworkLeg == 0);
-        var rightChild = nodes.FirstOrDefault(n => n.ParentId == userId && n.NetworkLeg == 1);
-
-        if (leftChild != null)
-            node.LeftChild = BuildNode(leftChild.UserId, level + 1);
-        
-        if (rightChild != null)
-            node.RightChild = BuildNode(rightChild.UserId, level + 1);
-
-        return node;
-    }
-
-    return BuildNode(rootUserId, 0);
-}
-```
-
---
-
-### ❌ مشکل 3: GetMyNetworkStatisticsQueryHandler
-
-**فایل**: `FrontOffice.BFF/src/FrontOffice.BFF.Application/NetworkMembershipCQ/Queries/GetMyNetworkStatistics/GetMyNetworkStatisticsQueryHandler.cs`
-
-**کد فعلی**:
-```csharp
-var cmsRequest = new GetNetworkStatisticsRequest
-{
-    UserId = userId  // ❌ GetNetworkStatisticsRequest فیلد UserId ندارد!
-};
-
-var response = await _context.NetworkMemberships.GetNetworkStatisticsAsync(cmsRequest, cancellationToken);
-
-// استفاده از فیلدهای قدیمی:
-return new GetMyNetworkStatisticsResponseDto
-{
-    LeftLegCount = response.LeftLegCount,
-    RightLegCount = response.RightLegCount,
-    TotalMembers = response.TotalMembers,
-    TreeDepth = response.TreeDepth,  // ❌ نام قدیمی
-    WeakerLeg = weakerLeg,
-    LastMember = response.LastMember != null ? new LastMemberDto { ... }  // ❌ LastMember وجود ندارد!
-};
-```
-
-**CMS Proto**:
-```protobuf
-message GetNetworkStatisticsRequest
-{
-    // Empty - برای کل شبکه است نه یک کاربر خاص!
-}
-
-message GetNetworkStatisticsResponse
-{
-    int32 total_members = 1;
-    int32 active_members = 2;
-    int32 left_leg_count = 3;
-    int32 right_leg_count = 4;
-    double left_percentage = 5;
-    double right_percentage = 6;
-    double average_depth = 7;
-    int32 max_depth = 8;  // ✅ max_depth (نه tree_depth)
-    repeated LevelDistribution level_distribution = 9;
-    repeated MonthlyGrowth monthly_growth = 10;
-    repeated TopNetworkUser top_users = 11;
-}
-```
-
-**🚨 مشکل بزرگ**: 
-1. CMS دیگر `UserId` نمی‌گیرد - این Query برای کل شبکه است
-2. فیلد `LastMember` وجود ندارد
-3. Response خیلی جامع‌تر شده (LevelDistribution, MonthlyGrowth, TopUsers)
-
-**🔧 راه حل**: باید یک Query جدید در CMS اضافه شود یا از `GetUserNetwork` استفاده کنیم:
-
-### گزینه A: استفاده از GetUserNetwork (سریع‌تر)
-
-```csharp
-public async Task<GetMyNetworkStatisticsResponseDto> Handle(GetMyNetworkStatisticsQuery request, CancellationToken cancellationToken)
-{
-    var userId = _currentUserService.UserId ?? throw new UnauthorizedAccessException();
-
-    // ✅ استفاده از GetUserNetwork:
-    var userNetworkRequest = new GetUserNetworkRequest { UserId = userId };
-    var userNetwork = await _context.NetworkMemberships.GetUserNetworkAsync(userNetworkRequest, cancellationToken);
-
-    // ✅ استفاده از GetNetworkTree برای شمارش:
-    var treeRequest = new GetNetworkTreeRequest
-    {
-        RootUserId = userId,
-        MaxDepth = 10  // Full tree
-    };
-    var tree = await _context.NetworkMemberships.GetNetworkTreeAsync(treeRequest, cancellationToken);
-
-    var leftCount = tree.Nodes.Count(n => n.ParentId == userId && n.NetworkLeg == 0);
-    var rightCount = tree.Nodes.Count(n => n.ParentId == userId && n.NetworkLeg == 1);
-
-    var lastMember = tree.Nodes
-        .Where(n => n.ParentId == userId)
-        .OrderByDescending(n => n.JoinedAt)
-        .FirstOrDefault();
-
-    return new GetMyNetworkStatisticsResponseDto
-    {
-        LeftLegCount = leftCount,
-        RightLegCount = rightCount,
-        TotalMembers = tree.Nodes.Count,
-        TreeDepth = tree.Nodes.Any() ? tree.Nodes.Max(n => n.NetworkLevel) : 0,
-        WeakerLeg = leftCount < rightCount ? "Left" : "Right",
-        LastMember = lastMember != null ? new LastMemberDto
-        {
-            UserId = lastMember.UserId,
-            FullName = lastMember.UserName,
-            Position = lastMember.NetworkLeg == 0 ? "Left" : "Right",
-            JoinedAt = lastMember.JoinedAt?.ToDateTime() ?? DateTime.UtcNow
-        } : null
-    };
-}
-```
-
-### گزینه B: اضافه کردن Query جدید به CMS (بهتر)
-
-در `networkmembership.proto` اضافه کن:
-
-```protobuf
-rpc GetUserNetworkStatistics(GetUserNetworkStatisticsRequest) returns (GetUserNetworkStatisticsResponse);
-
-message GetUserNetworkStatisticsRequest
-{
-    int64 user_id = 1;
-}
-
-message GetUserNetworkStatisticsResponse
-{
-    int32 left_leg_count = 1;
-    int32 right_leg_count = 2;
-    int32 total_children = 3;
-    int32 max_depth = 4;
-    string weaker_leg = 5; // "Left" | "Right"
-    google.protobuf.Int64Value last_member_id = 6;
-    google.protobuf.StringValue last_member_name = 7;
-    google.protobuf.Timestamp last_joined_at = 8;
-}
-```
-
---
-
-## 3️⃣ Commission - مغایرت‌ها
-
-### 🟢 BFF Handlers (2 عدد - موجود)
-```
-✅ GetMyCommissionPayouts (Query)
-✅ GetMyWeeklyBalances (Query)
-```
-
-### 📋 CMS Protobuf (commission.proto)
-```protobuf
-service CommissionContract {
-    // Commands
-    rpc CalculateWeeklyBalances(CalculateWeeklyBalancesRequest) returns (Empty);
-    rpc CalculateWeeklyCommissionPool(CalculateWeeklyCommissionPoolRequest) returns (Empty);
-    rpc ProcessUserPayouts(ProcessUserPayoutsRequest) returns (Empty);
-    rpc RequestWithdrawal(RequestWithdrawalRequest) returns (Empty);
-    rpc ProcessWithdrawal(ProcessWithdrawalRequest) returns (Empty);
-    rpc ApproveWithdrawal(ApproveWithdrawalRequest) returns (Empty);
-    rpc RejectWithdrawal(RejectWithdrawalRequest) returns (Empty);
-    
-    // Queries
-    rpc GetWeeklyCommissionPool(GetWeeklyCommissionPoolRequest) returns (GetWeeklyCommissionPoolResponse);
-    rpc GetUserCommissionPayouts(GetUserCommissionPayoutsRequest) returns (GetUserCommissionPayoutsResponse);
-    rpc GetCommissionPayoutHistory(GetCommissionPayoutHistoryRequest) returns (GetCommissionPayoutHistoryResponse);
-    rpc GetUserWeeklyBalances(GetUserWeeklyBalancesRequest) returns (GetUserWeeklyBalancesResponse);
-    rpc GetAllWeeklyPools(GetAllWeeklyPoolsRequest) returns (GetAllWeeklyPoolsResponse);
-    rpc GetWithdrawalRequests(GetWithdrawalRequestsRequest) returns (GetWithdrawalRequestsResponse);
-    
-    // Worker Control APIs
-    rpc TriggerWeeklyCalculation(TriggerWeeklyCalculationRequest) returns (TriggerWeeklyCalculationResponse);
-    rpc GetWorkerStatus(GetWorkerStatusRequest) returns (GetWorkerStatusResponse);
-    rpc GetWorkerExecutionLogs(GetWorkerExecutionLogsRequest) returns (GetWorkerExecutionLogsResponse);
-}
-```
-
---
-
-### ❌ مشکل 4: GetMyCommissionPayoutsQueryHandler
-
-**فایل**: `FrontOffice.BFF/src/FrontOffice.BFF.Application/CommissionCQ/Queries/GetMyCommissionPayouts/GetMyCommissionPayoutsQueryHandler.cs`
-
-**کد فعلی**:
-```csharp
-var cmsRequest = new GetUserCommissionPayoutsRequest
-{
-    UserId = userId,
-    PageNumber = request.PageNumber,  // ❌ نام اشتباه
-    PageSize = request.PageSize       // ❌ نام اشتباه
-};
-
-if (request.WeekNumber.HasValue)
-    cmsRequest.WeekNumber = request.WeekNumber.Value;  // ❌ نوع داده اشتباه
-
-if (request.Status.HasValue)
-    cmsRequest.Status = request.Status.Value;
-```
-
-**CMS Proto**:
-```protobuf
-message GetUserCommissionPayoutsRequest
-{
-    google.protobuf.Int64Value user_id = 1;
-    google.protobuf.Int32Value status = 2;
-    google.protobuf.StringValue week_number = 3;  // ✅ string است (نه int)
-    int32 page_index = 4;  // ✅ page_index (نه page_number)
-    int32 page_size = 5;
-}
-
-message UserCommissionPayoutModel
-{
-    int64 id = 1;
-    int64 user_id = 2;
-    string user_name = 3;
-    string week_number = 4;  // ✅ string است
-    int32 balances_earned = 5;
-    int64 value_per_balance = 6;
-    int64 total_amount = 7;
-    int32 status = 8;
-    google.protobuf.Int32Value withdrawal_method = 9;
-    string iban_number = 10;
-    google.protobuf.Timestamp created = 11;
-    google.protobuf.Timestamp last_modified = 12;
-}
-```
-
-**🔧 راه حل**:
-```csharp
-var cmsRequest = new GetUserCommissionPayoutsRequest
-{
-    UserId = userId,
-    PageIndex = request.PageNumber,   // ✅ PageIndex
-    PageSize = request.PageSize
-};
-
-if (!string.IsNullOrEmpty(request.WeekNumber))
-    cmsRequest.WeekNumber = request.WeekNumber;  // ✅ string
-
-if (request.Status.HasValue)
-    cmsRequest.Status = request.Status.Value;
-
-// در DTO نیز باید تغییر کند:
-var payouts = response.Models.Select(p => new CommissionPayoutDto
-{
-    Id = p.Id,
-    WeekNumber = p.WeekNumber,  // ✅ string
-    WeekLabel = $"هفته {p.WeekNumber}",
-    BalancesEarned = p.BalancesEarned,
-    ValuePerBalance = p.ValuePerBalance,  // ✅ جدید
-    TotalAmount = p.TotalAmount,
-    AmountFormatted = FormatCurrency(p.TotalAmount),
-    Status = MapStatus(p.Status),
-    StatusBadgeColor = GetStatusColor(p.Status),
-    WithdrawalMethod = p.WithdrawalMethod?.ToString(),  // ✅ جدید
-    IbanNumber = p.IbanNumber,  // ✅ جدید
-    CalculatedDate = p.Created?.ToDateTime() ?? DateTime.UtcNow,
-    LastModified = p.LastModified?.ToDateTime(),  // ✅ جدید
-    DatePersian = FormatPersianDate(p.Created?.ToDateTime())
-}).ToList();
-```
-
-**Query DTO نیز باید بروز شود**:
-```csharp
-public class GetMyCommissionPayoutsQuery : IRequest<GetMyCommissionPayoutsResponseDto>
-{
-    public string? WeekNumber { get; set; }  // ✅ string (نه int?)
-    public int? Status { get; set; }
-    public int PageNumber { get; set; } = 1;
-    public int PageSize { get; set; } = 10;
-}
-```
-
---
-
-### ❌ مشکل 5: GetMyWeeklyBalancesQueryHandler
-
-**این Handler احتمالا وجود دارد اما بررسی نشده**. باید چک شود:
-
-**CMS Proto**:
-```protobuf
-message GetUserWeeklyBalancesRequest
-{
-    google.protobuf.Int64Value user_id = 1;
-    google.protobuf.StringValue week_number = 2;  // ✅ string
-    bool only_active = 3;
-    int32 page_index = 4;
-    int32 page_size = 5;
-}
-
-message UserWeeklyBalanceModel
-{
-    int64 id = 1;
-    int64 user_id = 2;
-    string week_number = 3;  // ✅ string
-    int32 left_leg_balances = 4;
-    int32 right_leg_balances = 5;
-    int32 total_balances = 6;
-    int64 weekly_pool_contribution = 7;
-    google.protobuf.Timestamp calculated_at = 8;
-    bool is_expired = 9;
-    google.protobuf.Timestamp created = 10;
-}
-```
-
-**مشکل احتمالی**: نام فیلدها و نوع `week_number` (string vs int)
-
---
-
-## 4️⃣ UserWallet - TODO Queries
-
-### 🟡 BFF Handlers (5 عدد - بعضی کامنت شده)
-```
-✅ GetUserWallet (Query) - موجود
-⚠️ GetAllUserWalletChangeLog (Query) - TODO
-⚠️ WithdrawBalance (Command) - TODO
-⚠️ GetUserWithdrawals (Query) - TODO
-⚠️ GetWithdrawalSettings (Query) - TODO
-```
-
-این ها در `/FrontOffice/src/FrontOffice.Main/Utilities/WalletService.cs` کامنت شده‌اند.
-
-**CMS API ها موجود هستند در `Commission` proto**:
-```protobuf
-rpc RequestWithdrawal(RequestWithdrawalRequest) returns (Empty);
-rpc GetWithdrawalRequests(GetWithdrawalRequestsRequest) returns (GetWithdrawalRequestsResponse);
-```
-
-**⚠️ نکته**: `WithdrawBalance` در `Commission` است نه `UserWallet`!
-
---
-
-## 📋 خلاصه اقدامات لازم
-
-### فاز 1: اصلاح Handler های موجود (اولویت بالا) ⚡
-
-#### 1.1. ClubMembershipCQ
-
-**فایل**: `GetMyClubMembershipQueryHandler.cs`
-
-```csharp
-// ❌ کد قدیمی:
-var activationDate = response.ActivationDate?.ToDateTime();
-var expirationDate = response.ExpirationDate?.ToDateTime();
-
-// ✅ کد جدید:
-var activationDate = response.ActivatedAt?.ToDateTime();
-var expirationDate = response.ExpiresAt?.ToDateTime();
-
-// ✅ اضافه کردن Features:
-Features = response.Features.Select(f => new MembershipFeatureDto
-{
-    ProductId = f.ProductId,
-    ProductName = f.ProductName,
-    Quantity = f.Quantity,
-    ExpiresAt = f.ExpiresAt?.ToDateTime(),
-    IsActive = f.IsActive
-}).ToList()
-```
-
-**فایل**: `ActivateMyClubMembershipCommandHandler.cs`
-
-```csharp
-// ✅ بعد از Activate، GetClubMembership را صدا بزن:
-await _context.ClubMemberships.ActivateClubMembershipAsync(grpcRequest, cancellationToken);
-
-var membershipRequest = new GetClubMembershipRequest { UserId = userId };
-var membership = await _context.ClubMemberships.GetClubMembershipAsync(membershipRequest, cancellationToken);
-
-return new ActivateMyClubMembershipResponseDto
-{
-    Success = true,
-    Message = "عضویت باشگاه با موفقیت فعال شد",
-    ActivationDate = membership.ActivatedAt?.ToDateTime(),
-    ExpirationDate = membership.ExpiresAt?.ToDateTime(),
-    // AmountPaid باید از Package Service گرفته شود یا محاسبه شود
-};
-```
-
---
-
-#### 1.2. NetworkMembershipCQ
-
-**فایل**: `GetMyNetworkTreeQueryHandler.cs`
-
-```csharp
-// ✅ کامل بازنویسی با Tree Builder:
-var response = await _context.NetworkMemberships.GetNetworkTreeAsync(cmsRequest, cancellationToken);
-var rootNode = BuildTreeFromFlatList(response.Nodes, userId);
-
-return new GetMyNetworkTreeResponseDto
-{
-    RootNode = rootNode,
-    TotalMembers = response.Nodes.Count,
-    CurrentDepth = response.Nodes.Any() ? response.Nodes.Max(n => n.NetworkLevel) : 0
-};
-
-// اضافه کردن متد BuildTreeFromFlatList (کد کامل بالا)
-```
-
-**فایل**: `GetMyNetworkStatisticsQueryHandler.cs`
-
-```csharp
-// ✅ استفاده از GetUserNetwork + GetNetworkTree:
-var userNetworkRequest = new GetUserNetworkRequest { UserId = userId };
-var userNetwork = await _context.NetworkMemberships.GetUserNetworkAsync(userNetworkRequest, cancellationToken);
-
-var treeRequest = new GetNetworkTreeRequest { RootUserId = userId, MaxDepth = 10 };
-var tree = await _context.NetworkMemberships.GetNetworkTreeAsync(treeRequest, cancellationToken);
-
-// محاسبه آمار (کد کامل بالا)
-```
-
---
-
-#### 1.3. CommissionCQ
-
-**فایل**: `GetMyCommissionPayoutsQueryHandler.cs`
-
-```csharp
-// ❌ کد قدیمی:
-var cmsRequest = new GetUserCommissionPayoutsRequest
-{
-    UserId = userId,
-    PageNumber = request.PageNumber,
-    PageSize = request.PageSize
-};
-if (request.WeekNumber.HasValue)
-    cmsRequest.WeekNumber = request.WeekNumber.Value;
-
-// ✅ کد جدید:
-var cmsRequest = new GetUserCommissionPayoutsRequest
-{
-    UserId = userId,
-    PageIndex = request.PageNumber,  // PageIndex
-    PageSize = request.PageSize
-};
-if (!string.IsNullOrEmpty(request.WeekNumber))
-    cmsRequest.WeekNumber = request.WeekNumber;  // string
-
-// ✅ Response Mapping:
-var payouts = response.Models.Select(p => new CommissionPayoutDto
-{
-    Id = p.Id,
-    WeekNumber = p.WeekNumber,  // string
-    ValuePerBalance = p.ValuePerBalance,  // جدید
-    WithdrawalMethod = p.WithdrawalMethod,  // جدید
-    IbanNumber = p.IbanNumber,  // جدید
-    LastModified = p.LastModified?.ToDateTime()  // جدید
-    // ... بقیه فیلدها
-}).ToList();
-```
-
-**Query DTO**:
-```csharp
-public class GetMyCommissionPayoutsQuery
-{
-    public string? WeekNumber { get; set; }  // ✅ string
-    // ...
-}
-
-public class CommissionPayoutDto
-{
-    public long ValuePerBalance { get; set; }  // ✅ جدید
-    public string? WithdrawalMethod { get; set; }  // ✅ جدید
-    public string? IbanNumber { get; set; }  // ✅ جدید
-    public DateTime? LastModified { get; set; }  // ✅ جدید
-    // ...
-}
-```
-
---
-
-### فاز 2: اضافه کردن Handler های جدید (اولویت متوسط) 🟡
-
-#### 2.1. UserWalletCQ - GetAllUserWalletChangeLog
-
-```csharp
-// Query:
-public class GetAllUserWalletChangeLogQuery : IRequest<GetAllUserWalletChangeLogResponseDto>
-{
-    public long? ReferenceId { get; set; }
-    public bool? IsIncrease { get; set; }
-    public int PageNumber { get; set; } = 1;
-    public int PageSize { get; set; } = 20;
-}
-
-// Handler:
-public async Task<GetAllUserWalletChangeLogResponseDto> Handle(...)
-{
-    var userId = _currentUserService.UserId ?? throw new UnauthorizedAccessException();
-
-    // TODO: باید در CMS یک Query اضافه شود
-    // فعلا از GetUserCommissionPayouts استفاده کنیم برای تاریخچه برداشت
-    var request = new GetWithdrawalRequestsRequest
-    {
-        UserId = userId,
-        PageIndex = request.PageNumber,
-        PageSize = request.PageSize
-    };
-
-    var response = await _context.Commission.GetWithdrawalRequestsAsync(request, cancellationToken);
-
-    // Mapping...
-}
-```
-
-#### 2.2. UserWalletCQ - WithdrawBalance Command
-
-```csharp
-// Command:
-public class WithdrawBalanceCommand : IRequest<WithdrawBalanceResponseDto>
-{
-    public long PayoutId { get; set; }
-    public int WithdrawalMethod { get; set; }  // 0=Cash, 1=Diamond
-    public string? IbanNumber { get; set; }
-}
-
-// Handler:
-public async Task<WithdrawBalanceResponseDto> Handle(...)
-{
-    var userId = _currentUserService.UserId ?? throw new UnauthorizedAccessException();
-
-    var request = new RequestWithdrawalRequest
-    {
-        PayoutId = command.PayoutId,
-        WithdrawalMethod = command.WithdrawalMethod,
-        IbanNumber = command.IbanNumber
-    };
-
-    await _context.Commission.RequestWithdrawalAsync(request, cancellationToken);
-
-    return new WithdrawBalanceResponseDto
-    {
-        Success = true,
-        Message = "درخواست برداشت ثبت شد"
-    };
-}
-```
-
---
-
-## ⏱️ تخمین زمان اجرا
-
-| مرحله | فایل‌ها | زمان | اولویت |
-|-------|---------|------|--------|
-| ClubMembership fix | 2 Handler | 2 ساعت | 🔴 بالا |
-| NetworkMembership fix | 2 Handler | 3-4 ساعت | 🔴 بالا |
-| Commission fix | 2 Handler | 2 ساعت | 🔴 بالا |
-| UserWallet new Queries | 4 Handler | 3 ساعت | 🟡 متوسط |
-| Testing & Build | - | 2 ساعت | 🟢 پایین |
-| **جمع کل** | **10 Handler** | **12-15 ساعت** | |
-
---
-
-## ✅ Checklist اجرایی
-
-### مرحله 1: ClubMembershipCQ
- [ ] GetMyClubMembershipQueryHandler: تغییر ActivationDate → ActivatedAt
- [ ] GetMyClubMembershipQueryHandler: تغییر ExpirationDate → ExpiresAt
- [ ] GetMyClubMembershipResponseDto: اضافه کردن List<MembershipFeatureDto>
- [ ] ActivateMyClubMembershipCommandHandler: گرفتن داده واقعی از GetClubMembership
-
-### مرحله 2: NetworkMembershipCQ
- [ ] GetMyNetworkTreeQueryHandler: پیاده‌سازی BuildTreeFromFlatList
- [ ] GetMyNetworkTreeQueryHandler: حذف استفاده از response.RootNode
- [ ] GetMyNetworkStatisticsQueryHandler: حذف فیلد UserId از Request
- [ ] GetMyNetworkStatisticsQueryHandler: استفاده از GetUserNetwork + GetNetworkTree
- [ ] GetMyNetworkStatisticsResponseDto: نام TreeDepth → MaxDepth
-
-### مرحله 3: CommissionCQ
- [ ] GetMyCommissionPayoutsQuery: تغییر WeekNumber از int? به string?
- [ ] GetMyCommissionPayoutsQueryHandler: PageNumber → PageIndex
- [ ] CommissionPayoutDto: اضافه کردن ValuePerBalance, WithdrawalMethod, IbanNumber, LastModified
- [ ] GetMyWeeklyBalancesQueryHandler: بررسی و اصلاح (اگر لازم باشد)
-
-### مرحله 4: UserWalletCQ
- [ ] Query: GetAllUserWalletChangeLog ساخته شود
- [ ] Command: WithdrawBalance ساخته شود
- [ ] Query: GetUserWithdrawals ساخته شود (از GetWithdrawalRequests استفاده کند)
- [ ] Query: GetWithdrawalSettings ساخته شود
- [ ] WalletService.cs: uncomment کردن متدها
-
-### مرحله 5: Build & Test
- [ ] dotnet build FrontOffice.BFF.sln
- [ ] dotnet build FrontOffice/src/FrontOffice.sln
- [ ] تست هر Handler با Postman/Swagger
- [ ] تست UI با داده واقعی
-
---
-
-**📅 آخرین بروزرسانی**: ۱۴ آذر ۱۴۰۴  
-**👤 توسط**: GitHub Copilot (Claude Sonnet 4.5)
@@ -1,142 +0,0 @@
-# BackOffice - Network & Commission Management System
-
-**Version**: 2.2  
-**Last Updated**: 2025-12-05  
-**Status**: 🟡 **Build In Progress - ~12 Errors Remaining**
-
---
-
-## 📋 Overview
-
-BackOffice is a comprehensive Blazor WebAssembly application for managing network marketing operations, commission calculations, club memberships, and system administration.
-
---
-
-## 🎯 Current Status
-
-### **Build Status: 🔴 FAILING (~12 errors)**
-
-> See `BackOffice/docs/BUILD-FIX-STATUS.md` for detailed error list
-
-### **Recent Changes (2025-12-05)**:
- ⚠️ Migrated from .NET 8 to .NET 9
- ⚠️ Updated MudBlazor to 8.14.0 (requires T parameter for generics)
- ⚠️ Multiple files excluded from build (missing proto dependencies)
- ⚠️ Products.Protobuf switched from NuGet to ProjectReference
-
-### **Known Issues**:
- Missing proto projects: DiscountProduct, DiscountCategory, DiscountOrder, Tag, ProductTag
- Some UserOrder methods missing in proto (CancelOrder, ApplyDiscount, UpdateOrderStatus)
- PaginationState namespace conflicts
- Int32Value/Int64Value binding issues in WithdrawalReports
-
-### **Excluded Files** (see `BackOffice/docs/EXCLUDED-FILES.md`):
- `Pages/DiscountShop/**` - needs new proto projects
- `Pages/Tag/**` - needs Tag.Protobuf
- `Pages/Products/Components/*Dialog*` - needs proto updates
- `Pages/UserOrder/Components/*Dialog*` - needs proto updates
- Several other pages with missing dependencies
-
---
-
-## 📁 Project Structure
-
-```
-BackOffice/
-├── docs/
-│   ├── development-plan.md     # Detailed implementation roadmap
-│   ├── BUILD-FIX-STATUS.md     # Current build errors and fixes
-│   ├── EXCLUDED-FILES.md       # List of excluded files
-│   └── PROTO-DEPENDENCIES.md   # Proto requirements
-├── src/
-│   ├── BackOffice.sln
-│   └── BackOffice/
-│       ├── Pages/
-│       │   ├── Commission/     # 4 pages (Dashboard, Reports, Payouts, Withdrawals)
-│       │   ├── Network/        # 4 pages (Tree, History, Balances, Info)
-│       │   ├── Club/           # 3 pages (Members, Statistics)
-│       │   ├── SystemManagement/ # 4 pages (Worker, Alerts, Health, Config)
-│       │   ├── Dashboard/      # 1 page (SystemOverview)
-│       │   └── Settings/       # 1 page (UserSettings)
-│       └── Components/         # Reusable dialogs
-└── README.md
-```
-
---
-
-## 🚀 Getting Started
-
-### Prerequisites:
- .NET 9.0 SDK
- Running CMS microservice (port 5133)
- Running BFF service (port 5001)
-
-### Run BackOffice:
-```bash
-cd src/BackOffice
-dotnet run
-```
-
-Access at: `https://localhost:7001`
-
---
-
-## 📊 Features
-
-### **1. Commission Management** 💰
- Weekly pool dashboard with statistics
- Commission reports with filtering
- User payouts tracking
- Withdrawal approval/rejection
- Manual calculation trigger
-
-### **2. Network Management** 🌳
- Binary tree visualization (table-based)
- User network information
- Network history tracking
- Weekly balance reports
-
-### **3. Club Management** 🏆
- Active/Inactive club members
- Activation/Deactivation workflows
- Member statistics (mock data)
-
-### **4. System Management** ⚙️
- Worker control panel
- System alerts monitoring
- Health dashboard
- Configuration editor
-
---
-
-## 🔧 Technical Stack
-
- **Framework**: Blazor WebAssembly
- **UI Library**: MudBlazor
- **Communication**: gRPC-Web
- **Authentication**: JWT Bearer
- **Build Status**: ✅ 0 errors
-
---
-
-## 📖 Documentation
-
-See `docs/development-plan.md` for:
- Detailed feature specifications
- Implementation status
- API documentation
- Architecture diagrams
- Testing guidelines
-
---
-
-## 🎯 Next Steps
-
-1. Implement Statistics APIs with real database queries
-2. Frontend integration testing
-3. Add audit logging for critical operations
-4. Implement caching for performance optimization
-
---
-
-**For detailed implementation status, see**: [development-plan.md](docs/development-plan.md)
@@ -1,612 +0,0 @@
-# گزارش وضعیت UI پنل مدیریت (BackOffice)
-
-تاریخ گزارش: 2024-12-04
-وضعیت کلی: **آماده برای Production - 95% کامل** 🎉
-
---
-
-## 📊 خلاصه آماری
-
-| بخش | تعداد موارد | وضعیت |
-|-----|-------------|-------|
-| صفحات موجود قبلی | 56 صفحه | ✅ آماده |
-| صفحات جدید | 4 صفحه | ✅ کامل |
-| Services Backend | 8 فایل (4 Interface + 4 Implementation) | ✅ کامل |
-| Dialog Components | 6 کامپوننت | ✅ کامل |
-| اتصالات CRUD | همه عملیات | ✅ کامل |
-| گزارش‌ها و نمودارهای مالی | 2 صفحه | 🟡 تکمیل پایه (PDF باقیمانده) |
-| **جمع کل** | **60 صفحه + 8 سرویس + 6 دیالوگ** | **95% آماده** 🎉 |
-
---
-
-## ✅ صفحات موجود و آماده (56 صفحه)
-
-### 1. داشبورد و نمای کلی
- ✅ Dashboard/Index.razor - داشبورد اصلی
- ✅ Dashboard/Overview - نمای کلی سیستم
-
-### 2. کمیسیون (4 صفحه)
- ✅ Commission/Dashboard.razor - داشبورد کمیسیون
- ✅ Commission/Reports.razor - گزارش‌های هفتگی
- ✅ Commission/Payouts.razor - پرداخت کاربران
- ✅ Commission/Withdrawals.razor - درخواست‌های برداشت (لیست، فیلتر وضعیت، دکمه‌های Approve/Reject/Process متصل به API، نمایش BankReferenceId / TrackingCode / PaymentFailureReason)
-
-### 3. شبکه (3 صفحه)
- ✅ Network/Tree.razor - درخت شبکه
- ✅ Network/Balances.razor - گزارش موجودی‌ها
- ✅ Network/Statistics.razor - آمار شبکه
-
-### 4. باشگاه (2 صفحه)
- ✅ Club/Members.razor - اعضای باشگاه
- ✅ Club/Statistics.razor - آمار باشگاه
-
-### 5. مدیریت محصولات و سفارشات (6 صفحه)
- ✅ Package/ - مدیریت پکیج‌ها
- ✅ Products/ProductsMainPage.razor - مدیریت محصولات
- ✅ Products/ProductCategoriesDragDropPage.razor - مدیریت دسته‌بندی محصولات
- ✅ Category/ - مدیریت دسته‌بندی‌ها
- ✅ UserOrder/ - مدیریت سفارشات
- ✅ Products/Components/ - کامپوننت‌های محصول
- ✅ Tag/ - مدیریت تگ‌ها (لیست + جستجو + ایجاد/ویرایش/حذف، اختصاص تگ به محصول از طریق ProductsMainPage، نمایش تگ‌های فعلی هر محصول و امکان حذف آن‌ها در AssignTagsDialog)
-
-### 6. مدیریت کاربران و نقش‌ها (4 صفحه)
- ✅ User/ - مدیریت کاربران
- ✅ UserRole/ - مدیریت نقش کاربران
- ✅ Role/ - مدیریت نقش‌ها
- ✅ UserAddress/ - مدیریت آدرس‌های کاربران
-
-### 7. سیستم و تنظیمات (5 صفحه)
- ✅ SystemManagement/ - مدیریت سیستم
- ✅ Settings/ - تنظیمات
- ✅ Login/ - صفحه ورود
- ✅ System/Alerts.razor - مدیریت هشدارها
- ✅ System/Health.razor - سلامت سیستم
-
-### 8. کامپوننت‌های عمومی
- ✅ AutoComplete/ - کامپوننت‌های AutoComplete
- ✅ Components/ - سایر کامپوننت‌های مشترک
-
---
-
-## 🆕 صفحات جدید ساخته شده (4 صفحه) + Services
-
-### فروشگاه تخفیفی (3 صفحه)
-```
-✅ Pages/DiscountShop/DiscountProductsMainPage.razor
-   - مدیریت محصولات تخفیفی
-   - فیلتر: جستجو، دسته‌بندی، وضعیت، موجودی
-   - CRUD: افزودن، ویرایش، حذف محصول
-   - نمایش: تصویر، قیمت، تخفیف، موجودی، فروش
-   - ✅ متصل به IDiscountProductService
-
-✅ Pages/DiscountShop/DiscountCategoriesMainPage.razor
-   - مدیریت دسته‌بندی‌های فروشگاه تخفیفی
-   - نمایش درختی (Tree View) با سلسله مراتب
-   - CRUD: افزودن دسته/زیردسته، ویرایش، حذف
-   - جستجو در عنوان و توضیحات
-   - ✅ متصل به IDiscountCategoryService
-
-✅ Pages/DiscountShop/DiscountOrdersMainPage.razor
-   - مدیریت سفارشات فروشگاه تخفیفی
-   - فیلتر: جستجو، وضعیت، بازه تاریخ
-   - عملیات: مشاهده جزئیات، تغییر وضعیت سفارش
-   - وضعیت‌ها: در انتظار، پرداخت شده، آماده‌سازی، ارسال، تحویل، لغو، مرجوع
-   - ✅ متصل به IDiscountOrderService
-```
-
-### پیام‌های عمومی (1 صفحه)
-```
-✅ Pages/PublicMessages/PublicMessagesMainPage.razor
-   - مدیریت پیام‌های عمومی (اطلاعیه‌ها، اخبار، هشدارها)
-   - فیلتر: جستجو، وضعیت، نوع پیام
-   - CRUD: ایجاد، ویرایش، حذف پیام
-   - عملیات: انتشار، بایگانی، مشاهده
-   - انواع پیام: اطلاعیه، خبر، هشدار، تبلیغات
-   - وضعیت: پیش‌نویس، منتشر شده، بایگانی شده
-   - ✅ متصل به IPublicMessageService
-```
-
-### 🆕 Services پیاده‌سازی شده (8 فایل)
-
-#### 1. Discount Product Service
-```
-✅ Services/DiscountProduct/IDiscountProductService.cs
-   - Interface: GetProductsAsync, GetByIdAsync, CreateAsync, UpdateAsync, DeleteAsync
-   - DTOs: ProductFilterDto, DiscountProductDto, CreateDiscountProductDto, UpdateDiscountProductDto
-
-✅ Services/DiscountProduct/DiscountProductService.cs
-   - پیاده‌سازی کامل با DiscountProductsContractClient
-   - فیلترینگ سمت سرور
-   - مدیریت تصاویر و تگ‌ها
-```
-
-#### 2. Discount Category Service
-```
-✅ Services/DiscountCategory/IDiscountCategoryService.cs
-   - Interface: GetCategoriesAsync, GetByIdAsync, CreateAsync, UpdateAsync, DeleteAsync
-   - DTOs: DiscountCategoryDto, CreateDiscountCategoryDto, UpdateDiscountCategoryDto
-
-✅ Services/DiscountCategory/DiscountCategoryService.cs
-   - پیاده‌سازی کامل با DiscountCategoriesContractClient
-   - ساخت ساختار درختی (Tree Structure)
-   - مدیریت Parent-Child relationships
-```
-
-#### 3. Discount Order Service
-```
-✅ Services/DiscountOrder/IDiscountOrderService.cs
-   - Interface: GetOrdersAsync, GetByIdAsync, UpdateStatusAsync
-   - DTOs: OrderFilterDto, DiscountOrderDto, DiscountOrderDetailsDto, OrderItemDto, UpdateOrderStatusDto
-   - Enums: OrderStatus (7 states)
-
-✅ Services/DiscountOrder/DiscountOrderService.cs
-   - پیاده‌سازی کامل با DiscountOrdersContractClient
-   - فیلترینگ پیشرفته (جستجو، وضعیت، بازه تاریخ)
-   - مدیریت آیتم‌های سفارش
-```
-
-#### 4. Public Message Service
-```
-✅ Services/PublicMessage/IPublicMessageService.cs
-   - Interface: GetMessagesAsync, GetByIdAsync, CreateAsync, UpdateAsync, DeleteAsync, PublishAsync, ArchiveAsync
-   - DTOs: MessageFilterDto, PublicMessageDto, PublicMessageDetailsDto, CreatePublicMessageDto, UpdatePublicMessageDto
-   - Enums: MessageType (4 types), MessageStatus (3 states)
-
-✅ Services/PublicMessage/PublicMessageService.cs
-   - پیاده‌سازی کامل با PublicMessagesContractClient
-   - مدیریت چرخه حیات پیام (Draft → Published → Archived)
-   - مدیریت تصاویر، اکشن‌ها و تگ‌ها
-```
-
---
-
-## 📋 منوی ناوبری به‌روز شده
-
-```razor
-NavMenu.razor - آپدیت شده با بخش‌های جدید:
-
-├─ داشبورد
-├─ نمای کلی سیستم
-├─ کمیسیون (4 زیرمنو)
-├─ شبکه (3 زیرمنو)
-├─ باشگاه (2 زیرمنو)
-├─ مدیریت (6 آیتم - Administrator)
-├─ 🆕 فروشگاه تخفیفی (3 زیرمنو - Administrator) ⭐
-│  ├─ محصولات تخفیفی
-│  ├─ دسته‌بندی‌های فروشگاه
-│  └─ سفارشات فروشگاه
-├─ 🆕 پیام‌های عمومی (Administrator) ⭐
-├─ سیستم (3 آیتم - Administrator)
-├─ تنظیمات
-└─ خروج
-```
-
---
-
-## 🎉 مراحل تکمیل شده
-
-### ✅ فاز 1: اتصال Backend - کامل!
-```
-✅ IDiscountProductService + Implementation
-✅ IDiscountCategoryService + Implementation
-✅ IDiscountOrderService + Implementation
-✅ IPublicMessageService + Implementation
-✅ gRPC Client Registration (4 clients)
-✅ DI Configuration
-✅ صفحات متصل به Services
-```
-
-### ✅ فاز 2: Dialog Components - کامل!
-
-#### 1. Discount Shop Dialogs (4 کامپوننت) ✅
-```
-✅ DiscountShop/Components/ProductFormDialog.razor
-   - فرم کامل محصول با validation
-   - مدیریت تصاویر و تگ‌ها
-   - انتخاب دسته‌بندی با Tree View
-   - Create و Edit modes
-
-✅ DiscountShop/Components/CategoryFormDialog.razor
-   - فرم دسته‌بندی با parent selection
-   - Exclude current category در Edit mode
-   - مدیریت ترتیب نمایش
-   - Create و Edit modes
-
-✅ DiscountShop/Components/OrderDetailsDialog.razor
-   - نمایش کامل جزئیات سفارش
-   - اطلاعات خریدار، آدرس، پرداخت
-   - لیست آیتم‌های سفارش با تصاویر
-   - خلاصه مالی و یادداشت ادمین
-
-✅ DiscountShop/Components/ChangeOrderStatusDialog.razor
-   - تغییر وضعیت سفارش (7 حالت)
-   - یادداشت ادمین
-   - هشدارهای مناسب برای هر وضعیت
-   - Validation و UI feedback
-```
-
-#### 2. Public Messages Dialogs (2 کامپوننت) ✅
-```
-✅ PublicMessages/Components/MessageFormDialog.razor
-   - فرم کامل پیام با validation
-   - 4 نوع پیام (اطلاعیه، خبر، هشدار، تبلیغات)
-   - مدیریت تصاویر، اکشن‌ها، تگ‌ها
-   - تاریخ انقضا
-   - گزینه انتشار فوری
-   - Create و Edit modes
-
-✅ PublicMessages/Components/MessageViewDialog.razor
-   - نمایش کامل پیام با فرمت زیبا
-   - نمایش تصویر، محتوا، اکشن
-   - آمار بازدید و اطلاعات تاریخ
-   - تگ‌ها و وضعیت پیام
-   - آیکون‌های مناسب برای هر نوع
-```
-
-### ✅ فاز 3: اتصال Dialogs به صفحات - کامل!
-```
-✅ DiscountProductsMainPage: OpenCreateDialog + OpenEditDialog
-✅ DiscountCategoriesMainPage: OpenCreateDialog + OpenEditDialog (با parent support)
-✅ DiscountOrdersMainPage: OpenOrderDetails + OpenChangeStatusDialog
-✅ PublicMessagesMainPage: OpenCreateDialog + OpenEditDialog + ViewMessage
-✅ همه عملیات CRUD به سرویس‌ها متصل شدند
-✅ Error Handling و User Feedback با Snackbar
-```
-
-## 🔨 کارهای باقی‌مانده (Nice to Have)
-
-### اولویت متوسط (Important)
-
-#### 3. بهبود UI/UX صفحات موجود
-```
-⏸️ Products/ProductsMainPage.razor
-   - ✅ افزودن bulk operations (حذف/تغییر وضعیت دسته‌ای)
-   - ✅ افزودن export به Excel (خروجی CSV از لیست محصولات با توجه به فیلترهای فعلی)
-   - ✅ بهبود فیلترهای پیشرفته
-   - ✅ افزودن صفحه ویرایش گروهی محصولات (Pages/Products/BulkEdit.razor) با فرم Bulk Update قیمت، تخفیف، موجودی و وضعیت (اتصال به BulkUpdateProductPrices, BulkUpdateProductStock, ToggleProductStatus)
-
-⏸️ UserOrder/OrdersMainPage.razor
-   - ✅ افزودن timeline سفارش (نمایش مراحل ثبت سفارش، پرداخت، ارسال و تحویل/مرجوعی در UserOrderDetailsDialog بر اساس PaymentStatus و DeliveryStatus)
-   - ✅ افزودن نمایش نمودار آماری سفارشات (کارت جمع سفارش‌ها و نمودار تعداد سفارش بر اساس وضعیت ارسال)
-   - ✅ بهبود جستجوی پیشرفته (فیلتر شناسه سفارش/کاربر/تراکنش و فیلترهای ترکیبی)
-   - ✅ دکمه‌های مدیریت سفارش: لغو سفارش (CancelOrder) با Dialog دلیل/بازگشت وجه، تغییر وضعیت ارسال (UpdateOrderStatus) از طریق ChangeOrderStatusDialog، و Dialog اعمال تخفیف دستی (ApplyDiscountToOrder) متصل به gRPC BackOffice.BFF.UserOrder
-   - ✅ نمایش VAT سفارش: ستون‌های VatAmount/VatPercentage در OrdersMainPage و خلاصه VAT (BaseAmount/VatAmount/TotalAmount) در UserOrderDetailsDialog بر اساس داده‌های BackOffice.BFF.UserOrder
-```
-
-#### 4. گزارش‌های جدید (2 صفحه)
-```
-✅ Commission/Reports/WithdrawalReports.razor
-   - گزارش برداشت‌های کاربران (جمع‌بندی دوره‌ای)
-   - نمودار روند برداشت‌ها (مبالغ و تعداد درخواست‌ها)
-   - فیلتر: بازه تاریخ، کاربر، وضعیت، نوع دوره
-   - Export به Excel (CSV) ✅، Export به PDF 🟡 (خروجی متنی ساختارمند؛ PDF واقعی در نسخه بعدی)
-
-✅ DiscountShop/Reports/SalesReports.razor
-   - گزارش فروش فروشگاه تخفیفی (لیست سفارش‌ها با فیلتر تاریخ/وضعیت/جستجو)
-   - نمودار روند فروش (مبلغ نهایی و تخفیف)
-   - نمودار پرفروش‌ترین محصولات (بر اساس مبلغ فروش)
-   - آمار درآمد: مجموع فروش، مجموع تخفیف، میانگین مبلغ سفارش
-```
-
-### اولویت پایین (Nice to Have)
-
-#### 5. قابلیت‌های اضافی
-```
-✅ Dashboard/DiscountShopWidget.razor
-   - ویجت آمار فروشگاه تخفیفی در داشبورد اصلی (صفحه Dashboard/SystemOverview)
-   - نمایش: تعداد سفارش‌ها و مجموع فروش ۷ روز اخیر، آمار امروز، نمودار روند فروش روزانه (Line Chart)
-
-✅ PublicMessages/Templates/
-   - مدیریت قالب‌های آماده پیام در دیالوگ جداگانه (MessageTemplatesDialog)
-   - ذخیره قالب‌ها در LocalStorage مرورگر (بدون تغییر Backend)
-   - افزودن، حذف و مشاهده پیش‌نمایش قالب‌ها، دسترسی از PublicMessagesMainPage
-
-✅ DiscountShop/Components/ProductImageGallery.razor
-   - کامپوننت گالری تصاویر محصول برای DiscountShop (کلاینت‌ساید)
-   - Upload چندتایی تصاویر (multi-upload) و پیش‌نمایش Base64
-   - Drag & drop reorder برای تغییر ترتیب نمایش
-   - EventCallback برای ارسال لیست تصاویر مرتب‌شده به والد (برای اتصال بعدی به Backend)
-```
-
-#### 6. مدیریت پرداخت‌های دستی (Manual Payments)
-```
-✅ Pages/Payment/ManualPayments.razor
-   - لیست پرداخت‌های دستی (ManualPayment) با MudDataGrid
-   - فیلتر بر اساس UserId و Status
-   - نمایش ستون‌های: Id, UserId, UserFullName, Amount, TypeDisplay, StatusDisplay, Created
-   - دکمه ثبت پرداخت دستی جدید (CreateManualPayment)
-
-✅ Components/ManualPaymentDialog.razor
-   - حالت Create: فرم ثبت ManualPayment (UserId, Amount, Type, Description, ReferenceNumber)
-   - حالت Details: نمایش جزئیات پرداخت دستی و نمایش دلیل رد (در صورت وجود)
-   - دکمه‌های Approve/Reject برای درخواست‌های Pending متصل به BackOffice.BFF.ManualPayment
-```
-
---
-
-## 🎯 برنامه پیاده‌سازی پیشنهادی
-
-### ✅ فاز 1: اتصال Backend (2 روز) - کامل شد!
-1. **✅ Day 1**: Discount Shop Services
-   - ✅ پیاده‌سازی IDiscountProductService + DiscountProductService
-   - ✅ پیاده‌سازی IDiscountCategoryService + DiscountCategoryService
-   - ✅ پیاده‌سازی IDiscountOrderService + DiscountOrderService
-   - ✅ تست اتصال با BackOffice.BFF
-
-2. **✅ Day 2**: Public Messages Service + Integration
-   - ✅ پیاده‌سازی IPublicMessageService + PublicMessageService
-   - ✅ اتصال CRUD operations
-   - ✅ تست Publish/Archive workflows
-   - ✅ اتصال تمام صفحات به Services
-   - ✅ Registration در DI Container
-   - ✅ gRPC Client Configuration
-
-### فاز 2: Dialog Components (2 روز - Critical) - در حال انتظار
-1. **Day 3**: Discount Shop Dialogs
-   - ProductFormDialog.razor (4 ساعت)
-   - CategoryFormDialog.razor (2 ساعت)
-   - OrderDetailsDialog.razor (2 ساعت)
-
-2. **Day 4**: Remaining Dialogs
-   - ChangeOrderStatusDialog.razor (2 ساعت)
-   - MessageFormDialog.razor (4 ساعت)
-   - MessageViewDialog.razor (2 ساعت)
-
-### فاز 3: بهبودها و گزارش‌ها (1.5 روز - Important)
-1. **Day 5**: UI/UX Enhancements
-   - Bulk operations (3 ساعت)
-   - Export functionality (2 ساعت)
-   - Advanced filters (3 ساعت)
-
-2. **Day 6**: گزارش‌های جدید
-   - WithdrawalReports.razor (4 ساعت)
-   - SalesReports.razor (4 ساعت)
-
-### فاز 4: Extra Features (1 روز - Nice to Have)
-1. **Day 7**: قابلیت‌های اضافی
-   - Dashboard widgets
-   - Message templates
-   - Image gallery component
-
---
-
-## 📈 پیشرفت کلی پروژه
-
-```
-Backend Status:
-├─ CMS Microservice: ████████████████████░ 95% (9 TODO handlers)
-├─ BackOffice.BFF: ███████████████████░░ 85% (8 TODO handlers)
-└─ Discount Shop Backend: ████████████████████ 100% ✅
-
-UI Status:
-├─ Existing Pages: ████████████████████ 100% (56 pages) ✅
-├─ New Pages Created: ████████████████████ 100% (4 pages) ✅
-├─ Service Connections: ████████████████████ 100% (4 services) ✅
-├─ Service Implementation: ████████████████████ 100% (8 files) ✅
-├─ DI Registration: ████████████████████ 100% ✅
-├─ Dialog Components: ████████████████████ 100% (6 components) ✅
-├─ CRUD Operations: ████████████████████ 100% ✅
-└─ Reports & Extras: ░░░░░░░░░░░░░░░░░░░░ 0% (Optional) ⏸️
-
-Overall Progress: ███████████████████░░ 95% Complete (↑ از 85%)
-```
-
---
-
-## 🚀 آماده برای Production
-
-### ✅ آماده الان
- 56 صفحه UI کاملاً عملیاتی
- 4 صفحه جدید با Backend متصل شده
- 4 Service Interface + Implementation کامل
- 4 gRPC Client متصل و عملیاتی
- سیستم احراز هویت و مجوزدهی
- منوی ناوبری کامل با بخش‌های جدید
- MudBlazor UI components
- Responsive design
- فیلترینگ و جستجوی پیشرفته
- عملیات CRUD پایه (List, Delete) عملیاتی
-
-### ⏸️ نیاز به تکمیل
- ساخت 6 Dialog component برای CRUD کامل (2 روز)
- گزارش‌ها و بهبودهای UX (1.5 روز)
- قابلیت‌های اضافی (1 روز)
-## 💡 توصیه‌ها
-
-1. **✅ مرحله 1 کامل شد**: Services به Backend متصل شدند - صفحات آماده نمایش داده
-2. **اولویت فعلی**: ساخت Dialog components - ضروری برای CRUD operations کامل
-3. **Testing**: تست کامل workflows با داده‌های واقعی (در صورت دسترسی به CMS)
-4. **Error Handling**: بررسی Proto field errors در DiscountOrder/DiscountShoppingCart (38 خطا)
-5. **Performance**: بررسی performance با داده‌های واقعی (pagination, caching)
-6. **Documentation**: مستندسازی API endpoints برای هر service ✅ انجام شد
-
---**اولویت دوم**: ساخت Dialog components - ضروری برای CRUD operations
-3. **Testing**: تست کامل workflows قبل از production
-4. **Documentation**: مستندسازی API endpoints برای هر service
-5. **Performance**: بررسی performance با داده‌های واقعی (pagination, caching)
-
---
-## 📝 یادداشت‌های فنی
-
-### ✅ Services پیاده‌سازی شده (4 Interface + 4 Implementation)
-
-```csharp
-// تمام Interfaces و پیاده‌سازی‌ها آماده و در DI ثبت شده‌اند
-
-✅ IDiscountProductService + DiscountProductService
-   - GetProductsAsync(ProductFilterDto) → List<DiscountProductDto>
-   - GetByIdAsync(long) → DiscountProductDto
-   - CreateAsync(CreateDiscountProductDto) → long (ProductId)
-   - UpdateAsync(long, UpdateDiscountProductDto) → Task
-   - DeleteAsync(long) → Task
-
-✅ IDiscountCategoryService + DiscountCategoryService
-   - GetCategoriesAsync(bool?) → List<DiscountCategoryDto> (با Tree Structure)
-   - GetByIdAsync(long) → DiscountCategoryDto
-   - CreateAsync(CreateDiscountCategoryDto) → long (CategoryId)
-   - UpdateAsync(long, UpdateDiscountCategoryDto) → Task
-   - DeleteAsync(long) → Task
-
-✅ IDiscountOrderService + DiscountOrderService
-   - GetOrdersAsync(OrderFilterDto) → List<DiscountOrderDto>
-   - GetByIdAsync(long) → DiscountOrderDetailsDto
-   - UpdateStatusAsync(long, UpdateOrderStatusDto) → Task
-
-✅ IPublicMessageService + PublicMessageService
-   - GetMessagesAsync(MessageFilterDto) → List<PublicMessageDto>
-   - GetByIdAsync(long) → PublicMessageDetailsDto
-   - CreateAsync(CreatePublicMessageDto) → long (MessageId)
-   - UpdateAsync(long, UpdatePublicMessageDto) → Task
-   - DeleteAsync(long) → Task
-   - PublishAsync(long) → Task
-   - ArchiveAsync(long) → Task
-```
-
-### Proto Files موجود
-```
-✅ BackOffice.BFF/Protobufs/DiscountProduct.proto
-✅ BackOffice.BFF/Protobufs/DiscountCategory.proto
-✅ BackOffice.BFF/Protobufs/DiscountOrder.proto
-✅ BackOffice.BFF/Protobufs/DiscountShoppingCart.proto
-✅ BackOffice.BFF/Protobufs/PublicMessage.proto
-```
-
-### gRPC Clients موجود و ثبت شده
-```
-✅ DiscountProductsContractClient (registered in DI)
-✅ DiscountCategoriesContractClient (registered in DI)
-✅ DiscountOrdersContractClient (registered in DI)
-✅ DiscountShoppingCartsContractClient (registered in DI)
-✅ PublicMessagesContractClient (registered in DI)
-```
-
-### Known Issues
-```
-⚠️ Proto Field Errors در DiscountOrder/DiscountShoppingCart:
-   - 38 compile errors مربوط به field naming mismatches
-   - مثال: ShippingAddress, OrderItemDto.Id, DiscountPercent
-   - این خطاها عملکرد Product/Category را تحت تأثیر قرار نمی‌دهند
-   - نیاز به sync کردن Proto schemas با CMS
-```
-
---
-
-**آخرین به‌روزرسانی**: 4 دسامبر 2024  
-**نسخه گزارش**: 3.0 (Final)  
-**وضعیت کلی**: 🟢 95% آماده - **Ready for Production**
-
---
-
-## 🎉 دستاوردهای کل پروژه (3 فاز کامل)
-
-### فاز 1: Backend Services ✅
-1. ✅ **8 فایل Service** پیاده‌سازی شد (4 Interface + 4 Implementation)
-2. ✅ **4 gRPC Client** به DI اضافه شد
-3. ✅ **ConfigureService.cs** آپدیت شد
-4. ✅ **فیلترینگ پیشرفته** با DTOs
-
-### فاز 2: Dialog Components ✅
-5. ✅ **6 Dialog Component** ساخته شد
-6. ✅ **ProductFormDialog**: Create/Edit با validation کامل
-7. ✅ **CategoryFormDialog**: Parent selection + Tree support
-8. ✅ **OrderDetailsDialog**: نمایش کامل جزئیات
-9. ✅ **ChangeOrderStatusDialog**: 7 وضعیت با UI feedback
-10. ✅ **MessageFormDialog**: 4 نوع پیام + تمام فیلدها
-11. ✅ **MessageViewDialog**: نمایش زیبا با آیکون‌ها
-
-### فاز 3: Integration ✅
-12. ✅ **4 صفحه UI** به Services و Dialogs متصل شدند
-13. ✅ عملیات **CRUD کامل**: Create, Read, Update, Delete
-14. ✅ **Error Handling** و **User Feedback** با Snackbar
-15. ✅ **Validation** در تمام فرم‌ها
-16. ✅ **Loading States** و **Progress Indicators**
-
-## 📊 آمار کلی پروژه
-
-```
-✅ تعداد فایل ایجاد شده: 14 فایل
-   ├─ 4 Service Interface
-   ├─ 4 Service Implementation
-   ├─ 6 Dialog Components
-   └─ ConfigureService.cs (Updated)
-
-✅ تعداد صفحه به‌روز شده: 4 صفحه
-   ├─ DiscountProductsMainPage.razor
-   ├─ DiscountCategoriesMainPage.razor
-   ├─ DiscountOrdersMainPage.razor
-   └─ PublicMessagesMainPage.razor
-
-✅ عملیات CRUD پیاده‌سازی شده: 16 operation
-   ├─ Products: List, Create, Read, Update, Delete (5)
-   ├─ Categories: List, Create, Read, Update, Delete (5)
-   ├─ Orders: List, Read, UpdateStatus (3)
-   └─ Messages: List, Create, Read, Update, Delete, Publish, Archive (7)
-
-✅ تعداد خط کد تخمینی: ~2500 خط
-```
-
-**نتیجه نهایی**: سیستم مدیریت کامل BackOffice با 95% پیشرفت آماده برای Production 🚀
-
---
-
-## 🚀 مراحل بعدی (اختیاری)
-
-1. **Testing**: تست عملکرد با داده‌های واقعی از CMS
-2. **UI/UX Polish**: بهبودهای ظاهری و تجربه کاربری
-3. **Reports**: گزارش‌های پیشرفته (optional)
-4. **Performance**: Optimization و Caching
-5. **Documentation**: مستندسازی API برای توسعه‌دهندگان
-
---
-
-## 🎉 دستاوردهای کل پروژه (3 فاز)
-
-### فاز 1: Backend Services ✅
-1. ✅ **8 فایل Service** پیاده‌سازی شد (4 Interface + 4 Implementation)
-2. ✅ **4 gRPC Client** به DI اضافه شد
-3. ✅ **ConfigureService.cs** آپدیت شد
-4. ✅ **فیلترینگ پیشرفته** با DTOs
-
-### فاز 2: Dialog Components ✅
-5. ✅ **6 Dialog Component** ساخته شد
-6. ✅ **ProductFormDialog**: Create/Edit با validation کامل
-7. ✅ **CategoryFormDialog**: Parent selection + Tree support
-8. ✅ **OrderDetailsDialog**: نمایش کامل جزئیات
-9. ✅ **ChangeOrderStatusDialog**: 7 وضعیت با UI feedback
-10. ✅ **MessageFormDialog**: 4 نوع پیام + تمام فیلدها
-11. ✅ **MessageViewDialog**: نمایش زیبا با آیکون‌ها
-
-### فاز 3: Integration ✅
-12. ✅ **4 صفحه UI** به Services و Dialogs متصل شدند
-13. ✅ عملیات **CRUD کامل**: Create, Read, Update, Delete
-14. ✅ **Error Handling** و **User Feedback** با Snackbar
-15. ✅ **Validation** در تمام فرم‌ها
-16. ✅ **Loading States** و **Progress Indicators**
-
-## 📊 آمار کلی پروژه
-
-```
-✅ تعداد فایل ایجاد شده: 14 فایل
-   ├─ 4 Service Interface
-   ├─ 4 Service Implementation
-   ├─ 6 Dialog Components
-   └─ ConfigureService.cs (Updated)
-
-✅ تعداد صفحه به‌روز شده: 4 صفحه
-   ├─ DiscountProductsMainPage.razor
-   ├─ DiscountCategoriesMainPage.razor
-   ├─ DiscountOrdersMainPage.razor
-   └─ PublicMessagesMainPage.razor
-
-✅ عملیات CRUD پیاده‌سازی شده: 16 operation
-   ├─ Products: List, Create, Read, Update, Delete (5)
-   ├─ Categories: List, Create, Read, Update, Delete (5)
-   ├─ Orders: List, Read, UpdateStatus (3)
-   └─ Messages: List, Create, Read, Update, Delete, Publish, Archive (7)
-
-✅ تعداد خط کد تخمینی: ~2500 خط
-```
-
-**نتیجه نهایی**: سیستم مدیریت کامل BackOffice با 95% پیشرفت آماده برای Production 🚀
-
-**وضعیت کلی**: 🟡 در حال تکمیل (70%)
@@ -1,505 +0,0 @@
-# 🌐 FrontOffice - پرتال مشتری
-
-> **FrontOffice**: رابط کاربری Blazor Server برای مشتریان نهایی سیستم FourSat
-> 
-> **آخرین بروزرسانی**: ۲۸ آذر ۱۴۰۴ (18 دسامبر 2025)
-
---
-
-## 🆕 تغییرات اخیر (۲۸ آذر ۱۴۰۴)
-
-### ✅ نمودار درختی شبکه با d3-org-chart
- **کتابخانه**: d3-org-chart v3 + d3.js v7 + d3-flextree
- **OrganizationChart.razor**: بازنویسی کامل با JS Interop
- **امکانات**:
-  - نمایش درختی باینری شبکه
-  - دکمه‌های: باز کردن همه، بستن همه، مرکز، نمایش کامل، بروزرسانی
-  - انتخاب عمق درخت (2-10 سطح)
-  - کلیک روی نود برای دیدن زیرمجموعه‌ها
-  - دکمه‌های بازگشت و "درخت من"
-  - طراحی ریسپانسیو با MudBlazor
-
-### ✅ API جدید: GetSubordinateTree
- **Proto**: `GetSubordinateTreeRequest` با `target_user_id`
- **BFF Handler**: `GetSubordinateTreeQueryHandler`
- **Frontend Service**: `GetSubordinateTreeAsync(targetUserId, maxDepth)`
- **امنیت**: Authentication با JWT (بدون بار اضافی چک زیرمجموعه)
-
-### ✅ فایل‌های جدید/آپدیت شده:
- `wwwroot/js/org-chart.js` - JS Interop برای d3-org-chart
- `wwwroot/css/org-chart.css` - استایل‌های سفارشی نمودار
- `Pages/Profile/Components/OrganizationChart.razor` - کامپوننت نمودار
- `Pages/Profile/Components/OrganizationChart.razor.cs` - لاجیک کامپوننت
- `Utilities/NetworkMembershipService.cs` - متد جدید GetSubordinateTreeAsync
-
---
-
-## 📊 وضعیت پروژه
-
-| بخش | وضعیت | درصد تکمیل | فایل‌ها |
-|-----|-------|------------|---------|
-| **UI Pages** | ✅ Build موفق | 85% | 24 صفحه |
-| **BFF Handlers** | ✅ اصلاح شده | 80% | 14 Handler |
-| **Protobuf Packages** | ✅ کامل | 90% | 5 Package |
-| **Services** | ✅ اتصال واقعی | 80% | 8 Service |
-| **gRPC Connection** | ✅ فعال | 90% | - |
-
-**🎉 آخرین موفقیت**: نمودار درختی d3-org-chart با کلیک روی نودها (۲۸ آذر)
-
---
-
-## 🗂️ ساختار پروژه
-
-```
-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): نمایش درخت دودویی
-  - **d3-org-chart v3**: کتابخانه حرفه‌ای نمودار سازمانی
-  - **JS Interop**: ارتباط Blazor با JavaScript
-  - **امکانات**:
-    - نمایش درختی با zoom و pan
-    - کلیک روی نود → نمایش زیرمجموعه‌ها
-    - دکمه‌های عملیاتی (باز کردن، بستن، مرکز، نمایش کامل)
-    - انتخاب عمق (2-10 سطح)
-    - دکمه‌های بازگشت و "درخت من"
-    - طراحی ریسپانسیو
-  - **متصل به**: `NetworkMembershipService.GetMyNetworkTreeAsync` و `GetSubordinateTreeAsync`
-  
- ✅ **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
-   - `GetSubordinateTreeAsync(targetUserId, maxDepth)`: درخت زیرمجموعه **جدید**
-   - `GetMyNetworkStatisticsAsync()`: آمار کلی شبکه
-   - **✅ متصل به BFF**: gRPC واقعی
-   
-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 (3 Handler) ✅ **کامل شده**
- ✅ **GetMyNetworkTree** (Query)
-  - Tree Builder پیاده‌سازی شده
-  - تبدیل Flat List از CMS به Tree Structure
-  
- ✅ **GetMyNetworkStatistics** (Query)
-  - آمار کامل شبکه
-  
- ✅ **GetSubordinateTree** (Query) **جدید**
-  - دریافت درخت یک زیرمجموعه
-  - امنیت: فقط با JWT معتبر
-
-#### 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)
@@ -1,981 +0,0 @@
-<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>
@@ -1,210 +0,0 @@
-<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>
@@ -1,407 +0,0 @@
-# 🔴 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)
@@ -1,547 +0,0 @@
-# 🎯 اسپرینت جاری (Current Sprint)
-
-**تاریخ شروع**: ۱۴ آذر ۱۴۰۴  
-**آخرین بروزرسانی**: ۲۸ آذر ۱۴۰۴  
-**مدت**: 2 هفته  
-**هدف**: تکمیل BackOffice UI و رفع Anti-Patterns معماری
-
---
-
-## 🔧 تغییرات اخیر (۲۸ آذر) - Session 2
-
-### ✅ سیستم مدیریت موجودی محصولات
-**CMS Handler**: چک موجودی در `SubmitShopBuyOrderCommandHandler`
- چک موجودی قبل از تأیید سفارش
- کاهش `RemainingCount` و افزایش `SaleCount` بعد از پرداخت
- پیام خطای فارسی با جزئیات محصول و تعداد
-
-**FrontOffice ProductDetail**:
- `MaxQty` داینامیک بر اساس موجودی واقعی
- نمایش Chip موجودی (سبز/قرمز) با تعداد
- غیرفعال کردن دکمه افزودن وقتی ناموجود
-
-### ✅ ویژگی‌های باشگاه (ClubFeatures) - اصلاح معماری
-**حذف فیلدها از UserClubFeature**:
- `DetailedDescriptionHtml`, `Icon`, `Color` فقط در `ClubFeature` (جدول قالب)
- `UserClubFeature` فقط: `IsActive`, `GrantedAt`, `Notes`
-
-**فایل‌های اصلاح‌شده**:
- CMS: `UserClubFeatureDto`, `clubmembership.proto`, `ClubFeatureProfile`
- BFF: `GetClubFeaturesQueryHandler`, `GetClubFeaturesResponseDto`, `configuration.proto`, `ConfigurationProfile`
- FrontOffice: `ClubConfigurationService`, `FeaturesPage`
-
-**MembershipPage - مزایای عضویت**:
-1. شارژ ۵۶ میلیون تومان کیف پول فروشگاه تخفیفی
-2. عضویت در شبکه بازاریابی و دریافت پورسانت
-3. امکان جذب زیرمجموعه
-
-### ✅ رفع باگ مدال آدرس‌ها
- **Snackbar تکراری**: حذف inject از code-behind (global در `_Imports.razor`)
- **NullReferenceException**: null check برای `dialog.Result`
-
-### ✅ VAT و Cart Services
- **VATService**: نرخ پیش‌فرض 9.99% برای debug
- **CartService**: `EnsureInitializedAsync` + `IsAuthenticatedAsync` برای لود فقط برای کاربران لاگین‌شده
-
---
-
-## 🔧 تغییرات قبلی (۲۸ آذر) - Session 1
-
-### ✅ نمودار درختی شبکه در FrontOffice با d3-org-chart
-**کتابخانه‌ها**: d3-org-chart v3 + d3.js v7 + d3-flextree v2.1.2
-**ویژگی‌ها**:
- نمایش درختی باینری شبکه
- کلیک روی نود → نمایش درخت زیرمجموعه
- دکمه بازگشت به نود قبلی
- دکمه "درخت من" برای بازگشت به درخت کاربر
- انتخاب عمق درخت با MudSelect (2-10 سطح)
- FitToScreen برای تناسب با صفحه
- Responsive با MudBlazor components
-
-### ✅ API جدید GetSubordinateTree
-**Proto**: `GetSubordinateTreeRequest` با `target_user_id` و `max_depth`
-**BFF Handler**: `GetSubordinateTreeQueryHandler.cs`
-**Frontend Service**: `GetSubordinateTreeAsync(targetUserId, maxDepth)`
-**امنیت**: JWT Authentication (بدون check سنگین subordinate)
-
-### ✅ رفع مشکل Encoding فارسی در Geography
-**Entity های تغییر یافته**: Country, State, City
-**تغییرات Configuration**: `NVARCHAR` با `Persian_100_CI_AI` collation
-**Migration**: `FixPersianCollation_Geography`
-
---
-
-## 🔧 تغییرات قبلی (۱۷ آذر)
-
-### ✅ رفع Anti-Pattern معماری در BackOffice.BFF
-**مشکل**: BackOffice.BFF.WebApi از پکیج‌های Protobuf مربوط به CMS استفاده می‌کرد
-**راه‌حل**: 
- ساخت Protobuf های اختصاصی BackOffice.BFF (ClubMembership, Commission, Configuration, NetworkMembership)
- تغییر namespace از `CMSMicroservice` به `Foursat.BackOffice.BFF.*`
- تغییر GrpcServices از "Client" به "Both" (برای پشتیبانی هم از Server و هم Client)
- نسخه‌های منتشر شده: 0.0.6 (ClubMembership, Commission, NetworkMembership), 1.0.6 (Configuration)
-
-### ✅ اضافه شدن HTTP Annotations به Protobuf
- افزودن `google/api/annotations.proto` به 4 پروژه Protobuf
- پیاده‌سازی HTTP endpoints برای Swagger: 33 endpoint
-  - ClubMembership: 7 endpoints
-  - Commission: 14 endpoints
-  - Configuration: 5 endpoints
-  - NetworkMembership: 7 endpoints
- نصب `Google.Api.CommonProtos v2.10.0`
-
-### ✅ رفع مشکل Mapster با Immutable Types
- ساخت `NetworkMembershipProfile.cs` با استفاده از `MapWith()`
- مپینگ دستی برای `RepeatedField` و `Timestamp`
- رفع خطای "Cannot convert immutable type"
-
-### ✅ پشتیبانی از Multi-Role Authorization
- تغییر `AuthorizationService` برای خواندن چندین رول از JWT
- اضافه شدن متد `GetUserRolesAsync()` 
- استفاده از `user.FindAll(ClaimTypes.Role)` بجای `FindFirst`
- پشتیبانی از رول‌های آرایه‌ای در `ApiAuthenticationStateProvider`
-
-### ✅ نمایش درختی شبکه (Network Tree Visualization)
- پیاده‌سازی درخت تعاملی با D3.js v7
- ویژگی‌های درخت:
-  - Zoom & Pan با mouse/touch
-  - دکمه Reset برای بازگشت به حالت اولیه
-  - رنگ‌بندی: سبز (فعال), قرمز (غیرفعال), سبز (چپ), نارنجی (راست)
-  - کلیک روی node برای بارگذاری درخت آن کاربر
-  - Responsive با viewBox و preserveAspectRatio
- اضافه شدن `UserAutoComplete` برای جستجوی کاربر
-  - جستجوی همزمان در Mobile, FirstName, LastName, NationalCode
-  - نمایش نام + موبایل در لیست
-
-### ✅ رفع مشکلات UI
- رفع NullReferenceException در `NetworkTreeViewer` (JoinedAt null check)
- رفع timing issue در render درخت (StateHasChanged + Task.Delay)
- رفع خطای JSInterop با استفاده از `setDotNetReference`
-
---
-
-## ⚠️ یادآوری مهم: Proto Package Workflow
-
-**قبل از هر کاری این را بخوانید!**
-
-### قانون اجباری برای تغییر Proto (ALL Services):
-
-```
-┌─────────────────────────────────────────┐
-│  تغییر Proto File                       │
-│         ↓                                │
-│  افزایش Version در csproj              │
-│         ↓                                │
-│  dotnet pack -c Release                 │
-│         ↓                                │
-│  Update Version در لایه بالاتر          │
-└─────────────────────────────────────────┘
-```
-
-**این برای همه سرویس‌ها اجباری است:**
- ✅ CMS Proto changes → Update BFF
- ✅ BackOffice.BFF Proto changes → Update BackOffice UI
- ✅ FrontOffice.BFF Proto changes → Update FrontOffice UI
-
-**عدم رعایت = ساعت‌ها Debug و سردرگمی بیهوده!**
-
-GitLab Registry: `https://git.afrino.co/api/packages/FourSat/nuget/index.json`
-
---
-
-## 📋 وضعیت کلی پروژه
-
-### Backend:
- ✅ **CMS Microservice**: ~98% Complete
-  - ✅ **Daya Loan Integration**: 100% Complete (Real API implemented - Dec 6, 2025)
- ✅ **BackOffice.BFF**: 100% Complete (35+ Handlers)
-  - ✅ **Architecture Fixed**: Anti-pattern با CMS Protobuf رفع شد
-  - ✅ **HTTP Annotations**: 33 endpoint با Swagger support
-  - ✅ **Mapster Profiles**: NetworkMembership, Products با MapWith()
- ✅ **FrontOffice.BFF**: 98% Complete (همه سرویس‌های مورد نیاز مشتری پیاده‌سازی شده)
-
-### Frontend:
- ✅ **BackOffice UI**: ~97% Complete (65+ صفحه)
-  - ✅ **Multi-Role Authorization**: پشتیبانی از چندین نقش همزمان
-  - ✅ **Network Tree Visualization**: نمایش درختی تعاملی با D3.js
-  - ✅ **User AutoComplete**: جستجوی پیشرفته کاربران
- ✅ **FrontOffice UI**: **98% Complete** (تمام صفحات مورد نیاز مشتری پیاده‌سازی شده)
-
---
-
-## 🎉 جمع‌بندی نهایی FrontOffice (سمت مشتری)
-
-### ✅ صفحات پیاده‌سازی شده و متصل به API:
-
-#### 🔐 احراز هویت:
-| صفحه | Route | وضعیت |
-|------|-------|-------|
-| ثبت‌نام (OTP) | `/register` | ✅ متصل به gRPC |
-| ورود (OTP) | Dialog | ✅ متصل به gRPC |
-| تایید قرارداد | `/register` Step 3 | ✅ متصل به gRPC |
-
-#### 👤 پروفایل:
-| صفحه | Route | وضعیت |
-|------|-------|-------|
-| داشبورد پروفایل | `/profile` | ✅ متصل به gRPC |
-| ویرایش اطلاعات شخصی | `/profile/personal` | ✅ متصل به gRPC |
-| مدیریت آدرس‌ها | `/profile/addresses` | ✅ متصل به gRPC |
-| تنظیمات | `/profile/settings` | ✅ متصل به gRPC |
-| کیف پول | `/profile/wallet` | ✅ متصل به gRPC |
-| درخت شبکه | `/profile/tree` | ✅ متصل به gRPC |
-
-#### 🛒 فروشگاه:
-| صفحه | Route | وضعیت |
-|------|-------|-------|
-| لیست محصولات | `/products` | ✅ متصل به gRPC |
-| جزئیات محصول | `/products/{id}` | ✅ متصل به gRPC |
-| دسته‌بندی‌ها | `/categories` | ✅ متصل به gRPC |
-| سبد خرید | `/cart` | ✅ متصل به gRPC |
-| تایید خرید (VAT) | `/checkout` | ✅ متصل به gRPC |
-
-#### 📦 سفارشات:
-| صفحه | Route | وضعیت |
-|------|-------|-------|
-| لیست سفارشات | `/orders` | ✅ متصل به gRPC |
-| جزئیات سفارش (VAT) | `/orders/{id}` | ✅ متصل به gRPC |
-| پیگیری سفارش | `/order-tracking/{id}` | ✅ متصل به gRPC |
-
-#### 💰 کمیسیون:
-| صفحه | Route | وضعیت |
-|------|-------|-------|
-| داشبورد کمیسیون | `/commission` | ✅ متصل به gRPC |
-| تاریخچه پرداخت‌ها | `/commission/history` | ✅ متصل به gRPC |
-| تعادل هفتگی | `/commission/weekly-balance` | ✅ متصل به gRPC |
-
-#### 🌐 شبکه:
-| صفحه | Route | وضعیت |
-|------|-------|-------|
-| آمار شبکه | `/network/statistics` | ✅ متصل به gRPC |
-| درخت شبکه | `/profile/tree` | ✅ متصل به gRPC |
-
-#### 🏆 باشگاه:
-| صفحه | Route | وضعیت |
-|------|-------|-------|
-| عضویت باشگاه | `/club/membership` | ✅ متصل به gRPC |
-| امکانات باشگاه | `/club/features` | ✅ Static |
-
-#### 📦 پکیج‌ها:
-| صفحه | Route | وضعیت |
-|------|-------|-------|
-| لیست پکیج‌ها | `/packages` | ✅ متصل به gRPC |
-| پکیج‌های من | `/my-packages` | ✅ متصل به gRPC |
-| جزئیات پکیج | `/packages/{id}` | ✅ متصل به gRPC |
-
-#### 📄 سایر صفحات:
-| صفحه | Route | وضعیت |
-|------|-------|-------|
-| صفحه اصلی | `/` | ✅ Complete |
-| درباره ما | `/about` | ✅ Static |
-| سوالات متداول | `/faq` | ✅ Static |
-| تماس با ما | `/contact` | ⚠️ UI آماده، Mock |
-
---
-
-### ⚠️ موارد Mock (نیاز به CMS):
-
-| قابلیت | وضعیت UI | نیاز CMS |
-|--------|----------|----------|
-| **فرم تماس با ما** | ✅ UI کامل | Entity `ContactMessage` |
-| **نظرات محصول** | ❌ | Entity `Review` |
-| **کد تخفیف** | ❌ | RPC `ValidateDiscountCode` |
-
---
-
-### ❌ موارد حذف شده (نیاز نیست):
-
-| قابلیت | دلیل |
-|--------|------|
-| `ChangePassword` | سیستم فقط OTP دارد، رمز عبور نداریم |
-| `ForgotPassword` | سیستم فقط OTP دارد |
-
-> **نکته**: صفحه `ChangePassword.razor` ساخته شده ولی فعلاً کاربردی ندارد چون لاگین فقط با OTP است.
-
---
-
-## 📊 مقایسه CMS vs FrontOffice.BFF
-
-### سرویس‌های CMS که در FrontOffice.BFF پیاده‌سازی شده:
-
-| CMS Service | FrontOffice.BFF | وضعیت |
-|-------------|-----------------|-------|
-| UserService | ✅ UserService | کامل |
-| OtpTokenService | ✅ (در UserService) | کامل |
-| UserAddressService | ✅ UserAddressService | کامل |
-| ProductsService | ✅ ProductsService | کامل |
-| CategoryService | ✅ CategoriesService | کامل |
-| UserCartsService | ✅ ShopingCartService | کامل |
-| UserOrderService | ✅ UserOrderService | کامل |
-| UserWalletService | ✅ UserWalletService | کامل |
-| TransactionsService | ✅ TransactionService | کامل |
-| CommissionService | ✅ CommissionService | کامل |
-| ClubMembershipService | ✅ ClubMembershipService | کامل |
-| NetworkMembershipService | ✅ NetworkMembershipService | کامل |
-| PackageService | ✅ PackageService | کامل |
-| DiscountShopServices | ✅ DiscountShopService | کامل |
-| UserContractService | ✅ (در UserService - AcceptContract) | کامل |
-
-### سرویس‌های CMS که فقط برای Admin هستند (نیاز مشتری نیست):
-
-| CMS Service | توضیح |
-|-------------|-------|
-| ConfigurationService | تنظیمات سیستم (Admin) |
-| ContractService | مدیریت قراردادها (Admin) |
-| ManualPaymentService | پرداخت دستی (Admin) |
-| RoleService | مدیریت نقش‌ها (Admin) |
-| UserRoleService | اختصاص نقش (Admin) |
-| TagService | مدیریت تگ‌ها (Admin) |
-| ProductTagService | اختصاص تگ به محصول (Admin) |
-| PublicMessageService | پیام‌های عمومی (Admin) |
-| ProductImagesService | مدیریت تصاویر (Admin) |
-| ProductGalleriesService | گالری محصول (Admin) |
-| ProductCategoryService | دسته‌بندی محصول (Admin) |
-| FactorDetailsService | جزئیات فاکتور (Admin) |
-| UserWalletChangeLogService | لاگ تغییرات کیف پول (Admin) |
-
---
-
-### 2. ✅ Package Purchase System - UI Implementation
-**Status**: ✅ تکمیل شد  
-**Owner**: FrontOffice Team  
-**تاریخ تکمیل**: ۱۵ آذر ۱۴۰۴
-
-#### CMS Status:
- ✅ Entities (5) - `PackagePurchase`, `PackagePurchaseItem`, etc.
- ✅ Commands (6) - `CreatePackagePurchaseCommand`, etc.
- ✅ Queries (3) - `GetPackagePurchaseByIdQuery`, etc.
- ✅ Protobuf (4 RPCs) - 264 lines
-
-#### تغییرات انجام شده:
- ✅ **PackageService.cs**: سرویس gRPC برای دریافت پکیج‌ها
- ✅ **RouteConstants.cs**: اضافه شدن مسیرهای `/packages` و `/my-packages`
- ✅ **ConfigureServices.cs**: ثبت `PackageService` در DI
- ✅ **Packages.razor**: صفحه لیست پکیج‌ها با Grid View، جستجو، و Loading States
- ✅ **MyPackages.razor**: صفحه پکیج‌های کاربر با نمایش وضعیت خرید
-
-**Build Status**: ✅ FrontOffice Build Succeeded - 0 Errors
-
-**Reference**: `01-BUSINESS/package-purchase-system.md`
-
---
-
-### 3. ✅ اصلاح محاسبه کمیسیون هفتگی (بحرانی)
-**Status**: ✅ تکمیل شد  
-**Owner**: CMS Team  
-**تاریخ شروع**: ۱۴ آذر ۱۴۰۴  
-**تاریخ تکمیل**: ۱۴ آذر ۱۴۰۴
-
-#### شرح مشکلات رفع شده:
-
-| # | مشکل | وضعیت |
-|---|------|-------|
-| 1 | محدودیت لول (15) پیاده‌سازی نشده | ✅ Fixed |
-| 2 | فقط تعادل شخصی حساب می‌شود (نه زیرمجموعه) | ✅ Fixed |
-
-#### فرمول پیاده‌سازی شده:
-```
-کمیسیون = (تعادل_شخص + SUM(تعادل_زیرمجموعه تا 15 لول)) × ارزش_هر_تعادل
-```
-
-#### تسک‌های تکمیل شده:
-
-| فاز | شرح | وضعیت |
-|-----|------|-------|
-| 1 | اضافه کردن `Commission.MaxNetworkLevel` به Config | ✅ |
-| 2 | اصلاح `CalculateWeeklyBalancesCommandHandler` - محدودیت لول | ✅ |
-| 3 | اصلاح `ProcessUserPayoutsCommandHandler` - تعادل زیرمجموعه | ✅ |
-| 4 | تست و Build | ✅ (0 Errors) |
-
-#### تغییرات انجام شده:
- **Config**: اضافه کردن `Commission.MaxNetworkLevel = 15`
- **CalculateWeeklyBalances**: پارامتر `maxLevel` به متدهای بازگشتی اضافه شد
- **ProcessUserPayouts**: متد `SumSubordinateBalancesAsync` برای جمع تعادل زیرمجموعه‌ها تا 15 لول
-
-**Reference**: `01-BUSINESS/commission-calculation-fix.md`
-
---
-
-### 4. ✅ اصلاح سقف تعادل هفتگی (MaxWeeklyBalances)
-**Status**: ✅ تکمیل شد  
-**Owner**: CMS Team  
-**تاریخ تکمیل**: ۱۴ آذر ۱۴۰۴
-
-#### شرح مشکل:
-سقف تعادل هفتگی در پیاده‌سازی فعلی **300 کل** بود، اما باید **300 برای هر دست** باشد.
-
-| توضیح | منطق قدیم | منطق جدید |
-|-------|-----------|-----------|
-| سقف | 300 کل | 300 هر دست |
-| Max Total | 300 | 300+300=600 |
-
-#### تغییرات انجام شده:
-
-**CMS Changes:**
- ✅ **SystemConfiguration**: تغییر کلید از `MaxWeeklyBalancesPerUser` به `MaxWeeklyBalancesPerLeg`
- ✅ **CalculateWeeklyBalancesCommandHandler**: اصلاح منطق محاسبه سقف
-  - اعمال سقف روی هر دست جداگانه قبل از محاسبه MIN
-  - باقیمانده = مازاد سقف هر دست (نه نصف تعادل کل)
- ✅ **ApplicationDbContextInitialiser**: اصلاح Seed Data
-
-**منطق جدید:**
-```csharp
-// ✅ سقف روی هر دست جداگانه
-var cappedLeftTotal = Math.Min(leftTotal, maxBalancesPerLeg);
-var cappedRightTotal = Math.Min(rightTotal, maxBalancesPerLeg);
-var totalBalances = Math.Min(cappedLeftTotal, cappedRightTotal);
-var leftRemainder = leftTotal - cappedLeftTotal;  // مازاد سقف
-var rightRemainder = rightTotal - cappedRightTotal;
-```
-
-**Build Status**: ✅ CMS Build Succeeded - 0 Errors
-
-**مستندات:**
- ✅ `01-BUSINESS/balance-calculation-rules.md` - آپدیت شد
-
---
-
-## 🟢 Low Priority (هفته بعد)
-
-### 5. ✅ VAT System Implementation
-**Status**: ✅ تکمیل شد  
-**Owner**: CMS + BFF + FrontOffice UI  
-**تاریخ تکمیل**: ۱۵ آذر ۱۴۰۴
-
-#### تغییرات انجام شده:
-
-**CMS:**
- ✅ **OrderVAT Entity**: قبلاً موجود بود
- ✅ **GetUserOrderResponseDto**: اضافه شدن `VatInfo` با فیلدهای `VatRate`, `BaseAmount`, `VatAmount`, `TotalAmount`, `IsPaid`
- ✅ **GetUserOrderQueryHandler**: اضافه شدن `.Include(i => i.OrderVAT)` و mapping VAT
- ✅ **CMS Proto**: اضافه شدن `OrderVATInfo` message
-
-**FrontOffice.BFF:**
- ✅ **Proto**: اضافه شدن `OrderVATInfo` و `vat_info` field
- ✅ **GetUserOrderResponseDto**: اضافه شدن `OrderVATInfoDto`
-
-**FrontOffice UI:**
- ✅ **CheckoutSummary.razor**: نمایش جزئیات مالی شامل:
-  - جمع کالاها
-  - مالیات بر ارزش افزوده (۹%)
-  - مبلغ قابل پرداخت
- ✅ **OrderDetail.razor**: نمایش جزئیات مالی مشابه
-
-**Build Status**: ✅ All Projects - 0 Errors
-
---
-
-### 6. Manual Payment System
-**Status**: 🟡 In Progress (CMS + BackOffice.BFF)  
-**Owner**: CMS + BackOffice.BFF  
-**Estimate**: 2 روز (UI باقیمانده)
-
-#### وضعیت فعلی:
- ✅ CMS Domain & Application: ManualPayment + CreateManualPayment/ApproveManualPayment/RejectManualPayment + GetAllManualPayments
- ✅ CMS gRPC: ManualPaymentContract (Create/Approve/Reject/GetAllManualPayments)
- ✅ BackOffice.BFF: 4 Handler (CreateManualPayment, ApproveManualPayment, RejectManualPayment, GetManualPayments)
- ⏳ BackOffice UI: صفحه لیست Manual Payments + Dialog جزئیات/Approve/Reject
- ⏳ FrontOffice Flow (CreateManualPaymentRequest از سمت کاربر)
-
---
-
-### 7. RBAC System Implementation
-**Status**: 🟡 In Progress (BackOffice.BFF Permission Layer پیاده‌سازی شده؛ CMS + BackOffice UI باقی مانده)  
-**Owner**: CMS + BFF Teams  
-**Estimate**: 1.5 هفته
-
-#### Requirements:
- تعریف Roles و Permissions (CMS Domain/Application)
- Policy-based Authorization (CMS + BackOffice UI)
- Admin Panel برای مدیریت دسترسی‌ها
- ✅ BackOffice.BFF: IPermissionService + CheckUserPermissionHandler / GetUserRolesHandler + gRPC PermissionInterceptor
-
---
-
-## ⚠️ Blockers & Dependencies
-
-### 🟢 Resolved:
-1. ~~**Protobuf Mismatch** (FrontOffice.BFF ↔ CMS)~~ ✅ Fixed
-2. ~~**WalletService Mock Data**~~ ✅ Connected to gRPC
-3. ~~**Tree Builder Missing** (NetworkMembership)~~ ✅ Implemented
-
-### 🟡 Minor Issues:
-1. **MudBlazor Warnings** - ~100 warnings (غیر critical)
-2. **Missing CMS Entities** - Review, ContactMessage, DiscountValidation
-
---
-
-## 📊 Progress Summary
-
-### ✅ وضعیت نهایی FrontOffice (سمت مشتری):
-
-**FrontOffice UI: 98% Complete** 🎉
-
- ✅ **28+ صفحه** پیاده‌سازی شده
- ✅ **همه سرویس‌ها** به gRPC متصل
- ✅ **Build موفق** بدون Error
- ⚠️ فقط **فرم تماس با ما** Mock است (نیاز به CMS entity)
-
-### کارهای تمام شده این اسپرینت (۱۴-۱۵ آذر):
-
-**روز اول (۱۴ آذر):**
- ✅ FrontOffice Proto Projects: 5 پروژه جدید
- ✅ FrontOffice UI Services: 4 سرویس به gRPC وصل شدند
- ✅ FrontOffice.BFF Handlers: 15+ handler
- ✅ Commission Calculation Fix
- ✅ Balance Cap Fix: 300 per leg
-
-**روز دوم (۱۵ آذر):**
- ✅ Package Purchase UI: Packages.razor + MyPackages.razor
- ✅ VAT System: CheckoutSummary + OrderDetail
- ✅ OrderTracking: Timeline پیگیری سفارش
- ✅ ChangePassword: UI آماده (برای آینده)
- ✅ Documentation: جمع‌بندی نهایی
-
---
-
-## 🗂️ Backlog (کارهای آینده)
-
-### Low Priority - FrontOffice:
-
-| تسک | توضیحات | اولویت |
-|-----|---------|--------|
-| **Password Authentication** | اضافه کردن لاگین با رمز عبور علاوه بر OTP | 🟡 Low |
-| **ForgotPassword** | بازیابی رمز عبور (نیاز به CMS RPC) | 🟡 Low |
-| **Contact Form Backend** | اتصال فرم تماس به CMS | 🟡 Low |
-| **Product Reviews** | سیستم نظرات محصول | 🟡 Low |
-| **Discount Code** | اعتبارسنجی کد تخفیف | 🟡 Low |
-
-### High Priority - BackOffice (Admin):
-
-| تسک | توضیحات | اولویت |
-|-----|---------|--------|
-| **Manual Payment UI** | صفحه مدیریت پرداخت‌های دستی | 🔴 High |
-| **RBAC System** | سیستم کنترل دسترسی | 🔴 High |
-
---
-
-## 🎯 Definition of Done
-
-### برای هر Task:
- [x] Code Review Complete
- [x] Build با 0 error
- [x] Manual Testing انجام شده
- [x] Documentation بروز شده
-
---
-
-## 📝 نتیجه‌گیری نهایی
-
-### سمت مشتری (FrontOffice):
-✅ **آماده Production** - تمام قابلیت‌های اصلی پیاده‌سازی شده
-
-### سمت ادمین (BackOffice):
-🟡 **95% Complete** - Manual Payment و RBAC باقیمانده
-
---
-
-**آخرین بروزرسانی**: ۱۵ آذر ۱۴۰۴ 🚀
@@ -1,617 +0,0 @@
-# 📋 Task List - توضیحات جدید بیزینس 2025-12-08
-
-**تاریخ ایجاد**: 2025-12-08  
-**آخرین به‌روزرسانی**: 2025-12-09  
-**منبع**: تحلیل توضیحات شفاهی جدید بیزینس  
-**وضعیت**: ✅ Task #0 Complete, بقیه آماده برای اجرا
-
---
-
-## ✅ Completed Tasks
-
-### ~~Task #0: اصلاح محاسبات تعادل و فلش~~ ✅
-
-**شرح**:
-کد محاسبه تعادل با توضیحات دقیق بیزینس تطبیق داده شد.
-
-**انجام شده**:
- ✅ ترتیب محاسبات اصلاح شد (تعادل → باقیمانده → سقف → فلش)
- ✅ فلش از هر دو طرف محاسبه می‌شود
- ✅ باقیمانده جداگانه ذخیره می‌شود (چپ و راست)
- ✅ Documentation به‌روزرسانی شد
- ✅ مثال‌های 5 لول عمقی اضافه شد
-
-**فایل‌های تغییر یافته**:
-```
-CMS/src/.../CalculateWeeklyBalancesCommandHandler.cs (اصلاح شد)
-totalDoc/01-BUSINESS/balance-calculation-rules.md (به‌روزرسانی شد)
-totalDoc/01-BUSINESS/balance-calculation-examples-5-levels.md (جدید)
-```
-
-**تاریخ اتمام**: 2025-12-09
-
---
-
-## 🔥 Priority 1: Critical Tasks
-
-### Task #1: پیاده‌سازی Worker حذف خودکار کاربران غیرفعال
-
-**شرح**:
-کاربرانی که تا 2 هفته بعد از ثبت نام هیچکدام از موارد زیر را انجام ندادند باید به صورت خودکار حذف شوند:
- وام دایا نگرفتند
- پرداخت مستقیم 56 میلیون نکردند
-
-**Acceptance Criteria**:
- [ ] Worker روزانه یک بار اجرا شود (مثلاً ساعت 3 صبح)
- [ ] کاربرانی با `CreatedAt < Now - 14 days` و `IsActive = false` و `ClubMembershipId = null` شناسایی شوند
- [ ] کاربر به صورت Soft Delete حذف شود (یا Hard Delete بر اساس تصمیم)
- [ ] جایگاه شبکه (Network Position) آزاد شود
- [ ] معرف (Parent) بتواند دوباره کاربر جدید جذب کند
- [ ] Log کامل عملیات حذف ثبت شود
-
-**فایل‌های نیاز به ایجاد/تغییر**:
-```
-CMS/src/CMSMicroservice.WebApi/BackgroundWorkers/
-  └── DeleteInactiveUsersJob.cs (جدید)
-
-CMS/src/CMSMicroservice.Application/UserCQ/Commands/
-  └── DeleteInactiveUser/
-      ├── DeleteInactiveUserCommand.cs (جدید)
-      └── DeleteInactiveUserCommandHandler.cs (جدید)
-
-CMS/src/CMSMicroservice.WebApi/Program.cs
-  └── services.AddHostedService<DeleteInactiveUsersJob>();
-```
-
-**کد پیشنهادی**:
-```csharp
-public class DeleteInactiveUsersJob : BackgroundService
-{
-    private readonly IServiceProvider _serviceProvider;
-    private readonly ILogger<DeleteInactiveUsersJob> _logger;
-
-    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
-    {
-        while (!stoppingToken.IsCancellationRequested)
-        {
-            // محاسبه زمان اجرا (3 صبح)
-            var now = DateTime.Now;
-            var next3AM = now.Date.AddDays(1).AddHours(3);
-            var delay = next3AM - now;
-            
-            await Task.Delay(delay, stoppingToken);
-            
-            using var scope = _serviceProvider.CreateScope();
-            var context = scope.ServiceProvider.GetRequiredService<IApplicationDbContext>();
-            
-            var twoWeeksAgo = DateTime.Now.AddDays(-14);
-            
-            var inactiveUsers = await context.Users
-                .Where(u => u.Created < twoWeeksAgo
-                         && u.ClubMembershipId == null
-                         && !u.IsActive)
-                .ToListAsync(stoppingToken);
-            
-            _logger.LogInformation($"🧹 حذف {inactiveUsers.Count} کاربر غیرفعال بیش از 2 هفته");
-            
-            foreach (var user in inactiveUsers)
-            {
-                // حذف کاربر
-                user.IsDeleted = true; // Soft Delete
-                user.DeletedAt = DateTime.Now;
-                
-                // آزادسازی جایگاه شبکه
-                // (NetworkParentId را null نکنید چون تاریخچه نیاز دارد)
-                
-                _logger.LogWarning($"❌ حذف کاربر: {user.Id} - {user.UserName}");
-            }
-            
-            await context.SaveChangesAsync(stoppingToken);
-        }
-    }
-}
-```
-
-**تست**:
-1. کاربر جدید با `CreatedAt = DateTime.Now.AddDays(-15)` ایجاد کنید
-2. `IsActive = false`, `ClubMembershipId = null`
-3. Worker را مجبور به اجرا کنید (یا زمان را تغییر دهید)
-4. چک کنید: `user.IsDeleted = true`
-
-**تخمین زمان**: 4-6 ساعت
-
---
-
-### Task #2: الزامی کردن دیالوگ باشگاه مشتریان
-
-**شرح**:
-بعد از پرداخت موفق 56 میلیون تومان، کاربر **باید** قرارداد باشگاه مشتریان را امضا کند. تا زمانی که امضا نکند، نمی‌تواند به سایر بخش‌های سیستم دسترسی داشته باشد و لینک معرفی خود را ببیند.
-
-**Acceptance Criteria**:
- [ ] بعد از تأیید پرداخت، Modal/Dialog باشگاه مشتریان باز شود
- [ ] دکمه Close غیرفعال باشد (یا Modal با `disableBackdropClick` باز شود)
- [ ] کاربر نتواند از دیالوگ خارج شود (ESC هم کار نکند)
- [ ] بعد از امضای قرارداد:
-  - `ClubMembership` record ایجاد شود
-  - `User.ClubMembershipId` Set شود
-  - 25 میلیون تومان به `WeeklyCommissionPool` اضافه شود
- [ ] بعد از امضا، redirect به Dashboard
- [ ] در Dashboard لینک معرفی نمایش داده شود
-
-**فایل‌های نیاز به تغییر**:
-```
-FrontOffice/src/FrontOffice.Main/Pages/
-  └── Payment/PaymentSuccess.razor
-  └── Payment/PaymentSuccess.razor.cs
-
-FrontOffice/src/FrontOffice.Main/Components/
-  └── ClubMembershipDialog.razor (جدید یا اصلاح)
-
-CMS/src/CMSMicroservice.Application/ClubMembershipCQ/Commands/
-  └── CreateClubMembership/
-      ├── CreateClubMembershipCommand.cs
-      └── CreateClubMembershipCommandHandler.cs
-```
-
-**کد پیشنهادی (Frontend)**:
-```razor
-@* PaymentSuccess.razor *@
-@if (_showClubDialog)
-{
-    <MudDialog @bind-IsVisible="_showClubDialog" 
-               Options="@(new DialogOptions { 
-                   DisableBackdropClick = true, 
-                   CloseButton = false 
-               })">
-        <DialogContent>
-            <h3>عضویت در باشگاه مشتریان</h3>
-            <p>برای ادامه، لطفاً قرارداد باشگاه مشتریان را مطالعه و امضا کنید.</p>
-            
-            <MudPaper Class="pa-4 my-4" Elevation="2">
-                <p>متن قرارداد...</p>
-            </MudPaper>
-            
-            <MudCheckBox @bind-Checked="_agreedToTerms">
-                متن قرارداد را مطالعه کردم و با آن موافقم
-            </MudCheckBox>
-        </DialogContent>
-        <DialogActions>
-            <MudButton Variant="Variant.Filled" 
-                       Color="Color.Primary" 
-                       Disabled="!_agreedToTerms"
-                       OnClick="SignContract">
-                امضای قرارداد
-            </MudButton>
-        </DialogActions>
-    </MudDialog>
-}
-```
-
-```csharp
-// PaymentSuccess.razor.cs
-private bool _showClubDialog = false;
-private bool _agreedToTerms = false;
-
-protected override async Task OnInitializedAsync()
-{
-    // بعد از تأیید پرداخت
-    if (PaymentConfirmed && !User.ClubMembershipId.HasValue)
-    {
-        _showClubDialog = true;
-    }
-}
-
-private async Task SignContract()
-{
-    var request = new CreateClubMembershipRequest
-    {
-        UserId = User.Id,
-        InitialContribution = 25000000
-    };
-    
-    await ClubMembershipContract.CreateClubMembershipAsync(request);
-    
-    _showClubDialog = false;
-    NavigationManager.NavigateTo("/dashboard");
-}
-```
-
-**تست**:
-1. پرداخت 56M انجام دهید
-2. بعد از موفقیت، باید Dialog باز شود
-3. سعی کنید Close کنید → نشود
-4. بدون tick نزدن → دکمه غیرفعال باشد
-5. tick بزنید و امضا کنید → redirect به Dashboard
-6. لینک معرفی نمایش داده شود
-
-**تخمین زمان**: 6-8 ساعت
-
---
-
-### Task #3: شرط نمایش لینک معرفی
-
-**شرح**:
-لینک معرفی فقط باید برای کاربرانی نمایش داده شود که:
-1. پرداخت کرده‌اند (`IsActive = true`)
-2. عضو باشگاه مشتریان شده‌اند (`ClubMembershipId != null`)
-3. عضویت باشگاه فعال است (`ClubMembership.IsActive = true`)
-
-**Acceptance Criteria**:
- [ ] در صفحه Dashboard یا Profile، شرط بالا چک شود
- [ ] اگر شرایط برقرار نیست:
-  - پیغام: "برای دریافت لینک معرفی، ابتدا عضو باشگاه مشتریان شوید"
-  - دکمه "عضویت در باشگاه" (در صورت عدم عضویت)
- [ ] اگر شرایط برقرار است:
-  - لینک معرفی نمایش داده شود
-  - دکمه کپی
-  - QR Code (اختیاری)
-
-**فایل‌های نیاز به تغییر**:
-```
-FrontOffice/src/FrontOffice.Main/Pages/
-  └── Dashboard/Dashboard.razor
-  └── Dashboard/Dashboard.razor.cs
-
-یا
-
-FrontOffice/src/FrontOffice.Main/Pages/
-  └── Profile/MyProfile.razor
-```
-
-**کد پیشنهادی**:
-```razor
-@if (CanShowReferralLink)
-{
-    <MudCard Class="my-4">
-        <MudCardHeader>
-            <CardHeaderContent>
-                <MudText Typo="Typo.h6">🔗 لینک معرفی شما</MudText>
-            </CardHeaderContent>
-        </MudCardHeader>
-        <MudCardContent>
-            <MudTextField @bind-Value="_referralLink" 
-                          ReadOnly="true" 
-                          Adornment="Adornment.End"
-                          AdornmentIcon="@Icons.Material.Filled.ContentCopy"
-                          OnAdornmentClick="CopyLink"/>
-        </MudCardContent>
-    </MudCard>
-}
-else
-{
-    <MudAlert Severity="Severity.Warning" Class="my-4">
-        برای دریافت لینک معرفی، ابتدا عضو باشگاه مشتریان شوید.
-        @if (!User.ClubMembershipId.HasValue)
-        {
-            <MudButton Color="Color.Primary" 
-                       Variant="Variant.Filled" 
-                       Class="mt-2"
-                       OnClick="OpenClubDialog">
-                عضویت در باشگاه
-            </MudButton>
-        }
-    </MudAlert>
-}
-```
-
-```csharp
-private bool CanShowReferralLink => 
-    User.IsActive 
-    && User.ClubMembershipId.HasValue 
-    && User.ClubMembership?.IsActive == true;
-```
-
-**تست**:
-1. کاربر بدون `ClubMembership` → Alert نمایش داده شود
-2. کاربر با `ClubMembership` فعال → لینک نمایش داده شود
-3. دکمه کپی کار کند
-
-**تخمین زمان**: 3-4 ساعت
-
---
-
-## ⚠️ Priority 2: Medium Tasks
-
-### Task #4: Validation دقیق‌تر محدودیت 2 فرزند فعال
-
-**شرح**:
-در هنگام ثبت نام با کد معرف، باید بررسی شود که آیا Parent حداکثر **2 فرزند فعال** دارد یا نه (نه فقط 2 فرزند).
-
-**Acceptance Criteria**:
- [ ] Validation در `CreateUserCommandHandler` یا `NetworkPlacementService`
- [ ] شمارش فرزندان با شرط:
-  ```csharp
-  u.NetworkParentId == parentId 
-  && u.IsActive 
-  && u.ClubMembershipId != null
-  ```
- [ ] اگر `activeChildCount >= 2`:
-  - Exception: "این کاربر تعداد زیرمجموعه‌هاش پر شده و شما نمی‌تونید جزو زیرمجموعه این آدم بشید"
-  - یا Auto-Placement (بر اساس تصمیم)
-
-**فایل‌های نیاز به تغییر**:
-```
-CMS/src/CMSMicroservice.Application/Services/
-  └── NetworkPlacementService.cs
-
-CMS/src/CMSMicroservice.Application/UserCQ/Commands/CreateUser/
-  └── CreateUserCommandHandler.cs
-  └── CreateUserCommandValidator.cs
-```
-
-**کد پیشنهادی**:
-```csharp
-public async Task<NetworkLeg?> CalculateLegPositionAsync(long parentId, CancellationToken cancellationToken)
-{
-    var activeChildrenCount = await _context.Users
-        .CountAsync(u => u.NetworkParentId == parentId 
-                      && u.IsActive 
-                      && u.ClubMembershipId != null, 
-                    cancellationToken);
-    
-    if (activeChildrenCount >= 2)
-    {
-        throw new InvalidOperationException(
-            "این کاربر تعداد زیرمجموعه‌هاش پر شده و شما نمی‌تونید جزو زیرمجموعه این آدم بشید");
-    }
-    
-    // بررسی Left و Right
-    var hasLeft = await _context.Users
-        .AnyAsync(u => u.NetworkParentId == parentId 
-                    && u.LegPosition == NetworkLeg.Left
-                    && u.IsActive 
-                    && u.ClubMembershipId != null, 
-                  cancellationToken);
-    
-    if (!hasLeft) return NetworkLeg.Left;
-    
-    var hasRight = await _context.Users
-        .AnyAsync(u => u.NetworkParentId == parentId 
-                    && u.LegPosition == NetworkLeg.Right
-                    && u.IsActive 
-                    && u.ClubMembershipId != null, 
-                  cancellationToken);
-    
-    if (!hasRight) return NetworkLeg.Right;
-    
-    return null; // هر دو پر است
-}
-```
-
-**تست**:
-1. Parent با 2 فرزند فعال
-2. ثبت نام با کد این Parent
-3. باید Exception بیاید
-
-**تخمین زمان**: 3-4 ساعت
-
---
-
-### Task #5: بهبود پیغام خطای کد معرف پر
-
-**شرح**:
-در صفحه ثبت نام، اگر کاربر کد معرفی وارد کند که ظرفیتش پر است، باید پیغام خطای واضح و فارسی نمایش داده شود.
-
-**Acceptance Criteria**:
- [ ] در Frontend، بعد از وارد کردن کد معرف، validation شود
- [ ] اگر کد پر بود، پیغام:
-  > "این کد معرف ظرفیتش پر شده، لطفا از کد معرف دیگری استفاده کنید"
- [ ] Snackbar یا Alert با Severity.Warning
- [ ] فیلد کد معرف هایلایت شود (قرمز)
-
-**فایل‌های نیاز به تغییر**:
-```
-FrontOffice/src/FrontOffice.Main/Pages/
-  └── Register.razor
-  └── Register.razor.cs
-```
-
-**کد پیشنهادی**:
-```csharp
-private async Task ValidateReferralCode()
-{
-    if (string.IsNullOrWhiteSpace(_referralCode))
-        return;
-    
-    try
-    {
-        var request = new ValidateReferralCodeRequest
-        {
-            ReferralCode = _referralCode
-        };
-        
-        var response = await UserContract.ValidateReferralCodeAsync(request);
-        
-        if (!response.IsValid)
-        {
-            _referralCodeError = "کد معرف نامعتبر است";
-        }
-        else if (response.IsFull)
-        {
-            _referralCodeError = "این کد معرف ظرفیتش پر شده، لطفا از کد معرف دیگری استفاده کنید";
-            Snackbar.Add(_referralCodeError, Severity.Warning);
-        }
-    }
-    catch (Exception ex)
-    {
-        _referralCodeError = "خطا در بررسی کد معرف";
-    }
-}
-```
-
-**تست**:
-1. Parent پر را پیدا کنید
-2. کد معرف او را در Register وارد کنید
-3. پیغام واضح نمایش داده شود
-
-**تخمین زمان**: 2-3 ساعت
-
---
-
-## 📝 Priority 3: Documentation Tasks
-
-### Task #6: به‌روزرسانی مستندات
-
-**شرح**:
-با توجه به توضیحات جدید، داکیومنت‌های زیر باید Update شوند.
-
-**فایل‌های نیاز به تغییر**:
-
-#### 1. `totalDoc/01-BUSINESS/network-commission-system.md`
-```markdown
-# اضافه کردن بخش جدید:
-
-## ۱۰. حذف خودکار کاربران غیرفعال
-
-کاربرانی که تا 2 هفته بعد از ثبت نام:
- وام دایا نگرفته‌اند
- پرداخت مستقیم 56 میلیون نکرده‌اند
-
-به صورت خودکار حذف می‌شوند.
-
-**Worker**: `DeleteInactiveUsersJob`
-**زمان اجرا**: روزانه ساعت 3 صبح
-**منطق**: `CreatedAt < Now - 14 days && !IsActive && ClubMembershipId == null`
-
---
-
-## ۱۱. شرایط نمایش لینک معرفی
-
-لینک معرفی فقط برای کاربرانی نمایش داده می‌شود که:
-1. پرداخت کرده‌اند (IsActive = true)
-2. عضو باشگاه مشتریان شده‌اند (ClubMembershipId != null)
-3. عضویت باشگاه فعال است (ClubMembership.IsActive = true)
-
-**تا زمانی که این شرایط برقرار نباشد، کاربر نمی‌تواند لینک معرفی خود را ببیند.**
-
---
-
-## ۱۲. الزامی بودن دیالوگ باشگاه مشتریان
-
-بعد از پرداخت موفق 56 میلیون تومان، کاربر **باید** قرارداد باشگاه مشتریان را امضا کند.
-
-**فرآیند**:
-1. پرداخت موفق
-2. Dialog باشگاه مشتریان باز می‌شود
-3. کاربر نمی‌تواند Dialog را ببندد
-4. باید قرارداد را بخواند و امضا کند
-5. بعد از امضا → redirect به Dashboard
-6. لینک معرفی نمایش داده می‌شود
-```
-
-#### 2. `totalDoc/01-BUSINESS/binary-tree-guide.md`
-```markdown
-# اصلاح بخش Validation:
-
-### محدودیت 2 فرزند **فعال**
-
-هر Parent فقط می‌تواند **2 فرزند فعال** داشته باشد.
-
-**تعریف فعال**:
- IsActive = true
- ClubMembershipId != null
- عضویت باشگاه فعال است
-
-**نکته مهم**: کاربرانی که ثبت نام کرده‌اند اما هنوز فعال نشده‌اند، در شمارش 2 فرزند محسوب نمی‌شوند.
-```
-
-#### 3. `totalDoc/03-BACKEND/CMS/implementation-status.md`
-```markdown
-# افزودن به بخش Background Workers:
-
-### ✅ DeleteInactiveUsersWorker (NEW - 2025-12-08)
-
-**وضعیت**: 🔴 نیاز به پیاده‌سازی
-
-**شرح**: حذف خودکار کاربران غیرفعال بعد از 2 هفته
-
-**منطق**:
- روزانه ساعت 3 صبح اجرا می‌شود
- کاربرانی که `CreatedAt < Now - 14 days`
- و `IsActive = false`
- و `ClubMembershipId = null`
- به صورت Soft Delete حذف می‌شوند
-
-**فایل**: `CMS/BackgroundWorkers/DeleteInactiveUsersJob.cs`
-
-**Dependencies**:
- IApplicationDbContext
- ILogger
-```
-
-#### 4. `totalDoc/05-TASKS/BACKLOG.md`
-```markdown
-# اضافه کردن این 5 Task به Backlog
-
-## 🔥 Critical
-
- [ ] Task #1: پیاده‌سازی DeleteInactiveUsersWorker (6h)
- [ ] Task #2: الزامی کردن دیالوگ باشگاه (8h)
- [ ] Task #3: شرط نمایش لینک معرفی (4h)
-
-## ⚠️ Medium
-
- [ ] Task #4: Validation 2 فرزند فعال (4h)
- [ ] Task #5: پیغام خطای کد معرف پر (3h)
-
-## 📝 Low
-
- [ ] Task #6: Update Documentation (2h)
-
-**زمان کل**: 27 ساعت (~4 روز کاری)
-```
-
-**تخمین زمان**: 2-3 ساعت
-
---
-
-## 📊 خلاصه Task ها
-
-| # | عنوان | Priority | زمان | وضعیت |
-|---|--------|----------|------|--------|
-| 1 | DeleteInactiveUsersWorker | 🔥 Critical | 6h | ⬜ Todo |
-| 2 | الزامی دیالوگ باشگاه | 🔥 Critical | 8h | ⬜ Todo |
-| 3 | شرط لینک معرفی | 🔥 Critical | 4h | ⬜ Todo |
-| 4 | Validation 2 فرزند فعال | ⚠️ Medium | 4h | ⬜ Todo |
-| 5 | پیغام کد معرف پر | ⚠️ Medium | 3h | ⬜ Todo |
-| 6 | Update Documentation | 📝 Low | 3h | ⬜ Todo |
-
-**مجموع زمان**: 28 ساعت (~4 روز کاری)
-
---
-
-## 🎯 پلان اجرا (پیشنهادی)
-
-### روز 1 (8 ساعت):
- [ ] Task #1: DeleteInactiveUsersWorker (6h)
- [ ] شروع Task #2 (2h)
-
-### روز 2 (8 ساعت):
- [ ] ادامه Task #2: Dialog الزامی (6h)
- [ ] شروع Task #3 (2h)
-
-### روز 3 (8 ساعت):
- [ ] ادامه Task #3: شرط لینک (2h)
- [ ] Task #4: Validation (4h)
- [ ] شروع Task #5 (2h)
-
-### روز 4 (4 ساعت):
- [ ] ادامه Task #5 (1h)
- [ ] Task #6: Documentation (3h)
-
---
-
-## ✅ Definition of Done
-
-هر Task زمانی Complete حساب می‌شود که:
-1. ✅ کد نوشته شده و Build موفق
-2. ✅ Unit Test / Manual Test انجام شده
-3. ✅ Code Review شده
-4. ✅ Documentation به‌روز شده
-5. ✅ Merge به Main Branch
-
---
-
-**تهیه‌کننده**: AI Assistant  
-**تاریخ**: 2025-12-08  
-**نسخه**: 1.0
@@ -1,250 +0,0 @@
-# گزارش بررسی تطبیق بیزینس با کد
-
-**تاریخ بررسی**: _________  
-**بررسی‌کننده**: _________  
-**نسخه کد**: _________
-
---
-
-## ✅ بیزینس 1: Binary Tree (درخت دودویی)
-
-### بررسی کد:
-```bash
-# دستور اجرا شده:
-cd CMS/src/CMSMicroservice.Domain/Entities
-grep -A 20 "class User" User.cs | grep -E "Parent|Left|Right"
-```
-
-### نتیجه:
- [ ] ✅ User دارای Parent, LeftChild, RightChild است
- [ ] ✅ Spillover Logic پیاده‌سازی شده
- [ ] ✅ Depth محاسبه می‌شود
- [ ] ✅ Parent تغییر نمی‌کند
-
-### تست عملی:
-```
-ثبت‌نام 7 کاربر:
- User1 (Root)
- User2 (Left of 1)
- User3 (Right of 1)
- User4 (Left of 2) ✓
- User5 (Right of 2) ✓
- User6 (Left of 3) ✓
- User7 (Right of 3) ✓
-
-نتیجه: [✅ موفق] [❌ ناموفق]
-```
-
-### تطبیق با داکیومنت:
- فایل: `totalDoc/CMS/binary-tree-registration-guide.md`
- وضعیت: [✅ تطبیق کامل] [⚠️ نیاز به به‌روزرسانی] [❌ عدم تطبیق]
- توضیحات: _________________
-
---
-
-## 💰 بیزینس 2: محاسبه کمیسیون
-
-### بررسی کد:
-```bash
-# Cron Job
-cd CMS/src/CMSMicroservice.Application/BackgroundWorkers
-grep "Cron.*Sunday" -r .
-
-# فرمول
-grep "TotalPV.*Percentage" -r .
-```
-
-### نتیجه:
- [ ] ✅ Cron: یکشنبه 00:05 UTC
- [ ] ✅ فرمول: Commission = TotalPV × Percentage
- [ ] ✅ MinimumPV چک می‌شود
- [ ] ✅ CarryOver به هفته بعد
- [ ] ✅ MaxCommission رعایت می‌شود
-
-### تست عملی:
-```
-User: TestUser1
-PV این هفته: 1000
-Percentage: 10%
-MinimumPV: 500
-
-محاسبه شده: _______
-انتظار: 100
-
-نتیجه: [✅ موفق] [❌ ناموفق]
-```
-
-### تطبیق با داکیومنت:
- فایل: `totalDoc/CMS/network-club-commission-system-v1.1.md`
- وضعیت: [✅ تطبیق کامل] [⚠️ نیاز به به‌روزرسانی] [❌ عدم تطبیق]
- توضیحات: _________________
-
---
-
-## 🏆 بیزینس 3: سطوح باشگاه
-
-### بررسی کد:
-```bash
-cd CMS/src/CMSMicroservice.Domain/Entities
-grep -A 10 "ClubLevel" ClubMembership.cs
-```
-
-### نتیجه:
- [ ] ✅ 4 سطح: Bronze, Silver, Gold, Platinum
- [ ] ✅ شرط ارتقا پیاده‌سازی شده
- [ ] ✅ سطح پایین نمی‌آید
- [ ] ✅ Duration (ماهانه/سالانه)
-
-### تست عملی:
-```
-User: TestUser2
-PV فعلی: 5000 (Bronze)
-شرط Silver: 10000 PV
-
-بعد از رسیدن به 10000:
- سطح فعلی: _______
- انتظار: Silver
-
-نتیجه: [✅ موفق] [❌ ناموفق]
-```
-
-### تطبیق با داکیومنت:
- فایل: `totalDoc/CMS/network-club-commission-system-v1.1.md`
- وضعیت: [✅ تطبیق کامل] [⚠️ نیاز به به‌روزرسانی] [❌ عدم تطبیق]
- توضیحات: _________________
-
---
-
-## 💳 بیزینس 4: برداشت (Withdrawal)
-
-### بررسی کد:
-```bash
-cd CMS/src/CMSMicroservice.Application/WithdrawalCQ
-ls -1 *Command.cs
-```
-
-### نتیجه:
- [ ] ✅ حداقل موجودی چک می‌شود
- [ ] ✅ کارمزد محاسبه می‌شود
- [ ] ✅ وضعیت‌ها: Pending/Approved/Rejected
- [ ] ✅ فقط مدیر می‌تواند تأیید کند
- [ ] ✅ واریز بعد از Approve
-
-### تست عملی:
-```
-موجودی: 200,000
-درخواست برداشت: 150,000
-کارمزد 2%: 3,000
-مبلغ نهایی: 147,000
-
-نتیجه: [✅ موفق] [❌ ناموفق]
-```
-
-### تطبیق با داکیومنت:
- فایل: `totalDoc/CMS/implementation-progress.md`
- وضعیت: [✅ تطبیق کامل] [⚠️ نیاز به به‌روزرسانی] [❌ عدم تطبیق]
- توضیحات: _________________
-
---
-
-## 📧 بیزینس 5: اطلاع‌رسانی (Email/SMS)
-
-### بررسی کد:
-```bash
-cd CMS/src/CMSMicroservice.Application/Common/Services
-ls -1 *Notification*
-```
-
-### نتیجه:
- [ ] ✅ Email برای Commission ارسال می‌شود
- [ ] ✅ SMS برای تأیید موبایل
- [ ] ✅ Template های HTML
- [ ] ✅ ارسال بلافاصله بعد از event
-
-### تست عملی:
-```
-Event: Commission Calculated
-User Email: test@example.com
-
-Email دریافت شد؟ [✅ بله] [❌ خیر]
-محتوای Email صحیح؟ [✅ بله] [❌ خیر]
-
-نتیجه: [✅ موفق] [❌ ناموفق]
-```
-
-### تطبیق با داکیومنت:
- فایل: `totalDoc/CMS/email-sms-configuration-guide.md`
- وضعیت: [✅ تطبیق کامل] [⚠️ نیاز به به‌روزرسانی] [❌ عدم تطبیق]
- توضیحات: _________________
-
---
-
-## 🛒 بیزینس 6: سفارش و فاکتور
-
-### بررسی کد:
-```bash
-cd CMS/src/CMSMicroservice.Domain/Entities
-grep -A 20 "class UserOrder" UserOrder.cs
-```
-
-### نتیجه:
- [ ] ✅ UserOrder و FactorDetail
- [ ] ✅ محاسبه PV
- [ ] ✅ وضعیت سفارش
- [ ] ✅ VatPercentage اضافه شده
-
-### تست عملی:
-```
-محصول 1: قیمت 100,000، PV: 50
-محصول 2: قیمت 200,000، PV: 100
-
-جمع PV: _______
-انتظار: 150
-
-VAT 10%: _______
-انتظار: 30,000
-
-نتیجه: [✅ موفق] [❌ ناموفق]
-```
-
-### تطبیق با داکیومنت:
- فایل: `totalDoc/CMS/network-club-commission-system-v1.1.md`
- وضعیت: [✅ تطبیق کامل] [⚠️ نیاز به به‌روزرسانی] [❌ عدم تطبیق]
- توضیحات: _________________
-
---
-
-## 📊 خلاصه نتایج
-
-### آمار کلی:
- تعداد بیزینس بررسی شده: 6
- تطبیق کامل: _____ (___%)
- نیاز به به‌روزرسانی داکیومنت: _____
- عدم تطبیق (Bug): _____
-
-### موارد نیازمند اقدام فوری:
-1. _________________
-2. _________________
-3. _________________
-
-### موارد نیازمند به‌روزرسانی داکیومنت:
-1. _________________
-2. _________________
-3. _________________
-
---
-
-## 🎯 اقدامات بعدی
-
-### این هفته:
- [ ] _________________
- [ ] _________________
-
-### ماه آینده:
- [ ] _________________
- [ ] _________________
-
---
-
-**امضا**: _________  
-**تاریخ تکمیل گزارش**: _________
@@ -1,336 +0,0 @@
-# 📦 گزارش آمادگی تحویل پروژه FourSat به Admin
-
-> **تاریخ گزارش**: 1403/09/14 (2024-12-04)  
-> **نسخه پروژه**: v1.0.0-RC1  
-> **وضعیت**: آماده برای تحویل مرحله اول
-
---
-
-## ✅ بخش‌های آماده برای استفاده (Production Ready)
-
-### 1. **BackOffice UI - 56 صفحه کاربردی**
-
-#### 📊 Dashboard & Analytics
- ✅ داشبورد اصلی با نمودارها و آمار
- ✅ گزارش‌های فروش
- ✅ آمار کاربران و شبکه
-
-#### 👥 User Management (مدیریت کاربران)
- ✅ لیست کاربران با فیلترهای پیشرفته
- ✅ جزئیات کاربر
- ✅ ایجاد/ویرایش/حذف کاربر
- ✅ مدیریت آدرس‌های کاربر
- ✅ تخصیص نقش به کاربر
-
-#### 🛍️ Product Management (مدیریت محصولات)
- ✅ لیست محصولات با فیلترها
- ✅ ایجاد محصول جدید
- ✅ ویرایش محصول
- ✅ حذف محصول
- ✅ مدیریت گالری تصاویر
- ✅ مدیریت موجودی
- ✅ **Tag Management** (اضافه کردن برچسب‌ها)
- ✅ **Bulk Operations** (ویرایش دسته‌جمعی قیمت/موجودی)
-
-#### 🗂️ Category Management (مدیریت دسته‌بندی)
- ✅ لیست دسته‌بندی‌ها (Tree Structure)
- ✅ ایجاد/ویرایش/حذف دسته‌بندی
- ✅ دسته‌بندی چندسطحی (Parent-Child)
-
-#### 📦 Order Management (مدیریت سفارشات)
- ✅ لیست سفارشات با فیلترها
- ✅ جزئیات سفارش
- ✅ تغییر وضعیت سفارش
- ✅ لغو سفارش
- ✅ **CalculateOrderPV** (محاسبه PV برای MLM)
- ✅ **ApplyDiscountToOrder** (اعمال تخفیف دستی)
- ✅ **GetOrdersByDateRange** (فیلتر بازه زمانی)
-
-#### 💰 Commission Management (مدیریت کمیسیون)
- ✅ لیست درخواست‌های برداشت
- ✅ تأیید/رد برداشت
- ✅ گزارش‌های مالی
- ✅ **Withdrawal Reports** (گزارش‌های دوره‌ای)
-
-#### 🌳 Network Management (مدیریت شبکه)
- ✅ نمایش ساختار شبکه (Tree View)
- ✅ افزودن عضو به شبکه
- ✅ حذف از شبکه
- ✅ جابه‌جایی در شبکه
- ✅ مشاهده موقعیت کاربر
-
-#### 📦 Package Management (مدیریت پکیج‌ها)
- ✅ لیست پکیج‌ها
- ✅ ایجاد/ویرایش پکیج
- ✅ **GetUserPackageStatus** (وضعیت خرید پکیج کاربر)
-
-#### 🎫 Club Membership (عضویت باشگاه)
- ✅ مدیریت عضویت باشگاه
- ✅ فعالسازی عضویت
- ✅ لیست اعضای باشگاه
-
-#### 🔐 Roles & Permissions (نقش‌ها و دسترسی‌ها)
- ✅ مدیریت نقش‌ها
- ✅ تخصیص نقش به کاربر
-
-#### ⚙️ Settings (تنظیمات)
- ✅ تنظیمات عمومی
- ✅ مدیریت Configuration Keys
- ✅ تنظیمات ایمیل
- ✅ تنظیمات SMS
-
---
-
-### 2. **CMS Backend - Features کامل**
-
-#### ✅ Club Discount Shop System (100%)
-**تاریخ تکمیل**: 4 دسامبر 2024
-
-**Entities:**
- DiscountCategory (دسته‌بندی محصولات تخفیفی)
- DiscountProduct (محصولات تخفیفی)
- DiscountShoppingCart (سبد خرید)
- DiscountOrder (سفارشات)
- DiscountOrderItem (جزئیات سفارش)
-
-**Operations:**
- CRUD محصولات و دسته‌بندی
- مدیریت سبد خرید
- Checkout با Hybrid Payment (کیف پول تخفیف + درگاه)
- مدیریت موجودی خودکار
- 19 gRPC RPC برای BackOffice
-
-**Business Logic:**
- خرید با کیف پول تخفیف تا سقف MaxDiscountPercent
- پرداخت باقیمانده از طریق درگاه
- Order lifecycle: Pending → Processing → Shipped → Delivered/Cancelled
-
-#### ✅ Tag Management (100%)
-**تاریخ تکمیل**: 4 دسامبر 2024
-
- CRUD Tags
- Assign Tags to Products
- Filter Products by Tag
- Proto + gRPC Services آماده
-
-#### ✅ Product Bulk Operations (100%)
-**تاریخ تکمیل**: 4 دسامبر 2024
-
- BulkUpdateProductPrices (ویرایش دسته‌جمعی قیمت)
- BulkUpdateProductStock (ویرایش دسته‌جمعی موجودی)
- GetLowStockProducts (محصولات کم موجودی)
- ToggleProductStatus (فعال/غیرفعال کردن)
-
-#### ✅ Payment Gateway Integration (100%)
-**تاریخ تکمیل**: 4 دسامبر 2024
-
- DayaPaymentService پیاده‌سازی کامل
- InitiatePaymentAsync
- VerifyPaymentAsync
- ProcessPayoutAsync
- GetWithdrawalReports (گزارش‌های دوره‌ای)
-
-#### ✅ Order Management Extensions (100% Proto/gRPC)
-**تاریخ تکمیل**: 4 دسامبر 2024
-
- UpdateOrderStatus (تغییر وضعیت)
- GetOrdersByDateRange (فیلتر بازه زمانی)
- ApplyDiscountToOrder (تخفیف دستی)
- CalculateOrderPV (محاسبه PV)
-
-**نکته**: Handlers با TODO دقیق آماده شده‌اند (45 دقیقه پیاده‌سازی)
-
-#### ✅ Package Purchase System (100% Proto/gRPC)
-**تاریخ تکمیل**: 4 دسامبر 2024
-
- PurchaseGoldenPackage
- VerifyGoldenPackagePurchase
- GetUserPackageStatus
- Proto + gRPC Services آماده
-
-**نکته**: Handlers با TODO دقیق آماده شده‌اند (1 ساعت پیاده‌سازی)
-
-#### ✅ Public Messages System (100% Proto/gRPC)
-**تاریخ تکمیل**: 4 دسامبر 2024
-
- Create/Update/Delete Messages
- Publish/Archive Messages
- Get All/Active Messages
- Proto + gRPC Services آماده
-
-**نکته**: 5 TODO handlers (1 ساعت پیاده‌سازی)
-
---
-
-## ⚠️ بخش‌های در حال تکمیل (نزدیک به اتمام)
-
-### 🔄 BackOffice.BFF - TODO Handlers
-
-#### پیاده‌سازی سریع (کل: 3 ساعت)
-1. **Package Purchase (1 ساعت)**:
-   - GetUserPackageStatusHandler
-
-2. **Order Management (1 ساعت)**:
-   - UpdateOrderStatusHandler
-   - GetOrdersByDateRangeHandler
-   - ApplyDiscountToOrderHandler
-   - CalculateOrderPVHandler
-
-3. **Public Messages (1 ساعت)**:
-   - GetAllMessagesHandler
-   - GetActiveMessagesHandler
-
-**راهنمای پیاده‌سازی**: هر Handler فقط یک gRPC call ساده است. TODO comments دقیق موجود است.
-
---
-
-## 🚀 بخش‌های در صف توسعه (اولویت بالا)
-
-### 1. Discount Shop - BackOffice Integration (4 روز)
-**وضعیت**: CMS 100% آماده، نیاز به 19 Handler در BackOffice.BFF
-
-**Handlers مورد نیاز**:
- Product Management (5 handlers)
- Category Management (4 handlers)
- Shopping Cart (5 handlers)
- Order Management (5 handlers)
-
-**UI Pages مورد نیاز**:
- صفحه مدیریت محصولات تخفیفی
- صفحه مدیریت دسته‌بندی
- صفحه سفارشات تخفیفی
-
-### 2. Public Messages UI (2 روز)
- صفحه لیست اعلانات
- Dialog ایجاد/ویرایش
- دکمه Publish/Archive
- پیش‌نمایش اعلان
-
-### 3. Withdrawal Reports UI (2 روز)
- صفحه گزارش‌های مالی
- Chart.js visualization
- فیلترهای پیشرفته
- Export Excel/PDF
-
---
-
-## 📋 چک‌لیست تحویل
-
-### ✅ آماده برای تحویل فوری
- [✅] BackOffice UI با 56 صفحه کاملاً کاربردی
- [✅] User Management کامل
- [✅] Product Management کامل + Bulk Ops + Tags
- [✅] Order Management کامل (با TODO handlers)
- [✅] Commission Management کامل
- [✅] Network Management کامل
- [✅] Package Management کامل (با TODO handlers)
- [✅] Roles & Settings کامل
- [✅] CMS Backend برای Discount Shop (100%)
- [✅] CMS Backend برای Payment Gateway (100%)
- [✅] مستندات کامل (1812+ خط)
-
-### ⏳ نیاز به تکمیل کوتاه‌مدت (1 هفته)
- [ ] پیاده‌سازی 8 TODO handlers در BackOffice.BFF (3 ساعت)
- [ ] پیاده‌سازی 9 TODO handlers در CMS (2 ساعت)
- [ ] Discount Shop Integration - BackOffice.BFF (4 روز)
- [ ] Public Messages UI (2 روز)
- [ ] Withdrawal Reports UI (2 روز)
-
---
-
-## 📊 آمار کلی پروژه
-
-### Backend (CMS)
- **Total Entities**: 45+
- **Total Commands**: 120+
- **Total Queries**: 80+
- **Total gRPC Services**: 20+
- **Build Status**: ✅ 0 errors, 507 warnings
- **Test Coverage**: Unit tests برای بخش‌های کلیدی
-
-### BackOffice.BFF
- **Total Handlers**: 55 (47 کامل + 8 TODO)
- **gRPC Clients**: 15+
- **Build Status**: ⚠️ 38 pre-existing errors in DiscountOrder module (unrelated)
-
-### BackOffice UI
- **Total Pages**: 56
- **Total Components**: 40+
- **UI Framework**: Blazor + MudBlazor
- **Authentication**: JWT-based
- **Authorization**: Role-based (SuperAdmin, Admin, Inspector)
-
---
-
-## 🎯 پیشنهاد مسیر تحویل
-
-### مرحله 1: تحویل فوری (امروز)
-**محتوا**:
- BackOffice UI کامل (56 صفحه)
- مستندات کامل
- راهنمای استفاده
-
-**قابلیت‌ها**:
- مدیریت کاربران، محصولات، سفارشات
- مدیریت کمیسیون و شبکه
- گزارش‌های پایه
-
-### مرحله 2: تکمیل سریع (3-5 روز)
-**محتوا**:
- پیاده‌سازی TODO handlers (5 ساعت)
- Discount Shop Integration (4 روز)
-
-**قابلیت‌های اضافه**:
- مدیریت کامل Discount Shop
- Package Purchase Flow کامل
- Order Management پیشرفته
-
-### مرحله 3: بهبودها (1 هفته)
-**محتوا**:
- Public Messages UI
- Withdrawal Reports UI
- Manual Payment System
-
---
-
-## 📞 پشتیبانی و مستندات
-
-### مستندات موجود
- ✅ `REMAINING-TASKS-CONSOLIDATED.md` (1400+ خط)
- ✅ `implementation-progress.md` (1812 خط)
- ✅ `network-club-commission-system-v1.1.md`
- ✅ `discount-shop-system.md`
- ✅ `package-purchase-system.md`
- ✅ `BackOffice/development-plan.md` (1462 خط)
- ✅ راهنمای نصب و راه‌اندازی
-
-### نکات فنی مهم
- **Database**: SQL Server
- **Framework**: .NET 8/9
- **Authentication**: JWT + Cookie
- **Communication**: gRPC
- **Mapping**: Mapster
- **Validation**: FluentValidation
- **Logging**: Serilog (آماده شود)
-
---
-
-## ✅ تأییدیه آمادگی
-
-**تأیید می‌شود که**:
- ✅ BackOffice UI با 56 صفحه کاملاً تست شده و آماده استفاده است
- ✅ تمام CRUD های اصلی کار می‌کنند
- ✅ CMS Backend برای فیچرهای اصلی 100% آماده است
- ✅ مستندات کامل و به‌روز است
- ✅ Build تمیز و بدون خطای blocking
-
-**توصیه می‌شود**:
- Admin می‌تواند از نسخه فعلی برای شروع استفاده کند
- TODO handlers در عرض یک هفته تکمیل خواهند شد
- Discount Shop در اولویت بعدی است
-
---
-
-**تاریخ گزارش**: 1403/09/14  
-**تهیه‌کننده**: تیم توسعه FourSat  
-**نسخه**: v1.0.0-RC1
@@ -1,353 +0,0 @@
-# 🚀 Quick Start - شروع سریع توسعه
-
-**برای توسعه‌دهنده جدید یا بازگشت به پروژه**
-
---
-
-## 📖 مرحله 1: مطالعه مستندات (30 دقیقه)
-
-### الزامی:
-```bash
-cd /home/masoud/Apps/project/FourSat/totalDoc
-
-# 1. شروع از INDEX
-cat INDEX.md
-
-# 2. درک بیزینس
-cat CMS/network-club-commission-system-v1.1.md
-
-# 3. وضعیت فعلی
-cat REMAINING-TASKS.md
-
-# 4. مقایسه CMS vs BFF
-cat CMS-API-COVERAGE.md
-```
-
---
-
-## 🎯 مرحله 2: انتخاب تسک (5 دقیقه)
-
-### چک‌لیست قبل از شروع:
- [ ] تسک از `REMAINING-TASKS.md` انتخاب شد؟
- [ ] اولویت مشخص است؟ (🔴 بالا / 🟡 متوسط / 🟢 پایین)
- [ ] بیزینس در `network-club-commission-system-v1.1.md` مستند است؟
- [ ] تأثیر روی سرویس‌های دیگر مشخص است؟
-
-### تسک فعلی (هفته 1):
-```
-🔴 Transaction System (درگاه پرداخت)
-├─ CMS: 3 روز
-├─ BackOffice.BFF: 2 روز  
-└─ BackOffice UI: 2 روز
-```
-
---
-
-## 💻 مرحله 3: Setup محیط توسعه
-
-### CMS
-```bash
-cd /home/masoud/Apps/project/FourSat/CMS/src
-
-# Build
-dotnet build
-
-# Run (با Hangfire Dashboard)
-cd CMSMicroservice.WebApi
-dotnet run --urls="http://localhost:5133"
-
-# Check Health
-curl http://localhost:5133/health
-
-# Hangfire Dashboard
-# http://localhost:5133/hangfire
-```
-
-### BackOffice.BFF
-```bash
-cd /home/masoud/Apps/project/FourSat/BackOffice.BFF/src
-
-# Build
-dotnet build
-
-# Run
-cd BackOffice.BFF.WebApi
-dotnet run --urls="http://localhost:5000"
-
-# Check
-curl http://localhost:5000/health
-```
-
-### BackOffice (UI)
-```bash
-cd /home/masoud/Apps/project/FourSat/BackOffice/src
-
-# Build
-dotnet build
-
-# Run
-cd BackOffice
-dotnet run
-
-# Browser: http://localhost:5001
-```
-
---
-
-## 📝 مرحله 4: پیاده‌سازی (به ترتیب)
-
-### 1️⃣ CMS (Backend)
-
-#### الف. Entity & Migration
-```bash
-cd CMS/src/CMSMicroservice.Domain/Entities
-
-# 1. ایجاد Entity
-# مثال: Transaction.cs
-
-# 2. اضافه کردن به DbContext
-cd ../CMSMicroservice.Infrastructure/Data
-
-# 3. ایجاد Migration
-dotnet ef migrations add AddTransaction -s ../../CMSMicroservice.WebApi
-
-# 4. اعمال Migration
-dotnet ef database update -s ../../CMSMicroservice.WebApi
-```
-
-#### ب. Commands & Queries
-```bash
-cd CMS/src/CMSMicroservice.Application
-
-# ساختار:
-TransactionCQ/
-├── CreateTransactionCommand.cs
-├── CreateTransactionCommandHandler.cs
-├── GetTransactionQuery.cs
-└── GetTransactionQueryHandler.cs
-```
-
-#### ج. Protobuf
-```bash
-cd CMS/src/CMSMicroservice.Protobuf/Protos
-
-# 1. ویرایش transactions.proto
-# 2. Build پروژه (auto-generate C# code)
-dotnet build
-```
-
-#### د. gRPC Service
-```bash
-cd CMS/src/CMSMicroservice.WebApi/GrpcServices
-
-# ایجاد TransactionGrpcService.cs
-```
-
-#### ✅ داکیومنت CMS
-```bash
-cd /home/masoud/Apps/project/FourSat/totalDoc
-
-# به‌روزرسانی:
-# - CMS/implementation-progress.md
-# - REMAINING-TASKS.md (mark as done)
-```
-
---
-
-### 2️⃣ BackOffice.BFF (Gateway)
-
-#### الف. Handler
-```bash
-cd BackOffice.BFF/src/BackOffice.BFF.Application/Handlers
-
-# ساختار:
-TransactionHandlers/
-├── CreateTransactionHandler.cs
-├── GetTransactionHandler.cs
-└── GetAllTransactionsHandler.cs
-```
-
-#### ب. DTOs
-```bash
-cd BackOffice.BFF/src/BackOffice.BFF.Application/DTOs
-
-# TransactionDto.cs
-```
-
-#### ج. Controller
-```bash
-cd BackOffice.BFF/src/BackOffice.BFF.WebApi/Controllers
-
-# TransactionController.cs
-[ApiController]
-[Route("api/transactions")]
-```
-
-#### ✅ داکیومنت BFF
-```bash
-# به‌روزرسانی:
-# - BackOffice.BFF/cms-integration.md
-```
-
---
-
-### 3️⃣ BackOffice (Admin UI)
-
-#### الف. صفحه جدید
-```bash
-cd BackOffice/src/BackOffice/Pages
-
-# Transactions/
-# ├── Index.razor (لیست)
-# ├── Details.razor (جزئیات)
-# └── Transactions.razor.cs (Code-behind)
-```
-
-#### ب. Service
-```bash
-cd BackOffice/src/BackOffice/Services
-
-# TransactionService.cs
-```
-
-#### ج. Menu Item
-```bash
-# اضافه کردن به Shared/NavMenu.razor
-```
-
-#### ✅ داکیومنت UI
-```bash
-# به‌روزرسانی:
-# - BackOffice/development-plan.md
-```
-
---
-
-## 🧪 مرحله 5: تست
-
-### تست دستی:
-```bash
-# 1. CMS: Postman/gRPCurl
-grpcurl -plaintext localhost:5133 list
-
-# 2. BFF: Swagger
-# http://localhost:5000/swagger
-
-# 3. UI: Browser
-# http://localhost:5001
-```
-
-### چک‌لیست تست:
- [ ] API در CMS کار می‌کند؟
- [ ] Handler در BFF صحیح است؟
- [ ] صفحه در UI نمایش داده می‌شود؟
- [ ] سطوح دسترسی (SuperAdmin/Admin/Inspector) صحیح است؟
- [ ] Error handling درست است؟
-
---
-
-## 📋 مرحله 6: مقایسه با بیزینس
-
-### چک‌لیست بیزینس:
-```bash
-cd /home/masoud/Apps/project/FourSat/totalDoc
-
-# 1. باز کردن تمپلیت
-cp BUSINESS-VERIFICATION-TEMPLATE.md BUSINESS-CHECK-$(date +%Y-%m-%d).md
-
-# 2. پر کردن بخش مربوط به Transaction
-# 3. مقایسه کد با داکیومنت
-
-# مثال:
-# - آیا Transaction.Status درست است؟
-# - آیا ReferenceId ذخیره می‌شود؟
-# - آیا Gateway name صحیح است؟
-```
-
---
-
-## 💾 مرحله 7: Commit & Document
-
-### قبل از Commit:
-```bash
-# 1. مقایسه با داکیومنت
-cat totalDoc/CMS/network-club-commission-system-v1.1.md
-
-# 2. به‌روزرسانی داکیومنت
-vim totalDoc/CMS/implementation-progress.md
-
-# 3. Mark تسک as Done
-vim totalDoc/REMAINING-TASKS.md
-```
-
-### Commit Message:
-```bash
-git add .
-git commit -m "feat(CMS): Add Transaction System for payment gateway
-
- Add Transaction entity with Status/ReferenceId/Gateway
- Implement CreateTransaction, VerifyTransaction commands
- Add GetTransaction, GetAllTransactions queries
- Update Protobuf: transactions.proto
- Docs: CMS/implementation-progress.md updated
-
-Business: Payment gateway integration
-Impact: BackOffice.BFF needs TransactionHandler (next)
-"
-```
-
---
-
-## 🔄 مرحله 8: تکرار برای BFF و UI
-
-همین مراحل رو برای BackOffice.BFF و BackOffice UI تکرار کن.
-
---
-
-## 📚 مراجع سریع
-
-### مستندات:
- `INDEX.md` → فهرست کامل
- `REMAINING-TASKS.md` → تسک‌های باقی‌مانده
- `CMS-API-COVERAGE.md` → مقایسه CMS vs BFF
- `BUSINESS-VERIFICATION-TEMPLATE.md` → چک‌لیست بیزینس
-
-### بیزینس:
- `CMS/network-club-commission-system-v1.1.md` → بیزینس اصلی
- `CMS/balance-calculation-carryover-logic.md` → محاسبات
- `CMS/email-sms-configuration-guide.md` → اطلاع‌رسانی
-
-### پیشرفت:
- `CMS/implementation-progress.md` → وضعیت CMS
- `BackOffice/development-plan.md` → وضعیت BackOffice
-
---
-
-## ⚠️ نکات مهم
-
-### 🚫 اشتباهات رایج:
- ❌ شروع بدون مطالعه بیزینس
- ❌ فراموش کردن داکیومنت
- ❌ نادیده گرفتن سطوح دسترسی
- ❌ تست نکردن قبل از commit
-
-### ✅ بهترین روش‌ها:
- ✅ اول CMS، بعد BFF، بعد UI
- ✅ هر تسک = یک commit با داکیومنت
- ✅ هر هفته = مقایسه کد با بیزینس
- ✅ هر ماه = BUSINESS-VERIFICATION
-
---
-
-## 🆘 مشکل داری؟
-
-### چک‌لیست عیب‌یابی:
-1. آیا CMS در حال اجراست؟ → `curl http://localhost:5133/health`
-2. آیا BFF متصل به CMS است؟ → چک logs
-3. آیا Migration اعمال شده؟ → `dotnet ef database update`
-4. آیا Protobuf build شده؟ → `dotnet build`
-5. آیا بیزینس درست است؟ → مراجعه به `network-club-commission-system-v1.1.md`
-
---
-
-**موفق باشی! 🚀**
@@ -1,929 +0,0 @@
-# تحلیل تناقضات، شبهات و مشکلات طراحی
-
-**تاریخ تحلیل**: 2024-12-03 (به‌روزرسانی نهایی)  
-**آخرین بررسی**: 2024-12-03 - بررسی جامع نامگذاری و ساختار  
-**وضعیت**: ✅ **تمام مشکلات مهم اصلاح شده**  
-**اولویت**: پایین - فقط نگهداری و مانیتورینگ
-
---
-
-## ✅ مشکلات اصلاح شده (Fixed Issues - 2024-12-03)
-
-### ✅ **اصلاح نامگذاری و حذف تناقضات (Spelling & Naming Fixes)**
-
-#### عملیات انجام شده:
-
-**1. اصلاح DbSet Properties:**
- ✅ `UserCartss` → `UserCarts`
- ✅ `Productss` → `Products`
- ✅ `ProductImagess` → `ProductImages`
- ✅ `FactorDetailss` → `FactorDetails`
- ✅ `UserAddresss` → `UserAddresses`
- ✅ `Categorys` → `Categories`
- ✅ `Transactionss` → `Transactions`
- ✅ **ProductGalleryss → ProductGalleries** (DbSet property)
-
-**2. اصلاح Entity Names:**
- ✅ `PruductTag` → `ProductTag`
- ✅ `PruductCategory` → `ProductCategory`
- ✅ **ProductGallerys → ProductGalleries** (تصحیح املایی)
-
-**3. اصلاح Entity Naming Convention (EF Core Standard):**
- ✅ `UserCarts` → `UserCart`
- ✅ `ProductImages` → `ProductImage`
- ✅ `ProductGalleries` → `ProductGallery`
- ✅ `Products` → `Product`
- ✅ `Transactions` → `Transaction`
-
-**4. اصلاح Event Folders:**
- ✅ `PruductTagEvents` → `ProductTagEvents`
- ✅ `PruductCategoryEvents` → `ProductCategoryEvents`
-
-**4. اصلاح Proto Files:**
- ✅ `pruductcategory.proto` → `productcategory.proto`
- ✅ `pruducttag.proto` → `producttag.proto`
-
-**5. اصلاح WebApi Services:**
- ✅ `PruductCategoryService` → `ProductCategoryService`
- ✅ `PruductTagService` → `ProductTagService`
-
-**6. حذف Duplicate Folders:**
- ✅ **ProductCQ** merged into **ProductsCQ**
-  - Commands: UpdateProductBulk
-  - Queries: GetProductsByCategory, GetProductsByTag
- ✅ **CreateTag** (duplicate command removed)
-
-**7. CQRS Handlers:**
- ✅ 100+ handler files updated via batch operations
- ✅ All references to old DbSet names corrected
-
-**8. Build Status:**
- ✅ **0 Errors**
- ⚠️ 242 Warnings (nullable warnings only - قابل چشم‌پوشی)
-
---
-
-## 🚨 مشکلات جدی باقیمانده (Critical Issues - نیاز به اصلاح فوری)
-
-### ✅ **FIXED - ProductGallerys → ProductGalleries**
-
-**وضعیت**: ✅ اصلاح شد در 2024-12-03
- 150+ فایل و فولدر تغییر نام یافتند
- Build موفقیت‌آمیز: 0 Error, 0 Warning
- زمان صرف شده: 45 دقیقه
-
---
-
-### ✅ **RESOLVED - Entity Naming Convention (EF Core Standard)**
-
-**وضعیت**: ✅ تکمیل شد در 2024-12-03  
-**زمان اجرا**: 3 ساعت  
-**نتیجه**: Build موفقیت‌آمیز با 0 Error
-
-#### مشکلی که حل شد:
-**5 Entity با نامگذاری Plural که به Singular تبدیل شدند**
-
-#### Entity های اصلاح شده:
-
-| # | قبل (اشتباه) | بعد (صحیح) | استفاده | فایل‌ها | وضعیت |
-|---|---------------|-----------|----------|---------|--------|
-| 1 | `UserCarts` | `UserCart` | 192 مورد | 40+ | ✅ Done |
-| 2 | `ProductImages` | `ProductImage` | 181 مورد | 35+ | ✅ Done |
-| 3 | `ProductGalleries` | `ProductGallery` | 162 مورد | 30+ | ✅ Done |
-| 4 | `Products` | `Product` | 283 مورد | 50+ | ✅ Done |
-| 5 | `Transactions` | `Transaction` | 257 مورد | 45+ | ✅ Done |
-| | **مجموع** | | **1075 مورد** | **200+** | ✅ |
-
-#### اصلاحات انجام شده:
-
-**1. EF Core Convention اعمال شد:**
-```csharp
-// قبل: ❌
-public class Products { }
-DbSet<Products> Products { get; }
-
-// بعد: ✅
-public class Product { }
-DbSet<Product> Products { get; }
-```
-
-**2. فایل‌های تغییر یافته:**
- ✅ 5 Entity files renamed
- ✅ 5 Configuration files updated
- ✅ DbContext interfaces/implementations updated
- ✅ 15+ navigation properties updated
- ✅ 200+ CQRS handlers batch updated
- ✅ 17 Event classes updated
- ✅ Build: 0 errors, 370 warnings (pre-existing)
-
-**3. مشکل در Navigation Properties:**
-```csharp
-public class Category {
-    public virtual ICollection<Products> Products { get; set; }
-    //                         ↑ باید Product باشد
-}
-```
-
-**4. عدم Consistency:**
- ✅ `User` → `DbSet<User> Users` (درست)
- ❌ `Products` → `DbSet<Products> Products` (اشتباه)
-
-#### تاثیر:
- **Entity Files**: 5 فایل
- **Configuration Files**: 5 فایل
- **DbContext Files**: 2 فایل
- **Navigation Properties**: 50+ Entity
- **CQRS Handlers**: 200+ فایل
- **Proto Files**: 5 فایل
- **Services**: 5 فایل
- **CQ Folders**: 5 فولدر
- **Events**: 5 فولدر
- **Validators**: 15+ فایل
- **Profiles**: 10+ فایل
-
-**مجموع تخمینی**: **400+ فایل**
-
-#### تصمیم:
-**🚀 اصلاح فوری - مرحله به مرحله**
-
-دلایل اصلاح:
-1. ✅ پایه محکم برای توسعه آینده
-2. ✅ مطابق با استانداردهای Microsoft
-3. ✅ جلوگیری از confusion در تیم
-4. ✅ کاهش Technical Debt
-5. ✅ بهبود maintainability
-
-#### برنامه اجرا:
-
-**Phase 1: Products → Product** (تخمین: 1 ساعت)
- Entity + Configuration
- DbContext files
- Navigation Properties
- CQRS Handlers (batch)
- Proto + Service
- Build & Test
-
-**Phase 2: UserCarts → UserCart** (تخمین: 45 دقیقه)
- مشابه Phase 1
-
-**Phase 3: ProductImages → ProductImage** (تخمین: 45 دقیقه)
- مشابه Phase 1
-
-**Phase 4: ProductGalleries → ProductGallery** (تخمین: 45 دقیقه)
- مشابه Phase 1
-
-**Phase 5: Transactions → Transaction** (تخمین: 1 ساعت)
- مشابه Phase 1
-
-**زمان کل تخمینی**: 4-5 ساعت
-**تاریخ شروع**: 2024-12-03
-**اولویت**: 🔴 فوری (قبل از ادامه Phase 9)
-
---
-
-## 🚨 مشکلات جدی (Critical Issues)
-
-### 1. ✅ **RESOLVED - تناقض در مدیریت Balance و NetworkBalance**
-
-#### مشکل:
-```csharp
-// UserWallet.cs
-public long Balance { get; set; }          // موجودی
-public long NetworkBalance { get; set; }   // موجودی شبکه/کارمزد (کیف پول طلایی)
-public long DiscountBalance { get; set; }  // موجودی تخفیف
-```
-
-#### تناقضات:
-
-**A. در ProcessDayaLoanApprovalCommandHandler:**
-```csharp
-// خط 64: شارژ Balance
-wallet.Balance += request.WalletAmount;  // 56M تومان
-
-// خط 81: شارژ NetworkBalance
-wallet.NetworkBalance += request.LockedWalletAmount;  // 56M تومان
-
-// خط 99: شارژ DiscountBalance
-wallet.DiscountBalance += request.DiscountWalletAmount;  // 56M تومان
-```
-
-**مجموع**: 3 × 56M = **168M تومان** به یک کاربر داده می‌شود!
-
-**سوال**: آیا این عمدی است؟ آیا هر کیف پول مجزا است؟
-
-#### نتیجه:
- ✅ اگر **3 کیف پول مجزا** باشند: مشکلی نیست
- ❌ اگر **یک کیف پول** باشند: **شارژ سه‌باره اشتباه است!**
-
---
-
-### 2. ❌ **UserWalletChangeLog فقط Balance و NetworkBalance را ثبت می‌کند**
-
-#### مشکل:
-```csharp
-// UserWalletChangeLog.cs
-public long CurrentBalance { get; set; }
-public long CurrentNetworkBalance { get; set; }
-// ❌ فیلد CurrentDiscountBalance وجود ندارد!
-```
-
-#### کد فعلی:
-```csharp
-// ProcessDayaLoanApprovalCommandHandler.cs - خط 97
-// توجه: تغییرات DiscountBalance در UserWalletChangeLog ثبت نمی‌شود 
-// چون فیلد مخصوصی برای آن وجود ندارد
-var balanceBeforeDiscount = wallet.DiscountBalance;
-wallet.DiscountBalance += request.DiscountWalletAmount;
-// ❌ هیچ Log ثبت نمی‌شود!
-```
-
-#### تاثیر:
- ❌ **تغییرات DiscountBalance قابل Audit نیست**
- ❌ نمی‌توان تاریخچه تخفیف را ردیابی کرد
- ❌ در صورت اختلاف، مدرک نداریم
- ❌ در Phase 9 (Club Discount Shop) مشکل جدی ایجاد می‌کند
-
-#### راه‌حل پیشنهادی:
-```csharp
-// باید به UserWalletChangeLog اضافه شود:
-public long CurrentDiscountBalance { get; set; }
-```
-
---
-
-### 3. ❌ **تناقض در مفهوم Balance و NetworkBalance**
-
-#### مستندات می‌گوید:
-```
-Balance: موجودی عادی (خرید محصول)
-NetworkBalance: موجودی شبکه/کارمزد (قابل برداشت نقدی یا خرید الماس)
-DiscountBalance: موجودی تخفیف (فقط خرید از فروشگاه تخفیفی)
-```
-
-#### اما در کدها:
-
-**SubmitShopBuyOrderCommandHandler.cs (خط 61)**:
-```csharp
-// خرید محصول: از Balance کم می‌شود
-userWallet.Balance -= request.TotalAmount;
-```
-
-**VerifyGoldenPackagePurchaseCommandHandler.cs (خط 92)**:
-```csharp
-// شارژ بعد از خرید پکیج طلایی: به Balance اضافه می‌شود
-wallet.Balance += order.Amount;
-```
-
-**سوال**: 
- آیا Balance = پول کاربر برای خرید محصولات؟
- آیا پول خرید پکیج طلایی باید به Balance برگردد؟
- اگر بله، پس **کاربر پکیج طلایی را رایگان می‌خرد!** (پول برمی‌گردد به Balance)
-
-#### مشکل:
-**احتمال 1**: Logic اشتباه است - نباید پول به Balance برگردد
-**احتمال 2**: Balance برای چیز دیگری است و مستندات ناقص است
-
---
-
-### 4. ❌ **تناقض در Transactions و UserOrder**
-
-#### جداول فعلی:
-```csharp
-// Transactions.cs
-public class Transactions
-{
-    public long Amount { get; set; }
-    public PaymentStatus PaymentStatus { get; set; }
-    public string? RefId { get; set; }
-    public TransactionType Type { get; set; }
-    
-    // Navigation
-    public virtual ICollection<UserOrder> UserOrders { get; set; }  // ❓ یک تراکنش چند سفارش؟
-}
-
-// UserOrder (موجود در کد قبلی)
-// شامل: TotalAmount, Status, ProductId, etc
-```
-
-#### سوالات:
-1. **یک Transaction چند UserOrder دارد؟**
-   - اگر بله: چرا؟ معمولاً یک تراکنش = یک سفارش
-   - اگر خیر: چرا `ICollection` است؟
-
-2. **UserOrder خودش Amount دارد یا از Transaction می‌گیرد؟**
-   - اگر دوتا Amount جدا باشند: ممکن است inconsistent شوند
-   - اگر یکی باشند: چرا دوجا ذخیره می‌شود؟
-
-3. **رابطه Transactions → UserOrders چیست؟**
-   - One-to-Many: یک پرداخت برای چند سفارش (مثلاً سبد خرید)
-   - One-to-One: یک پرداخت برای یک سفارش
-   - فعلاً مشخص نیست!
-
---
-
-### 5. ❌ **Commission Payout و Withdrawal Method دوباره در UserCommissionPayout**
-
-#### Entity فعلی:
-```csharp
-public class UserCommissionPayout
-{
-    public CommissionPayoutStatus Status { get; set; }  // وضعیت پرداخت
-    public WithdrawalMethod? WithdrawalMethod { get; set; }  // روش برداشت
-    public string? IbanNumber { get; set; }
-    public DateTime? WithdrawnAt { get; set; }
-    public string? ProcessedBy { get; set; }
-    public string? BankReferenceId { get; set; }
-    public string? PaymentFailureReason { get; set; }
-}
-```
-
-#### مشکل:
-این Entity هم **وظیفه محاسبه کمیسیون** و هم **وظیفه برداشت** را دارد.
-
-**اصل Single Responsibility نقض شده است!**
-
-#### راه‌حل پیشنهادی:
-```csharp
-// جداسازی:
-public class UserCommissionPayout  // فقط کمیسیون
-{
-    public long UserId { get; set; }
-    public string WeekNumber { get; set; }
-    public int BalancesEarned { get; set; }
-    public long TotalAmount { get; set; }
-    public CommissionStatus Status { get; set; }  // Calculated/Paid
-    public DateTime? PaidAt { get; set; }
-}
-
-public class CommissionWithdrawalRequest  // فقط برداشت
-{
-    public long CommissionPayoutId { get; set; }
-    public long UserId { get; set; }
-    public WithdrawalMethod Method { get; set; }
-    public string? IbanNumber { get; set; }
-    public WithdrawalStatus Status { get; set; }
-    public string? ProcessedBy { get; set; }
-    public DateTime? ProcessedAt { get; set; }
-}
-```
-
---
-
-### 6. ❌ **NetworkBalance: قفل یا آزاد؟**
-
-#### مستندات می‌گوید:
-```
-NetworkBalance: موجودی شبکه/کارمزد (قابل برداشت نقدی یا خرید الماس)
-```
-
-#### اما:
- در کد، **NetworkBalance مستقیماً قابل برداشت نیست**
- باید **RequestWithdrawal** زد و **ادمین تایید کند**
- پس واقعاً "قفل" است تا زمان تایید
-
-#### پیشنهاد:
-نام را تغییر بدهیم به:
-```csharp
-public long CommissionBalance { get; set; }  // واضح‌تر
-// یا
-public long LockedCommissionBalance { get; set; }  // صریح‌تر
-```
-
---
-
-### 7. ❌ **TransactionType ناقص است**
-
-#### TransactionType فعلی:
-```csharp
-public enum TransactionType
-{
-    Buy = 0,
-    DepositIpg = 1,
-    DepositExternal1 = 2,
-    Withdraw = 3,
-    NetworkCommission = 10,
-    ClubActivation = 11,
-    DiscountWalletCharge = 12,
-}
-```
-
-#### مشکل:
-**Phase 9 (Club Discount Shop)** نیاز به TransactionType جدید دارد:
- ❌ `DiscountPurchase`: خرید با پرداخت ترکیبی (DiscountBalance + Gateway)
- ❌ `DiscountDeduction`: کسر از DiscountBalance
- ❌ `DiscountRefund`: برگشت تخفیف (در صورت لغو)
-
---
-
-### 8. ❌ **PackagePurchaseMethod در User Entity**
-
-#### کد فعلی:
-```csharp
-// User.cs
-public PackagePurchaseMethod PackagePurchaseMethod { get; set; } = PackagePurchaseMethod.None;
-```
-
-#### مشکل:
- این فیلد **فقط یکبار** مقداردهی می‌شود
- اگر کاربر بخواهد **دوباره** پکیج بخرد چی؟
- اگر چند پکیج مختلف داشته باشیم چی؟
-
-#### راه‌حل پیشنهادی:
-```csharp
-// باید به ClubMembership منتقل شود:
-public class ClubMembership
-{
-    public long UserId { get; set; }
-    public PackagePurchaseMethod PurchaseMethod { get; set; }  // اینجا بهتر است
-    public DateTime PurchasedAt { get; set; }
-    // ...
-}
-
-// و User فقط:
-public bool HasPurchasedGoldenPackage { get; set; }  // flag ساده
-```
-
---
-
-## 🟡 مشکلات متوسط (Medium Issues)
-
-### 9. ⚠️ **UserWalletChangeLog: فقط 2 فیلد ثبت می‌شود**
-
-#### فعلی:
-```csharp
-public long CurrentBalance { get; set; }
-public long CurrentNetworkBalance { get; set; }
-// ❌ CurrentDiscountBalance ندارد
-```
-
-#### باید باشد:
-```csharp
-public long CurrentBalance { get; set; }
-public long CurrentNetworkBalance { get; set; }
-public long CurrentDiscountBalance { get; set; }  // ⬅️ اضافه شود
-```
-
---
-
-### 10. ⚠️ **CommissionPayoutHistory: فقط Amount و Status ثبت می‌شود**
-
-#### فعلی:
-```csharp
-public class CommissionPayoutHistory
-{
-    public long AmountBefore { get; set; }
-    public long AmountAfter { get; set; }
-    public CommissionPayoutStatus OldStatus { get; set; }
-    public CommissionPayoutStatus NewStatus { get; set; }
-    // ❌ WithdrawalMethod, IbanNumber, BankReferenceId ثبت نمی‌شوند
-}
-```
-
-#### پیشنهاد:
-```csharp
-public string? WithdrawalMethod { get; set; }  // Diamond/Cash
-public string? IbanNumber { get; set; }
-public string? BankReferenceId { get; set; }
-public string? FailureReason { get; set; }
-```
-
---
-
-### 11. ⚠️ **WeeklyCommissionPool: TotalPoolAmount از کجا می‌آید؟**
-
-#### Entity:
-```csharp
-public class WeeklyCommissionPool
-{
-    public long TotalPoolAmount { get; set; }  // ❓ از کجا محاسبه می‌شود؟
-    public int TotalBalances { get; set; }
-    public long ValuePerBalance { get; set; }
-}
-```
-
-#### سوال:
-**TotalPoolAmount چطوری محاسبه می‌شود؟**
-
-از مستندات:
-```
-TotalPoolAmount = مجموع خریدهای هفته × 20%
-```
-
-**اما**:
- ❌ هیچ رابطه‌ای با `UserOrder` یا `Transactions` نداریم
- ❌ محاسبه Pool از کدام جدول انجام می‌شود؟
- ❌ آیا باید `WeeklyPurchaseSummary` جدا باشد؟
-
---
-
-### 12. ⚠️ **User.NetworkParentId vs User.ParentId**
-
-#### Entity:
-```csharp
-public class User
-{
-    public long? ParentId { get; set; }         // والد معمولی
-    public long? NetworkParentId { get; set; }  // والد در شبکه باینری
-}
-```
-
-#### سوال:
-**چه فرقی دارند؟**
-
- `ParentId`: اولین معرف (Sponsor)
- `NetworkParentId`: والد در درخت باینری
-
-#### مشکل:
-اگر **یک نفر** معرف کند اما در **شبکه زیر شخص دیگری** قرار بگیرد:
- `ParentId = A` (معرف)
- `NetworkParentId = B` (در شبکه)
-
-**آیا این scenario واقعاً اتفاق می‌افتد؟**
-
-اگر بله:
- ✅ طراحی درست است
- ❌ باید مستندسازی بهتری داشته باشد
-
-اگر خیر:
- ❌ `ParentId` اضافی است، همیشه = `NetworkParentId`
-
---
-
-## 🟢 نکات مثبت (Good Practices)
-
-### ✅ چیزهایی که خوب طراحی شدند:
-
-1. **Clean Architecture**: لایه‌بندی واضح Domain/Application/Infrastructure
-2. **History Tables**: CommissionPayoutHistory برای Audit
-3. **Enum Usage**: TransactionType, CommissionStatus واضح هستند
-4. **Navigation Properties**: روابط Entity Framework به خوبی تعریف شدند
-5. **DateTime Tracking**: CreatedAt, PaidAt, WithdrawnAt همه ثبت می‌شوند
-6. **Nullable Fields**: فیلدهای اختیاری به درستی `?` دارند
-
---
-
-## 📊 آمار بررسی جامع (2024-12-03)
-
-### ✅ موارد بررسی شده:
-
-**1. Entity ها:**
- ✅ 38 Entity بررسی شد
- ✅ هیچ Entity تکراری یافت نشد
- ❌ 1 Entity با نام غلط: `ProductGallerys` (باید ProductGalleries)
-
-**2. DbSet ها:**
- ✅ 38 DbSet در IApplicationDbContext
- ✅ همه DbSet ها Entity متناظر دارند
- ✅ نامگذاری DbSet ها اصلاح شد (حذف 's' های اضافی)
-
-**3. Configuration ها:**
- ✅ 37 Configuration file بررسی شد
- ✅ همه Entity ها Configuration دارند
- ✅ نامگذاری Configuration ها صحیح است
-
-**4. CQ Folders:**
- ✅ 21 CQ folder بررسی شد
- ✅ هیچ تکراری یافت نشد
- ✅ ProductCQ به ProductsCQ merge شد
- ℹ️ WalletCQ برای Discount Wallet است (درست)
- ℹ️ UserPackagePurchaseCQ وجود ندارد (نیازی نیست)
-
-**5. Event Folders:**
- ✅ 21 Event folder بررسی شد
- ✅ همه با Entity های مرتبط مطابقت دارند
- ❌ ProductGallerysEvents باید ProductGalleriesEvents باشد
-
-**6. Proto Files:**
- ✅ 26 Proto file بررسی شد
- ✅ همه Service های مرتبط دارند
- ℹ️ public_messages.proto برای shared messages است (Service ندارد)
-
-**7. WebApi Services:**
- ✅ 25 Service file بررسی شد
- ✅ همه با Proto های مرتبط مطابقت دارند
-
-### 📈 نتیجه کلی:
-
-| بخش | وضعیت | تعداد فایل | مشکلات |
-|-----|-------|-----------|---------|
-| Entity ها | 🟡 | 38 | 1 نام غلط |
-| DbSet ها | ✅ | 38 | اصلاح شد |
-| Configuration ها | ✅ | 37 | هیچ مشکلی |
-| CQ Folders | ✅ | 21 | اصلاح شد |
-| Event Folders | 🟡 | 21 | 1 نام غلط |
-| Proto Files | ✅ | 26 | هیچ مشکلی |
-| Services | ✅ | 25 | هیچ مشکلی |
-| **مجموع** | **🟡** | **226** | **1 تناقض مهم** |
-
---
-
-## 📋 اقدامات پیشنهادی (Action Items)
-
-### 🔴 اولویت بالا (قبل از Phase 9):
-
-1. ✅ **~~اضافه کردن `CurrentDiscountBalance` به UserWalletChangeLog~~** - به Phase 9 موکول شد
-   ```csharp
-   // Migration جدید
-   ALTER TABLE UserWalletChangeLog ADD CurrentDiscountBalance BIGINT NOT NULL DEFAULT 0;
-   ```
-
-2. ✅ **جداسازی UserCommissionPayout و CommissionWithdrawalRequest**
-   - UserCommissionPayout: فقط کمیسیون
-   - CommissionWithdrawalRequest: فقط برداشت
-
-3. ✅ **اضافه کردن TransactionType برای Phase 9**
-   ```csharp
-   DiscountPurchase = 13,
-   DiscountDeduction = 14,
-   DiscountRefund = 15,
-   ```
-
-4. ✅ **بررسی و مستندسازی تفاوت Balance و NetworkBalance**
-   - آیا 3 کیف پول مجزا هستند یا یکی؟
-   - منطق شارژ سه‌گانه چیست؟
-
-5. ✅ **حذف یا توضیح wallet.Balance += order.Amount در VerifyGoldenPackagePurchase**
-   - چرا پول برمی‌گردد؟
-   - آیا این intentional است؟
-
---
-
-### 🟡 اولویت متوسط (Technical Debt):
-
-6. ⚠️ **Refactoring ProductGallerys → ProductGalleries**
-   - 📅 زمان تخمینی: 2-3 ساعت
-   - 📦 Scope: CMS + BackOffice.BFF
-   - ⚠️ Risk: متوسط (100+ فایل)
-   - 💡 Approach: استفاده از Find & Replace با دقت بالا
-
-7. ⚠️ **مستندسازی ParentId vs NetworkParentId**
-8. ⚠️ **محاسبه TotalPoolAmount را واضح کنیم**
-9. ⚠️ **بررسی رابطه Transaction → UserOrder** (One-to-Many چرا؟)
-
---
-
-### 🟢 اولویت پایین (Nice to Have):
-
-10. 💡 Rename `NetworkBalance` → `CommissionBalance` یا `LockedCommissionBalance`
-11. 💡 انتقال `PackagePurchaseMethod` از User به ClubMembership
-12. 💡 اضافه کردن فیلدهای بیشتر به CommissionPayoutHistory
-
---
-
-## 🎯 تغییرات انجام شده (Changelog - 2024-12-03)
-
-### 🔧 Refactoring های بزرگ:
-
-1. **اصلاح نامگذاری DbSet ها** - ✅ Complete
-   - 10 DbSet property اصلاح شد
-   - تمام navigation properties در Entity ها به‌روز شدند
-   
-2. **اصلاح غلط املایی Pruduct → Product** - ✅ Complete
-   - 2 Entity class (PruductTag, PruductCategory)
-   - 2 Configuration class
-   - 2 Event folder
-   - 2 Proto file
-   - 2 WebApi Service
-   - 50+ CQRS Handler files
-
-3. **حذف Duplicate ها** - ✅ Complete
-   - ProductCQ merged into ProductsCQ
-   - CreateTag command removed (duplicate)
-
-4. **Batch Operations** - ✅ Complete
-   - 100+ handler files updated via `sed` automation
-   - Zero manual errors
-
-### 📊 آمار تغییرات:
-
- **تعداد فایل های ویرایش شده**: 150+
- **تعداد فولدرهای تغییر نام داده شده**: 15+
- **خطوط کد تغییر یافته**: 500+
- **Build Status**: ✅ 0 Errors
- **زمان صرف شده**: 4 ساعت
- **Quality Improvement**: +30%
-
---
-
-## 🎯 سوالات کلیدی برای تصمیم‌گیری
-
-1. ❓ **آیا Balance، NetworkBalance، DiscountBalance سه کیف پول مجزا هستند؟**
-   - اگر بله: مستندسازی شود
-   - اگر خیر: کد شارژ اشتباه است
-
-2. ❓ **چرا در VerifyGoldenPackagePurchase پول به Balance برمی‌گردد؟**
-   - آیا intentional است؟
-   - آیا باید به NetworkBalance برود؟
-
-3. ❓ **ParentId برای چیست؟ چه تفاوتی با NetworkParentId دارد؟**
-   - آیا scenario واقعی دارد؟
-   - آیا باید حذف شود؟
-
-4. ❓ **TotalPoolAmount از کجا محاسبه می‌شود؟**
-   - آیا باید از UserOrder محاسبه شود؟
-   - آیا باید جدول جدیدی باشد؟
-
-5. ❓ **آیا UserCommissionPayout باید به دو Entity جدا شود؟**
-   - Payout (محاسبه)
-   - WithdrawalRequest (برداشت)
-
---
-
-## 📝 نتیجه‌گیری
-
-**وضعیت کلی**: 🟢 **خوب - اکثر مشکلات برطرف شد**
-
-**امتیاز طراحی**: **8.5/10** (قبلاً 7/10)
-
-**نقاط قوت**:
- ✅ Clean Architecture
- ✅ Entity Relationships
- ✅ History/Audit Tables
- ✅ نامگذاری DbSet ها اصلاح شد
- ✅ حذف Duplicate ها
- ✅ Build بدون Error
-
-**نقاط ضعف**:
- ❌ Entity `ProductGallerys` هنوز با نام اشتباه (تنها مشکل باقیمانده)
- ⚠️ UserWalletChangeLog ناقص (بدون DiscountBalance) - Phase 9
- ⚠️ UserCommissionPayout چند مسئولیت دارد - نیاز به refactor
- ⚠️ TransactionType ناقص - Phase 9
-
-**بهبودها نسبت به نسخه قبل**:
- ✅ +150 فایل اصلاح شد
- ✅ +15 فولدر reorganize شد
- ✅ حذف تمام تکراری‌ها
- ✅ یکپارچه‌سازی نامگذاری
- ✅ کد clean و maintainable تر شد
-
-**توصیه**: 
-✅ پروژه آماده برای ادامه Phase 9 است.  
-⚠️ فقط یک Technical Debt باقیمانده: Refactoring ProductGallerys → ProductGalleries
-
---
-
-**تهیه‌کننده**: AI Analysis  
-**تاریخ ایجاد**: 2024-12-02  
-**آخرین به‌روزرسانی**: 2024-12-03  
-**نسخه**: 2.0 (Major Update)
-
---
-
-## 📎 پیوست: Technical Debt Register
-
-| شناسه | عنوان | اولویت | تخمین زمان | وضعیت | تاریخ |
-|-------|-------|--------|------------|--------|-------|
-| TD-001 | ~~ProductGallerys → ProductGalleries~~ | متوسط | 45 دقیقه | ✅ Done | 2024-12-03 |
-| TD-002 | UserWalletChangeLog.CurrentDiscountBalance | بالا | 30 دقیقه | 🟡 Phase 9 | - |
-| TD-003 | Split UserCommissionPayout | پایین | 2 ساعت | 🔵 Backlog | - |
-| TD-004 | Add TransactionType for Phase 9 | بالا | 15 دقیقه | 🟡 Phase 9 | - |
-| TD-005 | Document ParentId vs NetworkParentId | پایین | 1 ساعت | 🔵 Backlog | - |
-| **TD-006** | **~~UserCarts → UserCart~~** | **🔴 فوری** | **30 دقیقه** | **✅ Done** | **2024-12-03** |
-| **TD-007** | **~~ProductImages → ProductImage~~** | **🔴 فوری** | **30 دقیقه** | **✅ Done** | **2024-12-03** |
-| **TD-008** | **~~ProductGalleries → ProductGallery~~** | **🔴 فوری** | **30 دقیقه** | **✅ Done** | **2024-12-03** |
-| **TD-009** | **~~Products → Product~~** | **🔴 فوری** | **45 دقیقه** | **✅ Done** | **2024-12-03** |
-| **TD-010** | **~~Transactions → Transaction~~** | **🔴 فوری** | **45 دقیقه** | **✅ Done** | **2024-12-03** |
-
-**مجموع زمان صرف شده**: 3 ساعت (Entity Naming Convention Refactoring)  
-**اولویت کلی**: ✅ تکمیل شده
-
---
-
-## 📊 آمار Refactoring (به‌روزرسانی نهایی 2024-12-03)
-
-### ✅ موارد انجام شده:
-
-**Refactoring Round 1** (2024-12-02):
- 10 DbSet property اصلاح شد
- 2 Entity typo (Pruduct) اصلاح شد
- 150+ فایل ویرایش شد
- 15+ فولدر تغییر نام یافت
- 2 Duplicate folder حذف شد
-
-**Refactoring Round 2** (2024-12-03 صبح):
- ProductGallerys → ProductGalleries ✅
- 100+ فایل تغییر نام یافت
-
-**Refactoring Round 3** (2024-12-03 بعدازظهر):
- 5 Entity Naming Convention اصلاح شد ✅
- 1075+ کد به‌روز شد
- 200+ فایل تغییر یافت
- Build: 0 errors
- Build: 0 Error, 0 Warning ✅
-
-**مجموع**: 250+ فایل اصلاح شده
-
-### 🔄 در حال انجام:
-
-**Refactoring Round 3** (2024-12-03 - در حال انجام):
- Entity Naming Convention Fix
- 5 Entity: Plural → Singular
- 400+ فایل تحت تاثیر
- زمان تخمینی: 4-5 ساعت
-
-````
-
-6. ⚠️ **Refactoring ProductGallerys → ProductGalleries**
-   - 📅 زمان تخمینی: 2-3 ساعت
-   - 📦 Scope: CMS + BackOffice.BFF
-   - ⚠️ Risk: متوسط (100+ فایل)
-   - 💡 Approach: استفاده از Find & Replace با دقت بالا
-
-7. ⚠️ **مستندسازی ParentId vs NetworkParentId**
-8. ⚠️ **محاسبه TotalPoolAmount را واضح کنیم**
-9. ⚠️ **بررسی رابطه Transaction → UserOrder** (One-to-Many چرا؟)
-
---
-
-### 🟢 اولویت پایین (Nice to Have):
-
-10. 💡 Rename `NetworkBalance` → `CommissionBalance` یا `LockedCommissionBalance`
-11. 💡 انتقال `PackagePurchaseMethod` از User به ClubMembership
-12. 💡 اضافه کردن فیلدهای بیشتر به CommissionPayoutHistory
-
---
-
-## 🎯 تغییرات انجام شده (Changelog - 2024-12-03)
-
-### 🔧 Refactoring های بزرگ:
-
-1. **اصلاح نامگذاری DbSet ها** - ✅ Complete
-   - 10 DbSet property اصلاح شد
-   - تمام navigation properties در Entity ها به‌روز شدند
-   
-2. **اصلاح غلط املایی Pruduct → Product** - ✅ Complete
-   - 2 Entity class (PruductTag, PruductCategory)
-   - 2 Configuration class
-   - 2 Event folder
-   - 2 Proto file
-   - 2 WebApi Service
-   - 50+ CQRS Handler files
-
-3. **حذف Duplicate ها** - ✅ Complete
-   - ProductCQ merged into ProductsCQ
-   - CreateTag command removed (duplicate)
-
-4. **Batch Operations** - ✅ Complete
-   - 100+ handler files updated via `sed` automation
-   - Zero manual errors
-
-### 📊 آمار تغییرات:
-
- **تعداد فایل های ویرایش شده**: 150+
- **تعداد فولدرهای تغییر نام داده شده**: 15+
- **خطوط کد تغییر یافته**: 500+
- **Build Status**: ✅ 0 Errors
- **زمان صرف شده**: 4 ساعت
- **Quality Improvement**: +30%
-
---
-
-## 🎯 سوالات کلیدی برای تصمیم‌گیری
-
-1. ❓ **آیا Balance، NetworkBalance، DiscountBalance سه کیف پول مجزا هستند؟**
-   - اگر بله: مستندسازی شود
-   - اگر خیر: کد شارژ اشتباه است
-
-2. ❓ **چرا در VerifyGoldenPackagePurchase پول به Balance برمی‌گردد؟**
-   - آیا intentional است؟
-   - آیا باید به NetworkBalance برود؟
-
-3. ❓ **ParentId برای چیست؟ چه تفاوتی با NetworkParentId دارد؟**
-   - آیا scenario واقعی دارد؟
-   - آیا باید حذف شود؟
-
-4. ❓ **TotalPoolAmount از کجا محاسبه می‌شود؟**
-   - آیا باید از UserOrder محاسبه شود؟
-   - آیا باید جدول جدیدی باشد؟
-
-5. ❓ **آیا UserCommissionPayout باید به دو Entity جدا شود؟**
-   - Payout (محاسبه)
-   - WithdrawalRequest (برداشت)
-
---
-
-## 📝 نتیجه‌گیری
-
-**وضعیت کلی**: 🟡 **قابل قبول اما نیاز به اصلاح دارد**
-
-**امتیاز طراحی**: **7/10**
-
-**نقاط قوت**:
- ✅ Clean Architecture
- ✅ Entity Relationships
- ✅ History/Audit Tables
-
-**نقاط ضعف**:
- ❌ UserWalletChangeLog ناقص (بدون DiscountBalance)
- ❌ تناقض در Balance vs NetworkBalance
- ❌ UserCommissionPayout چند مسئولیت دارد
- ❌ TransactionType ناقص
-
-**توصیه**: 
-قبل از شروع Phase 9، حتماً موارد اولویت بالا را بررسی و اصلاح کنید تا در آینده مشکل نداشته باشید.
-
---
-
-**تهیه‌کننده**: AI Analysis  
-**تاریخ**: 2024-12-02  
-**نسخه**: 1.0
@@ -1,113 +0,0 @@
-# 📦 آرشیو مستندات قدیمی
-
-**تاریخ آرشیو**: ۱۴ آذر ۱۴۰۴ (December 4, 2024)  
-**دلیل**: تجمیع و بازسازی ساختار مستندات پروژه FourSat
-
---
-
-## 🗂️ فایل‌های آرشیو شده
-
-### 1. `REMAINING-TASKS-OLD-2024-12-02.md`
- **دلیل آرشیو**: این فایل در خود متن خود را منسوخ اعلام کرده است
- **جایگزین**: `05-TASKS/BACKLOG.md` (از REMAINING-TASKS-CONSOLIDATED.md)
- **حجم**: 1,556 خط
- **محتوا**: Task های قدیمی که به CONSOLIDATED منتقل شدند
-
-### 2. `network-club-commission-system-OLD.md`
- **دلیل آرشیو**: نسخه قدیمی‌تر سند Network & Commission
- **جایگزین**: `01-BUSINESS/network-commission-system.md` (نسخه v1.1)
- **حجم**: 1,958 خط
- **محتوا**: نسخه اولیه سند که بعداً به v1.1 خلاصه‌تر شد
-
-### 3. `implementation-progress-fa-OLD.md`
- **دلیل آرشیو**: ترجمه فارسی ناقص از نسخه انگلیسی
- **جایگزین**: `03-BACKEND/CMS/implementation-status.md` (نسخه انگلیسی کامل)
- **حجم**: 1,499 خط
- **محتوا**: نسخه فارسی implementation-progress که بروزرسانی نشد
-
-### 4. `monitoring-alerts-partial-OLD.md`
- **دلیل آرشیو**: گزارش اولیه ناقص Monitoring System
- **جایگزین**: فعلاً در `CMS/monitoring-alerts-consolidated-report.md` (در ساختار قدیم)
- **حجم**: 334 خط
- **محتوا**: Skeleton اولیه که بعداً به consolidated report تبدیل شد
-
-### 5. `BACKOFFICE-UI-STATUS-OLD.md`
- **دلیل آرشیو**: منتقل به ساختار جدید
- **جایگزین**: `04-FRONTEND/BackOffice/ui-status.md`
- **حجم**: 590 خط
- **محتوا**: وضعیت صفحات BackOffice
-
-### 6. `BUSINESS-VERIFICATION-TEMPLATE-OLD.md`
- **دلیل آرشیو**: منتقل به ساختار جدید
- **جایگزین**: `05-TASKS/verification-template.md`
- **حجم**: متوسط
- **محتوا**: چک‌لیست QA و تست
-
-### 7. `CMS-API-COVERAGE-OLD.md`
- **دلیل آرشیو**: منتقل به ساختار جدید
- **جایگزین**: `03-BACKEND/CMS/api-coverage.md`
- **حجم**: متوسط
- **محتوا**: لیست کامل API های CMS
-
-### 8. `QUICK-START-DEVELOPMENT-OLD.md`
- **دلیل آرشیو**: منتقل به ساختار جدید
- **جایگزین**: `06-DEPLOYMENT/quick-start.md`
- **حجم**: متوسط
- **محتوا**: راهنمای Setup محیط توسعه
-
-### 9. `DELIVERY-READINESS-REPORT-OLD.md`
- **دلیل آرشیو**: منتقل به ساختار جدید
- **جایگزین**: `06-DEPLOYMENT/delivery-readiness.md`
- **حجم**: متوسط
- **محتوا**: چک‌لیست آمادگی Production
-
-### 10. `REMAINING-TASKS-CONSOLIDATED-OLD.md`
- **دلیل آرشیو**: منتقل به ساختار جدید و تقسیم شد
- **جایگزین**: `05-TASKS/BACKLOG.md` و `05-TASKS/CURRENT-SPRINT.md`
- **حجم**: 1,410 خط
- **محتوا**: Task های جامع که به Sprint و Backlog تقسیم شدند
-
---
-
-## ℹ️ نحوه استفاده از آرشیو
-
-اگر نیاز به مراجعه به نسخه‌های قدیمی داشتید:
-1. تمام فایل‌های آرشیو شده **فقط خواندنی** هستند
-2. برای یافتن نسخه جدید، به **جایگزین** در بالا مراجعه کنید
-3. در صورت نیاز به بازیابی، با تیم مدیریت مستندات تماس بگیرید
-
---
-
-### 11. `ANALYSIS-CONTRADICTIONS-AND-ISSUES.md`
- **دلیل آرشیو**: سند تحلیلی قدیمی
- **جایگزین**: مشکلات شناسایی شده حل شدند
- **حجم**: 929 خط
- **محتوا**: تحلیل تناقضات و مشکلات اولیه سیستم
-
-### 12. `ENTITY-NAMING-REFACTORING-PLAN.md`
- **دلیل آرشیو**: طرح Refactoring انجام شده
- **جایگزین**: Entity ها با نام‌های جدید در `03-BACKEND/CMS/entity-guide.md`
- **حجم**: متوسط
- **محتوا**: طرح تغییر نام Entity ها
-
-### 13. `monitoring-alerts-consolidated-report.md`
- **دلیل آرشیو**: گزارش قدیمی Monitoring System
- **جایگزین**: سیستم Monitoring پیاده‌سازی شده
- **حجم**: 732 خط
- **محتوا**: گزارش جامع Monitoring & Alerts
-
---
-
-## 📊 آمار آرشیو
-
- **تعداد فایل‌های آرشیو شده**: 15 فایل
- **دسته منسوخ**: 7 فایل (تکراری/قدیمی)
- **دسته منتقل شده**: 6 فایل (به ساختار جدید)
- **دسته تحلیلی**: 3 فایل (انجام شده)
- **کاهش حجم Root**: ~80% (از 11 فایل به 5 فایل)
- **کاهش کل فایل‌ها**: 28.5% (از 77 به 55 فایل)
- **بهبود سازماندهی**: ✅ Complete
-
---
-
-**نکته**: این آرشیو فقط برای حفظ تاریخچه است. تمام محتوای مهم در نسخه‌های جدید موجود است.
@@ -1,590 +0,0 @@
-# گزارش وضعیت UI پنل مدیریت (BackOffice)
-
-تاریخ گزارش: 2024-12-04
-وضعیت کلی: **آماده برای Production - 95% کامل** 🎉
-
---
-
-## 📊 خلاصه آماری
-
-| بخش | تعداد موارد | وضعیت |
-|-----|-------------|-------|
-| صفحات موجود قبلی | 56 صفحه | ✅ آماده |
-| صفحات جدید | 4 صفحه | ✅ کامل |
-| Services Backend | 8 فایل (4 Interface + 4 Implementation) | ✅ کامل |
-| Dialog Components | 6 کامپوننت | ✅ کامل |
-| اتصالات CRUD | همه عملیات | ✅ کامل |
-| **جمع کل** | **60 صفحه + 8 سرویس + 6 دیالوگ** | **95% آماده** 🎉 |
-
---
-
-## ✅ صفحات موجود و آماده (56 صفحه)
-
-### 1. داشبورد و نمای کلی
- ✅ Dashboard/Index.razor - داشبورد اصلی
- ✅ Dashboard/Overview - نمای کلی سیستم
-
-### 2. کمیسیون (4 صفحه)
- ✅ Commission/Dashboard.razor - داشبورد کمیسیون
- ✅ Commission/Reports.razor - گزارش‌های هفتگی
- ✅ Commission/Payouts.razor - پرداخت کاربران
- ✅ Commission/Withdrawals.razor - درخواست‌های برداشت
-
-### 3. شبکه (3 صفحه)
- ✅ Network/Tree.razor - درخت شبکه
- ✅ Network/Balances.razor - گزارش موجودی‌ها
- ✅ Network/Statistics.razor - آمار شبکه
-
-### 4. باشگاه (2 صفحه)
- ✅ Club/Members.razor - اعضای باشگاه
- ✅ Club/Statistics.razor - آمار باشگاه
-
-### 5. مدیریت محصولات و سفارشات (6 صفحه)
- ✅ Package/ - مدیریت پکیج‌ها
- ✅ Products/ProductsMainPage.razor - مدیریت محصولات
- ✅ Products/ProductCategoriesDragDropPage.razor - مدیریت دسته‌بندی محصولات
- ✅ Category/ - مدیریت دسته‌بندی‌ها
- ✅ UserOrder/ - مدیریت سفارشات
- ✅ Products/Components/ - کامپوننت‌های محصول
-
-### 6. مدیریت کاربران و نقش‌ها (4 صفحه)
- ✅ User/ - مدیریت کاربران
- ✅ UserRole/ - مدیریت نقش کاربران
- ✅ Role/ - مدیریت نقش‌ها
- ✅ UserAddress/ - مدیریت آدرس‌های کاربران
-
-### 7. سیستم و تنظیمات (5 صفحه)
- ✅ SystemManagement/ - مدیریت سیستم
- ✅ Settings/ - تنظیمات
- ✅ Login/ - صفحه ورود
- ✅ System/Alerts.razor - مدیریت هشدارها
- ✅ System/Health.razor - سلامت سیستم
-
-### 8. کامپوننت‌های عمومی
- ✅ AutoComplete/ - کامپوننت‌های AutoComplete
- ✅ Components/ - سایر کامپوننت‌های مشترک
-
---
-
-## 🆕 صفحات جدید ساخته شده (4 صفحه) + Services
-
-### فروشگاه تخفیفی (3 صفحه)
-```
-✅ Pages/DiscountShop/DiscountProductsMainPage.razor
-   - مدیریت محصولات تخفیفی
-   - فیلتر: جستجو، دسته‌بندی، وضعیت، موجودی
-   - CRUD: افزودن، ویرایش، حذف محصول
-   - نمایش: تصویر، قیمت، تخفیف، موجودی، فروش
-   - ✅ متصل به IDiscountProductService
-
-✅ Pages/DiscountShop/DiscountCategoriesMainPage.razor
-   - مدیریت دسته‌بندی‌های فروشگاه تخفیفی
-   - نمایش درختی (Tree View) با سلسله مراتب
-   - CRUD: افزودن دسته/زیردسته، ویرایش، حذف
-   - جستجو در عنوان و توضیحات
-   - ✅ متصل به IDiscountCategoryService
-
-✅ Pages/DiscountShop/DiscountOrdersMainPage.razor
-   - مدیریت سفارشات فروشگاه تخفیفی
-   - فیلتر: جستجو، وضعیت، بازه تاریخ
-   - عملیات: مشاهده جزئیات، تغییر وضعیت سفارش
-   - وضعیت‌ها: در انتظار، پرداخت شده، آماده‌سازی، ارسال، تحویل، لغو، مرجوع
-   - ✅ متصل به IDiscountOrderService
-```
-
-### پیام‌های عمومی (1 صفحه)
-```
-✅ Pages/PublicMessages/PublicMessagesMainPage.razor
-   - مدیریت پیام‌های عمومی (اطلاعیه‌ها، اخبار، هشدارها)
-   - فیلتر: جستجو، وضعیت، نوع پیام
-   - CRUD: ایجاد، ویرایش، حذف پیام
-   - عملیات: انتشار، بایگانی، مشاهده
-   - انواع پیام: اطلاعیه، خبر، هشدار، تبلیغات
-   - وضعیت: پیش‌نویس، منتشر شده، بایگانی شده
-   - ✅ متصل به IPublicMessageService
-```
-
-### 🆕 Services پیاده‌سازی شده (8 فایل)
-
-#### 1. Discount Product Service
-```
-✅ Services/DiscountProduct/IDiscountProductService.cs
-   - Interface: GetProductsAsync, GetByIdAsync, CreateAsync, UpdateAsync, DeleteAsync
-   - DTOs: ProductFilterDto, DiscountProductDto, CreateDiscountProductDto, UpdateDiscountProductDto
-
-✅ Services/DiscountProduct/DiscountProductService.cs
-   - پیاده‌سازی کامل با DiscountProductsContractClient
-   - فیلترینگ سمت سرور
-   - مدیریت تصاویر و تگ‌ها
-```
-
-#### 2. Discount Category Service
-```
-✅ Services/DiscountCategory/IDiscountCategoryService.cs
-   - Interface: GetCategoriesAsync, GetByIdAsync, CreateAsync, UpdateAsync, DeleteAsync
-   - DTOs: DiscountCategoryDto, CreateDiscountCategoryDto, UpdateDiscountCategoryDto
-
-✅ Services/DiscountCategory/DiscountCategoryService.cs
-   - پیاده‌سازی کامل با DiscountCategoriesContractClient
-   - ساخت ساختار درختی (Tree Structure)
-   - مدیریت Parent-Child relationships
-```
-
-#### 3. Discount Order Service
-```
-✅ Services/DiscountOrder/IDiscountOrderService.cs
-   - Interface: GetOrdersAsync, GetByIdAsync, UpdateStatusAsync
-   - DTOs: OrderFilterDto, DiscountOrderDto, DiscountOrderDetailsDto, OrderItemDto, UpdateOrderStatusDto
-   - Enums: OrderStatus (7 states)
-
-✅ Services/DiscountOrder/DiscountOrderService.cs
-   - پیاده‌سازی کامل با DiscountOrdersContractClient
-   - فیلترینگ پیشرفته (جستجو، وضعیت، بازه تاریخ)
-   - مدیریت آیتم‌های سفارش
-```
-
-#### 4. Public Message Service
-```
-✅ Services/PublicMessage/IPublicMessageService.cs
-   - Interface: GetMessagesAsync, GetByIdAsync, CreateAsync, UpdateAsync, DeleteAsync, PublishAsync, ArchiveAsync
-   - DTOs: MessageFilterDto, PublicMessageDto, PublicMessageDetailsDto, CreatePublicMessageDto, UpdatePublicMessageDto
-   - Enums: MessageType (4 types), MessageStatus (3 states)
-
-✅ Services/PublicMessage/PublicMessageService.cs
-   - پیاده‌سازی کامل با PublicMessagesContractClient
-   - مدیریت چرخه حیات پیام (Draft → Published → Archived)
-   - مدیریت تصاویر، اکشن‌ها و تگ‌ها
-```
-
---
-
-## 📋 منوی ناوبری به‌روز شده
-
-```razor
-NavMenu.razor - آپدیت شده با بخش‌های جدید:
-
-├─ داشبورد
-├─ نمای کلی سیستم
-├─ کمیسیون (4 زیرمنو)
-├─ شبکه (3 زیرمنو)
-├─ باشگاه (2 زیرمنو)
-├─ مدیریت (6 آیتم - Administrator)
-├─ 🆕 فروشگاه تخفیفی (3 زیرمنو - Administrator) ⭐
-│  ├─ محصولات تخفیفی
-│  ├─ دسته‌بندی‌های فروشگاه
-│  └─ سفارشات فروشگاه
-├─ 🆕 پیام‌های عمومی (Administrator) ⭐
-├─ سیستم (3 آیتم - Administrator)
-├─ تنظیمات
-└─ خروج
-```
-
---
-
-## 🎉 مراحل تکمیل شده
-
-### ✅ فاز 1: اتصال Backend - کامل!
-```
-✅ IDiscountProductService + Implementation
-✅ IDiscountCategoryService + Implementation
-✅ IDiscountOrderService + Implementation
-✅ IPublicMessageService + Implementation
-✅ gRPC Client Registration (4 clients)
-✅ DI Configuration
-✅ صفحات متصل به Services
-```
-
-### ✅ فاز 2: Dialog Components - کامل!
-
-#### 1. Discount Shop Dialogs (4 کامپوننت) ✅
-```
-✅ DiscountShop/Components/ProductFormDialog.razor
-   - فرم کامل محصول با validation
-   - مدیریت تصاویر و تگ‌ها
-   - انتخاب دسته‌بندی با Tree View
-   - Create و Edit modes
-
-✅ DiscountShop/Components/CategoryFormDialog.razor
-   - فرم دسته‌بندی با parent selection
-   - Exclude current category در Edit mode
-   - مدیریت ترتیب نمایش
-   - Create و Edit modes
-
-✅ DiscountShop/Components/OrderDetailsDialog.razor
-   - نمایش کامل جزئیات سفارش
-   - اطلاعات خریدار، آدرس، پرداخت
-   - لیست آیتم‌های سفارش با تصاویر
-   - خلاصه مالی و یادداشت ادمین
-
-✅ DiscountShop/Components/ChangeOrderStatusDialog.razor
-   - تغییر وضعیت سفارش (7 حالت)
-   - یادداشت ادمین
-   - هشدارهای مناسب برای هر وضعیت
-   - Validation و UI feedback
-```
-
-#### 2. Public Messages Dialogs (2 کامپوننت) ✅
-```
-✅ PublicMessages/Components/MessageFormDialog.razor
-   - فرم کامل پیام با validation
-   - 4 نوع پیام (اطلاعیه، خبر، هشدار، تبلیغات)
-   - مدیریت تصاویر، اکشن‌ها، تگ‌ها
-   - تاریخ انقضا
-   - گزینه انتشار فوری
-   - Create و Edit modes
-
-✅ PublicMessages/Components/MessageViewDialog.razor
-   - نمایش کامل پیام با فرمت زیبا
-   - نمایش تصویر، محتوا، اکشن
-   - آمار بازدید و اطلاعات تاریخ
-   - تگ‌ها و وضعیت پیام
-   - آیکون‌های مناسب برای هر نوع
-```
-
-### ✅ فاز 3: اتصال Dialogs به صفحات - کامل!
-```
-✅ DiscountProductsMainPage: OpenCreateDialog + OpenEditDialog
-✅ DiscountCategoriesMainPage: OpenCreateDialog + OpenEditDialog (با parent support)
-✅ DiscountOrdersMainPage: OpenOrderDetails + OpenChangeStatusDialog
-✅ PublicMessagesMainPage: OpenCreateDialog + OpenEditDialog + ViewMessage
-✅ همه عملیات CRUD به سرویس‌ها متصل شدند
-✅ Error Handling و User Feedback با Snackbar
-```
-
-## 🔨 کارهای باقی‌مانده (Nice to Have)
-
-### اولویت متوسط (Important)
-
-#### 3. بهبود UI/UX صفحات موجود
-```
-⏸️ Products/ProductsMainPage.razor
-   - افزودن bulk operations (حذف/تغییر وضعیت دسته‌ای)
-   - افزودن export به Excel
-   - بهبود فیلترهای پیشرفته
-
-⏸️ UserOrder/OrdersMainPage.razor
-   - افزودن timeline سفارش
-   - افزودن نمایش نمودار آماری سفارشات
-   - بهبود جستجوی پیشرفته
-```
-
-#### 4. گزارش‌های جدید (2 صفحه)
-```
-⏸️ Commission/Reports/WithdrawalReports.razor
-   - گزارش برداشت‌های کاربران
-   - نمودار روند برداشت‌ها
-   - فیلتر: بازه تاریخ، کاربر، وضعیت
-   - Export به PDF/Excel
-
-⏸️ DiscountShop/Reports/SalesReports.razor
-   - گزارش فروش فروشگاه تخفیفی
-   - نمودار پرفروش‌ترین محصولات
-   - آمار درآمد
-```
-
-### اولویت پایین (Nice to Have)
-
-#### 5. قابلیت‌های اضافی
-```
-⏸️ Dashboard/DiscountShopWidget.razor
-   - ویجت آمار فروشگاه تخفیفی در داشبورد اصلی
-   - نمایش: فروش روزانه، سفارشات جدید، محصولات پرفروش
-
-⏸️ PublicMessages/Templates/
-   - قالب‌های آماده پیام
-   - ذخیره پیام‌های پرکاربرد
-
-⏸️ DiscountShop/Components/ProductImageGallery.razor
-   - گالری تصاویر محصول
-   - Upload multiple images
-   - Drag & drop reorder
-```
-
---
-
-## 🎯 برنامه پیاده‌سازی پیشنهادی
-
-### ✅ فاز 1: اتصال Backend (2 روز) - کامل شد!
-1. **✅ Day 1**: Discount Shop Services
-   - ✅ پیاده‌سازی IDiscountProductService + DiscountProductService
-   - ✅ پیاده‌سازی IDiscountCategoryService + DiscountCategoryService
-   - ✅ پیاده‌سازی IDiscountOrderService + DiscountOrderService
-   - ✅ تست اتصال با BackOffice.BFF
-
-2. **✅ Day 2**: Public Messages Service + Integration
-   - ✅ پیاده‌سازی IPublicMessageService + PublicMessageService
-   - ✅ اتصال CRUD operations
-   - ✅ تست Publish/Archive workflows
-   - ✅ اتصال تمام صفحات به Services
-   - ✅ Registration در DI Container
-   - ✅ gRPC Client Configuration
-
-### فاز 2: Dialog Components (2 روز - Critical) - در حال انتظار
-1. **Day 3**: Discount Shop Dialogs
-   - ProductFormDialog.razor (4 ساعت)
-   - CategoryFormDialog.razor (2 ساعت)
-   - OrderDetailsDialog.razor (2 ساعت)
-
-2. **Day 4**: Remaining Dialogs
-   - ChangeOrderStatusDialog.razor (2 ساعت)
-   - MessageFormDialog.razor (4 ساعت)
-   - MessageViewDialog.razor (2 ساعت)
-
-### فاز 3: بهبودها و گزارش‌ها (1.5 روز - Important)
-1. **Day 5**: UI/UX Enhancements
-   - Bulk operations (3 ساعت)
-   - Export functionality (2 ساعت)
-   - Advanced filters (3 ساعت)
-
-2. **Day 6**: گزارش‌های جدید
-   - WithdrawalReports.razor (4 ساعت)
-   - SalesReports.razor (4 ساعت)
-
-### فاز 4: Extra Features (1 روز - Nice to Have)
-1. **Day 7**: قابلیت‌های اضافی
-   - Dashboard widgets
-   - Message templates
-   - Image gallery component
-
---
-
-## 📈 پیشرفت کلی پروژه
-
-```
-Backend Status:
-├─ CMS Microservice: ████████████████████░ 95% (9 TODO handlers)
-├─ BackOffice.BFF: ███████████████████░░ 85% (8 TODO handlers)
-└─ Discount Shop Backend: ████████████████████ 100% ✅
-
-UI Status:
-├─ Existing Pages: ████████████████████ 100% (56 pages) ✅
-├─ New Pages Created: ████████████████████ 100% (4 pages) ✅
-├─ Service Connections: ████████████████████ 100% (4 services) ✅
-├─ Service Implementation: ████████████████████ 100% (8 files) ✅
-├─ DI Registration: ████████████████████ 100% ✅
-├─ Dialog Components: ████████████████████ 100% (6 components) ✅
-├─ CRUD Operations: ████████████████████ 100% ✅
-└─ Reports & Extras: ░░░░░░░░░░░░░░░░░░░░ 0% (Optional) ⏸️
-
-Overall Progress: ███████████████████░░ 95% Complete (↑ از 85%)
-```
-
---
-
-## 🚀 آماده برای Production
-
-### ✅ آماده الان
- 56 صفحه UI کاملاً عملیاتی
- 4 صفحه جدید با Backend متصل شده
- 4 Service Interface + Implementation کامل
- 4 gRPC Client متصل و عملیاتی
- سیستم احراز هویت و مجوزدهی
- منوی ناوبری کامل با بخش‌های جدید
- MudBlazor UI components
- Responsive design
- فیلترینگ و جستجوی پیشرفته
- عملیات CRUD پایه (List, Delete) عملیاتی
-
-### ⏸️ نیاز به تکمیل
- ساخت 6 Dialog component برای CRUD کامل (2 روز)
- گزارش‌ها و بهبودهای UX (1.5 روز)
- قابلیت‌های اضافی (1 روز)
-## 💡 توصیه‌ها
-
-1. **✅ مرحله 1 کامل شد**: Services به Backend متصل شدند - صفحات آماده نمایش داده
-2. **اولویت فعلی**: ساخت Dialog components - ضروری برای CRUD operations کامل
-3. **Testing**: تست کامل workflows با داده‌های واقعی (در صورت دسترسی به CMS)
-4. **Error Handling**: بررسی Proto field errors در DiscountOrder/DiscountShoppingCart (38 خطا)
-5. **Performance**: بررسی performance با داده‌های واقعی (pagination, caching)
-6. **Documentation**: مستندسازی API endpoints برای هر service ✅ انجام شد
-
---**اولویت دوم**: ساخت Dialog components - ضروری برای CRUD operations
-3. **Testing**: تست کامل workflows قبل از production
-4. **Documentation**: مستندسازی API endpoints برای هر service
-5. **Performance**: بررسی performance با داده‌های واقعی (pagination, caching)
-
---
-## 📝 یادداشت‌های فنی
-
-### ✅ Services پیاده‌سازی شده (4 Interface + 4 Implementation)
-
-```csharp
-// تمام Interfaces و پیاده‌سازی‌ها آماده و در DI ثبت شده‌اند
-
-✅ IDiscountProductService + DiscountProductService
-   - GetProductsAsync(ProductFilterDto) → List<DiscountProductDto>
-   - GetByIdAsync(long) → DiscountProductDto
-   - CreateAsync(CreateDiscountProductDto) → long (ProductId)
-   - UpdateAsync(long, UpdateDiscountProductDto) → Task
-   - DeleteAsync(long) → Task
-
-✅ IDiscountCategoryService + DiscountCategoryService
-   - GetCategoriesAsync(bool?) → List<DiscountCategoryDto> (با Tree Structure)
-   - GetByIdAsync(long) → DiscountCategoryDto
-   - CreateAsync(CreateDiscountCategoryDto) → long (CategoryId)
-   - UpdateAsync(long, UpdateDiscountCategoryDto) → Task
-   - DeleteAsync(long) → Task
-
-✅ IDiscountOrderService + DiscountOrderService
-   - GetOrdersAsync(OrderFilterDto) → List<DiscountOrderDto>
-   - GetByIdAsync(long) → DiscountOrderDetailsDto
-   - UpdateStatusAsync(long, UpdateOrderStatusDto) → Task
-
-✅ IPublicMessageService + PublicMessageService
-   - GetMessagesAsync(MessageFilterDto) → List<PublicMessageDto>
-   - GetByIdAsync(long) → PublicMessageDetailsDto
-   - CreateAsync(CreatePublicMessageDto) → long (MessageId)
-   - UpdateAsync(long, UpdatePublicMessageDto) → Task
-   - DeleteAsync(long) → Task
-   - PublishAsync(long) → Task
-   - ArchiveAsync(long) → Task
-```
-
-### Proto Files موجود
-```
-✅ BackOffice.BFF/Protobufs/DiscountProduct.proto
-✅ BackOffice.BFF/Protobufs/DiscountCategory.proto
-✅ BackOffice.BFF/Protobufs/DiscountOrder.proto
-✅ BackOffice.BFF/Protobufs/DiscountShoppingCart.proto
-✅ BackOffice.BFF/Protobufs/PublicMessage.proto
-```
-
-### gRPC Clients موجود و ثبت شده
-```
-✅ DiscountProductsContractClient (registered in DI)
-✅ DiscountCategoriesContractClient (registered in DI)
-✅ DiscountOrdersContractClient (registered in DI)
-✅ DiscountShoppingCartsContractClient (registered in DI)
-✅ PublicMessagesContractClient (registered in DI)
-```
-
-### Known Issues
-```
-⚠️ Proto Field Errors در DiscountOrder/DiscountShoppingCart:
-   - 38 compile errors مربوط به field naming mismatches
-   - مثال: ShippingAddress, OrderItemDto.Id, DiscountPercent
-   - این خطاها عملکرد Product/Category را تحت تأثیر قرار نمی‌دهند
-   - نیاز به sync کردن Proto schemas با CMS
-```
-
---
-
-**آخرین به‌روزرسانی**: 4 دسامبر 2024  
-**نسخه گزارش**: 3.0 (Final)  
-**وضعیت کلی**: 🟢 95% آماده - **Ready for Production**
-
---
-
-## 🎉 دستاوردهای کل پروژه (3 فاز کامل)
-
-### فاز 1: Backend Services ✅
-1. ✅ **8 فایل Service** پیاده‌سازی شد (4 Interface + 4 Implementation)
-2. ✅ **4 gRPC Client** به DI اضافه شد
-3. ✅ **ConfigureService.cs** آپدیت شد
-4. ✅ **فیلترینگ پیشرفته** با DTOs
-
-### فاز 2: Dialog Components ✅
-5. ✅ **6 Dialog Component** ساخته شد
-6. ✅ **ProductFormDialog**: Create/Edit با validation کامل
-7. ✅ **CategoryFormDialog**: Parent selection + Tree support
-8. ✅ **OrderDetailsDialog**: نمایش کامل جزئیات
-9. ✅ **ChangeOrderStatusDialog**: 7 وضعیت با UI feedback
-10. ✅ **MessageFormDialog**: 4 نوع پیام + تمام فیلدها
-11. ✅ **MessageViewDialog**: نمایش زیبا با آیکون‌ها
-
-### فاز 3: Integration ✅
-12. ✅ **4 صفحه UI** به Services و Dialogs متصل شدند
-13. ✅ عملیات **CRUD کامل**: Create, Read, Update, Delete
-14. ✅ **Error Handling** و **User Feedback** با Snackbar
-15. ✅ **Validation** در تمام فرم‌ها
-16. ✅ **Loading States** و **Progress Indicators**
-
-## 📊 آمار کلی پروژه
-
-```
-✅ تعداد فایل ایجاد شده: 14 فایل
-   ├─ 4 Service Interface
-   ├─ 4 Service Implementation
-   ├─ 6 Dialog Components
-   └─ ConfigureService.cs (Updated)
-
-✅ تعداد صفحه به‌روز شده: 4 صفحه
-   ├─ DiscountProductsMainPage.razor
-   ├─ DiscountCategoriesMainPage.razor
-   ├─ DiscountOrdersMainPage.razor
-   └─ PublicMessagesMainPage.razor
-
-✅ عملیات CRUD پیاده‌سازی شده: 16 operation
-   ├─ Products: List, Create, Read, Update, Delete (5)
-   ├─ Categories: List, Create, Read, Update, Delete (5)
-   ├─ Orders: List, Read, UpdateStatus (3)
-   └─ Messages: List, Create, Read, Update, Delete, Publish, Archive (7)
-
-✅ تعداد خط کد تخمینی: ~2500 خط
-```
-
-**نتیجه نهایی**: سیستم مدیریت کامل BackOffice با 95% پیشرفت آماده برای Production 🚀
-
---
-
-## 🚀 مراحل بعدی (اختیاری)
-
-1. **Testing**: تست عملکرد با داده‌های واقعی از CMS
-2. **UI/UX Polish**: بهبودهای ظاهری و تجربه کاربری
-3. **Reports**: گزارش‌های پیشرفته (optional)
-4. **Performance**: Optimization و Caching
-5. **Documentation**: مستندسازی API برای توسعه‌دهندگان
-
---
-
-## 🎉 دستاوردهای کل پروژه (3 فاز)
-
-### فاز 1: Backend Services ✅
-1. ✅ **8 فایل Service** پیاده‌سازی شد (4 Interface + 4 Implementation)
-2. ✅ **4 gRPC Client** به DI اضافه شد
-3. ✅ **ConfigureService.cs** آپدیت شد
-4. ✅ **فیلترینگ پیشرفته** با DTOs
-
-### فاز 2: Dialog Components ✅
-5. ✅ **6 Dialog Component** ساخته شد
-6. ✅ **ProductFormDialog**: Create/Edit با validation کامل
-7. ✅ **CategoryFormDialog**: Parent selection + Tree support
-8. ✅ **OrderDetailsDialog**: نمایش کامل جزئیات
-9. ✅ **ChangeOrderStatusDialog**: 7 وضعیت با UI feedback
-10. ✅ **MessageFormDialog**: 4 نوع پیام + تمام فیلدها
-11. ✅ **MessageViewDialog**: نمایش زیبا با آیکون‌ها
-
-### فاز 3: Integration ✅
-12. ✅ **4 صفحه UI** به Services و Dialogs متصل شدند
-13. ✅ عملیات **CRUD کامل**: Create, Read, Update, Delete
-14. ✅ **Error Handling** و **User Feedback** با Snackbar
-15. ✅ **Validation** در تمام فرم‌ها
-16. ✅ **Loading States** و **Progress Indicators**
-
-## 📊 آمار کلی پروژه
-
-```
-✅ تعداد فایل ایجاد شده: 14 فایل
-   ├─ 4 Service Interface
-   ├─ 4 Service Implementation
-   ├─ 6 Dialog Components
-   └─ ConfigureService.cs (Updated)
-
-✅ تعداد صفحه به‌روز شده: 4 صفحه
-   ├─ DiscountProductsMainPage.razor
-   ├─ DiscountCategoriesMainPage.razor
-   ├─ DiscountOrdersMainPage.razor
-   └─ PublicMessagesMainPage.razor
-
-✅ عملیات CRUD پیاده‌سازی شده: 16 operation
-   ├─ Products: List, Create, Read, Update, Delete (5)
-   ├─ Categories: List, Create, Read, Update, Delete (5)
-   ├─ Orders: List, Read, UpdateStatus (3)
-   └─ Messages: List, Create, Read, Update, Delete, Publish, Archive (7)
-
-✅ تعداد خط کد تخمینی: ~2500 خط
-```
-
-**نتیجه نهایی**: سیستم مدیریت کامل BackOffice با 95% پیشرفت آماده برای Production 🚀
-
-**وضعیت کلی**: 🟡 در حال تکمیل (70%)
@@ -1,250 +0,0 @@
-# گزارش بررسی تطبیق بیزینس با کد
-
-**تاریخ بررسی**: _________  
-**بررسی‌کننده**: _________  
-**نسخه کد**: _________
-
---
-
-## ✅ بیزینس 1: Binary Tree (درخت دودویی)
-
-### بررسی کد:
-```bash
-# دستور اجرا شده:
-cd CMS/src/CMSMicroservice.Domain/Entities
-grep -A 20 "class User" User.cs | grep -E "Parent|Left|Right"
-```
-
-### نتیجه:
- [ ] ✅ User دارای Parent, LeftChild, RightChild است
- [ ] ✅ Spillover Logic پیاده‌سازی شده
- [ ] ✅ Depth محاسبه می‌شود
- [ ] ✅ Parent تغییر نمی‌کند
-
-### تست عملی:
-```
-ثبت‌نام 7 کاربر:
- User1 (Root)
- User2 (Left of 1)
- User3 (Right of 1)
- User4 (Left of 2) ✓
- User5 (Right of 2) ✓
- User6 (Left of 3) ✓
- User7 (Right of 3) ✓
-
-نتیجه: [✅ موفق] [❌ ناموفق]
-```
-
-### تطبیق با داکیومنت:
- فایل: `totalDoc/CMS/binary-tree-registration-guide.md`
- وضعیت: [✅ تطبیق کامل] [⚠️ نیاز به به‌روزرسانی] [❌ عدم تطبیق]
- توضیحات: _________________
-
---
-
-## 💰 بیزینس 2: محاسبه کمیسیون
-
-### بررسی کد:
-```bash
-# Cron Job
-cd CMS/src/CMSMicroservice.Application/BackgroundWorkers
-grep "Cron.*Sunday" -r .
-
-# فرمول
-grep "TotalPV.*Percentage" -r .
-```
-
-### نتیجه:
- [ ] ✅ Cron: یکشنبه 00:05 UTC
- [ ] ✅ فرمول: Commission = TotalPV × Percentage
- [ ] ✅ MinimumPV چک می‌شود
- [ ] ✅ CarryOver به هفته بعد
- [ ] ✅ MaxCommission رعایت می‌شود
-
-### تست عملی:
-```
-User: TestUser1
-PV این هفته: 1000
-Percentage: 10%
-MinimumPV: 500
-
-محاسبه شده: _______
-انتظار: 100
-
-نتیجه: [✅ موفق] [❌ ناموفق]
-```
-
-### تطبیق با داکیومنت:
- فایل: `totalDoc/CMS/network-club-commission-system-v1.1.md`
- وضعیت: [✅ تطبیق کامل] [⚠️ نیاز به به‌روزرسانی] [❌ عدم تطبیق]
- توضیحات: _________________
-
---
-
-## 🏆 بیزینس 3: سطوح باشگاه
-
-### بررسی کد:
-```bash
-cd CMS/src/CMSMicroservice.Domain/Entities
-grep -A 10 "ClubLevel" ClubMembership.cs
-```
-
-### نتیجه:
- [ ] ✅ 4 سطح: Bronze, Silver, Gold, Platinum
- [ ] ✅ شرط ارتقا پیاده‌سازی شده
- [ ] ✅ سطح پایین نمی‌آید
- [ ] ✅ Duration (ماهانه/سالانه)
-
-### تست عملی:
-```
-User: TestUser2
-PV فعلی: 5000 (Bronze)
-شرط Silver: 10000 PV
-
-بعد از رسیدن به 10000:
- سطح فعلی: _______
- انتظار: Silver
-
-نتیجه: [✅ موفق] [❌ ناموفق]
-```
-
-### تطبیق با داکیومنت:
- فایل: `totalDoc/CMS/network-club-commission-system-v1.1.md`
- وضعیت: [✅ تطبیق کامل] [⚠️ نیاز به به‌روزرسانی] [❌ عدم تطبیق]
- توضیحات: _________________
-
---
-
-## 💳 بیزینس 4: برداشت (Withdrawal)
-
-### بررسی کد:
-```bash
-cd CMS/src/CMSMicroservice.Application/WithdrawalCQ
-ls -1 *Command.cs
-```
-
-### نتیجه:
- [ ] ✅ حداقل موجودی چک می‌شود
- [ ] ✅ کارمزد محاسبه می‌شود
- [ ] ✅ وضعیت‌ها: Pending/Approved/Rejected
- [ ] ✅ فقط مدیر می‌تواند تأیید کند
- [ ] ✅ واریز بعد از Approve
-
-### تست عملی:
-```
-موجودی: 200,000
-درخواست برداشت: 150,000
-کارمزد 2%: 3,000
-مبلغ نهایی: 147,000
-
-نتیجه: [✅ موفق] [❌ ناموفق]
-```
-
-### تطبیق با داکیومنت:
- فایل: `totalDoc/CMS/implementation-progress.md`
- وضعیت: [✅ تطبیق کامل] [⚠️ نیاز به به‌روزرسانی] [❌ عدم تطبیق]
- توضیحات: _________________
-
---
-
-## 📧 بیزینس 5: اطلاع‌رسانی (Email/SMS)
-
-### بررسی کد:
-```bash
-cd CMS/src/CMSMicroservice.Application/Common/Services
-ls -1 *Notification*
-```
-
-### نتیجه:
- [ ] ✅ Email برای Commission ارسال می‌شود
- [ ] ✅ SMS برای تأیید موبایل
- [ ] ✅ Template های HTML
- [ ] ✅ ارسال بلافاصله بعد از event
-
-### تست عملی:
-```
-Event: Commission Calculated
-User Email: test@example.com
-
-Email دریافت شد؟ [✅ بله] [❌ خیر]
-محتوای Email صحیح؟ [✅ بله] [❌ خیر]
-
-نتیجه: [✅ موفق] [❌ ناموفق]
-```
-
-### تطبیق با داکیومنت:
- فایل: `totalDoc/CMS/email-sms-configuration-guide.md`
- وضعیت: [✅ تطبیق کامل] [⚠️ نیاز به به‌روزرسانی] [❌ عدم تطبیق]
- توضیحات: _________________
-
---
-
-## 🛒 بیزینس 6: سفارش و فاکتور
-
-### بررسی کد:
-```bash
-cd CMS/src/CMSMicroservice.Domain/Entities
-grep -A 20 "class UserOrder" UserOrder.cs
-```
-
-### نتیجه:
- [ ] ✅ UserOrder و FactorDetail
- [ ] ✅ محاسبه PV
- [ ] ✅ وضعیت سفارش
- [ ] ✅ VatPercentage اضافه شده
-
-### تست عملی:
-```
-محصول 1: قیمت 100,000، PV: 50
-محصول 2: قیمت 200,000، PV: 100
-
-جمع PV: _______
-انتظار: 150
-
-VAT 10%: _______
-انتظار: 30,000
-
-نتیجه: [✅ موفق] [❌ ناموفق]
-```
-
-### تطبیق با داکیومنت:
- فایل: `totalDoc/CMS/network-club-commission-system-v1.1.md`
- وضعیت: [✅ تطبیق کامل] [⚠️ نیاز به به‌روزرسانی] [❌ عدم تطبیق]
- توضیحات: _________________
-
---
-
-## 📊 خلاصه نتایج
-
-### آمار کلی:
- تعداد بیزینس بررسی شده: 6
- تطبیق کامل: _____ (___%)
- نیاز به به‌روزرسانی داکیومنت: _____
- عدم تطبیق (Bug): _____
-
-### موارد نیازمند اقدام فوری:
-1. _________________
-2. _________________
-3. _________________
-
-### موارد نیازمند به‌روزرسانی داکیومنت:
-1. _________________
-2. _________________
-3. _________________
-
---
-
-## 🎯 اقدامات بعدی
-
-### این هفته:
- [ ] _________________
- [ ] _________________
-
-### ماه آینده:
- [ ] _________________
- [ ] _________________
-
---
-
-**امضا**: _________  
-**تاریخ تکمیل گزارش**: _________
@@ -1,411 +0,0 @@
-# CMS API Coverage - مقایسه CMS با BackOffice.BFF
-
-**تاریخ بررسی**: 2025-12-01  
-**هدف**: شناسایی APIهای CMS که در BackOffice.BFF پوشش داده نشده‌اند
-
---
-
-## 📊 خلاصه وضعیت
-
-| دسته | تعداد Proto در CMS | پوشش در BFF | وضعیت |
-|------|-------------------|--------------|--------|
-| **User Management** | 1 | ✅ کامل | 100% |
-| **Network & Tree** | 1 | ✅ کامل | 100% |
-| **Club Membership** | 1 | ✅ کامل | 100% |
-| **Commission & Wallet** | 3 | ✅ کامل | 100% |
-| **Products** | 6 | ⚠️ جزئی | 70% |
-| **Orders** | 2 | ⚠️ جزئی | 60% |
-| **Configuration** | 1 | ✅ کامل | 100% |
-| **Roles & Permissions** | 2 | ✅ کامل | 100% |
-| **Cart** | 1 | ❌ خیر | 0% |
-| **Transactions** | 1 | ❌ خیر | 0% |
-| **Contracts** | 2 | ❌ خیر | 0% |
-| **OTP** | 1 | ✅ کامل | 100% |
-| **Public Messages** | 1 | ❌ خیر | 0% |
-
---
-
-## ✅ APIهای کامل پوشش داده شده (در BFF موجود است)
-
-### 1. User Management (`user.proto`)
- ✅ CreateNewUserCommand
- ✅ UpdateUserCommand
- ✅ DeleteUserCommand
- ✅ GetAllUserByFilterQuery
- ✅ GetUserQuery
- ✅ SendOtpCommand
- ✅ VerifyOtpCodeCommand
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: همه عملیات
- Admin: Create, Update, GetAll, Get (بدون Delete)
- Inspector: فقط GetAll, Get
-
---
-
-### 2. Network Management (`networkmembership.proto`)
- ✅ GetNetworkTreeQuery
- ✅ GetNetworkHistoryQuery
- ✅ GetNetworkStatisticsQuery
- ✅ GetUserNetworkInfoQuery
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: همه
- Admin: همه
- Inspector: فقط مشاهده (همه)
-
---
-
-### 3. Club Membership (`clubmembership.proto`)
- ✅ ActivateClubCommand
- ✅ GetAllClubMembersQuery
- ✅ GetClubStatisticsQuery
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: همه
- Admin: ActivateClub, GetAll, Get
- Inspector: فقط GetAll, Get
-
---
-
-### 4. Commission & Balance (`commission.proto`, `userwallet.proto`, `userwalletchangelog.proto`)
- ✅ GetAllWeeklyPoolsQuery
- ✅ GetWeeklyPoolQuery
- ✅ GetUserWeeklyBalancesQuery
- ✅ GetUserPayoutsQuery
- ✅ ApproveWithdrawalCommand
- ✅ RejectWithdrawalCommand
- ✅ ProcessWithdrawalCommand
- ✅ GetWithdrawalRequestsQuery
- ✅ TriggerWeeklyCalculationCommand (Worker)
- ✅ GetWorkerStatusQuery
- ✅ GetWorkerExecutionLogsQuery
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: همه عملیات + Trigger Worker
- Admin: Approve/Reject Withdrawal, GetAll queries
- Inspector: فقط Get queries (بدون Approve/Reject)
-
---
-
-### 5. Configuration (`configuration.proto`)
- ✅ CreateOrUpdateConfigurationCommand
- ✅ DeactivateConfigurationCommand
- ✅ GetAllConfigurationsQuery
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: همه عملیات
- Admin: فقط GetAll (بدون Update)
- Inspector: فقط GetAll
-
---
-
-### 6. Roles & Permissions (`role.proto`, `userrole.proto`)
- ✅ CreateNewRoleCommand
- ✅ UpdateRoleCommand
- ✅ DeleteRoleCommand
- ✅ GetAllRoleByFilterQuery
- ✅ GetRoleQuery
- ✅ CreateNewUserRoleCommand
- ✅ UpdateUserRoleCommand
- ✅ DeleteUserRoleCommand
- ✅ GetAllUserRoleByFilterQuery
- ✅ GetUserRoleQuery
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: همه عملیات
- Admin: ❌ هیچ دسترسی (فقط SuperAdmin)
- Inspector: ❌ هیچ دسترسی
-
---
-
-## ⚠️ APIهای جزئی پوشش داده شده
-
-### 7. Products (`products.proto`, `category.proto`, `tag.proto`, `package.proto`, `productgallerys.proto`, `productimages.proto`)
-
-#### ✅ موجود در BFF:
- CreateNewProductsCommand
- UpdateProductsCommand
- DeleteProductsCommand
- GetAllProductsByFilterQuery
- GetProductsQuery
- GetProductsForCategoryQuery
- AddProductImageCommand
- RemoveProductImageCommand
- GetProductGalleryQuery
-
-#### ⚠️ موجود در CMS ولی نه در BFF:
-```
-Products:
-  - BulkUpdateProductsCommand (به‌روزرسانی دسته‌ای)
-  - GetProductBySkuQuery (جستجو با SKU)
-  - ToggleProductStatusCommand (فعال/غیرفعال)
-  - GetLowStockProductsQuery (محصولات کم موجودی)
-
-Category:
-  - CreateNewCategoryCommand ✅
-  - UpdateCategoryCommand ✅
-  - DeleteCategoryCommand ✅
-  - GetAllCategoryByFilterQuery ✅
-  - GetCategoriesQuery ✅
-  - GetCategoryQuery ✅
-  - UpdateCategoryProductsCommand ✅ (ارتباط Product-Category)
-  - UpdateProductCategoriesCommand ✅
-
-Tags:
-  - CreateTagCommand ❌
-  - UpdateTagCommand ❌
-  - DeleteTagCommand ❌
-  - GetAllTagsQuery ❌
-  - AssignTagToProductCommand ❌ (ارتباط Product-Tag)
-
-Package (بسته‌بندی):
-  - CreateNewPackageCommand ✅
-  - UpdatePackageCommand ✅
-  - DeletePackageCommand ✅
-  - GetAllPackageByFilterQuery ✅
-  - GetPackageQuery ✅
-```
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: همه عملیات
- Admin: همه عملیات محصولات (Create, Update, Delete)
- Inspector: فقط Get queries
-
---
-
-### 8. Orders (`userorder.proto`, `factordetails.proto`)
-
-#### ✅ موجود در BFF:
- CreateNewUserOrderCommand
- UpdateUserOrderCommand
- DeleteUserOrderCommand
- GetAllUserOrderByFilterQuery
- GetUserOrderQuery
-
-#### ⚠️ موجود در CMS ولی نه در BFF:
-```
-UserOrder:
-  - CancelOrderCommand (لغو سفارش)
-  - UpdateOrderStatusCommand (تغییر وضعیت)
-  - GetOrderByInvoiceNumberQuery (جستجو با شماره فاکتور)
-  - GetOrdersByDateRangeQuery (گزارش بازه زمانی)
-  - CalculateOrderPVQuery (محاسبه PV سفارش)
-  - ApplyDiscountToOrderCommand (اعمال تخفیف)
-
-FactorDetails:
-  - GetFactorDetailsQuery (جزئیات کامل فاکتور)
-  - UpdateFactorDetailCommand (ویرایش آیتم فاکتور)
-  - RemoveFactorDetailCommand (حذف آیتم فاکتور)
-```
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: همه عملیات
- Admin: همه عملیات (Create, Update, Cancel, Status)
- Inspector: فقط Get queries
-
---
-
-## ❌ APIهای بدون پوشش (باید اضافه شوند)
-
-### 9. Shopping Cart (`usercarts.proto`)
-**وضعیت**: هیچ Handler در BFF وجود ندارد
-
-```
-باید اضافه شود:
-  - AddToCartCommand
-  - UpdateCartItemCommand
-  - RemoveFromCartCommand
-  - GetUserCartQuery
-  - ClearCartCommand
-  - MergeCartCommand (برای کاربران مهمان → لاگین)
-```
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: مشاهده سبد همه کاربران
- Admin: مشاهده سبد همه کاربران
- Inspector: مشاهده فقط (بدون ویرایش)
-
-**اولویت**: 🟡 متوسط (برای فروشگاه ضروری است)
-
---
-
-### 10. Transactions (`transactions.proto`)
-**وضعیت**: هیچ Handler در BFF وجود ندارد
-
-```
-باید اضافه شود:
-  - CreateTransactionCommand (ثبت تراکنش پرداخت)
-  - GetTransactionQuery
-  - GetAllTransactionsByFilterQuery
-  - GetTransactionByReferenceQuery (جستجو با شماره پیگیری)
-  - GetUserTransactionsQuery (تراکنش‌های یک کاربر)
-  - VerifyTransactionCommand (تأیید پرداخت از درگاه)
-  - RefundTransactionCommand (بازگشت وجه)
-```
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: همه عملیات + Refund
- Admin: مشاهده تراکنش‌ها (بدون Refund)
- Inspector: فقط مشاهده
-
-**اولویت**: 🔴 بالا (برای درگاه پرداخت ضروری است)
-
---
-
-### 11. Contracts (`contract.proto`, `usercontract.proto`)
-**وضعیت**: هیچ Handler در BFF وجود ندارد
-
-```
-باید اضافه شود:
-Contract:
-  - CreateContractCommand
-  - UpdateContractCommand
-  - DeleteContractCommand
-  - GetAllContractsQuery
-  - GetContractQuery
-  - ActivateContractCommand
-  - DeactivateContractCommand
-
-UserContract:
-  - AssignContractToUserCommand
-  - GetUserContractsQuery
-  - GetContractUsersQuery
-  - RevokeUserContractCommand
-```
-
-**توضیح**: Contracts احتمالاً برای قراردادهای عضویت یا خریدهای خاص است.
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: همه عملیات
- Admin: Assign, Get queries
- Inspector: فقط Get queries
-
-**اولویت**: 🟢 پایین (در صورت نیاز بیزینسی)
-
---
-
-### 12. Public Messages (`public_messages.proto`)
-**وضعیت**: هیچ Handler در BFF وجود ندارد
-
-```
-باید اضافه شود:
-  - CreatePublicMessageCommand (ایجاد اعلان عمومی)
-  - UpdatePublicMessageCommand
-  - DeletePublicMessageCommand
-  - GetAllPublicMessagesQuery
-  - GetPublicMessageQuery
-  - PublishMessageCommand (انتشار اعلان)
-  - ArchiveMessageCommand (بایگانی)
-```
-
-**توضیح**: پیام‌های عمومی برای اطلاع‌رسانی به تمام کاربران
-
-**تنظیمات دسترسی پیشنهادی**:
- SuperAdmin: همه عملیات
- Admin: Create, Update, Publish
- Inspector: فقط Get queries
-
-**اولویت**: 🟡 متوسط
-
---
-
-### 13. User Address (`useraddress.proto`)
-**وضعیت**: در BFF موجود است ✅
-
- ✅ CreateNewUserAddressCommand
- ✅ UpdateUserAddressCommand
- ✅ DeleteUserAddressCommand
- ✅ GetAllUserAddressByFilterQuery
- ✅ GetUserAddressQuery
-
---
-
-## 📋 خلاصه کارهای باقی‌مانده در CMS
-
-### 🔴 اولویت بالا (برای Launch ضروری):
-1. **Transactions** - درگاه پرداخت
-   - زمان: 3 روز
-   - Commands: 7 مورد
-   - ✅ داکیومنت: در `REMAINING-TASKS.md`
-
-### 🟡 اولویت متوسط (برای فروشگاه):
-2. **Shopping Cart**
-   - زمان: 2 روز
-   - Commands: 6 مورد
-   
-3. **Public Messages**
-   - زمان: 1 روز
-   - Commands: 6 مورد
-   
-4. **Products (تکمیل)**
-   - Tags Management
-   - Bulk Operations
-   - Low Stock Alerts
-   - زمان: 2 روز
-
-5. **Orders (تکمیل)**
-   - Cancel/Status/Discount
-   - Reports
-   - زمان: 2 روز
-
-### 🟢 اولویت پایین:
-6. **Contracts** (در صورت نیاز بیزینسی)
-   - زمان: 2 روز
-
---
-
-## 🎯 نقشه راه پیشنهادی
-
-### هفته 1: Transaction System (درگاه پرداخت)
- CMS: 7 Command/Query
- BFF: 7 Handler
- BackOffice: صفحه تراکنش‌ها
- ✅ داکیومنت
-
-### هفته 2: Shopping Cart
- CMS: 6 Command/Query
- BFF: 6 Handler
- BackOffice: صفحه مدیریت سبدهای خرید کاربران
- ✅ داکیومنت
-
-### هفته 3: Products & Orders تکمیل
- Tags Management
- Bulk Operations
- Order Cancel/Status
- ✅ داکیومنت
-
-### هفته 4: Public Messages
- Create/Publish Messages
- Notification System
- ✅ داکیومنت
-
---
-
-## 📊 تخمین زمان کل
-
-| فیچر | CMS | BFF | BackOffice | جمع |
-|------|-----|-----|------------|-----|
-| Transactions | 3 روز | 2 روز | 2 روز | **1 هفته** |
-| Shopping Cart | 2 روز | 1 روز | 2 روز | **1 هفته** |
-| Products/Orders تکمیل | 2 روز | 1 روز | 2 روز | **1 هفته** |
-| Public Messages | 1 روز | 1 روز | 1 روز | **3 روز** |
-| **جمع کل** | | | | **3.5 هفته** |
-
---
-
-## ✅ چک‌لیست قبل از شروع هر فیچر
-
- [ ] بیزینس در `network-club-commission-system-v1.1.md` مستند شده؟
- [ ] Proto file در CMS تعریف شده؟
- [ ] Commands/Queries در CMS پیاده‌سازی شده؟
- [ ] Migration اجرا شده؟
- [ ] Handlers در BFF اضافه شده؟
- [ ] Controllers در BFF تعریف شده؟
- [ ] صفحات در BackOffice ایجاد شده؟
- [ ] تست‌های دستی انجام شده؟
- [ ] ✅ داکیومنت نهایی (مقایسه کد با داکیومنت)
-
---
-
-**آخرین به‌روزرسانی**: 2025-12-01
@@ -1,336 +0,0 @@
-# 📦 گزارش آمادگی تحویل پروژه FourSat به Admin
-
-> **تاریخ گزارش**: 1403/09/14 (2024-12-04)  
-> **نسخه پروژه**: v1.0.0-RC1  
-> **وضعیت**: آماده برای تحویل مرحله اول
-
---
-
-## ✅ بخش‌های آماده برای استفاده (Production Ready)
-
-### 1. **BackOffice UI - 56 صفحه کاربردی**
-
-#### 📊 Dashboard & Analytics
- ✅ داشبورد اصلی با نمودارها و آمار
- ✅ گزارش‌های فروش
- ✅ آمار کاربران و شبکه
-
-#### 👥 User Management (مدیریت کاربران)
- ✅ لیست کاربران با فیلترهای پیشرفته
- ✅ جزئیات کاربر
- ✅ ایجاد/ویرایش/حذف کاربر
- ✅ مدیریت آدرس‌های کاربر
- ✅ تخصیص نقش به کاربر
-
-#### 🛍️ Product Management (مدیریت محصولات)
- ✅ لیست محصولات با فیلترها
- ✅ ایجاد محصول جدید
- ✅ ویرایش محصول
- ✅ حذف محصول
- ✅ مدیریت گالری تصاویر
- ✅ مدیریت موجودی
- ✅ **Tag Management** (اضافه کردن برچسب‌ها)
- ✅ **Bulk Operations** (ویرایش دسته‌جمعی قیمت/موجودی)
-
-#### 🗂️ Category Management (مدیریت دسته‌بندی)
- ✅ لیست دسته‌بندی‌ها (Tree Structure)
- ✅ ایجاد/ویرایش/حذف دسته‌بندی
- ✅ دسته‌بندی چندسطحی (Parent-Child)
-
-#### 📦 Order Management (مدیریت سفارشات)
- ✅ لیست سفارشات با فیلترها
- ✅ جزئیات سفارش
- ✅ تغییر وضعیت سفارش
- ✅ لغو سفارش
- ✅ **CalculateOrderPV** (محاسبه PV برای MLM)
- ✅ **ApplyDiscountToOrder** (اعمال تخفیف دستی)
- ✅ **GetOrdersByDateRange** (فیلتر بازه زمانی)
-
-#### 💰 Commission Management (مدیریت کمیسیون)
- ✅ لیست درخواست‌های برداشت
- ✅ تأیید/رد برداشت
- ✅ گزارش‌های مالی
- ✅ **Withdrawal Reports** (گزارش‌های دوره‌ای)
-
-#### 🌳 Network Management (مدیریت شبکه)
- ✅ نمایش ساختار شبکه (Tree View)
- ✅ افزودن عضو به شبکه
- ✅ حذف از شبکه
- ✅ جابه‌جایی در شبکه
- ✅ مشاهده موقعیت کاربر
-
-#### 📦 Package Management (مدیریت پکیج‌ها)
- ✅ لیست پکیج‌ها
- ✅ ایجاد/ویرایش پکیج
- ✅ **GetUserPackageStatus** (وضعیت خرید پکیج کاربر)
-
-#### 🎫 Club Membership (عضویت باشگاه)
- ✅ مدیریت عضویت باشگاه
- ✅ فعالسازی عضویت
- ✅ لیست اعضای باشگاه
-
-#### 🔐 Roles & Permissions (نقش‌ها و دسترسی‌ها)
- ✅ مدیریت نقش‌ها
- ✅ تخصیص نقش به کاربر
-
-#### ⚙️ Settings (تنظیمات)
- ✅ تنظیمات عمومی
- ✅ مدیریت Configuration Keys
- ✅ تنظیمات ایمیل
- ✅ تنظیمات SMS
-
---
-
-### 2. **CMS Backend - Features کامل**
-
-#### ✅ Club Discount Shop System (100%)
-**تاریخ تکمیل**: 4 دسامبر 2024
-
-**Entities:**
- DiscountCategory (دسته‌بندی محصولات تخفیفی)
- DiscountProduct (محصولات تخفیفی)
- DiscountShoppingCart (سبد خرید)
- DiscountOrder (سفارشات)
- DiscountOrderItem (جزئیات سفارش)
-
-**Operations:**
- CRUD محصولات و دسته‌بندی
- مدیریت سبد خرید
- Checkout با Hybrid Payment (کیف پول تخفیف + درگاه)
- مدیریت موجودی خودکار
- 19 gRPC RPC برای BackOffice
-
-**Business Logic:**
- خرید با کیف پول تخفیف تا سقف MaxDiscountPercent
- پرداخت باقیمانده از طریق درگاه
- Order lifecycle: Pending → Processing → Shipped → Delivered/Cancelled
-
-#### ✅ Tag Management (100%)
-**تاریخ تکمیل**: 4 دسامبر 2024
-
- CRUD Tags
- Assign Tags to Products
- Filter Products by Tag
- Proto + gRPC Services آماده
-
-#### ✅ Product Bulk Operations (100%)
-**تاریخ تکمیل**: 4 دسامبر 2024
-
- BulkUpdateProductPrices (ویرایش دسته‌جمعی قیمت)
- BulkUpdateProductStock (ویرایش دسته‌جمعی موجودی)
- GetLowStockProducts (محصولات کم موجودی)
- ToggleProductStatus (فعال/غیرفعال کردن)
-
-#### ✅ Payment Gateway Integration (100%)
-**تاریخ تکمیل**: 4 دسامبر 2024
-
- DayaPaymentService پیاده‌سازی کامل
- InitiatePaymentAsync
- VerifyPaymentAsync
- ProcessPayoutAsync
- GetWithdrawalReports (گزارش‌های دوره‌ای)
-
-#### ✅ Order Management Extensions (100% Proto/gRPC)
-**تاریخ تکمیل**: 4 دسامبر 2024
-
- UpdateOrderStatus (تغییر وضعیت)
- GetOrdersByDateRange (فیلتر بازه زمانی)
- ApplyDiscountToOrder (تخفیف دستی)
- CalculateOrderPV (محاسبه PV)
-
-**نکته**: Handlers با TODO دقیق آماده شده‌اند (45 دقیقه پیاده‌سازی)
-
-#### ✅ Package Purchase System (100% Proto/gRPC)
-**تاریخ تکمیل**: 4 دسامبر 2024
-
- PurchaseGoldenPackage
- VerifyGoldenPackagePurchase
- GetUserPackageStatus
- Proto + gRPC Services آماده
-
-**نکته**: Handlers با TODO دقیق آماده شده‌اند (1 ساعت پیاده‌سازی)
-
-#### ✅ Public Messages System (100% Proto/gRPC)
-**تاریخ تکمیل**: 4 دسامبر 2024
-
- Create/Update/Delete Messages
- Publish/Archive Messages
- Get All/Active Messages
- Proto + gRPC Services آماده
-
-**نکته**: 5 TODO handlers (1 ساعت پیاده‌سازی)
-
---
-
-## ⚠️ بخش‌های در حال تکمیل (نزدیک به اتمام)
-
-### 🔄 BackOffice.BFF - TODO Handlers
-
-#### پیاده‌سازی سریع (کل: 3 ساعت)
-1. **Package Purchase (1 ساعت)**:
-   - GetUserPackageStatusHandler
-
-2. **Order Management (1 ساعت)**:
-   - UpdateOrderStatusHandler
-   - GetOrdersByDateRangeHandler
-   - ApplyDiscountToOrderHandler
-   - CalculateOrderPVHandler
-
-3. **Public Messages (1 ساعت)**:
-   - GetAllMessagesHandler
-   - GetActiveMessagesHandler
-
-**راهنمای پیاده‌سازی**: هر Handler فقط یک gRPC call ساده است. TODO comments دقیق موجود است.
-
---
-
-## 🚀 بخش‌های در صف توسعه (اولویت بالا)
-
-### 1. Discount Shop - BackOffice Integration (4 روز)
-**وضعیت**: CMS 100% آماده، نیاز به 19 Handler در BackOffice.BFF
-
-**Handlers مورد نیاز**:
- Product Management (5 handlers)
- Category Management (4 handlers)
- Shopping Cart (5 handlers)
- Order Management (5 handlers)
-
-**UI Pages مورد نیاز**:
- صفحه مدیریت محصولات تخفیفی
- صفحه مدیریت دسته‌بندی
- صفحه سفارشات تخفیفی
-
-### 2. Public Messages UI (2 روز)
- صفحه لیست اعلانات
- Dialog ایجاد/ویرایش
- دکمه Publish/Archive
- پیش‌نمایش اعلان
-
-### 3. Withdrawal Reports UI (2 روز)
- صفحه گزارش‌های مالی
- Chart.js visualization
- فیلترهای پیشرفته
- Export Excel/PDF
-
---
-
-## 📋 چک‌لیست تحویل
-
-### ✅ آماده برای تحویل فوری
- [✅] BackOffice UI با 56 صفحه کاملاً کاربردی
- [✅] User Management کامل
- [✅] Product Management کامل + Bulk Ops + Tags
- [✅] Order Management کامل (با TODO handlers)
- [✅] Commission Management کامل
- [✅] Network Management کامل
- [✅] Package Management کامل (با TODO handlers)
- [✅] Roles & Settings کامل
- [✅] CMS Backend برای Discount Shop (100%)
- [✅] CMS Backend برای Payment Gateway (100%)
- [✅] مستندات کامل (1812+ خط)
-
-### ⏳ نیاز به تکمیل کوتاه‌مدت (1 هفته)
- [ ] پیاده‌سازی 8 TODO handlers در BackOffice.BFF (3 ساعت)
- [ ] پیاده‌سازی 9 TODO handlers در CMS (2 ساعت)
- [ ] Discount Shop Integration - BackOffice.BFF (4 روز)
- [ ] Public Messages UI (2 روز)
- [ ] Withdrawal Reports UI (2 روز)
-
---
-
-## 📊 آمار کلی پروژه
-
-### Backend (CMS)
- **Total Entities**: 45+
- **Total Commands**: 120+
- **Total Queries**: 80+
- **Total gRPC Services**: 20+
- **Build Status**: ✅ 0 errors, 507 warnings
- **Test Coverage**: Unit tests برای بخش‌های کلیدی
-
-### BackOffice.BFF
- **Total Handlers**: 55 (47 کامل + 8 TODO)
- **gRPC Clients**: 15+
- **Build Status**: ⚠️ 38 pre-existing errors in DiscountOrder module (unrelated)
-
-### BackOffice UI
- **Total Pages**: 56
- **Total Components**: 40+
- **UI Framework**: Blazor + MudBlazor
- **Authentication**: JWT-based
- **Authorization**: Role-based (SuperAdmin, Admin, Inspector)
-
---
-
-## 🎯 پیشنهاد مسیر تحویل
-
-### مرحله 1: تحویل فوری (امروز)
-**محتوا**:
- BackOffice UI کامل (56 صفحه)
- مستندات کامل
- راهنمای استفاده
-
-**قابلیت‌ها**:
- مدیریت کاربران، محصولات، سفارشات
- مدیریت کمیسیون و شبکه
- گزارش‌های پایه
-
-### مرحله 2: تکمیل سریع (3-5 روز)
-**محتوا**:
- پیاده‌سازی TODO handlers (5 ساعت)
- Discount Shop Integration (4 روز)
-
-**قابلیت‌های اضافه**:
- مدیریت کامل Discount Shop
- Package Purchase Flow کامل
- Order Management پیشرفته
-
-### مرحله 3: بهبودها (1 هفته)
-**محتوا**:
- Public Messages UI
- Withdrawal Reports UI
- Manual Payment System
-
---
-
-## 📞 پشتیبانی و مستندات
-
-### مستندات موجود
- ✅ `REMAINING-TASKS-CONSOLIDATED.md` (1400+ خط)
- ✅ `implementation-progress.md` (1812 خط)
- ✅ `network-club-commission-system-v1.1.md`
- ✅ `discount-shop-system.md`
- ✅ `package-purchase-system.md`
- ✅ `BackOffice/development-plan.md` (1462 خط)
- ✅ راهنمای نصب و راه‌اندازی
-
-### نکات فنی مهم
- **Database**: SQL Server
- **Framework**: .NET 8/9
- **Authentication**: JWT + Cookie
- **Communication**: gRPC
- **Mapping**: Mapster
- **Validation**: FluentValidation
- **Logging**: Serilog (آماده شود)
-
---
-
-## ✅ تأییدیه آمادگی
-
-**تأیید می‌شود که**:
- ✅ BackOffice UI با 56 صفحه کاملاً تست شده و آماده استفاده است
- ✅ تمام CRUD های اصلی کار می‌کنند
- ✅ CMS Backend برای فیچرهای اصلی 100% آماده است
- ✅ مستندات کامل و به‌روز است
- ✅ Build تمیز و بدون خطای blocking
-
-**توصیه می‌شود**:
- Admin می‌تواند از نسخه فعلی برای شروع استفاده کند
- TODO handlers در عرض یک هفته تکمیل خواهند شد
- Discount Shop در اولویت بعدی است
-
---
-
-**تاریخ گزارش**: 1403/09/14  
-**تهیه‌کننده**: تیم توسعه FourSat  
-**نسخه**: v1.0.0-RC1
@@ -1,385 +0,0 @@
-# Entity Naming Convention Refactoring Plan
-
-**تاریخ شروع**: 2024-12-03  
-**تاریخ اتمام**: 2024-12-03  
-**مدت زمان واقعی**: 3 ساعت  
-**اولویت**: 🔴 فوری  
-**وضعیت**: ✅ تکمیل شده
-
---
-
-## 🎯 هدف
-
-تبدیل 5 Entity از **Plural** به **Singular** مطابق با EF Core Convention:
-
-```csharp
-// Before: ❌
-public class Products { }
-DbSet<Products> Products { get; }
-
-// After: ✅
-public class Product { }
-DbSet<Product> Products { get; }
-```
-
---
-
-## 📋 Entity های هدف
-
-| # | Entity | تغییر به | استفاده | فایل‌ها | زمان | وضعیت |
-|---|--------|----------|----------|---------|------|--------|
-| 1 | UserCarts | UserCart | 192 | 40+ | 30m | ✅ Done |
-| 2 | ProductImages | ProductImage | 181 | 35+ | 30m | ✅ Done |
-| 3 | ProductGalleries | ProductGallery | 162 | 30+ | 30m | ✅ Done |
-| 4 | Products | Product | 283 | 50+ | 45m | ✅ Done |
-| 5 | Transactions | Transaction | 257 | 45+ | 45m | ✅ Done |
-
-**نتیجه نهایی**: 
- ✅ تمام 5 Entity به Singular تبدیل شدند
- ✅ Build: 0 errors
- ✅ 1075+ استفاده به‌روز شدند
-
---
-
-## 🔧 مراحل اجرا (برای هر Entity)
-
-### Phase 1: تغییر نام Entity File و Class
-
-**1.1. تغییر نام فایل Entity:**
-```bash
-mv Products.cs Product.cs
-```
-
-**1.2. تغییر نام کلاس در فایل:**
-```csharp
-// Before:
-public class Products : BaseAuditableEntity
-
-// After:
-public class Product : BaseAuditableEntity
-```
-
-**1.3. چک کردن وضعیت:**
- ✅ فایل تغییر نام یافت
- ✅ Class name صحیح است
-
---
-
-### Phase 2: Configuration Files
-
-**2.1. تغییر نام فایل Configuration:**
-```bash
-mv ProductsConfiguration.cs ProductConfiguration.cs
-```
-
-**2.2. تغییر Class و EntityTypeConfiguration:**
-```csharp
-// Before:
-public class ProductsConfiguration : IEntityTypeConfiguration<Products>
-
-// After:
-public class ProductConfiguration : IEntityTypeConfiguration<Product>
-```
-
-**2.3. آپدیت builder type:**
-```csharp
-public void Configure(EntityTypeBuilder<Product> builder)
-```
-
---
-
-### Phase 3: DbContext Files
-
-**3.1. آپدیت IApplicationDbContext:**
-```csharp
-// Before:
-DbSet<Products> Products { get; }
-
-// After:
-DbSet<Product> Products { get; }
-```
-
-**3.2. آپدیت ApplicationDbContext:**
-```csharp
-// Before:
-public DbSet<Products> Products => Set<Products>();
-
-// After:
-public DbSet<Product> Products => Set<Product>();
-```
-
---
-
-### Phase 4: Navigation Properties
-
-**4.1. پیدا کردن تمام Navigation Properties:**
-```bash
-grep -r "ICollection<Products>" CMSMicroservice.Domain/Entities/
-```
-
-**4.2. تغییر به Singular:**
-```csharp
-// Before:
-public virtual ICollection<Products> Products { get; set; }
-
-// After:
-public virtual ICollection<Product> Products { get; set; }
-```
-
-**4.3. آپدیت Foreign Key references:**
-```csharp
-// WithMany relations
-builder.HasOne(x => x.Category)
-       .WithMany(x => x.Products)  // همین Plural باقی بماند
-       .HasForeignKey(x => x.CategoryId);
-```
-
---
-
-### Phase 5: CQRS - تغییر نام Folders
-
-**5.1. تغییر نام CQ Folder:**
-```bash
-# معمولاً نیازی نیست - ProductsCQ همان باقی می‌ماند
-# چون به feature اشاره می‌کند نه Entity
-```
-
-**5.2. تغییر نام Commands/Queries folders (اختیاری):**
-```bash
-# معمولاً نام‌ها جمع هستند و تغییر نمی‌کنند
-```
-
---
-
-### Phase 6: CQRS - آپدیت Class References
-
-**6.1. Batch update در Commands:**
-```bash
-find . -type f -name "*.cs" -exec sed -i 's/\bProducts\b/Product/g' {} \;
-```
-
-**توجه**: این command همه جا تغییر می‌دهد! باید دقیق باشیم.
-
-**6.2. Manual review برای موارد خاص:**
- DbSet property names باید Plural بمانند
- Folder names معمولاً Plural هستند
- Navigation Properties باید Plural باشند
-
---
-
-### Phase 7: Events
-
-**7.1. آپدیت Event namespaces:**
-```bash
-find . -path "*/ProductsEvents/*" -name "*.cs" -exec sed -i 's/\bProducts\b/Product/g' {} \;
-```
-
-**7.2. Review Event class names:**
-```csharp
-// Before:
-public class ProductsCreatedEvent
-
-// After:  
-public class ProductCreatedEvent
-```
-
---
-
-### Phase 8: Proto Files
-
-**8.1. آپدیت proto references (احتمالاً نیاز نیست):**
-```protobuf
-// Proto files معمولاً lowercase و plural هستند
-// تغییر نمی‌دهیم مگر اینکه inconsistency باشد
-```
-
-**8.2. آپدیت Service references:**
-```csharp
-// فقط در صورت لزوم
-```
-
---
-
-### Phase 9: Validators & Profiles
-
-**9.1. آپدیت Validator references:**
-```bash
-find . -path "*/Validator/*" -name "*Products*.cs" -exec sed -i 's/\bProducts\b/Product/g' {} \;
-```
-
-**9.2. آپدیت AutoMapper Profiles:**
-```csharp
-CreateMap<Product, ProductDto>();
-CreateMap<CreateProductCommand, Product>();
-```
-
---
-
-### Phase 10: Build & Test
-
-**10.1. Clean:**
-```bash
-find . -type d \( -name "obj" -o -name "bin" \) -exec rm -rf {} +
-```
-
-**10.2. Restore:**
-```bash
-dotnet restore
-```
-
-**10.3. Build:**
-```bash
-dotnet build
-```
-
-**10.4. Check for errors:**
- ✅ 0 Errors
- ⚠️ Warnings قابل قبول
-
-**10.5. Manual review:**
- چک کردن چند فایل به صورت sample
- اطمینان از صحت Navigation Properties
- تست CRUD operations
-
---
-
-## ⚠️ نکات مهم
-
-### 🔴 جاهایی که باید Plural بمانند:
-
-1. **DbSet Property Names:**
-   ```csharp
-   DbSet<Product> Products { get; }  // ✅ Products
-   ```
-
-2. **Navigation Properties:**
-   ```csharp
-   public virtual ICollection<Product> Products { get; set; }  // ✅ Products
-   ```
-
-3. **Table Names (در Configuration):**
-   ```csharp
-   builder.ToTable("Products");  // ✅ معمولاً Plural
-   ```
-
-4. **CQ Folder Names:**
-   ```
-   ProductsCQ/  // ✅ معمولاً Plural (به feature اشاره می‌کند)
-   ```
-
-5. **Proto Files:**
-   ```
-   products.proto  // ✅ معمولاً Plural
-   ```
-
-### 🟢 جاهایی که باید Singular شوند:
-
-1. **Entity Class Name:**
-   ```csharp
-   public class Product { }  // ✅ Singular
-   ```
-
-2. **Configuration Class:**
-   ```csharp
-   public class ProductConfiguration  // ✅ Singular
-   ```
-
-3. **Generic Type Parameters:**
-   ```csharp
-   IEntityTypeConfiguration<Product>  // ✅ Singular
-   EntityTypeBuilder<Product>  // ✅ Singular
-   ```
-
-4. **DbSet Generic Type:**
-   ```csharp
-   DbSet<Product>  // ✅ Singular
-   ```
-
---
-
-## 🎯 ترتیب پیشنهادی اجرا
-
-### دور 1: UserCarts → UserCart
-**دلیل**: کمترین complexity، بهترین برای test کردن process
-
-**مراحل**:
-1. Entity + Configuration
-2. DbContext
-3. Navigation Properties (کم)
-4. CQRS Handlers
-5. Build & Test
-
-**زمان**: 45 دقیقه
-
---
-
-### دور 2: ProductImages → ProductImage
-**دلیل**: مشابه UserCart، پیچیدگی کم
-
-**زمان**: 45 دقیقه
-
---
-
-### دور 3: ProductGalleries → ProductGallery
-**دلیل**: تازه ProductGalleries درست کردیم، فعلاً fresh است
-
-**زمان**: 45 دقیقه
-
---
-
-### دور 4: Products → Product
-**دلیل**: پر استفاده‌ترین، باید در آخر باشد
-
-**زمان**: 1 ساعت
-
---
-
-### دور 5: Transactions → Transaction
-**دلیل**: پر استفاده، باید در آخر باشد
-
-**زمان**: 1 ساعت
-
---
-
-## 📊 Progress Tracking
-
-| Entity | Start | End | Duration | Status | Notes |
-|--------|-------|-----|----------|--------|-------|
-| UserCarts | - | - | - | ⏸️ | - |
-| ProductImages | - | - | - | ⏸️ | - |
-| ProductGalleries | - | - | - | ⏸️ | - |
-| Products | - | - | - | ⏸️ | - |
-| Transactions | - | - | - | ⏸️ | - |
-
---
-
-## ✅ Checklist برای هر Entity
-
-### Pre-Refactoring:
- [ ] Backup گرفته شد
- [ ] Build موفق است (baseline)
- [ ] Git commit انجام شد
-
-### During Refactoring:
- [ ] Entity file renamed
- [ ] Entity class renamed
- [ ] Configuration file renamed
- [ ] Configuration class updated
- [ ] IApplicationDbContext updated
- [ ] ApplicationDbContext updated
- [ ] Navigation Properties updated
- [ ] CQRS Handlers updated (batch)
- [ ] Events updated
- [ ] Validators updated
- [ ] Profiles updated
-
-### Post-Refactoring:
- [ ] Build successful (0 errors)
- [ ] Manual review انجام شد
- [ ] Git commit با message مناسب
- [ ] Documentation updated
-
---
-
-**آخرین به‌روزرسانی**: 2024-12-03  
-**وضعیت کلی**: 🔄 آماده برای شروع
@@ -1,278 +0,0 @@
-# FourSat Project - Documentation Index
-> تمام مستندات سامانه‌های FourSat در این فولدر تجمیع شده‌اند
-
-**تاریخ ایجاد:** 2025-12-01  
-**آخرین بروزرسانی:** 2025-12-01  
-**تعداد کل فایل‌ها:** 24 فایل markdown + 7 فایل پشتیبان (SQL, NDM2, TXT)
-
---
-
-## 📊 وضعیت کلی پروژه
-
-| سیستم | پیشرفت | وضعیت | توضیحات |
-|-------|--------|-------|---------|
-| **BackOffice** | 95% | 🟢 Production Ready | 23 صفحه، 30 BFF Handler، 0 خطا |
-| **CMS** | 95% | 🟢 Production Ready | MVP 100% - Email/SMS آماده |
-| **BackOffice.BFF** | 100% | 🟢 Production Ready | 30 Handler کامل |
-| **FrontOffice** | 40% | 🟡 In Progress | UI در حال توسعه |
-| **FrontOffice.BFF** | 50% | 🟡 In Progress | APIها جزئی |
-
---
-
-## 📋 ساختار مستندات
-
-### 1️⃣ BackOffice (مدیریت)
-**مسیر:** `BackOffice/`
-
-| فایل | شرح |
-|------|-----|
-| `README.md` | معرفی کلی پروژه BackOffice |
-| `development-plan.md` | برنامه توسعه و پیشرفت پروژه (92% تکمیل) |
-
-**آخرین وضعیت (2025-12-01):**
- ✅ 23 صفحه پیاده‌سازی شده
- ✅ 30 BFF Handler (Commission: 15, Network: 9, Club: 6)
- ✅ معماری 3-لایه (UI → BFF → CMS)
- ✅ Build با 0 خطا
- ✅ Withdrawal APIs کامل شد
- ✅ Worker Control APIs کامل شد
-
---
-
-### 2️⃣ BackOffice.BFF (Backend For Frontend - مدیریت)
-**مسیر:** `BackOffice.BFF/`
-
-| فایل | شرح |
-|------|-----|
-| `README.md` | معرفی کلی BFF مدیریت |
-| `cms-integration.md` | راهنمای یکپارچه‌سازی با CMS |
-| `.github/git-commit-instructions.md` | استانداردهای Commit Message |
-| `docs/model.ndm2` | مدل دیتابیس (Navicat) |
-
-**توضیحات:**
- لایه واسط بین UI مدیریت و CMS
- مدیریت gRPC Clients
- Mapping و Validation
-
---
-
-### 3️⃣ FrontOffice (کاربران)
-**مسیر:** `FrontOffice/`
-
-| فایل | شرح |
-|------|-----|
-| `README.md` | معرفی کلی پروژه FrontOffice |
-| `mudblazor_classes.md` | راهنمای استایل‌ها و کلاس‌های MudBlazor |
-
-**توضیحات:**
- رابط کاربری برای مشتریان
- استفاده از MudBlazor Component Library
-
---
-
-### 4️⃣ FrontOffice.BFF (Backend For Frontend - کاربران)
-**مسیر:** `FrontOffice.BFF/`
-
-| فایل | شرح |
-|------|-----|
-| `README.md` | معرفی کلی BFF کاربران |
-| `docs/CMS.sql` | اسکریپت SQL |
-| `docs/model.ndm2` | مدل دیتابیس (Navicat) |
-
-**توضیحات:**
- لایه واسط بین UI کاربران و CMS
- مدیریت Authentication و Authorization
-
---
-
-### 5️⃣ CMS (Content Management System)
-**مسیر:** `CMS/`
-
-| فایل | شرح | کاربرد |
-|------|-----|--------|
-| `README.md` | معرفی کلی CMS + Quick Start | عمومی |
-| `cms-data-and-business.md` | معماری دیتا و بیزینس لاجیک | معماری |
-| `network-club-commission-system.md` | سیستم شبکه، باشگاه و کمیسیون (نسخه اول) | Business Logic |
-| `network-club-commission-system-v1.1.md` | سیستم شبکه، باشگاه و کمیسیون (نسخه 1.1) | Business Logic |
-| `binary-tree-registration-guide.md` | راهنمای ثبت‌نام درختی باینری | راهنمای توسعه |
-| `migration-network-parent-guide.md` | راهنمای مهاجرت NetworkParent | راهنمای توسعه |
-| `implementation-progress.md` | گزارش پیشرفت پیاده‌سازی (90% تکمیل) | Progress Report |
-| `implementation-progress-fa.md` | گزارش پیشرفت پیاده‌سازی (فارسی) | Progress Report |
-| `daya-loan-integration.md` | سیستم یکپارچه‌سازی وام دایا (90% تکمیل) | Feature Implementation |
-| `manual-payment-system.md` | سیستم پرداخت دستی مشتریان (Design Complete) | Feature Design |
-| `monitoring-alerts-implementation-report.md` | گزارش پیاده‌سازی Monitoring و Alerts | Feature Report |
-| `monitoring-alerts-consolidated-report.md` | گزارش تجمیعی Monitoring و Alerts | Feature Report |
-| `email-sms-configuration-guide.md` | راهنمای تنظیم Email/SMS (MailKit + Kavenegar) | Configuration |
-| `balance-calculation-carryover-logic.md` | منطق محاسبه Balance و CarryOver | Business Logic |
-| `model.ndm2`, `model1.ndm2` | مدل‌های دیتابیس (Navicat) | Database |
-| `update-pool-percent.sql` | اسکریپت SQL برای به‌روزرسانی Pool Percent | Database |
-| `network_crm_calculate.txt` | یادداشت‌های محاسبات شبکه CRM | Notes |
-| `REMAINING-TASKS.md` | ⭐ لیست کامل کارهای باقی‌مانده با اولویت‌بندی | Planning |
-
-**ویژگی‌های کلیدی:**
- 🌳 سیستم شبکه‌سازی باینری (Binary Tree)
- 💰 محاسبه و توزیع کمیسیون هفتگی
- 🏆 سیستم باشگاه مشتریان (Club Membership)
- 📊 Dashboard های آماری و مانیتورینگ
- ⚠️ سیستم هشدارها و اعلان‌ها
- 📧 ✅ Email/SMS Notifications (MailKit + Kavenegar)
- 🔄 ✅ Hangfire Job Scheduling
- 💊 ✅ Health Checks (Kubernetes-ready)
-
---
-
-## 🎯 دسته‌بندی موضوعی
-
-### معماری و طراحی
- `CMS/cms-data-and-business.md`
- `BackOffice.BFF/cms-integration.md`
-
-### Business Logic اصلی
- `CMS/network-club-commission-system-v1.1.md` ⭐ (آخرین نسخه)
- `CMS/network-club-commission-system.md`
- `CMS/balance-calculation-carryover-logic.md` (منطق محاسبات)
-
-### راهنماهای توسعه
- `CMS/binary-tree-registration-guide.md`
- `CMS/migration-network-parent-guide.md`
- `CMS/email-sms-configuration-guide.md`
- `FrontOffice/mudblazor_classes.md`
- `BackOffice.BFF/.github/git-commit-instructions.md`
-
-### گزارش‌های پیشرفت
- `BackOffice/development-plan.md` (88% تکمیل)
- `CMS/implementation-progress.md`
- `CMS/implementation-progress-fa.md`
-
-### Feature Reports
- `CMS/monitoring-alerts-implementation-report.md`
- `CMS/monitoring-alerts-consolidated-report.md`
-
---
-
-## 📊 آمار کلی پروژه
-
-### BackOffice (UI مدیریت)
- **صفحات:** 23 صفحه
- **پیشرفت:** 88%
- **وضعیت Build:** ✅ موفق (0 خطا)
-
-### CMS (Backend اصلی)
- **Entities:** 30+ موجودیت
- **APIs:** 100+ endpoint
- **وضعیت Build:** ✅ موفق (0 خطا)
-
-### سیستم کمیسیون و شبکه
- **وضعیت:** ✅ پیاده‌سازی شده
- **محاسبات:** هفتگی، خودکار
- **Binary Tree:** کامل با spillover
-
---
-
-## 🔄 آخرین تغییرات (2025-12-01)
-
-### Phase 4: MVP Complete ✅
-1. ✅ Email/SMS Notification System
-   - MailKit 4.14.1 (SMTP Email with HTML templates)
-   - Kavenegar 1.2.5 (Iranian SMS gateway)
-   - User.Email field added with migration
-   - 3 notification types: Commission, Club activation, Errors
-   
-2. ✅ Hangfire Job Scheduling
-   - Dashboard UI at `/hangfire`
-   - Cron: Sunday 00:05 UTC
-   - SQL Server persistence
-   - Manual trigger API
-   
-3. ✅ Infrastructure Enhancements
-   - Health Check endpoints (/health, /health/ready, /health/live)
-   - AlertService (structured logging)
-   - Retry logic (Polly 8.5.0)
-   - WorkerExecutionLog (audit trail)
-   
-4. ✅ BackOffice Integration
-   - Configuration page (4 tabs)
-   - Withdrawal APIs complete
-   - Worker Control APIs complete
-
---
-
-## 📞 نکات مهم برای توسعه‌دهندگان
-
-### مستندات حیاتی
-1. **🚀 شروع سریع**: `QUICK-START-DEVELOPMENT.md` (راهنمای گام‌به‌گام توسعه از صفر)
-2. **⚠️ بررسی بیزینس**: `BUSINESS-VERIFICATION-TEMPLATE.md` (تمپلیت گزارش ماهانه)
-3. **🔍 مقایسه CMS vs BFF**: `CMS-API-COVERAGE.md` (چه APIهایی باقی مانده؟)
-4. **⭐ کارهای باقی‌مانده:** `REMAINING-TASKS.md` (اولویت‌بندی شده + چک‌لیست بیزینس)
-5. **شروع پروژه جدید:** `README.md` هر پروژه
-6. **درک Business Logic:** `CMS/network-club-commission-system-v1.1.md`
-7. **راه‌اندازی توسعه:** `BackOffice/development-plan.md`
-8. **یکپارچه‌سازی:** `BackOffice.BFF/cms-integration.md`
-
-### فایل‌های کمکی
- **UI Styling:** `FrontOffice/mudblazor_classes.md`
- **Database Migration:** `CMS/migration-network-parent-guide.md`
- **Tree Registration:** `CMS/binary-tree-registration-guide.md`
- **Email/SMS Setup:** `CMS/email-sms-configuration-guide.md`
-
---
-
-## 🗂️ ساختار فایل‌ها
-
-```
-totalDoc/
-├── INDEX.md (این فایل)
-├── README.md
-├── REMAINING-TASKS.md ⭐ (کارهای باقی‌مانده + بیزینس‌های کلیدی)
-├── BUSINESS-VERIFICATION-TEMPLATE.md ⚠️ (تمپلیت گزارش بررسی ماهانه)
-├── CMS-API-COVERAGE.md 🔍 (مقایسه CMS vs BFF)
-├── QUICK-START-DEVELOPMENT.md 🚀 (راهنمای شروع سریع توسعه)
-├── BackOffice/
-│   ├── README.md
-│   └── development-plan.md
-├── BackOffice.BFF/
-│   ├── README.md
-│   ├── cms-integration.md
-│   ├── .github/
-│   │   └── git-commit-instructions.md
-│   └── docs/
-│       └── model.ndm2
-├── FrontOffice/
-│   ├── README.md
-│   └── mudblazor_classes.md
-├── FrontOffice.BFF/
-│   ├── README.md
-│   └── docs/
-│       ├── CMS.sql
-│       └── model.ndm2
-└── CMS/
-    ├── README.md
-    ├── cms-data-and-business.md
-    ├── network-club-commission-system.md
-    ├── network-club-commission-system-v1.1.md
-    ├── binary-tree-registration-guide.md
-    ├── migration-network-parent-guide.md
-    ├── implementation-progress.md
-    ├── implementation-progress-fa.md
-    ├── monitoring-alerts-implementation-report.md
-    ├── monitoring-alerts-consolidated-report.md
-    ├── email-sms-configuration-guide.md
-    ├── balance-calculation-carryover-logic.md
-    ├── model.ndm2
-    ├── model1.ndm2
-    ├── update-pool-percent.sql
-    └── network_crm_calculate.txt
-```
-
---
-
-## ⚠️ نکته مهم
-
-**تمام فایل‌های markdown به `totalDoc/` منتقل شده‌اند** (MOVED نه COPIED).
-
- ✅ فایل‌های `.md` فقط در `totalDoc/` هستند
- ✅ فایل‌های دیگر (SQL, NDM2, TXT) در مسیرهای اصلی باقی‌مانده‌اند
- ✅ تغییرات مستقیماً در `totalDoc/` انجام می‌شود
- ❌ دیگر نیازی به همگام‌سازی نیست
-
---
@@ -1,353 +0,0 @@
-# 🚀 Quick Start - شروع سریع توسعه
-
-**برای توسعه‌دهنده جدید یا بازگشت به پروژه**
-
---
-
-## 📖 مرحله 1: مطالعه مستندات (30 دقیقه)
-
-### الزامی:
-```bash
-cd /home/masoud/Apps/project/FourSat/totalDoc
-
-# 1. شروع از INDEX
-cat INDEX.md
-
-# 2. درک بیزینس
-cat CMS/network-club-commission-system-v1.1.md
-
-# 3. وضعیت فعلی
-cat REMAINING-TASKS.md
-
-# 4. مقایسه CMS vs BFF
-cat CMS-API-COVERAGE.md
-```
-
---
-
-## 🎯 مرحله 2: انتخاب تسک (5 دقیقه)
-
-### چک‌لیست قبل از شروع:
- [ ] تسک از `REMAINING-TASKS.md` انتخاب شد؟
- [ ] اولویت مشخص است؟ (🔴 بالا / 🟡 متوسط / 🟢 پایین)
- [ ] بیزینس در `network-club-commission-system-v1.1.md` مستند است؟
- [ ] تأثیر روی سرویس‌های دیگر مشخص است؟
-
-### تسک فعلی (هفته 1):
-```
-🔴 Transaction System (درگاه پرداخت)
-├─ CMS: 3 روز
-├─ BackOffice.BFF: 2 روز  
-└─ BackOffice UI: 2 روز
-```
-
---
-
-## 💻 مرحله 3: Setup محیط توسعه
-
-### CMS
-```bash
-cd /home/masoud/Apps/project/FourSat/CMS/src
-
-# Build
-dotnet build
-
-# Run (با Hangfire Dashboard)
-cd CMSMicroservice.WebApi
-dotnet run --urls="http://localhost:5133"
-
-# Check Health
-curl http://localhost:5133/health
-
-# Hangfire Dashboard
-# http://localhost:5133/hangfire
-```
-
-### BackOffice.BFF
-```bash
-cd /home/masoud/Apps/project/FourSat/BackOffice.BFF/src
-
-# Build
-dotnet build
-
-# Run
-cd BackOffice.BFF.WebApi
-dotnet run --urls="http://localhost:5000"
-
-# Check
-curl http://localhost:5000/health
-```
-
-### BackOffice (UI)
-```bash
-cd /home/masoud/Apps/project/FourSat/BackOffice/src
-
-# Build
-dotnet build
-
-# Run
-cd BackOffice
-dotnet run
-
-# Browser: http://localhost:5001
-```
-
---
-
-## 📝 مرحله 4: پیاده‌سازی (به ترتیب)
-
-### 1️⃣ CMS (Backend)
-
-#### الف. Entity & Migration
-```bash
-cd CMS/src/CMSMicroservice.Domain/Entities
-
-# 1. ایجاد Entity
-# مثال: Transaction.cs
-
-# 2. اضافه کردن به DbContext
-cd ../CMSMicroservice.Infrastructure/Data
-
-# 3. ایجاد Migration
-dotnet ef migrations add AddTransaction -s ../../CMSMicroservice.WebApi
-
-# 4. اعمال Migration
-dotnet ef database update -s ../../CMSMicroservice.WebApi
-```
-
-#### ب. Commands & Queries
-```bash
-cd CMS/src/CMSMicroservice.Application
-
-# ساختار:
-TransactionCQ/
-├── CreateTransactionCommand.cs
-├── CreateTransactionCommandHandler.cs
-├── GetTransactionQuery.cs
-└── GetTransactionQueryHandler.cs
-```
-
-#### ج. Protobuf
-```bash
-cd CMS/src/CMSMicroservice.Protobuf/Protos
-
-# 1. ویرایش transactions.proto
-# 2. Build پروژه (auto-generate C# code)
-dotnet build
-```
-
-#### د. gRPC Service
-```bash
-cd CMS/src/CMSMicroservice.WebApi/GrpcServices
-
-# ایجاد TransactionGrpcService.cs
-```
-
-#### ✅ داکیومنت CMS
-```bash
-cd /home/masoud/Apps/project/FourSat/totalDoc
-
-# به‌روزرسانی:
-# - CMS/implementation-progress.md
-# - REMAINING-TASKS.md (mark as done)
-```
-
---
-
-### 2️⃣ BackOffice.BFF (Gateway)
-
-#### الف. Handler
-```bash
-cd BackOffice.BFF/src/BackOffice.BFF.Application/Handlers
-
-# ساختار:
-TransactionHandlers/
-├── CreateTransactionHandler.cs
-├── GetTransactionHandler.cs
-└── GetAllTransactionsHandler.cs
-```
-
-#### ب. DTOs
-```bash
-cd BackOffice.BFF/src/BackOffice.BFF.Application/DTOs
-
-# TransactionDto.cs
-```
-
-#### ج. Controller
-```bash
-cd BackOffice.BFF/src/BackOffice.BFF.WebApi/Controllers
-
-# TransactionController.cs
-[ApiController]
-[Route("api/transactions")]
-```
-
-#### ✅ داکیومنت BFF
-```bash
-# به‌روزرسانی:
-# - BackOffice.BFF/cms-integration.md
-```
-
---
-
-### 3️⃣ BackOffice (Admin UI)
-
-#### الف. صفحه جدید
-```bash
-cd BackOffice/src/BackOffice/Pages
-
-# Transactions/
-# ├── Index.razor (لیست)
-# ├── Details.razor (جزئیات)
-# └── Transactions.razor.cs (Code-behind)
-```
-
-#### ب. Service
-```bash
-cd BackOffice/src/BackOffice/Services
-
-# TransactionService.cs
-```
-
-#### ج. Menu Item
-```bash
-# اضافه کردن به Shared/NavMenu.razor
-```
-
-#### ✅ داکیومنت UI
-```bash
-# به‌روزرسانی:
-# - BackOffice/development-plan.md
-```
-
---
-
-## 🧪 مرحله 5: تست
-
-### تست دستی:
-```bash
-# 1. CMS: Postman/gRPCurl
-grpcurl -plaintext localhost:5133 list
-
-# 2. BFF: Swagger
-# http://localhost:5000/swagger
-
-# 3. UI: Browser
-# http://localhost:5001
-```
-
-### چک‌لیست تست:
- [ ] API در CMS کار می‌کند؟
- [ ] Handler در BFF صحیح است؟
- [ ] صفحه در UI نمایش داده می‌شود؟
- [ ] سطوح دسترسی (SuperAdmin/Admin/Inspector) صحیح است؟
- [ ] Error handling درست است؟
-
---
-
-## 📋 مرحله 6: مقایسه با بیزینس
-
-### چک‌لیست بیزینس:
-```bash
-cd /home/masoud/Apps/project/FourSat/totalDoc
-
-# 1. باز کردن تمپلیت
-cp BUSINESS-VERIFICATION-TEMPLATE.md BUSINESS-CHECK-$(date +%Y-%m-%d).md
-
-# 2. پر کردن بخش مربوط به Transaction
-# 3. مقایسه کد با داکیومنت
-
-# مثال:
-# - آیا Transaction.Status درست است؟
-# - آیا ReferenceId ذخیره می‌شود؟
-# - آیا Gateway name صحیح است؟
-```
-
---
-
-## 💾 مرحله 7: Commit & Document
-
-### قبل از Commit:
-```bash
-# 1. مقایسه با داکیومنت
-cat totalDoc/CMS/network-club-commission-system-v1.1.md
-
-# 2. به‌روزرسانی داکیومنت
-vim totalDoc/CMS/implementation-progress.md
-
-# 3. Mark تسک as Done
-vim totalDoc/REMAINING-TASKS.md
-```
-
-### Commit Message:
-```bash
-git add .
-git commit -m "feat(CMS): Add Transaction System for payment gateway
-
- Add Transaction entity with Status/ReferenceId/Gateway
- Implement CreateTransaction, VerifyTransaction commands
- Add GetTransaction, GetAllTransactions queries
- Update Protobuf: transactions.proto
- Docs: CMS/implementation-progress.md updated
-
-Business: Payment gateway integration
-Impact: BackOffice.BFF needs TransactionHandler (next)
-"
-```
-
---
-
-## 🔄 مرحله 8: تکرار برای BFF و UI
-
-همین مراحل رو برای BackOffice.BFF و BackOffice UI تکرار کن.
-
---
-
-## 📚 مراجع سریع
-
-### مستندات:
- `INDEX.md` → فهرست کامل
- `REMAINING-TASKS.md` → تسک‌های باقی‌مانده
- `CMS-API-COVERAGE.md` → مقایسه CMS vs BFF
- `BUSINESS-VERIFICATION-TEMPLATE.md` → چک‌لیست بیزینس
-
-### بیزینس:
- `CMS/network-club-commission-system-v1.1.md` → بیزینس اصلی
- `CMS/balance-calculation-carryover-logic.md` → محاسبات
- `CMS/email-sms-configuration-guide.md` → اطلاع‌رسانی
-
-### پیشرفت:
- `CMS/implementation-progress.md` → وضعیت CMS
- `BackOffice/development-plan.md` → وضعیت BackOffice
-
---
-
-## ⚠️ نکات مهم
-
-### 🚫 اشتباهات رایج:
- ❌ شروع بدون مطالعه بیزینس
- ❌ فراموش کردن داکیومنت
- ❌ نادیده گرفتن سطوح دسترسی
- ❌ تست نکردن قبل از commit
-
-### ✅ بهترین روش‌ها:
- ✅ اول CMS، بعد BFF، بعد UI
- ✅ هر تسک = یک commit با داکیومنت
- ✅ هر هفته = مقایسه کد با بیزینس
- ✅ هر ماه = BUSINESS-VERIFICATION
-
---
-
-## 🆘 مشکل داری؟
-
-### چک‌لیست عیب‌یابی:
-1. آیا CMS در حال اجراست؟ → `curl http://localhost:5133/health`
-2. آیا BFF متصل به CMS است؟ → چک logs
-3. آیا Migration اعمال شده؟ → `dotnet ef database update`
-4. آیا Protobuf build شده؟ → `dotnet build`
-5. آیا بیزینس درست است؟ → مراجعه به `network-club-commission-system-v1.1.md`
-
---
-
-**موفق باشی! 🚀**
@@ -1,732 +0,0 @@
-# 📊 Monitoring & Alerts System - Consolidated Implementation Report
-
-**Date**: 2025-11-30  
-**Status**: ✅ Skeleton Implemented (30% Complete)  
-**Build**: ✅ Success  
-
---
-
-## 📋 Executive Summary
-
-اسکلت کامل سیستم Monitoring & Alerts پیاده‌سازی شد. این سیستم شامل دو بخش اصلی است:
-1. **Alert System**: اعلان‌های مدیریتی (Critical/Warning/Success) برای Admin
-2. **User Notification System**: اعلان‌های کاربری (SMS/Email/Push) برای Users
-
-فعلاً فقط Logging فعال است. Integration های اصلی (Sentry, Slack, SMS) آماده پیاده‌سازی هستند.
-
---
-
-## 🏗️ Architecture Overview
-
-```
-┌─────────────────────────────────────────────────────────┐
-│                  Application Layer                       │
-│  ┌─────────────────────┐  ┌─────────────────────────┐  │
-│  │  IAlertService      │  │ IUserNotificationService│  │
-│  │  - Critical         │  │ - Commission Received   │  │
-│  │  - Warning          │  │ - Club Activation       │  │
-│  │  - Success          │  │ - Payout Error          │  │
-│  └─────────────────────┘  └─────────────────────────┘  │
-└─────────────────────────────────────────────────────────┘
-                          ↓ implements
-┌─────────────────────────────────────────────────────────┐
-│              Infrastructure Layer                        │
-│  ┌─────────────────────┐  ┌─────────────────────────┐  │
-│  │   AlertService      │  │ UserNotificationService │  │
-│  │   ✅ Logging        │  │   ✅ Logging            │  │
-│  │   ⏳ Sentry         │  │   ⏳ SMS Gateway        │  │
-│  │   ⏳ Slack          │  │   ⏳ Email Service      │  │
-│  │   ⏳ Email          │  │   ⏳ Push Notification  │  │
-│  └─────────────────────┘  └─────────────────────────┘  │
-│                                                           │
-│  ┌──────────────────────────────────────────────────┐   │
-│  │         MonitoringSettings (Configuration)       │   │
-│  │  - SentryEnabled, SentryDsn                      │   │
-│  │  - SlackEnabled, SlackWebhookUrl                 │   │
-│  │  - EmailAlertsEnabled, AdminEmails               │   │
-│  │  - SmsNotificationsEnabled, SmsApiKey            │   │
-│  └──────────────────────────────────────────────────┘   │
-└─────────────────────────────────────────────────────────┘
-                          ↓ used by
-┌─────────────────────────────────────────────────────────┐
-│              Background Workers / Handlers               │
-│  ┌──────────────────────────────────────────────────┐   │
-│  │   WeeklyNetworkCommissionWorker                  │   │
-│  │   - On Success: SendSuccessNotificationAsync()   │   │
-│  │   - On Error: SendCriticalAlertAsync()           │   │
-│  └──────────────────────────────────────────────────┘   │
-│  ┌──────────────────────────────────────────────────┐   │
-│  │   ProcessUserPayoutsCommandHandler               │   │
-│  │   - On Payout: SendCommissionReceivedNotification│   │
-│  └──────────────────────────────────────────────────┘   │
-└─────────────────────────────────────────────────────────┘
-```
-
---
-
-## 📦 Implementation Details
-
-### 1️⃣ Alert Service (Admin Notifications)
-
-**Interface**: `CMSMicroservice.Application/Common/Interfaces/IAlertService.cs`
-
-```csharp
-public interface IAlertService
-{
-    Task SendCriticalAlertAsync(string title, string message, Exception? exception, CancellationToken ct);
-    Task SendWarningAlertAsync(string title, string message, CancellationToken ct);
-    Task SendSuccessNotificationAsync(string title, string message, CancellationToken ct);
-}
-```
-
-**Implementation**: `CMSMicroservice.Infrastructure/Services/Monitoring/AlertService.cs`
-
-**Current Behavior**:
-```
-🚨 CRITICAL ALERT: {Title} - {Message}
-⚠️ WARNING ALERT: {Title} - {Message}
-✅ SUCCESS: {Title} - {Message}
-```
-
-**Pending Integrations**:
- **Sentry**: Exception tracking & aggregation (TODO: `SentrySdk.CaptureException()`)
- **Slack**: Real-time alerts to channel (TODO: HTTP POST to webhook)
- **Email**: Alert emails to admin list (TODO: SMTP integration)
-
---
-
-### 2️⃣ User Notification Service
-
-**Interface**: `CMSMicroservice.Application/Common/Interfaces/IAlertService.cs` (same file)
-
-```csharp
-public interface IUserNotificationService
-{
-    Task SendCommissionReceivedNotificationAsync(long userId, decimal amount, int weekNumber, CancellationToken ct);
-    Task SendClubActivationNotificationAsync(long userId, CancellationToken ct);
-    Task SendPayoutErrorNotificationAsync(long userId, string errorMessage, CancellationToken ct);
-}
-```
-
-**Implementation**: `CMSMicroservice.Infrastructure/Services/Monitoring/UserNotificationService.cs`
-
-**Current Behavior**:
-```
-📧 Sending commission notification: User={UserId}, Amount={Amount}, Week={WeekNumber}
-🎉 Sending club activation notification: User={UserId}
-⚠️ Sending payout error notification: User={UserId}, Error={Error}
-```
-
-**Pending Integrations**:
- **SMS Gateway**: Kavenegar/Ghasedak integration (TODO: HTTP API call)
- **Email Service**: SMTP/SendGrid integration (TODO: template-based emails)
- **Push Notification**: FCM/OneSignal integration (TODO: mobile app notifications)
-
---
-
-### 3️⃣ Configuration Model
-
-**File**: `CMSMicroservice.Infrastructure/Services/Monitoring/MonitoringSettings.cs`
-
-```csharp
-public class MonitoringSettings
-{
-    public const string SectionName = "Monitoring";
-    
-    // Sentry
-    public bool SentryEnabled { get; set; }
-    public string? SentryDsn { get; set; }
-    
-    // Slack
-    public bool SlackEnabled { get; set; }
-    public string? SlackWebhookUrl { get; set; }
-    
-    // Email Alerts (Admin)
-    public bool EmailAlertsEnabled { get; set; }
-    public List<string> AdminEmails { get; set; }
-    
-    // SMS (User Notifications)
-    public bool SmsNotificationsEnabled { get; set; }
-    public string? SmsApiKey { get; set; }
-    public string? SmsGatewayUrl { get; set; }
-}
-```
-
-**Config File**: `CMSMicroservice.WebApi/appsettings.json`
-
-```json
-{
-  "Monitoring": {
-    "SentryEnabled": false,
-    "SentryDsn": "",
-    "SlackEnabled": false,
-    "SlackWebhookUrl": "",
-    "EmailAlertsEnabled": false,
-    "AdminEmails": ["admin@example.com"],
-    "SmsNotificationsEnabled": false,
-    "SmsApiKey": "",
-    "SmsGatewayUrl": ""
-  }
-}
-```
-
---
-
-### 4️⃣ Dependency Injection
-
-**File**: `CMSMicroservice.Infrastructure/ConfigureServices.cs`
-
-```csharp
-services.AddScoped<IAlertService, AlertService>();
-services.AddScoped<IUserNotificationService, UserNotificationService>();
-```
-
---
-
-### 5️⃣ Worker Integration
-
-**File**: `CMSMicroservice.Infrastructure/BackgroundJobs/WeeklyNetworkCommissionWorker.cs`
-
-**On Success**:
-```csharp
-await alertService.SendSuccessNotificationAsync(
-    "Weekly Commission Completed",
-    $"Week {previousWeekNumber}: {payoutsProcessed} payouts, {balancesToExpire.Count} balances expired");
-```
-
-**On Error**:
-```csharp
-await alertService.SendCriticalAlertAsync(
-    "Weekly Commission Worker Failed",
-    $"Worker execution {executionId} failed for week {GetPreviousWeekNumber()}",
-    ex,
-    cancellationToken);
-```
-
---
-
-## 🔌 Integration Roadmap
-
-### Priority 1: Sentry (High - 1 hour)
-
-**Why**: Critical error tracking & aggregation برای Production
-
-**Steps**:
-1. Install NuGet:
-   ```bash
-   dotnet add package Sentry.AspNetCore
-   ```
-
-2. Configure in `Program.cs`:
-   ```csharp
-   builder.WebHost.UseSentry(options =>
-   {
-       options.Dsn = builder.Configuration["Monitoring:SentryDsn"];
-       options.Environment = builder.Environment.EnvironmentName;
-       options.TracesSampleRate = 1.0;
-   });
-   ```
-
-3. Update `AlertService.SendCriticalAlertAsync()`:
-   ```csharp
-   if (_settings.SentryEnabled && exception != null)
-   {
-       SentrySdk.CaptureException(exception, scope =>
-       {
-           scope.SetTag("alert.title", title);
-           scope.SetExtra("message", message);
-       });
-   }
-   ```
-
-4. Set DSN in `appsettings.Production.json`:
-   ```json
-   {
-     "Monitoring": {
-       "SentryEnabled": true,
-       "SentryDsn": "https://xxxxx@sentry.io/12345"
-     }
-   }
-   ```
-
---
-
-### Priority 2: Slack Webhook (Medium - 2 hours)
-
-**Why**: Real-time alerts به تیم Development/DevOps
-
-**Steps**:
-1. Create Incoming Webhook در Slack:
-   - Go to: `https://api.slack.com/apps`
-   - Create app → Incoming Webhooks → Add to channel
-   - Copy Webhook URL
-
-2. Update `AlertService`:
-   ```csharp
-   private readonly HttpClient _httpClient;
-   
-   public async Task SendCriticalAlertAsync(...)
-   {
-       _logger.LogCritical(exception, "🚨 {Title} - {Message}", title, message);
-       
-       if (_settings.SlackEnabled)
-       {
-           var payload = new
-           {
-               text = $"🚨 *{title}*",
-               attachments = new[]
-               {
-                   new
-                   {
-                       color = "danger",
-                       text = message,
-                       fields = exception != null ? new[]
-                       {
-                           new { title = "Exception", value = exception.Message, @short = false }
-                       } : null
-                   }
-               }
-           };
-           
-           await _httpClient.PostAsJsonAsync(_settings.SlackWebhookUrl, payload);
-       }
-   }
-   ```
-
-3. Set Webhook URL in config:
-   ```json
-   {
-     "Monitoring": {
-       "SlackEnabled": true,
-       "SlackWebhookUrl": "https://hooks.slack.com/services/T00/B00/XXX"
-     }
-   }
-   ```
-
---
-
-### Priority 3: SMS Gateway - Kavenegar (Medium - 3 hours)
-
-**Why**: اطلاع‌رسانی کمیسیون به کاربران
-
-**Steps**:
-1. Get API Key from Kavenegar:
-   - Sign up: `https://panel.kavenegar.com`
-   - API Key: Settings → API Key
-
-2. Create `ISmsGatewayService`:
-   ```csharp
-   public interface ISmsGatewayService
-   {
-       Task SendAsync(string mobile, string message, CancellationToken ct = default);
-   }
-   ```
-
-3. Implement `KavenegarSmsService`:
-   ```csharp
-   public class KavenegarSmsService : ISmsGatewayService
-   {
-       private readonly HttpClient _httpClient;
-       private readonly string _apiKey;
-       
-       public async Task SendAsync(string mobile, string message, CancellationToken ct)
-       {
-           var url = $"https://api.kavenegar.com/v1/{_apiKey}/sms/send.json";
-           var payload = new
-           {
-               receptor = mobile,
-               message = message
-           };
-           
-           var response = await _httpClient.PostAsJsonAsync(url, payload, ct);
-           response.EnsureSuccessStatusCode();
-       }
-   }
-   ```
-
-4. Update `UserNotificationService.SendCommissionReceivedNotificationAsync()`:
-   ```csharp
-   var user = await _context.Users.FindAsync(userId, ct);
-   
-   if (user.SmsNotifications && _settings.SmsNotificationsEnabled)
-   {
-       var message = $"کمیسیون شما: {amount:N0} ریال برای هفته {weekNumber} واریز شد.";
-       await _smsGateway.SendAsync(user.Mobile, message, ct);
-   }
-   ```
-
-5. Configure:
-   ```json
-   {
-     "Monitoring": {
-       "SmsNotificationsEnabled": true,
-       "SmsApiKey": "your-kavenegar-api-key"
-     }
-   }
-   ```
-
---
-
-### Priority 4: Email Alerts for Admins (Low - 2 hours)
-
-**Why**: Backup notification channel
-
-**Options**:
- **A) MailKit (SMTP)**:
-  ```csharp
-  using var client = new SmtpClient();
-  await client.ConnectAsync("smtp.gmail.com", 587, SecureSocketOptions.StartTls);
-  await client.AuthenticateAsync("user@example.com", "password");
-  
-  var message = new MimeMessage();
-  message.From.Add(new MailboxAddress("CMS Alerts", "noreply@foursat.ir"));
-  message.To.Add(new MailboxAddress("Admin", adminEmail));
-  message.Subject = $"[ALERT] {title}";
-  message.Body = new TextPart("html") { Text = htmlMessage };
-  
-  await client.SendAsync(message);
-  ```
-
- **B) SendGrid API**:
-  ```csharp
-  var client = new SendGridClient(_settings.SendGridApiKey);
-  var msg = MailHelper.CreateSingleEmail(
-      from: new EmailAddress("noreply@foursat.ir", "CMS Alerts"),
-      to: new EmailAddress(adminEmail),
-      subject: $"[ALERT] {title}",
-      plainTextContent: message,
-      htmlContent: htmlMessage
-  );
-  await client.SendEmailAsync(msg);
-  ```
-
-**Config**:
-```json
-{
-  "Monitoring": {
-    "EmailAlertsEnabled": true,
-    "AdminEmails": ["admin@foursat.ir", "devops@foursat.ir"],
-    "SmtpServer": "smtp.gmail.com",
-    "SmtpPort": 587,
-    "SmtpUsername": "user@example.com",
-    "SmtpPassword": "password"
-  }
-}
-```
-
---
-
-### Priority 5: Retry Logic با Exponential Backoff (Low - 1 hour)
-
-**Why**: بهبود Reliability در صورت خطاهای Transient
-
-**Implementation در Worker**:
-```csharp
-private async Task<T> RetryWithExponentialBackoffAsync<T>(
-    Func<Task<T>> operation,
-    int maxRetries = 3,
-    CancellationToken ct = default)
-{
-    for (int attempt = 0; attempt <= maxRetries; attempt++)
-    {
-        try
-        {
-            return await operation();
-        }
-        catch (Exception ex) when (attempt < maxRetries && IsTransientError(ex))
-        {
-            var delay = TimeSpan.FromSeconds(Math.Pow(2, attempt)); // 2^n: 1s, 2s, 4s
-            
-            _logger.LogWarning(ex,
-                "Attempt {Attempt}/{MaxRetries} failed. Retrying in {Delay}s...",
-                attempt + 1, maxRetries, delay.TotalSeconds);
-            
-            await Task.Delay(delay, ct);
-        }
-    }
-    
-    throw new InvalidOperationException($"Operation failed after {maxRetries} retries");
-}
-
-private bool IsTransientError(Exception ex)
-{
-    return ex is TimeoutException
-        || ex is HttpRequestException
-        || (ex is SqlException sqlEx && sqlEx.IsTransient);
-}
-```
-
-**Usage**:
-```csharp
-// در ExecuteWeeklyCalculationAsync():
-var balancesCalculated = await RetryWithExponentialBackoffAsync(async () =>
-{
-    return await mediator.Send(new CalculateWeeklyBalancesCommand
-    {
-        WeekNumber = previousWeekNumber
-    }, cancellationToken);
-}, maxRetries: 3, ct: cancellationToken);
-```
-
---
-
-## 🧪 Testing Guide
-
-### Test 1: Alert Service (Console Logging)
-```csharp
-// در Controller یا Handler:
-var alertService = _serviceProvider.GetRequiredService<IAlertService>();
-
-await alertService.SendCriticalAlertAsync(
-    "Test Critical Alert",
-    "این یک تست برای Alert Service است",
-    new Exception("Sample exception"));
-
-await alertService.SendSuccessNotificationAsync(
-    "Test Success",
-    "عملیات با موفقیت انجام شد");
-```
-
-**Expected Output**:
-```
-🚨 CRITICAL ALERT: Test Critical Alert - این یک تست برای Alert Service است
-✅ SUCCESS: Test Success - عملیات با موفقیت انجام شد
-```
-
---
-
-### Test 2: User Notification Service
-```csharp
-var notificationService = _serviceProvider.GetRequiredService<IUserNotificationService>();
-
-await notificationService.SendCommissionReceivedNotificationAsync(
-    userId: 123,
-    amount: 500_000,
-    weekNumber: 48);
-```
-
-**Expected Output**:
-```
-📧 Sending commission notification: User=123, Amount=500000, Week=48
-```
-
---
-
-### Test 3: Worker Integration
-```bash
-# Run Worker manually (for testing)
-# تغییر زمان اجرا به 1 دقیقه بعد برای تست:
-# در Worker: var delay = TimeSpan.FromMinutes(1);
-dotnet run --project CMSMicroservice.WebApi
-```
-
-**Expected**:
- Worker starts
- After 1 minute → Executes calculation
- On success → Logs: `✅ SUCCESS: Weekly Commission Completed`
- On error → Logs: `🚨 CRITICAL ALERT: Weekly Commission Worker Failed`
-
---
-
-### Test 4: Sentry Integration (بعد از پیاده‌سازی)
-```csharp
-// Throw یک exception برای تست:
-throw new InvalidOperationException("Test Sentry integration");
-```
-
-**Check**: Sentry dashboard → Issues → باید exception جدید نمایش داده شود
-
---
-
-### Test 5: Slack Integration (بعد از پیاده‌سازی)
-```csharp
-await alertService.SendCriticalAlertAsync("Test Slack", "Testing webhook integration", null);
-```
-
-**Check**: Slack channel → باید پیام جدید نمایش داده شود
-
---
-
-### Test 6: SMS Integration (بعد از پیاده‌سازی)
-```csharp
-await notificationService.SendCommissionReceivedNotificationAsync(
-    userId: YOUR_USER_ID,  // با شماره موبایل معتبر
-    amount: 100_000,
-    weekNumber: 48);
-```
-
-**Check**: موبایل کاربر → باید SMS دریافت شود
-
---
-
-## 📊 Current Status & Progress
-
-| Component | Status | Completion | Notes |
-|-----------|--------|------------|-------|
-| **Interfaces** | ✅ Done | 100% | `IAlertService`, `IUserNotificationService` |
-| **Skeleton Implementations** | ✅ Done | 100% | Logging only |
-| **Configuration Model** | ✅ Done | 100% | `MonitoringSettings` |
-| **DI Registration** | ✅ Done | 100% | In `ConfigureServices.cs` |
-| **Worker Integration** | ✅ Done | 100% | Success + Error alerts |
-| **appsettings Structure** | ✅ Done | 100% | Monitoring section added |
-| **Sentry Integration** | ⏳ Pending | 0% | Install package + configure DSN |
-| **Slack Webhook** | ⏳ Pending | 0% | Create webhook + implement POST |
-| **SMS Gateway** | ⏳ Pending | 0% | Choose provider + get API key |
-| **Email Alerts** | ⏳ Pending | 0% | SMTP/SendGrid integration |
-| **Retry Logic** | ⏳ Pending | 0% | Exponential backoff implementation |
-| **Testing** | ⏳ Pending | 0% | Unit + Integration tests |
-
-**Overall Progress**: 30% ✅ | 70% ⏳
-
---
-
-## 📝 Important Notes
-
-### 1. Production Readiness
- ⚠️ **فعلاً فقط Logging فعال است**
- ⚠️ برای Production **حداقل Sentry** باید فعال شود
- ⚠️ برای Critical systems حتماً Slack هم اضافه شود
-
-### 2. User Preferences
- SMS/Email/Push باید بر اساس تنظیمات کاربر (`User.SmsNotifications`, etc.) ارسال شود
- در `UserNotificationService` باید ابتدا preferences چک شود
-
-### 3. Rate Limiting
- برای SMS Gateway باید Rate Limiting در نظر گرفته شود
- پیشنهاد: استفاده از Queue (Hangfire/RabbitMQ) برای ارسال تعداد زیاد SMS
-
-### 4. Cost Management
- SMS و Email هزینه دارند
- پیشنهاد: Batching برای ارسال گروهی
- پیشنهاد: Template-based messaging برای کاهش هزینه
-
-### 5. Security
- API Keys در `appsettings.json` نباید commit شوند
- استفاده از Environment Variables یا Azure Key Vault
- مثال: `SmsApiKey: ${SMS_API_KEY}` در appsettings
-
-### 6. Monitoring the Monitor
- خود Alert System هم باید Monitor شود
- اگر Slack/SMS fail شد، باید Fallback به Email یا Log باشد
- پیشنهاد: Dead Letter Queue برای failed notifications
-
---
-
-## 🔗 File Reference Map
-
-```
-CMS/
-├── src/
-│   ├── CMSMicroservice.Application/
-│   │   └── Common/
-│   │       └── Interfaces/
-│   │           └── IAlertService.cs ⭐
-│   │
-│   ├── CMSMicroservice.Infrastructure/
-│   │   ├── Services/
-│   │   │   └── Monitoring/
-│   │   │       ├── AlertService.cs ⭐
-│   │   │       ├── UserNotificationService.cs ⭐
-│   │   │       └── MonitoringSettings.cs ⭐
-│   │   │
-│   │   ├── BackgroundJobs/
-│   │   │   └── WeeklyNetworkCommissionWorker.cs ✏️ (Modified)
-│   │   │
-│   │   └── ConfigureServices.cs ✏️ (Modified)
-│   │
-│   └── CMSMicroservice.WebApi/
-│       └── appsettings.json ✏️ (Modified)
-│
-└── docs/
-    └── monitoring-alerts-implementation-report.md 📄 (This file)
-```
-
-**Legend**:
- ⭐ = New file created
- ✏️ = Existing file modified
- 📄 = Documentation
-
---
-
-## 🚀 Next Action Items
-
-### Immediate (این هفته):
-1. ✅ Review this document
-2. ⏳ Decision: کدام Integration اول؟ (پیشنهاد: Sentry)
-3. ⏳ Get credentials:
-   - Sentry DSN
-   - Slack Webhook URL
-   - SMS Gateway API Key
-
-### Short-term (هفته آینده):
-4. ⏳ Implement Sentry integration
-5. ⏳ Implement Slack webhook
-6. ⏳ Test in Staging environment
-
-### Long-term (ماه آینده):
-7. ⏳ Implement SMS Gateway (Kavenegar)
-8. ⏳ Add Email alerts
-9. ⏳ Implement Retry logic
-10. ⏳ Write Unit/Integration tests
-11. ⏳ Deploy to Production
-
---
-
-## 📞 Contact & Support
-
-**Implementation Questions**:
- Developer: GitHub Copilot (این گزارش)
- Review: Development Team
-
-**Service Providers**:
- **Sentry**: https://sentry.io (Error tracking)
- **Slack**: https://api.slack.com/messaging/webhooks (Webhooks)
- **Kavenegar**: https://kavenegar.com (SMS Gateway - Iran)
- **Ghasedak**: https://ghasedak.me (SMS Gateway Alternative)
- **SendGrid**: https://sendgrid.com (Email service)
-
---
-
-**Last Updated**: 2025-11-30  
-**Build Status**: ✅ Success  
-**Ready for**: Integration implementation
-
---
-
-## 🎯 TL;DR (خلاصه برای رجوع سریع)
-
-### چی ساخته شد:
- ✅ `IAlertService` + `AlertService` (Admin alerts)
- ✅ `IUserNotificationService` + `UserNotificationService` (User notifications)
- ✅ `MonitoringSettings` (Configuration model)
- ✅ Worker integration (Success/Error alerts)
- ✅ DI registration
- ✅ appsettings structure
-
-### فعلاً چی کار می‌کنه:
- Logging به Console (🚨 Critical, ⚠️ Warning, ✅ Success)
-
-### چی باید اضافه بشه:
-1. **Sentry** - Error tracking (Priority: High)
-2. **Slack** - Real-time alerts (Priority: Medium)
-3. **SMS Gateway** - User notifications (Priority: Medium)
-4. **Email** - Backup channel (Priority: Low)
-5. **Retry Logic** - Reliability (Priority: Low)
-
-### کجا باید نگاه کنی:
- Interfaces: `CMSMicroservice.Application/Common/Interfaces/IAlertService.cs`
- Implementations: `CMSMicroservice.Infrastructure/Services/Monitoring/`
- Worker: `CMSMicroservice.Infrastructure/BackgroundJobs/WeeklyNetworkCommissionWorker.cs`
- Config: `CMSMicroservice.WebApi/appsettings.json`
-
-### چطوری تست کنی:
-```csharp
-await alertService.SendCriticalAlertAsync("Test", "Message", null);
-// Output: 🚨 CRITICAL ALERT: Test - Message
-```
-
-### بعدش چیکار کنم:
-1. Get Sentry DSN → Update appsettings.Production.json
-2. Install `Sentry.AspNetCore` → Configure in Program.cs
-3. Update `AlertService.SendCriticalAlertAsync()` → Add `SentrySdk.CaptureException()`
-4. Test → Deploy
@@ -1,333 +0,0 @@
-# 📊 Monitoring & Alerts System - Implementation Report
-
-**Date**: 2025-11-30  
-**Status**: ✅ Skeleton Implemented  
-**Completion**: 30% (Structure ready, integrations pending)
-
---
-
-## 🎯 Overview
-
-اسکلت سیستم **Monitoring & Alerts** برای پروژه CMS پیاده‌سازی شد. این سیستم به دو بخش اصلی تقسیم می‌شود:
-
-1. **Alert System**: برای ارسال اعلان‌های مدیریتی (Critical Errors, Warnings, Success)
-2. **User Notification System**: برای ارسال پیام به کاربران (کمیسیون، پرداخت، فعال‌سازی باشگاه)
-
---
-
-## 📦 Files Created/Modified
-
-### ✨ New Files:
-
-1. **`IAlertService.cs`** (Interface)
-   - `SendCriticalAlertAsync()` - برای خطاهای Critical
-   - `SendWarningAlertAsync()` - برای Warning ها
-   - `SendSuccessNotificationAsync()` - برای موفقیت‌ها
-
-2. **`IUserNotificationService.cs`** (Interface)
-   - `SendCommissionReceivedNotificationAsync()` - اعلان دریافت کمیسیون
-   - `SendClubActivationNotificationAsync()` - اعلان فعال‌سازی باشگاه
-   - `SendPayoutErrorNotificationAsync()` - اعلان خطا در پرداخت
-
-3. **`AlertService.cs`** (Implementation - Skeleton)
-   - ✅ Logging به Console
-   - ⏳ TODO: Sentry Integration
-   - ⏳ TODO: Slack Integration
-   - ⏳ TODO: Email Integration
-
-4. **`UserNotificationService.cs`** (Implementation - Skeleton)
-   - ✅ Logging به Console
-   - ⏳ TODO: SMS Gateway Integration
-   - ⏳ TODO: Email Service Integration
-   - ⏳ TODO: Push Notification Integration
-
-5. **`MonitoringSettings.cs`** (Configuration Model)
-   - تنظیمات Sentry, Slack, Email, SMS
-   - قابل تنظیم از طریق `appsettings.json`
-
---
-
-### ✏️ Modified Files:
-
-1. **`ConfigureServices.cs`**
-   ```csharp
-   services.AddScoped<IAlertService, AlertService>();
-   services.AddScoped<IUserNotificationService, UserNotificationService>();
-   ```
-
-2. **`WeeklyNetworkCommissionWorker.cs`**
-   - ✅ Integration با `IAlertService`
-   - ✅ ارسال Critical Alert در صورت خطا
-   - ✅ ارسال Success Notification پس از اتمام موفق
-
-3. **`appsettings.json`**
-   - اضافه شدن بخش `Monitoring` با تنظیمات پیش‌فرض
-
---
-
-## 🔧 Current Implementation
-
-### Alert System Usage:
-
-```csharp
-// در Worker یا هر Handler دیگر:
-try
-{
-    // عملیات خطرناک
-}
-catch (Exception ex)
-{
-    await _alertService.SendCriticalAlertAsync(
-        "Operation Failed",
-        "Description of what went wrong",
-        ex);
-}
-```
-
-### Current Output:
-```
-🚨 CRITICAL ALERT: Weekly Commission Worker Failed - Worker execution abc-123 failed for week 2025-W48
-```
-
---
-
-## ⏳ Pending Integrations (TODO)
-
-### 1. Sentry Integration
-```csharp
-// در AlertService.SendCriticalAlertAsync():
-if (_settings.SentryEnabled)
-{
-    SentrySdk.CaptureException(exception);
-}
-```
-
-**Steps**:
- Install NuGet: `Sentry.AspNetCore`
- Configure DSN in `appsettings.json`
- Add to `Program.cs`: `builder.WebHost.UseSentry()`
-
---
-
-### 2. Slack Integration
-```csharp
-// در AlertService:
-if (_settings.SlackEnabled)
-{
-    var payload = new
-    {
-        text = $"🚨 {title}",
-        attachments = new[]
-        {
-            new { text = message, color = "danger" }
-        }
-    };
-    
-    await _httpClient.PostAsJsonAsync(_settings.SlackWebhookUrl, payload);
-}
-```
-
-**Steps**:
- Create Slack Incoming Webhook
- Add URL to `appsettings.json`
- Install NuGet: `System.Net.Http.Json`
-
---
-
-### 3. Email Alerts (برای Admin)
-```csharp
-// در AlertService:
-if (_settings.EmailAlertsEnabled)
-{
-    foreach (var email in _settings.AdminEmails)
-    {
-        await _emailService.SendAsync(
-            to: email,
-            subject: $"[ALERT] {title}",
-            body: message);
-    }
-}
-```
-
-**Steps**:
- Configure SMTP settings
- Install NuGet: `MailKit` or use existing email service
- Add admin emails to config
-
---
-
-### 4. SMS Notifications (برای کاربران)
-```csharp
-// در UserNotificationService.SendCommissionReceivedNotificationAsync():
-var user = await _context.Users.FindAsync(userId);
-
-if (user.SmsNotifications && _settings.SmsNotificationsEnabled)
-{
-    var message = $"کمیسیون شما: {amount:N0} ریال برای هفته {weekNumber} واریز شد.";
-    
-    await _smsGateway.SendAsync(user.Mobile, message);
-}
-```
-
-**Steps**:
- Choose SMS provider (Kavenegar, Ghasedak, etc.)
- Get API Key
- Implement `ISmsGatewayService`
-
---
-
-### 5. Retry Logic با Exponential Backoff
-```csharp
-// در Worker:
-private async Task<T> RetryWithExponentialBackoff<T>(
-    Func<Task<T>> operation,
-    int maxRetries = 3)
-{
-    for (int i = 0; i < maxRetries; i++)
-    {
-        try
-        {
-            return await operation();
-        }
-        catch (Exception ex) when (i < maxRetries - 1)
-        {
-            var delay = TimeSpan.FromSeconds(Math.Pow(2, i)); // 2^i seconds
-            _logger.LogWarning("Retry {Attempt}/{Max} after {Delay}s", 
-                i + 1, maxRetries, delay.TotalSeconds);
-            await Task.Delay(delay);
-        }
-    }
-}
-```
-
---
-
-## 📋 Configuration Example
-
-در `appsettings.Production.json`:
-
-```json
-{
-  "Monitoring": {
-    "SentryEnabled": true,
-    "SentryDsn": "https://xxxxx@sentry.io/12345",
-    
-    "SlackEnabled": true,
-    "SlackWebhookUrl": "https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXX",
-    
-    "EmailAlertsEnabled": true,
-    "AdminEmails": [
-      "admin@foursat.ir",
-      "devops@foursat.ir"
-    ],
-    
-    "SmsNotificationsEnabled": true,
-    "SmsApiKey": "your-kavenegar-api-key",
-    "SmsGatewayUrl": "https://api.kavenegar.com/v1/{apikey}/sms/send.json"
-  }
-}
-```
-
---
-
-## 🧪 Testing
-
-### Test 1: Alert Service
-```csharp
-var alertService = serviceProvider.GetRequiredService<IAlertService>();
-
-await alertService.SendCriticalAlertAsync(
-    "Test Alert",
-    "This is a test critical alert");
-```
-
-**Expected**: Log در Console + (در Production) Sentry + Slack
-
---
-
-### Test 2: User Notification
-```csharp
-var notificationService = serviceProvider.GetRequiredService<IUserNotificationService>();
-
-await notificationService.SendCommissionReceivedNotificationAsync(
-    userId: 123,
-    amount: 500_000,
-    weekNumber: 48);
-```
-
-**Expected**: Log در Console + (در Production) SMS + Email
-
---
-
-## 📊 Integration Priority
-
-| Priority | Integration | Effort | Impact |
-|----------|------------|--------|--------|
-| 🔴 High | Sentry | 1 hour | Critical error tracking |
-| 🟡 Medium | Slack | 2 hours | Real-time admin alerts |
-| 🟡 Medium | SMS (Kavenegar) | 3 hours | User notifications |
-| 🟢 Low | Email Alerts | 2 hours | Backup notification channel |
-| 🟢 Low | Retry Logic | 1 hour | Reliability improvement |
-
---
-
-## ✅ Current Status Summary
-
-### Completed (30%):
- ✅ Interface definitions
- ✅ Skeleton implementations with Logging
- ✅ DI registration
- ✅ Worker integration
- ✅ Configuration model
- ✅ appsettings structure
-
-### Pending (70%):
- ⏳ Sentry integration (5%)
- ⏳ Slack webhook (10%)
- ⏳ Email service (10%)
- ⏳ SMS gateway (15%)
- ⏳ Push notifications (10%)
- ⏳ Retry logic (5%)
- ⏳ Testing (10%)
- ⏳ Documentation (5%)
-
---
-
-## 🚀 Next Steps
-
-1. **Immediate** (در صورت نیاز):
-   - Enable Sentry for error tracking
-   - Setup Slack webhook for critical alerts
-
-2. **Short-term** (هفته آینده):
-   - Integrate SMS gateway (Kavenegar)
-   - Test User notifications
-
-3. **Long-term** (ماه آینده):
-   - Add Email service
-   - Implement Retry logic
-   - Push notification service
-
---
-
-## 📝 Notes
-
- تمام TODO ها در کد با comment مشخص شده‌اند
- فعلاً فقط Logging فعال است
- برای Production باید حتماً یکی از Integration ها (Sentry/Slack) فعال شود
- SMS Gateway باید بر اساس پروژه انتخاب شود (Kavenegar, Ghasedak, etc.)
-
---
-
-## 🔗 Related Files
-
- **Interfaces**: `CMSMicroservice.Application/Common/Interfaces/IAlertService.cs`
- **Implementations**: `CMSMicroservice.Infrastructure/Services/Monitoring/`
- **Worker**: `CMSMicroservice.Infrastructure/BackgroundJobs/WeeklyNetworkCommissionWorker.cs`
- **Config**: `CMSMicroservice.WebApi/appsettings.json`
-
---
-
-**Report generated**: 2025-11-30  
-**Build Status**: ✅ Success  
-**Ready for**: Development continuation / Integration implementation
@@ -1,536 +0,0 @@
-# 🔍 گزارش تحلیل و مقایسه توضیحات جدید بیزینس
-
-**تاریخ تحلیل**: 2025-12-08  
-**آخرین به‌روزرسانی**: 2025-12-09  
-**تحلیل‌گر**: AI Assistant  
-**وضعیت**: ✅ تحلیل کامل شده + اصلاحات اعمال شد
-
---
-
-## 📊 خلاصه اجرایی (به‌روز شده)
-
-توضیحات جدید بیزینس دریافت و با **documentation موجود** و **کد پیاده‌سازی شده** مقایسه شد. نتیجه:
-
-✅ **95% سازگاری** - بخش اصلی محاسبات تعادل اصلاح و تایید شد  
-⚠️ **5% نیاز به اصلاح** - User Activation Flow و Worker حذف 2 هفته
-
-### ✅ تغییرات اعمال شده (2025-12-09):
-1. **محاسبات تعادل اصلاح شد**:
-   - ترتیب صحیح: تعادل → باقیمانده → سقف → فلش
-   - فلش از هر دو طرف محاسبه می‌شود
-   - کد کاملاً مطابق توضیحات بیزینس
-
-2. **Documentation به‌روزرسانی شد**:
-   - `balance-calculation-rules.md` با آخرین تغییرات
-   - مستند جدید با مثال‌های 5 لول عمقی
-
---
-
-## 1️⃣ مقایسه با Documentation موجود
-
-### ✅ موارد سازگار (مطابقت کامل):
-
-| # | موضوع | Doc موجود | توضیحات جدید | وضعیت |
-|---|-------|------------|---------------|--------|
-| 1 | شبکه باینری | Binary Tree (2 child max) | هر کاربر 2 نفر جذب می‌کنه | ✅ مطابق |
-| 2 | فرمول تعادل | `MIN(Left, Right)` | `MIN(دست راست، دست چپ)` | ✅ مطابق |
-| 3 | سقف 300 | `MaxWeeklyBalancesPerLeg = 300` | بیشتر از 300 تا نمیده | ✅ مطابق |
-| 4 | باقیمانده | Carryover logic implemented | میره برای هفته بعد | ✅ مطابق |
-| 5 | فلش (Flush) | > 300 flush می‌شود | مازاد 300 فلش میشه | ✅ مطابق |
-| 6 | Pool Contribution | 25M per user to pool | 25 میلیون تومان به استخر | ✅ مطابق |
-| 7 | محاسبه بازگشتی | Recursive tree traversal | هر نفر تعادلاش فقط برای خودش | ✅ مطابق |
-
-**فایل‌های مرجع:**
- ✅ `totalDoc/01-BUSINESS/balance-calculation-rules.md` (100% مطابقت)
- ✅ `totalDoc/01-BUSINESS/network-commission-system.md` (95% مطابقت)
- ✅ `totalDoc/01-BUSINESS/binary-tree-guide.md` (100% مطابقت)
-
---
-
-### ⚠️ موارد جزئی‌تر یا دقیق‌تر شده:
-
-| # | موضوع | Doc قبلی | توضیحات جدید | نوع تغییر |
-|---|-------|----------|---------------|-----------|
-| 1 | لینک معرفی | فرض بر فعال بودن | **فقط بعد از عضویت باشگاه** نمایش داده شود | 🔶 دقیق‌تر |
-| 2 | دیالوگ باشگاه | اختیاری | **الزامی** - بدون امضا لینک نمیاد | 🔶 اجباری شد |
-| 3 | حذف کاربر غیرفعال | ذکر نشده | **2 هفته** بعد حذف اتوماتیک | 🆕 قانون جدید |
-| 4 | محدودیت جذب | 2 child per node | اگر **2 نفر فعال** داشته باشه خطا | 🔶 دقیق‌تر (فعال) |
-| 5 | محاسبه فلش | توضیح تکنیکال | توضیح دقیق‌تر با مثال‌های عددی | 🔶 Clarification |
-
---
-
-### 🆕 موارد کاملاً جدید (در Doc قبلی نبود):
-
-1. **Worker حذف کاربران غیرفعال** (2 هفته):
-   - هیچ document یا کدی برای این وجود ندارد
-   - نیاز به پیاده‌سازی کامل
-
-2. **شرط نمایش لینک معرفی**:
-   - فقط بعد از امضای قرارداد باشگاه
-   - نیاز به چک کردن در Frontend/Backend
-
-3. **الزامی بودن دیالوگ باشگاه**:
-   - احتمالاً الآن اختیاری است
-   - باید اجباری شود
-
---
-
-## 2️⃣ مقایسه با کد فعلی
-
-### ✅ پیاده‌سازی‌های صحیح (مطابق توضیحات جدید - تایید شده 2025-12-09):
-
-#### 2.1 محاسبه تعادل با سقف 300 (اصلاح شده ✅)
-**کد فعلی در `CalculateWeeklyBalancesCommandHandler.cs`:**
-
-```csharp
-// ✅ مرحله 1: محاسبه تعادل اولیه (قبل از اعمال سقف)
-var totalBalances = Math.Min(leftTotal, rightTotal);
-
-// ✅ مرحله 2: محاسبه باقیمانده (قبل از سقف)
-var leftRemainder = leftTotal - totalBalances;
-var rightRemainder = rightTotal - totalBalances;
-
-// ✅ مرحله 3: اعمال سقف 300 (برای امتیاز نهایی)
-var cappedBalances = Math.Min(totalBalances, maxBalancesPerLeg);
-
-// ✅ مرحله 4: محاسبه فلش (از هر دو طرف)
-var flushedPerSide = totalBalances - cappedBalances;
-var totalFlushed = flushedPerSide * 2;
-```
-
-✅ **وضعیت**: کاملاً مطابق توضیحات جدید است (اصلاح شده در 2025-12-09)
-
-**مثال عددی مطابق:**
-```
-توضیحات جدید:
-  چپ=500، راست=600
-  تعادل=500
-  امتیاز=300
-  باقی چپ=0، باقی راست=100
-  فلش چپ=200، فلش راست=200، جمع=400
-
-کد فعلی:
-  leftTotal=500, rightTotal=600
-  totalBalances = MIN(500, 600) = 500 ✅
-  leftRemainder = 500 - 500 = 0 ✅
-  rightRemainder = 600 - 500 = 100 ✅
-  cappedBalances = MIN(500, 300) = 300 ✅
-  flushedPerSide = 500 - 300 = 200 ✅
-  totalFlushed = 200 × 2 = 400 ✅
-```
-
---
-
-#### 2.2 محاسبه بازگشتی (هر نفر تعادلش برای خودش)
-**کد فعلی:**
-
-```csharp
-// CountNewMembersRecursive - خطوط 163-196
-// هر نفر به صورت مجزا محاسبه می‌شود
-// تعادل فرزندان به والد منتقل نمی‌شود (درست)
-```
-
-✅ **وضعیت**: مطابق با منطق "هر نفر تعادلاش فقط برای خودش"
-
---
-
-#### 2.3 Pool Contribution (25M per user)
-**کد فعلی:**
-
-```csharp
-// خطوط 56-58
-var activationFee = long.Parse(configs.GetValueOrDefault("Club.ActivationFee", "25000000"));
-var poolPercent = decimal.Parse(configs.GetValueOrDefault("Commission.WeeklyPoolContributionPercent", "20")) / 100m;
-
-// خط 98
-var weeklyPoolContribution = (long)(totalNewMembers * activationFee * poolPercent);
-```
-
-✅ **وضعیت**: دقیقاً مطابق (25M × 20% = 5M per user به استخر)
-
---
-
-### ❌ پیاده‌سازی‌های ناقص یا نادرست:
-
-#### 2.4 نمایش لینک معرفی (شرط الزامی باشگاه)
-**کد فعلی**: بررسی نشد اما احتمالاً فقط چک می‌کند:
-```csharp
-// فرض: Frontend فقط IsActive چک می‌کند
-if (user.IsActive) {
-    ShowReferralLink();
-}
-```
-
-❌ **باید باشد**:
-```csharp
-if (user.IsActive && user.ClubMembershipId != null && user.ClubMembership.IsActive) {
-    ShowReferralLink();
-}
-```
-
-**فایل‌های مشکوک**:
- `FrontOffice/src/.../Dashboard` یا `Profile` صفحات
- Backend validation در UserCQ
-
---
-
-#### 2.5 الزامی بودن دیالوگ باشگاه
-**وضعیت فعلی**: احتمالاً اختیاری است
-
-❌ **باید**: 
- بعد از پرداخت 56M، دیالوگ باشگاه بیاد
- **تا امضا نکنه** هیچ جای دیگه نره
- بعد از امضا → لینک معرفی نمایش داده شود
-
-**نیاز به بررسی**:
- `FrontOffice` → Payment Success Page
- `BackOffice` → User Activation Flow
-
---
-
-#### 2.6 Worker حذف کاربران غیرفعال (2 هفته)
-**کد فعلی**: 🔴 **هیچ چیزی وجود ندارد!**
-
-❌ **باید پیاده‌سازی شود**:
-```csharp
-// فایل جدید: DeleteInactiveUsersJob.cs
-
-public class DeleteInactiveUsersJob : BackgroundService
-{
-    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
-    {
-        while (!stoppingToken.IsCancellationRequested)
-        {
-            // روزانه یک بار (3 صبح)
-            var now = DateTime.Now;
-            var twoWeeksAgo = now.AddDays(-14);
-            
-            // کاربران غیرفعال بیش از 2 هفته
-            var inactiveUsers = await _context.Users
-                .Where(u => u.Created < twoWeeksAgo
-                         && u.ClubMembershipId == null
-                         && !u.IsActive)
-                .ToListAsync();
-                
-            foreach (var user in inactiveUsers)
-            {
-                // حذف کاربر
-                _context.Users.Remove(user);
-                
-                // آزاد کردن جایگاه در شبکه معرف
-                // (منطق Network Parent Position)
-            }
-            
-            await _context.SaveChangesAsync();
-            await Task.Delay(TimeSpan.FromDays(1), stoppingToken);
-        }
-    }
-}
-```
-
-**وضعیت**: 🆕 **نیاز به پیاده‌سازی کامل**
-
---
-
-#### 2.7 محدودیت جذب (2 نفر **فعال**)
-**کد فعلی** (فرضی):
-```csharp
-// احتمالاً فقط تعداد children چک می‌شود
-var childCount = await _context.Users
-    .CountAsync(u => u.NetworkParentId == parentId);
-    
-if (childCount >= 2) {
-    throw new Exception("Parent پر است");
-}
-```
-
-⚠️ **باید دقیق‌تر باشد**:
-```csharp
-var activeChildCount = await _context.Users
-    .CountAsync(u => u.NetworkParentId == parentId 
-                  && u.IsActive 
-                  && u.ClubMembershipId != null);
-    
-if (activeChildCount >= 2) {
-    throw new Exception("این کاربر تعداد زیرمجموعه‌هاش پر شده");
-}
-```
-
-**نیاز به بررسی**:
- `NetworkPlacementService.CalculateLegPositionAsync`
- یا هرجایی که Position Validation انجام می‌شود
-
---
-
-## 3️⃣ تناقضات شناسایی شده
-
-### 🔴 تناقض 1: تعریف "فعال"
-
-**توضیحات جدید**:
-> کاربر فعال = وام دایا گرفته **یا** پرداخت مستقیم کرده **و** عضو باشگاه شده
-
-**کد فعلی** (احتمالی):
-```csharp
-// ممکن است فقط IsActive flag چک شود
-// یا فقط Payment چک شود
-```
-
-**راه حل**:
-```csharp
-// باید هر دو شرط چک شود
-bool isFullyActivated = user.IsActive 
-                     && user.ClubMembershipId != null 
-                     && user.ClubMembership.IsActive;
-```
-
---
-
-### 🔴 تناقض 2: زمان حذف کاربر غیرفعال
-
-**توضیحات جدید**: 
-> **2 هفته** بعد از ثبت نام
-
-**Documentation قبلی**:
-> هیچ ذکری نشده
-
-**کد فعلی**:
-> Worker وجود ندارد
-
-**راه حل**: پیاده‌سازی Worker جدید
-
---
-
-### 🔴 تناقض 3: Blocking UI تا امضای باشگاه
-
-**توضیحات جدید**:
-> **تا امضا نکنه نمیتونه لینک معرفیشو ببینه**
-
-**احتمال کد فعلی**:
-> ممکن است لینک معرفی بعد از Payment نمایش داده شود
-
-**راه حل**: 
-1. بعد از پرداخت → دیالوگ باشگاه (Modal)
-2. دیالوگ بسته نشود تا امضا کنه
-3. بعد از امضا → redirect to Dashboard
-4. لینک معرفی نمایش داده شود
-
---
-
-## 4️⃣ لیست Task های لازم برای اصلاح
-
-### 🔥 Priority 1 (Critical - تأثیر بر Business Logic):
-
-#### Task 1: پیاده‌سازی Worker حذف کاربران غیرفعال
-```yaml
-عنوان: DeleteInactiveUsersWorker
-محل: CMS/src/.../BackgroundWorkers/
-شرح:
-  - روزانه 1 بار اجرا شود
-  - کاربرانی که Created < Now - 14 روز
-  - و IsActive = false
-  - و ClubMembershipId = null
-  - حذف شوند
-  - جایگاه Network آزاد شود
-
-فایل‌های تأثیرگذار:
-  - CMS/BackgroundWorkers/DeleteInactiveUsersJob.cs (جدید)
-  - CMS/Program.cs (ثبت Worker)
-  
-تست:
-  - User ساخت کن با Created = 15 روز پیش
-  - Worker اجرا شود
-  - User حذف شده باشد
-```
-
---
-
-#### Task 2: الزامی کردن دیالوگ باشگاه مشتریان
-```yaml
-عنوان: Mandatory Club Membership Dialog
-محل: FrontOffice/Pages/Payment/Success یا Registration
-
-شرح:
-  - بعد از تأیید پرداخت 56M
-  - Modal باشگاه مشتریان باز شود
-  - Close button غیرفعال باشد
-  - تا امضا نکنه بسته نشود
-  - بعد از امضا: ClubMembershipId Set شود
-  - سپس redirect به Dashboard
-
-فایل‌های تأثیرگذار:
-  - FrontOffice/Pages/Payment/PaymentSuccess.razor
-  - FrontOffice/Components/ClubMembershipDialog.razor (جدید یا اصلاح)
-  - CMS/ClubMembershipCQ/CreateClubMembership Command
-
-تست:
-  - Payment Success → Modal بیاد
-  - Close نشود تا Sign کند
-  - بعد از Sign → User.ClubMembershipId != null
-```
-
---
-
-#### Task 3: شرط نمایش لینک معرفی
-```yaml
-عنوان: Referral Link Display Condition
-محل: FrontOffice/Pages/Dashboard یا Profile
-
-شرح:
-  - لینک معرفی فقط نمایش داده شود اگر:
-    * IsActive = true
-    * ClubMembershipId != null
-    * ClubMembership.IsActive = true
-  - اگر شرط برقرار نیست:
-    * پیغام: "برای دریافت لینک معرفی، ابتدا عضو باشگاه مشتریان شوید"
-    * دکمه "عضویت در باشگاه"
-
-فایل‌های تأثیرگذار:
-  - FrontOffice/Pages/Dashboard.razor.cs
-  - FrontOffice/Components/ReferralLinkSection.razor
-
-تست:
-  - User بدون ClubMembership → لینک نیاد
-  - User با ClubMembership فعال → لینک بیاد
-```
-
---
-
-### ⚠️ Priority 2 (Medium - بهبود Validation):
-
-#### Task 4: بررسی دقیق‌تر محدودیت 2 فرزند فعال
-```yaml
-عنوان: Active Children Validation
-محل: CMS/NetworkMembershipCQ یا NetworkPlacementService
-
-شرح:
-  - در هنگام ثبت نام، چک شود:
-    * تعداد children با شرط IsActive و ClubMembershipId != null
-  - اگر >= 2 بود:
-    * Exception: "این کاربر تعداد زیرمجموعه‌هاش پر شده"
-    * یا Auto-placement به parent خالی
-
-فایل‌های تأثیرگذار:
-  - CMS/Services/NetworkPlacementService.cs
-  - CMS/UserCQ/CreateUser/CreateUserCommandValidator.cs
-
-تست:
-  - Parent با 2 active child
-  - User جدید ثبت نام با این Parent
-  - Exception یا Auto-placement
-```
-
---
-
-#### Task 5: Validation ثبت نام با کد معرف پر
-```yaml
-عنوان: Full Parent Registration Error
-محل: FrontOffice/Pages/Register
-
-شرح:
-  - اگر ReferralCode وارد شد:
-    * API بررسی کند Parent پر است یا نه
-    * اگر پر بود → خطای واضح با پیام فارسی
-    * "این کد معرف ظرفیتش پر شده، لطفا از کد دیگری استفاده کنید"
-
-فایل‌های تأثیرگذار:
-  - FrontOffice/Pages/Register.razor.cs
-  - CMS/UserCQ/CreateUser/CreateUserCommandHandler.cs
-
-تست:
-  - والد پر
-  - ثبت نام با کد او
-  - خطا با پیام واضح
-```
-
---
-
-### 📝 Priority 3 (Low - Documentation):
-
-#### Task 6: به‌روزرسانی Documentation
-```yaml
-فایل‌های نیاز به Update:
-  1. totalDoc/01-BUSINESS/network-commission-system.md
-     - اضافه کردن: Worker حذف 2 هفته
-     - اضافه کردن: شرط نمایش لینک معرفی
-     - اضافه کردن: الزامی بودن دیالوگ باشگاه
-  
-  2. totalDoc/01-BUSINESS/binary-tree-guide.md
-     - دقیق‌سازی: 2 فرزند فعال (نه فقط 2 فرزند)
-  
-  3. totalDoc/03-BACKEND/CMS/implementation-status.md
-     - افزودن: DeleteInactiveUsersWorker
-     - افزودن: Club Membership Validation
-
-  4. totalDoc/05-TASKS/BACKLOG.md
-     - اضافه کردن این 5 تسک
-```
-
---
-
-## 5️⃣ نتیجه‌گیری
-
-### ✅ نقاط قوت پیاده‌سازی فعلی:
-1. ✅ محاسبه تعادل با سقف 300 (هر دست) **کاملاً صحیح**
-2. ✅ Carryover logic **دقیقاً مطابق** توضیحات جدید
-3. ✅ Flush logic **درست** پیاده‌سازی شده
-4. ✅ Pool Contribution (25M × 20%) **مطابق**
-5. ✅ Recursive Balance Calculation **صحیح**
-
-### ❌ نقاط ضعف و نیاز به اصلاح:
-### 📊 درصد سازگاری (به‌روز شده 2025-12-09):
-```
-✅ Business Logic Core (Balance Calculation): 100% ✅
-⚠️ User Activation Flow: 60%
-❌ Background Workers: 0%
-⚠️ Validation & UX: 70%
-
-🎯 مجموع: 95% سازگاری (بعد از اصلاحات)
-```usiness Logic Core (Balance Calculation): 95%
-⚠️ User Activation Flow: 60%
-❌ Background Workers: 0%
-⚠️ Validation & UX: 70%
-
-🎯 مجموع: 70% سازگاری
-```
-
-### 🎯 اولویت‌بندی اصلاحات:
-1. 🔥 **فوری** (1-2 روز): Task 1, 2, 3 (Worker + Dialog + Link)
-2. ⚠️ **متوسط** (3-4 روز): Task 4, 5 (Validation ها)
-3. 📝 **کم** (1 روز): Task 6 (Documentation)
-
-**زمان تخمینی کل**: 5-7 روز کاری
-
---
-
-## 6️⃣ پیوست: جدول مقایسه تفصیلی
-
-| Feature | Doc قبلی | توضیحات جدید | کد فعلی | نیاز به اصلاح |
-|---------|----------|---------------|---------|---------------|
-| Binary Tree | ✅ 2 child | ✅ 2 نفر | ✅ Implemented | ❌ No |
-| Balance Formula | ✅ MIN(L,R) | ✅ MIN(چپ،راست) | ✅ Correct | ❌ No |
-| Cap 300/leg | ✅ Documented | ✅ Mentioned | ✅ Implemented | ❌ No |
-| Carryover | ✅ Implemented | ✅ میره هفته بعد | ✅ Correct | ❌ No |
-| Flush | ✅ > 300 flush | ✅ مازاد فلش میشه | ✅ Correct | ❌ No |
-| Pool 25M | ✅ Config | ✅ 25M per user | ✅ Correct | ❌ No |
-| Recursive | ✅ Tree Traverse | ✅ هر نفر برای خودش | ✅ Correct | ❌ No |
-| Link Display | ⚠️ IsActive | 🆕 + ClubMembership | ⚠️ Incomplete | ✅ Yes |
-| Club Dialog | ⚠️ Optional? | 🆕 الزامی | ⚠️ Likely Optional | ✅ Yes |
-| 2-week Delete | ❌ Not mentioned | 🆕 Auto delete | ❌ Not implemented | ✅ Yes |
-| Active Children | ⚠️ Count=2 | 🆕 ActiveCount=2 | ⚠️ Unclear | ✅ Yes |
-| Full Parent Msg | ⚠️ Generic | 🆕 واضح باشه | ⚠️ Unclear | ✅ Maybe |
-
-**رنگ‌بندی**:
- ✅ سبز: مطابق و صحیح
- ⚠️ زرد: نیاز به بررسی یا اصلاح جزئی
- ❌ قرمز: نیاز به پیاده‌سازی کامل
- 🆕 آبی: قانون جدید
-
---
-
-**پایان گزارش**
-
-📎 **فایل‌های مرتبط**:
- `/totalDoc/01-BUSINESS/new-business-requirements-2025-12-08.md`
- `/totalDoc/01-BUSINESS/balance-calculation-rules.md`
- `/totalDoc/01-BUSINESS/network-commission-system.md`
- `/CMS/src/.../CalculateWeeklyBalancesCommandHandler.cs`
@@ -1,207 +0,0 @@
-# 📝 خلاصه تغییرات و به‌روزرسانی‌های 2025-12-09
-
-**تاریخ**: 2025-12-09  
-**موضوع**: اصلاح محاسبات تعادل شبکه باینری  
-**وضعیت**: ✅ تکمیل شده و مستندسازی شده
-
---
-
-## 🎯 تغییرات اعمال شده
-
-### 1️⃣ اصلاح کد محاسبه تعادل
-
-**فایل**: `CMS/src/.../CalculateWeeklyBalancesCommandHandler.cs`
-
-**تغییرات**:
-
-#### قبل (اشتباه):
-```csharp
-// سقف رو زود اعمال می‌کرد
-var cappedLeftTotal = Math.Min(leftTotal, maxBalancesPerLeg);
-var cappedRightTotal = Math.Min(rightTotal, maxBalancesPerLeg);
-var totalBalances = Math.Min(cappedLeftTotal, cappedRightTotal);
-
-// باقیمانده رو اشتباه حساب می‌کرد
-var leftRemainder = leftTotal - cappedLeftTotal;
-var rightRemainder = rightTotal - cappedRightTotal;
-```
-
-**مشکل**: 
- با چپ=500، راست=600 → تعادل=300 (اشتباه!)
- باقیمانده چپ=200 (باید 0 بود)
- باقیمانده راست=300 (باید 100 بود)
-
-#### بعد (صحیح):
-```csharp
-// مرحله 1: تعادل اولیه (بدون سقف)
-var totalBalances = Math.Min(leftTotal, rightTotal);
-
-// مرحله 2: باقیمانده (قبل از سقف)
-var leftRemainder = leftTotal - totalBalances;
-var rightRemainder = rightTotal - totalBalances;
-
-// مرحله 3: اعمال سقف 300
-var cappedBalances = Math.Min(totalBalances, maxBalancesPerLeg);
-
-// مرحله 4: فلش از دو طرف
-var flushedPerSide = totalBalances - cappedBalances;
-var totalFlushed = flushedPerSide * 2;
-```
-
-**نتیجه صحیح**:
- چپ=500، راست=600 → تعادل=500 ✅
- باقیمانده چپ=0 ✅
- باقیمانده راست=100 ✅
- امتیاز=300 ✅
- فلش=400 (200 چپ + 200 راست) ✅
-
---
-
-### 2️⃣ به‌روزرسانی Documentation
-
-#### فایل‌های به‌روز شده:
-
-**1. `totalDoc/01-BUSINESS/balance-calculation-rules.md`**
- ✅ اضافه شدن بخش "آخرین به‌روزرسانی 2025-12-09"
- ✅ توضیح 4 مرحله محاسبات
- ✅ مثال‌های عددی صحیح
- ✅ اصلاح فرمول‌ها
-
-**2. `totalDoc/01-BUSINESS/balance-calculation-examples-5-levels.md` (جدید)**
- ✅ مثال کامل درخت 63 کاربره (6 لول)
- ✅ محاسبات دقیق هر کاربر
- ✅ جدول جمع‌بندی
- ✅ سناریوهای مختلف (متعادل، نامتعادل، سقف)
- ✅ محاسبه صندوق و توزیع کمیسیون
-
-**3. `totalDoc/ANALYSIS-NEW-BUSINESS-REQUIREMENTS.md`**
- ✅ به‌روزرسانی درصد سازگاری: 70% → 95%
- ✅ علامت‌گذاری Task #0 به عنوان Complete
- ✅ اضافه شدن بخش تغییرات اعمال شده
-
-**4. `totalDoc/05-TASKS/NEW-BUSINESS-REQUIREMENTS-TASKS.md`**
- ✅ اضافه شدن Task #0 به عنوان Completed
- ✅ ثبت تاریخ اتمام و فایل‌های تغییر یافته
-
---
-
-## 📊 مقایسه قبل و بعد
-
-### مثال: چپ=500، راست=600
-
-| مرحله | قبل (اشتباه) | بعد (صحیح) |
-|--------|--------------|------------|
-| تعادل اولیه | ❌ 300 | ✅ 500 |
-| باقیمانده چپ | ❌ 200 | ✅ 0 |
-| باقیمانده راست | ❌ 300 | ✅ 100 |
-| امتیاز نهایی | ✅ 300 | ✅ 300 |
-| فلش چپ | ❌ نامشخص | ✅ 200 |
-| فلش راست | ❌ نامشخص | ✅ 200 |
-| جمع فلش | ❌ 200 | ✅ 400 |
-
---
-
-## ✅ تایید نهایی
-
-### منطق صحیح (4 مرحله):
-
-```
-1️⃣ تعادل اولیه = MIN(چپ، راست)
-2️⃣ باقیمانده چپ = چپ - تعادل
-   باقیمانده راست = راست - تعادل
-3️⃣ امتیاز نهایی = MIN(تعادل، 300)
-4️⃣ فلش از هر طرف = تعادل - 300 (اگر > 0)
-   جمع فلش = فلش × 2
-```
-
-### نکات کلیدی:
-
-1. ✅ **باقیمانده جداگانه**: چپ و راست مجزا ذخیره می‌شوند
-2. ✅ **باقیمانده قبل از سقف**: از تعادل اولیه محاسبه می‌شود
-3. ✅ **سقف روی امتیاز**: 300 روی امتیاز نهایی اعمال می‌شود
-4. ✅ **فلش از دو طرف**: هر دو طرف مقدار یکسان فلش می‌شوند
-5. ✅ **محاسبه مستقل**: هر کاربر جداگانه در حلقه
-
---
-
-## 📁 فایل‌های تغییر یافته
-
-### کد:
-```
-✅ CMS/src/CMSMicroservice.Application/CommissionCQ/Commands/
-   CalculateWeeklyBalances/CalculateWeeklyBalancesCommandHandler.cs
-   
-   تغییرات:
-   - خطوط 84-110: منطق محاسبه تعادل
-   - خطوط 127: فیلد TotalBalances از totalBalances → cappedBalances
-```
-
-### Documentation:
-```
-✅ totalDoc/01-BUSINESS/balance-calculation-rules.md
-   - به‌روزرسانی کامل بخش‌ها
-   - اضافه شدن مثال‌های جدید
-   
-✅ totalDoc/01-BUSINESS/balance-calculation-examples-5-levels.md (جدید)
-   - 400+ خط
-   - 10 بخش کامل
-   - مثال‌های عملی 5 لول
-   
-✅ totalDoc/ANALYSIS-NEW-BUSINESS-REQUIREMENTS.md
-   - به‌روزرسانی درصد سازگاری
-   - اضافه شدن تغییرات اعمال شده
-   
-✅ totalDoc/05-TASKS/NEW-BUSINESS-REQUIREMENTS-TASKS.md
-   - Task #0 به عنوان Completed
-```
-
---
-
-## 🎯 نتیجه‌گیری
-
-### ✅ موفقیت‌ها:
-1. کد کاملاً مطابق با توضیحات بیزینس شد
-2. تمام مستندات به‌روزرسانی شدند
-3. مثال‌های جامع 5 لول اضافه شد
-4. درصد سازگاری از 70% به 95% رسید
-
-### ⏳ کارهای باقیمانده:
-1. Task #1: پیاده‌سازی DeleteInactiveUsersWorker (6 ساعت)
-2. Task #2: الزامی کردن دیالوگ باشگاه (8 ساعت)
-3. Task #3: شرط نمایش لینک معرفی (4 ساعت)
-4. Task #4: Validation 2 فرزند فعال (4 ساعت)
-5. Task #5: پیغام کد معرف پر (3 ساعت)
-6. Task #6: Update Documentation (3 ساعت)
-
-**زمان تخمینی باقیمانده**: 28 ساعت (~4 روز کاری)
-
---
-
-## 📌 یادداشت‌های مهم
-
-### برای Developer بعدی:
-1. کد محاسبه تعادل **دست نزنید**، کاملاً تست و تایید شده است
-2. ترتیب 4 مرحله حیاتی است، تغییر ندهید
-3. باقیمانده **جداگانه** (چپ و راست) ذخیره می‌شود
-4. فلش از **هر دو طرف** باید محاسبه شود
-
-### برای تست:
-```sql
-- چک کردن باقیمانده‌ها
-SELECT UserId, WeekNumber, 
-       LeftLegTotal, RightLegTotal, TotalBalances,
-       LeftLegRemainder, RightLegRemainder
-FROM NetworkWeeklyBalances
-WHERE WeekNumber = '2025-W50';
-
-- باید:
-- TotalBalances = MIN(LeftLegTotal, RightLegTotal) یا 300
-- LeftLegRemainder = LeftLegTotal - MIN(LeftLegTotal, RightLegTotal)
-- RightLegRemainder = RightLegTotal - MIN(LeftLegTotal, RightLegTotal)
-```
-
---
-
-**تهیه‌کننده**: AI Assistant  
-**تاریخ**: 2025-12-09  
-**نسخه**: 1.0 Final
@@ -1,169 +0,0 @@
-# 📝 Changelog - ۲۸ آذر ۱۴۰۴ (18 December 2025)
-
-> **Session**: بهبودات FrontOffice، مدیریت موجودی، ClubFeatures
-
---
-
-## 🛒 سیستم مدیریت موجودی محصولات
-
-### CMS - SubmitShopBuyOrderCommandHandler
-**فایل**: `CMSMicroservice.Application/UserOrderCQ/Commands/SubmitShopBuyOrder/SubmitShopBuyOrderCommandHandler.cs`
-
-#### تغییرات:
-1. **چک موجودی قبل از خرید**:
-   - اگر محصول ناموجود شده (`RemainingCount <= 0`) → خطا
-   - اگر تعداد درخواستی > موجودی → خطا با جزئیات
-
-2. **کاهش موجودی بعد از پرداخت موفق**:
-   ```csharp
-   foreach (var cartItem in user.UserCarts)
-   {
-       cartItem.Product.RemainingCount -= cartItem.Count;
-       cartItem.Product.SaleCount += cartItem.Count;
-   }
-   ```
-
-3. **پیام‌های خطای فارسی**:
-   - `"محصولات زیر ناموجود شده‌اند: [لیست]"`
-   - `"موجودی محصولات زیر کافی نیست: «نام»: درخواست X عدد، موجودی Y عدد"`
-
-### FrontOffice - ProductDetail
-**فایل‌ها**:
- `Pages/Store/ProductDetail.razor`
- `Pages/Store/ProductDetail.razor.cs`
-
-#### تغییرات:
-1. **MaxQty داینامیک**: از عدد ثابت 20 به `_product.RemainingCount`
-2. **پراپرتی IsInStock**: `_product.RemainingCount > 0`
-3. **UI موجودی**:
-   - Chip سبز: "موجود در انبار (X عدد)"
-   - Chip قرمز: "ناموجود"
-4. **غیرفعال کردن دکمه**: وقتی محصول ناموجود
-
---
-
-## 🎖️ ویژگی‌های باشگاه مشتریان (ClubFeatures)
-
-### معماری اصلاح‌شده
- **ClubFeature** (جدول قالب): `Title`, `Description`, `DetailedDescriptionHtml`, `Icon`, `Color`, `IsActive`, `RequiredPoints`, `SortOrder`
- **UserClubFeature** (junction table): `UserId`, `ClubMembershipId`, `ClubFeatureId`, `IsActive`, `GrantedAt`, `Notes`
-
-### فایل‌های اصلاح‌شده:
-
-#### CMS:
- `UserClubFeatureDto.cs`: حذف `DetailedDescriptionHtml`, `Icon`, `Color`
- `clubmembership.proto`: حذف فیلدهای 7,8,9 از `UserClubFeatureModel`
- `ClubFeatureProfile.cs`: حذف mapping های اضافی
-
-#### BFF:
- `GetClubFeaturesQueryHandler.cs`: حذف mapping های حذف‌شده
- `GetClubFeaturesResponseDto.cs`: حذف فیلدها از `ClubFeatureItemDto`
- `configuration.proto`: حذف `detailed_description_html`, `icon`, `color` از `ClubFeatureModel`
- `ConfigurationProfile.cs`: حذف mapping های اضافی
-
-#### FrontOffice:
- `ClubConfigurationService.cs`: حذف فیلدها از `ClubFeatureDto` و mapping
- `FeaturesPage.razor`: 
-  - استفاده از آیکون ثابت `Star`
-  - حذف متد `GetMudIcon`
-  - تغییر جدول به `MudList` ساده
-  - نمایش `Notes` در مدال جزئیات
-
-### MembershipPage - مزایای عضویت
-**فایل**: `Pages/Club/MembershipPage.razor`
-
-مزایای جدید:
-1. ✅ شارژ ۵۶ میلیون تومان کیف پول فروشگاه تخفیفی
-2. ✅ عضویت در شبکه بازاریابی و دریافت پورسانت
-3. ✅ امکان جذب زیرمجموعه و گسترش شبکه
-
---
-
-## 📍 مدال آدرس‌ها
-
-### رفع باگ‌ها:
-
-#### 1. خطای Snackbar تکراری
-**مشکل**: `CS0102: already contains a definition for 'Snackbar'`
-**علت**: `ISnackbar` در `_Imports.razor` به صورت global inject شده بود
-**حل**: حذف `[Inject] private ISnackbar Snackbar` از code-behind
-
-**فایل‌های اصلاح‌شده**:
- `AddAddressDialog.razor.cs`
- `EditAddressDialog.razor.cs`
-
-#### 2. خطای NullReferenceException
-**مشکل**: `Object reference not set to an instance of an object`
-**علت**: `dialog.Result` می‌تواند `null` باشد
-**حل**: اضافه کردن null check
-
-```csharp
-// قبل
-if (!result.Canceled)
-
-// بعد
-if (result is not null && !result.Canceled)
-```
-
-**فایل**: `Addresses.razor.cs`
-
---
-
-## 💰 VAT Service
-
-### تغییرات:
- **نرخ پیش‌فرض**: 9.99% (برای تشخیص داده سرور از local)
- **استفاده در CheckoutSummary**: `VAT.IsEnabled`, `VAT.VatPercentage`, `VAT.AddVAT()`
- **کلید جدید**: `VAT_PERCENTAGE_KEY` در LocalStorage
-
---
-
-## 🛒 CartService Authentication
-
-### تغییرات:
- **EnsureInitializedAsync()**: متد جدید برای lazy loading
- **IsAuthenticatedAsync()**: چک توکن در LocalStorage
- **عدم لود برای unauthenticated**: سبد خرید فقط برای کاربران لاگین‌شده لود می‌شود
-
-### فایل‌های آپدیت‌شده برای فراخوانی EnsureInitialized:
- `MainLayout.razor.cs`
- `Cart.razor.cs`
- `Products.razor.cs`
- `ProductDetail.razor.cs`
- `CheckoutSummary.razor.cs`
-
---
-
-## 📊 خلاصه فایل‌های تغییر یافته
-
-### CMS (5 فایل):
-1. `SubmitShopBuyOrderCommandHandler.cs` - چک و کاهش موجودی
-2. `UserClubFeatureDto.cs` - حذف فیلدها
-3. `clubmembership.proto` - حذف فیلدها
-4. `ClubFeatureProfile.cs` - حذف mapping
-
-### BFF (4 فایل):
-1. `GetClubFeaturesQueryHandler.cs` - حذف mapping
-2. `GetClubFeaturesResponseDto.cs` - حذف فیلدها
-3. `configuration.proto` - حذف فیلدها
-4. `ConfigurationProfile.cs` - حذف mapping
-
-### FrontOffice (12 فایل):
-1. `ProductDetail.razor` - نمایش موجودی
-2. `ProductDetail.razor.cs` - MaxQty داینامیک
-3. `ClubConfigurationService.cs` - حذف فیلدها
-4. `FeaturesPage.razor` - بازطراحی UI
-5. `MembershipPage.razor` - مزایای عضویت
-6. `AddAddressDialog.razor.cs` - رفع خطای Snackbar
-7. `EditAddressDialog.razor.cs` - رفع خطای Snackbar
-8. `Addresses.razor.cs` - رفع NullRef
-9. `CartService.cs` - Authentication check
-10. `VATService.cs` - نرخ 9.99%
-11. `CheckoutSummary.razor` - استفاده از VATService
-12. `MainLayout.razor.cs` - EnsureInitializedAsync
-
---
-
-## ✅ وضعیت نهایی
- **Build**: موفق
- **تست دستی**: آدرس‌ها ✅، موجودی محصول ✅، ClubFeatures ✅
@@ -1,651 +0,0 @@
-# 📝 Changelog - ۲۹ آذر ۱۴۰۴ (19 December 2025)
-
-> **Session**: مایگریشن از WeekNumber به WeekDefinitionId در سیستم کمیسیون
-
---
-
-## 🎯 هدف اصلی
-
-تغییر از `string WeekNumber` به `long WeekDefinitionId` به عنوان **Foreign Key** به جدول `WeekDefinitions` در تمام جداول و سرویس‌های مرتبط با کمیسیون.
-
-### دلایل تغییر:
-1. **یکپارچگی داده**: استفاده از FK واقعی به جای string
-2. **بهبود Query Performance**: Join بر اساس long id سریع‌تر از string
-3. **جلوگیری از Orphan Records**: FK constraint
-4. **سادگی نام‌گذاری**: `WeekDisplayName` به جای ترکیب `GregorianWeekNumber` + `PersianWeekNumber`
-
---
-
-## 📦 CMS Microservice
-
-### Entities (5 entity)
-
-#### 1. NetworkWeeklyBalance
-```csharp
-// قبل
-public string WeekNumber { get; set; }
-
-// بعد
-public long WeekDefinitionId { get; set; }
-public virtual WeekDefinition WeekDefinition { get; set; }
-```
-
-#### 2. WeeklyCommissionPool
-```csharp
-// قبل
-public string WeekNumber { get; set; }
-
-// بعد
-public long WeekDefinitionId { get; set; }
-public virtual WeekDefinition WeekDefinition { get; set; }
-```
-
-#### 3. UserCommissionPayout
-```csharp
-// قبل
-public string WeekNumber { get; set; }
-
-// بعد
-public long WeekDefinitionId { get; set; }
-public virtual WeekDefinition WeekDefinition { get; set; }
-```
-
-#### 4. WorkerExecutionLog
-```csharp
-// قبل
-public string WeekNumber { get; set; }
-
-// بعد
-public long? WeekDefinitionId { get; set; } // nullable برای backward compatibility
-public virtual WeekDefinition? WeekDefinition { get; set; }
-```
-
-#### 5. CommissionPayoutHistory
-```csharp
-// قبل
-public string WeekNumber { get; set; }
-
-// بعد
-public long WeekDefinitionId { get; set; }
-public virtual WeekDefinition WeekDefinition { get; set; }
-```
-
-### EF Configurations
-
-**فایل‌های آپدیت شده**:
- `NetworkWeeklyBalanceConfiguration.cs` - Index و FK
- `WeeklyCommissionPoolConfiguration.cs` - Index و FK
- `UserCommissionPayoutConfiguration.cs` - Index و FK
- `WorkerExecutionLogConfiguration.cs` - Index و FK
- `CommissionPayoutHistoryConfiguration.cs` - Index و FK
-
-**نمونه تغییرات**:
-```csharp
-// حذف Index قدیمی
-builder.HasIndex(e => e.WeekNumber);
-
-// اضافه کردن FK جدید
-builder.HasIndex(e => e.WeekDefinitionId);
-builder.HasOne(e => e.WeekDefinition)
-    .WithMany()
-    .HasForeignKey(e => e.WeekDefinitionId)
-    .OnDelete(DeleteBehavior.Restrict);
-```
-
-### Proto Files (commission.proto)
-
-#### UserCommissionPayoutModel
-```protobuf
-// قبل
-string week_number = 4;
-
-// بعد
-int64 week_definition_id = 4;
-string week_display_name = 11; // فیلد جدید
-```
-
-#### UserWeeklyBalanceModel
-```protobuf
-// قبل
-string week_number = 2;
-
-// بعد
-int64 week_definition_id = 2;
-string week_display_name = 10; // فیلد جدید
-```
-
-### Handlers & Mapping Profiles
-
-**فایل‌های آپدیت شده**:
- `GetAllUserCommissionPayoutsQueryHandler.cs`
- `GetUserWeeklyBalancesQueryHandler.cs`
- `CommissionProfile.cs`
-
-**تغییرات Mapping**:
-```csharp
-// استفاده از WeekDefinition برای ساخت WeekDisplayName
-.Map(dest => dest.WeekDisplayName, 
-     src => $"هفته {src.WeekDefinition.WeekOrder} - {src.WeekDefinition.StartDatePersian}")
-```
-
---
-
-## 🔗 BackOffice.BFF
-
-### Proto Files (commission.proto)
-
-#### WeekInfo
-```protobuf
-// اضافه شد
-int64 week_definition_id = 1;  // جدید - برای انتخاب هفته
-string display_name = 2;        // تغییر نام از week_number
-```
-
-#### WeeklyCommissionPoolModel
-```protobuf
-// اضافه شد
-string week_display_name = 3;   // جدید
-```
-
-#### WorkerExecutionLogModel
-```protobuf
-// اضافه شد
-string week_display_name = 3;   // جدید
-```
-
-### Application DTOs
-
-**GetAvailableWeeksResponseDto.cs**:
-```csharp
-public class WeekInfoDto
-{
-    public long WeekDefinitionId { get; set; }  // جدید
-    public string DisplayName { get; set; }
-    ...
-}
-```
-
-**GetAllWeeklyPoolsResponseDto.cs**:
-```csharp
-public record WeeklyCommissionPoolDto
-{
-    public string WeekDisplayName { get; init; }  // جدید
-    ...
-}
-```
-
-**GetWorkerExecutionLogsResponseDto.cs**:
-```csharp
-public class WorkerExecutionLogModel
-{
-    public string WeekDisplayName { get; set; }  // جدید
-    ...
-}
-```
-
-### Mapping Profiles (CommissionProfile.cs)
-
-```csharp
-// WeekInfo mapping
-.Map(dest => dest.WeekDefinitionId, src => src.WeekDefinitionId)
-
-// WeeklyCommissionPoolModel mapping
-WeekDisplayName = m.WeekDisplayName ?? string.Empty,
-
-// WeeklyBalanceModel mapping
-WeekDisplayName = m.WeekDisplayName ?? string.Empty,
-```
-
---
-
-## 🖥️ BackOffice Admin (Blazor)
-
-### Project Reference
-
-**BackOffice.csproj**:
-```xml
-<!-- تغییر از PackageReference به ProjectReference برای 23 proto پروژه -->
-<ProjectReference Include="..\..\..\..\BackOffice.BFF\src\Protobufs\BackOffice.BFF.Commission.Protobuf\..." />
-<!-- و 22 proto پروژه دیگر -->
-```
-
-### Components Updated
-
-#### WeekNumberPicker.razor.cs
-```csharp
-// قبل - فقط string binding
-[Parameter] public string? SelectedWeekNumber { get; set; }
-
-// بعد - dual binding support
-[Parameter] public string? SelectedWeekNumber { get; set; }      // for DisplayName
-[Parameter] public long? SelectedWeekDefinitionId { get; set; }  // for API calls
-```
-
-#### Dashboard.razor.cs
-```csharp
-// قبل
-private string _selectedWeek = "";
-
-// بعد
-private long? _selectedWeekDefinitionId;
-private WeekInfo? _selectedWeek;
-private string _currentWeekDisplayName = string.Empty;
-```
-
-#### UserPayouts.razor.cs
-```csharp
-// قبل
-private string _filterWeekNumber = "";
-
-// بعد
-private long? _filterWeekDefinitionId;
-```
-
-#### BalancesReport.razor
-```csharp
-// قبل
-private string _filterWeekNumber = "";
-public string WeekNumber { get; set; }
-
-// بعد
-private long? _filterWeekDefinitionId;
-public string WeekDisplayName { get; set; }
-```
-
-#### WeeklyReports.razor
-```csharp
-// قبل
-public string WeekNumber { get; set; }
-
-// بعد
-public long WeekDefinitionId { get; set; }
-public string WeekDisplayName { get; set; }
-```
-
-#### SystemOverview.razor
-```csharp
-// قبل
-private string _currentWeek = "";
-
-// بعد
-private long _currentWeekDefinitionId = 0;
-private string _currentWeekDisplayName = string.Empty;
-```
-
-#### WorkerControl.razor
-```csharp
-// قبل
-public string WeekNumber { get; set; }
-
-// بعد
-public long WeekDefinitionId { get; set; }
-public string WeekDisplayName { get; set; }
-```
-
-#### PayoutDetailsDialog.razor
-```razor
-<!-- قبل -->
-@Payout.WeekNumber
-
-<!-- بعد -->
-@Payout.WeekDisplayName
-```
-
---
-
-## 🔗 FrontOffice.BFF
-
-### Proto Files
-
-#### commission.proto
-```protobuf
-message UserCommissionPayoutModel {
-    int64 week_definition_id = 4;  // تغییر از week_number
-    string week_display_name = 11; // جدید
-}
-message UserWeeklyBalanceModel {
-    int64 week_definition_id = 2;  // تغییر از week_number
-    string week_display_name = 10; // جدید
-}
-```
-
-#### userwallet.proto
-```protobuf
-message UserWithdrawalModel {
-    int64 week_definition_id = 2;   // تغییر از week_number
-    string week_display_name = 3;   // تغییر از week_label
-}
-```
-
-### Application DTOs
-
-**GetMyCommissionPayoutsResponseDto.cs**:
-```csharp
-public class CommissionPayoutItem
-{
-    // حذف
-    public int WeekNumber { get; set; }
-    public string WeekLabel { get; set; }
-    
-    // اضافه
-    public long WeekDefinitionId { get; set; }
-    public string WeekDisplayName { get; set; }
-}
-```
-
-**GetMyWeeklyBalancesResponseDto.cs**:
-```csharp
-public class WeeklyBalanceItem
-{
-    // حذف
-    public int WeekNumber { get; set; }
-    public string WeekLabel { get; set; }
-    
-    // اضافه
-    public long WeekDefinitionId { get; set; }
-    public string WeekDisplayName { get; set; }
-}
-```
-
-### Handlers
-
-**GetMyCommissionPayoutsQueryHandler.cs**:
- Mapping از `WeekDefinitionId` و `WeekDisplayName`
-
-**GetMyWeeklyBalancesQueryHandler.cs**:
- Mapping از `WeekDefinitionId` و `WeekDisplayName`
-
---
-
-## 🖥️ FrontOffice (Blazor)
-
-### DTOs (CommissionDtos.cs)
-
-```csharp
-// قبل
-public record CommissionPayoutDto(
-    int WeekNumber,
-    string WeekLabel,
-    ...
-);
-
-// بعد
-public record CommissionPayoutDto(
-    long WeekDefinitionId,
-    string WeekDisplayName,
-    ...
-);
-```
-
-```csharp
-// قبل
-public record WeeklyBalanceDto(
-    int WeekNumber,
-    string WeekLabel,
-    ...
-);
-
-// بعد
-public record WeeklyBalanceDto(
-    long WeekDefinitionId,
-    string WeekDisplayName,
-    ...
-);
-```
-
-```csharp
-// قبل
-public record WeekDefinitionDto(
-    ...
-    string GregorianWeekNumber,
-    string PersianWeekNumber
-);
-
-// بعد
-public record WeekDefinitionDto(
-    long Id,
-    ...
-    // حذف GregorianWeekNumber و PersianWeekNumber
-);
-```
-
-### Services (CommissionService.cs)
-
-```csharp
-// قبل
-public async Task<...> GetMyCommissionPayoutsAsync(int? weekNumber, ...)
-
-// بعد
-public async Task<...> GetMyCommissionPayoutsAsync(long? weekDefinitionId, ...)
-```
-
-```csharp
-// قبل
-public async Task<WeeklyBalanceDto?> GetMyWeeklyBalanceAsync(string? weekNumber)
-
-// بعد
-public async Task<WeeklyBalanceDto?> GetMyWeeklyBalanceAsync(long? weekDefinitionId)
-```
-
-**حذف متد**: `ExtractWeekNumber(string)`
-
-### Services (WalletService.cs)
-
-```csharp
-// قبل
-public record WalletWithdrawal(
-    long Id, 
-    string WeekNumber, 
-    ...
-);
-
-// بعد
-public record WalletWithdrawal(
-    long Id,
-    long WeekDefinitionId,
-    string WeekDisplayName,
-    ...
-);
-```
-
-### Components
-
-#### WeekSelector.razor.cs
-```csharp
-// حذف
-public WeekDefinitionDto? FindByGregorianWeekNumber(string weekNumber)
-
-// اضافه
-public WeekDefinitionDto? FindById(long id)
-```
-
-#### WeeklyBalancePage.razor.cs
-```csharp
-// استفاده از Id به جای GregorianWeekNumber
-_selectedWeekDefinition = _weekSelector?.FindById(id);
-```
-
-### Razor Templates
-
-#### CommissionDashboardPage.razor
-```razor
-<!-- قبل -->
-<MudChip>@context.WeekLabel</MudChip>
-Href="?week={context.WeekNumber}"
-
-<!-- بعد -->
-<MudChip>@context.WeekDisplayName</MudChip>
-Href="?week={context.WeekDefinitionId}"
-```
-
-#### CommissionHistoryPage.razor
-```razor
-<!-- قبل -->
-<MudChip>@context.WeekLabel</MudChip>
-Href="?week={context.WeekNumber}"
-
-<!-- بعد -->
-<MudChip>@context.WeekDisplayName</MudChip>
-Href="?week={context.WeekDefinitionId}"
-```
-
-#### WeeklyBalancePage.razor
-```razor
-<!-- قبل -->
-<MudText>@_weeklyBalance.WeekLabel</MudText>
-
-<!-- بعد -->
-<MudText>@_weeklyBalance.WeekDisplayName</MudText>
-```
-
-#### WithdrawalRequests.razor
-```razor
-<!-- قبل -->
-<MudTd>@context.WeekNumber</MudTd>
-<MudText>هفته @wd.WeekNumber</MudText>
-
-<!-- بعد -->
-<MudTd>@context.WeekDisplayName</MudTd>
-<MudText>@wd.WeekDisplayName</MudText>
-```
-
-### Project Reference
-
-**FrontOffice.Main.csproj**:
-```xml
-<!-- کامنت شد (NuGet قدیمی) -->
-<!-- <PackageReference Include="Foursat.FrontOffice.BFF.UserWallet.Protobuf" Version="0.0.15" /> -->
-
-<!-- اضافه شد (ProjectReference برای proto جدید) -->
-<ProjectReference Include="...FrontOffice.BFF.UserWallet.Protobuf.csproj" />
-```
-
---
-
-## 📊 خلاصه فایل‌های تغییریافته
-
-### CMS (15+ فایل):
-| فایل | تغییر |
-|------|-------|
-| `NetworkWeeklyBalance.cs` | Entity + FK |
-| `WeeklyCommissionPool.cs` | Entity + FK |
-| `UserCommissionPayout.cs` | Entity + FK |
-| `WorkerExecutionLog.cs` | Entity + FK (nullable) |
-| `CommissionPayoutHistory.cs` | Entity + FK |
-| `NetworkWeeklyBalanceConfiguration.cs` | EF Config |
-| `WeeklyCommissionPoolConfiguration.cs` | EF Config |
-| `UserCommissionPayoutConfiguration.cs` | EF Config |
-| `WorkerExecutionLogConfiguration.cs` | EF Config |
-| `CommissionPayoutHistoryConfiguration.cs` | EF Config |
-| `commission.proto` | Proto models (WeeklyCommissionPoolModel, WorkerExecutionLogModel) |
-| `CommissionProfile.cs` | Mapster mapping |
-| `GetAllUserCommissionPayoutsQueryHandler.cs` | Include WeekDefinition |
-| `GetUserWeeklyBalancesQueryHandler.cs` | Include WeekDefinition |
-| `GetAvailableWeeksQueryHandler.cs` | WeekDefinitionId in WeekInfo |
-
-### BackOffice.BFF (8 فایل):
-| فایل | تغییر |
-|------|-------|
-| `commission.proto` | WeekInfo, WeeklyCommissionPoolModel, WorkerExecutionLogModel |
-| `GetAvailableWeeksResponseDto.cs` | WeekDefinitionId in WeekInfoDto |
-| `GetAllWeeklyPoolsResponseDto.cs` | WeekDisplayName |
-| `GetWorkerExecutionLogsResponseDto.cs` | WeekDisplayName |
-| `GetAvailableWeeksQueryHandler.cs` | Mapping WeekDefinitionId |
-| `CommissionProfile.cs` | Mapster config for new fields |
-
-### BackOffice Admin (12 فایل):
-| فایل | تغییر |
-|------|-------|
-| `BackOffice.csproj` | 23 ProjectReference به جای PackageReference |
-| `WeekNumberPicker.razor.cs` | Dual binding (string + long) |
-| `Dashboard.razor` | WeekDefinitionId selector |
-| `Dashboard.razor.cs` | _selectedWeekDefinitionId, _currentWeekDisplayName |
-| `UserPayouts.razor` | WeekDisplayName column |
-| `UserPayouts.razor.cs` | _filterWeekDefinitionId |
-| `BalancesReport.razor` | WeekDisplayName column, filter |
-| `WeeklyReports.razor` | WeekDefinitionId, WeekDisplayName |
-| `SystemOverview.razor` | _currentWeekDisplayName |
-| `WorkerControl.razor` | WeekDisplayName in logs |
-| `PayoutDetailsDialog.razor` | WeekDisplayName |
-
-### FrontOffice.BFF (8 فایل):
-| فایل | تغییر |
-|------|-------|
-| `commission.proto` | week_definition_id, week_display_name |
-| `userwallet.proto` | week_definition_id, week_display_name |
-| `GetMyCommissionPayoutsResponseDto.cs` | DTO fields |
-| `GetMyWeeklyBalancesResponseDto.cs` | DTO fields |
-| `GetUserWithdrawalsResponseDto.cs` | DTO fields |
-| `GetMyCommissionPayoutsQueryHandler.cs` | Mapping |
-| `GetMyWeeklyBalancesQueryHandler.cs` | Mapping |
-| `CommissionProfile.cs` | Mapster config |
-
-### FrontOffice (12 فایل):
-| فایل | تغییر |
-|------|-------|
-| `CommissionDtos.cs` | DTOs |
-| `CommissionService.cs` | Service methods |
-| `WalletService.cs` | WalletWithdrawal record |
-| `WeekSelector.razor` | UI |
-| `WeekSelector.razor.cs` | FindById method |
-| `WeeklyBalancePage.razor` | WeekDisplayName |
-| `WeeklyBalancePage.razor.cs` | WeekDefinitionId |
-| `CommissionDashboardPage.razor` | Links & display |
-| `CommissionHistoryPage.razor` | Links & display |
-| `WithdrawalRequests.razor` | WeekDisplayName |
-| `FrontOffice.Main.csproj` | ProjectReference |
-
---
-
-## ⚠️ نکات مهم
-
-### Migration مورد نیاز
-قبل از deploy، باید EF migration اجرا شود:
-```bash
-cd CMS/src
-dotnet ef migrations add MigrateWeekNumberToWeekDefinitionId -p CMSMicroservice.Infrastructure -s CMSMicroservice.WebApi
-dotnet ef database update -p CMSMicroservice.Infrastructure -s CMSMicroservice.WebApi
-```
-
-### Data Migration
-داده‌های موجود باید migrate شوند:
-```sql
-- مثال برای NetworkWeeklyBalance
-UPDATE NetworkWeeklyBalances 
-SET WeekDefinitionId = (
-    SELECT Id FROM WeekDefinitions 
-    WHERE CONCAT(Year, '-', LPAD(WeekOrder, 2, '0')) = NetworkWeeklyBalances.WeekNumber
-)
-WHERE WeekDefinitionId IS NULL;
-```
-
-### FK Constraint
-جدول `WorkerExecutionLogs` ممکن است رکوردهایی با `WeekNumber` نامعتبر داشته باشد که باید قبل از اعمال FK constraint اصلاح شوند.
-
---
-
-## ✅ وضعیت Build
-
-| پروژه | وضعیت |
-|-------|--------|
-| CMS | ✅ Build Succeeded |
-| BackOffice.BFF | ✅ Build Succeeded |
-| BackOffice Admin | ✅ Build Succeeded |
-| FrontOffice.BFF | ✅ Build Succeeded |
-| FrontOffice | ✅ Build Succeeded |
-
---
-
-## 🔄 تغییرات Proto NuGet
-
-برای publish نهایی، باید proto packageها آپدیت شوند:
-1. `Foursat.CMSMicroservice.Protobuf` → ورژن جدید
-2. `Foursat.BackOffice.BFF.Commission.Protobuf` → ورژن جدید
-3. `Foursat.FrontOffice.BFF.Commission.Protobuf` → ورژن جدید
-4. `Foursat.FrontOffice.BFF.UserWallet.Protobuf` → ورژن جدید
-
---
-
-## 📝 نکته مهم درباره ProjectReference
-
-در این سشن، برای BackOffice Admin و FrontOffice، تمام `PackageReference` های proto به `ProjectReference` تغییر داده شدند تا تغییرات proto بدون نیاز به publish فوری قابل تست باشند.
@@ -1,255 +0,0 @@
-# CHANGELOG - Club Membership Auto-Features
-
-**Date**: 2025-12-09  
-**Version**: 1.1.0  
-**Component**: CMS Microservice - Club Membership Module
-
---
-
-## 🎯 Summary
-
-افزودن قابلیت اختصاص خودکار ویژگی‌های باشگاه مشتریان (`UserClubFeatures`) به اعضای جدید هنگام فعالسازی.
-
---
-
-## ✨ New Features
-
-### 1. Auto-Grant Club Features on Activation
-
-**Location**: `CMSMicroservice.Application/ClubMembershipCQ/Commands/ActivateClubMembership/ActivateClubMembershipCommandHandler.cs`
-
-**Changes**:
-```csharp
-// Step 8: اضافه کردن ویژگی‌های باشگاه (فقط برای اعضای جدید)
-if (isNewMembership)
-{
-    var clubFeatures = await _context.ClubFeatures
-        .Where(f => !f.IsDeleted && new long[] { 1, 2, 3, 4 }.Contains(f.Id))
-        .ToListAsync(cancellationToken);
-
-    if (clubFeatures.Any())
-    {
-        var userClubFeatures = clubFeatures.Select(feature => new UserClubFeature
-        {
-            UserId = user.Id,
-            ClubMembershipId = entity.Id,
-            ClubFeatureId = feature.Id,
-            GrantedAt = activationDate,
-            Notes = "اعطا شده به‌طور خودکار هنگام فعالسازی"
-        }).ToList();
-
-        _context.UserClubFeatures.AddRange(userClubFeatures);
-        await _context.SaveChangesAsync(cancellationToken);
-        
-        _logger.LogInformation(
-            "Granted {Count} club features to UserId {UserId}",
-            clubFeatures.Count,
-            user.Id
-        );
-    }
-}
-```
-
-**Behavior**:
- ✅ فقط برای `isNewMembership = true` اجرا می‌شود (نه برای reactivation)
- ✅ 4 ویژگی پایه (`ClubFeatureId IN (1,2,3,4)`) به‌طور خودکار ثبت می‌شوند
- ✅ `GrantedAt` = تاریخ فعالسازی
- ✅ Logging کامل
-
---
-
-## 📄 Migration Scripts
-
-### 1. MigrateUsersToClubMembership.sql (Full Version)
-
-**Location**: `/dbbkup/MigrateUsersToClubMembership.sql`  
-**Size**: 370 lines
-
-**Features**:
- Query `UserWalletChangeLogs` برای محاسبه مجموع شارژ‌ها
- Fallback به `Transactions` اگر logs خالی بود
- Transaction-safe (هر کاربر = یک transaction مستقل)
- اختصاص خودکار 4 ویژگی باشگاه
-
-**SQL Logic**:
-```sql
-- برای هر کاربر:
-BEGIN TRANSACTION;
-
-1. INSERT INTO ClubMemberships 
-   (UserId, ActivatedAt=FirstChargeDate, InitialContribution=25M)
-
-2. INSERT INTO ClubMembershipHistories 
-   (Action=0, Reason='فعال‌سازی خودکار - مهاجرت')
-
-3. INSERT INTO UserClubFeatures (4 rows)
-   SELECT @UserId, @MembershipId, cf.Id, @DateTime, 
-          CAST(N'اعطا شده خودکار' AS NVARCHAR(500))
-   FROM ClubFeatures cf
-   WHERE cf.Id IN (1,2,3,4)
-
-COMMIT TRANSACTION;
-```
-
-### 2. MigrateUsersToClubMembership_Simple.sql
-
-**Location**: `/dbbkup/MigrateUsersToClubMembership_Simple.sql`  
-**Size**: 130 lines
-
-**Difference**: بررسی موجودی فعلی (`UserWallets.Balance`) به‌جای تاریخچه شارژ
-
---
-
-## 🔧 Technical Details
-
-### Schema Fixes
-
-**Issues Fixed**:
-1. ❌ `User.ClubMembershipId` → این ستون وجود نداره!
-   - رابطه: `ClubMemberships.UserId → Users.Id` (یک‌طرفه)
-2. ❌ `Action = 'Activated'` → باید `INT` باشه
-   - `Action = 0` (Activated enum value)
-3. ❌ `N'فارسی'` در `SELECT` → encoding خراب می‌شه
-   - `CAST(N'فارسی' AS NVARCHAR(500))`
-
-### Transaction Strategy
-
-**Before (Wrong)**:
-```sql
-SET XACT_ABORT ON;
-BEGIN TRANSACTION;
-  -- 100 INSERT...
-COMMIT TRANSACTION;
-```
-❌ با cursor سازگار نیست → log file overflow
-
-**After (Correct)**:
-```sql
-WHILE @@FETCH_STATUS = 0
-BEGIN
-    BEGIN TRANSACTION;
-      -- INSERT ClubMembership
-      -- INSERT History
-      -- INSERT UserClubFeatures (x4)
-    COMMIT TRANSACTION;
-END
-```
-✅ هر کاربر مستقل → partial success ممکنه
-
---
-
-## 📊 Data Impact
-
-**Affected Tables**:
-1. `ClubMemberships` - رکوردهای جدید برای کاربران مهاجرت شده
-2. `ClubMembershipHistories` - یک رکورد `Action=0` برای هر کاربر
-3. `UserClubFeatures` - 4 رکورد (ویژگی‌های 1,2,3,4) برای هر کاربر
-
-**Example**:
-اگر 100 کاربر مهاجرت کنند:
- 100 row در `ClubMemberships`
- 100 row در `ClubMembershipHistories`
- 400 row در `UserClubFeatures` (100 × 4)
-
---
-
-## 🧪 Testing
-
-### Validation Queries
-
-**1. تعداد ویژگی‌های ثبت شده**:
-```sql
-SELECT 
-    cm.UserId,
-    COUNT(ucf.Id) AS FeaturesCount
-FROM ClubMemberships cm
-LEFT JOIN UserClubFeatures ucf ON ucf.ClubMembershipId = cm.Id
-WHERE cm.Created >= '2025-12-09'
-GROUP BY cm.UserId
-HAVING COUNT(ucf.Id) != 4;  -- باید خالی باشه!
-```
-
-**2. چک کردن History**:
-```sql
-SELECT COUNT(*)
-FROM ClubMembershipHistories
-WHERE Action = 0
-  AND CreatedBy = 'MigrationScript'
-  AND Created >= '2025-12-09';
-```
-
-**3. لیست اعضای جدید**:
-```sql
-SELECT 
-    u.Id,
-    u.FirstName + ' ' + u.LastName AS FullName,
-    cm.ActivatedAt,
-    cm.InitialContribution,
-    COUNT(ucf.Id) AS FeaturesGranted
-FROM Users u
-INNER JOIN ClubMemberships cm ON cm.UserId = u.Id
-LEFT JOIN UserClubFeatures ucf ON ucf.ClubMembershipId = cm.Id
-WHERE cm.Created >= '2025-12-09'
-GROUP BY u.Id, u.FirstName, u.LastName, cm.ActivatedAt, cm.InitialContribution;
-```
-
---
-
-## 📝 Configuration
-
-**Constants**:
-```sql
-@InitialContribution = 25,000,000  -- سهم استخر
-@ChargeAmount = 56,000,000          -- حداقل شارژ
-@ClubFeatureIds = (1, 2, 3, 4)     -- ویژگی‌های پایه
-```
-
-**Adjustable**: می‌توان این مقادیر را در اسکریپت تغییر داد
-
---
-
-## 🚀 Deployment Steps
-
-1. ✅ **Review Script**: بررسی `MigrateUsersToClubMembership.sql`
-2. ✅ **Backup Database**: پشتیبان‌گیری قبل از اجرا
-3. ✅ **Test on Staging**: اجرای آزمایشی روی staging
-4. ✅ **Run Migration**: اجرای production
-5. ✅ **Validate Results**: اجرای validation queries
-6. ✅ **Monitor Logs**: بررسی لاگ‌های SQL Server
-
---
-
-## 🐛 Known Issues
-
-**None** - تمام مشکلات شناسایی شده در مراحل توسعه رفع شدند.
-
---
-
-## 📖 Documentation Updates
-
-**Files Modified/Created**:
-1. `implementation-status.md` - افزودن بخش Recent Updates (2025-12-09)
-2. `club-membership-migration.md` - مستند جامع migration scripts (NEW)
-3. `00-INDEX.md` - اضافه کردن لینک به migration docs
-4. `CHANGELOG-CLUB-FEATURES.md` - این فایل (NEW)
-
---
-
-## 👥 Contributors
-
- **Developer**: GitHub Copilot
- **Review**: N/A
- **Date**: 2025-12-09
-
---
-
-## 🔗 Related Issues
-
- Feature Request: "اختصاص خودکار ویژگی‌های باشگاه"
- Task: "مهاجرت کاربران موجود به سیستم باشگاه"
-
---
-
-**Version History**:
- `1.1.0` (2025-12-09): Auto-grant club features + Migration scripts
- `1.0.0` (2024-12-04): Initial club membership implementation
@@ -1,188 +0,0 @@
-# 📝 یادداشت پاکسازی (Cleanup Notes)
-
-**تاریخ**: ۱۴ آذر ۱۴۰۴  
-**عملیات**: پاکسازی فایل‌های تکراری و پوشه‌های قدیمی
-
---
-
-## ✅ کارهای انجام شده
-
-### 1. حذف فایل‌های تکراری (22 فایل):
-
-#### CMS/ (11 فایل):
- ✅ `balance-calculation-carryover-logic.md` → موجود در `01-BUSINESS/`
- ✅ `binary-tree-registration-guide.md` → موجود در `01-BUSINESS/`
- ✅ `cms-data-and-business.md` → موجود در `03-BACKEND/CMS/entity-guide.md`
- ✅ `daya-loan-integration.md` → موجود در `01-BUSINESS/`
- ✅ `discount-shop-system.md` → موجود در `01-BUSINESS/`
- ✅ `email-sms-configuration-guide.md` → موجود در `03-BACKEND/CMS/`
- ✅ `implementation-progress.md` → موجود در `03-BACKEND/CMS/implementation-status.md`
- ✅ `network-club-commission-system-v1.1.md` → موجود در `01-BUSINESS/`
- ✅ `package-purchase-system.md` → موجود در `01-BUSINESS/`
- ✅ `payment-gateway-integration.md` → موجود در `03-BACKEND/CMS/payment-gateway.md`
- ✅ `README.md` → موجود در `03-BACKEND/CMS/`
-
-#### BackOffice/ (5 فایل):
- ✅ `development-plan.md` → موجود در `03-BACKEND/BackOffice.BFF/handlers-status.md`
- ✅ `README.md` → موجود در `04-FRONTEND/BackOffice/`
- ✅ `BackOffice.BFF/README.md` → موجود در `03-BACKEND/BackOffice.BFF/`
- ✅ `BackOffice.BFF/cms-integration.md` → موجود در `03-BACKEND/BackOffice.BFF/`
- ✅ `BackOffice.BFF/discount-shop-integration-plan.md` → موجود در `03-BACKEND/BackOffice.BFF/`
-
-#### FrontOffice/ (6 فایل):
- ✅ `README.md` → موجود در `04-FRONTEND/FrontOffice/`
- ✅ `FRONTOFFICE-ANALYSIS.md` → موجود در `04-FRONTEND/FrontOffice/gap-analysis.md`
- ✅ `TODO-COMMENTED-CODE.md` → موجود در `04-FRONTEND/FrontOffice/`
- ✅ `BFF-CMS-PROTOBUF-MISMATCH-ANALYSIS.md` → موجود در `03-BACKEND/FrontOffice.BFF/protobuf-mismatch.md`
- ✅ `PROGRESS-REPORT-1404-09-14.md` → موجود در `04-FRONTEND/FrontOffice/progress-report.md`
- ✅ `FrontOffice.BFF/README.md` → موجود در `03-BACKEND/FrontOffice.BFF/`
-
---
-
-### 2. انتقال به آرشیو (3 فایل):
-
- ✅ `CMS/ANALYSIS-CONTRADICTIONS-AND-ISSUES.md` → `99-ARCHIVE/`
-  - **دلیل**: سند تحلیلی قدیمی، مشکلات حل شده
-  
- ✅ `CMS/ENTITY-NAMING-REFACTORING-PLAN.md` → `99-ARCHIVE/`
-  - **دلیل**: طرح Refactoring انجام شده
-  
- ✅ `CMS/monitoring-alerts-consolidated-report.md` → `99-ARCHIVE/`
-  - **دلیل**: گزارش قدیمی Monitoring System
-
---
-
-### 3. افزوده شده به ساختار جدید (6 فایل):
-
-#### Business Logic:
- ✅ `CMS/manual-payment-system.md` → `01-BUSINESS/`
-
-#### Backend CMS:
- ✅ `CMS/migration-network-parent-guide.md` → `03-BACKEND/CMS/`
- ✅ `CMS/payment-architecture-pyms.md` → `03-BACKEND/CMS/`
-
-#### Frontend FrontOffice:
- ✅ `FrontOffice/mudblazor_classes.md` → `04-FRONTEND/FrontOffice/mudblazor-reference.md`
-  - **نکته**: 6,270 خط مرجع کامل MudBlazor Components
-
---
-
-### 4. حذف پوشه‌های خالی:
-
- ✅ `BackOffice/` - تمام فایل‌ها منتقل شدند
- ✅ `FrontOffice/` - تمام فایل‌ها منتقل شدند
- ⚠️ `BackOffice.BFF/` - فقط پوشه `docs/` باقی مانده
- ⚠️ `FrontOffice.BFF/` - فقط پوشه `docs/` باقی مانده
-
---
-
-## 📊 آمار قبل و بعد
-
-| متریک | قبل پاکسازی | بعد پاکسازی | تغییر |
-|-------|-------------|-------------|-------|
-| فایل‌های .md در Root | 5 | 5 | 0 |
-| فایل‌های CMS/ | 17 | 0 (.md) | -17 |
-| فایل‌های BackOffice/ | 2 | 0 | -2 |
-| فایل‌های FrontOffice/ | 6 | 0 | -6 |
-| فایل‌های آرشیو | 12 | 15 | +3 |
-| کل فایل‌های .md | 77 | 55 | -22 |
-
-**بهبود**: کاهش 28.5% در تعداد فایل‌ها (حذف تکرار)
-
---
-
-## 🗂️ ساختار نهایی
-
-```
-totalDoc/
-├── 00-INDEX.md                    (14KB)
-├── 00-INDEX-NEW.md                (15KB)
-├── README.md                      (3.6KB)
-├── QUICK-REFERENCE.md             (جدید)
-├── CONSOLIDATION-FINAL-REPORT.md  (15KB)
-│
-├── 01-BUSINESS/                   (7 فایل)
-│   ├── network-commission-system.md
-│   ├── discount-shop-business.md
-│   ├── package-purchase-system.md
-│   ├── daya-loan-integration.md
-│   ├── balance-calculation-rules.md
-│   ├── binary-tree-guide.md
-│   └── manual-payment-system.md   ⭐ جدید
-│
-├── 02-ARCHITECTURE/               (1 فایل)
-│   └── README.md                  (راهنما)
-│
-├── 03-BACKEND/
-│   ├── CMS/                       (9 فایل)
-│   │   ├── README.md
-│   │   ├── implementation-status.md
-│   │   ├── entity-guide.md
-│   │   ├── api-coverage.md
-│   │   ├── email-sms-configuration.md
-│   │   ├── payment-gateway.md
-│   │   ├── migration-network-parent-guide.md  ⭐ جدید
-│   │   └── payment-architecture-pyms.md       ⭐ جدید
-│   ├── BackOffice.BFF/            (4 فایل)
-│   └── FrontOffice.BFF/           (2 فایل)
-│
-├── 04-FRONTEND/
-│   ├── BackOffice/                (2 فایل)
-│   └── FrontOffice/               (5 فایل)
-│       ├── README.md
-│       ├── gap-analysis.md
-│       ├── todo-commented-code.md
-│       ├── progress-report.md
-│       └── mudblazor-reference.md  ⭐ جدید (6,270 خط)
-│
-├── 05-TASKS/                      (3 فایل)
-├── 06-DEPLOYMENT/                 (2 فایل)
-│
-├── 99-ARCHIVE/                    (15 فایل)
-│   ├── ARCHIVE-INDEX.md
-│   ├── ... (12 فایل قدیمی)
-│   ├── ANALYSIS-CONTRADICTIONS-AND-ISSUES.md       ⭐ جدید
-│   ├── ENTITY-NAMING-REFACTORING-PLAN.md           ⭐ جدید
-│   └── monitoring-alerts-consolidated-report.md    ⭐ جدید
-│
-└── (پوشه‌های قدیمی با فایل‌های non-markdown)
-    ├── CMS/                       (4 فایل: .ndm2, .sql, .txt)
-    ├── BackOffice.BFF/docs/       (فایل‌های طراحی)
-    └── FrontOffice.BFF/docs/      (فایل‌های طراحی)
-```
-
---
-
-## ⚠️ فایل‌های باقیمانده غیر Markdown
-
-پوشه‌های زیر فایل‌های **غیر markdown** دارند که حفظ شده‌اند:
-
-### CMS/:
- `model.ndm2` - دیاگرام دیتابیس
- `model1.ndm2` - دیاگرام دیتابیس (نسخه 2)
- `network_crm_calculate.txt` - محاسبات CRM
- `update-pool-percent.sql` - اسکریپت SQL
-
-### BackOffice.BFF/docs/:
- (فایل‌های طراحی - نیاز به بررسی)
-
-### FrontOffice.BFF/docs/:
- (فایل‌های طراحی - نیاز به بررسی)
-
-**توصیه**: این فایل‌ها را حفظ کنید (مربوط به database schema و scripts هستند)
-
---
-
-## ✅ نتیجه‌گیری
-
- **تمیز شد**: 22 فایل تکراری حذف
- **سازماندهی**: 6 فایل جدید به ساختار اضافه شد
- **حفظ تاریخچه**: 3 فایل به آرشیو منتقل شد
- **کارایی**: ساختار 28.5% کوچکتر و واضح‌تر
-
-**وضعیت**: ✅ ساختار مستندات بهینه و آماده استفاده
-
---
-
-**تاریخ تکمیل**: ۱۴ آذر ۱۴۰۴  
-**مسئول**: GitHub Copilot (Claude Sonnet 4.5)
@@ -1,397 +0,0 @@
-# 📊 گزارش نهایی تجمیع مستندات FourSat
-
-**تاریخ**: ۱۴ آذر ۱۴۰۴ (December 4, 2024)  
-**پروژه**: FourSat - CMS, BackOffice, FrontOffice  
-**نسخه مستندات**: 2.0  
-**وضعیت**: ✅ تجمیع کامل شد
-
---
-
-## 🎯 خلاصه اجرایی
-
-تجمیع و بازسازی کامل ساختار مستندات پروژه FourSat با موفقیت انجام شد. **42 فایل** markdown پراکنده در پوشه‌های مختلف، به **ساختار منظم 7 پوشه اصلی** منتقل شدند.
-
-### نتایج کلیدی:
- ✅ **28 فایل فعال** در ساختار جدید
- ✅ **4 فایل منسوخ** به آرشیو منتقل شدند
- ✅ **کاهش 16% تکرار** در محتوا
- ✅ **دسته‌بندی واضح** بر اساس Business/Backend/Frontend/Tasks
- ✅ **INDEX جامع** با لینک‌های سریع
-
---
-
-## 📋 مراحل انجام شده
-
-### ✅ مرحله 1: کشف و فهرست‌سازی (Discovery)
-**انجام شد در**: 1-2 ساعت
-
-#### کارهای انجام شده:
- [x] اسکن تمام فایل‌های .md در workspace
- [x] شناسایی 42 فایل markdown
- [x] دسته‌بندی اولیه بر اساس محتوا
- [x] شناسایی فایل‌های تکراری و منسوخ
-
-**خروجی**:
-```
-توزیع فایل‌ها:
- CMS/: 18 فایل (بیشترین)
- FrontOffice/: 6 فایل
- BackOffice.BFF/: 4 فایل
- BackOffice/: 2 فایل
- FrontOffice.BFF/: 1 فایل
- Root: 11 فایل
-```
-
---
-
-### ✅ مرحله 2: صحت‌سنجی محتوا (Validation)
-**انجام شد در**: 1-2 ساعت
-
-#### کارهای انجام شده:
- [x] بررسی تاریخ آخرین بروزرسانی هر فایل
- [x] شناسایی فایل‌های معتبر (32 فایل)
- [x] شناسایی فایل‌های نیازمند بروزرسانی (5 فایل)
- [x] شناسایی فایل‌های منسوخ/تکراری (5 فایل)
-
-**یافته‌های کلیدی**:
-
-#### ✅ فایل‌های معتبر:
-1. `CMS/implementation-progress.md` (3059 خط) - تا ۴ دسامبر ✅
-2. `BackOffice/development-plan.md` (1461 خط) - تا ۱ دسامبر ✅
-3. `FrontOffice/README.md` (امروز) ✅
-4. `REMAINING-TASKS-CONSOLIDATED.md` ✅
-
-#### ⚠️ فایل‌های تکراری:
-1. `network-club-commission-system.md` (1958 خط) vs `v1.1.md` (905 خط)
-   - **تصمیم**: v1.1 را نگه داشتیم (خلاصه‌تر و جامع‌تر)
-   
-2. `implementation-progress.md` (EN) vs `implementation-progress-fa.md` (FA)
-   - **تصمیم**: نسخه انگلیسی را نگه داشتیم (به‌روزتر)
-   
-3. `monitoring-alerts-implementation-report.md` vs `consolidated-report.md`
-   - **تصمیم**: نسخه consolidated را نگه داشتیم
-
-#### ❌ فایل‌های منسوخ:
-1. `REMAINING-TASKS.md` - خودش را منسوخ اعلام کرده
-2. `network-club-commission-system.md` - نسخه قدیمی
-3. `implementation-progress-fa.md` - ترجمه ناقص
-
---
-
-### ✅ مرحله 3: ساخت ساختار جدید (Structure)
-**انجام شد در**: 30 دقیقه
-
-#### کارهای انجام شده:
- [x] ایجاد پوشه‌های اصلی (01-BUSINESS تا 06-DEPLOYMENT)
- [x] ایجاد زیرپوشه‌ها (CMS, BackOffice.BFF, FrontOffice.BFF)
- [x] ایجاد پوشه آرشیو (99-ARCHIVE)
-
-**ساختار ایجاد شده**:
-```
-totalDoc/
-├── 00-INDEX.md ⭐ (فهرست جامع)
-├── 00-INDEX-NEW.md (گزارش تحلیل)
-├── 01-BUSINESS/ (6 فایل)
-│   ├── network-commission-system.md
-│   ├── discount-shop-business.md
-│   ├── package-purchase-system.md
-│   ├── daya-loan-integration.md
-│   ├── balance-calculation-rules.md
-│   └── binary-tree-guide.md
-├── 02-ARCHITECTURE/ (آینده)
-├── 03-BACKEND/
-│   ├── CMS/ (6 فایل)
-│   ├── BackOffice.BFF/ (4 فایل)
-│   └── FrontOffice.BFF/ (2 فایل)
-├── 04-FRONTEND/
-│   ├── BackOffice/ (2 فایل)
-│   └── FrontOffice/ (4 فایل)
-├── 05-TASKS/
-│   ├── CURRENT-SPRINT.md ⭐
-│   ├── BACKLOG.md
-│   └── verification-template.md
-├── 06-DEPLOYMENT/
-│   ├── quick-start.md
-│   └── delivery-readiness.md
-└── 99-ARCHIVE/ (4 فایل + ARCHIVE-INDEX.md)
-```
-
---
-
-### ✅ مرحله 4: تجمیع اسناد (Consolidation)
-**انجام شد در**: 1 ساعت
-
-#### کارهای انجام شده:
- [x] کپی فایل‌های Business Logic به `01-BUSINESS/`
- [x] کپی فایل‌های CMS Backend به `03-BACKEND/CMS/`
- [x] کپی فایل‌های BFF به `03-BACKEND/BackOffice.BFF/` و `FrontOffice.BFF/`
- [x] کپی فایل‌های Frontend به `04-FRONTEND/`
- [x] کپی فایل‌های Tasks به `05-TASKS/`
- [x] کپی فایل‌های Deployment به `06-DEPLOYMENT/`
-
-**آمار عملیات**:
-```bash
-✅ Business docs: 6 فایل کپی شد
-✅ CMS backend: 6 فایل کپی شد
-✅ BackOffice.BFF: 4 فایل کپی شد
-✅ FrontOffice.BFF: 2 فایل کپی شد
-✅ BackOffice UI: 2 فایل کپی شد
-✅ FrontOffice UI: 4 فایل کپی شد
-✅ Tasks: 2 فایل کپی شد
-✅ Deployment: 2 فایل کپی شد
-```
-
-**نکته**: فایل‌های اصلی در مکان قدیمی باقی ماندند (برای سازگاری با backward)
-
---
-
-### ✅ مرحله 5: بروزرسانی TODO ها (Tasks Update)
-**انجام شد در**: 1 ساعت
-
-#### کارهای انجام شده:
- [x] استخراج TODO ها از `FrontOffice/TODO-COMMENTED-CODE.md`
- [x] استخراج TODO ها از `FrontOffice.BFF/protobuf-mismatch.md`
- [x] استخراج TODO ها از `REMAINING-TASKS-CONSOLIDATED.md`
- [x] ایجاد `05-TASKS/CURRENT-SPRINT.md` با اولویت‌بندی
-
-**خروجی - CURRENT-SPRINT.md**:
-```
-🔥 High Priority (امروز/فردا):
-  - FrontOffice UI Integration (7 صفحه)
-  - Protobuf Mismatch Fixes (3 Handler)
-
-🟡 Medium Priority (این هفته):
-  - WalletService Implementation (5 متد)
-  - Package Purchase UI (4 صفحه)
-
-🟢 Low Priority (هفته بعد):
-  - VAT System (2 روز)
-  - RBAC System (1.5 هفته)
-```
-
-**تعداد TODO ها**:
- **High**: 10 task
- **Medium**: 9 task
- **Low**: 2 task
- **جمع**: 21 task فعال
-
---
-
-### ✅ مرحله 6: آرشیو اسناد منسوخ (Archive)
-**انجام شد در**: 20 دقیقه
-
-#### کارهای انجام شده:
- [x] انتقال `REMAINING-TASKS.md` به `99-ARCHIVE/REMAINING-TASKS-OLD-2024-12-02.md`
- [x] انتقال `network-club-commission-system.md` به آرشیو
- [x] انتقال `implementation-progress-fa.md` به آرشیو
- [x] انتقال `monitoring-alerts-implementation-report.md` به آرشیو
- [x] ایجاد `99-ARCHIVE/ARCHIVE-INDEX.md` با توضیحات
-
-**فایل‌های آرشیو شده**:
-```
-1. REMAINING-TASKS-OLD-2024-12-02.md (1556 خط)
-2. network-club-commission-system-OLD.md (1958 خط)
-3. implementation-progress-fa-OLD.md (1499 خط)
-4. monitoring-alerts-partial-OLD.md (334 خط)
-
-جمع: 5,347 خط از مستندات فعال حذف شد
-```
-
---
-
-### ✅ مرحله 7: ایجاد INDEX جامع (Index Creation)
-**انجام شد در**: 2 ساعت
-
-#### کارهای انجام شده:
- [x] ایجاد `00-INDEX.md` با جدول محتوا
- [x] افزودن لینک‌های مستقیم به تمام فایل‌ها
- [x] ایجاد بخش "راهنمای سریع" برای نقش‌های مختلف
- [x] افزودن آمار و وضعیت پروژه
- [x] ایجاد جدول "جستجوی سریع" برای موضوعات کلیدی
-
-**ویژگی‌های INDEX**:
- 📊 **Dashboard وضعیت**: Backend 95%, Frontend 75%
- 🎯 **Quick Navigation**: لینک مستقیم به کارهای جاری
- 🔍 **Search Table**: جستجو بر اساس موضوع (Club, Network, Commission, etc.)
- 📈 **Stats**: 28 فایل فعال، 4 آرشیو، 7 پوشه
- 🤝 **Contribution Guide**: قوانین به‌روزرسانی مستندات
-
---
-
-## 📊 آمار نهایی
-
-### قبل از تجمیع:
-| متریک | مقدار |
-|-------|-------|
-| تعداد فایل .md | 42 فایل |
-| حجم کل | ~33,000 خط |
-| ساختار | پراکنده در 5 پوشه |
-| فایل‌های تکراری | 5 فایل |
-| INDEX قدیمی | 24 فایل ثبت شده (ناقص) |
-
-### بعد از تجمیع:
-| متریک | مقدار |
-|-------|-------|
-| فایل‌های فعال | 28 فایل |
-| فایل‌های آرشیو | 4 فایل |
-| ساختار جدید | 7 پوشه منظم |
-| کاهش تکرار | ~16% |
-| INDEX جدید | 28 فایل با لینک + آمار |
-
-### توزیع فایل‌ها:
-```
-01-BUSINESS/:          6 فایل (21%)
-02-ARCHITECTURE/:      0 فایل (Roadmap)
-03-BACKEND/:          12 فایل (43%)
-  ├── CMS/:            6 فایل
-  ├── BackOffice.BFF:  4 فایل
-  └── FrontOffice.BFF: 2 فایل
-04-FRONTEND/:          6 فایل (21%)
-  ├── BackOffice/:     2 فایل
-  └── FrontOffice/:    4 فایل
-05-TASKS/:             3 فایل (11%)
-06-DEPLOYMENT/:        2 فایل (7%)
-99-ARCHIVE/:           5 فایل (4 + index)
-Root:                  2 فایل (INDEX ها)
-```
-
---
-
-## 🎯 دستاوردهای کلیدی
-
-### 1️⃣ دسته‌بندی منطقی
-✅ مستندات بر اساس **Business Logic** (نه تکنولوژی) دسته‌بندی شدند  
-✅ توسعه‌دهنده می‌تواند بر اساس **نقش** (Backend/Frontend/PM) فایل پیدا کند  
-✅ مستندات Business مستقل از Implementation هستند
-
-### 2️⃣ حذف تکرار
-✅ 5 فایل تکراری شناسایی و یکپارچه شدند  
-✅ 4 فایل منسوخ به آرشیو منتقل شدند  
-✅ محتوای مفید ادغام شد، اطلاعات از دست نرفت
-
-### 3️⃣ TODO های فعال
-✅ CURRENT-SPRINT.md با 21 task مشخص  
-✅ اولویت‌بندی واضح (High/Medium/Low)  
-✅ تخمین زمان و Blocker ها مشخص است
-
-### 4️⃣ آرشیو هوشمند
-✅ فایل‌های قدیمی حذف نشدند (آرشیو شدند)  
-✅ ARCHIVE-INDEX.md توضیح می‌دهد چرا هر فایل آرشیو شد  
-✅ لینک به فایل جایگزین موجود است
-
-### 5️⃣ INDEX جامع
-✅ یک نقطه ورود برای تمام مستندات  
-✅ جستجوی سریع بر اساس موضوع  
-✅ آمار و وضعیت پروژه در یک نگاه
-
---
-
-## ⚠️ موارد نیازمند توجه
-
-### 1. Backward Compatibility
-**وضعیت**: ⚠️ فایل‌های قدیمی هنوز در مکان اصلی هستند
-
-**دلیل**: ممکن است لینک‌های هارد کد در جاهای دیگر وجود داشته باشد
-
-**توصیه**:
- [ ] بررسی تمام لینک‌ها در کد و README ها
- [ ] جایگزینی تدریجی با لینک‌های جدید
- [ ] حذف فایل‌های قدیمی بعد از 2 هفته
-
-### 2. Architecture Docs
-**وضعیت**: ⏳ پوشه `02-ARCHITECTURE/` خالی است
-
-**کارهای آینده**:
- [ ] System Overview Diagram
- [ ] Microservices Communication Flow
- [ ] Database ERD
- [ ] Security Architecture
-
-### 3. Index های متعدد
-**وضعیت**: ⚠️ هم `00-INDEX.md` و هم `00-INDEX-NEW.md` موجود است
-
-**تصمیم مورد نیاز**:
- آیا `00-INDEX-NEW.md` (گزارش تحلیل) را نگه داریم یا حذف کنیم؟
- **پیشنهاد**: تبدیل به `00-ANALYSIS-REPORT.md`
-
-### 4. فایل‌های باقیمانده در Root
-**وضعیت**: ⚠️ برخی فایل‌ها هنوز در Root/CMS/BackOffice قدیمی هستند
-
-**آمار**:
-```bash
-# فایل‌های باقیمانده که هنوز منتقل نشدند:
- CMS/: ~10 فایل (ANALYSIS, ENTITY-NAMING, etc.)
- FrontOffice/: mudblazor_classes.md (6270 خط!)
- BackOffice.BFF/: .github/git-commit-instructions.md
-```
-
-**تصمیم مورد نیاز**: چه کنیم با این فایل‌ها؟
-
---
-
-## 🚀 مراحل بعدی (Roadmap)
-
-### کوتاه‌مدت (این هفته):
- [ ] بررسی لینک‌های شکسته در INDEX
- [ ] تصمیم‌گیری درباره فایل‌های باقیمانده
- [ ] تبدیل `00-INDEX-NEW.md` به `00-ANALYSIS-REPORT.md`
- [ ] به‌روزرسانی `CURRENT-SPRINT.md` هر روز
-
-### میان‌مدت (این ماه):
- [ ] ایجاد مستندات Architecture (02-ARCHITECTURE/)
- [ ] ایجاد README.md برای هر پوشه
- [ ] افزودن Diagram ها و تصاویر
- [ ] CI/CD برای بررسی خودکار لینک‌ها
-
-### بلندمدت (فصل آینده):
- [ ] MkDocs یا Docusaurus برای Documentation Site
- [ ] Search Engine برای مستندات
- [ ] Versioning برای مستندات
- [ ] Multi-language Support (FA + EN)
-
---
-
-## 💡 توصیه‌های بهبود
-
-### 1. قوانین مستندات:
-```markdown
-✅ هر Feature → یک سند Business در 01-BUSINESS/
-✅ هر API → ثبت در 03-BACKEND/{service}/api-coverage.md
-✅ هر UI Page → ثبت در 04-FRONTEND/{app}/ui-status.md
-✅ هر TODO → افزودن به CURRENT-SPRINT.md
-```
-
-### 2. Git Hook برای Documentation:
-```bash
-# pre-commit hook
-if [ -f "*.cs" ] && grep -q "TODO" *.cs; then
-  echo "⚠️  TODO found! Update CURRENT-SPRINT.md"
-fi
-```
-
-### 3. Review Process:
- هر Pull Request باید شامل بروزرسانی مستندات باشد
- Documentation Review قبل از Merge
- آمار Coverage مستندات در CI/CD
-
---
-
-## 📝 نتیجه‌گیری
-
-تجمیع مستندات FourSat با موفقیت انجام شد و ساختار جدید:
-
-✅ **واضح**: هر کس می‌داند کجا دنبال چی بگردد  
-✅ **کامل**: تمام اطلاعات (حتی قدیمی) حفظ شد  
-✅ **قابل نگهداری**: قوانین واضح برای به‌روزرسانی  
-✅ **مقیاس‌پذیر**: ساختار برای رشد آینده آماده است  
-
-**زمان کل**: ~6-7 ساعت  
-**کیفیت**: ⭐⭐⭐⭐⭐ (5/5)  
-**وضعیت**: ✅ Ready for Production
-
---
-
-**تاریخ تکمیل**: ۱۴ آذر ۱۴۰۴، ساعت ۱۵:۳۰  
-**تحلیلگر**: GitHub Copilot (Claude Sonnet 4.5)  
-**تایید**: منتظر بازبینی تیم
-
@@ -1,451 +0,0 @@
-# 🎉 وضعیت نهایی پروژه - FourSat
-
-**تاریخ تکمیل**: ۱۷ آذر ۱۴۰۴ (December 8, 2025)  
-**نسخه**: 3.1 - PRODUCTION READY ✅  
-**وضعیت**: 100% COMPLETE - ALL SYSTEMS OPERATIONAL 🚀
-
---
-
-## 🏆 پروژه 100% تکمیل شد!
-
-### آخرین دستاوردها (December 8, 2025):
- ✅ **BackOffice UI**: 97% Complete (65+ pages) - Advanced features added
- ✅ **BackOffice.BFF**: 100% Complete - Architecture refactored
- ✅ **Daya Loan Integration**: 100% Complete - Real API Fully Implemented
-  - DayaLoanApiService: Complete HTTP client integration
-  - API Endpoint: POST /api/merchant/contracts
-  - Status Mapping: Persian descriptions → Enum values
-  - Configuration: Mock/Real switchable via appsettings.json
-  - Worker: Running every 15 minutes with real API
- ✅ **Product Image Management**: Backend FULLY implemented
-  - ProductsService methods: uncommented and active
-  - CQRS Handlers: AddProductImage, GetProductGallery, RemoveProductImage
-  - CMS Integration: Connected to ProductGalleries microservice
-  - Image Optimization: SixLabors.ImageSharp (1200x1200 + 300x300)
- ✅ **BulkEdit Module**: Fully operational
- ✅ **9 Modules**: All active and working
- ✅ **38+ Pages**: Production ready
- ✅ **14 Proto Projects**: All compiled successfully
- ✅ **0 Excluded Files**: Everything enabled!
-
-### تغییرات اخیر (۱۷ آذر ۱۴۰۴):
- ✅ **رفع Anti-Pattern معماری**: BackOffice.BFF حالا از Protobuf اختصاصی خودش استفاده می‌کند
-  - 4 پروژه Protobuf جدید: ClubMembership, Commission, Configuration, NetworkMembership
-  - Namespace: `Foursat.BackOffice.BFF.{Module}.Protos`
-  - Version: 0.0.6 منتشر شد در GitLab registry
- ✅ **HTTP Annotations برای Swagger**: 33 endpoint با HTTP annotations
-  - Package: Google.Api.CommonProtos v2.10.0
-  - Import: google/api/annotations.proto
- ✅ **Mapster Immutable Types**: رفع خطای runtime
-  - NetworkMembershipProfile با MapWith() پیاده‌سازی شد
-  - RepeatedField و Timestamp mapping دستی
- ✅ **Multi-Role Authorization**: پشتیبانی از JWT آرایه‌ای
-  - GetUserRolesAsync() برای خواندن همه نقش‌ها
-  - AuthorizationService با roles.Any() بروز شد
- ✅ **Network Tree Visualization**: نمایش درختی تعاملی شبکه
-  - D3.js v7 با zoom/pan
-  - رنگ‌بندی: سبز (فعال)، قرمز (غیرفعال)، نارنجی/سبز (چپ/راست)
-  - کلیک روی نود برای بارگذاری مجدد درخت
- ✅ **User AutoComplete**: جستجوی چند فیلدی کاربران
-  - جستجو در: Mobile, FirstName, LastName, NationalCode
-  - Debounce: 500ms
-
---
-
-## ⚠️ ملاحظات بحرانی - Proto Package Management
-
-> **این نکته باعث صرفه‌جویی ساعت‌ها وقت Debug می‌شود!**
-
-### قانون طلایی: هر تغییر Proto = 3 مرحله
-
-```
-تغییر Proto → Version++ → Pack → Update در لایه بالاتر
-```
-
-**مثال واقعی:**
-1. تغییر `products.proto` در CMS
-2. افزایش `<Version>0.0.142</Version>` به `0.0.143`
-3. `dotnet pack -c Release` (auto-push به GitLab)
-4. Update `Foursat.CMSMicroservice.Protobuf` version در BackOffice.BFF
-5. Pack کردن BackOffice.BFF Protos
-6. Update در BackOffice UI
-
-**این قانون برای ALL سرویس‌ها صادق است - نه فقط یکی!**
-
-**⚠️ Bug های رایج در صورت فراموشی:**
- Build موفق ولی Runtime error
- "Method not found" exceptions
- "Type mismatch" errors
- گیر کردن در Debug بی‌دلیل
-
---
-
-## 📊 خلاصه اجرایی
-
-پروژه تجمیع و بازسازی مستندات FourSat با موفقیت **100% تکمیل** شد. 
-
-### دستاوردهای کلیدی:
- ✅ **42 فایل** پراکنده → **32 فایل** سازمان‌یافته
- ✅ **22 فایل تکراری** حذف شد (کاهش 28.5%)
- ✅ **7 پوشه منظم** با دسته‌بندی منطقی
- ✅ **15 فایل آرشیو** با حفظ تاریخچه
- ✅ **5 فایل راهنما** برای دسترسی سریع
- ✅ **0 فقدان داده** - همه چیز حفظ شد
-
---
-
-## 📂 ساختار نهایی
-
-```
-totalDoc/
-├── 00-INDEX.md                    ⭐ فهرست جامع (14KB)
-├── README.md                      📖 راهنمای سریع (3.6KB)
-├── QUICK-REFERENCE.md             🎯 مرجع سریع
-├── CONSOLIDATION-FINAL-REPORT.md  📊 گزارش تجمیع (15KB)
-├── CLEANUP-NOTES.md               📝 یادداشت پاکسازی
-├── FINAL-STATUS.md                🎉 این فایل
-│
-├── 01-BUSINESS/                   📊 Business Logic (7 فایل)
-├── 02-ARCHITECTURE/               🏗️ Architecture (1 فایل - در حال توسعه)
-├── 03-BACKEND/                    ⚙️ Backend Services (15 فایل)
-│   ├── CMS/                       (9 فایل)
-│   ├── BackOffice.BFF/            (4 فایل)
-│   └── FrontOffice.BFF/           (2 فایل)
-├── 04-FRONTEND/                   🎨 Frontend Apps (7 فایل)
-│   ├── BackOffice/                (2 فایل)
-│   └── FrontOffice/               (5 فایل)
-├── 05-TASKS/                      ✅ Tasks (3 فایل)
-├── 06-DEPLOYMENT/                 🚀 Deployment (2 فایل)
-└── 99-ARCHIVE/                    📦 Archive (15 فایل)
-```
-
-**جمع**: 55 فایل .md فعال + راهنماها
-
---
-
-## 📈 آمار تفصیلی
-
-### قبل از تجمیع:
-| متریک | مقدار |
-|-------|-------|
-| فایل‌های .md | 77 فایل |
-| فایل‌های Root | 11 فایل |
-| ساختار | پراکنده (5 پوشه قدیمی) |
-| تکرار | 22 فایل تکراری |
-| INDEX | ناقص (24 فایل) |
-| آرشیو | 0 فایل |
-
-### بعد از تجمیع:
-| متریک | مقدار | بهبود |
-|-------|-------|-------|
-| فایل‌های .md | 55 فایل | -28.5% |
-| فایل‌های Root | 5 فایل | -55% |
-| ساختار | 7 پوشه منظم | +100% |
-| تکرار | 0 فایل | -100% ✅ |
-| INDEX | کامل (32 فایل) | +33% |
-| آرشیو | 15 فایل | حفظ تاریخچه |
-
---
-
-## 🎯 محتویات اصلی
-
-### 📊 Business Logic (7 فایل):
-1. `network-commission-system.md` - شبکه باینری و کمیسیون
-2. `discount-shop-business.md` - فروشگاه تخفیف
-3. `package-purchase-system.md` - خرید پکیج طلایی
-4. `daya-loan-integration.md` - قرض‌الحسنه دایا
-5. `balance-calculation-rules.md` - محاسبه موجودی
-6. `binary-tree-guide.md` - راهنمای شبکه دودویی
-7. `manual-payment-system.md` - پرداخت دستی
-
-### ⚙️ Backend Services (15 فایل):
-
-**CMS (9 فایل)**:
- implementation-status.md (3,059 خط - Phase 1-12)
- entity-guide.md (راهنمای Entity ها)
- api-coverage.md (150+ gRPC RPCs)
- email-sms-configuration.md
- payment-gateway.md
- migration-network-parent-guide.md
- payment-architecture-pyms.md
- README.md
-
-**BackOffice.BFF (4 فایل)**:
- handlers-status.md (35 Handler)
- cms-integration.md
- discount-shop-integration.md
- README.md
-
-**FrontOffice.BFF (2 فایل)**:
- protobuf-mismatch.md (⚠️ 6 Handler با مشکل)
- README.md
-
-### 🎨 Frontend Apps (7 فایل):
-
-**BackOffice (2 فایل)**:
- ui-status.md (23 Pages)
- README.md
-
-**FrontOffice (5 فایل)**:
- gap-analysis.md (12 Module، 60% BFF، 75% UI)
- todo-commented-code.md (5 متد TODO)
- progress-report.md (گزارش امروز)
- mudblazor-reference.md (6,270 خط!)
- README.md
-
-### ✅ Tasks (3 فایل):
- CURRENT-SPRINT.md (21 task فعال)
- BACKLOG.md (Feature های آینده)
- verification-template.md (چک‌لیست QA)
-
-### 🚀 Deployment (2 فایل):
- quick-start.md (راهنمای Setup)
- delivery-readiness.md (آمادگی Production)
-
---
-
-## 🎯 اولویت‌های جاری
-
-### 🔥 High Priority (امروز/فردا):
-1. **FrontOffice UI Integration** - 7 صفحه (Club, Network, Commission)
-2. **Protobuf Mismatch Fixes** - 3 Handler
-
-### 🟡 Medium Priority (این هفته):
-3. **WalletService Implementation** - 5 متد
-4. **Package Purchase UI** - 4 صفحه
-
-**جزئیات کامل**: `05-TASKS/CURRENT-SPRINT.md`
-
---
-
-## 📊 وضعیت کدنویسی
-
-### Backend:
- ✅ **CMS Microservice**: ~98% Complete
-  - 50+ Entities
-  - 120+ Commands
-  - 80+ Queries
-  - ✅ **Daya Loan Integration**: 100% (Real API - Dec 6, 2025)
-    - DayaLoanApiService: Full HTTP integration
-    - POST /api/merchant/contracts
-    - Status mapping: Persian → Enum
-    - Worker: Every 15 minutes with real API
-  - 150+ gRPC RPCs
-  - Build: 0 errors, 287 warnings
-
- ✅ **BackOffice.BFF**: 100% (Production Ready)
-  - 35 CQRS Handlers
-  - 5 gRPC Services
-  - Build: 0 errors
-
- 🚧 **FrontOffice.BFF**: 60% (In Progress)
-  - 12 CQRS Handlers (9 old + 3 new today)
-  - 6 Handler with Protobuf issues
-
-### Frontend:
- ✅ **BackOffice UI**: 100% (Production Ready)
-  - 23 Pages
-  - 8 Dialogs
-  - Build: 0 errors
-
- 🚧 **FrontOffice UI**: 75% (In Progress)
-  - 24 Pages (7 new today)
-  - Mock Services (need real API integration)
-  - Build: 0 errors, 113 warnings
-
---
-
-## 🗂️ فایل‌های کلیدی که باید بخوانید
-
-### برای شروع:
-1. **[00-INDEX.md](00-INDEX.md)** ⭐ - نقطه شروع اصلی
-2. **[README.md](README.md)** 📖 - راهنمای سریع
-3. **[QUICK-REFERENCE.md](QUICK-REFERENCE.md)** 🎯 - مرجع فوری
-
-### برای Development:
-4. **[05-TASKS/CURRENT-SPRINT.md](05-TASKS/CURRENT-SPRINT.md)** 🔥 - کارهای جاری
-5. **[04-FRONTEND/FrontOffice/todo-commented-code.md](04-FRONTEND/FrontOffice/todo-commented-code.md)** - TODO ها
-6. **[03-BACKEND/FrontOffice.BFF/protobuf-mismatch.md](03-BACKEND/FrontOffice.BFF/protobuf-mismatch.md)** - مشکلات فنی
-
-### برای گزارش‌دهی:
-7. **[CONSOLIDATION-FINAL-REPORT.md](CONSOLIDATION-FINAL-REPORT.md)** 📊 - گزارش کامل تجمیع
-8. **[CLEANUP-NOTES.md](CLEANUP-NOTES.md)** 📝 - یادداشت پاکسازی
-9. **[06-DEPLOYMENT/delivery-readiness.md](06-DEPLOYMENT/delivery-readiness.md)** - آمادگی تحویل
-
---
-
-## ✅ چک‌لیست تکمیل
-
-### تجمیع مستندات:
- [x] **مرحله 1**: کشف و فهرست‌سازی (42 فایل شناسایی)
- [x] **مرحله 2**: صحت‌سنجی محتوا (32 معتبر، 5 نیاز به بروز، 5 منسوخ)
- [x] **مرحله 3**: ساخت ساختار (7 پوشه ایجاد شد)
- [x] **مرحله 4**: تجمیع اسناد (28 فایل کپی شد)
- [x] **مرحله 5**: بروزرسانی TODO ها (21 task فعال)
- [x] **مرحله 6**: آرشیو منسوخ (10 فایل)
- [x] **مرحله 7**: INDEX جامع (00-INDEX.md)
- [x] **مرحله 8**: گزارش نهایی (CONSOLIDATION-FINAL-REPORT.md)
-
-### پاکسازی:
- [x] **حذف تکراری**: 22 فایل از CMS/BackOffice/FrontOffice
- [x] **انتقال به آرشیو**: 3 فایل تحلیلی
- [x] **افزوده شده**: 6 فایل به ساختار جدید
- [x] **حذف پوشه‌های خالی**: BackOffice/, FrontOffice/
-
-### راهنماها:
- [x] **00-INDEX.md**: فهرست کامل با لینک‌ها
- [x] **README.md**: راهنمای کوتاه
- [x] **QUICK-REFERENCE.md**: مرجع سریع
- [x] **02-ARCHITECTURE/README.md**: Roadmap معماری
-
---
-
-## 🚀 مراحل بعدی
-
-### این هفته:
- [ ] تست تمام لینک‌ها در INDEX
- [ ] بروزرسانی روزانه CURRENT-SPRINT
- [ ] FrontOffice UI Integration (7 صفحه)
- [ ] Protobuf Mismatch Fixes (3 Handler)
-
-### این ماه:
- [ ] پر کردن 02-ARCHITECTURE/ با Diagram ها
- [ ] WalletService Implementation (5 متد)
- [ ] Package Purchase UI (4 صفحه)
- [ ] بررسی و حذف پوشه‌های قدیمی باقیمانده
-
-### فصل آینده:
- [ ] VAT System (2 روز)
- [ ] RBAC System (1.5 هفته)
- [ ] MkDocs یا Docusaurus
- [ ] Search Engine برای مستندات
-
---
-
-## 💡 توصیه‌های استفاده
-
-### برای توسعه‌دهندگان:
-```bash
-# شروع سریع
-cat totalDoc/00-INDEX.md | less
-
-# دیدن کارهای جاری
-cat totalDoc/05-TASKS/CURRENT-SPRINT.md
-
-# پیدا کردن TODO ها
-grep -r "TODO" totalDoc/04-FRONTEND/FrontOffice/
-
-# راهنمای Setup
-cat totalDoc/06-DEPLOYMENT/quick-start.md
-```
-
-### برای مدیران:
-```bash
-# وضعیت کلی
-cat totalDoc/FINAL-STATUS.md
-
-# آمادگی تحویل
-cat totalDoc/06-DEPLOYMENT/delivery-readiness.md
-
-# گزارش تجمیع
-cat totalDoc/CONSOLIDATION-FINAL-REPORT.md
-```
-
-### برای Business Analysts:
-```bash
-# قوانین کسب‌وکار
-ls totalDoc/01-BUSINESS/
-
-# شبکه و کمیسیون
-cat totalDoc/01-BUSINESS/network-commission-system.md
-```
-
---
-
-## 📊 کیفیت مستندات
-
-### معیارهای کیفیت:
- ✅ **کامل بودن**: 100% - همه بخش‌ها مستند شده
- ✅ **سازماندهی**: 100% - دسته‌بندی منطقی
- ✅ **به‌روز بودن**: 95% - آخرین بروزرسانی امروز
- ✅ **دسترسی‌پذیری**: 100% - INDEX و لینک‌ها کامل
- ✅ **حفظ تاریخچه**: 100% - آرشیو کامل
-
-### پوشش مستندات:
- ✅ **Business Logic**: 7 سند جامع
- ✅ **Backend**: 15 سند (CMS + BFFs)
- ✅ **Frontend**: 7 سند (BackOffice + FrontOffice)
- ✅ **Tasks**: 3 سند (Sprint, Backlog, QA)
- ✅ **Deployment**: 2 سند (Setup, Delivery)
- ⏳ **Architecture**: 1 سند (در حال توسعه)
-
---
-
-## 🎉 نتیجه‌گیری
-
-پروژه FourSat دارای **یکی از جامع‌ترین و منظم‌ترین مستندات** در پروژه‌های داخلی است:
-
-### دستاوردها:
- ✅ **کاهش 28.5%** در تعداد فایل‌ها (حذف تکرار)
- ✅ **بهبود 100%** در سازماندهی (7 پوشه منطقی)
- ✅ **افزایش 33%** در پوشش INDEX
- ✅ **صفر فقدان داده** (همه چیز حفظ یا آرشیو شد)
- ✅ **دسترسی‌پذیری عالی** (5 فایل راهنما)
-
-### ارزش افزوده:
- 📊 درک سریع‌تر Business برای تازه‌واردان
- ⚙️ توسعه سریع‌تر با مستندات کامل Backend
- 🎨 طراحی راحت‌تر با راهنمای Frontend
- ✅ مدیریت بهتر Task ها با CURRENT-SPRINT
- 🚀 Deployment آسان‌تر با راهنمای کامل
-
---
-
-**🏆 کیفیت**: ⭐⭐⭐⭐⭐ (5/5)  
-**�� تاریخ**: ۱۴ آذر ۱۴۰۴  
-**✅ وضعیت**: Production Ready  
-**🚀 آماده**: برای استفاده تیم
-
-**تبریک! مستندات FourSat حرفه‌ای و آماده است** 🎊
-
---
-
-## 📦 بروزرسانی - مرحله 3: سازماندهی نهایی
-
-**تاریخ**: ۱۴ آذر ۱۴۰۴ (بعدازظهر)  
-**مرحله**: تمیزسازی و سازماندهی فایل‌های غیر markdown
-
-### کارهای انجام شده:
-
-#### 1. انتقال فایل‌های طراحی و دیتابیس:
- ✅ **CMS/** → `03-BACKEND/CMS/docs/` (4 فایل):
-  - `model.ndm2` (2.4 MB)
-  - `model1.ndm2` (2.2 MB)
-  - `network_crm_calculate.txt` (28 KB)
-  - `update-pool-percent.sql` (2 KB)
-
- ✅ **BackOffice.BFF/docs/** → `03-BACKEND/BackOffice.BFF/docs/` (1 فایل):
-  - `model.ndm2`
-
- ✅ **FrontOffice.BFF/docs/** → `03-BACKEND/FrontOffice.BFF/docs/` (2 فایل):
-  - `model.ndm2`
-  - `CMS.sql`
-
-#### 2. حذف پوشه‌های قدیمی:
- ✅ `CMS/` - خالی شد و حذف شد
- ✅ `BackOffice.BFF/` - حذف شد (شامل .github/)
- ✅ `FrontOffice.BFF/` - حذف شد
-
-#### 3. ایجاد مستندات docs:
- ✅ `03-BACKEND/CMS/docs/README.md`
- ✅ `03-BACKEND/BackOffice.BFF/docs/README.md`
- ✅ `03-BACKEND/FrontOffice.BFF/docs/README.md`
-
-### نتیجه:
-**ساختار کاملاً تمیز** - فقط پوشه‌های 00-06 و 99-ARCHIVE در Root 🎊
-
---
-
-**وضعیت نهایی**: ✅ 100% Complete  
-**کیفیت**: ⭐⭐⭐⭐⭐ (5/5)  
-**ساختار**: حرفه‌ای و Production Ready
@@ -1,115 +0,0 @@
-
-
-# مستند راهنمای سرویس‌های پذیرنده - دایا دایموند
-
-شماره مستند: **TA-DAYA-S10-G-MerchantServices**  
-طبقه‌بندی: **محرمانه**
-
-## اطلاعات نسخه
-
-| تاریخ ویرایش | شرح ویرایش | نسخه |
-|--------------|------------|------|
-| 1404/09/12   | نسخه اول   | 1    |
-
---
-
-## سرویس وضعیت قرارداد کاربران
-
-این سرویس جهت نمایش وضعیت کاربرانی که درخواست وام خود را امضا کرده‌اند پیاده‌سازی شده است.  
-
- **ورودی سرویس**: لیستی از کدهای ملی  
- **خروجی سرویس**: برای هر کد ملی، شناسه قرارداد، وضعیت «امضا شده»، کد ملی مشتری درخواست‌دهنده و زمان امضای قرارداد برگردانده می‌شود.
-
-### مشخصات فنی سرویس
-
- **نوع سرویس**: RESTful
- **Base Address**: `https://testdaya.tadbirandishan.com`
- **API**: `/api/merchant/contracts`
- **Method**: `POST`
-
-### احراز هویت
-
-در Header درخواست باید یک پارامتر با نام زیر ارسال شود:
-
- Header Name: `merchant-permission-key`  
- مقدار این کلید توسط شرکت اعلام می‌شود.
-
-### نکات
-
- این سرویس به مدت **۲۰ دقیقه** نتیجه را کش می‌کند.
-
---
-
-## نمونه درخواست به‌صورت cURL
-
-```bash
-curl --location --request POST 'https://localhost:7279/api/merchant/Contracts' \
--header 'merchant-permission-key: 14752708$Db5Wk5hnhKO4FGuoKBUZIvHW5WO1NpCxYNy_sy8epfQ-d6n6vjeZJa6EnTq876cq' \
--header 'Content-Type: application/json' \
--data '{
-  "NationalCodes": [
-    "2345678901",
-    "1234567890"
-  ]
-}'
-````
-
---
-
-## نمونه بدنه‌ی درخواست (Request Body)
-
-```json
-{
-  "NationalCodes": [
-    "2345678901",
-    "1234567890"
-  ]
-}
-```
-
---
-
-## نمونه پاسخ‌های موفق (Sample Successful Response)
-
-```json
-{
-  "succeed": true,
-  "code": 200,
-  "data": [
-    {
-      "nationalCode": "1234567890",
-      "applicationNo": "C4_U8467433",
-      "statusDescription": "فعال شده (در انتظار تسویه)",
-      "dateTime": "2025-11-08T11:27:34.245193+03:30"
-    },
-    {
-      "nationalCode": "2345678901",
-      "applicationNo": "C4_C8144074",
-      "statusDescription": "فعال شده (در انتظار تسویه)",
-      "dateTime": "2025-11-08T11:31:23.602347+03:30"
-    },
-    {
-      "nationalCode": "1234567890",
-      "applicationNo": "C4_V9343786",
-      "statusDescription": "فعال شده (در انتظار تسویه)",
-      "dateTime": "2025-12-01T18:00:40.939024+03:30"
-    }
-  ]
-}
-```
-
---
-
-## نمونه پاسخ‌های ناموفق (Sample Failed Response)
-
-```json
-{
-  "succeed": false,
-  "code": 401,
-  "message": "دسترسی به سرویس مورد نظر غیرمجاز است",
-  "data": null
-}
-```
-
-```
-```
@@ -1,120 +0,0 @@
-# 🎯 FourSat - مرجع سریع (Quick Reference)
-
-> **برای دسترسی فوری به مستندات مهم**  
-> **آخرین بروزرسانی**: ۲۹ آذر ۱۴۰۴
-
---
-
-## 🆕 آخرین تغییرات
-
-### ۲۹ آذر - مایگریشن WeekNumber به WeekDefinitionId ✨
- **5 Entity** در CMS آپدیت شدند
- **Proto Files** در CMS و BFF آپدیت شدند
- **Blazor Components** در FrontOffice آپدیت شدند
- **فیلدهای جدید**: `WeekDefinitionId` (long), `WeekDisplayName` (string)
- **فیلدهای حذف شده**: `WeekNumber`, `WeekLabel`, `GregorianWeekNumber`, `PersianWeekNumber`
-
-**📄 جزئیات**: [CHANGELOG-2025-12-19.md](CHANGELOG-2025-12-19.md)
-
-### ۲۸ آذر - بهبودات FrontOffice
- سیستم مدیریت موجودی محصولات
- ویژگی‌های باشگاه مشتریان
- رفع باگ آدرس‌ها
-
-**📄 جزئیات**: [CHANGELOG-2025-12-18.md](CHANGELOG-2025-12-18.md)
-
---
-
-## 📚 لینک‌های کلیدی
-
-### ⭐ ضروری (Must Read):
-1. **[00-INDEX.md](00-INDEX.md)** - فهرست کامل (شروع از اینجا)
-2. **[05-TASKS/CURRENT-SPRINT.md](05-TASKS/CURRENT-SPRINT.md)** - کارهای جاری
-3. **[README.md](README.md)** - راهنمای کوتاه
-
-### 🔥 برای Development:
- **Setup**: [06-DEPLOYMENT/quick-start.md](06-DEPLOYMENT/quick-start.md)
- **سیستم کمیسیون**: [03-BACKEND/CMS/commission-system.md](03-BACKEND/CMS/commission-system.md) ✨
- **TODO ها**: [04-FRONTEND/FrontOffice/todo-commented-code.md](04-FRONTEND/FrontOffice/todo-commented-code.md)
- **Protobuf Issues**: [03-BACKEND/FrontOffice.BFF/protobuf-mismatch.md](03-BACKEND/FrontOffice.BFF/protobuf-mismatch.md)
-
-### 📊 برای Business:
- **شبکه و کمیسیون**: [01-BUSINESS/network-commission-system.md](01-BUSINESS/network-commission-system.md)
- **باشگاه مشتریان**: [01-BUSINESS/network-commission-system.md](01-BUSINESS/network-commission-system.md#club-membership)
- **فروشگاه تخفیف**: [01-BUSINESS/discount-shop-business.md](01-BUSINESS/discount-shop-business.md)
-
-### ⚙️ برای Backend:
- **CMS Status**: [03-BACKEND/CMS/implementation-status.md](03-BACKEND/CMS/implementation-status.md)
- **API Coverage**: [03-BACKEND/CMS/api-coverage.md](03-BACKEND/CMS/api-coverage.md)
- **Entity Guide**: [03-BACKEND/CMS/entity-guide.md](03-BACKEND/CMS/entity-guide.md)
- **Commission System**: [03-BACKEND/CMS/commission-system.md](03-BACKEND/CMS/commission-system.md) ✨
-
-### 🎨 برای Frontend:
- **BackOffice Status**: [04-FRONTEND/BackOffice/ui-status.md](04-FRONTEND/BackOffice/ui-status.md)
- **FrontOffice Gap**: [04-FRONTEND/FrontOffice/gap-analysis.md](04-FRONTEND/FrontOffice/gap-analysis.md)
-
---
-
-## 🎯 کارهای فوری (امروز/فردا)
-
-1. **FrontOffice UI Integration** (7 صفحه)
-   - Club: 3 صفحه
-   - Network: 2 صفحه
-   - Commission: 2 صفحه
-
-2. **Protobuf Mismatch Fixes** (3 Handler)
-   - ClubMembership: field name issue
-   - NetworkMembership: tree builder needed
-   - Commission: type conversion
-
-**جزئیات**: [05-TASKS/CURRENT-SPRINT.md](05-TASKS/CURRENT-SPRINT.md)
-
---
-
-## 📊 وضعیت سیستم
-
-| Component | Progress | امروز |
-|-----------|----------|--------|
-| CMS | 96% ✅ | +1% (Network Info) |
-| BackOffice.BFF | 100% ✅ | Updated (DTO) |
-| BackOffice UI | 98% ✅ | +1% (Persian Date) |
-| FrontOffice.BFF | 60% 🚧 | - |
-| FrontOffice UI | 75% 🚧 | - |
-
-### تغییرات اخیر:
- ✅ **امروز (22 آذر)**: تاریخ شمسی + اطلاعات کامل شبکه + رفع Bug هفته
- ✅ BackOffice.BFF: رفع Anti-Pattern معماری (Protobuf اختصاصی)
- ✅ HTTP Annotations: 33 endpoint برای Swagger
- ✅ Network Tree: نمایش درختی D3.js با zoom/pan
- ✅ User AutoComplete: جستجوی چند فیلدی
- ✅ Multi-Role Authorization: پشتیبانی از JWT آرایه‌ای
-
---
-
-## 🔍 جستجوی موضوعی
-
-```bash
-# باشگاه مشتریان
-grep -r "ClubMembership" 01-BUSINESS/ 03-BACKEND/
-
-# شبکه باینری
-grep -r "Binary Tree" 01-BUSINESS/
-
-# کمیسیون
-grep -r "Commission" 01-BUSINESS/ 05-TASKS/
-
-# کیف پول
-grep -r "Wallet" 01-BUSINESS/ 04-FRONTEND/
-```
-
---
-
-## 📞 پشتیبانی
-
- **Backend Issues**: [03-BACKEND/CMS/implementation-status.md](03-BACKEND/CMS/implementation-status.md)
- **Frontend Issues**: [04-FRONTEND/FrontOffice/gap-analysis.md](04-FRONTEND/FrontOffice/gap-analysis.md)
- **Business Questions**: [01-BUSINESS/](01-BUSINESS/)
-
---
-
-**تاریخ بروزرسانی**: ۲۲ آذر ۱۴۰۴ (12 دسامبر 2025)
@@ -1,288 +0,0 @@
-# 📚 راهنمای کامل Documentation - محاسبات تعادل شبکه
-
-**تاریخ**: 2025-12-09  
-**موضوع**: مستندات کامل سیستم محاسبه تعادل باینری  
-**وضعیت**: ✅ به‌روز و تکمیل شده
-
---
-
-## 🎯 شروع سریع
-
-اگر برای اولین بار هستید، این ترتیب را دنبال کنید:
-
-1. **مفاهیم اصلی**: [`binary-tree-guide.md`](./01-BUSINESS/binary-tree-guide.md)
-2. **قوانین محاسبه**: [`balance-calculation-rules.md`](./01-BUSINESS/balance-calculation-rules.md)
-3. **مثال‌های عملی**: [`balance-calculation-examples-5-levels.md`](./01-BUSINESS/balance-calculation-examples-5-levels.md)
-4. **تحلیل جدید**: [`ANALYSIS-NEW-BUSINESS-REQUIREMENTS.md`](./ANALYSIS-NEW-BUSINESS-REQUIREMENTS.md)
-5. **تغییرات اخیر**: [`CHANGELOG-2025-12-09.md`](./CHANGELOG-2025-12-09.md)
-
---
-
-## 📖 مستندات بیزینس (Business Documentation)
-
-### 🌳 ساختار شبکه باینری
-**فایل**: [`01-BUSINESS/binary-tree-guide.md`](./01-BUSINESS/binary-tree-guide.md)
-
-**محتوا**:
- ✅ قوانین Binary Tree (حداکثر 2 فرزند)
- ✅ Position validation (Left/Right)
- ✅ NetworkPlacementService API
- ✅ محدودیت‌ها و قوانین
-
-**زمان مطالعه**: 10 دقیقه
-
---
-
-### 📊 قوانین محاسبه تعادل
-**فایل**: [`01-BUSINESS/balance-calculation-rules.md`](./01-BUSINESS/balance-calculation-rules.md)
-
-**محتوا**:
- ✅ 4 مرحله محاسبات (تعادل → باقیمانده → سقف → فلش)
- ✅ فرمول‌های کامل
- ✅ Configuration-based calculation
- ✅ مثال‌های عددی
- ✅ مقایسه قبل و بعد
-
-**آخرین به‌روزرسانی**: 2025-12-09  
-**وضعیت**: ✅ Verified & Implemented
-
-**زمان مطالعه**: 20 دقیقه
-
---
-
-### 🎯 مثال‌های عملی 5 لول
-**فایل**: [`01-BUSINESS/balance-calculation-examples-5-levels.md`](./01-BUSINESS/balance-calculation-examples-5-levels.md)
-
-**محتوا**:
- ✅ درخت 63 کاربره (6 لول عمق)
- ✅ محاسبات دقیق Level به Level
- ✅ جدول جمع‌بندی
- ✅ محاسبه صندوق و توزیع
- ✅ سناریوهای پیچیده (نامتعادل، سقف، Carryover)
- ✅ 10+ مثال عددی مختلف
-
-**تاریخ ایجاد**: 2025-12-09  
-**وضعیت**: ✅ جامع و کامل
-
-**زمان مطالعه**: 30 دقیقه
-
---
-
-### 💼 سیستم کمیسیون شبکه
-**فایل**: [`01-BUSINESS/network-commission-system.md`](./01-BUSINESS/network-commission-system.md)
-
-**محتوا**:
- ✅ مفاهیم کلیدی (کیف پول‌ها، فعال‌سازی)
- ✅ موجودیت‌های Domain
- ✅ فرآیند کامل ثبت نام تا پرداخت
- ✅ History & Audit tables
-
-**زمان مطالعه**: 40 دقیقه
-
---
-
-### 💰 سیستم خرید پکیج
-**فایل**: [`01-BUSINESS/package-purchase-system.md`](./01-BUSINESS/package-purchase-system.md)
-
-**محتوا**:
- ✅ انواع پکیج‌ها
- ✅ فرآیند خرید
- ✅ شارژ کیف پول‌ها
- ✅ تبدیل به عضویت باشگاه
-
-**زمان مطالعه**: 15 دقیقه
-
---
-
-## 🔍 تحلیل و گزارش‌ها
-
-### 📋 تحلیل توضیحات جدید بیزینس
-**فایل**: [`ANALYSIS-NEW-BUSINESS-REQUIREMENTS.md`](./ANALYSIS-NEW-BUSINESS-REQUIREMENTS.md)
-
-**محتوا**:
- ✅ مقایسه با Documentation موجود (95% سازگاری)
- ✅ مقایسه با کد فعلی (100% Balance Logic)
- ✅ تناقضات شناسایی شده
- ✅ لیست Task های لازم برای اصلاح
- ✅ جدول مقایسه تفصیلی
-
-**تاریخ**: 2025-12-08  
-**آخرین به‌روزرسانی**: 2025-12-09
-
-**زمان مطالعه**: 25 دقیقه
-
---
-
-### 📝 توضیحات جدید بیزینس (خام)
-**فایل**: [`01-BUSINESS/new-business-requirements-2025-12-08.md`](./01-BUSINESS/new-business-requirements-2025-12-08.md)
-
-**محتوا**:
- ✅ خلاصه‌سازی متن شفاهی صاحب پروژه
- ✅ 10 بخش کامل
- ✅ جدول مقایسه حالات مختلف
- ✅ فرآیند کامل فعال‌سازی
-
-**زمان مطالعه**: 20 دقیقه
-
---
-
-## 📌 تغییرات و به‌روزرسانی‌ها
-
-### 🆕 آخرین تغییرات (2025-12-09)
-**فایل**: [`CHANGELOG-2025-12-09.md`](./CHANGELOG-2025-12-09.md)
-
-**محتوا**:
- ✅ اصلاح کد محاسبه تعادل (قبل و بعد)
- ✅ مقایسه نتایج
- ✅ فایل‌های تغییر یافته
- ✅ یادداشت‌های مهم برای Developer
- ✅ Query های تست
-
-**زمان مطالعه**: 10 دقیقه
-
---
-
-## 📋 Task ها و اولویت‌ها
-
-### ✅ Task های اصلاحی
-**فایل**: [`05-TASKS/NEW-BUSINESS-REQUIREMENTS-TASKS.md`](./05-TASKS/NEW-BUSINESS-REQUIREMENTS-TASKS.md)
-
-**محتوا**:
- ✅ Task #0: اصلاح محاسبات (Complete ✅)
- 🔥 Task #1: DeleteInactiveUsersWorker (6h)
- 🔥 Task #2: الزامی دیالوگ باشگاه (8h)
- 🔥 Task #3: شرط لینک معرفی (4h)
- ⚠️ Task #4: Validation 2 فرزند فعال (4h)
- ⚠️ Task #5: پیغام کد معرف پر (3h)
- 📝 Task #6: Update Documentation (3h)
-
-**جمع زمان باقیمانده**: 28 ساعت (~4 روز)
-
-**زمان مطالعه**: 15 دقیقه
-
---
-
-## 🎓 مسیر یادگیری پیشنهادی
-
-### برای Developer تازه‌کار:
-```
-1. binary-tree-guide.md (مفاهیم پایه)
-   ↓
-2. network-commission-system.md (کل سیستم)
-   ↓
-3. balance-calculation-rules.md (قوانین محاسبه)
-   ↓
-4. balance-calculation-examples-5-levels.md (مثال‌های عملی)
-   ↓
-5. کد: CalculateWeeklyBalancesCommandHandler.cs (پیاده‌سازی)
-```
-
-**زمان کل**: 2-3 ساعت
-
---
-
-### برای Senior Developer:
-```
-1. CHANGELOG-2025-12-09.md (آخرین تغییرات)
-   ↓
-2. balance-calculation-rules.md (قوانین دقیق)
-   ↓
-3. ANALYSIS-NEW-BUSINESS-REQUIREMENTS.md (تحلیل کامل)
-   ↓
-4. 05-TASKS/NEW-BUSINESS-REQUIREMENTS-TASKS.md (Task ها)
-   ↓
-5. کد: بررسی Implementation
-```
-
-**زمان کل**: 1-2 ساعت
-
---
-
-### برای Business Analyst:
-```
-1. new-business-requirements-2025-12-08.md (توضیحات اولیه)
-   ↓
-2. balance-calculation-examples-5-levels.md (مثال‌های عملی)
-   ↓
-3. ANALYSIS-NEW-BUSINESS-REQUIREMENTS.md (تحلیل)
-   ↓
-4. network-commission-system.md (کل سیستم)
-```
-
-**زمان کل**: 1.5-2 ساعت
-
---
-
-## 🔗 لینک‌های سریع
-
-### مستندات اصلی:
- [Binary Tree Guide](./01-BUSINESS/binary-tree-guide.md)
- [Balance Calculation Rules](./01-BUSINESS/balance-calculation-rules.md)
- [5-Level Examples](./01-BUSINESS/balance-calculation-examples-5-levels.md)
- [Network Commission System](./01-BUSINESS/network-commission-system.md)
-
-### تحلیل و گزارش:
- [Analysis Report](./ANALYSIS-NEW-BUSINESS-REQUIREMENTS.md)
- [New Requirements](./01-BUSINESS/new-business-requirements-2025-12-08.md)
- [Changelog](./CHANGELOG-2025-12-09.md)
-
-### Task ها:
- [Task List](./05-TASKS/NEW-BUSINESS-REQUIREMENTS-TASKS.md)
- [Current Sprint](./05-TASKS/CURRENT-SPRINT.md)
- [Backlog](./05-TASKS/BACKLOG.md)
-
-### کد:
- [CalculateWeeklyBalancesCommandHandler.cs](../CMS/src/CMSMicroservice.Application/CommissionCQ/Commands/CalculateWeeklyBalances/CalculateWeeklyBalancesCommandHandler.cs)
- [CalculateWeeklyCommissionPoolCommandHandler.cs](../CMS/src/CMSMicroservice.Application/CommissionCQ/Commands/CalculateWeeklyCommissionPool/CalculateWeeklyCommissionPoolCommandHandler.cs)
-
---
-
-## 📊 آمار مستندات
-
-```
-تعداد فایل‌ها: 10+
-تعداد خطوط: 2000+
-تاریخ آخرین به‌روزرسانی: 2025-12-09
-وضعیت: ✅ 95% Complete
-```
-
-### Coverage:
- ✅ Business Logic: 100%
- ✅ Examples: 100%
- ✅ Code Implementation: 100%
- ⚠️ User Flow: 60%
- ❌ Background Workers: 0%
-
---
-
-## 🎯 نکات کلیدی
-
-### 🔥 حیاتی:
-1. **ترتیب 4 مرحله** در محاسبات تعادل دست نخورده باشد
-2. **باقیمانده جداگانه** (چپ و راست) ذخیره شود
-3. **فلش از دو طرف** محاسبه شود
-
-### ⚠️ مهم:
-4. سقف 300 روی **امتیاز نهایی** است، نه تعادل اولیه
-5. هر کاربر **مستقل** محاسبه می‌شود
-6. باقیمانده‌ها برای **هفته بعد** نگهداری می‌شوند
-
-### 💡 توصیه:
-7. قبل از تغییر کد، حتماً مستندات را بخوانید
-8. بعد از تغییر، مثال‌های 5 لول را تست کنید
-9. Documentation را همزمان با کد به‌روز کنید
-
---
-
-## 📞 ارتباط
-
-برای سوال یا پیشنهاد در مورد مستندات:
- مستندات را در `totalDoc/` قرار دهید
- Changelog ها را در ریشه `totalDoc/` نگه دارید
- مثال‌ها را در `01-BUSINESS/` اضافه کنید
-
---
-
-**آخرین به‌روزرسانی**: 2025-12-09  
-**نسخه**: 2.0  
-**نگهدارنده**: AI Assistant
@@ -1,135 +0,0 @@
-# 📚 FourSat Project Documentation
-
-> **نسخه 2.1** - آخرین بروزرسانی: ۲۹ آذر ۱۴۰۴ (19 December 2025)
-
---
-
-## 📋 تغییرات اخیر
-
-### ۲۹ آذر - مایگریشن WeekNumber به WeekDefinitionId
- تغییر از `string WeekNumber` به `long WeekDefinitionId` در سیستم کمیسیون
- آپدیت تمام Entities، Protos، DTOs و Blazor Components
- مستندات: [CHANGELOG-2025-12-19.md](CHANGELOG-2025-12-19.md)
-
-### ۲۸ آذر - بهبودات FrontOffice
- سیستم مدیریت موجودی محصولات
- ویژگی‌های باشگاه مشتریان
- مستندات: [CHANGELOG-2025-12-18.md](CHANGELOG-2025-12-18.md)
-
---
-
-## 🚀 شروع سریع
-
-### برای توسعه‌دهندگان:
-```bash
-# خواندن فهرست کامل
-cat 00-INDEX.md
-
-# دیدن کارهای جاری
-cat 05-TASKS/CURRENT-SPRINT.md
-
-# راهنمای Setup
-cat 06-DEPLOYMENT/quick-start.md
-```
-
-### برای مدیران پروژه:
- **وضعیت کلی**: [00-INDEX.md](00-INDEX.md)
- **گزارش تحویل**: [06-DEPLOYMENT/delivery-readiness.md](06-DEPLOYMENT/delivery-readiness.md)
- **Backlog**: [05-TASKS/BACKLOG.md](05-TASKS/BACKLOG.md)
-
---
-
-## 📊 وضعیت پروژه
-
-| Component | Status | Progress |
-|-----------|--------|----------|
-| CMS Microservice | ✅ Production Ready | 95% |
-| BackOffice.BFF | ✅ Production Ready | 100% |
-| BackOffice UI | ✅ Production Ready | 100% |
-| FrontOffice.BFF | 🚧 In Progress | 60% |
-| FrontOffice UI | 🚧 In Progress | 75% |
-
---
-
-## 🗂️ ساختار مستندات
-
-```
-totalDoc/
-├── 00-INDEX.md              ⭐ فهرست کامل (شروع از اینجا)
-├── 01-BUSINESS/             📊 Business Logic & Rules
-├── 02-ARCHITECTURE/         🏗️ System Architecture (در حال توسعه)
-├── 03-BACKEND/              ⚙️ Backend Services (CMS, BFFs)
-├── 04-FRONTEND/             🎨 Frontend Apps (BackOffice, FrontOffice)
-├── 05-TASKS/                ✅ Sprint, Backlog, QA
-├── 06-DEPLOYMENT/           🚀 Deployment & Operations
-└── 99-ARCHIVE/              📦 Archived Documents
-```
-
---
-
-## 🔍 پیدا کردن سریع
-
-| موضوع | فایل |
-|-------|------|
-| باشگاه مشتریان | [01-BUSINESS/network-commission-system.md](01-BUSINESS/network-commission-system.md) |
-| شبکه باینری | [01-BUSINESS/binary-tree-guide.md](01-BUSINESS/binary-tree-guide.md) |
-| فروشگاه تخفیف | [01-BUSINESS/discount-shop-business.md](01-BUSINESS/discount-shop-business.md) |
-| سیستم کمیسیون | [03-BACKEND/CMS/commission-system.md](03-BACKEND/CMS/commission-system.md) ✨ |
-| پیاده‌سازی CMS | [03-BACKEND/CMS/implementation-status.md](03-BACKEND/CMS/implementation-status.md) |
-| TODO ها | [04-FRONTEND/FrontOffice/todo-commented-code.md](04-FRONTEND/FrontOffice/todo-commented-code.md) |
-| کارهای جاری | [05-TASKS/CURRENT-SPRINT.md](05-TASKS/CURRENT-SPRINT.md) 🔥 |
-
---
-
-## 📝 Changelogs
-
-| تاریخ | فایل | موضوع |
-|-------|------|-------|
-| ۲۹ آذر ۱۴۰۴ | [CHANGELOG-2025-12-19.md](CHANGELOG-2025-12-19.md) | مایگریشن WeekNumber به WeekDefinitionId |
-| ۲۸ آذر ۱۴۰۴ | [CHANGELOG-2025-12-18.md](CHANGELOG-2025-12-18.md) | مدیریت موجودی، ClubFeatures |
-| ۲۱ آذر ۱۴۰۴ | [SESSION-2025-12-12-PERSIAN-DATE-AND-NETWORK-INFO-IMPROVEMENTS.md](SESSION-2025-12-12-PERSIAN-DATE-AND-NETWORK-INFO-IMPROVEMENTS.md) | تاریخ شمسی و Network Info |
-| ۱۸ آذر ۱۴۰۴ | [CHANGELOG-2025-12-09.md](CHANGELOG-2025-12-09.md) | ClubFeatures، Balance Calculation |
-
---
-
-## 🎯 اولویت‌های جاری (۲۹ آذر)
-
-### ✅ انجام شده:
-1. **مایگریشن WeekNumber به WeekDefinitionId** - تمام لایه‌ها
-2. **آپدیت Proto Files** - CMS و FrontOffice.BFF
-3. **آپدیت Blazor Components** - FrontOffice
-
-### 🔥 High Priority:
-1. **اجرای EF Migration** - دیتابیس CMS
-2. **Data Migration Scripts** - انتقال داده‌های موجود
-3. **پابلیش NuGet Packages** - proto ها
-
-**جزئیات**: [05-TASKS/CURRENT-SPRINT.md](05-TASKS/CURRENT-SPRINT.md)
-
---
-
-## 📈 آمار
-
- **Backend**: 50+ Entities, 120+ Commands, 150+ gRPC RPCs
- **Frontend**: 47 Pages (23 BackOffice + 24 FrontOffice)
- **Build**: ✅ 0 Errors
- **Documentation**: 28 فایل فعال در ساختار جدید
-
---
-
-## 💡 راهنما
-
- **مستندات فنی**: [03-BACKEND/](03-BACKEND/)
- **مستندات بیزینس**: [01-BUSINESS/](01-BUSINESS/)
- **گزارش تجمیع**: [CONSOLIDATION-FINAL-REPORT.md](CONSOLIDATION-FINAL-REPORT.md)
- **فایل‌های آرشیو**: [99-ARCHIVE/ARCHIVE-INDEX.md](99-ARCHIVE/ARCHIVE-INDEX.md)
-
---
-
-## 🤝 مشارکت
-
-قوانین به‌روزرسانی مستندات را در [00-INDEX.md](00-INDEX.md) مطالعه کنید.
-
---
-
-**🔗 لینک اصلی**: [00-INDEX.md](00-INDEX.md) - همه چیز از اینجا شروع می‌شود!
@@ -1,663 +0,0 @@
-# گزارش تغییرات - 2025-12-12
-
-## خلاصه اجرایی
-
-این سشن شامل دو بخش اصلی بود:
-1. **تبدیل نمایش تاریخ‌ها به شمسی** در فرانت‌اند BackOffice
-2. **بهبود سرویس اطلاعات شبکه کاربران** با اضافه کردن 28+ فیلد جدید
-
---
-
-## بخش 1: سیستم تبدیل تاریخ شمسی
-
-### 1.1. ایجاد PersianDateTimeService
-
-**فایل:** `/BackOffice/src/BackOffice/Services/PersianDateTimeService.cs`
-
-سرویسی برای تبدیل تاریخ‌های میلادی به شمسی در لایه نمایش:
-
-```csharp
-public interface IPersianDateTimeService
-{
-    string GetCurrentWeekNumber();                      // "1404-W23"
-    string ConvertWeekNumberToPersian(string);          // "2025-W48" → "1404-W23"
-    string ConvertToPersianDate(DateTime);              // DateTime → "1404/09/21"
-    string ConvertToPersianDateTime(DateTime);          // DateTime → "1404/09/21 - 14:30"
-    string GetWeekRangeDisplay(string);                 // "شنبه 1404/09/15 تا جمعه 1404/09/21"
-}
-```
-
-**قابلیت‌های کلیدی:**
- تبدیل شماره هفته میلادی به شمسی با حفظ هفته شنبه‌محور
- فرمت‌دهی تاریخ و تاریخ‌وزمان شمسی
- نمایش بازه هفتگی با نام روزهای فارسی
-
-### 1.2. ثبت سرویس در DI Container
-
-**فایل:** `/BackOffice/src/BackOffice/ConfigureService.cs`
-
-```csharp
-services.AddSingleton<BackOffice.Services.IPersianDateTimeService, 
-                      BackOffice.Services.PersianDateTimeService>();
-```
-
-### 1.3. آپدیت صفحات فرانت‌اند
-
-#### Dashboard.razor + Dashboard.razor.cs
-
-**تغییرات:**
- Inject کردن `IPersianDateTimeService`
- اضافه کردن فیلد `_currentWeekNumberPersian`
- تبدیل شماره هفته در `OnInitializedAsync` و `OnWeekChanged`
- نمایش تاریخ محاسبه Pool به شمسی
-
-**نمونه کد:**
-```csharp
-[Inject] public IPersianDateTimeService PersianDateTime { get; set; }
-private string _currentWeekNumberPersian = string.Empty;
-
-protected override async Task OnInitializedAsync()
-{
-    _currentWeekNumber = GetCurrentWeekNumber();  // "2025-W48"
-    _currentWeekNumberPersian = PersianDateTime.ConvertWeekNumberToPersian(_currentWeekNumber); // "1404-W23"
-}
-```
-
-```razor
-<MudText Typo="Typo.body2">هفته @(_currentWeekNumberPersian)</MudText>
-
-@if (_poolData?.CalculatedAt != null)
-{
-    var persianDate = PersianDateTime.ConvertToPersianDateTime(calculatedDate);
-    @($"در تاریخ {persianDate}")
-}
-```
-
-#### UserPayouts.razor + UserPayouts.razor.cs
-
-**تغییرات:**
- Inject کردن `IPersianDateTimeService`
- تبدیل شماره هفته در ستون جدول
- تبدیل تاریخ ایجاد Payout
-
-**نمونه کد:**
-```razor
-<PropertyColumn Property="x => x.WeekNumber" Title="هفته">
-    <CellTemplate>
-        @{
-            var persianWeek = PersianDateTime.ConvertWeekNumberToPersian(context.Item.WeekNumber);
-        }
-        <MudText Typo="Typo.body2">@persianWeek</MudText>
-    </CellTemplate>
-</PropertyColumn>
-```
-
-#### WorkerControl.razor
-
-**تغییرات:**
- Inject کردن `IPersianDateTimeService`
- تبدیل تاریخ آخرین اجرا و اجرای بعدی Worker
- تبدیل شماره هفته و تاریخ در لاگ اجرا
- نمایش پیام تایید با هفته شمسی
-
-**نمونه کد:**
-```razor
-<tr>
-    <td><strong>آخرین اجرا:</strong></td>
-    <td>@PersianDateTime.ConvertToPersianDateTime(_lastRunTime)</td>
-</tr>
-
-<MudTd DataLabel="هفته">@PersianDateTime.ConvertWeekNumberToPersian(context.WeekNumber)</MudTd>
-```
-
-### 1.4. استراتژی معماری
-
-**بک‌اند (CMS):**
- ✅ ذخیره و محاسبه با تاریخ میلادی
- ✅ شماره هفته فرمت میلادی: `"2025-W48"`
- ✅ هفته از شنبه شروع می‌شود
-
-**فرانت‌اند (BackOffice):**
- ✅ دریافت داده‌های میلادی از API
- ✅ تبدیل به شمسی فقط در لایه نمایش (Presentation Layer)
- ✅ هیچ تغییری در API Call ها یا Database
-
-**مزایا:**
- جداسازی کامل Business Logic از Presentation
- امکان تغییر نمایش بدون تأثیر بر دیتابیس
- سازگاری با APIهای خارجی که میلادی هستند
-
---
-
-## بخش 2: بهبود سرویس GetUserNetworkPosition
-
-### 2.1. آپدیت UserNetworkPositionDto (CMS)
-
-**فایل:** `/CMS/src/CMSMicroservice.Application/NetworkMembershipCQ/Queries/GetUserNetworkPosition/UserNetworkPositionDto.cs`
-
-**فیلدهای اضافه شده (28+ فیلد جدید):**
-
-#### اطلاعات شخصی کاربر
-```csharp
-public string? Email { get; set; }
-public string? NationalCode { get; set; }
-public string ReferralCode { get; set; }
-public bool IsMobileVerified { get; set; }
-public DateTime? BirthDate { get; set; }
-public DateTime JoinedAt { get; set; }
-```
-
-#### اطلاعات والد (تکمیل شده)
-```csharp
-public string? ParentFullName { get; set; }
-```
-
-#### اطلاعات فرزندان مستقیم (جزئیات کامل)
-```csharp
-// فرزند چپ
-public long? LeftChildId { get; set; }
-public string? LeftChildFullName { get; set; }
-public string? LeftChildMobile { get; set; }
-public DateTime? LeftChildJoinedAt { get; set; }
-
-// فرزند راست
-public long? RightChildId { get; set; }
-public string? RightChildFullName { get; set; }
-public string? RightChildMobile { get; set; }
-public DateTime? RightChildJoinedAt { get; set; }
-```
-
-#### آمار کامل شبکه
-```csharp
-public int TotalLeftLegMembers { get; set; }      // کل اعضای شاخه چپ (همه سطوح)
-public int TotalRightLegMembers { get; set; }     // کل اعضای شاخه راست (همه سطوح)
-public int TotalNetworkSize { get; set; }         // کل اعضای شبکه
-public int MaxNetworkDepth { get; set; }          // حداکثر عمق شبکه
-```
-
-#### اطلاعات پکیج و دایا
-```csharp
-public bool HasReceivedDayaCredit { get; set; }
-public DateTime? DayaCreditReceivedAt { get; set; }
-public PackagePurchaseMethod PackagePurchaseMethod { get; set; }
-public bool HasPurchasedGoldenPackage { get; set; }
-```
-
-#### آمار مالی (کمیسیون)
-```csharp
-public decimal TotalEarnedCommission { get; set; }  // کل کمیسیون کسب شده
-public decimal TotalPaidCommission { get; set; }    // کمیسیون پرداخت شده
-public decimal PendingCommission { get; set; }      // کمیسیون در انتظار
-public int TotalBalancesEarned { get; set; }        // تعداد بالانس‌های کسب شده
-```
-
-#### آمار فعالیت
-```csharp
-public int ActiveMembersInNetwork { get; set; }     // اعضای فعال (پکیج خریده)
-public int InactiveMembersInNetwork { get; set; }   // اعضای غیرفعال
-```
-
-### 2.2. آپدیت GetUserNetworkPositionQueryHandler
-
-**فایل:** `/CMS/src/CMSMicroservice.Application/NetworkMembershipCQ/Queries/GetUserNetworkPosition/GetUserNetworkPositionQueryHandler.cs`
-
-**متدهای کمکی جدید:**
-
-```csharp
-/// <summary>
-/// محاسبه تعداد اعضای یک شاخه (چپ یا راست) به صورت بازگشتی
-/// </summary>
-private async Task<int> GetLegMemberCountAsync(long userId, NetworkLeg leg, CancellationToken cancellationToken)
-
-/// <summary>
-/// محاسبه حداکثر عمق شبکه
-/// </summary>
-private async Task<int> GetMaxNetworkDepthAsync(long userId, CancellationToken cancellationToken)
-
-/// <summary>
-/// دریافت تمام ID های زیرمجموعه یک کاربر
-/// </summary>
-private async Task<List<long>> GetAllDescendantIdsAsync(long userId, CancellationToken cancellationToken)
-```
-
-**کوئری‌های جدید:**
- محاسبه آمار کمیسیون از جدول `UserCommissionPayouts`
- شمارش اعضای فعال/غیرفعال بر اساس `PackagePurchaseMethod`
- واکشی اطلاعات کامل فرزندان با موبایل و تاریخ عضویت
-
-### 2.3. آپدیت Protobuf Messages
-
-**فایل‌ها:**
- `/CMS/src/CMSMicroservice.Protobuf/Protos/networkmembership.proto`
- `/BackOffice.BFF/src/Protobufs/BackOffice.BFF.NetworkMembership.Protobuf/Protos/networkmembership.proto`
-
-**تغییرات:** افزایش فیلدها از 14 به 42 فیلد
-
-```protobuf
-message GetUserNetworkResponse
-{
-    // اطلاعات اصلی کاربر
-    int64 id = 1;
-    int64 user_id = 2;
-    string user_name = 3;
-    string mobile = 4;
-    string email = 5;
-    string national_code = 6;
-    string referral_code = 7;
-    bool is_mobile_verified = 8;
-    google.protobuf.Timestamp birth_date = 9;
-    google.protobuf.Timestamp joined_at = 10;
-    
-    // اطلاعات والد
-    google.protobuf.Int64Value parent_id = 11;
-    string parent_name = 12;
-    string parent_mobile = 13;
-    
-    // موقعیت در شبکه
-    int32 network_leg = 14;
-    int32 network_level = 15;
-    bool is_in_network = 16;
-    
-    // اطلاعات فرزند چپ
-    google.protobuf.Int64Value left_child_id = 17;
-    string left_child_name = 18;
-    string left_child_mobile = 19;
-    google.protobuf.Timestamp left_child_joined_at = 20;
-    
-    // اطلاعات فرزند راست
-    google.protobuf.Int64Value right_child_id = 21;
-    string right_child_name = 22;
-    string right_child_mobile = 23;
-    google.protobuf.Timestamp right_child_joined_at = 24;
-    
-    // آمار فرزندان مستقیم
-    int32 total_children = 25;
-    int32 left_child_count = 26;
-    int32 right_child_count = 27;
-    
-    // آمار کل شبکه
-    int32 total_left_leg_members = 28;
-    int32 total_right_leg_members = 29;
-    int32 total_network_size = 30;
-    int32 max_network_depth = 31;
-    
-    // اطلاعات پکیج و دایا
-    bool has_received_daya_credit = 32;
-    google.protobuf.Timestamp daya_credit_received_at = 33;
-    int32 package_purchase_method = 34;
-    bool has_purchased_golden_package = 35;
-    
-    // آمار مالی
-    double total_earned_commission = 36;
-    double total_paid_commission = 37;
-    double pending_commission = 38;
-    int32 total_balances_earned = 39;
-    
-    // آمار فعالیت
-    int32 active_members_in_network = 40;
-    int32 inactive_members_in_network = 41;
-    
-    google.protobuf.Timestamp created = 42;
-}
-```
-
-### 2.4. آپدیت CMS Mapping Profile
-
-**فایل:** `/CMS/src/CMSMicroservice.WebApi/Common/Mappings/NetworkMembershipProfile.cs`
-
-**تغییرات:** 40+ خط mapping برای تمام فیلدهای جدید
-
-```csharp
-config.NewConfig<UserNetworkPositionDto, GetUserNetworkResponse>()
-    .Map(dest => dest.Mobile, src => src.Mobile ?? "")
-    .Map(dest => dest.Email, src => src.Email ?? "")
-    .Map(dest => dest.NationalCode, src => src.NationalCode ?? "")
-    .Map(dest => dest.ReferralCode, src => src.ReferralCode)
-    .Map(dest => dest.IsMobileVerified, src => src.IsMobileVerified)
-    // ... 35+ mappings دیگر
-    .Map(dest => dest.TotalEarnedCommission, src => (double)src.TotalEarnedCommission)
-    .Map(dest => dest.ActiveMembersInNetwork, src => src.ActiveMembersInNetwork);
-```
-
-### 2.5. آپدیت BackOffice BFF
-
-#### GetUserNetworkInfoResponseDto
-
-**فایل:** `/BackOffice.BFF/src/BackOffice.BFF.Application/NetworkMembershipCQ/Queries/GetUserNetworkInfo/GetUserNetworkInfoResponseDto.cs`
-
-**تغییرات:** همان 42 فیلد CMS برای consistency
-
-#### NetworkMembershipProfile (BFF)
-
-**فایل:** `/BackOffice.BFF/src/BackOffice.BFF.WebApi/Common/Mappings/NetworkMembershipProfile.cs`
-
-**تغییرات:** Mapping کامل از DTO به Protobuf Response با تبدیل DateTime به Timestamp
-
-```csharp
-config.NewConfig<GetUserNetworkInfoResponseDto, GetUserNetworkResponse>()
-    .MapWith(src => new GetUserNetworkResponse
-    {
-        // ... 42 field mapping با تبدیل صحیح DateTime ها
-        BirthDate = src.BirthDate.HasValue 
-            ? Timestamp.FromDateTime(DateTime.SpecifyKind(src.BirthDate.Value, DateTimeKind.Utc)) 
-            : null,
-        // ...
-    });
-```
-
-### 2.6. آپدیت صفحه UserNetworkInfo.razor
-
-**فایل:** `/BackOffice/src/BackOffice/Pages/Network/UserNetworkInfo.razor`
-
-**بازنویسی کامل UI با 6 کارت اصلی:**
-
-#### 1. کارت اطلاعات کاربر
- شناسه، نام، موبایل (با badge تایید)
- ایمیل، کد ملی
- کد ارجاع
- موقعیت در شبکه
- تاریخ عضویت (شمسی)
-
-#### 2. کارت ساختار شبکه
- اطلاعات والد (نام، موبایل، لینک)
- فرزند چپ (نام، موبایل، تاریخ عضویت، لینک)
- فرزند راست (نام، موبایل، تاریخ عضویت، لینک)
-
-#### 3. کارت آمار کامل شبکه (6 آیتم با آیکون)
-```razor
-<MudGrid>
-    <MudItem xs="12" sm="6" md="3">
-        <!-- کل اعضای شبکه -->
-        <MudIcon Icon="@Icons.Material.Filled.AccountTree" />
-        <MudText Typo="Typo.h4">@_userInfo.TotalNetworkSize</MudText>
-    </MudItem>
-    <!-- اعضای شاخه چپ -->
-    <!-- اعضای شاخه راست -->
-    <!-- حداکثر عمق شبکه -->
-    <!-- اعضای فعال -->
-    <!-- اعضای غیرفعال -->
-</MudGrid>
-```
-
-#### 4. کارت آمار مالی و کمیسیون
- کل کمیسیون کسب شده (با فرمت هزارگان)
- کمیسیون پرداخت شده
- کمیسیون در انتظار
- تعداد بالانس کسب شده
-
-#### 5. کارت وضعیت پکیج و دایا
- وضعیت پکیج طلایی (با روش خرید)
- وضعیت اعتبار دایا (با تاریخ دریافت شمسی)
-
-#### 6. کارت عملیات
- دکمه نمایش درخت کامل
- دکمه Payout های کاربر (جدید)
- دکمه بروزرسانی
-
-**ویژگی‌های UI:**
- استفاده از MudBlazor Components
- آیکون‌های Material Design
- رنگ‌بندی semantic (Success, Warning, Info, Error)
- فرمت هزارگان برای مبالغ ریالی
- تاریخ‌های شمسی با `PersianDateTimeService`
-
---
-
-## بخش 3: اصلاح الگوریتم محاسبه شماره هفته
-
-### 3.1. مشکل اولیه
-
-**علت:** استفاده از `CalendarWeekRule.FirstDay` در C# که محاسبه اشتباه می‌کرد
-
-**نتیجه:**
- C# (GetAvailableWeeksQueryHandler): هفته 50 ❌
- SQL (populate-weekly-commission-pools.sql): هفته 49 ✅
-
-### 3.2. محاسبه صحیح (Saturday-based)
-
-**برای تاریخ 2025-12-12 (پنجشنبه):**
-1. اولین روز سال: 2025-01-01 = چهارشنبه
-2. اولین شنبه سال: 2025-01-04
-3. شنبه این هفته: 2025-12-07
-4. فاصله: 337 روز
-5. شماره هفته: 337 ÷ 7 = 48.14 → **هفته 49** ✅
-
-### 3.3. آپدیت GetAvailableWeeksQueryHandler
-
-**فایل:** `/CMS/src/CMSMicroservice.Application/CommissionCQ/Queries/GetAvailableWeeks/GetAvailableWeeksQueryHandler.cs`
-
-**قبل:**
-```csharp
-private static string GetWeekNumber(DateTime date)
-{
-    var calendar = CultureInfo.InvariantCulture.Calendar;
-    var weekOfYear = calendar.GetWeekOfYear(
-        date, 
-        CalendarWeekRule.FirstDay,  // ❌ اشتباه
-        DayOfWeek.Saturday);
-    
-    return $"{date.Year}-W{weekOfYear:D2}";
-}
-```
-
-**بعد:**
-```csharp
-private static string GetWeekNumber(DateTime date)
-{
-    var year = date.Year;
-    
-    // پیدا کردن اولین شنبه سال
-    var jan1 = new DateTime(year, 1, 1);
-    var jan1DayOfWeek = (int)jan1.DayOfWeek;
-    
-    // محاسبه offset تا اولین شنبه
-    var daysToFirstSaturday = jan1DayOfWeek == 6 ? 0 : (6 - jan1DayOfWeek + 7) % 7;
-    var firstSaturday = jan1.AddDays(daysToFirstSaturday);
-    
-    // پیدا کردن شنبه شروع هفته جاری
-    var currentDayOfWeek = (int)date.DayOfWeek;
-    var daysToCurrentSaturday = currentDayOfWeek == 6 ? 0 : (currentDayOfWeek + 1) % 7;
-    var weekStartSaturday = date.Date.AddDays(-daysToCurrentSaturday);
-    
-    // محاسبه شماره هفته
-    int weekNum;
-    if (weekStartSaturday < firstSaturday)
-    {
-        weekNum = 1;
-    }
-    else
-    {
-        var daysSinceFirstSaturday = (weekStartSaturday - firstSaturday).Days;
-        weekNum = (daysSinceFirstSaturday / 7) + 1;
-    }
-    
-    return $"{year}-W{weekNum:D2}";
-}
-```
-
-### 3.4. آپدیت SQL Script
-
-**فایل:** `/dbbkup/populate-weekly-commission-pools.sql`
-
-**تغییرات مشابه در تابع `GetWeekNumber`:**
-
-```sql
-CREATE FUNCTION dbo.GetWeekNumber (@Date DATETIME)
-RETURNS NVARCHAR(10)
-AS
-BEGIN
-    DECLARE @Year INT = YEAR(@Date);
-    
-    -- پیدا کردن اولین شنبه سال
-    DECLARE @Jan1 DATE = CAST(CAST(@Year AS VARCHAR(4)) + '-01-01' AS DATE);
-    DECLARE @Jan1DayOfWeek INT = DATEPART(WEEKDAY, @Jan1);
-    
-    -- محاسبه offset
-    DECLARE @DaysToFirstSaturday INT;
-    IF @Jan1DayOfWeek = 7
-        SET @DaysToFirstSaturday = 0;
-    ELSE
-        SET @DaysToFirstSaturday = 7 - @Jan1DayOfWeek;
-    
-    DECLARE @FirstSaturday DATE = DATEADD(DAY, @DaysToFirstSaturday, @Jan1);
-    
-    -- پیدا کردن شنبه شروع هفته جاری
-    DECLARE @CurrentDayOfWeek INT = DATEPART(WEEKDAY, @Date);
-    DECLARE @DaysToCurrentSaturday INT;
-    
-    IF @CurrentDayOfWeek = 7
-        SET @DaysToCurrentSaturday = 0;
-    ELSE
-        SET @DaysToCurrentSaturday = @CurrentDayOfWeek - 1;
-    
-    DECLARE @WeekStartSaturday DATE = DATEADD(DAY, -@DaysToCurrentSaturday, @Date);
-    
-    -- محاسبه شماره هفته
-    DECLARE @WeekNum INT;
-    IF @WeekStartSaturday < @FirstSaturday
-        SET @WeekNum = 1;
-    ELSE
-    BEGIN
-        DECLARE @DaysSinceFirstSaturday INT = DATEDIFF(DAY, @FirstSaturday, @WeekStartSaturday);
-        SET @WeekNum = (@DaysSinceFirstSaturday / 7) + 1;
-    END
-    
-    RETURN CAST(@Year AS NVARCHAR(4)) + '-W' + RIGHT('0' + CAST(@WeekNum AS NVARCHAR(2)), 2);
-END
-```
-
-### 3.5. سایر فایل‌های آپدیت شده
-
-**CalculateWeeklyBalancesCommandHandler.cs:**
- متد `GetWeekDateRange()` با الگوریتم دقیق‌تر
-
-**GetAvailableWeeksQueryHandler.cs:**
- متد `GetWeekRange()` برای محاسبه بازه شنبه تا جمعه
-
-**همه یکپارچه شدند:** C# ≡ SQL ≡ Frontend Display ✅
-
---
-
-## خلاصه فایل‌های تغییر یافته
-
-### فایل‌های جدید
-1. `/BackOffice/src/BackOffice/Services/PersianDateTimeService.cs` ⭐ جدید
-
-### فایل‌های CMS
-1. `/CMS/src/CMSMicroservice.Application/NetworkMembershipCQ/Queries/GetUserNetworkPosition/UserNetworkPositionDto.cs`
-2. `/CMS/src/CMSMicroservice.Application/NetworkMembershipCQ/Queries/GetUserNetworkPosition/GetUserNetworkPositionQueryHandler.cs`
-3. `/CMS/src/CMSMicroservice.Protobuf/Protos/networkmembership.proto`
-4. `/CMS/src/CMSMicroservice.WebApi/Common/Mappings/NetworkMembershipProfile.cs`
-5. `/CMS/src/CMSMicroservice.Application/CommissionCQ/Queries/GetAvailableWeeks/GetAvailableWeeksQueryHandler.cs`
-6. `/CMS/src/CMSMicroservice.Application/CommissionCQ/Commands/CalculateWeeklyBalances/CalculateWeeklyBalancesCommandHandler.cs`
-
-### فایل‌های BackOffice.BFF
-7. `/BackOffice.BFF/src/Protobufs/BackOffice.BFF.NetworkMembership.Protobuf/Protos/networkmembership.proto`
-8. `/BackOffice.BFF/src/BackOffice.BFF.Application/NetworkMembershipCQ/Queries/GetUserNetworkInfo/GetUserNetworkInfoResponseDto.cs`
-9. `/BackOffice.BFF/src/BackOffice.BFF.WebApi/Common/Mappings/NetworkMembershipProfile.cs`
-
-### فایل‌های BackOffice (Frontend)
-10. `/BackOffice/src/BackOffice/ConfigureService.cs`
-11. `/BackOffice/src/BackOffice/Pages/Commission/Dashboard.razor`
-12. `/BackOffice/src/BackOffice/Pages/Commission/Dashboard.razor.cs`
-13. `/BackOffice/src/BackOffice/Pages/Commission/UserPayouts.razor`
-14. `/BackOffice/src/BackOffice/Pages/Commission/UserPayouts.razor.cs`
-15. `/BackOffice/src/BackOffice/Pages/SystemManagement/WorkerControl.razor`
-16. `/BackOffice/src/BackOffice/Pages/Network/UserNetworkInfo.razor`
-
-### فایل‌های SQL
-17. `/dbbkup/populate-weekly-commission-pools.sql`
-
---
-
-## نتایج و دستاوردها
-
-### ✅ سیستم تاریخ شمسی
- **3 صفحه** اصلی به شمسی تبدیل شد
- **صفر تغییر** در Backend یا Database
- **معماری پاک** با جداسازی Presentation از Business Logic
- **Performance**: سرویس Singleton بدون overhead
-
-### ✅ بهبود سرویس شبکه
- **28+ فیلد جدید** اضافه شد
- **3 متد بازگشتی** برای محاسبه آمار شبکه
- **یکپارچگی کامل** از CMS تا UI
- **UI کاملا بازنویسی** شد با 6 کارت اطلاعاتی
-
-### ✅ اصلاح الگوریتم هفته
- **یکپارچگی کامل** بین C#, SQL, Frontend
- **محاسبه دقیق** Saturday-based
- **صفر اختلاف** بین سیستم‌ها
-
-### 📊 آمار کلی
- **17 فایل** ویرایش شد
- **1 فایل جدید** ایجاد شد
- **42 فیلد Protobuf** به جای 14 فیلد
- **3 صفحه Frontend** به شمسی تبدیل شد
- **2 الگوریتم** (C# + SQL) یکپارچه شد
-
---
-
-## تست و Validation
-
-### Build Status
- ✅ CMS: Build Successful (0 Errors, 465 Warnings - معمولی)
- ✅ BackOffice.BFF: Build Successful (0 Errors, 199 Warnings - معمولی)
- ✅ BackOffice: Build Successful (0 Errors, 239 Warnings - MudBlazor)
-
-### محاسبات تست شده
- ✅ تاریخ 2025-12-12 → هفته 49 (یکسان در همه سیستم‌ها)
- ✅ تبدیل شمسی "1404/09/21" ← 2025-12-12
- ✅ محاسبه بازه هفته: شنبه 2025-12-07 تا جمعه 2025-12-13
-
---
-
-## توصیه‌های آینده
-
-### کارهای تکمیلی پیشنهادی
-1. **Component Reusability**: ایجاد Blazor Components مشترک برای نمایش تاریخ شمسی
-   ```razor
-   <PersianDateDisplay DateTime="@dateTime" ShowTime="true" />
-   <PersianWeekDisplay WeekNumber="@weekNumber" ShowRange="true" />
-   ```
-
-2. **Caching**: اضافه کردن Cache برای محاسبات تبدیل هفته (اگر Performance مشکل شد)
-
-3. **Testing**: نوشتن Unit Test برای `GetWeekNumber` در C# و SQL
-
-4. **Documentation**: اضافه کردن XML Comments بیشتر برای API Documentation
-
-5. **صفحات باقیمانده**: اگر صفحات دیگری تاریخ نمایش می‌دهند، آن‌ها را هم تبدیل کنید
-
---
-
-## نکات فنی مهم
-
-### Saturday-based Week Calculation
-```
-هفته از شنبه شروع می‌شود:
- شنبه: روز اول هفته
- جمعه: روز آخر هفته
- Week 1: اولین شنبه سال
-```
-
-### DateTime to Timestamp Conversion
-```csharp
-// در Protobuf mapping همیشه UTC specify کنید
-Timestamp.FromDateTime(DateTime.SpecifyKind(dateTime, DateTimeKind.Utc))
-```
-
-### Persian Calendar in C#
-```csharp
-private readonly PersianCalendar _persianCalendar = new();
-var persianYear = _persianCalendar.GetYear(dateTime);
-var persianMonth = _persianCalendar.GetMonth(dateTime);
-var persianDay = _persianCalendar.GetDayOfMonth(dateTime);
-```
-
---
-
-**تاریخ:** 2025-12-12  
-**مدت زمان:** 1 Session  
-**وضعیت:** ✅ Completed & Tested  
-**تیم:** Masoud + GitHub Copilot
@@ -1,221 +0,0 @@
-# 🗂️ ساختار نهایی مستندات FourSat
-
-**تاریخ**: ۱۴ آذر ۱۴۰۴  
-**نسخه**: 2.0 Final
-
---
-
-## 📁 ساختار کامل
-
-```
-totalDoc/
-│
-├── 📄 00-INDEX.md                      (14 KB) ⭐ فهرست اصلی
-├── 📄 00-INDEX-NEW.md                  (15 KB) تحلیل اولیه
-├── 📄 README.md                        (3.6 KB) راهنمای سریع
-├── 📄 QUICK-REFERENCE.md               مرجع فوری
-├── 📄 CONSOLIDATION-FINAL-REPORT.md    (15 KB) گزارش تجمیع
-├── 📄 CLEANUP-NOTES.md                 یادداشت پاکسازی
-├── 📄 FINAL-STATUS.md                  (370 خط) وضعیت نهایی
-│
-├── 📊 01-BUSINESS/                     (7 فایل) منطق کسب‌وکار
-│   ├── network-commission-system.md
-│   ├── discount-shop-business.md
-│   ├── package-purchase-system.md
-│   ├── daya-loan-integration.md
-│   ├── balance-calculation-rules.md
-│   ├── binary-tree-guide.md
-│   └── manual-payment-system.md
-│
-├── 🏗️ 02-ARCHITECTURE/                 (1 فایل) معماری
-│   └── README.md                       (Roadmap)
-│
-├── ⚙️ 03-BACKEND/                       (3 زیرپوشه)
-│   │
-│   ├── CMS/                            (9 فایل .md + docs/)
-│   │   ├── README.md
-│   │   ├── implementation-status.md    (3,059 خط)
-│   │   ├── entity-guide.md
-│   │   ├── api-coverage.md
-│   │   ├── email-sms-configuration.md
-│   │   ├── payment-gateway.md
-│   │   ├── migration-network-parent-guide.md
-│   │   ├── payment-architecture-pyms.md
-│   │   └── docs/                       (7 فایل)
-│   │       ├── README.md
-│   │       ├── model.ndm2              (2.4 MB)
-│   │       ├── model1.ndm2             (2.2 MB)
-│   │       ├── network_crm_calculate.txt (28 KB)
-│   │       └── update-pool-percent.sql (2 KB)
-│   │
-│   ├── BackOffice.BFF/                 (4 فایل .md + docs/)
-│   │   ├── README.md
-│   │   ├── handlers-status.md
-│   │   ├── cms-integration.md
-│   │   ├── discount-shop-integration.md
-│   │   └── docs/                       (2 فایل)
-│   │       ├── README.md
-│   │       └── model.ndm2
-│   │
-│   └── FrontOffice.BFF/                (2 فایل .md + docs/)
-│       ├── README.md
-│       ├── protobuf-mismatch.md
-│       └── docs/                       (3 فایل)
-│           ├── README.md
-│           ├── model.ndm2
-│           └── CMS.sql
-│
-├── 🎨 04-FRONTEND/                      (2 زیرپوشه)
-│   │
-│   ├── BackOffice/                     (2 فایل)
-│   │   ├── README.md
-│   │   └── ui-status.md
-│   │
-│   └── FrontOffice/                    (5 فایل)
-│       ├── README.md
-│       ├── gap-analysis.md
-│       ├── todo-commented-code.md
-│       ├── progress-report.md
-│       └── mudblazor-reference.md      (6,270 خط!)
-│
-├── ✅ 05-TASKS/                         (3 فایل)
-│   ├── CURRENT-SPRINT.md               🔥 (21 task)
-│   ├── BACKLOG.md
-│   └── verification-template.md
-│
-├── 🚀 06-DEPLOYMENT/                    (2 فایل)
-│   ├── quick-start.md
-│   └── delivery-readiness.md
-│
-└── 📦 99-ARCHIVE/                       (15 فایل)
-    ├── ARCHIVE-INDEX.md
-    ├── REMAINING-TASKS-OLD-2024-12-02.md
-    ├── network-club-commission-system-OLD.md
-    ├── implementation-progress-fa-OLD.md
-    ├── monitoring-alerts-partial-OLD.md
-    ├── BACKOFFICE-UI-STATUS-OLD.md
-    ├── BUSINESS-VERIFICATION-TEMPLATE-OLD.md
-    ├── CMS-API-COVERAGE-OLD.md
-    ├── QUICK-START-DEVELOPMENT-OLD.md
-    ├── DELIVERY-READINESS-REPORT-OLD.md
-    ├── REMAINING-TASKS-CONSOLIDATED-OLD.md
-    ├── INDEX-OLD-v1.0.md
-    ├── ANALYSIS-CONTRADICTIONS-AND-ISSUES.md
-    ├── ENTITY-NAMING-REFACTORING-PLAN.md
-    └── monitoring-alerts-consolidated-report.md
-```
-
---
-
-## 📊 آمار
-
-### فایل‌ها:
-| نوع | تعداد |
-|-----|-------|
-| فایل‌های .md در Root | 7 |
-| فایل‌های .md فعال | 42 |
-| فایل‌های .md آرشیو | 15 |
-| فایل‌های docs (غیر md) | 7 |
-| **جمع کل** | **71 فایل** |
-
-### پوشه‌ها:
-| پوشه | زیرپوشه | فایل‌ها |
-|------|---------|---------|
-| 01-BUSINESS | - | 7 |
-| 02-ARCHITECTURE | - | 1 |
-| 03-BACKEND | 3 | 18 (.md) + 7 (docs) |
-| 04-FRONTEND | 2 | 7 |
-| 05-TASKS | - | 3 |
-| 06-DEPLOYMENT | - | 2 |
-| 99-ARCHIVE | - | 15 |
-
---
-
-## 🎯 فایل‌های کلیدی
-
-### برای شروع:
-1. **00-INDEX.md** ⭐ - نقطه شروع اصلی
-2. **README.md** - راهنمای سریع
-3. **QUICK-REFERENCE.md** - مرجع فوری
-
-### برای Development:
-4. **05-TASKS/CURRENT-SPRINT.md** 🔥 - کارهای جاری
-5. **04-FRONTEND/FrontOffice/todo-commented-code.md** - TODO ها
-6. **03-BACKEND/FrontOffice.BFF/protobuf-mismatch.md** - مشکلات
-
-### برای گزارش:
-7. **FINAL-STATUS.md** - وضعیت نهایی پروژه
-8. **CONSOLIDATION-FINAL-REPORT.md** - گزارش تجمیع
-9. **CLEANUP-NOTES.md** - یادداشت پاکسازی
-
---
-
-## 🗂️ راهنمای Navigation
-
-### بر اساس نقش:
-
-**Business Analyst:**
-```bash
-cd 01-BUSINESS/
-ls -l
-```
-
-**Backend Developer:**
-```bash
-cd 03-BACKEND/CMS/
-cat implementation-status.md
-```
-
-**Frontend Developer:**
-```bash
-cd 04-FRONTEND/FrontOffice/
-cat gap-analysis.md
-```
-
-**Project Manager:**
-```bash
-cat 05-TASKS/CURRENT-SPRINT.md
-cat 06-DEPLOYMENT/delivery-readiness.md
-```
-
-**DevOps:**
-```bash
-cat 06-DEPLOYMENT/quick-start.md
-ls 03-BACKEND/CMS/docs/  # Database models
-```
-
---
-
-## 📝 قوانین نگهداری
-
-### افزودن فایل جدید:
-1. تعیین دسته‌بندی (01-06)
-2. قرار دادن در پوشه مناسب
-3. بروزرسانی INDEX
-
-### آرشیو کردن:
-1. انتقال به 99-ARCHIVE/
-2. افزودن به ARCHIVE-INDEX.md
-3. ذکر دلیل و جایگزین
-
-### بروزرسانی:
-1. ویرایش فایل مربوطه
-2. بروزرسانی تاریخ
-3. Commit با پیام واضح
-
---
-
-## ✅ چک‌لیست کیفیت
-
- [x] **سازماندهی**: 7 پوشه منطقی ✅
- [x] **تمیزی**: هیچ فایل اضافی در Root ✅
- [x] **مستندسازی**: README برای هر بخش ✅
- [x] **لینک‌ها**: INDEX کامل با لینک‌ها ✅
- [x] **آرشیو**: 15 فایل با توضیحات ✅
- [x] **docs**: فایل‌های طراحی سازماندهی شده ✅
-
---
-
-**تاریخ ایجاد**: ۱۴ آذر ۱۴۰۴  
-**کیفیت**: ⭐⭐⭐⭐⭐ (5/5)  
-**وضعیت**: Production Ready ✅
@@ -0,0 +1,554 @@
+# 📦 سیستم مبتنی بر پکیج (Package-Based System)
+
+> **وضعیت:** تحلیل و بررسی — منتظر تایید  
+> **تاریخ:** اسفند ۱۴۰۴  
+> **تاثیرگذاری:** زیاد — بخش‌های متعدد سیستم تحت تاثیر قرار می‌گیرد
+
+---
+
+## ۱. خلاصه فیچر
+
+**وضعیت فعلی:** سیستم فقط یک پکیج پایه (۵۶ میلیون تومان) دارد و همه چیز حول آن می‌چرخد.
+
+**وضعیت هدف:** سیستم چندین پکیج با قیمت‌ها و ویژگی‌های متفاوت پشتیبانی می‌کند. هر پکیج روش‌های پرداخت، محاسبه پورسانت، شارژ کیف پول و فیچرهای مختص خود را دارد.
+
+```
+مثال پکیج‌ها:
+┌──────────────┬──────────────┬──────────────┬──────────────┐
+│  🥈 نقره‌ای   │  🥇 طلایی     │  💎 الماسی    │   ⭐ ویژه     │
+│  ۵.۶M تومان  │  ۵۶M تومان   │   ؟؟ تومان   │   ؟؟ تومان   │
+│              │  (پکیج پایه) │              │              │
+│ فقط مستقیم   │ دایا+مستقیم  │ فقط مستقیم   │ فقط مستقیم   │
+│ فیچر محدود   │ همه فیچرها   │ همه فیچرها   │ همه+اختصاصی  │
+└──────────────┴──────────────┴──────────────┴──────────────┘
+```
+
+---
+
+## ۲. وضعیت فعلی سیستم (AS-IS)
+
+### ۲.۱ فلوی فعلی فعالسازی
+
+```mermaid
+flowchart TD
+    A["کاربر وارد سیستم می‌شود"] --> B{"روش پرداخت"}
+    B -->|"خرید الماس دایا"| C["DayaLoan — ۵۶M"]
+    B -->|"پرداخت مستقیم"| D["درگاه بانکی — ۵۶M"]
+    C --> E["بررسی موفقیت پرداخت"]
+    D --> E
+    E --> F["شارژ کیف پول"]
+    F --> G["مدال قرارداد باشگاه مشتریان"]
+    G --> H["تایید OTP + امضا"]
+    H --> I["فعال‌سازی عضویت باشگاه"]
+    I --> J["اختصاص فیچرها"]
+    I --> K["ایجاد Cycle"]
+    I --> L["اضافه به Commission Pool"]
+    J --> M["✅ کاربر فعال — لینک معرف"]
+```
+
+### ۲.۲ جریان پول فعلی
+
+```
+کاربر ۵۶M پرداخت می‌کند
+    │
+    ├── Balance (کیف پول عادی)     += ۵۶,۰۰۰,۰۰۰ ریال
+    ├── DiscountBalance (اعتباری)  += ۱۱۲,۰۰۰,۰۰۰ ریال (×۲)
+    │
+    └── Club Activation:
+        ├── CommissionPool          += ۲۵,۲۰۰,۰۰۰ ریال (ClubActivationFee)
+        └── GiftValue               = ۲۵,۲۰۰,۰۰۰ ریال (اطلاع‌رسانی)
+```
+
+### ۲.۳ مقادیر Hardcoded فعلی (`SystemConstants.cs`)
+
+| ثابت | مقدار | کاربرد |
+|------|-------|--------|
+| `BasePackageAmount` | ۵۶,۰۰۰,۰۰۰ | قیمت پکیج |
+| `DayaLoanAmount` | ۵۶,۰۰۰,۰۰۰ | مبلغ وام دایا |
+| `ClubActivationFee` | ۲۵,۲۰۰,۰۰۰ | سهم هفتگی Commission Pool |
+| `ClubMembershipGiftValue` | ۲۵,۲۰۰,۰۰۰ | ارزش هدیه حق عضویت |
+| `MagicWalletMultiplier` | ×۲.۵ | ضریب کیف پول جادویی |
+
+### ۲.۴ مشکلات فعلی
+
+| # | مشکل | فایل |
+|---|------|------|
+| ۱ | پکیج ID=4 **hardcoded** در `InitiateBasePackagePaymentCommandHandler` | Application/Commands |
+| ۲ | مبلغ ۵۶M **hardcoded** در `SystemConstants` و چندین handler | Domain/Common |
+| ۳ | فیچرها **همه یکجا** assign می‌شن (۴ فیچر ثابت: چتیکا، بیمه، تریپ، لرن) | ActivateClubMembershipHandler |
+| ۴ | Commission Pool فقط با `ClubActivationFee` ثابت پر می‌شه | ActivateClubMembershipHandler |
+| ۵ | `DiscountBalance = Amount × 2` — ضریب hardcoded | VerifyPayment handlers |
+| ۶ | فرانت‌اند فقط یک مسیر خرید نشون میده | FrontOffice pages |
+
+---
+
+## ۳. طراحی پیشنهادی (TO-BE)
+
+### ۳.۱ فلوی جدید فعالسازی
+
+```mermaid
+flowchart TD
+    A["کاربر وارد سیستم"] --> B["صفحه پکیج‌ها<br/>(کاشی‌های نقره‌ای/طلایی/الماسی/...)"]
+    
+    B -->|"کلیک روی پکیج"| C{"نوع پکیج"}
+    
+    C -->|"پکیج پایه (طلایی)"| D["مدال با دو گزینه:<br/>۱. خرید الماس دایا<br/>۲. پرداخت مستقیم"]
+    C -->|"پکیج‌های دیگر"| E["مدال با یک گزینه:<br/>فقط پرداخت مستقیم<br/>+ توضیحات + قیمت"]
+    
+    D -->|"دایا"| F["فلوی دایا"]
+    D -->|"مستقیم"| G["درگاه پرداخت"]
+    E --> G
+    
+    F --> H["پرداخت موفق"]
+    G --> H
+    
+    H --> I["شارژ کیف پول<br/>(متناسب با قیمت پکیج)"]
+    I --> J["مدال قرارداد باشگاه"]
+    J --> K["OTP + امضا"]
+    K --> L["فعال‌سازی<br/>+ اختصاص فیچرهای پکیج"]
+    L --> M["✅ کاربر فعال"]
+```
+
+### ۳.۲ تغییرات Entity — Package
+
+**فعلی:**
+```csharp
+public class Package : BaseAuditableEntity
+{
+    public string Title { get; set; }
+    public string Description { get; set; }
+    public string ImagePath { get; set; }
+    public long Price { get; set; }
+}
+```
+
+**پیشنهادی:**
+```csharp
+public class Package : BaseAuditableEntity
+{
+    public string Title { get; set; }
+    public string Description { get; set; }
+    public string ImagePath { get; set; }
+    public long Price { get; set; }                          // قیمت پکیج (ریال)
+    
+    // === فیلدهای جدید ===
+    public int SortOrder { get; set; }                       // ترتیب نمایش
+    public bool IsActive { get; set; } = true;               // فعال/غیرفعال
+    public bool IsBasePackage { get; set; }                   // آیا پکیج پایه است؟
+    public bool SupportsDayaPurchase { get; set; }            // پشتیبانی از خرید دایا
+    public bool SupportsDirectPurchase { get; set; } = true;  // پشتیبانی از پرداخت مستقیم
+    
+    // === محاسبات مالی ===
+    public long ActivationFee { get; set; }                  // سهم Commission Pool
+    public long GiftValue { get; set; }                      // ارزش هدیه
+    public decimal DiscountMultiplier { get; set; } = 2.0m;  // ضریب شارژ DiscountBalance
+    
+    // === Navigation ===
+    public virtual ICollection<PackageFeature> PackageFeatures { get; set; }
+    public virtual ICollection<UserPackagePurchase> Purchases { get; set; }
+}
+```
+
+### ۳.۳ Entity جدید — PackageFeature (پل بین پکیج و فیچر)
+
+```csharp
+/// <summary>
+/// مشخص می‌کند هر پکیج چه فیچرهایی را فعال می‌کند
+/// </summary>
+public class PackageFeature : BaseAuditableEntity
+{
+    public long PackageId { get; set; }
+    public virtual Package Package { get; set; }
+    
+    public long ClubFeatureId { get; set; }
+    public virtual ClubFeature ClubFeature { get; set; }
+    
+    public bool IsIncluded { get; set; } = true;  // آیا این فیچر در پکیج هست؟
+}
+```
+
+### ۳.۴ تغییرات Entity — ClubMembership
+
+```csharp
+public class ClubMembership : BaseAuditableEntity
+{
+    // ... فیلدهای فعلی حفظ می‌شوند ...
+    
+    // === فیلد جدید ===
+    public long PackageId { get; set; }              // کدام پکیج خریداری شده
+    public virtual Package Package { get; set; }
+}
+```
+
+### ۳.۵ تغییرات Entity — ClubMembershipCycle
+
+```csharp
+public class ClubMembershipCycle : BaseAuditableEntity
+{
+    // ... فیلدهای فعلی حفظ می‌شوند ...
+    
+    // === فیلد جدید ===
+    public long PackageId { get; set; }              // پکیج این سایکل
+    public virtual Package Package { get; set; }
+    // PackageAmount قبلاً وجود دارد — از Package.Price پر می‌شود
+}
+```
+
+### ۳.۶ تغییرات Entity — WeeklyCommissionPool
+
+```csharp
+public class WeeklyCommissionPool : BaseAuditableEntity
+{
+    // ... فیلدهای فعلی حفظ می‌شوند ...
+    
+    // === فیلد جدید ===
+    public long PackageId { get; set; }              // Pool جداگانه برای هر پکیج
+    public virtual Package Package { get; set; }
+}
+```
+
+### ۳.۷ جریان پول جدید
+
+```
+پکیج نقره‌ای (۵.۶M):
+    ├── Balance        += ۵,۶۰۰,۰۰۰
+    ├── DiscountBalance += ۱۱,۲۰۰,۰۰۰ (×۲)
+    └── CommissionPool += ActivationFee مخصوص نقره‌ای
+
+پکیج طلایی/پایه (۵۶M):
+    ├── Balance        += ۵۶,۰۰۰,۰۰۰
+    ├── DiscountBalance += ۱۱۲,۰۰۰,۰۰۰ (×۲)
+    └── CommissionPool += ۲۵,۲۰۰,۰۰۰
+
+پکیج الماسی (??M):
+    ├── Balance        += ??
+    ├── DiscountBalance += ?? (×۲)
+    └── CommissionPool += ActivationFee مخصوص الماسی
+```
+
+---
+
+## ۴. محاسبه پورسانت — تغییرات
+
+### ۴.۱ وضعیت فعلی
+
+```
+یک WeeklyCommissionPool برای کل هفته
+    ↓
+TotalAmount = مجموع ActivationFee همه فعالسازی‌ها
+    ↓
+ValuePerBalance = TotalAmount ÷ مجموع Balance‌ها
+    ↓
+همه یکسان محاسبه می‌شوند
+```
+
+### ۴.۲ وضعیت هدف
+
+```
+برای هر پکیج، یک WeeklyCommissionPool جداگانه:
+
+Pool_نقره‌ای:
+    TotalAmount = مجموع ActivationFee خریداران نقره‌ای این هفته
+    Balance‌ها = فقط از شبکه خریداران نقره‌ای
+    ValuePerBalance = Pool_نقره‌ای ÷ Balance_نقره‌ای
+
+Pool_طلایی:
+    TotalAmount = مجموع ActivationFee خریداران طلایی این هفته
+    Balance‌ها = فقط از شبکه خریداران طلایی
+    ValuePerBalance = Pool_طلایی ÷ Balance_طلایی
+```
+
+### ۴.۳ نکته مهم: ساختار شبکه یکی است
+
+```
+                    [Ali]
+                   /     \
+              [Sara]     [Reza]        ← شبکه باینری یکی‌ست
+             /    \      /    \
+          [M1]  [M2]  [M3]  [M4]
+
+ولی محاسبات جدا:
+  - Ali با پکیج طلایی → پورسانت از Pool طلایی
+  - Sara با پکیج نقره‌ای → پورسانت از Pool نقره‌ای
+  - Reza با پکیج طلایی → پورسانت از Pool طلایی
+```
+
+### ۴.۴ تغییرات Stored Procedure
+
+**`sp_CalculateWeeklyBalances`** باید:
+- پارامتر `@PackageId` بگیرد
+- فقط کاربرانی که این پکیج را خریده‌اند فیلتر کند
+- برای هر پکیج جداگانه اجرا شود
+
+**`sp_CalculateWeeklyCommissionPool`** باید:
+- پارامتر `@PackageId` بگیرد
+- Pool مخصوص آن پکیج را بخواند
+- پرداخت‌ها فقط به خریداران آن پکیج اختصاص یابد
+
+---
+
+## ۵. فیچرهای باشگاه مشتریان بر اساس پکیج
+
+### ۵.۱ وضعیت فعلی
+
+وقتی کاربر فعال می‌شود، **همه ۴ فیچر** یکجا assign می‌شوند:
+```csharp
+// ActivateClubMembershipCommandHandler — خط ~350
+var allFeatureIds = ClubFeatureTypeExtensions.GetAllFeatureIds();
+foreach (var featureId in allFeatureIds)
+{
+    userClubFeatures.Add(new UserClubFeature { ... });
+}
+```
+
+### ۵.۲ وضعیت هدف
+
+فیچرها بر اساس جدول `PackageFeature` تعیین می‌شوند:
+
+| فیچر | نقره‌ای | طلایی (پایه) | الماسی |
+|------|---------|-------------|--------|
+| چتیکا | ❌ | ✅ | ✅ |
+| بیمه | ❌ | ✅ | ✅ |
+| تریپ | ✅ | ✅ | ✅ |
+| لرن | ✅ | ✅ | ✅ |
+| فیچر VIP | ❌ | ❌ | ✅ |
+
+*مقادیر بالا نمونه‌ای هستند — قابل تنظیم از BackOffice*
+
+### ۵.۳ تغییر در ActivateClubMembershipHandler
+
+```
+قبلی:
+  GetAllFeatureIds() → assign all
+
+جدید:
+  Package.PackageFeatures
+    .Where(pf => pf.IsIncluded)
+    .Select(pf => pf.ClubFeatureId)
+    → assign only included features
+```
+
+---
+
+## ۶. تغییرات UI — FrontOffice
+
+### ۶.۱ صفحه پکیج‌ها (کاشی‌ها)
+
+```
+┌─────────────────────────────────────────────────────┐
+│              انتخاب پکیج باشگاه مشتریان              │
+├─────────────┬──────────────┬──────────────┬─────────┤
+│             │              │              │         │
+│  🥈 نقره‌ای  │  🥇 طلایی     │  💎 الماسی    │  ⭐ ویژه │
+│  ۵.۶M       │  ۵۶M         │  ؟؟M         │  ؟؟M   │
+│             │              │              │         │
+│ ● لرن       │ ● چتیکا      │ ● همه        │ ● همه  │
+│ ● تریپ      │ ● بیمه       │ ● + VIP      │ ● +... │
+│             │ ● تریپ       │              │         │
+│             │ ● لرن        │              │         │
+│             │              │              │         │
+│ [انتخاب]    │ [انتخاب]     │ [انتخاب]     │[انتخاب]│
+└─────────────┴──────────────┴──────────────┴─────────┘
+```
+
+### ۶.۲ مدال پرداخت — پکیج پایه (طلایی)
+
+```
+┌─────────────────────────────────────────┐
+│        خرید پکیج طلایی — ۵۶M تومان       │
+│                                         │
+│  توضیحات: ...                            │
+│                                         │
+│  روش‌های پرداخت:                         │
+│  ┌─────────────────────────────────┐    │
+│  │  💎 خرید از طریق الماس دایا      │    │
+│  └─────────────────────────────────┘    │
+│  ┌─────────────────────────────────┐    │
+│  │  💳 پرداخت مستقیم (درگاه بانکی) │    │
+│  └─────────────────────────────────┘    │
+└─────────────────────────────────────────┘
+```
+
+### ۶.۳ مدال پرداخت — پکیج‌های دیگر (نقره‌ای و بالاتر)
+
+```
+┌─────────────────────────────────────────┐
+│      خرید پکیج نقره‌ای — ۵.۶M تومان      │
+│                                         │
+│  توضیحات: ...                            │
+│  ویژگی‌ها: لرن، تریپ                     │
+│                                         │
+│  ┌─────────────────────────────────┐    │
+│  │  💳 پرداخت و فعال‌سازی           │    │
+│  └─────────────────────────────────┘    │
+└─────────────────────────────────────────┘
+```
+
+---
+
+## ۷. بخش‌های تحت تاثیر (Impact Analysis)
+
+### ۷.۱ جدول تاثیرپذیری
+
+| # | لایه | فایل/بخش | نوع تغییر | شدت |
+|---|------|----------|-----------|-----|
+| ۱ | **Domain** | `Package.cs` | اضافه فیلد | 🟡 متوسط |
+| ۲ | **Domain** | `PackageFeature.cs` — **جدید** | Entity جدید | 🔴 زیاد |
+| ۳ | **Domain** | `ClubMembership.cs` | اضافه `PackageId` | 🟡 متوسط |
+| ۴ | **Domain** | `ClubMembershipCycle.cs` | اضافه `PackageId` | 🟡 متوسط |
+| ۵ | **Domain** | `WeeklyCommissionPool.cs` | اضافه `PackageId` | 🔴 زیاد |
+| ۶ | **Domain** | `SystemConstants.cs` | حذف hardcode‌ها → خوانش از Package | 🟡 متوسط |
+| ۷ | **Application** | `ActivateClubMembershipCommandHandler` | فیچر بر اساس پکیج | 🔴 زیاد |
+| ۸ | **Application** | `InitiateBasePackagePaymentCommandHandler` | حذف ID=4 hardcoded | 🟡 متوسط |
+| ۹ | **Application** | `VerifyBasePackagePaymentCommandHandler` | شارژ متناسب با پکیج | 🔴 زیاد |
+| ۱۰ | **Application** | `VerifyPackagePurchasePaymentCommandHandler` | شارژ متناسب با پکیج | 🔴 زیاد |
+| ۱۱ | **Application** | `ManualPaymentCommandHandler` | شارژ متناسب با پکیج | 🟡 متوسط |
+| ۱۲ | **Application** | `CustomerPurchasePackageCommandHandler` | پشتیبانی روش‌های پرداخت پکیج | 🟡 متوسط |
+| ۱۳ | **Infra** | `sp_CalculateWeeklyBalances` | پارامتر PackageId | 🔴 زیاد |
+| ۱۴ | **Infra** | `sp_CalculateWeeklyCommissionPool` | Pool جداگانه هر پکیج | 🔴 زیاد |
+| ۱۵ | **Infra** | `WeeklyCommissionCalculationService` | Loop روی پکیج‌ها | 🟡 متوسط |
+| ۱۶ | **Infra** | EF Configurations | جدول جدید + FK‌ها | 🟡 متوسط |
+| ۱۷ | **Infra** | Database Migration | schema changes | 🟡 متوسط |
+| ۱۸ | **Proto** | `package.proto` | فیلدهای جدید پکیج | 🟢 کم |
+| ۱۹ | **Proto** | `clubmembership.proto` | PackageId در response | 🟢 کم |
+| ۲۰ | **Proto** | `commission.proto` | PackageId در pool/payout | 🟢 کم |
+| ۲۱ | **FrontOffice** | صفحه انتخاب پکیج | UI جدید (کاشی‌ها) | 🔴 زیاد |
+| ۲۲ | **FrontOffice** | مدال پرداخت | دو مدال متفاوت | 🔴 زیاد |
+| ۲۳ | **FrontOffice** | `MyPackages.razor` | نمایش نوع پکیج | 🟡 متوسط |
+| ۲۴ | **FrontOffice** | `ActivateClubDialog.razor` | ارتباط با پکیج | 🟡 متوسط |
+| ۲۵ | **BackOffice** | صفحه مدیریت پکیج‌ها | CRUD فیلدهای جدید | 🟡 متوسط |
+| ۲۶ | **BackOffice** | صفحه فیچر پکیج‌ها — **جدید** | ماتریس پکیج×فیچر | 🔴 زیاد |
+| ۲۷ | **BackOffice** | `ActivateClubDialog.razor` | انتخاب پکیج | 🟡 متوسط |
+
+### ۷.۲ ریسک‌ها
+
+| ریسک | احتمال | شدت | راه‌حل |
+|------|--------|-----|--------|
+| داده‌های فعلی — کاربران بدون PackageId | قطعی | زیاد | Migration: کاربران فعلی → PackageId = پکیج پایه |
+| Commission Pool فعلی بدون PackageId | قطعی | زیاد | Migration: Pool‌های موجود → PackageId = پکیج پایه |
+| SP تغییر → محاسبات اشتباه | متوسط | بحرانی | تست جامع + محیط staging |
+| مبالغ hardcoded در جاهای پراکنده | زیاد | متوسط | Audit کامل کدبیس |
+| عدم سازگاری FrontOffice/BackOffice | متوسط | متوسط | تست end-to-end |
+
+---
+
+## ۸. فازبندی پیاده‌سازی
+
+### فاز ۱ — زیرساخت (Domain + DB) ≈ ۳-۴ روز
+
+| تسک | شرح |
+|-----|------|
+| T1.1 | بروزرسانی `Package` entity (فیلدهای جدید) |
+| T1.2 | ایجاد `PackageFeature` entity + EF Configuration |
+| T1.3 | اضافه کردن `PackageId` به `ClubMembership` |
+| T1.4 | اضافه کردن `PackageId` به `ClubMembershipCycle` |
+| T1.5 | اضافه کردن `PackageId` به `WeeklyCommissionPool` |
+| T1.6 | Database Migration + Seed data (پکیج پایه + فیچرها) |
+| T1.7 | Migration: کاربران/Pool‌های فعلی → PackageId = پکیج پایه |
+| T1.8 | بروزرسانی Proto‌ها |
+
+### فاز ۲ — منطق کسب‌وکار (Application) ≈ ۴-۵ روز
+
+| تسک | شرح |
+|-----|------|
+| T2.1 | بروزرسانی `ActivateClubMembershipCommandHandler` — فیچر بر اساس پکیج |
+| T2.2 | بروزرسانی Verify handlers — شارژ کیف پول متناسب با پکیج |
+| T2.3 | حذف مقادیر hardcoded از `SystemConstants` → خوانش از Package |
+| T2.4 | بروزرسانی `InitiateBasePackagePayment` → Generic `InitiatePackagePayment` |
+| T2.5 | بروزرسانی `ManualPaymentCommandHandler` — پشتیبانی پکیج متغیر |
+| T2.6 | CRUD پکیج با فیلدهای جدید (gRPC handlers) |
+| T2.7 | CRUD `PackageFeature` (ماتریس پکیج×فیچر) |
+
+### فاز ۳ — محاسبه پورسانت ≈ ۳-۴ روز
+
+| تسک | شرح |
+|-----|------|
+| T3.1 | بروزرسانی `sp_CalculateWeeklyBalances` — فیلتر بر اساس PackageId |
+| T3.2 | بروزرسانی `sp_CalculateWeeklyCommissionPool` — Pool جداگانه |
+| T3.3 | بروزرسانی `WeeklyCommissionCalculationService` — Loop روی پکیج‌ها |
+| T3.4 | تست محاسبات با داده واقعی |
+
+### فاز ۴ — UI (FrontOffice + BackOffice) ≈ ۴-۵ روز
+
+| تسک | شرح |
+|-----|------|
+| T4.1 | صفحه کاشی‌های پکیج (FrontOffice) |
+| T4.2 | مدال پرداخت پکیج پایه (دایا + مستقیم) |
+| T4.3 | مدال پرداخت پکیج‌های دیگر (فقط مستقیم) |
+| T4.4 | بروزرسانی `MyPackages.razor` — نمایش نوع پکیج |
+| T4.5 | بروزرسانی `ActivateClubDialog.razor` — ارتباط با پکیج |
+| T4.6 | BackOffice: CRUD پکیج با فیلدهای جدید |
+| T4.7 | BackOffice: صفحه ماتریس فیچرهای پکیج |
+| T4.8 | BackOffice: `ActivateClubDialog` — انتخاب پکیج |
+
+### فاز ۵ — تست و استقرار ≈ ۲-۳ روز
+
+| تسک | شرح |
+|-----|------|
+| T5.1 | تست end-to-end فلوی خرید هر پکیج |
+| T5.2 | تست محاسبه پورسانت جداگانه |
+| T5.3 | تست migration داده‌های فعلی |
+| T5.4 | Deploy به staging + تست |
+| T5.5 | Deploy به production |
+
+---
+
+## ۹. Seed Data — پکیج‌های اولیه
+
+```sql
+-- Migration: Seed packages
+INSERT INTO Packages (Title, Description, Price, IsActive, IsBasePackage, 
+    SupportsDayaPurchase, SupportsDirectPurchase, ActivationFee, GiftValue, 
+    DiscountMultiplier, SortOrder)
+VALUES
+    ('نقره‌ای', 'پکیج نقره‌ای باشگاه مشتریان', 5600000, 1, 0, 
+     0, 1, ???, ???, 2.0, 1),
+    ('طلایی', 'پکیج طلایی باشگاه مشتریان (پایه)', 56000000, 1, 1, 
+     1, 1, 25200000, 25200000, 2.0, 2);
+
+-- Migration: ربط فیچرها به پکیج‌ها
+INSERT INTO PackageFeatures (PackageId, ClubFeatureId, IsIncluded) VALUES
+    -- نقره‌ای: فقط تریپ و لرن
+    (@silverId, @tripId, 1),
+    (@silverId, @learnId, 1),
+    -- طلایی: همه فیچرها
+    (@goldId, @chatikaId, 1),
+    (@goldId, @bimeId, 1),
+    (@goldId, @tripId, 1),
+    (@goldId, @learnId, 1);
+
+-- Migration: کاربران فعلی → پکیج پایه
+UPDATE ClubMemberships SET PackageId = @goldId WHERE PackageId IS NULL;
+UPDATE ClubMembershipCycles SET PackageId = @goldId WHERE PackageId IS NULL;
+UPDATE WeeklyCommissionPools SET PackageId = @goldId WHERE PackageId IS NULL;
+```
+
+---
+
+## ۱۰. سوالات باز (نیاز به تصمیم‌گیری)
+
+| # | سوال | گزینه‌ها |
+|---|------|---------|
+| ۱ | `ActivationFee` و `GiftValue` پکیج نقره‌ای چقدر باشد؟ | نسبت به قیمت؟ مقدار ثابت؟ |
+| ۲ | آیا کاربر می‌تواند بعداً پکیج خود را ارتقا دهد (upgrade)؟ | بله → فقط مابه‌التفاوت / خیر |
+| ۳ | `DiscountMultiplier` برای همه پکیج‌ها ×۲ باشد؟ | یکسان / متفاوت به ازای هر پکیج |
+| ۴ | ضریب `MagicWallet` (×۲.۵) برای پکیج‌های کوچکتر هم همان باشد؟ | بله / خیر |
+| ۵ | فیچرهای پکیج نقره‌ای دقیقاً کدام‌ها هستند؟ | لرن+تریپ؟ فقط لرن؟ |
+| ۶ | آیا یک کاربر می‌تواند چند پکیج همزمان داشته باشد؟ | فقط یکی / امکان خرید چندتا |
+| ۷ | نام و تعداد دقیق پکیج‌ها چیست؟ | نقره‌ای+طلایی؟ بیشتر؟ |
+| ۸ | کاربرانی که با دایا فعال شدن، چه پکیجی دارند؟ | طلایی (پایه) |
+
+---
+
+## ۱۱. تخمین زمانی
+
+| فاز | مدت | وابستگی |
+|-----|------|---------|
+| فاز ۱ — زیرساخت | ۳-۴ روز | — |
+| فاز ۲ — منطق | ۴-۵ روز | فاز ۱ |
+| فاز ۳ — پورسانت | ۳-۴ روز | فاز ۱ |
+| فاز ۴ — UI | ۴-۵ روز | فاز ۲ |
+| فاز ۵ — تست | ۲-۳ روز | فاز ۳, ۴ |
+| **مجموع** | **~۱۶-۲۱ روز کاری** | |
+
+> فازهای ۲ و ۳ قابل موازی‌سازی هستند.
@@ -0,0 +1,236 @@
+# 🏆 سیستم باشگاه، کمیسیون و درخت شبکه‌ای
+
+> **منابع ادغام‌شده:** `club-commission-system-complete.md`, `balance-calculation-rules.md`, `club-membership-contract-system.md`  
+> **آخرین بروزرسانی:** اسفند ۱۴۰۴ (بروزرسانی: Magic Wallet کامل + بهبود مدیریت اعضا)
+
+---
+
+## ۱. مفاهیم کلیدی
+
+| مفهوم | توضیح |
+|-------|--------|
+| **عضویت باشگاه** | خرید پکیج طلایی (۵۶M) → فعالسازی (۲۵.۲M) → عضو فعال باشگاه |
+| **درخت باینری** | هر کاربر حداکثر ۲ فرزند مستقیم (چپ/راست) — بدون محدودیت عمق |
+| **کمیسیون هفتگی** | محاسبه بر اساس تعادل چپ/راست — یکشنبه ۰۰:۰۵ (Hangfire cron) |
+| **۳ کیف پول** | `Balance` (نقدی) + `NetworkBalance` (طلایی/کمیسیون) + `DiscountBalance` (اعتباری) |
+| **کیف‌پول جادویی** | وقتی Balance=0 → حالت Magic فعال → شارژ ×2.5 → سقف 100M/دور |
+| **چرخه عضویت** | `ClubMembershipCycle` — هر خرید پکیج = یک دور جدید (برای تاریخ کمیسیون) |
+
+---
+
+## ۲. ساختار درخت باینری
+
+```mermaid
+graph TD
+    ROOT["Root"] --- L["Left"]
+    ROOT --- R["Right"]
+    L --- L1["L1"] & L2["L2"]
+    R --- R1["R1"] & R2["R2"]
+    L1 --- L1a["..."] & L1b["..."]
+    L2 --- L2a["..."] & L2b["..."]
+    R1 --- R1a["..."] & R1b["..."]
+    R2 --- R2a["..."] & R2b["..."]
+```
+
+> ← بدون محدودیت عمق
+
+**قوانین:**
+- هر نود حداکثر ۲ فرزند (Binary) — `MaxDirectChildrenPerLeg = 1`
+- جایگذاری: `LegPosition` ∈ {Left=0, Right=1} (enum `NetworkLeg`)
+- مدل شبکه مستقیم روی entity `User` — فیلدهای `NetworkParentId`, `LegPosition`, `NetworkChildren`
+- محاسبه کمیسیون تا عمق ۱۵ سطح (`CommissionMaxNetworkLevel = 15`) — اما درخت بدون محدودیت رشد می‌کند
+
+---
+
+## ۳. فلوی عضویت و فعالسازی
+
+```mermaid
+flowchart TD
+    A["خرید پکیج طلایی — 56M"] --> B["نمایش مودال قرارداد\nغیرقابل‌بسته‌شدن"]
+    B --> C["مشاهده متن قرارداد\nReadContract RPC"]
+    C --> D["درخواست OTP\nRequestContractOtp — Kavenegar"]
+    D --> E["وارد کردن کد\nVerifyContractOtp"]
+    E --> F["امضای قرارداد\nAcceptContract"]
+
+    F --> G["شارژ ۲ کیف‌پول\nBalance += 56M\nDiscountBalance += 112M"]
+    F --> H["کسر فعالسازی\n−25.2M از Balance"]
+    F --> I["واریز 25.2M\nبه Pool هفتگی"]
+    F --> J["قرارگیری در\nدرخت باینری"]
+    F --> K["رفرش JWT Token\nclaims جدید"]
+```
+
+> ⚠️ در خرید با وام دایا: Balance += 56M, DiscountBalance += 112M (DayaLoanAmount × 2)  
+> NetworkBalance شارژ نمی‌شود — فقط برای کمیسیون
+
+---
+
+## ۴. الگوریتم محاسبه کمیسیون هفتگی
+
+### ۴.۱ فرمول ۴ مرحله‌ای
+
+```
+مرحله ۱: جمع فروش هر پا
+  SumLeft  = Σ(فروش‌های پای چپ در هفته جاری + CanOverLeft)
+  SumRight = Σ(فروش‌های پای راست در هفته جاری + CanOverRight)
+
+مرحله ۲: محاسبه تعادل
+  WeeklyBalance = MIN(SumLeft, SumRight)
+
+مرحله ۳: محاسبه باقیمانده (Carryover)
+  CanOverLeft  = SumLeft  - WeeklyBalance
+  CanOverRight = SumRight - WeeklyBalance
+
+مرحله ۴: سقف هفتگی
+  IF WeeklyBalance > 300  →  WeeklyBalance = 300
+  IF CanOverLeft > 300    →  Flush (CanOverLeft = 0)
+  IF CanOverRight > 300   →  Flush (CanOverRight = 0)
+```
+
+### ۴.۲ مثال عددی (درخت ۵ سطحی)
+
+```
+هفته ۱:  چپ=120, راست=80  →  Balance=80, Over(L=40, R=0)
+هفته ۲:  چپ=90+40=130, راست=150  →  Balance=130, Over(L=0, R=20)
+هفته ۳:  چپ=200, راست=180+20=200  →  Balance=200, Over(L=0, R=0)
+هفته ۴:  چپ=500, راست=100  →  Balance=100, Over(L=400→FLUSH=0, R=0)
+```
+
+### ۴.۳ Pool هفتگی و توزیع
+
+```mermaid
+flowchart LR
+    A["هر فعالسازی عضو\n25.2M واریز"] --> B["Pool هفتگی"]
+    B --> C["sp_CalculateWeeklyBalances"]
+    C --> D["sp_CalculateWeeklyCommissionPool"]
+    D --> E["توزیع بر اساس\nUserBalance / TotalBalance"]
+```
+
+> فرمت هفته: `YYYY-Www` (شمسی، شنبه‌پایه)
+
+### ۴.۴ فیلتر کاربران Magic از کمیسیون
+
+> ⚠️ **کاربرانی که در حالت Magic هستند (`WalletMode = 1`) از محاسبات کمیسیون هفتگی خارج می‌شوند.**
+
+```
+فیلتر در ۳ نقطه:
+  ✅ CalculateWeeklyBalancesCommandHandler.cs  →  WHERE wallet.WalletMode != Magic
+  ✅ OrmCommissionCalculationStrategy.cs       →  فیلتر LINQ
+  ✅ sp_CalculateWeeklyBalances.sql            →  NOT EXISTS (WalletMode=1)
+
+تاریخ محاسبه:
+  قبل:  ClubMembership.ActivatedAt (مشکل: بعد از خرید مجدد overwrite می‌شد)
+  بعد:  ClubMembershipCycle.PackagePurchasedAt (هر دور تاریخ مستقل)
+```
+
+---
+
+## ۵. تنظیمات سیستمی (SystemConstants)
+
+| ثابت (SystemConstants) | مقدار | توضیح |
+|------|-------|--------|
+| `ClubActivationFee` | 25,200,000 | هزینه فعالسازی (ریال) |
+| `ClubMembershipGiftValue` | 25,200,000 | واریز به Pool |
+| `BasePackageAmount` | 56,000,000 | قیمت پکیج طلایی (ریال) |
+| `DayaLoanAmount` | 56,000,000 | مبلغ وام دایا (ریال) |
+| `CommissionMaxWeeklyBalancesPerLeg` | 300 | سقف هفتگی هر پا |
+| `CommissionMaxNetworkLevel` | 15 | عمق محاسبه کمیسیون (نه محدودیت درخت) |
+| `MaxDirectChildrenPerLeg` | 1 | حداکثر فرزند مستقیم هر پا |
+| `MinimumWithdrawAmount` | 1,000,000 | حداقل مبلغ برداشت (ریال) |
+| `ShopVAT` | 0.1 (10%) | مالیات ارزش افزوده |
+| `MagicWalletMultiplier` | 2.5 | ضریب شارژ جادویی (واریز × 2.5) |
+| `MagicWalletMaxDeposit` | 1,000,000,000 | سقف واریز هر دور (100M تومان = 1B ریال) |
+| `MagicWalletMaxCredit` | 2,500,000,000 | سقف اعتبار هر دور (250M تومان) |
+| `CommissionCalculationMethod` | "SP" | روش محاسبه = Stored Procedure |
+
+---
+
+## ۶. ۳ سناریوی خرید پکیج طلایی
+
+| سناریو | فلو | وضعیت |
+|--------|------|--------|
+| **وام دایا** | درخواست وام → تأیید → Balance=56M + Discount=112M (مجموع ۱۶۸M) | ✅ پیاده‌شده |
+| **درگاه مستقیم** | IPG → callback → Balance=56M + Discount=112M (مجموع ۱۶۸M) | ✅ پیاده‌شده |
+| **پرداخت دستی** | کارت‌به‌کارت → آپلود رسید → تأیید ادمین → شارژ | ⚠️ طراحی‌شده |
+
+---
+
+## ۷. یکپارچه‌سازی وام دایا
+
+```mermaid
+flowchart TD
+    A["Hangfire Worker\nهر ۲۰ دقیقه — */20 * * * *"] --> B["بررسی درخواست‌های pending"]
+    B --> C["ارسال به API دایا\nMock/Real switchable"]
+    C --> D["دریافت نتیجه"]
+    D --> E["Balance += 56M"]
+    D --> F["DiscountBalance += 112M\nDayaLoanAmount × 2"]
+```
+
+> مجموع شارژ: 168M — Hangfire retry: `[AutomaticRetry(Attempts = 3)]`
+
+---
+
+## ۸. Chatika AI — اولین فیچر باشگاه
+
+| آیتم | جزئیات |
+|------|---------|
+| **نوع** | Hangfire recurring job |
+| **فرکانس** | هر ۵ دقیقه |
+| **Retry** | Polly — ۳ تلاش، backoff نمایی |
+| **فعال‌سازی** | فقط برای اعضای فعال باشگاه |
+| **وضعیت** | ✅ Production ready |
+
+---
+
+## ۹. کیف‌پول جادویی (Magic Wallet) ✅
+
+> **وضعیت: فاز ۱ تا ۵ پیاده‌سازی شده — فاز ۶ باقیمانده**  
+> **مرجع کامل:** [MAGIC-WALLET-SPEC](../roadmap/MAGIC-WALLET-SPEC.md)
+
+### ۹.۱ چرخه کامل
+
+```mermaid
+flowchart TD
+    A["خرید پکیج 56M\nBalance=56M, Discount=112M"] --> B["خرید از فروشگاه\nBalance کم می‌شود"]
+    B --> C{"Balance = 0?"}
+    C -->|خیر| B
+    C -->|بله| D{"عضو باشگاه فعال؟"}
+    D -->|خیر| E["حالت عادی باقی بمان"]
+    D -->|بله| F["🪄 ورود به حالت جادویی\nWalletMode = Magic"]
+    F --> G["شارژ از درگاه\nواریز × 2.5 = اعتبار Balance"]
+    G --> H{"Balance=0 AND\nTotalDeposited≥100M?"}
+    H -->|خیر| G
+    H -->|بله| I["خروج از جادویی\nWalletMode = Normal"]
+    I --> J["خرید مجدد پکیج\nفقط IPG — بدون دایا"]
+    J --> A
+```
+
+### ۹.۲ قوانین کلیدی
+
+| قانون | مقدار |
+|-------|-------|
+| ضریب شارژ | واریز × 2.5 = اعتبار Balance |
+| سقف واریز/دور | 100M تومان (1B ریال) |
+| سقف اعتبار/دور | 250M تومان (2.5B ریال) |
+| کمیسیون در Magic | ❌ غیرفعال |
+| شرط خروج | Balance=0 **و** TotalDeposited≥100M (هر دو همزمان) |
+| ریست سقف | هر خرید مجدد پکیج → سقف از صفر |
+
+### ۹.۳ Entity‌های جدید
+
+```csharp
+// فیلدهای جدید UserWallet
+public WalletMode WalletMode { get; set; }           // Normal=0, Magic=1
+public long MagicTotalDeposited { get; set; }         // مجموع واریزی دور فعلی
+public long MagicTotalCredited { get; set; }          // مجموع اعتبار دریافتی
+public DateTime? MagicActivatedAt { get; set; }
+public DateTime? MagicCompletedAt { get; set; }
+
+// Entity جدید — حل مشکل تاریخ کمیسیون
+public class ClubMembershipCycle {
+    public long Id { get; set; }
+    public long ClubMembershipId { get; set; }
+    public int CycleNumber { get; set; }               // شماره دور (1, 2, 3, ...)
+    public DateTime PackagePurchasedAt { get; set; }   // تاریخ خرید این دور
+    public bool IsCurrentCycle { get; set; }           // دور فعلی
+}
+```
@@ -0,0 +1,284 @@
+# 💰 سیستم مالی، پرداخت و درگاه‌ها
+
+> **منابع ادغام‌شده:** `payment-gateway.md`, `payment-architecture-pyms.md`, `daya-loan-integration.md`, `manual-payment-system.md`, `discount-shop-business.md`  
+> **آخرین بروزرسانی:** اسفند ۱۴۰۴ (بروزرسانی: تصحیح مدل تومان/ریال + فیکس ZarinPal Verify + امنیت Callback URL)
+
+---
+
+## ۱. معماری کلی مالی
+
+```mermaid
+flowchart TD
+    subgraph GATEWAYS["درگاه‌ها"]
+        ZP["ZarinPal\nIPG"]
+        DL["Daya Loan\nAPI"]
+        MP["Manual Pay\nCard2Card"]
+        DW["Discount Wallet\nInternal"]
+    end
+
+    ZP --> PYMS["PYMS — Payment Service\ngRPC ↔ CMS ↔ FrontOffice/BackOffice"]
+    DL --> PYMS
+    MP --> PYMS
+    DW --> PYMS
+
+    PYMS --> WALLETS
+
+    subgraph WALLETS["3 Wallet System"]
+        W1["💰 Balance\nکیف پول اصلی"]
+        W2["🌟 NetworkBalance\nپاداش تیمی"]
+        W3["🏷️ DiscountBalance\nکیف پول اعتباری"]
+    end
+```
+
+---
+
+## ۲. درگاه ZarinPal (IPG)
+
+> **✅ محل استفاده:** ZarinPal در چهار جا فعال است:
+> 1. **فروشگاه اعتباری** — باقیمانده بعد از کسر DiscountBalance (اگر > 0)
+> 2. **شارژ کیف‌پول اعتباری** — واریز مستقیم از پروفایل کاربر
+> 3. **خرید پکیج** — پرداخت مستقیم با کارت بانکی (هر دو شاخه فعال)
+> 4. **شارژ کیف‌پول جادویی** — واریز با ضریب ×2.5 (فقط در حالت Magic)
+>
+> ❌ **فروشگاه عادی (Regular Store) از ZarinPal استفاده نمی‌کند** — فقط کسر از Balance کیف‌پول
+
+### ۲.۱ فلوی پرداخت
+
+```mermaid
+flowchart TD
+    A["کاربر → انتخاب محصول\nدرخواست پرداخت"] --> B["CMS → CreatePaymentRequest\ngRPC to PYMS"]
+    B --> C["PYMS → ZarinPal API\nمبلغ ×۱۰ (تومان→ریال)\nدریافت Authority"]
+    C --> D["Redirect کاربر\nصفحه پرداخت ZarinPal"]
+    D --> E["بازگشت با Authority\nCMS VerifyPayment (مبلغ ×۱۰)"]
+    E -->|موفق| F["✅ ثبت سفارش\n+ شارژ کیف‌پول"]
+    E -->|ناموفق| G["❌ نمایش پیام خطا"]
+```
+
+> **✅ فیکس ZarinPal Verify (اسفند ۱۴۰۴ — `721661a`):**
+> - **باگ:** `VerifyPaymentAsync(authority)` با ۲ آرگومان → amount=0 → ZarinPal Code=-1
+> - **فیکس:** lookup `PaymentTransaction.Amount` از DB + استفاده از overload ۳ آرگومانه `VerifyPaymentAsync(authority, orderId, amount)`
+> - `IPaymentGatewayService` — default impl ۳ آرگومانه اضافه شد
+> - ۷ فایل تغییر: PackageService, TransactionsService, VerifyDiscountWalletChargeCommandHandler, VerifyPackagePurchaseCommandHandler, IPaymentGatewayService, MockPaymentGatewayService, DayaPaymentService
+
+### ۲.۲ تنظیمات ZarinPal
+
+| پارامتر | مقدار |
+|----------|-------|
+| `MerchantId` | `4225d555-5fa9-4df0-9b61-1ce152cbbba8` |
+| `CallbackUrl` | از `appsettings.json` خوانده می‌شود (نه از ورودی کاربر) |
+| `Sandbox` | `true` (staging) / `false` (production) |
+| `Currency` | DB: تومان — ZarinPal: ریال (×۱۰ هنگام ارسال) |
+
+> **✅ مدل ارزی (تصحیح اسفند ۱۴۰۴):**
+> - **DB:** `Package.Price` و همه مبالغ مالی به **تومان** ذخیره می‌شوند
+> - **CMS → ZarinPal:** `ZarinPalPaymentService` مبلغ را ×۱۰ می‌کند (`amountInRials = amount * 10`)
+> - **FrontOffice UI:** مبالغ مستقیم به تومان نمایش داده می‌شوند (بدون تبدیل)
+> - **FrontOffice → CMS:** مبالغ به تومان ارسال می‌شوند (FO هیچ تبدیلی انجام نمی‌دهد)
+> - **باگ قبلی ۱:** FO مبلغ تومان را ×۱۰ تبدیل می‌کرد + CMS/ZarinPal دوباره ×۱۰ → مبلغ ۱۰۰ برابر (فیکس: `2f9ef15`)
+> - **باگ قبلی ۲:** `FormattedPrice = Price / 10` اشتباه بود — Price از قبل تومان است (فیکس: `3c1a8ff` اصلاح شد)
+
+> **✅ امنیت Callback URL (اسفند ۱۴۰۴):**
+> - هیچ callback URL از ورودی کاربر خوانده نمی‌شود — همه از `appsettings.json` خوانده می‌شوند
+> - `PackageService` و `TransactionsService`: از `FrontOfficeBaseUrl` config
+> - `MagicWallet` و `DiscountWallet`: از `CmsBaseUrl` config
+> - جلوگیری از حمله Open Redirect
+
+> **تنظیمات محیطی:**
+> - `appsettings.json` + `appsettings.Staging.json`: `UseSandbox: true` (تست)
+> - `appsettings.Production.json`: `UseSandbox: false` (واقعی)
+> - Production URL: `cms.kbs1.ir` | FrontOffice GwUrl: `cms.kbs2.ir`
+
+---
+
+## ۳. سیستم وام دایا (DayaLoan)
+
+### ۳.۱ معماری
+
+```mermaid
+flowchart TD
+    A["Hangfire Recurring Job\nهر ۲۰ دقیقه — */20 * * * *"] --> B["DayaLoanProcessorJob.Execute"]
+    B --> C["بررسی LoanRequests\nStatus = Pending"]
+    C --> D["برای هر درخواست:"]
+    D --> E["ارسال به DayaLoan API\nAutomaticRetry Attempts=3"]
+    E -->|تأیید| F["✅ Balance += 56M\nDiscountBalance += 112M\n+ ثبت Transaction + Log"]
+    E -->|رد| G["❌ Status = Rejected\n+ ارسال SMS"]
+```
+
+### ۳.۲ Mock Mode
+
+```csharp
+// appsettings.json
+"DayaLoan": {
+    "UseMock": true,         // staging
+    "BaseUrl": "https://api.dayaloan.ir",
+    "ApiKey": "***",
+    "AutoApproveInMock": true
+}
+```
+
+### ۳.۳ مقادیر
+
+| آیتم | مقدار |
+|------|-------|
+| مبلغ وام (DayaLoanAmount) | ۵۶,۰۰۰,۰۰۰ ریال |
+| شارژ Balance | ۵۶,۰۰۰,۰۰۰ ریال |
+| شارژ DiscountBalance | ۱۱۲,۰۰۰,۰۰۰ ریال (دو برابر — DayaLoanAmount × 2) |
+| مجموع شارژ | ۱۶۸,۰۰۰,۰۰۰ ریال |
+| NetworkBalance | شارژ نمی‌شود |
+| بازپرداخت | طبق شرایط دایا |
+
+---
+
+## ۴. پرداخت دستی (کارت‌به‌کارت)
+
+> ⚠️ **وضعیت: طراحی‌شده — پیاده‌سازی نشده**
+
+```mermaid
+flowchart TD
+    A["کاربر → انتخاب کارت‌به‌کارت"] --> B["نمایش شماره‌کارت مقصد\n+ مبلغ"]
+    B --> C["کاربر → واریز\n+ آپلود تصویر رسید"]
+    C --> D["ادمین BackOffice\nمشاهده لیست درخواست‌ها"]
+    D --> E{"تأیید / رد؟"}
+    E -->|تأیید| F["✅ شارژ خودکار کیف‌پول"]
+    E -->|رد| G["❌ اطلاع‌رسانی به کاربر"]
+```
+
+**موجودیت‌های مورد نیاز:**
+- `ManualPaymentRequest` (UserId, Amount, ReceiptImage, Status, AdminNote)
+- `ManualPaymentStatus` enum: Pending, Approved, Rejected
+
+---
+
+## ۵. پرداخت ترکیبی فروشگاه اعتباری (Hybrid Payment)
+
+### ۵.۱ فرمول
+
+```
+قیمت محصول = 1,000,000 ریال
+MaxDiscountPercent محصول = 40%  (هر محصول درصد تخفیف مخصوص خود را دارد)
+
+سهم تخفیف = قیمت × MaxDiscountPercent% = 400,000
+
+⚠️ اگر DiscountBalance < سهم تخفیف → خطا: «موجودی کیف پول اعتباری کافی نیست»
+   (دیگر MIN استفاده نمی‌شود — کاربر باید موجودی کافی داشته باشد)
+
+باقیمانده → ZarinPal IPG = 1,000,000 - 400,000 = 600,000
+                                            ─────────
+                          مجموع             = 1,000,000
+
+ℹ️ تخفیف ثابت ۳۰% نیست — فیلد Product.MaxDiscountPercent (0-100) تعیین‌کننده است.
+```
+
+### ۵.۲ فلوی خرید فروشگاه اعتباری
+
+```mermaid
+flowchart TD
+    A["کاربر عضو باشگاه\nمشاهده محصول"] --> B["قیمت تخفیف‌خورده نمایش داده می‌شود"]
+    B --> C["افزودن به سبد\nمحاسبه MaxDiscount% هر محصول"]
+    C --> D["سهم تخفیف = قیمت × MaxDiscount%"]
+    D --> V{"DiscountBalance >= سهم تخفیف?"}
+    V -->|خیر| X["❌ خطا: موجودی کیف پول اعتباری کافی نیست"]
+    V -->|بله| E["باقیمانده = مجموع - سهم تخفیف"]
+    E --> F{"باقیمانده > 0?"}
+    F -->|بله| G["کسر DiscountBalance\n+ Redirect → ZarinPal IPG\nباقیمانده + 10% VAT"]
+    F -->|خیر| H["فقط کسر از DiscountBalance\nبدون درگاه → ثبت مستقیم"]
+    G --> LOG["ثبت UserWalletChangeLog"]
+    H --> LOG
+```
+
+### ۵.۳ دسترسی فروشگاه اعتباری
+
+| شرط | نتیجه |
+|------|--------|
+| `IsClubMember = true` | دسترسی به Discount Store |
+| `IsClubMember = false` | فقط Regular Store |
+| `DiscountBalance >= سهم تخفیف` | خرید مجاز |
+| `DiscountBalance < سهم تخفیف` | ❌ خطا: موجودی کیف پول اعتباری کافی نیست |
+
+### ۵.۴ UserWalletChangeLog (اسفند ۱۴۰۴ — فیکس)
+
+> **باگ:** هنگام خرید از فروشگاه اعتباری، `DiscountBalance` در دیتابیس کم می‌شد ولی هیچ
+> `UserWalletChangeLog` ثبت نمی‌شد → کاربر در تاریخچه کیف‌پول چیزی نمی‌دید.
+
+فیکس در ۳ هندلر:
+
+| هندلر | سناریو | فیکس |
+|--------|---------|------|
+| `PlaceOrderCommandHandler` | پرداخت کامل با DiscountBalance (بدون درگاه) | ✅ ثبت log با `ChangeDiscountValue = -amount` |
+| `CompleteOrderPaymentCommandHandler` | پرداخت ترکیبی (درگاه + DiscountBalance) | ✅ ثبت log بعد از verify موفق درگاه |
+| `VerifyDiscountWalletChargeCommandHandler` | شارژ کیف‌پول اعتباری | ✅ ثبت log با `ChangeDiscountValue = +amount` |
+
+---
+
+## ۶. PYMS — سرویس پرداخت مرکزی
+
+### ۶.۱ gRPC Services
+
+```protobuf
+service PaymentService {
+    rpc CreatePayment (CreatePaymentRequest) returns (CreatePaymentResponse);
+    rpc VerifyPayment (VerifyPaymentRequest) returns (VerifyPaymentResponse);
+    rpc GetPaymentStatus (GetPaymentStatusRequest) returns (PaymentStatusResponse);
+    rpc RefundPayment (RefundPaymentRequest) returns (RefundPaymentResponse);
+}
+```
+
+### ۶.۲ Transaction Types
+
+| نوع | کد | توضیح |
+|-----|-----|--------|
+| PackagePurchase | 1 | خرید پکیج طلایی |
+| StorePurchase | 2 | خرید از فروشگاه |
+| DiscountStorePurchase | 3 | خرید از فروشگاه اعتباری |
+| CommissionPayout | 4 | واریز کمیسیون هفتگی |
+| WalletCharge | 5 | شارژ مستقیم کیف‌پول |
+| ActivationFee | 6 | هزینه فعالسازی |
+| DayaLoanCharge | 7 | شارژ از وام دایا |
+| MagicWalletDeposit | 14 | واریز به کیف‌پول جادویی |
+| MagicWalletBonus | 15 | بونوس ضریب ×2.5 کیف‌پول جادویی |
+
+---
+
+## ۷. مالیات و VAT
+
+```
+هر دو فروشگاه از نرخ 10% استفاده می‌کنند:
+
+  Regular Store  → const vatRate = 0.10m  (hardcoded در SubmitShopBuyOrderCommandHandler)
+  Discount Store → VatCalculator.VAT_RATE = 0.10m
+  SystemConstants.ShopVAT = 0.1 (10%)
+
+قیمت نمایشی = قیمت پایه × (1 + 0.10)
+در صورتحساب: قیمت پایه + مالیات جداگانه نمایش داده می‌شود
+```
+
+---
+
+## ۸. خلاصه وضعیت پیاده‌سازی
+
+| ماژول | وضعیت | یادداشت |
+|-------|--------|---------|
+| ZarinPal IPG | ✅ کامل | **Production فعال** — MerchantId: `4225d555...` |
+| ZarinPal Verify | ✅ فیکس شده | رفع amount=0 با overload ۳ آرگومانه (`721661a`) |
+| Callback URL امنیت | ✅ فیکس شده | همه از config خوانده می‌شوند — جلوگیری از Open Redirect |
+| وام دایا | ✅ کامل | Mock mode فعال در staging |
+| پرداخت ترکیبی | ✅ کامل | Discount + IPG |
+| Pool هفتگی | ✅ کامل | SP + Hangfire |
+| WalletChangeLog | ✅ فیکس شده | لاگ تغییرات کیف‌پول در ۳ هندلر اضافه شد |
+| Validation کیف‌پول اعتباری | ✅ فیکس شده | ارور اگر موجودی کافی نباشد |
+| Toman/Rial مدل | ✅ تصحیح شده | DB=تومان، فقط ZarinPal ریال (×۱۰) — FO بدون تبدیل |
+| صفحه موفقیت پرداخت | ✅ بهبود | TransactionId + موجودی واقعی + دکمه بازگشت |
+| PackagePurchaseDialog | ✅ کامل | دیالوگ داینامیک کاشی‌ای با انتخاب روش پرداخت |
+| پرداخت دستی | ⬜ طراحی | نیاز به تصمیم مدیریت |
+| Refund | ⬜ طراحی | فقط در PYMS تعریف‌شده |
+| کیف‌پول جادویی (Magic) | ✅ کامل | فاز 1-6 پیاده‌سازی شده — Production فعال |
+
+### ۸.۱ نام‌گذاری استاندارد کیف‌پول‌ها (اسفند ۱۴۰۴)
+
+| فیلد دیتابیس | نام قدیم (UI) | نام جدید (UI) |
+|-------------|--------------|---------------|
+| `Balance` | عادی / اعتباری / نقدی | **کیف پول اصلی** |
+| `DiscountBalance` | تخفیفی / تخفیف | **کیف پول اعتباری** |
+| `NetworkBalance` | شبکه / طلایی / پورسانت | **پاداش تیمی** |
+
+> تغییرات UI در ۱۲ فایل (FrontOffice: 5, BackOffice: 7) اعمال شد.
@@ -0,0 +1,269 @@
+# 🛒 فروشگاه، موجودی و محصولات
+
+> **منابع ادغام‌شده:** `discount-shop-business.md`, `DISCOUNT-STORE-STATUS.md`, `package-purchase-system.md`, `INVENTORY-IMPROVEMENTS.md`, `INVENTORY-REFACTORING-STATUS.md`, `PRODUCT-BUNDLE-FEATURE.md`, `SHOP-UNIFICATION.md`  
+> **آخرین بروزرسانی:** اسفند ۱۴۰۴ (بروزرسانی: ExpirePendingOrders ۱۵ دقیقه + فروشگاه اعتباری نام‌گذاری)
+
+---
+
+## ۱. دو فروشگاه FourSat
+
+```mermaid
+flowchart LR
+    subgraph RS["Regular Store — /store"]
+        R1["همه کاربران"]
+        R2["پرداخت از Balance کیف‌پول"]
+        R3["قیمت عادی"]
+        R4["VAT = 10%"]
+    end
+
+    subgraph DS["Discount Store — /discount-store"]
+        D1["فقط اعضای باشگاه"]
+        D2["پرداخت ترکیبی تخفیف+نقد"]
+        D3["تخفیف بر اساس MaxDiscountPercent"]
+        D4["VAT = 10%"]
+    end
+
+    subgraph SHARED["مشترک"]
+        S1["Products"]
+        S2["Categories"]
+        S3["Inventory"]
+        S4["ProductImages 1:1"]
+    end
+
+    RS --> SHARED
+    DS --> SHARED
+```
+
+---
+
+## ۲. Lazy Loading محصولات
+
+### ۲.۱ API
+
+```csharp
+// ProductService.cs
+public record ProductListResult(List<ProductDto> Products, int TotalCount);
+
+public async Task<ProductListResult> GetProductsPagedAsync(
+    int skip, int take, 
+    Guid? categoryId = null, 
+    string? search = null)
+{
+    var request = new GetProductsRequest {
+        Pagination = new PaginationState { Skip = skip, Take = take },
+        CategoryId = categoryId?.ToString() ?? "",
+        SearchTerm = search ?? ""
+    };
+    // gRPC call...
+}
+```
+
+### ۲.۲ پیاده‌سازی UI (هر دو فروشگاه)
+
+```mermaid
+flowchart TD
+    A["بارگذاری اولیه: 12 محصول"] --> B["اسکرول → نمایش دکمه\nنمایش محصولات بیشتر"]
+    B --> C["کلیک → LoadMore\nskip += 12"]
+    C --> D["محصولات جدید append به لیست"]
+    D --> E{"Products.Count >= TotalCount?"}
+    E -->|خیر| B
+    E -->|بله| F["مخفی‌شدن دکمه"]
+```
+
+---
+
+## ۳. مدیریت موجودی (Inventory)
+
+### ۳.۱ بهبودهای اخیر
+
+| بهبود | توضیح | وضعیت |
+|-------|--------|--------|
+| Auto-Create | ایجاد خودکار رکورد موجودی هنگام ساخت محصول | ✅ |
+| Hangfire Worker | `InventorySyncJob` — بررسی دوره‌ای و ایجاد رکوردهای گمشده | ✅ |
+| Autocomplete | جستجوی محصول در صفحه موجودی BackOffice با autocomplete | ✅ |
+| Lazy Load | بارگذاری تنبل محصولات در هر دو فروشگاه | ✅ |
+
+### ۳.۲ Entity ها
+
+```csharp
+public class Inventory {
+    public Guid Id { get; set; }
+    public Guid ProductId { get; set; }         // FK → Product
+    public int Quantity { get; set; }            // موجودی فعلی
+    public int ReservedQuantity { get; set; }    // رزرو‌شده
+    public int MinimumStock { get; set; }        // حداقل موجودی (هشدار)
+    public bool TrackInventory { get; set; }     // آیا موجودی رصد شود؟
+}
+
+// فیلد کلیدی در Product:
+public int MaxDiscountPercent { get; set; }  // 0 تا 100 — درصد تخفیف در فروشگاه اعتباری
+```
+
+### ۳.۳ فلوی سفارش و موجودی
+
+```mermaid
+flowchart TD
+    A["سفارش جدید"] --> B{"Quantity - Reserved >= OrderQty?"}
+    B -->|بله| C["Reserved += OrderQty"]
+    C --> D{"پرداخت موفق؟"}
+    D -->|موفق| E["✅ Quantity -= OrderQty\nReserved -= OrderQty"]
+    D -->|ناموفق| F["❌ Reserved -= OrderQty\nآزادسازی"]
+    B -->|خیر| G["نمایش: موجودی کافی نیست"]
+```
+
+---
+
+## ۴. تصاویر محصول (۱:۱ مربعی)
+
+```
+AppImage Component (Shared):
+    • ObjectFit = Cover
+    • AspectRatio = 1:1 (مربع)
+    • Fallback = آیکون پیش‌فرض MudBlazor
+    • LazyLoading = true
+    
+اعمال در:
+    ✅ Regular Store — ProductCard
+    ✅ Discount Store — ProductCard
+    ✅ BackOffice — Product List
+    ✅ Product Detail Pages
+```
+
+---
+
+## ۵. باندل محصولات (Product Bundle)
+
+> ⚠️ **وضعیت: طراحی کامل — پیاده‌سازی نشده**
+
+### ۵.۱ مدل داده
+
+```csharp
+public class ProductBundle {
+    public Guid Id { get; set; }
+    public string Name { get; set; }
+    public string Description { get; set; }
+    public decimal OriginalPrice { get; set; }    // مجموع قیمت تکی
+    public decimal BundlePrice { get; set; }       // قیمت باندل
+    public decimal DiscountPercentage { get; set; }
+    public bool IsActive { get; set; }
+    public List<BundleItem> Items { get; set; }
+}
+
+public class BundleItem {
+    public Guid ProductId { get; set; }
+    public int Quantity { get; set; }
+}
+```
+
+### ۵.۲ فلو
+
+```mermaid
+flowchart TD
+    A["ادمین → ساخت باندل\nانتخاب محصولات + تعیین قیمت"] --> B["نمایش در فروشگاه\nبا تگ باندل"]
+    B --> C["خرید → تمام محصولات\nیکجا به سبد"]
+    C --> D["پرداخت → کسر موجودی\nهر محصول جداگانه"]
+```
+
+---
+
+## ۶. یکپارچه‌سازی فروشگاه‌ها (Shop Unification)
+
+### ۶.۱ اجزای مشترک
+
+| کامپوننت | کاربرد | وضعیت |
+|----------|--------|--------|
+| `ProductCard` | کارت محصول (۱:۱) | ✅ مشترک |
+| `AppImage` | نمایش تصویر | ✅ مشترک |
+| `CategoryFilter` | فیلتر دسته‌بندی | ✅ مشترک |
+| `SearchBar` | جستجوی محصول | ✅ مشترک |
+| `LoadMoreButton` | Lazy loading | ✅ مشترک |
+| `CartSummary` | خلاصه سبد | ⬜ جداگانه |
+
+### ۶.۲ مسیرهای Navigation
+
+```
+فروشگاه عادی:
+  /store                    → لیست محصولات
+  /store/product/{id}       → جزئیات محصول
+  /store/cart               → سبد خرید
+  /store/checkout            → پرداخت
+
+فروشگاه اعتباری:
+  /discount-store            → لیست محصولات
+  /discount-store/product/{id} → جزئیات
+  /discount-store/cart        → سبد (ترکیبی)
+  /discount-store/checkout    → پرداخت ترکیبی
+```
+
+---
+
+## ۷. دسته‌بندی‌ها (Categories)
+
+```mermaid
+graph TD
+    ROOT["دسته‌بندی‌ها"] --> A["سلامت و زیبایی"]
+    ROOT --> B["تغذیه"]
+    ROOT --> C["ورزشی"]
+
+    A --> A1["مکمل‌ها"]
+    A --> A2["مراقبت پوست"]
+    A --> A3["مراقبت مو"]
+
+    B --> B1["ارگانیک"]
+    B --> B2["رژیمی"]
+```
+
+> مدل: `Category (Id, Name, ParentId?, ImageUrl, IsActive, SortOrder)`
+
+---
+
+## ۸. خلاصه وضعیت
+
+| ماژول | وضعیت | درصد |
+|-------|--------|------|
+| فروشگاه عادی | ✅ کامل | 100% |
+| فروشگاه اعتباری | ✅ کامل | 100% |
+| Lazy Loading | ✅ کامل | 100% |
+| موجودی خودکار | ✅ کامل | 100% |
+| تصاویر مربعی | ✅ کامل | 100% |
+| انقضای سفارشات Pending | ✅ کامل | 100% |
+| باندل محصولات | ⬜ طراحی | 30% |
+| مقایسه محصول | ⬜ ایده | 0% |
+
+---
+
+## ۹. انقضای خودکار سفارشات Pending (ExpirePendingOrdersService)
+
+> سرویس پس‌زمینه‌ای که سفارشات فروشگاه اعتباری را بعد از ۱۵ دقیقه منقضی می‌کند.
+
+### ۹.۱ پارامترها
+
+| پارامتر | مقدار | توضیح |
+|---------|-------|-------|
+| `ExpirationTime` | **۱۵ دقیقه** | مدت زمان مجاز برای پرداخت |
+| `CheckInterval` | ۵ دقیقه | فاصله بررسی |
+
+### ۹.۲ عملکرد
+
+```mermaid
+flowchart TD
+    A["هر ۵ دقیقه\nExpirePendingOrdersService"] --> B["جستجوی DiscountOrders\nPaymentStatus=Pending\nCreated < (now - 15 min)"]
+    B --> C{"سفارشی یافت شد?"}
+    C -->|خیر| A
+    C -->|بله| D["آزادسازی رزرو موجودی\nReleaseReservationAsync"]
+    D --> E["PaymentStatus → Reject\nDeliveryStatus → Cancelled"]
+    E --> F["Transaction.PaymentStatus → Reject"]
+    F --> G["Log: Expired order #X"]
+    G --> A
+```
+
+### ۹.۳ فایل
+
+```
+CMS/src/CMSMicroservice.Infrastructure/BackgroundServices/ExpirePendingOrdersService.cs
+```
+
+رجیستر شده در `ConfigureServices.cs`:
+```csharp
+services.AddHostedService<ExpirePendingOrdersService>();
+```
@@ -0,0 +1,200 @@
+# 👤 سفر کاربر، ثبت‌نام و چرخه عضویت
+
+> **منابع ادغام‌شده:** `club-membership-contract-system.md`, `REGISTRATION-FLOW-FIXES.md`, `chatika-integration.md`, `club-feature-management-services.md`, `ADMIN-CUSTOMER-SEPARATION-FIX.md`, `ICURRENTUSERSERVICE-IMPLEMENTATION.md`  
+> **آخرین بروزرسانی:** اسفند ۱۴۰۴ (بروزرسانی: Magic Wallet cycle)
+
+---
+
+## ۱. فلوی کامل چرخه کاربر
+
+```mermaid
+flowchart TD
+    A["ورود به سایت"] --> B["ثبت‌نام — موبایل + OTP"]
+    B --> C["تکمیل پروفایل"]
+    C --> D{"مسیر؟"}
+
+    D -->|عادی| E["🛒 خرید از فروشگاه\nمشاهده بلاگ\nاستفاده از خدمات"]
+
+    D -->|باشگاه| F["🏆 خرید پکیج طلایی 56M"]
+    F --> G["امضای قرارداد OTP"]
+    G --> H["فعالسازی 25.2M"]
+    H --> I["عضویت درخت باینری"]
+    I --> J["دسترسی فروشگاه اعتباری\nفیچرهای باشگاه\nکمیسیون هفتگی"]
+    J --> K{"Balance = 0?"}
+    K -->|بله| L["🪄 کیف‌پول جادویی\nشارژ ×2.5 از درگاه"]
+    L --> M["خروج از Magic\nخرید مجدد پکیج"]
+    M --> F
+```
+
+---
+
+## ۲. ثبت‌نام و احراز هویت
+
+### ۲.۱ فلوی ثبت‌نام
+
+```mermaid
+flowchart TD
+    A["صفحه ثبت‌نام"] --> B["ورود شماره موبایل"]
+    B --> C["ارسال OTP\nKavenegar SMS API"]
+    C --> D["تأیید کد OTP"]
+    D -->|کاربر جدید| E["ساخت User\n+ JWT Token"]
+    D -->|کاربر موجود| F["ورود\n+ JWT Token"]
+```
+
+**JWT Claims:** `UserId`, `PhoneNumber`, `IsClubMember`, `Roles[]`, `ReferralCode`
+
+### ۲.۲ اصلاحات ثبت‌نام
+
+| مشکل | راه‌حل | وضعیت |
+|------|---------|--------|
+| OTP تکراری | Cooldown: ۶۰ ثانیه بین درخواست‌ها | ✅ |
+| شماره نامعتبر | Regex validation ایران `^09\d{9}$` | ✅ |
+| حمله brute-force | MaxAttempts: ۵ تلاش برای تأیید کد | ✅ |
+| انقضای کد | TTL: ۲ دقیقه | ✅ |
+| طول کد | ۶ رقم | ✅ |
+| قالب SMS | Kavenegar template: `Afrino` | ✅ |
+
+---
+
+## ۳. جداسازی Admin/Customer
+
+### ۳.۱ مشکل قبلی
+
+```mermaid
+flowchart LR
+    subgraph BEFORE["قبل — مشکل"]
+        A1["Admin + Customer"] --> A2["یک DbContext\nیک Identity\nتداخل Claims"]
+    end
+
+    subgraph AFTER["بعد — اصلاح‌شده ✅"]
+        B1["ICurrentUserService"] --> B2["جداسازی Policy\nAdmin → BackOffice\nCustomer → FrontOffice"]
+    end
+```
+
+### ۳.۲ ICurrentUserService
+
+```csharp
+public interface ICurrentUserService {
+    Guid UserId { get; }
+    string PhoneNumber { get; }
+    bool IsClubMember { get; }
+    bool IsAdmin { get; }
+    string[] Roles { get; }
+    Guid? ReferrerId { get; }
+}
+
+// پیاده‌سازی: از HttpContext.User.Claims خوانده می‌شود
+// ثبت: services.AddScoped<ICurrentUserService, CurrentUserService>()
+```
+
+---
+
+## ۴. قرارداد عضویت باشگاه
+
+### ۴.۱ فلوی امضای قرارداد
+
+```mermaid
+flowchart TD
+    A["خرید پکیج طلایی\nRedirect به صفحه قرارداد"] --> B["نمایش Modal\nغیرقابل‌بسته‌شدن"]
+    B --> C["ReadContract RPC\nنمایش متن قرارداد"]
+    C --> D["اسکرول تا انتها"]
+    D --> E["فعال شدن دکمه\nارسال کد تأیید"]
+    E --> F["RequestContractOtp\nارسال SMS"]
+    F --> G["ورود کد\nVerifyContractOtp"]
+    G -->|معتبر| H["✅ AcceptContract\nفعالسازی عضویت"]
+    G -->|نامعتبر| I["❌ پیام خطا\nحداکثر ۵ تلاش"]
+```
+
+### ۴.۲ ذخیره‌سازی قرارداد
+
+```csharp
+// از کد: UserContract : BaseAuditableEntity
+public class UserContract {
+    public long UserId { get; set; }
+    public virtual User User { get; set; }
+    public long ContractId { get; set; }         // FK → Contract
+    public virtual Contract Contract { get; set; }
+    public string SignGuid { get; set; }          // GUID یکتای امضا
+    public string SignedPdfFile { get; set; }     // فایل PDF امضاشده
+    // فیلدهای BaseAuditableEntity: CreatedAt, ModifiedAt, ...
+}
+```
+
+---
+
+## ۵. فیچرهای باشگاه (Club Features)
+
+### ۵.۱ سرویس مدیریت
+
+```csharp
+public interface IClubFeatureService {
+    Task<List<ClubFeature>> GetUserFeaturesAsync(Guid userId);
+    Task ActivateFeatureAsync(Guid userId, string featureCode);
+    Task DeactivateFeatureAsync(Guid userId, string featureCode);
+    Task<bool> HasFeatureAsync(Guid userId, string featureCode);
+}
+```
+
+### ۵.۲ فیچرهای موجود
+
+| کد فیچر | نام | توضیح | وضعیت |
+|----------|------|--------|--------|
+| `DISCOUNT_STORE` | فروشگاه اعتباری | دسترسی به فروشگاه اعتباری | ✅ فعال |
+| `CHATIKA_AI` | چاتیکا | مشاوره هوش مصنوعی | ✅ فعال |
+| `COMMISSION` | کمیسیون | دریافت کمیسیون هفتگی | ✅ فعال |
+| `NETWORK_VIEW` | نمای شبکه | مشاهده درخت باینری | ✅ فعال |
+| `DAYA_LOAN` | وام دایا | درخواست وام | ⚠️ بلاک‌شده |
+
+### ۵.۳ UserClubFeature Entity
+
+```csharp
+public class UserClubFeature {
+    public Guid Id { get; set; }
+    public Guid UserId { get; set; }
+    public string FeatureCode { get; set; }
+    public bool IsActive { get; set; }
+    public DateTime ActivatedAt { get; set; }
+    public DateTime? DeactivatedAt { get; set; }
+}
+```
+
+---
+
+## ۶. ناوبری Auth-Aware
+
+```csharp
+// صفحه اصلی — مسیردهی هوشمند
+if (IsAuthenticated && IsClubMember)
+    → نمایش داشبورد باشگاه + فروشگاه اعتباری
+else if (IsAuthenticated)
+    → نمایش فروشگاه عادی + پروفایل
+else
+    → نمایش Landing Page + ثبت‌نام
+```
+
+---
+
+## ۷. کدهای معرف (Referral)
+
+```mermaid
+flowchart TD
+    A["هر عضو باشگاه\nیک ReferralCode یکتا"] --> B["لینک:\nhttps://foursat.ir/register?ref=CODE"]
+    B --> C["ثبت‌نام با لینک\nذخیره ReferrerId"]
+    C --> D["خرید پکیج\nزیرمجموعه Referrer در درخت"]
+    D --> E["Referrer\nدریافت bonus"]
+```
+
+---
+
+## ۸. خلاصه وضعیت
+
+| ماژول | وضعیت | درصد |
+|-------|--------|------|
+| ثبت‌نام OTP | ✅ | 100% |
+| جداسازی Admin/Customer | ✅ | 100% |
+| ICurrentUserService | ✅ | 100% |
+| قرارداد باشگاه + OTP | ✅ | 100% |
+| فیچرهای باشگاه | ✅ | 100% |
+| Referral System | ✅ | 100% |
+| ناوبری Auth-Aware | ✅ | 100% |
+| مشاهده درخت شبکه (FrontOffice) | ✅ | 100% |
@@ -0,0 +1,250 @@
+# 📄 محتوا، صفحات، بلاگ و ایمیل/SMS
+
+> **منابع ادغام‌شده:** `SITE-PAGES-SIMPLIFICATION.md`, `system-constants.md`, `email-sms-configuration.md`, `chatika-integration.md`, `CMS-README.md`  
+> **آخرین بروزرسانی:** اسفند ۱۴۰۴ (بروزرسانی: Magic Wallet + VAT 10%)
+
+---
+
+## ۱. مدیریت صفحات سایت (Site Pages)
+
+### ۱.۱ معماری ساده‌شده (Shopify-style)
+
+```mermaid
+flowchart LR
+    subgraph BEFORE["قبل — پیچیده"]
+        X1["SitePage"] --> X2["SitePageSetting"] --> X3["SitePageContent"] --> X4["Template\n... 7 جدول"]
+    end
+
+    subgraph AFTER["بعد — ساده ✅"]
+        Y1["SitePage\nPageType + JsonSettings"] --> Y2["هر PageType\nیک typed editor"]
+    end
+```
+
+### ۱.۲ انواع صفحات
+
+| PageType | Route | Editor | وضعیت |
+|----------|-------|--------|--------|
+| `Home` | `/` | HomePageEditor | ✅ |
+| `About` | `/about` | AboutPageEditor | ✅ |
+| `Contact` | `/contact` | ContactPageEditor | ✅ |
+| `Landing` | `/landing` | LandingPageEditor | ✅ |
+| `Licenses` | `/licenses` | LicensesPageEditor | ✅ |
+| `FAQ` | `/faq` | FAQPageEditor | ✅ |
+| `Terms` | `/terms` | MarkdownEditor | ✅ |
+| `Privacy` | `/privacy` | MarkdownEditor | ✅ |
+
+### ۱.۳ SitePageSettingsService
+
+```csharp
+public interface ISitePageSettingsService {
+    Task<T> GetSettingsAsync<T>(string pageType) where T : class, new();
+    Task SaveSettingsAsync<T>(string pageType, T settings) where T : class;
+}
+
+// ذخیره‌سازی: JSON serialization در فیلد Settings
+// Cache: MemoryCache با Expiry 15 دقیقه
+```
+
+### ۱.۴ مثال — تنظیمات صفحه اصلی
+
+```json
+{
+    "heroTitle": "کارا بازار سلامت",
+    "heroSubtitle": "سلامتی در دستان شما",
+    "heroImageUrl": "/images/hero.jpg",
+    "featuredCategories": ["guid1", "guid2"],
+    "showPromotionBanner": true,
+    "promotionText": "تخفیف ویژه زمستانه"
+}
+```
+
+---
+
+## ۲. سیستم بلاگ
+
+### ۲.۱ Entity
+
+```csharp
+public class BlogPost {
+    public Guid Id { get; set; }
+    public string Title { get; set; }
+    public string Slug { get; set; }           // URL-friendly
+    public string Content { get; set; }         // HTML/Markdown
+    public string Summary { get; set; }
+    public string FeaturedImageUrl { get; set; }
+    public Guid AuthorId { get; set; }
+    public Guid? CategoryId { get; set; }
+    public bool IsPublished { get; set; }
+    public DateTime PublishedAt { get; set; }
+    public List<string> Tags { get; set; }
+    public int ViewCount { get; set; }
+}
+```
+
+### ۲.۲ Pagination (gRPC)
+
+```protobuf
+message GetBlogPostsRequest {
+    PaginationState pagination = 1;
+    string categoryId = 2;
+    string searchTerm = 3;
+    bool publishedOnly = 4;
+}
+```
+
+---
+
+## ۳. مدیریت فایل (File Management)
+
+### ۳.۱ معماری
+
+```mermaid
+flowchart TD
+    A["آپلود فایل\nتصویر / سند"] --> B["FileManagementService"]
+    B --> C["ذخیره در فایل‌سیستم\n+ ثبت در DB"]
+    C --> D["مسیر: /app/uploads/year/month/guid.ext\nURL: /api/files/guid"]
+```
+
+> محدودیت: حداکثر 10MB • jpg, png, webp, pdf, doc, docx • Resize: 800×800 (محصولات)
+
+### ۳.۲ Storage Strategy
+
+| محیط | ذخیره‌سازی |
+|------|------------|
+| Development | Local filesystem |
+| Staging | Local filesystem (server) |
+| Production | Local filesystem (server) |
+| آینده | MinIO / S3 compatible (planned) |
+
+---
+
+## ۴. تنظیمات ایمیل و SMS
+
+### ۴.۱ SMS (Kavenegar)
+
+```json
+{
+    "Kavenegar": {
+        "ApiKey": "***",
+        "SenderNumber": "1000001110100",
+        "DefaultTemplate": "Afrino",
+        "_note": "تمام OTPها با قالب Afrino ارسال می‌شوند"
+    }
+}
+```
+
+### ۴.۲ ایمیل
+
+```json
+{
+    "Email": {
+        "SmtpHost": "smtp.example.com",
+        "SmtpPort": 587,
+        "Username": "noreply@foursat.ir",
+        "FromName": "کارا بازار سلامت",
+        "UseSsl": true,
+        "Templates": {
+            "WelcomeEmail": "welcome.html",
+            "OrderReceipt": "order-receipt.html"
+        }
+    }
+}
+```
+
+> ⚠️ ایمیل فعلاً فقط برای اطلاع‌رسانی ادمین استفاده می‌شود — SMS کانال اصلی کاربران
+
+---
+
+## ۵. ثوابت سیستمی (SystemConstants)
+
+### ۵.۱ جدول اصلی
+
+```sql
+CREATE TABLE SystemConfigurations (
+    [Key] NVARCHAR(200) PRIMARY KEY,
+    [Value] NVARCHAR(MAX),
+    [Description] NVARCHAR(500),
+    [Category] NVARCHAR(100),
+    [LastModified] DATETIME2
+);
+```
+
+### ۵.۲ مقادیر کلیدی
+
+| Category | Key | Value | توضیح |
+|----------|-----|-------|--------|
+| Club | `ClubActivationFee` | 25200000 | هزینه فعالسازی (ریال) |
+| Club | `ClubMembershipGiftValue` | 25200000 | واریز Pool |
+| Club | `BasePackageAmount` | 56000000 | قیمت پکیج طلایی (ریال) |
+| Club | `CommissionMaxNetworkLevel` | 15 | عمق محاسبه کمیسیون |
+| Club | `CommissionMaxWeeklyBalancesPerLeg` | 300 | سقف هفتگی |
+| Payment | `ShopVAT` | 0.1 (10%) | مالیات ارزش افزوده (هر دو فروشگاه) |
+| Magic | `MagicWalletMultiplier` | 2.5 | ضریب شارژ جادویی |
+| Magic | `MagicWalletMaxDeposit` | 1,000,000,000 | سقف واریز/دور (100M تومان) |
+| Magic | `MagicWalletMaxCredit` | 2,500,000,000 | سقف اعتبار/دور (250M تومان) |
+| Payment | `DayaLoanAmount` | 56000000 | مبلغ وام (ریال) |
+| Payment | `MinimumWithdrawAmount` | 1000000 | حداقل برداشت (ریال) |
+| Store | `MaxDiscountPercent` | per-product | 0-100، هر محصول جداگانه |
+| Store | `ProductsPerPage` | 12 (FO) / 10 (CMS) | تعداد در صفحه |
+| System | `CommissionCalculationMethod` | "SP" | Stored Procedure |
+| System | `MaintenanceMode` | false | حالت تعمیر |
+
+---
+
+## ۶. Chatika AI Integration
+
+### ۶.۱ معماری
+
+```mermaid
+flowchart TD
+    A["Hangfire Recurring Job\nهر ۵ دقیقه"] --> B["ChatikaJob\nبررسی پیام‌های جدید"]
+    B --> C["ارسال به Chatika API\nPolly retry ×3"]
+    C --> D["دریافت پاسخ\nذخیره در ChatMessages"]
+    D --> E["نمایش در UI باشگاه\nSignalR planned"]
+```
+
+### ۶.۲ فعلی vs آینده
+
+| آیتم | فعلی | آینده |
+|------|-------|-------|
+| ارتباط | Polling (Hangfire) | SignalR real-time |
+| دسترسی | فقط اعضای باشگاه | تعمیم به همه؟ |
+| نوع پیام | متنی | متنی + تصویری |
+
+---
+
+## ۷. Landing Page
+
+### ۷.۱ ساختار
+
+```mermaid
+flowchart TD
+    A["🎨 Hero Section\nانیمیشن fade-in"] --> B["✨ ویژگی‌ها\nFeatures Grid — 3 ستونه"]
+    B --> C["📦 محصولات ویژه\nCarousel"]
+    C --> D["📊 آمار\nCounter animation\nlinear interpolation"]
+    D --> E["🚀 CTA\nثبت‌نام / ورود"]
+```
+
+### ۷.۲ اصلاح انیمیشن Counter
+
+```
+مشکل: اعداد به صورت exponential افزایش پیدا می‌کردند
+راه‌حل: linear interpolation با requestAnimationFrame
+    start → target در ۲ ثانیه، مساوی‌الفاصله
+```
+
+---
+
+## ۸. خلاصه وضعیت
+
+| ماژول | وضعیت | درصد |
+|-------|--------|------|
+| Site Pages (Shopify-style) | ✅ | 100% |
+| بلاگ + Pagination | ✅ | 100% |
+| مدیریت فایل | ✅ | 100% |
+| SMS (Kavenegar) | ✅ | 100% |
+| ایمیل | ⚠️ محدود | 50% |
+| Chatika AI | ✅ | 100% |
+| Landing Page | ✅ | 100% |
+| SystemConstants | ✅ | 100% |
+| SEO Meta Tags | ⬜ | 20% |
@@ -0,0 +1,219 @@
+# آدیت سرویس‌های gRPC — CMS
+
+> تاریخ: ۱۴۰۴/۰۴  
+> آخرین بروزرسانی: ۱۴۰۴/۱۲/۰۶  
+> هدف: شناسایی RPCهایی که از هیچ‌کدام از فرانت‌ها (FrontOffice مشتری + BackOffice ادمین) فراخوانی نمی‌شوند + تصمیم‌گیری نگهداری vs آرشیو
+
+---
+
+## 📊 خلاصه آمار
+
+| متریک | تعداد |
+|--------|-------|
+| کل فایل‌های proto | 43 (بدون google/) |
+| کل سرویس‌های gRPC | 42 |
+| **کل RPC متدها** | **342** |
+| استفاده‌شده در FrontOffice | 92 |
+| استفاده‌شده در BackOffice | 159 |
+| **استفاده‌شده (مجموع یکتا)** | **217** |
+| **استفاده‌نشده از فرانت‌ها** | **125** |
+| ↳ استفاده‌شده داخلی CMS | 101 |
+| ↳ **کد مُرده واقعی** | **24** |
+
+---
+
+## 🔴 بخش ۱ — تحلیل ۲۴ RPC مُرده: نگهداری vs آرشیو
+
+### ✅ نگهداری (آینده‌نگرانه — ۱۲ عدد)
+
+> این RPCها پیاده‌سازی کامل دارند و در نقشه‌راه آینده محصول کاربرد دارند.
+
+| # | RPC | فایل Proto | کیفیت کد | دلیل نگهداری |
+|---|-----|-----------|---------|-------------|
+| 1 | `CustomerReorderPreviousOrder` | userorder.proto | ✅ **کامل** — آیتم‌های سفارش قبلی به سبد اضافه می‌شود | UX حیاتی: «تکرار سفارش قبلی» — فیچر رایج فروشگاهی، فقط نیاز به دکمه در FrontOffice |
+| 2 | `CustomerTrackOrder` | userorder.proto | ✅ **کامل** — وضعیت + TrackingCode + DeliveryInfo | UX حیاتی: «ردیابی سفارش» — وقتی ارسال پستی فعال شود ضروری است |
+| 3 | `CalculateOrderPV` | userorder.proto | ✅ **کامل** — PV هر آیتم + جمع کل | سیستم MLM: محاسبه PV (Point Value) سفارش — برای فاز بعدی کمیسیون بر اساس خرید |
+| 4 | `GetInventorySummary` | inventory.proto | ✅ **کامل** — آمار تعداد + ارزش کل | داشبورد ادمین: خلاصه موجودی انبار — نیاز به کارت در BackOffice Dashboard |
+| 5 | `GetStockValueReport` | inventory.proto | ✅ **کامل** — گزارش ارزش ریالی موجودی | گزارش مالی: ارزش دارایی انبار — برای حسابداری ضروری |
+| 6 | `BulkAddStock` | inventory.proto | ✅ **کامل** — loop با error handling | عملیات انبوه: افزودن موجودی دسته‌ای — بعد از ورود کالای فیزیکی |
+| 7 | `BulkUpdateProductStock` | products.proto | ✅ **کامل** — Set/Add/Subtract با error handling | عملیات انبوه: بروزرسانی دسته‌ای موجودی محصول |
+| 8 | `GetConfigurationByKey` | configuration.proto | ✅ **کامل** — خواندن از SystemConstants | API مفید: دریافت یک تنظیم خاص بدون بارگذاری همه — performance بهتر |
+| 9 | `UpdateCustomerSettings` | user.proto | ✅ **کامل** — Email/SMS/Push notifications | تنظیمات اعلان‌ها: وقتی پنل تنظیمات مشتری ساخته شود |
+| 10 | `ChangeNetworkParent` | networkmembership.proto | ✅ **CQRS کامل** → MoveInNetworkCommand | مدیریت شبکه: جابجایی کاربر در درخت — ابزار ادمین ضروری |
+| 11 | `AssignFeatureToMembership` | clubmembership.proto | ✅ **CQRS کامل** → AssignClubFeatureCommand | مدیریت عضویت: اختصاص فیچر به عضویت — برای فاز بسته‌بندی پویا |
+| 12 | `GetLowStockProducts` | products.proto | ✅ **کامل** — فیلتر threshold + pagination | هشدار موجودی: مکمل GetLowStockItems — فیلتر ClubExclusive اضافه دارد |
+
+### 🗑️ آرشیو (حذف امن — ۱۲ عدد)
+
+> این RPCها یا stub خالی هستند، یا جایگزین بهتری دارند، یا هرگز ساخته نشدند.
+
+| # | RPC | فایل Proto | وضعیت کد | دلیل آرشیو |
+|---|-----|-----------|---------|-----------|
+| 1 | `CreateNewFileInfo` | fms.proto | ❌ **۰ رفرنس** — هیچ Service/Handler ندارد | سرویس FMS هرگز طراحی نشد — فایل‌ها از imageresolver استفاده می‌کنند |
+| 2 | `DeleteFileInfo` | fms.proto | ❌ **۰ رفرنس** — هیچ Service/Handler ندارد | همان — کل fms.proto حذف‌شدنی |
+| 3 | `BulkAdjustStock` | inventory.proto | ❌ **۰ رفرنس** — حتی Service method ندارد | هرگز پیاده‌سازی نشد — از AdjustStock تکی استفاده می‌شود |
+| 4 | `CreateNewOrderForCustomer` | userorder.proto | ❌ **Stub خالی** — `return new()` | مسیر سفارش مشتری از SubmitShopBuyOrder می‌گذرد — تکراری |
+| 5 | `SubmitOrderForCustomer` | userorder.proto | ❌ **Stub خالی** — `return new()` | مسیر سفارش مشتری از SubmitShopBuyOrder می‌گذرد — تکراری |
+| 6 | `DeactivateConfiguration` | configuration.proto | ❌ **throw میکند** — «تنظیمات فقط خواندنی هستند» | عمداً غیرفعال شده — SystemConstants ثابت هستند |
+| 7 | `GetConfigurationHistory` | configuration.proto | ❌ **خالی برمی‌گرداند** — `return new()` | SystemConstants تاریخچه ندارند — بی‌معنی |
+| 8 | `DeleteCity` | City.proto | ✅ کامل ولی **بی‌نیاز** | شهرها seed دیتا هستند — حذف شهر باعث خرابی آدرس‌ها می‌شود |
+| 9 | `UpdateCity` | City.proto | ✅ کامل ولی **بی‌نیاز** | شهرها از سرویس خارجی seed شده‌اند — ویرایش دستی نیاز نیست |
+| 10 | `GetOrdersByDateRange` | userorder.proto | ✅ کامل ولی **تکراری** | `GetAllUserOrderByFilter` همین قابلیت + فیلترهای بیشتر دارد |
+| 11 | `GetServiceHealth` | health.proto | ✅ کامل ولی **تکراری** | `GetSystemHealth` کل سیستم را برمی‌گرداند — فیلتر client-side کافی است |
+| 12 | `GetCategoryByIdForCustomer` | category.proto | ✅ کامل ولی **تکراری** | `GetCategory` (admin) + `GetAllCategoriesForCustomer` کافی است |
+
+---
+
+## 🟡 بخش ۲ — استفاده داخلی CMS (Internal Only — ۱۰۱ عدد)
+
+> این RPCها از فرانت‌ها فراخوانی نمی‌شوند ولی **در کد بکند CMS فعال هستند** (background services, handlers, internal flows). **حذف نشوند!**
+
+### B1. احراز هویت و کاربر (user.proto)
+
+| RPC | رفرنس CMS | علت |
+|-----|-----------|-----|
+| `CreateNewUser` | 175 | ثبت‌نام کاربر — اصلی‌ترین فلو |
+| `GetJwtToken` | 38 | صدور توکن JWT |
+| `AdminGetJwtToken` | 19 | لاگین ادمین |
+| `SetPasswordForUser` | 24 | تنظیم رمز عبور |
+| `ChangeCustomerPassword` | 5 | تغییر رمز مشتری |
+| `UploadCustomerAvatar` | 6 | آپلود آواتار |
+| `GetCustomerProfile` | 13 | پروفایل مشتری |
+| `GetCustomerReferrals` | 13 | لیست معرفی‌شدگان |
+| `GetCustomerSettings` | 13 | تنظیمات مشتری |
+
+### B2. بسته‌ها و پرداخت (package.proto / manualpayment.proto)
+
+| RPC | رفرنس CMS | علت |
+|-----|-----------|-----|
+| `PurchaseGoldenPackage` | 21 | خرید بسته طلایی — فلو فعال |
+| `VerifyGoldenPackagePurchase` | 22 | تأیید خرید بسته طلایی |
+| `CustomerPurchasePackage` | 3 | خرید مشتری (proto-generated + service) |
+| `CustomerVerifyPackagePurchase` | 3 | تأیید خرید مشتری |
+| `GetCustomerPurchaseHistory` | 13 | تاریخچه خرید |
+| `ProcessManualMembershipPayment` | 20 | پرداخت دستی عضویت |
+
+### B3. شبکه و عضویت (networkmembership.proto / clubmembership.proto)
+
+| RPC | رفرنس CMS | علت |
+|-----|-----------|-----|
+| `JoinNetwork` | 14 | پیوستن به شبکه — فراخوانی خودکار |
+| `RemoveFromNetwork` | 14 | حذف از شبکه |
+
+### B4. کمیسیون (commission.proto)
+
+| RPC | رفرنس CMS | علت |
+|-----|-----------|-----|
+| `CalculateWeeklyBalances` | 26 | سرویس پس‌زمینه هفتگی |
+| `CalculateWeeklyCommissionPool` | 22 | سرویس پس‌زمینه هفتگی |
+| `ProcessUserPayouts` | 15 | پردازش پرداخت‌ها |
+| `GetCommissionPayoutHistory` | 20 | تاریخچه پرداخت کمیسیون |
+
+### B5. انبارداری (inventory.proto)
+
+| RPC | رفرنس CMS | علت |
+|-----|-----------|-----|
+| `ConfirmSale` | 10 | تأیید فروش — فلو سفارش |
+| `ReserveStock` | 12 | رزرو موجودی — فلو سفارش |
+| `ReleaseReservation` | 10 | آزادسازی رزرو |
+| `ProcessReturn` | 6 | پردازش مرجوعی |
+| `DeleteWarehouse` | 18 | حذف انبار |
+| `GetInventoryByProduct` | 26 | موجودی بر اساس محصول |
+| `GetInventoryItem` | 19 | آیتم انبار |
+| `GetWarehouse` | 18 | دریافت انبار |
+| `SetDefaultWarehouse` | 18 | تنظیم انبار پیش‌فرض |
+| `UpdateWarehouse` | 18 | بروزرسانی انبار |
+| `GetStockMovementsByInventoryItem` | 17 | حرکات موجودی |
+
+### B6. تراکنش‌ها (transactions.proto)
+
+| RPC | رفرنس CMS | علت |
+|-----|-----------|-----|
+| `CreateNewTransactions` | 26 | ایجاد تراکنش — فلو پرداخت |
+| `DeleteTransactions` | 23 | حذف تراکنش |
+| `GetAllTransactionsByFilter` | 25 | لیست تراکنش‌ها |
+| `CustomerPaymentVerification` | 3 | تأیید پرداخت مشتری |
+| `GetCustomerTransaction` | 27 | تراکنش مشتری |
+| `GetCustomerTransactionsByFilter` | 14 | فیلتر تراکنش‌ها |
+| `RefundTransaction` | 31 | استرداد تراکنش |
+| `UpdateTransactions` | 23 | بروزرسانی تراکنش |
+| `VerifyTransaction` | 24 | تأیید تراکنش |
+
+### B7. سایر CRUD داخلی (خلاصه)
+
+> ۵۸ RPC در فایل‌های contract, usercontract, factordetails, productcategory, productgalleries, productimages, userwallet, userwalletchangelog, otptoken, usercarts, discountproduct, public_messages, category, products, producttag, tag, City, useraddress, userorder — همه CRUD داخلی با ≥3 رفرنس در CMS.
+
+---
+
+## 🟢 بخش ۳ — سرویس‌های کاملاً مورد استفاده
+
+### فایل‌های proto که تمام RPCهایشان استفاده می‌شود:
+
+| فایل Proto | کل RPC | استفاده FO | استفاده BO |
+|-----------|--------|-----------|-----------|
+| appversion.proto | 3 | ✅ 1 | ✅ 3 |
+| blogcategory.proto | 6 | ✅ 2 | ✅ 6 |
+| blogpost.proto | 11 | ✅ 5 | ✅ 9 |
+| blogpostimage.proto | 4 | ✅ 0 | ✅ 4 |
+| discountcategory.proto | 4 | ✅ 1 | ✅ 4 |
+| discountorder.proto | 7 | ✅ 3 | ✅ 4 |
+| discountshoppingcart.proto | 5 | ✅ 5 | ✅ 0 |
+| manualpayment.proto | 5 | ✅ 0 | ✅ 4 |
+| public_messages.proto | 8 | ✅ 0 | ✅ 7 |
+| role.proto | 5 | ✅ 0 | ✅ 5 |
+| sitepage.proto | 10 | ✅ 2 | ✅ 10 |
+| sitepagesettings.proto | 5 | ✅ 1 | ✅ 5 |
+| tag.proto | 6 | ✅ 0 | ✅ 5 |
+| userrole.proto | 5 | ✅ 0 | ✅ 5 |
+
+---
+
+## 📋 بخش ۴ — خلاصه تصمیمات
+
+### ماتریکس نهایی ۲۴ RPC مُرده
+
+```
+✅ نگهداری (12):  CustomerReorderPreviousOrder, CustomerTrackOrder,
+                   CalculateOrderPV, GetInventorySummary, GetStockValueReport,
+                   BulkAddStock, BulkUpdateProductStock, GetConfigurationByKey,
+                   UpdateCustomerSettings, ChangeNetworkParent,
+                   AssignFeatureToMembership, GetLowStockProducts
+
+🗑️ آرشیو (12):   CreateNewFileInfo, DeleteFileInfo, BulkAdjustStock,
+                   CreateNewOrderForCustomer, SubmitOrderForCustomer,
+                   DeactivateConfiguration, GetConfigurationHistory,
+                   DeleteCity, UpdateCity, GetOrdersByDateRange,
+                   GetServiceHealth, GetCategoryByIdForCustomer
+```
+
+### فایل‌های proto آرشیو‌شدنی (کامل)
+
+| فایل | وضعیت | اقدام |
+|------|-------|-------|
+| **fms.proto** | کل فایل مُرده (2 RPC) | حذف از csproj — ساخته نشود |
+
+### RPCهای آرشیو‌شدنی (جزئی — داخل فایل‌های فعال)
+
+| فایل Proto | RPCهای آرشیو | RPCهای فعال |
+|-----------|-------------|-------------|
+| inventory.proto | `BulkAdjustStock` (1) | 23 فعال |
+| userorder.proto | `CreateNewOrderForCustomer`, `SubmitOrderForCustomer` (2) | 18 فعال |
+| configuration.proto | `DeactivateConfiguration`, `GetConfigurationHistory` (2) | 5 فعال |
+| City.proto | `DeleteCity`, `UpdateCity` (2) | 6 فعال |
+| health.proto | `GetServiceHealth` (1) | 1 فعال |
+| category.proto | `GetCategoryByIdForCustomer` (1) | 7 فعال |
+
+---
+
+## ⚠️ نکات مهم
+
+1. **آرشیو ≠ حذف!** — RPCهای آرشیو‌شده با `[Obsolete]` + `#region [ARCHIVED]` علامت‌گذاری شدند (کامیت `13dd0f5`)
+2. RPCهای دسته B (Internal — ۱۰۱ عدد) **حیاتی** هستند — بدون آنها سیستم از کار می‌افتد
+3. RPCهای «نگهداری» (۱۲ عدد) کد **کامل و آماده** دارند — بکلاگ فیچر: [FEATURE-BACKLOG.md](../roadmap/FEATURE-BACKLOG.md)
+4. **fms.proto** از csproj اکسکلود شد (کامیت `13dd0f5`)
+5. نقشه‌راه تحول پکیج‌بیس: [PACKAGE-TRANSFORMATION-TASKS.md](../roadmap/PACKAGE-TRANSFORMATION-TASKS.md)
+6. قبل از هر تغییر، حتماً `grep -rn "RpcName" CMS/src/` بزنید تا مطمئن شوید
+
+---
+
+*آخرین بروزرسانی: ۱۴۰۴/۱۲/۰۶*
@@ -0,0 +1,700 @@
+# 📦 راهنمای مهاجرت سیستم پکیج‌بیس — خلاصه تغییرات و پلن استقرار
+
+> **وضعیت:** آماده تست و استقرار — **Q1-Q30 تکمیل‌شده ✅ | F1-F11 تکمیل‌شده ✅**  
+> **تاریخ:** ۸ اسفند ۱۴۰۴ (27 Feb 2026) — آپدیت ۱۰ اسفند  
+> **نسخه NuGet:** v0.0.189  
+> **تعداد کامیت‌ها:** ۵۱+ کامیت در ۴ ریپازیتوری (۲۱ CMS + ۹ FO + ۷ BO + ۱۴+ docs)  
+> **مدت پیاده‌سازی:** ۶ روز (۲۴ فوریه – ۱ مارس ۲۰۲۶)  
+> **ریپوها:** CMS (`gitea`/`kub-stage`) · FrontOffice (`kub-stage`) · BackOffice (`kub-stage`) · totalDoc (`foursatDocs`/`main`)
+
+---
+
+## فهرست مطالب
+
+1. [خلاصه اجرایی](#1-خلاصه-اجرایی)
+2. [چه چیزی تغییر کرده؟ — نمای بیزینسی](#2-چه-چیزی-تغییر-کرده--نمای-بیزینسی)
+3. [بخش‌های تحت تاثیر سیستم](#3-بخشهای-تحت-تاثیر-سیستم)
+4. [جزئیات تغییرات هر ریپو](#4-جزئیات-تغییرات-هر-ریپو)
+5. [پلن مهاجرت مرحله‌به‌مرحله](#5-پلن-مهاجرت-مرحلهبهمرحله)
+6. [Rollback Plan](#6-rollback-plan)
+7. [چک‌لیست تست قبل از Production](#7-چکلیست-تست-قبل-از-production)
+8. [ریسک‌ها و نکات بحرانی](#8-ریسکها-و-نکات-بحرانی)
+
+---
+
+## 1. خلاصه اجرایی
+
+### قبل (سیستم تک‌پکیج):
+- فقط **یک پکیج پایه** (۵۶ میلیون تومان) وجود داشت
+- تمام مقادیر مالی (قیمت، هزینه فعال‌سازی، ضرایب، سقف‌ها) **hardcoded** در کد بودند
+- خرید مجدد پکیج **غیرممکن** بود (حتی بعد تکمیل چرخه)
+- پورسانت فقط از **یک Pool واحد** محاسبه می‌شد
+- همه کاربران **همه فیچرها** را دریافت می‌کردند
+
+### بعد (سیستم چندپکیجی):
+- سیستم **N پکیج** با قیمت و ویژگی‌های متفاوت پشتیبانی می‌کند
+- تمام مقادیر مالی از **دیتابیس (Package entity)** خوانده می‌شوند
+- خرید مجدد بعد تکمیل چرخه Magic Wallet **فعال** شده
+- هر پکیج **Commission Pool مستقل** خود را دارد
+- فیچرها **per-package** هستند و با الگوریتم **DIFF** مدیریت می‌شوند
+- قرارداد باشگاه **فقط یک بار** (اولین خرید) امضا می‌شود
+
+### آمار تغییرات:
+
+| شاخص | مقدار |
+|-------|-------|
+| فایل‌های تغییریافته | **۲۲۷+ فایل** |
+| خطوط اضافه‌شده | **+۱۷,۰۰۰+** |
+| خطوط حذف‌شده | **−۲,۶۶۰+** |
+| تصمیمات بیزینسی پیاده‌شده | **۳۰ تصمیم** (Q1–Q30) |
+| باگ‌های فیکس‌شده | **۶ باگ بحرانی** |
+| مقادیر hardcoded حذف‌شده | **۱۵+ مورد** |
+| Handlerهای deprecated حذف‌شده | **۴ handler** (۱۲ فایل) |
+| RPCهای deprecated حذف‌شده | **۴ RPC** + ۸ message type |
+| فایل‌های rename شده | **۳۴ فایل** + ۱۱ دایرکتوری (UserWalletChangeLog → UserWalletHistory) |
+| History Tables جدید | **۳ جدول** (PackageHistories, ClubMembershipCycleHistories, UserWalletHistories) |
+
+---
+
+## 2. چه چیزی تغییر کرده؟ — نمای بیزینسی
+
+### 2.1 🏪 مدل فروش پکیج
+
+| قابلیت | قبل | بعد |
+|--------|-----|------|
+| تعداد پکیج | ۱ (پایه ۵۶M) | **N پکیج** (پایه ۵۶M + نقره‌ای ۵.۶M + ...) |
+| قیمت‌گذاری | hardcoded `56_000_000` | از `Package.Price` در دیتابیس |
+| هزینه فعال‌سازی | hardcoded `25_200_000` | از `Package.ActivationFee` |
+| ضریب تخفیف | hardcoded `× 2` | از `Package.DiscountMultiplier` |
+| پشتیبانی دایا | فقط پکیج پایه | بر اساس `Package.SupportsDayaPurchase` |
+| پرداخت مستقیم | همه | بر اساس `Package.SupportsDirectPurchase` |
+
+### 2.2 🔄 چرخه خرید مجدد (Re-Purchase)
+
+| مرحله | قبل | بعد |
+|-------|-----|------|
+| تکمیل چرخه Magic | کاربر در بن‌بست | `PackagePurchaseMethod = None` ریست می‌شود |
+| خرید مجدد | **مسدود** (guard G1-G3) | **مجاز** — بعد تکمیل چرخه Magic |
+| قرارداد باشگاه | هر بار | **فقط یک بار** — خرید مجدد Skip (Q19) |
+| فیچرها | همه فیچرها بدون توجه به پکیج | **DIFF/تفاضل** — فقط اختلاف اعمال می‌شود (Q20) |
+| تاریخچه | فقط `ActivatedAt` | `FirstActivationDate` + `LastActivationDate` (Q21) |
+
+### 2.3 💰 پورسانت و تعادل‌ها
+
+| ویژگی | قبل | بعد |
+|-------|-----|------|
+| Commission Pool | ۱ Pool واحد | **Pool جداگانه هر پکیج** |
+| تعادل هفتگی | ۱ رکورد per user/week | **N رکورد** per user/week/package |
+| MaxBalancesPerLeg | hardcoded `300` | per-package (پایه=۳۰۰, نقره‌ای=۳۰) |
+| MaxNetworkLevel | hardcoded `15` | per-package از دیتابیس |
+| Carryover | یک‌پارچه | **per-downline-package** — بر اساس پکیج زیرمجموعه‌ها (تغییر پکیج خود کاربر تاثیری ندارد) |
+| Stored Procedure | پارامترهای ثابت | پارامترهای داینامیک از Package entity |
+| گزارش مشتری | بدون تفکیک | **breakdown per-package** |
+| گزارش ادمین | بدون فیلتر | **فیلتر بر اساس پکیج** |
+
+### 2.4 🪄 کیف پول جادویی (Magic Wallet)
+
+| ویژگی | قبل | بعد |
+|-------|-----|------|
+| ضریب جادویی | hardcoded `× 2.5` | از `Package.MagicWalletMultiplier` |
+| سقف واریز | hardcoded `1,000,000,000` | از `Package.MagicWalletMaxDeposit` |
+| سقف اعتبار | hardcoded `2,500,000,000` | از `Package.MagicWalletMaxCredit` |
+| شرط EXIT | بررسی سقف global | بررسی سقف **per-package** |
+
+### 2.5 📋 فیچرهای باشگاه
+
+| ویژگی | قبل | بعد |
+|-------|-----|------|
+| تخصیص فیچر | `GetAllFeatureIds()` — همه فیچرها | از `Package.PackageFeatures` — per-package |
+| خرید مجدد | — | الگوریتم **DIFF**: مقایسه فیچرهای فعلی با پکیج جدید |
+| مدیریت ادمین | — | ماتریس checkbox پکیج × فیچر در BackOffice |
+
+---
+
+## 3. بخش‌های تحت تاثیر سیستم
+
+### 3.1 نقشه تاثیرگذاری
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                     🏗️ سیستم پکیج‌بیس — Impact Map                      │
+├─────────────────────────────────────────────────────────────────────────┤
+│                                                                         │
+│  ┌─── CMS (Backend) ──────────────────────────────────────────────────┐ │
+│  │                                                                     │ │
+│  │  📦 Domain Layer (Entity تغییرات)                                   │ │
+│  │  ├── Package.cs ← +۱۱ فیلد جدید                                    │ │
+│  │  ├── PackageFeature.cs ← Entity کاملاً جدید                        │ │
+│  │  ├── ClubMembership.cs ← ActivatedAt → ۴ فیلد First/Last           │ │
+│  │  ├── ClubMembershipCycle.cs ← +PackageId                           │ │
+│  │  ├── WeeklyCommissionPool.cs ← +PackageId                          │ │
+│  │  ├── UserCommissionPayout.cs ← +PackageId                          │ │
+│  │  ├── NetworkWeeklyBalance.cs ← +PackageId                          │ │
+│  │  └── SystemConstants.cs ← حذف ۹ ثابت منسوخ                         │ │
+│  │                                                                     │ │
+│  │  ⚙️ Application Layer (Handler تغییرات)                             │ │
+│  │  ├── ActivateClubMembershipCommandHandler ← فیچر DIFF + re-activate│ │
+│  │  ├── AcceptClubMembershipContractCommandHandler ← فیچر DIFF         │ │
+│  │  ├── VerifyPackagePurchaseCommandHandler ← حذف fallback 2.0m       │ │
+│  │  ├── CustomerPurchasePackage/Verify ← Generic purchase flow         │ │
+│  │  ├── ChargeMagicWalletCommandHandler ← سقف per-package             │ │
+│  │  ├── VerifyMagicWalletChargeCommandHandler ← ضریب per-package      │ │
+│  │  ├── UserOrderService (EXIT Magic) ← ریست + سقف per-package        │ │
+│  │  ├── CreateManualPaymentCommandHandler ← ضریب از Package           │ │
+│  │  └── CheckAndProcessDayaLoansCommandHandler ← حذف ID=4            │ │
+│  │                                                                     │ │
+│  │  🔌 Infrastructure Layer                                            │ │
+│  │  ├── sp_CalculateWeeklyBalances ← @PackageId + @Max params         │ │
+│  │  ├── sp_CalculateWeeklyCommissionPool ← @PackageId                 │ │
+│  │  ├── WeeklyCommissionCalculationService ← Loop per-package         │ │
+│  │  ├── OrmCommissionCalculationStrategy ← فیلتر PackageId            │ │
+│  │  └── SpCommissionCalculationStrategy ← پارامترهای داینامیک         │ │
+│  │                                                                     │ │
+│  │  📡 Proto/gRPC Layer                                                │ │
+│  │  ├── package.proto ← ۱۱ فیلد + PackageFeature CRUD                │ │
+│  │  ├── commission.proto ← package_id/title در ۴ model + فیلتر       │ │
+│  │  ├── حذف ۴ RPC deprecated (Golden/Base)                            │ │
+│  │  └── حذف ۸ message type deprecated                                 │ │
+│  │                                                                     │ │
+│  └─────────────────────────────────────────────────────────────────────┘ │
+│                                                                         │
+│  ┌─── FrontOffice (مشتری) ─────────────────────────────────────────────┐│
+│  │  ├── Packages.razor ← کاشی‌های داینامیک (نه hardcoded)              ││
+│  │  ├── PackageDetail.razor ← فیچرها از API (نه ثابت)                  ││
+│  │  ├── Checkout.razor ← پرداخت شرطی (دایا/مستقیم)                    ││
+│  │  ├── MyPackages.razor ← خرید مجدد + پیشرفت Magic                   ││
+│  │  ├── ActivationSection.razor ← قیمت داینامیک (نه ۵۶M hardcoded)     ││
+│  │  ├── ClubMembershipContractDialog ← متن قرارداد داینامیک            ││
+│  │  ├── CommissionDashboard ← فیلتر + ستون پکیج                       ││
+│  │  ├── WeeklyBalancePage ← فیلتر per-package                          ││
+│  │  ├── PaymentCallback ← مهاجرت به Customer* RPCs                     ││
+│  │  └── حذف "پکیج طلایی" hardcoded (۵+ جا)                            ││
+│  └─────────────────────────────────────────────────────────────────────┘│
+│                                                                         │
+│  ┌─── BackOffice (ادمین) ──────────────────────────────────────────────┐│
+│  │  ├── Package CRUD ← +۱۲ فیلد جدید در Create/Update                 ││
+│  │  ├── PackageFeature Matrix ← checkbox فیچرها                        ││
+│  │  ├── ManualPaymentDialog ← حذف ۵۶M hardcoded + Amount editable     ││
+│  │  ├── ChangeParentDialog ← جابجایی در شبکه (جدید)                   ││
+│  │  ├── UserPayouts ← فیلتر + ستون پکیج                               ││
+│  │  ├── BalancesReport ← فیلتر + ستون پکیج                            ││
+│  │  ├── PackageSelect Component ← dropdown قابل استفاده مجدد           ││
+│  │  └── حذف "پکیج طلایی" → "خرید پکیج"                               ││
+│  └─────────────────────────────────────────────────────────────────────┘│
+│                                                                         │
+│  ┌─── Database ────────────────────────────────────────────────────────┐│
+│  │  ├── Packages ← ۱۱ ستون جدید + Seed نقره‌ای                        ││
+│  │  ├── PackageFeatures ← جدول جدید                                    ││
+│  │  ├── ClubMemberships ← ۴ ستون First/Last + حذف ActivatedAt         ││
+│  │  ├── ClubMembershipCycles ← +PackageId                              ││
+│  │  ├── WeeklyCommissionPools ← +PackageId + Unique                    ││
+│  │  ├── UserCommissionPayouts ← +PackageId + Unique                    ││
+│  │  ├── NetworkWeeklyBalances ← +PackageId + Unique                    ││
+│  │  └── EF Migration + Data Backfill                                    ││
+│  └─────────────────────────────────────────────────────────────────────┘│
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+### 3.2 خلاصه آماری per-repo
+
+| ریپو | کامیت | فایل | اضافه | حذف | شرح اصلی |
+|-------|-------|------|-------|-----|-----------|
+| **CMS** | ۲۰ | ۱۷۹+ | +۱۳,۵۸۶ | −۲,۳۲۷ | Domain + Business + Commission + Proto + History + Rename + Interceptor |
+| **FrontOffice** | ۸ | ۲۹ | +۵۵۰ | −۱۳۶ | Dynamic UI + Customer RPCs + Per-package Reports + UI Guidance |
+| **BackOffice** | ۶ | ۲۴ | +۵۸۰ | −۳۱ | Package CRUD + Feature Matrix + Per-package Reports + UI Guidance |
+| **totalDoc** | ۱۴ | ۱۳ | +۲,۷۰۰ | −۱۹۴ | مستندات بیزینسی + تکنیکال + Phase 9 |
+
+---
+
+## 4. جزئیات تغییرات هر ریپو
+
+### 4.1 CMS — ۲۰ کامیت
+
+| فاز | کامیت | شرح |
+|-----|--------|------|
+| **Phase 0** | `8b9c317` | فیکس ۴ باگ بحرانی: DiscountBalance + UserPackagePurchase |
+| **Phase 0** | `fe3edd1` | فیکس EXIT Magic Mode — ریست PackagePurchaseMethod + بستن چرخه |
+| **Phase 1** | `ae92ab8` | زیرساخت Domain: Package +۱۱ فیلد، PackageFeature entity، FKهای جدید |
+| **Phase 1.5** | `a9cd2fd` | EF Migration + Seed Data + Data Backfill |
+| **Phase 2** | `8e5c7c5` | جایگزینی همه SystemConstants با Package entity reads |
+| **Phase 3** | `ccb938e` | بازسازی لایه Package + Proto enhancement + باگ‌فیکس |
+| **Phase 4** | `0002a5a` | CRUD DTOs + Legacy fixes |
+| **Phase 5** | `607f791` | پورسانت per-package + حذف ref طلایی |
+| **SP Fix** | `7176fe4` | فیکس SP: `cm.PackageId` → `cm.LastPackageId` |
+| **Phase 6** | `d19c569` | Deprecation cleanup + ConfigurationService MagicWallet |
+| **Phase 7a** | `469d97b` | Cosmetic cleanup + حذف orphan handler |
+| **Phase 7b** | `161f796` | Embed orderId در callback URL |
+| **Phase 7c** | `8446e0e` | حذف ۴ handler deprecated (۱۴ فایل، −۱,۱۲۵ خط) |
+| **Phase 8b** | `ce8e248` | NuGet bump → 0.0.185 |
+| **Phase 8d** | `7554d70` | حذف ۴ RPC + ۸ message deprecated از Proto |
+| **Phase 8e** | `aaaf7fc` | Per-package filtering در Commission queries |
+| **Phase 8f** | `dcd1135` | PackageFeature CRUD support |
+| **Audit** | `1ac2366` | Compliance audit — Feature DIFF + حذف fallbackهای hardcoded |
+| **Phase 9a** | `a1024a3` | Q24: آستانه موجودی `≤1M` ریال + Q26: SP Worker auto-deploy (IHostedService + checksum) |
+| **Phase 9b** | `fdbb91d` | Q27: PackageHistory + ClubMembershipCycleHistory entities + enums + EF configs |
+| **Phase 9d** | `10d2ca2` | Rename UserWalletChangeLog→UserWalletHistory (86 فایل) + IHasHistory + Interceptor + Migration |
+
+### 4.2 FrontOffice — ۸ کامیت
+
+| فاز | کامیت | شرح |
+|-----|--------|------|
+| **Phase 7a** | `b82cac4` | حذف "پکیج طلایی" + PackageTitle در DTO |
+| **Phase 7b** | `71f391a` | مهاجرت به Customer* RPCs |
+| **Phase 8a** | `0bbc11e` | Checkout wire-up به Customer RPCs |
+| **Phase 8c** | `d71d463` | صفحات پکیج — فیچرهای داینامیک |
+| **Phase 8d** | `40882c8` | NuGet bump Proto cleanup |
+| **Phase 8e** | `a956cb9` | Per-package filtering در Commission pages |
+| **Phase 8f** | `3bffc13` | T4.2+T4.3+F3: پرداخت شرطی + خرید مجدد + PV |
+| **Audit** | `816dcb7` | حذف ۵۶M hardcoded — قیمت‌گذاری داینامیک |
+| **Phase 9c** | `474d364` | Q28: UI Guidance alerts (G1-G7) — ۷ صفحه MudAlert آموزشی |
+
+### 4.3 BackOffice — ۶ کامیت
+
+| فاز | کامیت | شرح |
+|-----|--------|------|
+| **Phase 7a** | `f1b0085` | تغییر label "پکیج طلایی" → "خرید پکیج" |
+| **Phase 8b** | `89f5241` | Package CRUD expansion — ۱۲ فیلد جدید |
+| **Phase 8d** | `c96377a` | NuGet bump Proto cleanup |
+| **Phase 8e** | `8be98ae` | Per-package commission filtering + PackageSelect component |
+| **Phase 8f** | `e020354` | ChangeParentDialog + PackageFeature checkbox matrix |
+| **Audit** | `e6cf90e` | ManualPaymentDialog — حذف ۵۶M + Amount editable |
+| **Phase 9c** | `6939780` | Q28: UI Guidance alerts (G8-G13) — ۶ صفحه MudAlert |
+
+---
+
+## 5. پلن مهاجرت مرحله‌به‌مرحله
+
+### 📋 پیش‌نیازها
+
+- [ ] بکاپ کامل از دیتابیس Production
+- [ ] بکاپ از stateهای Kubernetes (Deployments, ConfigMaps)
+- [ ] اطمینان از دسترسی به Container Registry (تصاویر فعلی)
+- [ ] زمان‌بندی Maintenance Window (ترجیحاً شب یا آخر هفته)
+- [ ] اطلاع‌رسانی به کاربران (در صورت نیاز به downtime)
+
+---
+
+### مرحله ۱ از ۶: بکاپ و آماده‌سازی محیط 🛡️
+
+> ⏱️ تخمین: ۳۰ دقیقه
+
+```
+1.1  بکاپ کامل دیتابیس
+     └── pg_dump -Fc cms_db > cms_backup_pre_package_migration.dump
+
+1.2  بکاپ دیتابیس BO (اگر جداست)
+     └── pg_dump -Fc bo_db > bo_backup_pre_package_migration.dump
+
+1.3  ثبت وضعیت فعلی
+     └── تعداد رکوردها:
+         • ClubMemberships: SELECT COUNT(*) ...
+         • ClubMembershipCycles: SELECT COUNT(*) ...
+         • WeeklyCommissionPools: SELECT COUNT(*) ...
+         • UserCommissionPayouts: SELECT COUNT(*) ...
+         • NetworkWeeklyBalances: SELECT COUNT(*) ...
+         • Packages: SELECT COUNT(*) ...
+
+1.4  ذخیره نسخه فعلی Docker images
+     └── docker tag <current-cms> cms:rollback-point
+     └── docker tag <current-fo> fo:rollback-point
+     └── docker tag <current-bo> bo:rollback-point
+```
+
+**✅ Checkpoint:** بکاپ‌ها ذخیره شده‌اند و قابل restore هستند.
+
+---
+
+### مرحله ۲ از ۶: استقرار CMS (Backend) 🏗️
+
+> ⏱️ تخمین: ۴۵ دقیقه  
+> ⚠️ **ترتیب بحرانی:** CMS باید **اول** deploy شود چون FO و BO به آن وابسته‌اند.
+
+```
+2.1  Build CMS Docker image
+     └── cd CMS/src
+     └── docker build -t cms:package-based .
+
+2.2  اجرای EF Migration
+     └── این migration شامل:
+         • ۱۱ ستون جدید به جدول Packages
+         • جدول جدید PackageFeatures  
+         • ستون PackageId به ۵ جدول (ClubMemberships, Cycles, Pools, Payouts, Balances)
+         • ۴ ستون First/Last به ClubMemberships
+         • Unique Indexها
+
+     ⚠️ Migration خودکار اجرا می‌شود در startup اگر EF auto-migration فعال باشد.
+     ✅ اگر دستی: dotnet ef database update
+
+2.3  Data Backfill — مقداردهی پکیج پایه
+     └── اسکریپت SQL:
+     ┌──────────────────────────────────────────────────────────┐
+     │  -- مشخص کردن ID پکیج پایه                               │
+     │  DO $$                                                    │
+     │  DECLARE base_pkg_id BIGINT;                              │
+     │  BEGIN                                                    │
+     │      SELECT "Id" INTO base_pkg_id                         │
+     │      FROM "CMS"."Packages"                                │
+     │      WHERE "IsBasePackage" = true LIMIT 1;                │
+     │                                                           │
+     │      -- ClubMemberships                                   │
+     │      UPDATE "CMS"."ClubMemberships"                       │
+     │      SET "FirstActivationDate" = "ActivatedAt",           │
+     │          "LastActivationDate" = "ActivatedAt",            │
+     │          "FirstPackageId" = base_pkg_id,                  │
+     │          "LastPackageId" = base_pkg_id                    │
+     │      WHERE "FirstActivationDate" IS NULL;                 │
+     │                                                           │
+     │      -- ClubMembershipCycles                              │
+     │      UPDATE "CMS"."ClubMembershipCycles"                  │
+     │      SET "PackageId" = base_pkg_id                        │
+     │      WHERE "PackageId" IS NULL;                           │
+     │                                                           │
+     │      -- WeeklyCommissionPools                             │
+     │      UPDATE "CMS"."WeeklyCommissionPools"                 │
+     │      SET "PackageId" = base_pkg_id                        │
+     │      WHERE "PackageId" IS NULL;                           │
+     │                                                           │
+     │      -- UserCommissionPayouts                             │
+     │      UPDATE "CMS"."UserCommissionPayouts"                 │
+     │      SET "PackageId" = base_pkg_id                        │
+     │      WHERE "PackageId" IS NULL;                           │
+     │                                                           │
+     │      -- NetworkWeeklyBalances                             │
+     │      UPDATE "CMS"."NetworkWeeklyBalances"                 │
+     │      SET "PackageId" = base_pkg_id                        │
+     │      WHERE "PackageId" IS NULL;                           │
+     │                                                           │
+     │      RAISE NOTICE 'Migration done: PackageId=%',          │
+     │          base_pkg_id;                                     │
+     │  END $$;                                                  │
+     └──────────────────────────────────────────────────────────┘
+
+2.4  Verification — بررسی migration
+     ┌──────────────────────────────────────────────────────────┐
+     │  SELECT 'ClubMemberships' AS tbl, COUNT(*)               │
+     │  FROM "CMS"."ClubMemberships"                            │
+     │  WHERE "LastPackageId" IS NULL                            │
+     │  UNION ALL                                                │
+     │  SELECT 'Cycles', COUNT(*)                                │
+     │  FROM "CMS"."ClubMembershipCycles"                       │
+     │  WHERE "PackageId" IS NULL                                │
+     │  UNION ALL                                                │
+     │  SELECT 'Pools', COUNT(*)                                 │
+     │  FROM "CMS"."WeeklyCommissionPools"                      │
+     │  WHERE "PackageId" IS NULL                                │
+     │  UNION ALL                                                │
+     │  SELECT 'Payouts', COUNT(*)                               │
+     │  FROM "CMS"."UserCommissionPayouts"                      │
+     │  WHERE "PackageId" IS NULL                                │
+     │  UNION ALL                                                │
+     │  SELECT 'Balances', COUNT(*)                              │
+     │  FROM "CMS"."NetworkWeeklyBalances"                      │
+     │  WHERE "PackageId" IS NULL;                               │
+     │                                                           │
+     │  -- ✅ همه باید 0 باشند!                                  │
+     └──────────────────────────────────────────────────────────┘
+
+2.5  Seed پکیج نقره‌ای (اگر توسط EF Seed انجام نشده)
+     └── INSERT پکیج نقره‌ای + PackageFeatures
+
+2.5b اجرای Migration دوم: Q27_HistoryTables_And_RenameWalletHistory
+     └── این migration شامل:
+         • RenameTable: UserWalletChangeLogs → UserWalletHistories (حفظ داده‌ها!)
+         • RenameIndex × 2 + sp_rename PK + FK × 2
+         • CreateTable: PackageHistories (فیلدهای Old*/New*)
+         • CreateTable: ClubMembershipCycleHistories (فیلدهای Old*/New*)
+     ⚠️ داده‌های قبلی UserWalletChangeLogs حفظ می‌شوند (RenameTable نه DropTable)
+
+2.6  Deploy CMS به Kubernetes
+     └── kubectl set image deployment/cms cms=cms:package-based
+     └── kubectl rollout status deployment/cms
+
+2.7  Health Check
+     └── curl http://cms-service/health
+     └── بررسی لاگ‌ها: kubectl logs deployment/cms --tail=100
+```
+
+**✅ Checkpoint:** CMS جدید بالا آمده، migration اجرا شده، همه رکوردها PackageId دارند.
+
+---
+
+### مرحله ۳ از ۶: استقرار FrontOffice 🖥️
+
+> ⏱️ تخمین: ۲۰ دقیقه  
+> پیش‌نیاز: CMS باید بالا و سالم باشد
+
+```
+3.1  Build FrontOffice Docker image
+     └── cd FrontOffice/src
+     └── docker build -t fo:package-based .
+
+3.2  Deploy به Kubernetes
+     └── kubectl set image deployment/frontoffice fo=fo:package-based
+     └── kubectl rollout status deployment/frontoffice
+
+3.3  Smoke Test
+     └── ✅ صفحه پکیج‌ها باز می‌شود (کاشی‌های داینامیک)
+     └── ✅ جزئیات پکیج — فیچرها نمایش داده می‌شود
+     └── ✅ صفحه پاداش‌ها — فیلتر پکیج کار می‌کند
+     └── ✅ صفحه تعادل‌ها — per-package نمایش داده می‌شود
+     └── ✅ متن قرارداد — مبلغ داینامیک (نه ۵۶M hardcoded)
+```
+
+**✅ Checkpoint:** FrontOffice جدید بالا آمده و صفحات اصلی کار می‌کنند.
+
+---
+
+### مرحله ۴ از ۶: استقرار BackOffice 🛠️
+
+> ⏱️ تخمین: ۲۰ دقیقه  
+> پیش‌نیاز: CMS باید بالا و سالم باشد
+
+```
+4.1  Build BackOffice Docker image
+     └── cd BackOffice/src
+     └── docker build -t bo:package-based .
+
+4.2  Deploy به Kubernetes
+     └── kubectl set image deployment/backoffice bo=bo:package-based
+     └── kubectl rollout status deployment/backoffice
+
+4.3  Smoke Test
+     └── ✅ CRUD پکیج — ۱۲ فیلد جدید نمایش داده می‌شود
+     └── ✅ ماتریس فیچر — checkboxها load می‌شوند
+     └── ✅ گزارش تعادل‌ها — فیلتر پکیج کار می‌کند
+     └── ✅ گزارش پرداخت‌ها — ستون پکیج نمایش داده می‌شود
+     └── ✅ ManualPayment — مبلغ editable (نه ۵۶M disabled)
+```
+
+**✅ Checkpoint:** BackOffice جدید بالا آمده و CRUD + گزارشات کار می‌کنند.
+
+---
+
+### مرحله ۵ از ۶: بررسی پورسانت (بحرانی!) 💰
+
+> ⏱️ تخمین: ۳۰ دقیقه  
+> ⚠️ پورسانت = پول واقعی — دقت مضاعف لازم است
+
+```
+5.1  بررسی SP پارامترها
+     └── محاسبه پورسانت هفته تستی (staging)
+     └── بررسی: هر پکیج Pool جداگانه دارد
+     └── بررسی: MaxBalancesPerLeg صحیح (پایه=۳۰۰, نقره‌ای=۳۰)
+     └── بررسی: MaxNetworkLevel صحیح
+
+5.2  مقایسه نتایج
+     └── اجرای محاسبه در staging
+     └── مقایسه Pool مبلغ با محاسبه دستی
+     └── ✅ تفاوت < ۱% قابل قبول
+
+5.3  بررسی carryover
+     └── ✅ carryover فقط per-package
+     └── ✅ تغییر پکیج → ریست carryover
+```
+
+**✅ Checkpoint:** محاسبات پورسانت per-package صحیح هستند.
+
+---
+
+### مرحله ۶ از ۶: تنظیمات نهایی و بررسی سلامت ✅
+
+> ⏱️ تخمین: ۱۵ دقیقه
+
+```
+6.1  بررسی PackageFeatures seed شده‌اند
+     └── SELECT * FROM "CMS"."PackageFeatures";
+     └── پکیج پایه: همه فیچرها ✅
+     └── پکیج نقره‌ای: فیچرهای تعیین‌شده ✅
+
+6.2  بررسی JWT Claims (اختیاری)
+     └── لاگین یک کاربر تست → decode JWT
+     └── ✅ PackageId وجود دارد
+     └── ✅ CanRepurchase صحیح
+
+6.3  غیرفعال کردن Maintenance Mode (اگر فعال بود)
+
+6.4  مانیتورینگ ۲۴ ساعته
+     └── بررسی لاگ خطاها
+     └── بررسی response timeها
+     └── بررسی پرداخت‌های جدید
+```
+
+**✅ مهاجرت تکمیل شد!**
+
+---
+
+## 6. Rollback Plan
+
+### سناریو ۱: مشکل در Migration دیتابیس
+
+```bash
+# Restore از بکاپ
+pg_restore -d cms_db cms_backup_pre_package_migration.dump
+
+# Rollback CMS image
+kubectl set image deployment/cms cms=cms:rollback-point
+```
+
+### سناریو ۲: مشکل در CMS (بعد Migration موفق)
+
+```bash
+# ⚠️ نکته: migration undo ممکن نیست (ستون‌های جدید اضافه شده‌اند)
+# اما کد قدیمی با ستون‌های nullable مشکلی ندارد
+
+# Rollback فقط CMS image
+kubectl set image deployment/cms cms=cms:rollback-point
+```
+
+### سناریو ۳: مشکل در FO/BO
+
+```bash
+# FO و BO مستقل از هم هستند — هرکدام جداگانه rollback
+kubectl set image deployment/frontoffice fo=fo:rollback-point
+kubectl set image deployment/backoffice bo=bo:rollback-point
+```
+
+### نکته مهم Rollback:
+- ستون‌های جدید **nullable** هستند → کد قدیمی بدون مشکل کار می‌کند
+- جدول `PackageFeatures` جدید است → کد قدیمی آن را ignore می‌کند
+- **فقط Data Backfill** غیرقابل‌برگشت است (ولی ضرری ندارد — فقط NULL → مقدار)
+
+---
+
+## 7. چک‌لیست تست قبل از Production
+
+### 🛒 خرید و فعال‌سازی
+
+| # | تست | روش | نتیجه مورد انتظار |
+|---|------|------|-------------------|
+| 1 | خرید پکیج نقره‌ای (ZarinPal) | از FO → پکیج‌ها → نقره‌ای → پرداخت | Balance = ۵.۶M, Discount = ۱۱.۲M |
+| 2 | خرید پکیج پایه (ZarinPal) | از FO → پکیج‌ها → پایه → پرداخت | Balance = ۵۶M, Discount = ۱۱۲M |
+| 3 | خرید پکیج پایه (Daya Loan) | از FO → پکیج‌ها → پایه → دایا | Balance = ۵۶M + loan created |
+| 4 | پرداخت دستی (BO) | از BO → ManualPayment → مبلغ دلخواه | Amount editable, not hardcoded |
+| 5 | فعال‌سازی با نقره‌ای | فعال‌سازی باشگاه بعد خرید نقره‌ای | فقط فیچرهای نقره‌ای فعال (نه همه) |
+| 6 | فعال‌سازی با پایه | فعال‌سازی باشگاه بعد خرید پایه | همه فیچرها فعال |
+
+### 🔄 چرخه Magic + خرید مجدد
+
+| # | تست | نتیجه مورد انتظار |
+|---|------|-------------------|
+| 7 | تکمیل چرخه Magic → ریست | PackagePurchaseMethod = None |
+| 8 | خرید مجدد همان پکیج | بدون قرارداد مجدد، فقط شارژ wallet |
+| 9 | خرید مجدد پکیج متفاوت (پایه → نقره‌ای) | DIFF اجرا: فیچرهای اضافی غیرفعال |
+
+### 💰 پورسانت per-package
+
+| # | تست | نتیجه مورد انتظار |
+|---|------|-------------------|
+| 10 | Pool جداگانه هر پکیج | WeeklyCommissionPool با PackageId متفاوت |
+| 11 | MaxBalancesPerLeg متفاوت | پایه=۳۰۰, نقره‌ای=۳۰ |
+| 12 | Carryover per-downline-package | تغییر پکیج خود کاربر → carryover حفظ (بر اساس زیرمجموعه‌ها) |
+| 13 | SP پارامترها از Package | بدون hardcoded ۳۰۰/۱۵ |
+
+### 📊 گزارشات per-package
+
+| # | تست | نتیجه مورد انتظار |
+|---|------|-------------------|
+| 14 | FO — فیلتر dropdown پکیج | فیلتر عملکرد صحیح |
+| 15 | FO — breakdown پاداش per-package | مبالغ صحیح به تفکیک |
+| 16 | BO — فیلتر پکیج در تعادل‌ها | فیلتر عملکرد صحیح |
+| 17 | BO — ستون پکیج در پرداخت‌ها | نام پکیج نمایش داده می‌شود |
+
+### 📋 UI / قرارداد
+
+| # | تست | نتیجه مورد انتظار |
+|---|------|-------------------|
+| 18 | متن قرارداد — مبلغ داینامیک | مبلغ و نام پکیج صحیح (نه ۵۶M hardcoded) |
+| 19 | ActivationSection — قیمت | از API خوانده می‌شود |
+| 20 | BO — ManualPayment editable | مبلغ قابل ویرایش با validation |
+| 21 | BO — Package CRUD ۱۲ فیلد | همه فیلدهای جدید ذخیره/بارگذاری |
+| 22 | BO — Feature Matrix | checkboxها sync با DB |
+
+---
+
+## 8. ریسک‌ها و نکات بحرانی
+
+### 🔴 ریسک‌های بحرانی
+
+| # | ریسک | احتمال | تاثیر | کاهش‌دهنده |
+|---|-------|--------|-------|------------|
+| R1 | Migration دیتابیس — PackageId اشتباه | کم | **فاجعه** | Verification query (مرحله 2.4) + بکاپ |
+| R2 | SP تغییریافته → محاسبات مالی اشتباه | متوسط | **فاجعه** | تست staging + مقایسه دستی |
+| R3 | Magic Wallet EXIT — سقف global به‌جای per-package | متوسط | **بالا** | بررسی MW1-MW3 در CMS handlers |
+| R4 | قرارداد حقوقی — مبلغ اشتباه | کم | **حقوقی** | متن قرارداد داینامیک ✅ فیکس شده |
+
+### 🟡 ریسک‌های متوسط
+
+| # | ریسک | کاهش‌دهنده |
+|---|-------|------------|
+| R5 | Proto breaking change | Field numberها backward compatible (فقط اضافه) |
+| R6 | NuGet version mismatch بین repos | همه روی v0.0.189 ✅ |
+| R7 | JWT claims — cache invalidation | کاربران باید re-login کنند |
+| R8 | ~~Validator hardcoded 1B~~ | ✅ فیکس شد — `SystemConstants.WalletMaxSafeAmount` (10B) حصار ایمنی |
+
+### ⚠️ تغییرات آینده (هنوز پیاده‌نشده — Phase بعدی)
+
+این موارد در BIZ spec شناسایی شده‌اند ولی **هنوز پیاده نشده‌اند**:
+
+| # | مورد | شدت | شرح |
+|---|------|------|------|
+| ~~F1~~ | ~~WalletChangeLog + PackageId~~ | ✅ انجام‌شده | CMS:`e5bc3a9` — PackageId در UserWalletHistory |
+| ~~F2~~ | ~~Notification + PackageId~~ | ✅ انجام‌شده | CMS:`61b7e4f` — SmsTemplates+IUserNotificationService+UserNotificationService با packageName |
+| ~~F3~~ | ~~Background Services + PackageId~~ | ✅ بررسی‌شده | بدون تغییر — هر ۳ worker از قبل per-package صحیح کار می‌کنند |
+| ~~F4~~ | ~~CSV exports + ستون پکیج~~ | ✅ انجام‌شده | CMS:`61b7e4f` BO:`92c9922` — proto+handler+CSV برای ManualPayments/WithdrawalRequests |
+| ~~F5~~ | ~~SystemConfiguration per-package~~ | ✅ بررسی‌شده | بدون تغییر — مقادیر per-package قبلاً به Package entity منتقل شده‌اند |
+| ~~F6~~ | ~~MagicWalletChargePage hardcoded~~ | ✅ انجام‌شده | CMS:`61b7e4f` FO:`ecc4f44` — magic_multiplier+magic_max_credit از API، داشبورد "شارژ چند‌برابری" |
+| ~~F7~~ | ~~Validators async per-package~~ | ✅ انجام‌شده | CMS:`61b7e4f` FO:`ecc4f44` — SystemConstants.WalletMaxSafeAmount (10B) حصار ایمنی، سقف واقعی per-package در هندلر |
+| ~~F8~~ | ~~آستانه موجودی ورود به Magic (Q24)~~ | ✅ انجام‌شده | CMS:`a1024a3` — `Balance <= 1_000_000` |
+| ~~F9~~ | ~~SP Worker — مدیریت خودکار SP (Q26)~~ | ✅ انجام‌شده | CMS:`a1024a3` — `StoredProcedureDeploymentService` |
+| ~~F10~~ | ~~History Tables — یکسان‌سازی + خودکار (Q27)~~ | ✅ انجام‌شده | CMS:`fdbb91d`+`10d2ca2` — IHasHistory + Interceptor + RenameTable migration |
+| ~~F11~~ | ~~UI Guidance — آموزش و هشدار (Q28)~~ | ✅ انجام‌شده | FO:`474d364` BO:`6939780` — ۱۳ صفحه MudAlert |
+
+> ✅ **F1-F11 همه پیاده‌سازی شدند.**
+
+---
+
+## ضمیمه: ۳۰ تصمیم بیزینسی (Q1–Q30)
+
+### پیاده‌شده (Q1–Q23):
+
+| # | تصمیم | وضعیت |
+|---|-------|-------|
+| Q1 | باگ DiscountBalance → فیکس | ✅ `8b9c317` |
+| Q2 | ادغام ۳ مسیر پرداخت → Generic | ✅ `ccb938e` + `8446e0e` |
+| Q3 | پکیج نقره‌ای + پایه — داینامیک | ✅ `ae92ab8` + `a9cd2fd` |
+| Q4 | ActivationFee یک فیلد (حذف GiftValue) | ✅ `ae92ab8` |
+| Q5 | DiscountMultiplier داینامیک | ✅ `8e5c7c5` |
+| Q6 | Migration کاربران فعلی → پکیج پایه | ✅ `a9cd2fd` |
+| Q7 | خرید N بار بعد تکمیل چرخه | ✅ `fe3edd1` + `8e5c7c5` |
+| Q8 | Commission Pool جدا per-package | ✅ `607f791` |
+| Q9 | MagicWallet Multiplier داینامیک | ✅ `8e5c7c5` |
+| Q10 | دایا = پکیج پایه (نه طلایی) | ✅ `ccb938e` |
+| Q11 | فیچرها داینامیک per-package | ✅ `dcd1135` |
+| Q12 | MaxBalancesPerLeg per-package | ✅ `607f791` |
+| Q13 | MaxNetworkLevel per-package | ✅ `607f791` |
+| Q14 | MagicWalletMaxDeposit per-package | ✅ `ae92ab8` |
+| Q15 | MagicWalletMaxCredit per-package | ✅ `ae92ab8` |
+| Q16 | NetworkWeeklyBalance + PackageId | ✅ `ae92ab8` |
+| Q17 | گزارش FO breakdown per-package | ✅ `a956cb9` |
+| Q18 | گزارش BO فیلتر per-package | ✅ `8be98ae` |
+| Q19 | قرارداد فقط یک بار | ✅ `1ac2366` |
+| Q20 | فیچر DIFF/تفاضل | ✅ `1ac2366` |
+| Q21 | First/Last ActivationDate | ✅ `ae92ab8` |
+| Q22 | تشخیص هفته از LastActivationDate | ✅ `607f791` |
+| Q23 | Carryover strictly per-package | ✅ `607f791` |
+
+### تصمیمات v6 (Q24–Q30) — ✅ تکمیل‌شده:
+
+| # | تصمیم | وضعیت | کامیت |
+|---|-------|-------|-------|
+| Q24 | آستانه موجودی ≤ ۱,۰۰۰,۰۰۰ ریال (ورود Magic + خرید مجدد) | ✅ | CMS:`a1024a3` |
+| Q25 | DayaLoans فقط پکیج پایه — تایید (بدون تغییر کد) | ✅ تایید | — |
+| Q26 | SP Worker — auto-deploy با checksum (IHostedService) | ✅ | CMS:`a1024a3` |
+| Q27 | History Tables — PackageHistory + CycleHistory + IHasHistory + Interceptor + Rename UserWalletChangeLog→UserWalletHistory | ✅ | CMS:`fdbb91d`+`10d2ca2` |
+| Q28 | UI Guidance — ۱۳ صفحه MudAlert آموزشی/هشداری در FO/BO | ✅ | FO:`474d364` BO:`6939780` |
+| Q29 | شرط EXIT Magic — تایید: آخرین پکیج فعال (بدون تغییر کد) | ✅ تایید | — |
+| Q30 | Carryover — تایید: توضیح مستند شد (بدون تغییر کد) | ✅ تایید | — |
+
+---
+
+*آخرین بروزرسانی: ۱۰ اسفند ۱۴۰۴ — v7: F1-F7 همه تکمیل‌شده ✅ | ۵۱+ کامیت (۲۱ CMS + ۹ FO + ۷ BO + ۱۴+ docs) | NuGet v0.0.189 | Notifications+PackageName, CSV ستون پکیج, Dynamic MagicWallet, SystemConstants validators*
@@ -0,0 +1,356 @@
+# گزارش ممیزی صحت داده‌های دیتابیس CMS
+
+**تاریخ بررسی:** 1405/01/28 (2026-04-17)  
+**فایل بکاپ:** `dbbkup/CMS-20260417.sql` (4.9MB, 21,397 خط)  
+**تعداد جداول:** ~47 جدول | **تعداد کاربران:** 115 | **تعداد سفارشات:** 72
+
+---
+
+## فهرست مطالب
+
+1. [خلاصه اجرایی](#خلاصه-اجرایی)
+2. [اصلاحیه مهم — PaymentStatus](#اصلاحیه-مهم)
+3. [دسته ۱ — ورود دستی / مهاجرت دیتا](#دسته-۱--ورود-دستی--مهاجرت-دیتا)
+4. [دسته ۲ — باگ‌های کد](#دسته-۲--باگهای-کد)
+5. [دسته ۳ — وضعیت Stored Procedure‌ها](#دسته-۳--وضعیت-stored-procedureها)
+6. [آمار کلی جداول](#آمار-کلی-جداول)
+7. [خلاصه مالی](#خلاصه-مالی)
+8. [اقدامات پیشنهادی](#اقدامات-پیشنهادی)
+
+---
+
+## خلاصه اجرایی
+
+بکاپ دیتابیس CMS در تاریخ 17 آوریل 2026 تحلیل شد. تحلیل شامل بررسی صحت داده‌ها، ارجاعات خارجی (FK)، زنجیره مالی، و تطبیق با کد سورس C# و Stored Procedure‌ها بود.
+
+**وضعیت کلی:** سیستم در حال مهاجرت از ساختار استاتیک به پکیج‌محور بوده. بخش عمده مشکلات ناشی از ورود دستی داده و مهاجرت سیستم دایا است. چند باگ کد نیز در SP کمیسیون و Worker دایا شناسایی شد.
+
+---
+
+## اصلاحیه مهم
+
+> **`PaymentStatus=0` در enum کد یعنی `Success` نه `Pending`!**
+> 
+> ```csharp
+> // PaymentStatus.cs
+> Success = 0,
+> Reject = 1,
+> Pending = 2
+> ```
+> 
+> بنابراین تمام 72 سفارش واقعاً **موفق** هستند. این مشکل نیست.
+
+---
+
+## دسته ۱ — ورود دستی / مهاجرت دیتا
+
+### 1A) موجودی 56M بدون فلگ `HasReceivedDayaCredit`
+
+**شدت:** 🟠 متوسط  
+**علت:** ورود دستی / مهاجرت  
+
+- **23 کاربر** دقیقاً 56,000,000 ریال در `Balance` دارند ولی `HasReceivedDayaCredit = 0`
+- فقط **16 کاربر** از طریق Daya Worker صحیح اعتبار گرفتند (`HasReceivedDayaCredit = 1`)
+- بقیه احتمالاً دستی شارژ شدند بدون ثبت تاریخچه
+
+**کاربران آسیب‌پذیر:**
+
+| UserId | نام | Balance | HasReceivedDayaCredit |
+|--------|-----|---------|----------------------|
+| 51 | مرتضی اینالو | 56,000,000 | 0 |
+| 58 | وحید حق‌گو | 56,000,000 | 0 |
+| 87 | امیررضا محمدی | 56,000,000 | 0 |
+| 43 | کریم خادمی | 56,000,000 | 0 |
+| 52 | حمیدرضا اسمعیلی | 56,000,000 | 0 |
+| 88 | کریم رعیت‌پیشه | 56,000,000 | 0 |
+| 91 | رحیم رعیت‌پیشه | 56,000,000 | 0 |
+| 93 | ریحانه سادات هاشمی‌نصر | 56,000,000 | 0 |
+| 99 | هستی خادمی | 56,000,000 | 0 |
+| 110 | علی وفائی | 56,000,000 | 0 |
+| 113 | کاوس بیگ‌اینالو | 56,000,000 | 0 |
+| 119 | علیرضا کریمی‌پیروز | 56,000,000 | 0 |
+| 122 | ابوالقاسم عابدی | 56,000,000 | 0 |
+| 123 | ناصر کریمی‌پیروز | 56,000,000 | 0 |
+| 124 | محمدرضا باغجری | 56,000,000 | 0 |
+| 126 | امیرعباس میرزایی | 56,000,000 | 0 |
+| 138 | سیما اکبرزاده | 56,000,000 | 0 |
+| 139 | مسعود توسلیان | 56,000,000 | 0 |
+| 142 | صغری شبانکاره | 56,000,000 | 0 |
+| 170 | لیلا خدارحمی | 56,000,000 | 0 |
+| 172 | مهرافشان زاهدنیا | 56,000,000 | 0 |
+| 175 | ناهید حسن‌زاده | 56,000,000 | 0 |
+| 176 | مهریدخت میکانیکی | 56,000,000 | 0 |
+
+---
+
+### 1B) کد ملی تکراری — اکانت‌های تستی
+
+**شدت:** 🟡 پایین  
+**علت:** ورود دستی / تست  
+
+| کد ملی | تعداد اکانت | UserIdها | نام |
+|--------|------------|----------|-----|
+| مشترک #1 | 6 | 9, 11, 12, 13, 40, 41 | مهدی مرجانی |
+| مشترک #2 | 3 | 7, 8, 10 | مهدی صیفی |
+| مشترک #3 | 2 | 42, 43 | کریم خادمی |
+| مشترک #4 | 2 | 50, 51 | مرتضی اینالو |
+| مشترک #5 | 2 | 120, 190 | عسلی |
+
+- شماره موبایل تکراری: `09038888074` بین کاربران 120 و 190
+
+---
+
+### 1C) `NetworkInfos` خالی — مهاجرت صحیح انجام شده
+
+**شدت:** ✅ مشکل نیست  
+
+جدول `NetworkInfos` خالی است چون داده‌های شبکه به فیلدهای مستقیم `Users` مهاجرت شدند:
+- `Users.NetworkParentId` ← FK به والد شبکه
+- `Users.LegPosition` ← Left(0) / Right(1)
+
+مهاجرت در `20250601_MigrateParentIdToNetworkParentId.sql` انجام شده. entity `NetworkInfo` در C# وجود ندارد. SP‌ها هم از `Users.NetworkParentId` استفاده می‌کنند.
+
+---
+
+### 1D) `PasswordHash = NULL` برای تمام 115 کاربر
+
+**شدت:** 🟡 نیاز به بررسی  
+**علت:** احتمالاً بکاپ شامل فیلد پسورد نشده، یا سیستم OTP/موبایل استفاده می‌کند  
+
+---
+
+### 1E) دوره‌های عضویت باشگاه — `PaidAmount = 0`
+
+**شدت:** 🟡 نیاز به بررسی  
+
+- 87 دوره `ClubMembershipCycles` همه `PaidAmount = 0`
+- ممکن است عضویت باشگاه خودکار با خرید پکیج فعال شود (نه پرداخت جداگانه)
+
+---
+
+## دسته ۲ — باگ‌های کد
+
+### 2A) تراکنش‌های تکراری دایا — Race Condition در `CheckAndProcessDayaLoansCommandHandler`
+
+**شدت:** 🔴 بحرانی  
+**فایل:** `CMSMicroservice.Application/DayaLoanCQ/Commands/CheckAndProcessDayaLoans/CheckAndProcessDayaLoansCommandHandler.cs`  
+
+**یافته‌ها:**
+- **109 رکورد `DayaLoanContracts`** ولی فقط **16 کاربر** `HasReceivedDayaCredit=1`
+- **64 تراکنش** با «دریافت اعتبار دایا» ساخته شده ولی فقط **11 رکورد `UserPackagePurchases`**
+- تراکنش‌ها با `RefId` منحصربه‌فرد ساخته شدند (مثل `C4_T8579002`) — همه در `2025-11-19 01:24:24` ایجاد شدند
+
+**تحلیل ریشه‌ای:**
+- Daya Worker (Hangfire هر 15 دقیقه) احتمالاً برای بعضی کاربران **چند بار** اجرا شده
+- `CreateTransaction` و `DayaLoanContract` ساخته شده ولی `HasReceivedDayaCredit=true` ست نشده (exception بعد از SaveChanges اول ولی قبل از SaveChanges دوم)
+- یا: چون همه در یک لحظه ساخته شدند (`2025-11-19 01:24:24`)، ممکن است **یک بار bulk import دستی** بوده
+
+**ریسک:** کاربرانی که `HasReceivedDayaCredit=0` دارند ممکن است **دوباره** از Worker اعتبار بگیرند.
+
+---
+
+### 2B) SP `sp_CalculateWeeklyCommissionPool` — `DistributedAmount` آپدیت نمی‌شود
+
+**شدت:** 🔴 بحرانی  
+**فایل:** `dbbkup/CMS-20260417.sql` خط ~18830  
+
+در Step 10 (آپدیت نهایی Pool):
+
+```sql
+-- کد فعلی (باگ‌دار):
+UPDATE CMS.WeeklyCommissionPools 
+SET 
+    IsCalculated = 1, 
+    CalculatedAt = @CalculatedAt,
+    TotalBalances = @TotalBalances,
+    ValuePerBalance = @ValuePerBalance,
+    LastModified = @CalculatedAt,
+    LastModifiedBy = 'SP'
+WHERE Id = @PoolId;
+```
+
+**مشکل:** فیلد `DistributedAmount` **هرگز مقداردهی نمی‌شود** و 0 باقی می‌ماند.
+
+**نتیجه در دیتا:**
+- 15 استخر، مجموع `TotalPoolAmount = 2,016,000,000` ریال
+- همه `DistributedAmount = 0`
+- ولی 46 پرداخت واقعاً ثبت و به `NetworkBalance` اضافه شدند
+
+---
+
+### 2C) `UserWalletChangeLogs` خالی
+
+**شدت:** 🟠 متوسط  
+**فایل:** SP Step 9 + `CalculateWeeklyCommissionPoolCommandHandler.cs`  
+
+- SP باید در Step 9 لاگ تغییرات کیف‌پول را در `UserWalletChangeLogs` ذخیره کند
+- جدول **صفر رکورد** دارد
+- **احتمال 1:** SP هرگز Step 9 را درست اجرا نکرده
+- **احتمال 2:** ORM Strategy (نه SP) استفاده شده و آن `UserWalletChangeLogs` نمی‌نویسد
+- **احتمال 3:** لاگ‌ها در حین ForceRecalculate حذف شدند
+
+---
+
+### 2D) `WalletHistory.ChangeType = NULL` در تمام 239 رکورد
+
+**شدت:** 🟠 متوسط  
+**فایل:** `UserOrderService.cs` و `PackageService.cs` — هرجا `UserWalletHistory` ساخته می‌شود  
+
+- فیلد `ChangeType` هرگز ست نمی‌شود
+- کد از `IsIncrease` (bool) برای تفکیک واریز/برداشت استفاده می‌کند
+- `ChangeType` احتمالاً فیلد قدیمی deprecated شده
+
+---
+
+### 2E) `NetworkWeeklyBalances.WeeklyCommissionPoolId = NULL` (805 رکورد)
+
+**شدت:** 🟡 پایین  
+
+- SP مقدار `WeeklyPoolContribution = 0` ثبت می‌کند و PoolId ست نمی‌شود
+- ارتباط بین `NetworkWeeklyBalances` و `WeeklyCommissionPools` از طریق `WeekDefinitionId` برقرار است، نه FK مستقیم
+- **عملاً مشکل عملکردی ایجاد نمی‌کند** ولی tracking سخت‌تر می‌شود
+
+---
+
+### 2F) 30 سفارش کیف‌پولی — بررسی WalletHistory
+
+**شدت:** 🟠 نیاز به تأیید  
+
+- 30 سفارش با `PaymentMethod=1` (Wallet) ثبت شدند
+- اولین بررسی نشان داد «هیچ برداشتی ثبت نشده» — **اما** این بررسی بر اساس `ChangeType` بود که همه NULL هستند
+- **باید بر اساس `IsIncrease=0` (false = decrease)** دوباره بررسی شود
+- `SubmitShopBuyOrder()` در کد `UserWalletHistory` می‌سازد — احتمالاً رکوردها وجود دارند ولی `ChangeType` NULL است
+
+---
+
+## دسته ۳ — وضعیت Stored Procedure‌ها
+
+### `GetNetworkTree`
+
+| آیتم | وضعیت |
+|------|--------|
+| از `Users.NetworkParentId` استفاده می‌کند | ✅ صحیح (بعد از مهاجرت) |
+| JOIN با `ClubMemberships` | ✅ صحیح |
+| `MAXRECURSION 0` | ✅ صحیح |
+| فیلتر `IsDeleted = 0` | ✅ صحیح |
+
+### `sp_CalculateWeeklyBalances`
+
+| آیتم | وضعیت |
+|------|--------|
+| پارامتر `@PackageId` از `Packages.IsBasePackage` | ✅ صحیح |
+| `MaxBalancesPerLeg` و `MaxNetworkLevel` از Package | ✅ صحیح |
+| Carryover از هفته قبل | ✅ صحیح |
+| CTE recursive برای چپ/راست | ✅ صحیح |
+| `TotalBalances = MIN(left, right)` | ✅ صحیح |
+| `SubordinateBalances` محاسبه | ✅ صحیح |
+| 805 رکورد تولید شده | ✅ کار می‌کند |
+
+### `sp_CalculateWeeklyCommissionPool`
+
+| آیتم | وضعیت |
+|------|--------|
+| `ValuePerBalance = TotalPoolAmount / TotalBalances` | ✅ صحیح |
+| ایجاد `UserCommissionPayouts` | ✅ صحیح (46 رکورد) |
+| ثبت `CommissionPayoutHistories` | ✅ صحیح |
+| شارژ `NetworkBalance` کیف‌پول | ✅ صحیح |
+| آپدیت `DistributedAmount` در Pool | ❌ **انجام نمی‌شود** |
+| ثبت `UserWalletChangeLogs` | ⚠️ نامشخص |
+| ForceRecalculate — Revert | ✅ منطق صحیح |
+
+---
+
+## آمار کلی جداول
+
+| جدول | تعداد | وضعیت |
+|------|--------|--------|
+| Users | 115 | |
+| UserWallets | 115 | |
+| UserWalletHistories | 239 | ChangeType همه NULL |
+| UserWalletChangeLogs | 0 | ⚠️ خالی |
+| UserOrders | 72 | همه PaymentStatus=0 (Success) |
+| FactorDetails | 177 | |
+| Transactions | 175 | 64 تراکنش دایا |
+| PaymentTransactions | 22 | فقط DiscountOrders + شارژ |
+| Products | 163 | |
+| Categories | 14 | |
+| InventoryItems | 175 | |
+| StockMovements | 242 | 11 chain issue |
+| ClubMemberships | 88 | همه IsActive=1 |
+| ClubMembershipCycles | 87 | همه PaidAmount=0 |
+| UserClubFeatures | 249 | |
+| NetworkInfos | 0 | ✅ deprecated — مهاجرت شده |
+| NetworkWeeklyBalances | 805 | PoolId همه NULL |
+| WeeklyCommissionPools | 15 | DistributedAmount همه 0 |
+| UserCommissionPayouts | 46 | Status=3, مبالغ کلان |
+| WeekDefinitions | 59 | |
+| Packages | 2 | Base=56M, Secondary=5.6M |
+| DayaLoanContracts | 109 | |
+| UserPackagePurchases | 11 | |
+| DiscountOrders | 13 | |
+| DiscountOrderDetails | 14 | |
+| DiscountCategories | 8 | |
+| OrderVATs | 44 | ✅ محاسبات صحیح |
+| UserAddresses | 127 | |
+| Roles | 3 | user, admin, Administrator |
+| UserRoles | 119 | 115 user + 2 admin + 2 Administrator |
+| ProductImages | 4 | |
+| ShippingMethods | 0 | ⚠️ خالی |
+| SitePages | 0 | ⚠️ خالی |
+| SystemConfigurations | 0 | ⚠️ خالی |
+| Coupons | 0 | ⚠️ خالی |
+| ProductProperties | 0 | ⚠️ خالی |
+
+---
+
+## خلاصه مالی
+
+### موجودی‌های کل سیستم
+
+| فیلد | مبلغ (ریال) |
+|------|-------------|
+| مجموع `Balance` کل کیف‌پول‌ها | 2,548,684,394 |
+| مجموع `NetworkBalance` (کمیسیون) | 453,599,993 |
+| مجموع `DiscountBalance` (تخفیف) | 7,326,400,000 |
+| مجموع سفارشات (UserOrders) | 1,039,410,812 |
+| مجموع استخر کمیسیون (WeeklyPools) | 2,016,000,000 |
+
+### پکیج‌ها
+
+| Package | قیمت | IsBase | MaxBalancesPerLeg | MaxNetworkLevel | DiscountMultiplier |
+|---------|-------|--------|-------------------|-----------------|-------------------|
+| Package 1 | 56,000,000 | ✅ | 300 | 1,000,000 | 2.0 |
+| Package 4 | 5,600,000 | ❌ | 30 | 1,000,000 | 2.0 |
+
+### ارجاعات شکسته (FK)
+
+| ارجاع | تعداد |
+|-------|--------|
+| FactorDetails → OrderId ناموجود | 2 (DetailId=22,23 → OrderId=21) |
+| InventoryItems ≠ آخرین StockMovement | 3 |
+| StockMovement chain breaks | 11 |
+
+---
+
+## اقدامات پیشنهادی
+
+### اولویت بالا (انجام ندهید تا بررسی بیشتر)
+
+1. **فیکس SP `sp_CalculateWeeklyCommissionPool`:** اضافه کردن `DistributedAmount` به UPDATE نهایی
+2. **بررسی Daya Worker:** race condition در `CheckAndProcessDayaLoansCommandHandler` — ممکن است تراکنش تکراری بسازد
+3. **23 کاربر با 56M بدون فلگ دایا:** تعیین اینکه آیا دستی شارژ شدند یا از Worker — سپس اصلاح `HasReceivedDayaCredit`
+
+### اولویت متوسط
+
+4. **WalletHistory ChangeType:** تأیید اینکه deprecated شده و `IsIncrease` جایگزین است
+5. **UserWalletChangeLogs خالی:** بررسی اینکه ORM Strategy استفاده شده یا SP Strategy
+6. **اکانت‌های تکراری:** تصمیم‌گیری درباره 13 اکانت تکراری (حذف/ادغام)
+
+### اولویت پایین
+
+7. **جداول خالی:** SystemConfigurations, ShippingMethods, SitePages — آیا باید از seed پر شوند؟
+8. **StockMovement chain issues:** 11 ناسازگاری — آیا از ورود دستی موجودی بوده؟
+
+---
+
+*این گزارش فقط مستندات یافته‌ها است. هیچ تغییری در کد یا دیتابیس اعمال نشده است.*
@@ -0,0 +1,249 @@
+# 📊 فلوچارت‌ها و دیاگرام‌های کلان
+
+> **دید بالا (Big Picture): فلوی کاربر، مالی، داده و کیف‌پول جادویی**  
+> **آخرین بروزرسانی:** اسفند ۱۴۰۴ (بروزرسانی: Magic Wallet + VAT 10%)
+
+---
+
+## ۱. فلوی کلان کاربر (User Journey)
+
+```mermaid
+flowchart TD
+    A["🌐 ورود به سایت"] --> B{"آیا ثبت‌نام کرده؟"}
+    B -->|خیر| C["Landing Page"]
+    C --> D["ثبت‌نام\nموبایل + OTP"]
+    D --> E["پروفایل"]
+    E --> F
+
+    B -->|بله| G["Login + JWT"]
+    G --> H{"عضو باشگاه؟"}
+    H -->|خیر| F["🛒 Regular Store\nخرید عادی — پرداخت از کیف‌پول"]
+    H -->|بله| I["🏆 Club Member Dashboard"]
+
+    I --> J["فروشگاه اعتباری\nper-product MaxDiscount%"]
+    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خرید مجدد پکیج"]
+```
+
+---
+
+## ۲. فلوی مالی (Financial Flow)
+
+```mermaid
+flowchart TD
+    subgraph INPUT["═══ ورودی پول ═══"]
+        Z1["ZarinPal IPG"]
+        Z2["Daya Loan"]
+        Z3["Manual Pay"]
+    end
+
+    Z1 --> PYMS["PYMS Service"]
+    Z2 --> PYMS
+    Z3 --> PYMS
+    PYMS --> TX[("DB Transaction")]
+
+    TX --> W1 & W2 & W3
+
+    subgraph WALLETS["═══ توزیع به کیف‌پول‌ها ═══"]
+        W1["💰 Balance — نقدی\n• IPG: +56M\n• Daya: +56M\n• فعالسازی: −25.2M\n• خرید فروشگاه"]
+        W2["🌟 NetworkBalance — طلایی\n• شارژ نمی‌شود\n• فقط محاسبه کمیسیون\n• سقف 300/هفته"]
+        W3["🏷️ DiscountBalance — اعتباری\n• IPG: +112M\n• Daya: +112M\n• per-product MaxDiscount%"]
+    end
+
+    W1 & W2 --> POOL
+
+    subgraph POOL["═══ Weekly Commission Pool ═══"]
+        P1["هر فعالسازی → 25.2M واریز به Pool"]
+        P2["sp_CalculateWeeklyBalances"]
+        P3["sp_CalculateWeeklyCommissionPool"]
+        P4["UserShare = UserBalance / TotalBalance"]
+        P5["Cap: MAX 300 per leg per week"]
+        P1 --> P2 --> P3 --> P4 --> P5
+    end
+```
+
+---
+
+## ۳. فلوی داده (Data Flow)
+
+```mermaid
+flowchart TD
+    CLIENT["🌐 Browser / Client"] -->|HTTPS| NGINX["nginx / K8s Ingress"]
+
+    NGINX -->|"/"| FO["FrontOffice :5003\nBlazor Server"]
+    NGINX -->|"/admin"| BO["BackOffice :5002\nBlazor WASM"]
+    NGINX -->|"/hangfire"| CMS
+
+    FO -->|gRPC| CMS["CMS Microservice :5001"]
+    BO -->|gRPC| CMS
+
+    CMS --> MEDIATR["MediatR\nCommands / Queries → Handlers"]
+    CMS --> HF["Hangfire\n• DayaLoan — */20 min\n• Commission — Sunday 00:05\n• Chatika — */5 min"]
+    CMS --> EXT["External Services\n• ZarinPal API\n• Kavenegar API\n• DayaLoan API\n• Chatika API"]
+
+    MEDIATR --> EF["EF Core 9"]
+    HF --> EF
+    EF --> DB[("SQL Server 2022\nSchema: CMS\n~15 tables + 3 SPs")]
+```
+
+---
+
+## ۴. درخت باینری شبکه (Network Tree)
+
+```mermaid
+graph TD
+    ROOT["🔵 Root — Admin"]
+    ROOT --- A["👤 User A\nL=120 | R=80"]
+    ROOT --- B["👤 User B\nL=0 | R=150"]
+
+    A --- C["✅ User C\nActive"]
+    A --- D["✅ User D\nActive"]
+    B --- E["⏳ User E\nPending"]
+    B --- F["✅ User F\nActive"]
+
+    style ROOT fill:#1976D2,color:#fff
+    style C fill:#4CAF50,color:#fff
+    style D fill:#4CAF50,color:#fff
+    style E fill:#FF9800,color:#fff
+    style F fill:#4CAF50,color:#fff
+```
+
+> **راهنما:**
+> - `L` / `R` = فروش پای چپ / راست این هفته
+> - **Active** = فعال (قرارداد امضا شده) — **Pending** = در انتظار فعالسازی
+> - شبکه روی entity `User` مدل شده (`NetworkParentId`, `LegPosition`)
+> - محاسبه کمیسیون تا عمق ۱۵ سطح — درخت بدون محدودیت عمق
+
+---
+
+## ۵. فلوی خرید — Regular vs Discount Store
+
+### ۵.۱ Regular Store
+
+```mermaid
+flowchart TD
+    A1["مشاهده محصولات"] --> B1["Lazy Load — 12 per page"]
+    B1 --> C1["افزودن به سبد"]
+    C1 --> D1["بررسی موجودی"]
+    D1 --> E1["Checkout Summary\nانتخاب آدرس"]
+    E1 --> F1{"Balance کافی؟"}
+    F1 -->|بله| G1["کسر از Balance کیف‌پول\n+ VAT"]
+    G1 --> H1["ثبت سفارش"]
+    H1 --> I1["کسر موجودی"]
+    F1 -->|خیر| J1["❌ خطا: موجودی کیف‌پول کافی نیست"]
+```
+
+### ۵.۲ Discount Store
+
+```mermaid
+flowchart TD
+    A2["مشاهده محصولات\nفقط اعضای باشگاه"] --> B2["Lazy Load — 12 per page"]
+    B2 --> C2["افزودن به سبد"]
+    C2 --> D2["بررسی موجودی + DiscountBalance"]
+    D2 --> E2["محاسبه سهم تخفیف\nMaxDiscount% هر محصول"]
+    E2 --> F2["محاسبه باقیمانده\ngatewayAmount = total - discountUsed"]
+    F2 --> G2{"gatewayAmount > 0?"}
+    G2 -->|بله| H2["کسر DiscountBalance\n+ ZarinPal IPG برای باقیمانده + 10% VAT"]
+    H2 --> I2["Redirect → ZarinPal\nCallback → ثبت سفارش"]
+    G2 -->|خیر| J2["فقط کسر از DiscountBalance\nبدون درگاه"]
+    J2 --> K2["ثبت سفارش"]
+    I2 --> L2["کسر موجودی + SMS تأیید"]
+    K2 --> L2
+```
+
+---
+
+## ۶. معماری Deployment
+
+```mermaid
+flowchart TD
+    subgraph SERVER["🖥️ Production Server — 45.149.79.127"]
+        NGINX["nginx\n:80 / :443"]
+        subgraph K8S["☸ Kubernetes Cluster"]
+            CMS["CMS ×2\n:5001 gRPC"]
+            FO["FrontOffice ×2\n:5003 Blazor Server"]
+            BO["BackOffice ×1\n:5002 Static"]
+            DB[("SQL Server\n:1433")]
+            NEXUS["Nexus\n:8081"]
+            HF["Hangfire\ninside CMS"]
+        end
+    end
+
+    NGINX --> CMS
+    NGINX --> FO
+    NGINX --> BO
+    CMS --> DB
+    CMS --> HF
+
+    style SERVER fill:#f5f5f5,stroke:#333
+    style K8S fill:#e3f2fd,stroke:#1976D2
+```
+
+---
+
+## ۷. Entity Relationship (ساده‌شده)
+
+```mermaid
+erDiagram
+    User ||--o{ ClubMembership : has
+    User ||--o| UserWallet : has
+    User ||--o{ UserContract : signs
+    User ||--o{ UserOrder : places
+    User ||--o{ ChatMessage : sends
+    User }o--o| User : "NetworkParentId"
+
+    UserOrder ||--|{ OrderItem : contains
+    OrderItem }o--|| Product : references
+    UserOrder ||--o{ Transaction : has
+
+    Product ||--o| Inventory : has
+    Product }o--|| Category : belongs_to
+    Product ||--o{ ProductImage : has
+
+    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
+        int LegPosition
+    }
+    UserContract {
+        Guid SignGuid
+        string SignedPdfFile
+    }
+```
--- a/Show More
+++ b/Show More