docs: Magic Wallet + VAT 10% documentation update

- All 14 totalDoc files updated with Magic Wallet additions
- MAGIC-WALLET-PLAN.md: Phase 1-6 checklist fully marked complete
- Business docs: Magic Wallet section, commission filter, new entities
- Payment docs: VAT 9%→10%, TransactionType 14+15, ZarinPal 4th usage
- Technical docs: UserWallet fields, ClubMembershipCycle, gRPC RPCs
- Overview docs: Magic flowchart, ER diagram, changelog, glossary, roadmap
This commit is contained in:
masoodafar-web
2026-02-22 20:09:01 +03:30
parent 0e61513b0e
commit 421a651975
14 changed files with 221 additions and 62 deletions
+23 -23
View File
@@ -178,31 +178,31 @@
## Checklist پیاده‌سازی
- [ ] **فاز ۱:** WalletMode enum
- [ ] **فاز ۱:** UserWallet entity + 5 فیلد جدید
- [ ] **فاز ۱:** ClubMembershipCycle entity (جدید)
- [ ] **فاز ۱:** TransactionType + 2 مقدار
- [ ] **فاز ۱:** SystemConstants + 3 ثابت
- [ ] **فاز ۱:** EF Configuration (UserWallet + ClubMembershipCycle)
- [x] **فاز ۱:** WalletMode enum
- [x] **فاز ۱:** UserWallet entity + 5 فیلد جدید
- [x] **فاز ۱:** ClubMembershipCycle entity (جدید)
- [x] **فاز ۱:** TransactionType + 2 مقدار
- [x] **فاز ۱:** SystemConstants + 3 ثابت
- [x] **فاز ۱:** EF Configuration (UserWallet + ClubMembershipCycle)
- [ ] **فاز ۱:** Migration: AddMagicWalletFields
- [ ] **فاز ۱:** Migration: AddClubMembershipCycle + data seed
- [ ] **فاز ۲:** Trigger ورود Magic (SubmitShopBuyOrder)
- [ ] **فاز ۲:** Trigger خروج Magic
- [ ] **فاز ۲:** ActivateClubMembership → ActivatedAt نگه‌داشته بشه + Cycle جدید
- [ ] **فاز ۲:** PurchaseCycleCount
- [ ] **فاز ۳:** InitiateMagicChargeCommand + Handler
- [ ] **فاز ۳:** VerifyMagicChargeCommand + Handler
- [ ] **فاز ۳:** MagicWalletController (HTTP callback)
- [ ] **فاز ۳:** gRPC Proto + Service
- [ ] **فاز ۳:** ۲ تراکنش + ۱ لاگ (اجباری)
- [ ] **فاز ۴:** فیلتر کمیسیون Magic (C# handler + SP)
- [ ] **فاز ۴:** تاریخ کمیسیون: ActivatedAt → Cycle.PackagePurchasedAt (C# + SP)
- [ ] **فاز ۵:** MagicWallet.razor
- [ ] **فاز ۵:** MagicPaymentCallback.razor
- [ ] **فاز ۵:** WalletService gRPC client
- [ ] **فاز ۵:** Profile + Wallet page updates
- [ ] **فاز ۶:** Daya restriction
- [ ] **فاز ۶:** Club activation restriction
- [x] **فاز ۲:** Trigger ورود Magic (SubmitShopBuyOrder)
- [x] **فاز ۲:** Trigger خروج Magic
- [x] **فاز ۲:** ActivateClubMembership → ActivatedAt نگه‌داشته بشه + Cycle جدید
- [x] **فاز ۲:** PurchaseCycleCount
- [x] **فاز ۳:** InitiateMagicChargeCommand + Handler
- [x] **فاز ۳:** VerifyMagicChargeCommand + Handler
- [x] **فاز ۳:** MagicWalletController (HTTP callback)
- [x] **فاز ۳:** gRPC Proto + Service
- [x] **فاز ۳:** ۲ تراکنش + ۱ لاگ (اجباری)
- [x] **فاز ۴:** فیلتر کمیسیون Magic (C# handler + SP)
- [x] **فاز ۴:** تاریخ کمیسیون: ActivatedAt → Cycle.PackagePurchasedAt (C# + SP)
- [x] **فاز ۵:** MagicWallet.razor
- [x] **فاز ۵:** MagicPaymentCallback — نتیجه پرداخت از طریق ?payment= query param در همان MagicWallet.razor هندل میشه
- [x] **فاز ۵:** WalletService gRPC client
- [x] **فاز ۵:** Profile + Wallet page updates
- [x] **فاز ۶:** Daya restriction (CheckAndProcessDayaLoansCommandHandler + FO Purchase UI)
- [x] **فاز ۶:** Club activation restriction (ActivateClubMembershipCommandHandler + WalletMode guard)
---