update

2026-01-03 18:27:49 +03:30
parent 0369292d7f
commit 5965b98728
156 changed files with 16082 additions and 0 deletions
@@ -0,0 +1,135 @@
+# 🎯 FourSat - مرجع سریع (Quick Reference)
+
+> **برای دسترسی فوری به مستندات مهم**  
+> **آخرین بروزرسانی**: ۷ دی ۱۴۰۴
+
+---
+
+## 🆕 آخرین تغییرات
+
+### ۷ دی - SystemConstants + SmsTemplates + Commission System Fixes ✨
+- **SystemConstants**: انتقال مقادیر hardcode (56M) به کلاس مرکزی
+- **SmsTemplates**: متمرکز کردن همه قالب‌های پیامک در یک فایل
+- **Daya Loan SMS**: ارسال پیامک خودکار هنگام تأیید وام دایا
+- **AppVersion UI**: صفحه مدیریت نسخه با قابلیت افزودن جدید
+- **Mapping Fixes**: رفع مشکلات Mapster (Unit→Empty, WeeklyPools, AppVersion)
+- **Commission Status**: انتقال تبدیل Status از BFF به FrontOffice client
+- **ProcessWithdrawal**: رفع خطای "PayoutId invalid"
+- **WeekDisplayName**: نمایش "هفته چهلم" به جای "1404-W40"
+- **Withdrawals Page**: رفع مشکل لود نشدن صفحه
+- **Network Balances**: نمایش نام کاربر + Carryover breakdown با Tooltip
+- **WeekDefinitionId**: رفع مشکل ارسال 0 (Int64Value.Value extraction)
+
+**📄 جزئیات**: [CHANGELOG-2025-12-27.md](CHANGELOG-2025-12-27.md)
+
+### ۶ دی - App Version Management + ReferralCode
+- **App Version**: سیستم کامل مدیریت نسخه اپلیکیشن‌های موبایل
+- **ReferralCode**: نمایش کد معرف در درخت شبکه FrontOffice
+- **BackOffice**: صفحه `/settings/app-versions` با UI کامل
+
+**📄 جزئیات**: [CHANGELOG-2025-12-26.md](CHANGELOG-2025-12-26.md)
+
+### ۵ دی - Chatika + DayaLoan Fix + BackOffice Tree
+- **Chatika**: قابلیت فعال/غیرفعال کردن Worker از Config
+- **DayaLoan**: جلوگیری از استعلام مجدد مشتریان با قرارداد
+- **BackOffice Tree**: بازنویسی کامل با d3-org-chart
+
+**📄 جزئیات**: [CHANGELOG-2025-12-25.md](CHANGELOG-2025-12-25.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 | 98% ✅ | +1% (SmsTemplates, SystemConstants, Balance Fields) |
+| BackOffice.BFF | 100% ✅ | Mapping Fixes (Withdrawals, ProcessWithdrawal) |
+| BackOffice UI | 100% ✅ | AppVersion Complete + BalancesReport Enhanced |
+| FrontOffice.BFF | 65% 🚧 | Status simplify + WeekDefinitionId fix |
+| FrontOffice UI | 78% 🚧 | CommissionService MapStatus + GetStatusColor |
+
+### تغییرات اخیر:
+- ✅ **امروز (۷ دی)**: SystemConstants + SmsTemplates + Commission System Fixes
+- ✅ CMS: `SystemConstants.cs` و `SmsTemplates.cs` اضافه شد
+- ✅ CMS: `GetUserWeeklyBalancesQueryHandler` با فیلدهای جدید (UserFullName, Carryover breakdown)
+- ✅ CMS: `GetAllWeeklyPoolsQueryHandler` با WeekDisplayName صحیح
+- ✅ BackOffice.BFF: اصلاح CommissionProfile (ProcessWithdrawal + Withdrawals mapping)
+- ✅ BackOffice: `BalancesReport.razor` با ستون‌های جدید و MudTooltip
+- ✅ FrontOffice.BFF: `CommissionProfile` رفع WeekDefinitionId mapping
+- ✅ FrontOffice: `CommissionService` با MapStatus و GetStatusColor
+
+---
+
+## 🔍 جستجوی موضوعی
+
+```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/)
+
+---
+
+**تاریخ بروزرسانی**: ۳۰ آذر ۱۴۰۴ (20 دسامبر 2025)