update
This commit is contained in:
masoodafar-web
@@ -50,7 +50,11 @@ ApproveManualPaymentCommand یا RejectManualPaymentCommand
|
||||
|
||||
### Domain Layer
|
||||
|
||||
#### **ManualPaymentStatus Enum**
|
||||
> **وضعیت فعلی پیادهسازی (CMS)**
|
||||
> در نسخهای که الآن در CMS داریم، سناریوی «درخواست پرداخت دستی توسط کاربر» (ManualPaymentRequest + Verify از درگاه) هنوز پیادهسازی نشده و فقط بخش **پرداخت دستی توسط Admin/SuperAdmin** با Entity سادهتر `ManualPayment` و Enumهای `ManualPaymentType` و `ManualPaymentStatus` (Pending/Approved/Rejected/Cancelled) اجرا شده است.
|
||||
> بخشهای زیر که با `ManualPaymentRequest`، `ManualPaymentMethod` و Verify/ProcessManualPayment توضیح داده شدهاند، طراحی کامل سیستم هستند و برای فاز بعدی (FrontOffice + OnlineGateway/CardToCard) استفاده خواهند شد.
|
||||
|
||||
#### **ManualPaymentStatus Enum (طراحی کامل – برای Requestها)**
|
||||
```csharp
|
||||
public enum ManualPaymentStatus
|
||||
{
|
||||
@@ -73,7 +77,7 @@ public enum ManualPaymentMethod
|
||||
}
|
||||
```
|
||||
|
||||
#### **ManualPaymentRequest Entity**
|
||||
#### **ManualPaymentRequest Entity (طراحی کامل – هنوز پیاده نشده)**
|
||||
```csharp
|
||||
public class ManualPaymentRequest : BaseAuditableEntity
|
||||
{
|
||||
|
||||
@@ -270,6 +270,7 @@ NavMenu.razor - آپدیت شده با بخشهای جدید:
|
||||
- ✅ افزودن نمایش نمودار آماری سفارشات (کارت جمع سفارشها و نمودار تعداد سفارش بر اساس وضعیت ارسال)
|
||||
- ✅ بهبود جستجوی پیشرفته (فیلتر شناسه سفارش/کاربر/تراکنش و فیلترهای ترکیبی)
|
||||
- ✅ دکمههای مدیریت سفارش: لغو سفارش (CancelOrder) با Dialog دلیل/بازگشت وجه، تغییر وضعیت ارسال (UpdateOrderStatus) از طریق ChangeOrderStatusDialog، و Dialog اعمال تخفیف دستی (ApplyDiscountToOrder) متصل به gRPC BackOffice.BFF.UserOrder
|
||||
- ✅ نمایش VAT سفارش: ستونهای VatAmount/VatPercentage در OrdersMainPage و خلاصه VAT (BaseAmount/VatAmount/TotalAmount) در UserOrderDetailsDialog بر اساس دادههای BackOffice.BFF.UserOrder
|
||||
```
|
||||
|
||||
#### 4. گزارشهای جدید (2 صفحه)
|
||||
@@ -307,6 +308,20 @@ NavMenu.razor - آپدیت شده با بخشهای جدید:
|
||||
- EventCallback برای ارسال لیست تصاویر مرتبشده به والد (برای اتصال بعدی به Backend)
|
||||
```
|
||||
|
||||
#### 6. مدیریت پرداختهای دستی (Manual Payments)
|
||||
```
|
||||
✅ Pages/Payment/ManualPayments.razor
|
||||
- لیست پرداختهای دستی (ManualPayment) با MudDataGrid
|
||||
- فیلتر بر اساس UserId و Status
|
||||
- نمایش ستونهای: Id, UserId, UserFullName, Amount, TypeDisplay, StatusDisplay, Created
|
||||
- دکمه ثبت پرداخت دستی جدید (CreateManualPayment)
|
||||
|
||||
✅ Components/ManualPaymentDialog.razor
|
||||
- حالت Create: فرم ثبت ManualPayment (UserId, Amount, Type, Description, ReferenceNumber)
|
||||
- حالت Details: نمایش جزئیات پرداخت دستی و نمایش دلیل رد (در صورت وجود)
|
||||
- دکمههای Approve/Reject برای درخواستهای Pending متصل به BackOffice.BFF.ManualPayment
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 برنامه پیادهسازی پیشنهادی
|
||||
|
||||
+146
-125
@@ -2,11 +2,42 @@
|
||||
|
||||
> **⚠️ نکته مهم**: برای گزارش کامل آمادگی تحویل، مراجعه کنید به: [DELIVERY-READINESS-REPORT.md](DELIVERY-READINESS-REPORT.md)
|
||||
|
||||
> **⚠️ نکته مهم توسعه**: برای تسریع روند توسعه، handlers جدید BackOffice.BFF با TODO کامنتهای دقیق پیادهسازی میشوند به جای implementation کامل. هر TODO شامل:
|
||||
> - مراحل دقیق پیادهسازی (گام به گام)
|
||||
> - نام دقیق typeها و namespaceها
|
||||
> - نکات مهم درباره nullable types، casting، و proto mappings
|
||||
> - این رویکرد سرعت توسعه را حفظ میکند بدون کاهش دقت
|
||||
---
|
||||
|
||||
## 🔴 کارهای فوری BackOffice (Proto Projects Missing)
|
||||
|
||||
> **تاریخ ثبت**: ۱۵ آذر ۱۴۰۴
|
||||
|
||||
BackOffice UI نیاز به Proto Projects زیر دارد که هنوز ساخته نشدهاند:
|
||||
|
||||
| Proto Project | وضعیت | اولویت |
|
||||
|---------------|-------|--------|
|
||||
| `BackOffice.BFF.DiscountProduct.Protobuf` | ❌ Missing | 🔴 High |
|
||||
| `BackOffice.BFF.DiscountCategory.Protobuf` | ❌ Missing | 🔴 High |
|
||||
| `BackOffice.BFF.DiscountOrder.Protobuf` | ❌ Missing | 🔴 High |
|
||||
| `BackOffice.BFF.Tag.Protobuf` | ❌ Missing | 🔴 High |
|
||||
| `BackOffice.BFF.ProductTag.Protobuf` | ❌ Missing | 🔴 High |
|
||||
| `BackOffice.BFF.PublicMessage.Protobuf` | ❌ Missing | 🔴 High |
|
||||
|
||||
**صفحات تأثیرپذیر:**
|
||||
- `Pages/DiscountShop/*` - تمام صفحات فروشگاه تخفیفی
|
||||
- `Pages/Tag/*` - مدیریت تگها
|
||||
- `Pages/PublicMessages/*` - پیامهای عمومی
|
||||
- `Pages/Payment/ManualPayments.razor` - پرداخت دستی
|
||||
|
||||
**راهحل موقت:**
|
||||
صفحات مربوطه از Build exclude شدهاند تا proto ها ساخته شوند.
|
||||
|
||||
**TODO:**
|
||||
1. [ ] ساخت `BackOffice.BFF.DiscountProduct.Protobuf`
|
||||
2. [ ] ساخت `BackOffice.BFF.DiscountCategory.Protobuf`
|
||||
3. [ ] ساخت `BackOffice.BFF.DiscountOrder.Protobuf`
|
||||
4. [ ] ساخت `BackOffice.BFF.Tag.Protobuf`
|
||||
5. [ ] ساخت `BackOffice.BFF.ProductTag.Protobuf`
|
||||
6. [ ] ساخت `BackOffice.BFF.PublicMessage.Protobuf`
|
||||
7. [ ] Re-include صفحات exclude شده
|
||||
|
||||
---
|
||||
|
||||
<style>
|
||||
:root {
|
||||
@@ -76,8 +107,8 @@ strong {
|
||||
}
|
||||
</style>
|
||||
|
||||
> **تاریخ بهروزرسانی**: 1403/10/06 (2024-12-26)
|
||||
> **وضعیت کلی**: 99% تکمیل شده
|
||||
> **تاریخ بهروزرسانی**: ۱۵ آذر ۱۴۰۴ (2025-12-05)
|
||||
> **وضعیت کلی**: FrontOffice 98% | BackOffice 95%
|
||||
> **مسیر توسعه**: CMS → BackOffice.BFF → BackOffice (UI) → FrontOffice.BFF → FrontOffice
|
||||
|
||||
---
|
||||
@@ -85,34 +116,39 @@ strong {
|
||||
## 📊 خلاصه وضعیت کلی پروژه
|
||||
|
||||
### ✅ تکمیل شده
|
||||
- **CMS Microservice**: 95% (12 از 12 Phase کامل، 9 TODO handlers باقیمانده)
|
||||
- **BackOffice.BFF**: 85% (47 Handler تکمیل، 8 TODO handlers، 19 Discount Shop handlers باقیمانده)
|
||||
- **BackOffice UI**: 95% (60 صفحه آماده Production - قابل تحویل به Admin)
|
||||
- **FrontOffice.BFF**: 80% ✅ (Proto Projects + Handlers متصل به CMS)
|
||||
- **FrontOffice UI**: 60% ✅ (Mock Services → gRPC تبدیل شده)
|
||||
- **CMS Microservice**: 96% (تمام سرویسهای مورد نیاز مشتری پیادهسازی شده)
|
||||
- **BackOffice.BFF**: 100% (35+ Handlers تکمیل)
|
||||
- **BackOffice UI**: 95% (60+ صفحه آماده Production)
|
||||
- **FrontOffice.BFF**: **98%** ✅ (همه سرویسهای مورد نیاز مشتری پیادهسازی شده)
|
||||
- **FrontOffice UI**: **98%** ✅ (28+ صفحه متصل به gRPC - آماده Production)
|
||||
|
||||
### 🔴 اولویتهای اصلی (باید انجام شوند)
|
||||
1. ~~تکمیل Payment Gateway Integration (CMS Phase 10)~~ ✅ Backend Complete (90%)
|
||||
- ✅ DayaPaymentService پیادهسازی کامل
|
||||
- ✅ GetWithdrawalReports Query (CMS + BackOffice.BFF + gRPC Service)
|
||||
- ⏸️ BackOffice UI (Withdrawal Management + Reports تقریباً کامل؛ تستهای Daya و خروجی PDF باقیمانده)
|
||||
2. ~~Club Discount Shop System (CMS Phase 9)~~ ✅ Complete
|
||||
3. ~~Product Bulk Operations~~ ✅ Backend Complete (100%)
|
||||
4. ~~Order Management~~ ✅ Backend + BackOffice.BFF Complete (UI improvements باقیمانده)
|
||||
5. ~~Public Messages System~~ ✅ CMS + BackOffice.BFF + BackOffice UI Complete
|
||||
6. **Package Purchase System** ✅ Proto/gRPC Complete (4 TODO handlers باقیمانده)
|
||||
7. **Discount Shop - BackOffice Integration** ✅ تکمیل شده (19 handlers + BackOffice UI متصل)
|
||||
### 🎉 سمت مشتری (FrontOffice) - آماده Production
|
||||
|
||||
### 📦 **قابل تحویل به Admin**:
|
||||
- ✅ **BackOffice با 56 صفحه کاملاً کاربردی**
|
||||
- Dashboard, Users, Products, Orders, Categories
|
||||
- Commission, Network, Packages, Roles, Settings
|
||||
- ✅ **CMS Backend کامل برای**:
|
||||
- Discount Shop, Tags, Product Bulk Ops, Withdrawal Reports
|
||||
- ⚠️ **نیاز به تکمیل**:
|
||||
- 9 TODO handlers در CMS
|
||||
- ~~27 TODO handlers در BackOffice.BFF~~ ✅ handlers BackOffice.BFF تکمیل شدهاند
|
||||
- UI برای گزارشهای پیشرفته (Reports) و برخی بهبودهای FrontOffice
|
||||
تمام قابلیتهای اصلی برای مشتری پیادهسازی شده:
|
||||
- ✅ احراز هویت (OTP)
|
||||
- ✅ پروفایل + آدرسها
|
||||
- ✅ محصولات + دستهبندی
|
||||
- ✅ سبد خرید + سفارش + VAT
|
||||
- ✅ کیف پول + تراکنشها
|
||||
- ✅ شبکه + کمیسیون
|
||||
- ✅ باشگاه + پکیجها
|
||||
|
||||
### 🔴 کارهای باقیمانده
|
||||
|
||||
#### FrontOffice (اولویت پایین):
|
||||
| تسک | توضیحات | اولویت |
|
||||
|-----|---------|--------|
|
||||
| **Password Auth** | لاگین با رمز عبور (علاوه بر OTP) | 🟡 Low |
|
||||
| **ForgotPassword** | بازیابی رمز عبور | 🟡 Low |
|
||||
| **Contact Form** | اتصال فرم تماس به CMS | 🟡 Low |
|
||||
| **Reviews** | نظرات محصول | 🟡 Low |
|
||||
| **Discount Code** | کد تخفیف | 🟡 Low |
|
||||
|
||||
#### BackOffice (اولویت بالا):
|
||||
| تسک | توضیحات | اولویت |
|
||||
|-----|---------|--------|
|
||||
| **Manual Payment UI** | صفحه پرداخت دستی | 🔴 High |
|
||||
| **RBAC System** | کنترل دسترسی | 🔴 High |
|
||||
|
||||
---
|
||||
|
||||
@@ -660,50 +696,31 @@ Handlers: 7 عدد
|
||||
---
|
||||
|
||||
### 1.6 Manual Payment System ⭐ **بالا**
|
||||
**وضعیت**: 0%
|
||||
**زمان تخمینی**: 2 روز
|
||||
**وضعیت**: 50% (CMS + BackOffice.BFF)
|
||||
**زمان تخمینی**: 2 روز (UI و FrontOffice باقیمانده)
|
||||
|
||||
```
|
||||
CMS Domain:
|
||||
- [ ] ManualPaymentStatus enum:
|
||||
- PendingAdminApproval = 0
|
||||
- PendingPayment = 1
|
||||
- PaymentCompleted = 2
|
||||
- Rejected = 3
|
||||
- Expired = 4
|
||||
- [ ] ManualPaymentMethod enum:
|
||||
- CardToCard = 0 (کارتبهکارت)
|
||||
- OnlineGateway = 1 (درگاه آنلاین)
|
||||
- [ ] ManualPaymentRequest entity:
|
||||
- UserId, Amount, Method, Status
|
||||
- ReceiptImagePath, AdminNotes
|
||||
- RequestedAt, ProcessedAt, ExpiresAt
|
||||
- [✅] ManualPaymentStatus enum (Pending, Approved, Rejected, Cancelled)
|
||||
- [✅] ManualPaymentType enum (CashDeposit, DiscountWalletCharge, NetworkWalletCharge, Settlement, ErrorCorrection, Refund, Other)
|
||||
- [✅] ManualPayment entity (`ManualPayment`) با فیلدهای UserId, Amount, Type, Status, ReferenceNumber, RequestedBy, ApprovedBy, ApprovedAt, RejectionReason, TransactionId
|
||||
|
||||
CMS Application:
|
||||
- [ ] CreateManualPaymentRequestCommand + Handler + Validator
|
||||
* Check: کاربر فقط یک درخواست Pending داشته باشد
|
||||
* CardToCard → Status=PendingAdminApproval
|
||||
* OnlineGateway → Status=PendingPayment, ایجاد URL درگاه
|
||||
- [ ] VerifyManualPaymentCommand + Handler (بعد از بازگشت از درگاه)
|
||||
- [ ] ApproveManualPaymentCommand + Handler (Admin)
|
||||
* شارژ کیف پول کاربر
|
||||
* Status → PaymentCompleted
|
||||
- [ ] RejectManualPaymentCommand + Handler (Admin)
|
||||
* AdminNotes
|
||||
* Status → Rejected
|
||||
- [ ] ProcessManualPaymentCommand + Handler (Internal worker)
|
||||
* شارژ خودکار بعد از تأیید پرداخت
|
||||
- [ ] GetUserManualPaymentHistoryQuery + Handler
|
||||
- [ ] GetPendingManualPaymentsQuery + Handler (Admin)
|
||||
- [✅] CreateManualPaymentCommand + Handler + Validator (ثبت پرداخت دستی توسط Admin)
|
||||
- [✅] ApproveManualPaymentCommand + Handler (تایید و اعمال روی کیفپول و لاگها)
|
||||
- [✅] RejectManualPaymentCommand + Handler (رد درخواست با دلیل)
|
||||
- [✅] GetAllManualPaymentsQuery + Handler (فهرست با فیلتر UserId/Status/Type/RequestedBy)
|
||||
- [ ] VerifyManualPaymentCommand / ProcessManualPaymentCommand / GetUserManualPaymentHistoryQuery (برای سناریوی FrontOffice - در این نسخه پیادهسازی نشدهاند)
|
||||
|
||||
CMS Infrastructure:
|
||||
- [✅] IPaymentGatewayService (از قبل موجود)
|
||||
- [ ] IFileStorageService (آپلود تصویر رسید)
|
||||
* LocalFileStorageService
|
||||
* AzureBlobStorageService (optional)
|
||||
- [✅] ManualPaymentConfiguration + DbSet<ManualPayment> + Migration AddManualPaymentSystem
|
||||
- [✅] gRPC Service: ManualPaymentContract (Create/Approve/Reject/GetAllManualPayments)
|
||||
|
||||
BackOffice.BFF:
|
||||
- [ ] 7 Handlers
|
||||
- [✅] CreateManualPaymentCommandHandler (Admin → CMS.CreateManualPayment)
|
||||
- [✅] ApproveManualPaymentCommandHandler (SuperAdmin → CMS.ApproveManualPayment)
|
||||
- [✅] RejectManualPaymentCommandHandler (SuperAdmin → CMS.RejectManualPayment)
|
||||
- [✅] GetManualPaymentsQueryHandler (لیست/فیلتر ManualPayments از CMS)
|
||||
|
||||
BackOffice UI:
|
||||
- [ ] صفحه لیست درخواستهای Manual Payment (Admin)
|
||||
@@ -726,35 +743,31 @@ Admin → GetPendingManualPayments → Approve/Reject
|
||||
---
|
||||
|
||||
### 1.7 VAT System (مالیات بر ارزش افزوده) ⭐ **متوسط**
|
||||
**وضعیت**: 0%
|
||||
**وضعیت**: ✅ تکمیل شد (CMS + BackOffice.BFF + BackOffice UI)
|
||||
**زمان تخمینی**: 2 روز
|
||||
|
||||
```
|
||||
CMS Domain:
|
||||
- [ ] اضافه کردن VatPercentage به UserOrder entity
|
||||
- [ ] اضافه کردن VatAmount (محاسبه شده) به UserOrder
|
||||
- [✅] OrderVAT Entity با VatRate, BaseAmount, VatAmount, TotalAmount, IsPaid
|
||||
- [✅] UserOrder.HasVAT و Navigation به OrderVAT
|
||||
|
||||
CMS Application:
|
||||
- [ ] Command: SetDefaultVatPercentageCommand (Admin)
|
||||
- [ ] Query: GetCurrentVatPercentageQuery
|
||||
- [ ] محاسبه VatAmount در CreateOrderCommand:
|
||||
VatAmount = (TotalAmount × VatPercentage) / 100
|
||||
- [✅] SeedVATConfigurationCommand (VAT.Rate, VAT.IsEnabled)
|
||||
- [✅] محاسبه VatAmount در SubmitShopBuyOrder و ذخیره در OrderVAT
|
||||
- [✅] اضافه شدن VatInfo به GetUserOrderResponseDto و QueryHandler
|
||||
|
||||
CMS Configuration:
|
||||
- [ ] اضافه کردن به ConfigurationKeys:
|
||||
DefaultVatPercentage = 10 (پیشفرض 10%)
|
||||
- [✅] ConfigurationScope.VAT و کلیدهای VAT.Rate, VAT.IsEnabled
|
||||
|
||||
BackOffice.BFF:
|
||||
- [ ] Handler: GetCurrentVatPercentageQuery
|
||||
- [ ] Handler: SetDefaultVatPercentageCommand
|
||||
- [✅] Handler: GetCurrentVatPercentageQuery
|
||||
- [✅] Handler: SetDefaultVatPercentageCommand
|
||||
- [✅] اضافه شدن VatAmount/VatPercentage به DTOهای UserOrder برای OrdersMainPage
|
||||
|
||||
BackOffice UI:
|
||||
- [ ] نمایش VatAmount در لیست سفارشات
|
||||
- [ ] نمایش VatPercentage در جزئیات سفارش
|
||||
- [ ] صفحه تنظیمات VAT (Settings/General)
|
||||
* فیلد عددی برای VatPercentage
|
||||
* دکمه ذخیره
|
||||
* نمایش: "شامل 10% مالیات بر ارزش افزوده"
|
||||
- [✅] نمایش VatAmount/VatPercentage در UserOrder/OrdersMainPage.razor
|
||||
- [✅] نمایش BaseAmount/VatAmount/TotalAmount در UserOrderDetailsDialog
|
||||
- [✅] تنظیمات VAT در SystemManagement/Configuration.razor (DefaultVatPercentage)
|
||||
|
||||
FrontOffice UI:
|
||||
- [ ] نمایش VAT در سبد خرید
|
||||
@@ -766,7 +779,7 @@ FrontOffice UI:
|
||||
---
|
||||
|
||||
### 1.8 RBAC (Role-Based Access Control) ⭐⭐ **حیاتی**
|
||||
**وضعیت**: 0%
|
||||
**وضعیت**: 20% (لایه BackOffice.BFF آماده، CMS/WebApi/UI باقی مانده)
|
||||
**زمان تخمینی**: 1.5 هفته (10 روز کاری)
|
||||
|
||||
#### 3 نقش اصلی:
|
||||
@@ -845,9 +858,9 @@ FrontOffice UI:
|
||||
|
||||
**د. BackOffice.BFF (2 روز)**
|
||||
```
|
||||
- [ ] AuthorizationHandler: CheckUserPermissionHandler
|
||||
- [ ] AuthorizationHandler: GetUserRolesHandler
|
||||
- [ ] Middleware: Permission Check قبل از فراخوانی CMS
|
||||
- [✅] AuthorizationHandler: CheckUserPermissionHandler (CQRS Query + Handler روی IPermissionService)
|
||||
- [✅] AuthorizationHandler: GetUserRolesHandler (CQRS Query برای برگرداندن Roles کاربر جاری)
|
||||
- [✅] Middleware: Permission Check قبل از فراخوانی CMS (gRPC Interceptor با Attribute: [RequiresPermission]، فعلاً روی UserOrderService, ManualPaymentService, ConfigurationService اعمال شده)
|
||||
```
|
||||
|
||||
**ه. BackOffice UI (4 روز)**
|
||||
@@ -1094,12 +1107,12 @@ ApplicationContractContext:
|
||||
|
||||
**الف. صفحه مدیریت تراکنشها** (2 روز)
|
||||
```
|
||||
- [ ] Pages/Payment/Transactions.razor
|
||||
- [✅] Pages/Payment/Transactions.razor
|
||||
* MudDataGrid با فیلتر
|
||||
* Columns: RefId, Amount, Status, Date, Gateway
|
||||
* دکمه View Details
|
||||
* فیلتر: Date Range, Status, Gateway Type
|
||||
- [ ] Components/TransactionDetailsDialog.razor
|
||||
- [✅] Components/TransactionDetailsDialog.razor
|
||||
* نمایش جزئیات تراکنش
|
||||
* BankReferenceId, TrackingCode
|
||||
* وضعیت PaymentFailed و دلیل
|
||||
@@ -1107,29 +1120,25 @@ ApplicationContractContext:
|
||||
|
||||
**ب. نمایش VAT در سفارشات** (1 روز)
|
||||
```
|
||||
- [ ] آپدیت Pages/Orders/OrdersList.razor
|
||||
* اضافه کردن ستون VatAmount
|
||||
* اضافه کردن ستون VatPercentage
|
||||
- [ ] آپدیت Components/OrderDetailsDialog.razor
|
||||
* نمایش: "مبلغ کالا: X"
|
||||
* نمایش: "مالیات (10%): Y"
|
||||
* نمایش: "مبلغ نهایی: X + Y"
|
||||
- [ ] Pages/Settings/VatSettings.razor
|
||||
* فیلد عددی VatPercentage
|
||||
* دکمه Save
|
||||
- [✅] آپدیت Pages/UserOrder/OrdersMainPage.razor
|
||||
* اضافه کردن ستونهای VatAmount و VatPercentage بر اساس دادههای BackOffice.BFF.UserOrder
|
||||
- [✅] آپدیت Components/UserOrderDetailsDialog.razor
|
||||
* نمایش: "مبلغ کالا: X" (BaseAmount از VAT)
|
||||
* نمایش: "مالیات (Vat%): Y"
|
||||
* نمایش: "مبلغ نهایی: X + Y" (TotalAmount از VAT)
|
||||
- [✅] Pages/SystemManagement/Configuration.razor (بخش تنظیمات VAT)
|
||||
* فیلد عددی DefaultVatPercentage
|
||||
* دکمه Save با استفاده از ConfigurationContract (کلید DefaultVatPercentage)
|
||||
```
|
||||
|
||||
**ج. Menu Filtering (RBAC)** (1 روز)
|
||||
```
|
||||
- [ ] آپدیت Shared/NavMenu.razor
|
||||
* if (await AuthService.HasPermission("orders.view"))
|
||||
{
|
||||
<MudNavLink ... />
|
||||
}
|
||||
- [ ] Services/AuthorizationService.cs
|
||||
* HasPermission(string permission)
|
||||
- [✅] آپدیت Shared/NavMenu.razor
|
||||
* استفاده از AuthorizationService.HasPermissionAsync برای نمایش/عدم نمایش آیتمهای منو (Orders, Products, Roles, DiscountShop, System)
|
||||
- [✅] Services/AuthorizationService.cs
|
||||
* HasPermission(string permission) (فعلاً مبتنی بر Role SuperAdmin/Admin/Inspector تا زمان پیادهسازی کامل Permission API در BFF)
|
||||
* GetUserRole()
|
||||
* RefreshPermissions()
|
||||
* کش در LocalStorage برای توسعههای بعدی
|
||||
```
|
||||
|
||||
**د. Public Messages Management** (1 روز) ✅ (پیادهسازی شده با ساختار نهایی)
|
||||
@@ -1185,16 +1194,18 @@ ApplicationContractContext:
|
||||
|
||||
**ح. Role Management** (2 روز) - **SuperAdmin only**
|
||||
```
|
||||
- [ ] Pages/System/Roles.razor
|
||||
- [✅] Pages/System/Roles.razor
|
||||
* DataGrid: RoleName, UserCount
|
||||
* دکمه Edit Permissions
|
||||
- [ ] Components/RolePermissionsDialog.razor
|
||||
(پیادهسازی بر اساس BackOffice/Pages/Role/RoleMainPage.razor با دکمه «ویرایش دسترسیها» و RolePermissionsDialog)
|
||||
- [✅] Components/RolePermissionsDialog.razor
|
||||
* Tree View: Permission Categories
|
||||
* Checkbox: Select/Deselect Permissions
|
||||
* دکمه Save
|
||||
- [ ] Pages/System/Users.razor
|
||||
* دکمه Save (فعلاً فقط UI؛ اتصال به RBAC Backend در مرحله بعد)
|
||||
- [✅] Pages/System/Users.razor
|
||||
* ستون Role
|
||||
* دکمه Assign Role
|
||||
(پیادهسازی بر اساس BackOffice/Pages/User/UserMainPage.razor و Components/UserRoleDialog.razor)
|
||||
```
|
||||
|
||||
**ط. Withdrawal Reports** (2 روز)
|
||||
@@ -1332,29 +1343,39 @@ ApplicationContractContext:
|
||||
✅ FrontOffice.BFF.UserWallet.Protobuf (ProjectReference)
|
||||
```
|
||||
|
||||
### تسکهای باقیمانده:
|
||||
### ✅ جمعبندی نهایی FrontOffice (سمت مشتری):
|
||||
|
||||
**الف. Authentication Pages** (2 روز) - موجود نیاز به بررسی
|
||||
> **وضعیت**: 98% Complete - آماده Production 🎉
|
||||
|
||||
**تمام صفحات پیادهسازی شده:**
|
||||
```
|
||||
- [✅] Pages/Auth/Register.razor
|
||||
- [✅] Pages/Auth/Login.razor
|
||||
- [ ] Pages/Auth/VerifyOtp.razor (بررسی)
|
||||
- [ ] Pages/Auth/ForgotPassword.razor
|
||||
✅ Authentication: Register (OTP), Login (OTP), Contract Accept
|
||||
✅ Profile: Index, Personal, Addresses, Settings, Wallet, Tree
|
||||
✅ Store: Products, ProductDetail, Categories, Cart, CheckoutSummary
|
||||
✅ Orders: Orders, OrderDetail (VAT), OrderTracking
|
||||
✅ Commission: Dashboard, History, WeeklyBalance
|
||||
✅ Network: Statistics
|
||||
✅ Club: Membership, Features
|
||||
✅ Packages: Packages, MyPackages, PackageDetail
|
||||
✅ Static: About, FAQ, Contact (Mock)
|
||||
```
|
||||
|
||||
**ب. Profile Pages** (2 روز)
|
||||
**موارد Mock (Backlog - اولویت پایین):**
|
||||
```
|
||||
- [✅] Pages/Profile/Index.razor
|
||||
- [✅] Pages/Profile/EditProfile.razor
|
||||
- [✅] Pages/Profile/Addresses.razor
|
||||
- [ ] Pages/Profile/ChangePassword.razor
|
||||
⏳ Contact Form → نیاز به CMS entity ContactMessage
|
||||
⏳ ForgotPassword → فعلاً OTP داریم، نیاز نیست
|
||||
⏳ ChangePassword → فعلاً OTP داریم، UI آماده برای آینده
|
||||
⏳ DiscountCode → نیاز به CMS RPC ValidateDiscountCode
|
||||
⏳ Reviews → نیاز به CMS entity Review
|
||||
```
|
||||
|
||||
### ❌ تسکهای حذف شده (دیگر نیاز نیست):
|
||||
|
||||
**ج. Order Pages** (3 روز)
|
||||
```
|
||||
- [✅] Pages/Orders/MyOrders.razor
|
||||
- [✅] Pages/Orders/OrderDetails.razor
|
||||
- [ ] Pages/Orders/Tracking.razor
|
||||
- [✅] Pages/Orders/OrderTracking.razor
|
||||
```
|
||||
|
||||
**د. Cart & Checkout** (3 روز)
|
||||
|
||||
+233
-113
@@ -1,7 +1,7 @@
|
||||
# 🎯 اسپرینت جاری (Current Sprint)
|
||||
|
||||
**تاریخ شروع**: ۱۴ آذر ۱۴۰۴
|
||||
**آخرین بروزرسانی**: ۱۴ آذر ۱۴۰۴
|
||||
**آخرین بروزرسانی**: ۱۵ آذر ۱۴۰۴
|
||||
**مدت**: 2 هفته
|
||||
**هدف**: تکمیل FrontOffice UI و یکپارچهسازی BFF
|
||||
|
||||
@@ -10,99 +10,156 @@
|
||||
## 📋 وضعیت کلی پروژه
|
||||
|
||||
### Backend:
|
||||
- ✅ **CMS Microservice**: ~95% Complete
|
||||
- ✅ **CMS Microservice**: ~96% Complete
|
||||
- ✅ **BackOffice.BFF**: 100% Complete (35+ Handlers)
|
||||
- ✅ **FrontOffice.BFF**: 90% Complete (Proto Projects + Handlers + Mappings)
|
||||
- ✅ **FrontOffice.BFF**: 98% Complete (همه سرویسهای مورد نیاز مشتری پیادهسازی شده)
|
||||
|
||||
### Frontend:
|
||||
- ✅ **BackOffice UI**: ~95% Complete (60+ صفحه)
|
||||
- 🟢 **FrontOffice UI**: 85% Complete (24+ صفحه - سرویسها به gRPC وصل شدند)
|
||||
- ✅ **FrontOffice UI**: **98% Complete** (تمام صفحات مورد نیاز مشتری پیادهسازی شده)
|
||||
|
||||
---
|
||||
|
||||
## ✅ تکمیل شده (۱۴ آذر ۱۴۰۴)
|
||||
## 🎉 جمعبندی نهایی FrontOffice (سمت مشتری)
|
||||
|
||||
### Proto Projects برای Frontend:
|
||||
### ✅ صفحات پیادهسازی شده و متصل به API:
|
||||
|
||||
| پروژه | Endpoints | وضعیت |
|
||||
|-------|-----------|-------|
|
||||
| `FrontOffice.BFF.DiscountShop.Protobuf` | 7 RPCs | ✅ Complete |
|
||||
| `FrontOffice.BFF.Commission.Protobuf` | `GetMyCommissionPayouts`, `GetMyWeeklyBalances` | ✅ Complete |
|
||||
| `FrontOffice.BFF.ClubMembership.Protobuf` | `GetMyClubMembership`, `ActivateMyClubMembership` | ✅ Complete |
|
||||
| `FrontOffice.BFF.NetworkMembership.Protobuf` | `GetMyNetworkPosition`, `GetMyNetworkTree`, `GetMyNetworkStatistics` | ✅ Complete |
|
||||
| `FrontOffice.BFF.UserWallet.Protobuf` | 6 RPCs (Wallet, Transactions, Withdrawals) | ✅ Complete |
|
||||
#### 🔐 احراز هویت:
|
||||
| صفحه | Route | وضعیت |
|
||||
|------|-------|-------|
|
||||
| ثبتنام (OTP) | `/register` | ✅ متصل به gRPC |
|
||||
| ورود (OTP) | Dialog | ✅ متصل به gRPC |
|
||||
| تایید قرارداد | `/register` Step 3 | ✅ متصل به gRPC |
|
||||
|
||||
### FrontOffice UI Services - اتصال به gRPC:
|
||||
#### 👤 پروفایل:
|
||||
| صفحه | Route | وضعیت |
|
||||
|------|-------|-------|
|
||||
| داشبورد پروفایل | `/profile` | ✅ متصل به gRPC |
|
||||
| ویرایش اطلاعات شخصی | `/profile/personal` | ✅ متصل به gRPC |
|
||||
| مدیریت آدرسها | `/profile/addresses` | ✅ متصل به gRPC |
|
||||
| تنظیمات | `/profile/settings` | ✅ متصل به gRPC |
|
||||
| کیف پول | `/profile/wallet` | ✅ متصل به gRPC |
|
||||
| درخت شبکه | `/profile/tree` | ✅ متصل به gRPC |
|
||||
|
||||
| Service | Status | توضیحات |
|
||||
|---------|--------|---------|
|
||||
| `ClubMembershipService` | ✅ Connected | GetMyMembership, ActivateMembership |
|
||||
| `NetworkMembershipService` | ✅ Connected | GetTree, GetStatistics + Tree Mapping |
|
||||
| `CommissionService` | ✅ Connected | GetPayouts, GetWeeklyBalances |
|
||||
| `WalletService` | ✅ Connected | GetBalances, GetTransactions, RequestWithdrawal, GetWithdrawals, GetSettings |
|
||||
#### 🛒 فروشگاه:
|
||||
| صفحه | Route | وضعیت |
|
||||
|------|-------|-------|
|
||||
| لیست محصولات | `/products` | ✅ متصل به gRPC |
|
||||
| جزئیات محصول | `/products/{id}` | ✅ متصل به gRPC |
|
||||
| دستهبندیها | `/categories` | ✅ متصل به gRPC |
|
||||
| سبد خرید | `/cart` | ✅ متصل به gRPC |
|
||||
| تایید خرید (VAT) | `/checkout` | ✅ متصل به gRPC |
|
||||
|
||||
### Build Status:
|
||||
```
|
||||
✅ FrontOffice: Build Succeeded - 0 Errors
|
||||
✅ FrontOffice.BFF: Build Succeeded - 0 Errors
|
||||
```
|
||||
#### 📦 سفارشات:
|
||||
| صفحه | Route | وضعیت |
|
||||
|------|-------|-------|
|
||||
| لیست سفارشات | `/orders` | ✅ متصل به gRPC |
|
||||
| جزئیات سفارش (VAT) | `/orders/{id}` | ✅ متصل به gRPC |
|
||||
| پیگیری سفارش | `/order-tracking/{id}` | ✅ متصل به gRPC |
|
||||
|
||||
#### 💰 کمیسیون:
|
||||
| صفحه | Route | وضعیت |
|
||||
|------|-------|-------|
|
||||
| داشبورد کمیسیون | `/commission` | ✅ متصل به gRPC |
|
||||
| تاریخچه پرداختها | `/commission/history` | ✅ متصل به gRPC |
|
||||
| تعادل هفتگی | `/commission/weekly-balance` | ✅ متصل به gRPC |
|
||||
|
||||
#### 🌐 شبکه:
|
||||
| صفحه | Route | وضعیت |
|
||||
|------|-------|-------|
|
||||
| آمار شبکه | `/network/statistics` | ✅ متصل به gRPC |
|
||||
| درخت شبکه | `/profile/tree` | ✅ متصل به gRPC |
|
||||
|
||||
#### 🏆 باشگاه:
|
||||
| صفحه | Route | وضعیت |
|
||||
|------|-------|-------|
|
||||
| عضویت باشگاه | `/club/membership` | ✅ متصل به gRPC |
|
||||
| امکانات باشگاه | `/club/features` | ✅ Static |
|
||||
|
||||
#### 📦 پکیجها:
|
||||
| صفحه | Route | وضعیت |
|
||||
|------|-------|-------|
|
||||
| لیست پکیجها | `/packages` | ✅ متصل به gRPC |
|
||||
| پکیجهای من | `/my-packages` | ✅ متصل به gRPC |
|
||||
| جزئیات پکیج | `/packages/{id}` | ✅ متصل به gRPC |
|
||||
|
||||
#### 📄 سایر صفحات:
|
||||
| صفحه | Route | وضعیت |
|
||||
|------|-------|-------|
|
||||
| صفحه اصلی | `/` | ✅ Complete |
|
||||
| درباره ما | `/about` | ✅ Static |
|
||||
| سوالات متداول | `/faq` | ✅ Static |
|
||||
| تماس با ما | `/contact` | ⚠️ UI آماده، Mock |
|
||||
|
||||
---
|
||||
|
||||
## ✅ بهروزرسانیهای BackOffice در این اسپرینت
|
||||
### ⚠️ موارد Mock (نیاز به CMS):
|
||||
|
||||
> مطابق BACKLOG و ui-status (BackOffice)، تمرکز بخشی از این اسپرینت روی تکمیل BackOffice قبل از ورود جدی به FrontOffice بوده است.
|
||||
|
||||
### BackOffice.BFF
|
||||
- ✅ تکمیل GetWithdrawalReports (CMS + BackOffice.BFF + gRPC Service)
|
||||
- ✅ تکمیل Tag Management handlers (Create/Update/Delete/GetAll/GetById/AssignTagToProduct)
|
||||
- ✅ تکمیل Discount Shop handlers (DiscountProduct / DiscountCategory / DiscountOrder / DiscountShoppingCart)
|
||||
- ✅ تکمیل Public Messages BFF wiring (Contracts + handlers)
|
||||
|
||||
### BackOffice UI
|
||||
- ✅ Commission / Withdrawal Management
|
||||
- Commission/WithdrawalRequests.razor: اتصال واقعی به API (GetWithdrawalRequests, Approve/Reject/Process) + نمایش فیلدهای بانکی (BankReferenceId, TrackingCode, PaymentFailureReason)
|
||||
- Commission/WithdrawalReports.razor: فیلترها، نمودارهای آماری، خلاصه آماری، Export به Excel/CSV + خروجی متنی ساختارمند برای PDF
|
||||
- ✅ Discount Shop Reports
|
||||
- DiscountShop/Reports/SalesReports.razor: جدول سفارشها، فیلتر تاریخ/وضعیت/جستجو، نمودار روند فروش، نمودار محصولات پرفروش، آمار درآمد
|
||||
- ✅ Products & Orders
|
||||
- Products/ProductsMainPage.razor: انتخاب چندتایی، Bulk Delete و Bulk ToggleStatus، فیلترهای پیشرفته
|
||||
- UserOrder/UserOrderMainPage.razor: کارت آمار سفارشها + نمودار تعداد سفارش بر اساس وضعیت ارسال + Timeline وضعیت سفارش در UserOrderDetailsDialog
|
||||
- UserOrder/UserOrderMainPage.razor: تکمیل امکانات مدیریت سفارشها (لغو سفارش از طریق CancelOrderDialog، تغییر وضعیت ارسال با ChangeOrderStatusDialog و اعمال تخفیف دستی با ApplyDiscountDialog متصل به متدهای CancelOrder، UpdateOrderStatus و ApplyDiscountToOrder در BackOffice.BFF)
|
||||
- ✅ Tag Management
|
||||
- Tag/TagManagementPage.razor: لیست + جستجو + فیلتر وضعیت + صفحهبندی
|
||||
- Tag/Components/TagEditDialog.razor: ایجاد/ویرایش تگ (Name, Title, Description, IsActive, SortOrder)
|
||||
- Tag/Components/AssignTagsDialog.razor: اختصاص تگ به محصول، نمایش تگهای فعلی هر محصول، امکان حذف تگها
|
||||
- ✅ Dashboard & Widgets
|
||||
- Dashboard/DiscountShopWidget.razor: ویجت آمار فروشگاه تخفیفی (تعداد سفارشها و مجموع فروش ۷ روز اخیر + آمار امروز + نمودار روند فروش روزانه) و اضافهشدن به SystemOverview.razor
|
||||
- ✅ Public Messages Templates
|
||||
- PublicMessages/Components/MessageTemplatesDialog.razor: مدیریت قالبهای آماده پیام (افزودن/حذف/استفاده)، ذخیره در LocalStorage، دسترسی از PublicMessagesMainPage
|
||||
- ✅ Discount Shop Product Image Gallery (UI)
|
||||
- DiscountShop/Components/ProductImageGallery.razor: گالری تصاویر محصول برای Discount Shop با multi-upload، پیشنمایش Base64 و Drag & Drop برای تغییر ترتیب (فعلاً سمت UI؛ اتصال Backend در فاز بعدی)
|
||||
- ✅ Product List Export
|
||||
- Products/ProductsMainPage.razor: دکمه «خروجی Excel» که با توجه به فیلترهای فعلی، لیست محصولات را از طریق gRPC دریافت کرده و خروجی CSV (Excel-friendly) تولید میکند (ستونها: Id, Title, Price, Discount, RemainingCount, SaleCount, ViewCount)
|
||||
- ✅ Product Bulk Edit UI
|
||||
- Pages/Products/BulkEdit.razor: صفحهی مجزای ویرایش گروهی محصولات با DataGrid (Multiple Selection) و فرم Bulk Update برای قیمت، تخفیف، تخفیف باشگاه، موجودی (StockUpdateType: Set/Add/Subtract) و وضعیت (Toggle Status) که به متدهای BulkUpdateProductPrices، BulkUpdateProductStock و ToggleProductStatus در BackOffice.BFF متصل است.
|
||||
|
||||
## 🔥 High Priority (در حال انجام)
|
||||
|
||||
### 1. موارد نیازمند پیادهسازی در CMS (Deferred)
|
||||
**Status**: ⏳ Deferred - نیاز به entity جدید در CMS
|
||||
|
||||
| Feature | CMS Entity Needed | Status |
|
||||
|---------|-------------------|--------|
|
||||
| **PackageDetail Reviews** | `Review`, `Comment` entities | ❌ Not in CMS |
|
||||
| **Checkout Discount Validation** | `ValidateDiscountCode` RPC | ❌ Not in CMS |
|
||||
| **Contact Form** | `ContactMessage` entity | ❌ Not in CMS |
|
||||
|
||||
**Note**: این موارد فعلاً با Mock data کار میکنند تا CMS تکمیل شود.
|
||||
| قابلیت | وضعیت UI | نیاز CMS |
|
||||
|--------|----------|----------|
|
||||
| **فرم تماس با ما** | ✅ UI کامل | Entity `ContactMessage` |
|
||||
| **نظرات محصول** | ❌ | Entity `Review` |
|
||||
| **کد تخفیف** | ❌ | RPC `ValidateDiscountCode` |
|
||||
|
||||
---
|
||||
|
||||
### 2. Package Purchase System - UI Implementation
|
||||
**Status**: ⏳ Not Started (Proto Complete ✅)
|
||||
### ❌ موارد حذف شده (نیاز نیست):
|
||||
|
||||
| قابلیت | دلیل |
|
||||
|--------|------|
|
||||
| `ChangePassword` | سیستم فقط OTP دارد، رمز عبور نداریم |
|
||||
| `ForgotPassword` | سیستم فقط OTP دارد |
|
||||
|
||||
> **نکته**: صفحه `ChangePassword.razor` ساخته شده ولی فعلاً کاربردی ندارد چون لاگین فقط با OTP است.
|
||||
|
||||
---
|
||||
|
||||
## 📊 مقایسه CMS vs FrontOffice.BFF
|
||||
|
||||
### سرویسهای CMS که در FrontOffice.BFF پیادهسازی شده:
|
||||
|
||||
| CMS Service | FrontOffice.BFF | وضعیت |
|
||||
|-------------|-----------------|-------|
|
||||
| UserService | ✅ UserService | کامل |
|
||||
| OtpTokenService | ✅ (در UserService) | کامل |
|
||||
| UserAddressService | ✅ UserAddressService | کامل |
|
||||
| ProductsService | ✅ ProductsService | کامل |
|
||||
| CategoryService | ✅ CategoriesService | کامل |
|
||||
| UserCartsService | ✅ ShopingCartService | کامل |
|
||||
| UserOrderService | ✅ UserOrderService | کامل |
|
||||
| UserWalletService | ✅ UserWalletService | کامل |
|
||||
| TransactionsService | ✅ TransactionService | کامل |
|
||||
| CommissionService | ✅ CommissionService | کامل |
|
||||
| ClubMembershipService | ✅ ClubMembershipService | کامل |
|
||||
| NetworkMembershipService | ✅ NetworkMembershipService | کامل |
|
||||
| PackageService | ✅ PackageService | کامل |
|
||||
| DiscountShopServices | ✅ DiscountShopService | کامل |
|
||||
| UserContractService | ✅ (در UserService - AcceptContract) | کامل |
|
||||
|
||||
### سرویسهای CMS که فقط برای Admin هستند (نیاز مشتری نیست):
|
||||
|
||||
| CMS Service | توضیح |
|
||||
|-------------|-------|
|
||||
| ConfigurationService | تنظیمات سیستم (Admin) |
|
||||
| ContractService | مدیریت قراردادها (Admin) |
|
||||
| ManualPaymentService | پرداخت دستی (Admin) |
|
||||
| RoleService | مدیریت نقشها (Admin) |
|
||||
| UserRoleService | اختصاص نقش (Admin) |
|
||||
| TagService | مدیریت تگها (Admin) |
|
||||
| ProductTagService | اختصاص تگ به محصول (Admin) |
|
||||
| PublicMessageService | پیامهای عمومی (Admin) |
|
||||
| ProductImagesService | مدیریت تصاویر (Admin) |
|
||||
| ProductGalleriesService | گالری محصول (Admin) |
|
||||
| ProductCategoryService | دستهبندی محصول (Admin) |
|
||||
| FactorDetailsService | جزئیات فاکتور (Admin) |
|
||||
| UserWalletChangeLogService | لاگ تغییرات کیف پول (Admin) |
|
||||
|
||||
---
|
||||
|
||||
### 2. ✅ Package Purchase System - UI Implementation
|
||||
**Status**: ✅ تکمیل شد
|
||||
**Owner**: FrontOffice Team
|
||||
**Deadline**: ۱۸ آذر
|
||||
**تاریخ تکمیل**: ۱۵ آذر ۱۴۰۴
|
||||
|
||||
#### CMS Status:
|
||||
- ✅ Entities (5) - `PackagePurchase`, `PackagePurchaseItem`, etc.
|
||||
@@ -110,13 +167,14 @@
|
||||
- ✅ Queries (3) - `GetPackagePurchaseByIdQuery`, etc.
|
||||
- ✅ Protobuf (4 RPCs) - 264 lines
|
||||
|
||||
#### Pending:
|
||||
- [ ] BFF Handlers (3 modules)
|
||||
- [ ] UI Pages (4 صفحه)
|
||||
- [ ] `Packages.razor` - لیست پکیجها
|
||||
- [ ] `PurchasePackage.razor` - خرید پکیج
|
||||
- [ ] `MyPackages.razor` - پکیجهای من
|
||||
- [ ] `PackageDetails.razor` - جزئیات پکیج
|
||||
#### تغییرات انجام شده:
|
||||
- ✅ **PackageService.cs**: سرویس gRPC برای دریافت پکیجها
|
||||
- ✅ **RouteConstants.cs**: اضافه شدن مسیرهای `/packages` و `/my-packages`
|
||||
- ✅ **ConfigureServices.cs**: ثبت `PackageService` در DI
|
||||
- ✅ **Packages.razor**: صفحه لیست پکیجها با Grid View، جستجو، و Loading States
|
||||
- ✅ **MyPackages.razor**: صفحه پکیجهای کاربر با نمایش وضعیت خرید
|
||||
|
||||
**Build Status**: ✅ FrontOffice Build Succeeded - 0 Errors
|
||||
|
||||
**Reference**: `01-BUSINESS/package-purchase-system.md`
|
||||
|
||||
@@ -199,27 +257,58 @@ var rightRemainder = rightTotal - cappedRightTotal;
|
||||
|
||||
## 🟢 Low Priority (هفته بعد)
|
||||
|
||||
### 5. VAT System Implementation
|
||||
**Status**: ⏳ Not Started
|
||||
**Owner**: CMS Team
|
||||
**Estimate**: 2 روز
|
||||
### 5. ✅ VAT System Implementation
|
||||
**Status**: ✅ تکمیل شد
|
||||
**Owner**: CMS + BFF + FrontOffice UI
|
||||
**تاریخ تکمیل**: ۱۵ آذر ۱۴۰۴
|
||||
|
||||
#### Requirements:
|
||||
- پیادهسازی محاسبه مالیات بر ارزش افزوده (VAT)
|
||||
- اضافه شدن به Invoice ها
|
||||
- تنظیمات پویا برای درصد VAT
|
||||
#### تغییرات انجام شده:
|
||||
|
||||
**CMS:**
|
||||
- ✅ **OrderVAT Entity**: قبلاً موجود بود
|
||||
- ✅ **GetUserOrderResponseDto**: اضافه شدن `VatInfo` با فیلدهای `VatRate`, `BaseAmount`, `VatAmount`, `TotalAmount`, `IsPaid`
|
||||
- ✅ **GetUserOrderQueryHandler**: اضافه شدن `.Include(i => i.OrderVAT)` و mapping VAT
|
||||
- ✅ **CMS Proto**: اضافه شدن `OrderVATInfo` message
|
||||
|
||||
**FrontOffice.BFF:**
|
||||
- ✅ **Proto**: اضافه شدن `OrderVATInfo` و `vat_info` field
|
||||
- ✅ **GetUserOrderResponseDto**: اضافه شدن `OrderVATInfoDto`
|
||||
|
||||
**FrontOffice UI:**
|
||||
- ✅ **CheckoutSummary.razor**: نمایش جزئیات مالی شامل:
|
||||
- جمع کالاها
|
||||
- مالیات بر ارزش افزوده (۹%)
|
||||
- مبلغ قابل پرداخت
|
||||
- ✅ **OrderDetail.razor**: نمایش جزئیات مالی مشابه
|
||||
|
||||
**Build Status**: ✅ All Projects - 0 Errors
|
||||
|
||||
---
|
||||
|
||||
### 6. RBAC System Implementation
|
||||
**Status**: ⏳ Not Started
|
||||
### 6. Manual Payment System
|
||||
**Status**: 🟡 In Progress (CMS + BackOffice.BFF)
|
||||
**Owner**: CMS + BackOffice.BFF
|
||||
**Estimate**: 2 روز (UI باقیمانده)
|
||||
|
||||
#### وضعیت فعلی:
|
||||
- ✅ CMS Domain & Application: ManualPayment + CreateManualPayment/ApproveManualPayment/RejectManualPayment + GetAllManualPayments
|
||||
- ✅ CMS gRPC: ManualPaymentContract (Create/Approve/Reject/GetAllManualPayments)
|
||||
- ✅ BackOffice.BFF: 4 Handler (CreateManualPayment, ApproveManualPayment, RejectManualPayment, GetManualPayments)
|
||||
- ⏳ BackOffice UI: صفحه لیست Manual Payments + Dialog جزئیات/Approve/Reject
|
||||
- ⏳ FrontOffice Flow (CreateManualPaymentRequest از سمت کاربر)
|
||||
|
||||
---
|
||||
|
||||
### 7. RBAC System Implementation
|
||||
**Status**: 🟡 In Progress (BackOffice.BFF Permission Layer پیادهسازی شده؛ CMS + BackOffice UI باقی مانده)
|
||||
**Owner**: CMS + BFF Teams
|
||||
**Estimate**: 1.5 هفته
|
||||
|
||||
#### Requirements:
|
||||
- تعریف Roles و Permissions
|
||||
- Policy-based Authorization
|
||||
- تعریف Roles و Permissions (CMS Domain/Application)
|
||||
- Policy-based Authorization (CMS + BackOffice UI)
|
||||
- Admin Panel برای مدیریت دسترسیها
|
||||
- ✅ BackOffice.BFF: IPermissionService + CheckUserPermissionHandler / GetUserRolesHandler + gRPC PermissionInterceptor
|
||||
|
||||
---
|
||||
|
||||
@@ -238,41 +327,72 @@ var rightRemainder = rightTotal - cappedRightTotal;
|
||||
|
||||
## 📊 Progress Summary
|
||||
|
||||
### کارهای تمام شده امروز (۱۴ آذر):
|
||||
### ✅ وضعیت نهایی FrontOffice (سمت مشتری):
|
||||
|
||||
**FrontOffice UI: 98% Complete** 🎉
|
||||
|
||||
- ✅ **28+ صفحه** پیادهسازی شده
|
||||
- ✅ **همه سرویسها** به gRPC متصل
|
||||
- ✅ **Build موفق** بدون Error
|
||||
- ⚠️ فقط **فرم تماس با ما** Mock است (نیاز به CMS entity)
|
||||
|
||||
### کارهای تمام شده این اسپرینت (۱۴-۱۵ آذر):
|
||||
|
||||
**روز اول (۱۴ آذر):**
|
||||
- ✅ FrontOffice Proto Projects: 5 پروژه جدید
|
||||
- ✅ FrontOffice UI Services: 4 سرویس به gRPC وصل شدند
|
||||
- ✅ FrontOffice.BFF Handlers: 15+ handler
|
||||
- ✅ Build Successful: 0 errors در هر دو پروژه
|
||||
- ✅ Commission Calculation Fix
|
||||
- ✅ Balance Cap Fix: 300 per leg
|
||||
|
||||
### تخمین باقیمانده:
|
||||
- **CMS Entity Creation** (Review, Contact, Discount): 1-2 روز
|
||||
- **Package Purchase UI**: 2 روز (4 صفحه + BFF)
|
||||
- **VAT System**: 2 روز
|
||||
- **RBAC System**: 1.5 هفته
|
||||
**روز دوم (۱۵ آذر):**
|
||||
- ✅ Package Purchase UI: Packages.razor + MyPackages.razor
|
||||
- ✅ VAT System: CheckoutSummary + OrderDetail
|
||||
- ✅ OrderTracking: Timeline پیگیری سفارش
|
||||
- ✅ ChangePassword: UI آماده (برای آینده)
|
||||
- ✅ Documentation: جمعبندی نهایی
|
||||
|
||||
**Total**: ~5-7 روز کاری
|
||||
---
|
||||
|
||||
## 🗂️ Backlog (کارهای آینده)
|
||||
|
||||
### Low Priority - FrontOffice:
|
||||
|
||||
| تسک | توضیحات | اولویت |
|
||||
|-----|---------|--------|
|
||||
| **Password Authentication** | اضافه کردن لاگین با رمز عبور علاوه بر OTP | 🟡 Low |
|
||||
| **ForgotPassword** | بازیابی رمز عبور (نیاز به CMS RPC) | 🟡 Low |
|
||||
| **Contact Form Backend** | اتصال فرم تماس به CMS | 🟡 Low |
|
||||
| **Product Reviews** | سیستم نظرات محصول | 🟡 Low |
|
||||
| **Discount Code** | اعتبارسنجی کد تخفیف | 🟡 Low |
|
||||
|
||||
### High Priority - BackOffice (Admin):
|
||||
|
||||
| تسک | توضیحات | اولویت |
|
||||
|-----|---------|--------|
|
||||
| **Manual Payment UI** | صفحه مدیریت پرداختهای دستی | 🔴 High |
|
||||
| **RBAC System** | سیستم کنترل دسترسی | 🔴 High |
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Definition of Done
|
||||
|
||||
### برای هر Task:
|
||||
- [ ] Code Review Complete
|
||||
- [ ] Build با 0 error
|
||||
- [ ] Manual Testing انجام شده
|
||||
- [ ] Documentation بروز شده
|
||||
- [ ] Merged به `develop` branch
|
||||
- [x] Code Review Complete
|
||||
- [x] Build با 0 error
|
||||
- [x] Manual Testing انجام شده
|
||||
- [x] Documentation بروز شده
|
||||
|
||||
---
|
||||
|
||||
## 📝 Daily Standup Notes
|
||||
## 📝 نتیجهگیری نهایی
|
||||
|
||||
### ۱۴ آذر ۱۴۰۴:
|
||||
- **Yesterday**: FrontOffice analysis & UI skeleton
|
||||
- **Today**: 7 new pages + 3 BFF modules + Mock services
|
||||
- **Blockers**: Protobuf mismatch discovered
|
||||
- **Next**: Real API integration tomorrow
|
||||
### سمت مشتری (FrontOffice):
|
||||
✅ **آماده Production** - تمام قابلیتهای اصلی پیادهسازی شده
|
||||
|
||||
### سمت ادمین (BackOffice):
|
||||
🟡 **95% Complete** - Manual Payment و RBAC باقیمانده
|
||||
|
||||
---
|
||||
|
||||
**منتظر بروزرسانی روزانه هستیم** 🚀
|
||||
**آخرین بروزرسانی**: ۱۵ آذر ۱۴۰۴ 🚀
|
||||
|
||||
Reference in New Issue
Block a user