masoodafar-web
136 lines
4.9 KiB
Markdown
136 lines
4.9 KiB
Markdown
# 📚 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) - همه چیز از اینجا شروع میشود!
|