docs: Add Phase 8a — Checkout wire-up + NuGet plan

This commit is contained in:
masoodafar-web
2026-02-26 03:36:33 +03:30
parent d94b09878a
commit a61a987b57
+39 -5
View File
@@ -1,12 +1,12 @@
# 🔄 نقشه‌راه تحول پکیج‌بیس — تسک‌های گام‌به‌گام
> **وضعیت:** در حال اجرا — **فاز ۰-۶ تکمیل ✅** | **فاز ۷a-c تکمیل ✅** | فاز UI باقی‌مانده
> **وضعیت:** در حال اجرا — **فاز ۰-۷c تکمیل ✅** | **فاز 8a تکمیل ✅** | NuGet + UI باقی‌مانده
> **تاریخ:** ۱۴۰۴/۱۲/۰۹
> **پیش‌نیاز:** [BIZ-PACKAGE-BASED-SYSTEM.md](../business/BIZ-PACKAGE-BASED-SYSTEM.md) **v3** (تکمیل پورسانت per-package)
> **هدف:** شکستن **۴۸+ تغییر** به تسک‌های اتمیک با ترتیب اجرا و وابستگی‌ها
> **کامیت‌ها:**
> CMS: `8b9c317`→`fe3edd1`→`ae92ab8`→`a9cd2fd`→`8e5c7c5`→`ccb938e`→`0002a5a`→`607f791`→`7176fe4`→`d19c569`→`469d97b`→`161f796`→`8446e0e`
> FrontOffice: `b82cac4`→`71f391a`
> FrontOffice: `b82cac4`→`71f391a`→`0bbc11e`
> BackOffice: `f1b0085`
> ⚠️ **تغییرات v3:** پورسانت per-package، carryover مجزا، SP parameters داینامیک، گزارش‌دهی FO/BO per-package
@@ -29,9 +29,11 @@
├─→ 7a: Cosmetic cleanup ✅ CMS:`469d97b` FO:`b82cac4` BO:`f1b0085`
├─→ 7b: FO RPC migration ✅ CMS:`161f796` FO:`71f391a`
└─→ 7c: Delete deprecated ✅ CMS:`8446e0e`
└─→ مرحله ۵: تست + استقرار (۳ روز) ⬜
└─→ مرحله ۸: FO Checkout + NuGet
└─→ 8a: Checkout wire-up ✅ FO:`0bbc11e`
└─→ مرحله ۵: تست + استقرار (۳ روز) ⬜
مسیر بحرانی: ۰→۱→۱.۵→۲→۳→۴→UI→۵ = ~۱۷ روز | انجام‌شده: ۰→۷c (~۱۳ روز)
مسیر بحرانی: ۰→۱→۱.۵→۲→۳→۴→UI→۵ = ~۱۷ روز | انجام‌شده: ۰→8a (~۱۴ روز)
```
---
@@ -478,6 +480,38 @@ await connection.ExecuteAsync("CMS.sp_CalculateWeeklyBalances",
---
## مرحله ۸ — FrontOffice Checkout + NuGet
> 🔄 در حال اجرا | فاز 8a تکمیل ✅
### فاز 8a — Checkout Wire-up ✅
> کامیت: FO `0bbc11e`
**Checkout.razor.cs:**
- حذف dead code: `ProcessPayment()` از flow قدیمی `TransactionsContract + UserOrderContract` استفاده می‌کرد
- Rewrite با `CustomerPurchasePackageAsync` (مثل Profile/Index.razor.cs)
- Callback URL → `/profile/payment-callback` (از صفحه verify موجود استفاده مجدد)
- حذف DI بلااستفاده: `UserOrderContract`, `TransactionContract`
- حذف usings: `Transactions`, `UserOrder`, `WellKnownTypes`
**Profile/Index.razor.cs (cosmetic):**
- Rename `basePackage``selectedPackage`, `tempCallbackUrl``callbackUrl`
### فاز 8b — NuGet Rebuild + BackOffice Fix ⬜
> بلاکر: BackOffice هنوز از `HasPurchasedGoldenPackage` استفاده می‌کند (NuGet v0.0.184)
> Proto field renamed: `has_purchased_golden_package` → `has_purchased_package` (field 35)
> FrontOffice هم روی v0.0.182 هست (۲ نسخه عقب)
**تسک‌ها:**
1. Bump proto version → `0.0.185`
2. Pack + Push NuGet
3. BackOffice: `HasPurchasedGoldenPackage``HasPurchasedPackage` در `UserNetworkInfo.razor`
4. FrontOffice: Bump NuGet `0.0.182``0.0.185`
---
## مرحله ۴ — UI (FrontOffice + BackOffice)
> ⏱️ **۵ روز** (v3: +۲) | وابستگی: مرحله ۲ + ۳ | ریسک: متوسط
@@ -653,4 +687,4 @@ else
---
*آخرین بروزرسانی: ۱۴۰۴/۱۲/۰۹ — فاز ۰-۷c تکمیل (۱۶ کامیت: ۱۳ CMS + ۲ FO + ۱ BO) | ۴ deprecated handler حذف‌شده | FO به Customer* RPCs مهاجرت‌شده | UI باقی‌مانده*
*آخرین بروزرسانی: ۱۴۰۴/۱۲/۰۹ — فاز ۰-۸a تکمیل (۱۷ کامیت: ۱۳ CMS + ۳ FO + ۱ BO) | Checkout فعال‌شده | ۴ deprecated handler حذف | FO کامل مهاجرت به Customer* RPCs*