diff --git a/deployment/PACKAGE-MIGRATION-GUIDE.md b/deployment/PACKAGE-MIGRATION-GUIDE.md index 7cca504..7c34166 100644 --- a/deployment/PACKAGE-MIGRATION-GUIDE.md +++ b/deployment/PACKAGE-MIGRATION-GUIDE.md @@ -1,10 +1,10 @@ # 📦 راهنمای مهاجرت سیستم پکیج‌بیس — خلاصه تغییرات و پلن استقرار -> **وضعیت:** آماده تست و استقرار — **Q1-Q30 تکمیل‌شده ✅** -> **تاریخ:** ۸ اسفند ۱۴۰۴ (27 Feb 2026) — آپدیت ۹ اسفند -> **نسخه NuGet:** v0.0.188 -> **تعداد کامیت‌ها:** ۴۸ کامیت در ۴ ریپازیتوری (۲۰ CMS + ۸ FO + ۶ BO + ۱۴ docs) -> **مدت پیاده‌سازی:** ۵ روز (۲۴–۲۸ فوریه ۲۰۲۶) +> **وضعیت:** آماده تست و استقرار — **Q1-Q30 تکمیل‌شده ✅ | F1-F11 تکمیل‌شده ✅** +> **تاریخ:** ۸ اسفند ۱۴۰۴ (27 Feb 2026) — آپدیت ۱۰ اسفند +> **نسخه NuGet:** v0.0.189 +> **تعداد کامیت‌ها:** ۵۱+ کامیت در ۴ ریپازیتوری (۲۱ CMS + ۹ FO + ۷ BO + ۱۴+ docs) +> **مدت پیاده‌سازی:** ۶ روز (۲۴ فوریه – ۱ مارس ۲۰۲۶) > **ریپوها:** 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 (فقط اضافه) | -| R6 | NuGet version mismatch بین repos | همه روی v0.0.188 ✅ | +| R6 | NuGet version mismatch بین repos | همه روی v0.0.189 ✅ | | R7 | JWT claims — cache invalidation | کاربران باید re-login کنند | -| R8 | Validator hardcoded 1B | فعلاً anti-abuse cap — قابل قبول | +| R8 | ~~Validator hardcoded 1B~~ | ✅ فیکس شد — `SystemConstants.WalletMaxSafeAmount` (10B) حصار ایمنی | ### ⚠️ تغییرات آینده (هنوز پیاده‌نشده — Phase بعدی) @@ -637,19 +637,19 @@ kubectl set image deployment/backoffice bo=bo:rollback-point | # | مورد | شدت | شرح | |---|------|------|------| -| F1 | WalletChangeLog + PackageId | 🟡 | ۲۱ محل ساخت باید PackageId بگیرند | -| F2 | Notification + PackageId | 🟡 | ۴ notification بدون نام پکیج | -| F3 | Background Services + PackageId | 🟡 | ۳ worker بدون فیلتر پکیج | -| F4 | CSV exports + ستون پکیج | 🟡 | ۳ export بدون ستون | -| F5 | SystemConfiguration per-package | 🟡 | تنظیمات global vs per-package | -| F6 | MagicWalletChargePage hardcoded | 🟡 | ×۲.۵ و سقف در ۶ جا FO | -| F7 | Validators async per-package | 🟢 | سقف 1B → مقدار واقعی | +| ~~F1~~ | ~~WalletChangeLog + PackageId~~ | ✅ انجام‌شده | CMS:`e5bc3a9` — PackageId در UserWalletHistory | +| ~~F2~~ | ~~Notification + PackageId~~ | ✅ انجام‌شده | CMS:`61b7e4f` — SmsTemplates+IUserNotificationService+UserNotificationService با packageName | +| ~~F3~~ | ~~Background Services + PackageId~~ | ✅ بررسی‌شده | بدون تغییر — هر ۳ worker از قبل per-package صحیح کار می‌کنند | +| ~~F4~~ | ~~CSV exports + ستون پکیج~~ | ✅ انجام‌شده | CMS:`61b7e4f` BO:`92c9922` — proto+handler+CSV برای ManualPayments/WithdrawalRequests | +| ~~F5~~ | ~~SystemConfiguration per-package~~ | ✅ بررسی‌شده | بدون تغییر — مقادیر per-package قبلاً به Package entity منتقل شده‌اند | +| ~~F6~~ | ~~MagicWalletChargePage hardcoded~~ | ✅ انجام‌شده | CMS:`61b7e4f` FO:`ecc4f44` — magic_multiplier+magic_max_credit از API، داشبورد "شارژ چند‌برابری" | +| ~~F7~~ | ~~Validators async per-package~~ | ✅ انجام‌شده | CMS:`61b7e4f` FO:`ecc4f44` — SystemConstants.WalletMaxSafeAmount (10B) حصار ایمنی، سقف واقعی per-package در هندلر | | ~~F8~~ | ~~آستانه موجودی ورود به Magic (Q24)~~ | ✅ انجام‌شده | CMS:`a1024a3` — `Balance <= 1_000_000` | | ~~F9~~ | ~~SP Worker — مدیریت خودکار SP (Q26)~~ | ✅ انجام‌شده | CMS:`a1024a3` — `StoredProcedureDeploymentService` | | ~~F10~~ | ~~History Tables — یکسان‌سازی + خودکار (Q27)~~ | ✅ انجام‌شده | CMS:`fdbb91d`+`10d2ca2` — IHasHistory + Interceptor + RenameTable migration | | ~~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*