masoodafar-web
002e99f6bf
- Added PersianDateTimeService for converting Gregorian dates to Persian format in the BackOffice frontend. - Updated multiple frontend pages (Dashboard, UserPayouts, WorkerControl, UserNetworkInfo) to utilize the new Persian date service. - Enhanced GetUserNetworkPositionDto with 28+ new fields for comprehensive user network data. - Updated GetUserNetworkPositionQueryHandler to include new methods for calculating network statistics. - Modified Protobuf messages to accommodate the new fields, increasing from 14 to 42. - Refined week number calculation algorithm to ensure consistency across C# and SQL implementations. - Created new CSV and Excel files for binary plan calculations. - Ensured all changes are tested and validated for accuracy and performance.
121 lines
4.6 KiB
Markdown
121 lines
4.6 KiB
Markdown
# 🎯 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)
|