admin/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
002e99f6bfeb70eb970a3c6bff6fc004ac57190a
docs/00-INDEX.md
T
masoodafar-web 002e99f6bf Implement Persian Date Conversion and Enhance User Network Information Service 
- 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.
2025-12-20 06:15:59 +03:30

291 lines
14 KiB
Markdown
Raw Blame History

# 📚 FourSat Project - فهرست جامع مستندات
> **نسخه**: 2.1
> **آخرین بروزرسانی**: ۲۹ آذر ۱۴۰۴ (December 19, 2025)
> **وضعیت**: ✅ تجمیع و بازسازی کامل
---
## 🎯 راهنمای سریع (Quick Navigation)
### برای توسعه‌دهندگان:
- 🚀 **شروع سریع**: [`06-DEPLOYMENT/quick-start.md`](06-DEPLOYMENT/quick-start.md)
- 📋 **کارهای جاری**: [`05-TASKS/CURRENT-SPRINT.md`](05-TASKS/CURRENT-SPRINT.md)
- 🐛 **TODO های کد**: [`04-FRONTEND/FrontOffice/todo-commented-code.md`](04-FRONTEND/FrontOffice/todo-commented-code.md)
### برای معماران:
- 🏗️ **معماری سیستم**: [`02-ARCHITECTURE/`](02-ARCHITECTURE/)
- 📊 **Business Logic**: [`01-BUSINESS/`](01-BUSINESS/)
### برای مدیران:
- ✅ **وضعیت تحویل**: [`06-DEPLOYMENT/delivery-readiness.md`](06-DEPLOYMENT/delivery-readiness.md)
- 📈 **گزارش پیشرفت**: [`03-BACKEND/CMS/implementation-status.md`](03-BACKEND/CMS/implementation-status.md)
---
## 📊 وضعیت کلی پروژه
### Backend Services:
| سرویس | وضعیت | تکمیل | فایل مرجع |
|-------|------|------|-----------|
| **CMS Microservice** | ✅ Production Ready | 95% | [`03-BACKEND/CMS/implementation-status.md`](03-BACKEND/CMS/implementation-status.md) |
| **BackOffice.BFF** | ✅ Production Ready | 100% | [`03-BACKEND/BackOffice.BFF/handlers-status.md`](03-BACKEND/BackOffice.BFF/handlers-status.md) |
| **FrontOffice.BFF** | 🚧 In Progress | 60% | [`03-BACKEND/FrontOffice.BFF/README.md`](03-BACKEND/FrontOffice.BFF/README.md) |
### Frontend Applications:
| اپلیکیشن | وضعیت | تکمیل | فایل مرجع |
|---------|------|------|-----------|
| **BackOffice UI** | ✅ Production Ready | 100% | [`04-FRONTEND/BackOffice/ui-status.md`](04-FRONTEND/BackOffice/ui-status.md) |
| **FrontOffice UI** | 🚧 In Progress | 75% | [`04-FRONTEND/FrontOffice/README.md`](04-FRONTEND/FrontOffice/README.md) |
### آخرین دستاوردها (۱۴ آذر):
- ✅ **FrontOffice UI**: 7 صفحه جدید (Club, Network, Commission)
- ✅ **FrontOffice.BFF**: 3 ماژول جدید (ClubMembership, NetworkMembership, Commission)
- ✅ **Build**: موفق با 0 خطا
- ✅ **Documentation**: بازسازی کامل ساختار
---
## 🗂️ ساختار مستندات
### 📊 01-BUSINESS/ - منطق تجاری
قوانین کسب‌وکار، فرآیندها، و محاسبات مالی:
| فایل | موضوع | خلاصه |
|------|-------|-------|
| [`network-commission-system.md`](01-BUSINESS/network-commission-system.md) | شبکه + کمیسیون | Binary MLM Tree, Flash Out, Weekly Pool |
| [`discount-shop-business.md`](01-BUSINESS/discount-shop-business.md) | فروشگاه تخفیف | محصولات تخفیف‌دار، محدودیت DiscountBalance |
| [`package-purchase-system.md`](01-BUSINESS/package-purchase-system.md) | خرید پکیج طلایی | فعال‌سازی باشگاه، پرداخت 56M |
| [`daya-loan-integration.md`](01-BUSINESS/daya-loan-integration.md) | قرض‌الحسنه دایا | خرید الماس، انتقال NetworkBalance |
| [`balance-calculation-rules.md`](01-BUSINESS/balance-calculation-rules.md) | محاسبه موجودی | Carryover Logic, تعادل‌های باقیمانده |
| [`binary-tree-guide.md`](01-BUSINESS/binary-tree-guide.md) | ثبت‌نام در شبکه | قرارگیری در دست چپ/راست، Placement |
**کاربرد**: تحلیلگران کسب‌وکار، توسعه‌دهندگان Backend، تست‌نویس‌ها
---
### 🏗️ 02-ARCHITECTURE/ - معماری سیستم
**⚠️ در حال توسعه** - فعلاً به اسناد موجود در `CMS/` مراجعه کنید:
- معماری کلی: Clean Architecture (Domain → Application → Infrastructure)
- الگوی BFF: Backend for Frontend
- Microservices: CMS ↔ BFF ↔ UI
**Roadmap**:
- [ ] System Overview Diagram
- [ ] Microservices Communication Flow
- [ ] Database Schema (ERD)
- [ ] Security Architecture
---
### ⚙️ 03-BACKEND/ - Backend Services
#### 📦 CMS Microservice (Core Business Logic)
| فایل | موضوع | خلاصه |
|------|-------|-------|
| [`README.md`](03-BACKEND/CMS/README.md) | نمای کلی CMS | معرفی، تکنولوژی‌ها، Quick Start |
| [`implementation-status.md`](03-BACKEND/CMS/implementation-status.md) | پیشرفت پیاده‌سازی | Phase 1-12، 98% Complete، Daya API ✅ |
| [`entity-guide.md`](03-BACKEND/CMS/entity-guide.md) | راهنمای Entity ها | Domain Entities، Relations، Validations |
| [`commission-system.md`](03-BACKEND/CMS/commission-system.md) | ✨ سیستم کمیسیون | Entities, Proto Models, WeekDefinitionId Migration |
| [`api-coverage.md`](03-BACKEND/CMS/api-coverage.md) | پوشش API | لیست تمام gRPC Services و Handlers |
| [`email-sms-configuration.md`](03-BACKEND/CMS/email-sms-configuration.md) | Email & SMS | Kavenegar, MailKit, Templates |
| [`payment-gateway.md`](03-BACKEND/CMS/payment-gateway.md) | درگاه پرداخت | ZarinPal, Daya Integration |
| [`daya-api-implementation.md`](03-BACKEND/CMS/daya-api-implementation.md) | ✨ Daya API Guide | Complete Real API Implementation (Dec 6) |
| [`club-membership-migration.md`](03-BACKEND/CMS/club-membership-migration.md) | ✨ Migration Scripts | اسکریپت‌های مهاجرت باشگاه مشتریان (Dec 9) |
**Key Stats**:
- **Entities**: 50+ Domain Entities
- **Commands**: 120+ CQRS Commands
- **Queries**: 80+ CQRS Queries
- **gRPC RPCs**: 150+ Remote Procedures
- **Build**: ✅ 0 errors, 287 warnings (pre-existing)
#### 🔌 BackOffice.BFF (Admin Gateway)
| فایل | موضوع | خلاصه |
|------|-------|-------|
| [`README.md`](03-BACKEND/BackOffice.BFF/README.md) | نمای کلی BFF | معماری، Communication با CMS |
| [`handlers-status.md`](03-BACKEND/BackOffice.BFF/handlers-status.md) | وضعیت Handler ها | 35 CQRS Handler، 100% Complete |
| [`cms-integration.md`](03-BACKEND/BackOffice.BFF/cms-integration.md) | یکپارچه‌سازی CMS | Protobuf, gRPC Client Configuration |
| [`discount-shop-integration.md`](03-BACKEND/BackOffice.BFF/discount-shop-integration.md) | ادغام فروشگاه تخفیف | 19 Handler برای مدیریت محصولات تخفیف |
**Key Stats**:
- **Handlers**: 35 CQRS (100% Production Ready)
- **gRPC Clients**: 5 Services
- **Pages Served**: 23 Blazor Pages
#### 🔌 FrontOffice.BFF (User Gateway)
| فایل | موضوع | خلاصه |
|------|-------|-------|
| [`README.md`](03-BACKEND/FrontOffice.BFF/README.md) | نمای کلی BFF | معماری، 12 Handler (9 + 3 new) |
| [`protobuf-mismatch.md`](03-BACKEND/FrontOffice.BFF/protobuf-mismatch.md) | ⚠️ مغایرت Proto | 6 Handler با مشکل، راهکارها |
**Key Stats**:
- **Handlers**: 12 CQRS (60% Complete)
- **New Today**: ClubMembership, NetworkMembership, Commission (3 modules)
- **Blockers**: Protobuf field name mismatches
---
### 🎨 04-FRONTEND/ - Frontend Applications
#### 🖥️ BackOffice (Admin Panel)
| فایل | موضوع | خلاصه |
|------|-------|-------|
| [`README.md`](04-FRONTEND/BackOffice/README.md) | نمای کلی BackOffice | Blazor Server، MudBlazor 8.14.0 |
| [`ui-status.md`](04-FRONTEND/BackOffice/ui-status.md) | وضعیت صفحات | 23 Pages + 8 Dialogs، 100% Complete |
**Pages**: Dashboard, User Management, Order Management, Commission Reports, Network Stats, Club Management, Discount Shop Management, Payment Gateways, Worker Control
#### 👤 FrontOffice (User Portal)
| فایل | موضوع | خلاصه |
|------|-------|-------|
| [`README.md`](04-FRONTEND/FrontOffice/README.md) | نمای کلی FrontOffice | 24 Pages، 75% Complete |
| [`gap-analysis.md`](04-FRONTEND/FrontOffice/gap-analysis.md) | تحلیل Gap | 12 Module، 7 نیاز به API واقعی |
| [`todo-commented-code.md`](04-FRONTEND/FrontOffice/todo-commented-code.md) | ⚠️ TODO های کد | 5 متد WalletService + 3 Mock Service |
| [`progress-report.md`](04-FRONTEND/FrontOffice/progress-report.md) | گزارش پیشرفت امروز | 7 صفحه + 3 سرویس + 3 BFF module |
**New Pages (Today)**:
- **Club**: `ClubInfo.razor`, `ActivateClub.razor`, `ClubFeatures.razor`
- **Network**: `Tree.razor`, `NetworkStats.razor`
- **Commission**: `WeeklyReport.razor`, `PayoutHistory.razor`
**Status**: Mock services → Need real API integration
---
### ✅ 05-TASKS/ - مدیریت وظایف
| فایل | موضوع | خلاصه |
|------|-------|-------|
| [`CURRENT-SPRINT.md`](05-TASKS/CURRENT-SPRINT.md) | اسپرینت جاری | TODO های High/Medium/Low Priority |
| [`BACKLOG.md`](05-TASKS/BACKLOG.md) | Backlog | کارهای آینده، Feature Requests |
| [`verification-template.md`](05-TASKS/verification-template.md) | چک‌لیست QA | تست‌های Business Verification |
**Current Sprint Highlights**:
- 🔥 **High Priority**: FrontOffice UI Integration (7 صفحه)
- 🔥 **High Priority**: Protobuf Mismatch Fixes (3 Handler)
- 🟡 **Medium**: WalletService Implementation (5 متد)
- 🟡 **Medium**: Package Purchase UI (4 صفحه)
---
### 🚀 06-DEPLOYMENT/ - استقرار و عملیات
| فایل | موضوع | خلاصه |
|------|-------|-------|
| [`quick-start.md`](06-DEPLOYMENT/quick-start.md) | راهنمای شروع | Setup محیط توسعه، Build، Run |
| [`delivery-readiness.md`](06-DEPLOYMENT/delivery-readiness.md) | آمادگی تحویل | چک‌لیست Production، Deployment Steps |
**Requirements**:
- .NET 9 SDK
- SQL Server 2019+
- Visual Studio 2022 / Rider
- Node.js (برای Frontend tooling)
---
### 📦 99-ARCHIVE/ - آرشیو اسناد قدیمی
فایل‌های منسوخ شده که دیگر استفاده نمی‌شوند:
| فایل | دلیل آرشیو | جایگزین |
|------|-----------|---------|
| `REMAINING-TASKS-OLD-2024-12-02.md` | منسوخ شده | `05-TASKS/BACKLOG.md` |
| `network-club-commission-system-OLD.md` | نسخه قدیمی | `01-BUSINESS/network-commission-system.md` |
| `implementation-progress-fa-OLD.md` | ترجمه ناقص | `03-BACKEND/CMS/implementation-status.md` |
| `monitoring-alerts-partial-OLD.md` | گزارش ناقص | در CMS موجود |
**راهنما**: [`99-ARCHIVE/ARCHIVE-INDEX.md`](99-ARCHIVE/ARCHIVE-INDEX.md)
---
## 🔍 جستجوی سریع
### موضوعات کلیدی:
| موضوع | فایل‌های مرتبط |
|-------|---------------|
| **باشگاه مشتریان** | `01-BUSINESS/network-commission-system.md`, `03-BACKEND/CMS/implementation-status.md` (Phase 9) |
| **شبکه باینری** | `01-BUSINESS/network-commission-system.md`, `01-BUSINESS/binary-tree-guide.md` |
| **کمیسیون هفتگی** | `01-BUSINESS/network-commission-system.md`, `03-BACKEND/CMS/implementation-status.md` (Phase 4) |
| **فروشگاه تخفیف** | `01-BUSINESS/discount-shop-business.md`, `03-BACKEND/CMS/implementation-status.md` (Phase 9) |
| **خرید پکیج** | `01-BUSINESS/package-purchase-system.md`, `03-BACKEND/CMS/implementation-status.md` (Phase 12) |
| **کیف پول سه‌گانه** | `01-BUSINESS/balance-calculation-rules.md`, `04-FRONTEND/FrontOffice/todo-commented-code.md` |
| **درگاه پرداخت** | `03-BACKEND/CMS/payment-gateway.md`, `01-BUSINESS/daya-loan-integration.md` |
| **Email & SMS** | `03-BACKEND/CMS/email-sms-configuration.md` |
| **gRPC Integration** | `03-BACKEND/BackOffice.BFF/cms-integration.md`, `03-BACKEND/FrontOffice.BFF/protobuf-mismatch.md` |
---
## 📈 آمار کلی مستندات
### قبل از تجمیع:
- **تعداد فایل**: 42 فایل .md
- **حجم کل**: ~33,000 خط
- **ساختار**: پراکنده در پوشه‌های مختلف
### بعد از تجمیع:
- **تعداد فایل فعال**: ~28 فایل
- **تعداد آرشیو شده**: 4 فایل
- **ساختار**: دسته‌بندی شده در 7 پوشه اصلی
- **کاهش تکرار**: ~16%
### پوشش مستندات:
- ✅ **Business Logic**: 6 سند جامع
- ✅ **Backend**: 12 سند (CMS + BFFs)
- ✅ **Frontend**: 7 سند (BackOffice + FrontOffice)
- ✅ **Tasks**: 3 سند (Sprint, Backlog, Verification)
- ✅ **Deployment**: 2 سند (Quick Start, Delivery)
- ⏳ **Architecture**: در حال توسعه
---
## 🤝 مشارکت در مستندات
### به‌روزرسانی مستندات:
1. هر تغییر در کد → بروزرسانی سند مربوطه
2. TODO جدید → افزودن به `05-TASKS/CURRENT-SPRINT.md`
3. Feature جدید → ایجاد سند در پوشه مناسب
4. Bug Critical → ثبت در `CURRENT-SPRINT.md` با Priority 🔥
### قوانین نام‌گذاری:
- استفاده از `kebab-case` برای نام فایل‌ها
- زبان فارسی برای Business Docs
- زبان انگلیسی برای Technical Docs
- Emoji برای دسته‌بندی سریع (✅ 🚧 ⚠️ 🔥)
---
## 📞 پشتیبانی
برای سوالات و مشکلات:
- **مستندات فنی**: Backend Team
- **مستندات Business**: Product Owner
- **مستندات UI/UX**: Frontend Team
---
## 📝 تاریخچه تغییرات
### نسخه 2.0 (۱۴ آذر ۱۴۰۴):
- ✅ بازسازی کامل ساختار مستندات
- ✅ تجمیع اسناد تکراری
- ✅ آرشیو اسناد منسوخ
- ✅ ایجاد CURRENT-SPRINT.md
- ✅ به‌روزرسانی با کارهای امروز (7 صفحه + 3 BFF module)
### نسخه 1.0 (1 دسامبر 2025):
- INDEX.md اولیه با 24 فایل
---
**🎯 این مستندات همواره در حال به‌روزرسانی هستند. آخرین نسخه را از Git دریافت کنید.**
Reference in New Issue View Git Blame Copy Permalink