feat: Update changelog and documentation for version 2.7, including Commission Data Flow Fix, UI improvements, and terminology cleanup

04-FRONTEND/FrontOffice/README.md

@@ -2,11 +2,49 @@
 
 > **FrontOffice**: رابط کاربری Blazor Server برای مشتریان نهایی سیستم FourSat
 > 
-> **آخرین بروزرسانی**: ۶ دی ۱۴۰۴ (26 دسامبر 2025)
+> **آخرین بروزرسانی**: ۹ دی ۱۴۰۴ (29 دسامبر 2025)
 
 ---
 
-## 🆕 تغییرات اخیر (۶ دی ۱۴۰۴)
+## 🆕 تغییرات اخیر (۹ دی ۱۴۰۴)
+
+### ✅ Commission Data Flow Fix
+- **مشکل**: صفحه weekly-balance مقادیر carryover را 0 نشان می‌داد
+- **حل**: استفاده از مقادیر واقعی سرور به جای محاسبه محلی
+- **فایل‌ها**:
+  - `CommissionService.cs` - استفاده از `balance.LeftLegCarryover`
+  - `CommissionDtos.cs` - Properties جدید carryover و new_members
+
+### ✅ WeekSelector Autocomplete
+- **کامپوننت**: `MudAutocomplete` برای انتخاب هفته
+- **قابلیت**: جستجو در لیست هفته‌ها
+- **صفحه**: `CommissionDashboardPage.razor`
+
+### ✅ Responsive UI Improvements
+- **MudGrid**: استفاده از breakpoints (`xs`, `sm`, `md`)
+- **Summary Stats**: کارت‌های آماری در بالای صفحه
+- **MudHidden**: جدول در دسکتاپ، کارت در موبایل
+
+### ✅ Merged Dashboard & History Pages
+- **قبل**: دو صفحه جداگانه تکراری
+- **بعد**: یک صفحه با dual routing
+- **فایل حذف شده**: `CommissionHistoryPage.razor[.cs]`
+
+### ✅ Terminology Cleanup (MLM-Sensitive Words)
+جایگزینی کلمات حساس:
+| قبلی | جدید |
+|------|------|
+| کمیسیون | پاداش |
+| شبکه‌سازی | تیم‌سازی |
+| مشاهده شبکه | مشاهده تیم |
+| آمار شبکه | آمار تیم |
+| شبکه‌های فروش | تیم‌های فروش |
+
+**فایل‌های تغییر یافته**: WeeklyBalancePage, CommissionDashboardPage, MyPackages, Packages, Index, About, Footer, NetworkStatisticsPage
+
+---
+
+## 🆕 تغییرات قبلی (۶ دی ۱۴۰۴)
 
 ### ✅ نمایش کد معرف در درخت شبکه
 - **کد معرف**: نمایش ReferralCode برای کاربران فعال باشگاه
@@ -80,17 +118,16 @@ FrontOffice/
     │   │   │   ├── MembershipPage.razor
     │   │   │   ├── FeaturesPage.razor
     │   │   │   └── Components/ActivationSection.razor
-    │   │   ├── Network/           # ✅ شبکه (2 صفحه)
+    │   │   ├── Network/           # ✅ تیم (2 صفحه)
     │   │   │   ├── NetworkStatisticsPage.razor
     │   │   │   └── (Tree در Profile است)
-    │   │   └── Commission/        # ✅ کمیسیون (3 صفحه)
-    │   │       ├── CommissionDashboardPage.razor
-    │   │       ├── CommissionHistoryPage.razor
+    │   │   └── Commission/        # ✅ پاداش (2 صفحه)
+    │   │       ├── CommissionDashboardPage.razor  # dual: /dashboard + /history
     │   │       └── WeeklyBalancePage.razor
     │   └── Utilities/             # Services & DTOs
     │       ├── ClubMembershipService.cs        # ⚠️ Mock Data
     │       ├── NetworkMembershipService.cs     # ⚠️ Mock Data
-    │       ├── CommissionService.cs            # ⚠️ Mock Data
+    │       ├── CommissionService.cs            # ✅ Real Data
     │       └── WalletService.cs                # ⚠️ 4 متد کامنت شده
     └── FrontOffice.BFF/           # Backend for Frontend
         ├── FrontOffice.BFF.sln
@@ -170,26 +207,26 @@ FrontOffice/
   - MudChart.Donut برای توزیع
   - کارت آخرین عضو (آواتار، موقعیت، تاریخ)
 
-### 💰 Commission (3 صفحه) - **جدید** ✨
-- ✅ **CommissionDashboardPage.razor**: داشبورد پرداخت‌ها
-  - فیلترهای هفته و وضعیت
+### 💰 Commission (2 صفحه) - **بروزرسانی ۹ دی** ✨
+- ✅ **CommissionDashboardPage.razor**: داشبورد پاداش‌ها (merged با History)
+  - **Dual routing**: `/commission/dashboard` + `/commission/history`
+  - **WeekSelector Autocomplete**: انتخابگر هفته با جستجو
+  - **Summary Stats Cards**: کل پاداش، پرداخت شده، در انتظار، میانگین
   - جدول + نمای موبایل (MudHidden responsive)
   - Pagination با MudPagination
-  - لینک به صفحات تاریخچه و تعادل هفتگی
-  
-- ✅ **CommissionHistoryPage.razor**: تاریخچه کامل پرداخت‌ها
-  - کارت‌های خلاصه (مجموع، تعداد هفته، میانگین)
-  - جدول کامل با FixedHeader
-  - لینک به جزئیات تعادل هر هفته
+  - لینک به صفحه تعادل هفتگی
   
 - ✅ **WeeklyBalancePage.razor**: جزئیات تعادل هفتگی
   - انتخابگر هفته با دکمه "هفته جاری"
-  - کارت‌های تعادل چپ/راست با Progress bar
-  - پنل محاسبات (Min balance, Count, Commission)
+  - کارت‌های تعادل تیم اول/دوم با Progress bar
+  - **Carryover Breakdown**: نمایش اعضای جدید + انتقال از هفته قبل
+  - پنل محاسبات (Min balance, Count, پاداش)
   - هشدار Carryover (اگر باشد)
-  - MudChart.Bar مقایسه چپ/راست/Min
+  - MudChart.Bar مقایسه تیم اول/دوم/Min
   - پشتیبانی Query parameter (?week=45)
 
+- ❌ **CommissionHistoryPage.razor**: حذف شده (merged با Dashboard)
+
 ---
 
 ## 🛠️ Services (8 سرویس)