admin/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: F1-F7 همه تکمیل — آپدیت PACKAGE-MIGRATION-GUIDE

Browse Source 
- F1-F7 از 🟡 به ✅ تغییر کردند
- NuGet: v0.0.188 → v0.0.189
- R8 (validator hardcoded 1B): فیکس شد
- کامیت هش‌های جدید اضافه شد
- آمار کامیت‌ها و تاریخ بروز شد
This commit is contained in:
masoodafar-web
2026-02-27 09:05:50 +03:30
parent 6fc15b474e
commit de69bf862c
1 changed files with 16 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files
deployment/PACKAGE-MIGRATION-GUIDE.md
+16 -16
View File
@@ -1,10 +1,10 @@
# 📦 راهنمای مهاجرت سیستم پکیج‌بیس — خلاصه تغییرات و پلن استقرار # 📦 راهنمای مهاجرت سیستم پکیج‌بیس — خلاصه تغییرات و پلن استقرار
> **وضعیت:** آماده تست و استقرار — **Q1-Q30 تکمیل‌شده ✅** > **وضعیت:** آماده تست و استقرار — **Q1-Q30 تکمیل‌شده ✅ | F1-F11 تکمیل‌شده ✅**
> **تاریخ:** ۸ اسفند ۱۴۰۴ (27 Feb 2026) — آپدیت ۹ اسفند > **تاریخ:** ۸ اسفند ۱۴۰۴ (27 Feb 2026) — آپدیت ۱۰ اسفند
> **نسخه NuGet:** v0.0.188 > **نسخه NuGet:** v0.0.189
> **تعداد کامیت‌ها:** ۴۸ کامیت در ۴ ریپازیتوری (۲۰ CMS + ۸ FO + ۶ BO + ۱۴ docs) > **تعداد کامیت‌ها:** ۵۱+ کامیت در ۴ ریپازیتوری (۲۱ CMS + ۹ FO + ۷ BO + ۱۴+ docs)
> **مدت پیاده‌سازی:** ۵ روز (۲۴–۲۸ فوریه ۲۰۲۶) > **مدت پیاده‌سازی:** ۶ روز (۲۴ فوریه – ۱ مارس ۲۰۲۶)
> **ریپوها:** CMS (`gitea`/`kub-stage`) · FrontOffice (`kub-stage`) · BackOffice (`kub-stage`) · totalDoc (`foursatDocs`/`main`) > **ریپوها:** CMS (`gitea`/`kub-stage`) · FrontOffice (`kub-stage`) · BackOffice (`kub-stage`) · totalDoc (`foursatDocs`/`main`)
--- ---
@@ -627,9 +627,9 @@ kubectl set image deployment/backoffice bo=bo:rollback-point
| # | ریسک | کاهش‌دهنده | | # | ریسک | کاهش‌دهنده |
|---|-------|------------| |---|-------|------------|
| R5 | Proto breaking change | Field numberها backward compatible (فقط اضافه) | | R5 | Proto breaking change | Field numberها backward compatible (فقط اضافه) |
| R6 | NuGet version mismatch بین repos | همه روی v0.0.188 ✅ | | R6 | NuGet version mismatch بین repos | همه روی v0.0.189 ✅ |
| R7 | JWT claims — cache invalidation | کاربران باید re-login کنند | | R7 | JWT claims — cache invalidation | کاربران باید re-login کنند |
| R8 | Validator hardcoded 1B | فعلاً anti-abuse cap — قابل قبول | | R8 | ~~Validator hardcoded 1B~~ | ✅ فیکس شد — `SystemConstants.WalletMaxSafeAmount` (10B) حصار ایمنی |
### ⚠️ تغییرات آینده (هنوز پیاده‌نشده — Phase بعدی) ### ⚠️ تغییرات آینده (هنوز پیاده‌نشده — Phase بعدی)
@@ -637,19 +637,19 @@ kubectl set image deployment/backoffice bo=bo:rollback-point
| # | مورد | شدت | شرح | | # | مورد | شدت | شرح |
|---|------|------|------| |---|------|------|------|
| F1 | WalletChangeLog + PackageId | 🟡 | ۲۱ محل ساخت باید PackageId بگیرند | | ~~F1~~ | ~~WalletChangeLog + PackageId~~ | ✅ انجام‌شده | CMS:`e5bc3a9` — PackageId در UserWalletHistory |
| F2 | Notification + PackageId | 🟡 | ۴ notification بدون نام پکیج | | ~~F2~~ | ~~Notification + PackageId~~ | ✅ انجام‌شده | CMS:`61b7e4f` — SmsTemplates+IUserNotificationService+UserNotificationService با packageName |
| F3 | Background Services + PackageId | 🟡 | ۳ worker بدون فیلتر پکیج | | ~~F3~~ | ~~Background Services + PackageId~~ | ✅ بررسی‌شده | بدون تغییر — هر ۳ worker از قبل per-package صحیح کار می‌کنند |
| F4 | CSV exports + ستون پکیج | 🟡 | ۳ export بدون ستون | | ~~F4~~ | ~~CSV exports + ستون پکیج~~ | ✅ انجام‌شده | CMS:`61b7e4f` BO:`92c9922` — proto+handler+CSV برای ManualPayments/WithdrawalRequests |
| F5 | SystemConfiguration per-package | 🟡 | تنظیمات global vs per-package | | ~~F5~~ | ~~SystemConfiguration per-package~~ | ✅ بررسی‌شده | بدون تغییر — مقادیر per-package قبلاً به Package entity منتقل شده‌اند |
| F6 | MagicWalletChargePage hardcoded | 🟡 | ×۲.۵ و سقف در ۶ جا FO | | ~~F6~~ | ~~MagicWalletChargePage hardcoded~~ | ✅ انجام‌شده | CMS:`61b7e4f` FO:`ecc4f44` — magic_multiplier+magic_max_credit از API، داشبورد "شارژ چند‌برابری" |
| F7 | Validators async per-package | 🟢 | سقف 1B → مقدار واقعی | | ~~F7~~ | ~~Validators async per-package~~ | ✅ انجام‌شده | CMS:`61b7e4f` FO:`ecc4f44` — SystemConstants.WalletMaxSafeAmount (10B) حصار ایمنی، سقف واقعی per-package در هندلر |
| ~~F8~~ | ~~آستانه موجودی ورود به Magic (Q24)~~ | ✅ انجام‌شده | CMS:`a1024a3` — `Balance <= 1_000_000` | | ~~F8~~ | ~~آستانه موجودی ورود به Magic (Q24)~~ | ✅ انجام‌شده | CMS:`a1024a3` — `Balance <= 1_000_000` |
| ~~F9~~ | ~~SP Worker — مدیریت خودکار SP (Q26)~~ | ✅ انجام‌شده | CMS:`a1024a3` — `StoredProcedureDeploymentService` | | ~~F9~~ | ~~SP Worker — مدیریت خودکار SP (Q26)~~ | ✅ انجام‌شده | CMS:`a1024a3` — `StoredProcedureDeploymentService` |
| ~~F10~~ | ~~History Tables — یکسان‌سازی + خودکار (Q27)~~ | ✅ انجام‌شده | CMS:`fdbb91d`+`10d2ca2` — IHasHistory + Interceptor + RenameTable migration | | ~~F10~~ | ~~History Tables — یکسان‌سازی + خودکار (Q27)~~ | ✅ انجام‌شده | CMS:`fdbb91d`+`10d2ca2` — IHasHistory + Interceptor + RenameTable migration |
| ~~F11~~ | ~~UI Guidance — آموزش و هشدار (Q28)~~ | ✅ انجام‌شده | FO:`474d364` BO:`6939780` — ۱۳ صفحه MudAlert | | ~~F11~~ | ~~UI Guidance — آموزش و هشدار (Q28)~~ | ✅ انجام‌شده | FO:`474d364` BO:`6939780` — ۱۳ صفحه MudAlert |
> ✅ **F8-F11 همه پیاده‌سازی شدند.** سایر موارد (F1-F7) با fallback فعلی مشکلی ندارند و می‌توانند در فاز بعدی انجام شوند. > ✅ **F1-F11 همه پیاده‌سازی شدند.**
--- ---
@@ -697,4 +697,4 @@ kubectl set image deployment/backoffice bo=bo:rollback-point
--- ---
*آخرین بروزرسانی: ۹ اسفند ۱۴۰۴ — v6.1: Q24-Q30 همه تکمیل‌شده ✅ | ۴۸ کامیت (۲۰ CMS + ۸ FO + ۶ BO + ۱۴ docs) | History Interceptor + Rename + Migration اضافه شد* *آخرین بروزرسانی: ۱۰ اسفند ۱۴۰۴ — v7: F1-F7 همه تکمیل‌شده ✅ | ۵۱+ کامیت (۲۱ CMS + ۹ FO + ۷ BO + ۱۴+ docs) | NuGet v0.0.189 | Notifications+PackageName, CSV ستون پکیج, Dynamic MagicWallet, SystemConstants validators*