Docs: Phase 5-6 completion — per-package commission + deprecation cleanup

- CHANGELOG: Phase 5 (per-pkg commission, golden cleanup) + Phase 6 (deprecation, ConfigService MagicWallet)
- ROADMAP: Progress 83%→93%, timeline updated through Phase 6
- TASKS: Mark مرحله ۳ (پورسانت) , add commits 607f791→7176fe4→d19c569
This commit is contained in:
masoodafar-web
2026-02-26 01:14:51 +03:30
parent 37330a3e45
commit 0aa126af1c
3 changed files with 34 additions and 22 deletions
+22 -10
View File
@@ -1,7 +1,7 @@
# 📜 تاریخچه کارهای انجام‌شده
> **همه فعالیت‌های پروژه به صورت بولت با توضیح یک‌خطی و درصد تکمیل**
> **آخرین بروزرسانی:** اسفند ۱۴۰۴ (بروزرسانی: تحول پکیج‌بیس فاز ۰-۴ + فعال‌سازی درگاه + مرج پروداکشن)
> **آخرین بروزرسانی:** اسفند ۱۴۰۴ (بروزرسانی: تحول پکیج‌بیس فاز ۰-۶ + per-package commission + deprecation cleanup)
---
@@ -12,10 +12,10 @@
| **BackOffice** | 61 | 60 | **98%** |
| **FrontOffice** | 40 | 38 | **95%** |
| **CMS Core** | 72 | 70 | **97%** |
| **Package-Based System** | 30 | 25 | **83%** |
| **Package-Based System** | 30 | 28 | **93%** |
| **Deployment** | 22 | 21 | **95%** |
| **Migration** | 16 | 16 | **100%** |
| **مجموع** | **241** | **230** | **95%** |
| **مجموع** | **241** | **233** | **97%** |
---
@@ -218,7 +218,7 @@
---
## ۷. تحول سیستم پکیج‌بیس (Package-Based Transformation) — 83%
## ۷. تحول سیستم پکیج‌بیس (Package-Based Transformation) — 90%
> 📦 تبدیل سیستم تک‌پکیجی hardcoded به معماری چند‌پکیجی داینامیک
> مرجع: [BIZ-PACKAGE-BASED-SYSTEM.md](../business/BIZ-PACKAGE-BASED-SYSTEM.md) | [PACKAGE-TRANSFORMATION-TASKS.md](../roadmap/PACKAGE-TRANSFORMATION-TASKS.md)
@@ -276,12 +276,24 @@
- ✅ PurchaseGoldenPackage — حذف Title string match شکننده (`"طلایی"/"golden"`) → `IsDeleted/IsActive/SupportsDirectPurchase`
- ✅ VerifyPackagePurchase — حذف hardcoded `order.Amount × 2``package.DiscountMultiplier` از DB
### Phase 5 — پورسانت per-package ⬜ (در انتظار)
- ⬜ SP پارامترهای داینامیک (@MaxBalancesPerLeg, @MaxNetworkLevel)
- ⬜ Loop Service — حلقه روی پکیج‌های فعال
- Carryover مجزا per-package
### Phase 5 — پورسانت per-package + پاکسازی golden ✅ (`607f791`, `7176fe4`)
- ✅ ORM Commission: per-user-package calculation via `ClubMembership.LastPackageId`
- userPackageMap، per-user maxBalancesPerLeg/maxNetworkLevel
- Carryover keyed by (UserId, PackageId) tuple
- ✅ SP Commission: loop over packages، pass `@PackageId/@InputMaxBalancesPerLeg/@InputMaxNetworkLevel`
- ✅ sp_CalculateWeeklyBalances: ۳ پارامتر جدید، فیلتر `cm.LastPackageId = @PackageId`، ستون PackageId در INSERT
- ✅ Fix: `cm.PackageId``cm.LastPackageId` — match actual DB column name
- ✅ Fix golden/طلایی string refs in user-facing messages (ActivateClubMembership)
- ✅ Rename `HasPurchasedGoldenPackage``HasPurchasedPackage` (DTO + Handler + Proto + Mapping)
### Phase 6 — UI ⬜ (در انتظار)
### Phase 6 — Deprecation cleanup + ConfigurationService ✅ (`d19c569`)
- ✅ Mark `PurchaseGoldenPackage`/`VerifyGoldenPackagePurchase` RPCs as `deprecated = true`
- ✅ Mark `InitiateBasePackagePayment`/`VerifyBasePackagePayment` RPCs as `deprecated = true`
- ✅ Remove deprecated SystemConstants from `GetAllAsDict`/`GetAllWithDescriptions` helpers
- ✅ Add MagicWallet per-package values to ConfigurationService (Multiplier, MaxDeposit, MaxCredit)
- ✅ تأیید: صفر رفرنس فعال به ۹ SystemConstants منسوخ — dead code آماده حذف
### Phase 7 — UI ⬜ (در انتظار)
- ⬜ FrontOffice: کاشی‌های داینامیک پکیج
- ⬜ FrontOffice: MyPackages + re-purchase
- ⬜ FrontOffice: Commission Dashboard per-package
@@ -305,4 +317,4 @@
| اسفند ۱۴۰۳ (هفته ۴) | مستندات + نهایی‌سازی | 95% |
| اسفند ۱۴۰۴ (هفته ۱-۲) | 🪄 کیف‌پول جادویی (فاز 1-6) + اصلاح VAT 10% | 96% |
| اسفند ۱۴۰۴ (هفته ۳) | 🚀 فعال‌سازی درگاه + بهبود UI ادمین + مرج پروداکشن | 97% |
| اسفند ۱۴۰۴ (هفته ۴) | 📦 تحول پکیج‌بیس فاز ۰-۴ (Domain + Migration + Business Logic + Package Layer + CRUD) | 95% |
| اسفند ۱۴۰۴ (هفته ۴) | 📦 تحول پکیج‌بیس فاز ۰-۶ (Domain Migration Business Package → CRUD → Commission per-pkg → Deprecation) | 97% |
+4 -5
View File
@@ -1,7 +1,7 @@
# 🗺️ نقشه راه، ریسک‌ها و کارهای باقیمانده
> **Roadmap + Risk Register + Dependencies + Priorities**
> **آخرین بروزرسانی:** اسفند ۱۴۰۴ (بروزرسانی: تحول پکیج‌بیس فاز ۰-۴ + فعال‌سازی درگاه + مرج پروداکشن)
> **آخرین بروزرسانی:** اسفند ۱۴۰۴ (بروزرسانی: تحول پکیج‌بیس فاز ۰-۶ + per-package commission + deprecation cleanup)
---
@@ -15,7 +15,7 @@ Club System ████████████████████
E-Commerce ████████████████████████████████████████████████ 98%
Payment ████████████████████████████████████████████████ 97%
Magic Wallet ████████████████████████████████████████████████ 100%
Package-Based ████████████████████████████████████████░░░░░░░░ 83%
Package-Based ██████████████████████████████████████████████░░ 93%
UI/UX █████████████████████████████████████████████░░░ 93%
Deployment ██████████████████████████████████████████████░░ 95%
Documentation ████████████████████████████████████████████████ 100%
@@ -208,11 +208,10 @@ DONE (اسفند ۱۴۰۴):
→ بهبود UI ادمین (UserAutoComplete + نام کاربر در کیف‌پول) ✅
→ مرج پروداکشن هر ۳ ریپو (CMS + FO + BO) ✅
→ اجرای Migration روی پروداکشن ✅
→ 📦 تحول پکیج‌بیس فاز 0-4 ✅ (Domain + Migration + Business + Package Layer + CRUD)
→ 📦 تحول پکیج‌بیس فاز 0-6 ✅ (Domain Migration Business Package → CRUD → Commission per-pkg → Deprecation)
NOW (این ماه):
→ 📦 فاز 5: پورسانت per-package (SP + Loop Service + Carryover)
→ 📦 فاز 6: UI (کاشی‌های داینامیک + فیلتر پکیج + MyPackages)
→ 📦 فاز 7: UI (کاشی‌های داینامیک + فیلتر پکیج + MyPackages)
→ EF Migration نهایی
→ تست کامل پروداکشن
+8 -7
View File
@@ -1,10 +1,10 @@
# 🔄 نقشه‌راه تحول پکیج‌بیس — تسک‌های گام‌به‌گام
> **وضعیت:** در حال اجرا — **فاز ۰-۴ تکمیل ✅** | فاز ۵ در انتظار
> **تاریخ:** ۱۴۰۴/۱۲/۰۶
> **وضعیت:** در حال اجرا — **فاز ۰-۶ تکمیل ✅** | فاز ۷ (UI) در انتظار
> **تاریخ:** ۱۴۰۴/۱۲/۰۸
> **پیش‌نیاز:** [BIZ-PACKAGE-BASED-SYSTEM.md](../business/BIZ-PACKAGE-BASED-SYSTEM.md) **v3** (تکمیل پورسانت per-package)
> **هدف:** شکستن **۴۸+ تغییر** به تسک‌های اتمیک با ترتیب اجرا و وابستگی‌ها
> **کامیت‌ها:** `8b9c317` → `fe3edd1` → `ae92ab8` → `a9cd2fd` → `8e5c7c5` → `ccb938e` → `0002a5a`
> **کامیت‌ها:** `8b9c317` → `fe3edd1` → `ae92ab8` → `a9cd2fd` → `8e5c7c5` → `ccb938e` → `0002a5a` → `607f791` → `7176fe4` → `d19c569`
> ⚠️ **تغییرات v3:** پورسانت per-package، carryover مجزا، SP parameters داینامیک، گزارش‌دهی FO/BO per-package
@@ -20,7 +20,8 @@
│ └─→ مرحله ۳: بازسازی لایه Package ✅ `ccb938e`
│ └─→ مرحله ۴: CRUD + Legacy Fixes ✅ `0002a5a`
│ └─→ مرحله UI (۵ روز) ⬜
└─→ مرحله ۳: پورسانت (۴ روز) ⬜ موازی
└─→ مرحله ۳: پورسانت (۴ روز) ✅ `607f791`+`7176fe4`
└─→ مرحله ۶: Deprecation cleanup ✅ `d19c569`
└─→ مرحله ۵: تست + استقرار (۳ روز) ⬜
مسیر بحرانی: ۰→۱→۱.۵→۲→۳→۴→UI→۵ = ~۱۷ روز | انجام‌شده: ۰→۴ (~۱۰ روز)
@@ -308,9 +309,9 @@ WHERE "PackageId" IS NULL;
---
## مرحله ۳ — محاسبه پورسانت (موازی با مرحله ۲)
## مرحله ۳ — محاسبه پورسانت (موازی با مرحله ۲)
> ⏱️ **۴ روز** (v3: +۱) | وابستگی: مرحله ۱ | ریسک: بحرانی (مالی)
> ✅ تکمیل‌شده | کامیت: `607f791` + `7176fe4` | ⏱️ **۴ روز** | ریسک: بحرانی (مالی)
### T3.1-T3.2 — SPs + PackageId + پارامترهای داینامیک (🔄 v3)
@@ -596,4 +597,4 @@ else
---
*آخرین بروزرسانی: ۱۴۰۴/۱۲/۰۷ — فاز ۰-۴ تکمیل (۷ کامیت) | فاز ۵ پورسانت per-package در انتظار*
*آخرین بروزرسانی: ۱۴۰۴/۱۲/۰۸ — فاز ۰-۶ تکمیل (۱۰ کامیت) | پورسانت per-package ✅ | deprecation cleanup ✅ | فاز ۷ UI در انتظار*