# 📚 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) - همه چیز از اینجا شروع می‌شود!
