masoodafar-web
11 KiB
11 KiB
📚 FourSat Documentation Index
آخرین بروزرسانی: February 17, 2026
۲۲۰ فایل → ۳۰ فایل (تجمیع ۳ فازی + cleanup نهایی)
آخرین تغییرات: فیکس ZarinPal callback، تخفیف ۱۰۰٪ اجباری، VAT checkout، ExpirePendingOrders، فیکس DeliveryStatus mapping، دیپلوی Production، فیکس CI/CD cross-deploy، ساخت appsettings.Production.json هر ۳ پروژه، فیکس K8S_SERVER، فیکس nginx image path
🔍 راهنمای سریع — کدام مستند را باید ببینم؟
📂 business/ — مستندات بیزنسی (۷ فایل)
| فایل | توضیح |
|---|---|
| club-commission-system-complete.md | 🏆 سیستم جامع کمیسیون باشگاه: کیف پولها، درخت باینری، الگوریتم کمیسیون، توزیع Pool |
| balance-calculation-rules.md | قوانین محاسبه تعادل + فرمولهای Excel + مثالهای ۵ سطحی |
| club-membership-contract-system.md | سیستم قرارداد عضویت: امضا، OTP، رفرش توکن |
| package-purchase-system.md | ۳ سناریو خرید پکیج: وام دایا، پرداخت دستی، درگاه |
| daya-loan-integration.md | یکپارچهسازی وام دایا + جزئیات API + پیادهسازی CMS |
| DISCOUNT-STORE-STATUS.md | 🔄 وضعیت فروشگاه تخفیفی: تخفیف ۱۰۰٪ اجباری + ZarinPal + VAT + ExpirePendingOrders — Production Deploy ✅ |
| discount-shop-business.md | فروشگاه تخفیفی: پرداخت ترکیبی، درصد تخفیف، entity design |
| manual-payment-system.md | پرداخت دستی: کارت به کارت، تأیید ادمین، آپلود FMS |
📂 cms/ — مستندات فنی CMS (۱۵ فایل)
| فایل | توضیح |
|---|---|
| BFF-REMOVAL-PLAN.md | ✅ پلن حذف BFF — Permission Interceptor + تغییرات config |
| REMAINING-TASKS.md | وضعیت ۴۹/۴۹ متد — همه انجام شده ✅ |
| FRONTOFFICE-CMS-API-COMPATIBILITY.md | ماتریس سازگاری API بین FrontOffice و CMS |
| ICURRENTUSERSERVICE-IMPLEMENTATION.md | پترن JWT + ICurrentUserService در endpointهای Customer |
| ADMIN-CUSTOMER-SEPARATION-FIX.md | 🆕 فیکس جداسازی Admin/Customer: حذف JWT fallback از ۸ handler + resolve صریح در ۴ endpoint |
| payment-gateway.md | 🔄 IPaymentGatewayService: ZarinPal مستقیم + تخفیف ۱۰۰٪ اجباری + VAT + ExpirePendingOrders + فیکس DeliveryStatus mapping + دیپلوی Production |
| payment-architecture-pyms.md | معماری PYMS: جریان پرداخت BFF→PYMS→Gateway→CMS |
| chatika-integration.md | یکپارچهسازی Chatika AI: Hangfire worker، retry logic |
| club-feature-management-services.md | CQRS سرویسهای مدیریت ClubFeature |
| INVENTORY-REFACTORING-STATUS.md | ریفکتور Inventory: حذف Repository، ساختار CQ |
| system-constants.md | مرجع SystemConstants.cs (مبالغ، درصدها) |
| email-sms-configuration.md | تنظیمات SMS/Email: Kavenegar templates، Gmail |
| PRODUCT-BUNDLE-FEATURE.md | 🟡 فیچر آینده: طراحی Product Bundle |
| FRONTOFFICE-RELEASE-NOTES-v1.5.0.md | 🆕 یادداشت انتشار FrontOffice v1.5.0 (فارسی): هفتهنما، گزارش هفتگی، امتیاز انتقالی |
| FILE-MANAGEMENT-ARCHITECTURE.md | 🆕 معماری جامع مدیریت فایل: IFileManager, LocalFileManager, ImagePathResolverInterceptor, UploadsController (HTTP سرو عمومی + FMS Fallback), ذخیره دیسکی |
| REGISTRATION-FLOW-FIXES.md | 🆕 فیکس فلوی ثبتنام: ایجاد کاربر جدید در VerifyOtpToken، رفع lookup موبایل AcceptContract، رفع sync IsCompleteRegister |
📂 deployment/ — مستندات استقرار (۴ فایل)
| فایل | توضیح |
|---|---|
| OFFLINE-DEPLOYMENT-GUIDE.md | راهنمای جامع استقرار آفلاین + تنظیمات Nexus |
| CICD-PIPELINE-GUIDE.md | 🔄 راهنمای CI/CD Pipeline: معماری DinD، فیکسهای dockerd، Runner ConfigMap، عیبیابی، SERVER_PASSWORD، باگ cross-deploy، قالب workflow Production |
| INFRASTRUCTURE-GUIDE.md | 🔄 مشخصات سرور Staging + Production، DB credentials دوگانه، Gitea، Kestrel protocol، Ingress annotations، Proto v0.0.179 |
| SERVER-MIRRORS-CONFIG.md | 🔄 تنظیمات mirror: K3s registries.yaml Staging + Production، containerd |
| INGRESS-NGINX-WARNING.md | ⚠️ هشدار K3s: مشکل hostNetwork در ingress-nginx |
📂 ui-modernization/ — مستندات نوسازی UI (۳ فایل)
| فایل | توضیح |
|---|---|
| UI-MODERNIZATION-PLAN.md | 🆕 طرح جامع نوسازی UI فرانتآفیس: سیستم بلاگ، صفحات دینامیک، لندینگ، Mobile-First — ۷ فاز، ~۱۲۴ فایل جدید |
| BACKOFFICE-ARCHITECTURE.md | 🆕 مرجع معماری BackOffice: ساختار پوشهها، الگوهای BasePageComponent/Hub/CodeBehind/ExcelExport، مسیرها، permissionها، نقشه NavMenu |
| BACKOFFICE-STORE-UNIFICATION.md | 🆕 یکسانسازی فروشگاه عادی و تخفیفی: NavMenu restructure، حذف آمار سفارشات، رفع PaymentDate، بازنویسی ۴ صفحه |
📂 migration/ — مستندات مهاجرت BFF→CMS (۶ فایل)
| فایل | توضیح |
|---|---|
| GATEWAY-REMOVAL-MIGRATION-PLAN.md | پلن استراتژیک حذف هر دو Gateway (BFF) |
| FRONTOFFICE-TO-CMS-MIGRATION.md | مهاجرت کامل FrontOffice: proto changes، field aliasing + لاگ تغییرات |
| MIGRATION-PROGRESS.md | لاگ پیشرفت مهاجرت: نسخههای proto، خطاها، وضعیت سرویسها |
| BACKOFFICE-BFF-MIGRATION.md | مهاجرت BackOffice: Strategy C، تغییرات namespace |
| customer-facing-capabilities-codex.md | تحلیل جامع قابلیتهای مشتریمدار + gap analysis |
| DATA-TABLE-MAPPINGS.md | 🆕 نگاشت ۳۳ جدول source→target + تبدیل Binary Tree |
📊 آمار تجمیع
| مرحله | تعداد فایل | حذف شده |
|---|---|---|
| اولیه | 220 | — |
| فاز ۱ (حذف duplicate/expired) | 135 | ۸۵ |
| فاز ۲ (حذف obsolete عمیق) | 41 | ۹۴ |
| فاز ۳ (ساختاردهی + merge) | 28 | ۱۳ |
| cleanup نهایی (+2 فایل جدید) | 30 | — |
| session CI/CD + Admin fix (+2) | 32 | — |
| session UI Modernization plan (+1) | 33 | — |
| session Store Unification (+2 docs) | 35 | — |
| session File Mgmt + Content (+1 doc) | 36 | — |
| session Registration Flow Fix (+1 doc) | 37 | — |
| نهایی | 37 + INDEX | ۱۹۱ فایل حذف/ادغام |