docs/QUICK-REFERENCE.md

🎯 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

۶ دی - App Version Management + ReferralCode

• App Version: سیستم کامل مدیریت نسخه اپلیکیشن‌های موبایل
• ReferralCode: نمایش کد معرف در درخت شبکه FrontOffice
• BackOffice: صفحه /settings/app-versions با UI کامل

📄 جزئیات: CHANGELOG-2025-12-26.md

۵ دی - Chatika + DayaLoan Fix + BackOffice Tree

• Chatika: قابلیت فعال/غیرفعال کردن Worker از Config
• DayaLoan: جلوگیری از استعلام مجدد مشتریان با قرارداد
• BackOffice Tree: بازنویسی کامل با d3-org-chart

📄 جزئیات: CHANGELOG-2025-12-25.md

---

📚 لینک‌های کلیدی

⭐ ضروری (Must Read):

1. 00-INDEX.md - فهرست کامل (شروع از اینجا)
2. 05-TASKS/CURRENT-SPRINT.md - کارهای جاری
3. README.md - راهنمای کوتاه

🔥 برای Development:

• Setup: 06-DEPLOYMENT/quick-start.md
• سیستم کمیسیون: 03-BACKEND/CMS/commission-system.md ✨
• TODO ها: 04-FRONTEND/FrontOffice/todo-commented-code.md
• Protobuf Issues: 03-BACKEND/FrontOffice.BFF/protobuf-mismatch.md

📊 برای Business:

• شبکه و کمیسیون: 01-BUSINESS/network-commission-system.md
• باشگاه مشتریان: 01-BUSINESS/network-commission-system.md
• فروشگاه تخفیف: 01-BUSINESS/discount-shop-business.md

⚙️ برای Backend:

• CMS Status: 03-BACKEND/CMS/implementation-status.md
• API Coverage: 03-BACKEND/CMS/api-coverage.md
• Entity Guide: 03-BACKEND/CMS/entity-guide.md
• Commission System: 03-BACKEND/CMS/commission-system.md ✨

🎨 برای Frontend:

• BackOffice Status: 04-FRONTEND/BackOffice/ui-status.md
• FrontOffice Gap: 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

---

📊 وضعیت سیستم

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

---

🔍 جستجوی موضوعی

# باشگاه مشتریان
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
• Frontend Issues: 04-FRONTEND/FrontOffice/gap-analysis.md
• Business Questions: 01-BUSINESS/

---

تاریخ بروزرسانی: ۳۰ آذر ۱۴۰۴ (20 دسامبر 2025)