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