# 🎯 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)
