masoodafar-web
136 lines
6.0 KiB
Markdown
136 lines
6.0 KiB
Markdown
# 🎯 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)
|