# یکسان‌سازی فروشگاه عادی و فروشگاه تخفیفی (BackOffice)

**تاریخ:** ۱۳۹۴/۱۱/۲۴ (2026-02-13)  
**وضعیت:** ✅ فاز ۱ تا ۶ — تکمیل شده (CMS + BackOffice Build Succeeded — 0 Error)

---

## هدف

هر دو فروشگاه (عادی و تخفیفی) از نظر **UI/UX، ساختار صفحات، اکشن‌ها و قابلیت‌ها** عین‌به‌عین یکسان باشند.  
**تنها تفاوت مجاز:** منطق پرداخت — فروشگاه تخفیفی از کیف‌پول تخفیفی + درگاه، فروشگاه عادی فقط از کیف‌پول عادی.

### معیار یکسان‌سازی
- **مبنا:** فروشگاه عادی (Products, Category, UserOrder)
- **استثنا:** مزایای بدیهی فروشگاه تخفیفی به فروشگاه عادی هم اضافه شد
- **Bulk Operations:** بیخیال شد (طبق درخواست کاربر)

---

## تفاوت‌های زیرساختی (تغییر نکرده — بی‌تأثیر روی UX)

| موضوع | فروشگاه عادی | فروشگاه تخفیفی |
|---|---|---|
| ارتباط با سرور | gRPC مستقیم (`ProductsContractClient`) | سرویس اینترفیس (`IDiscountProductService`) که داخلاً gRPC صدا می‌زنه |
| مدل داده | Protobuf models | C# DTOs |

> **نکته:** هر دو در نهایت از همان gRPC backend استفاده می‌کنند. تفاوت فقط در لایه abstraction است و تأثیری روی UX ندارد.

---

## تغییرات انجام‌شده

### ۱. صفحه محصولات (`DiscountProductsMainPage`)

| تغییر | قبل | بعد |
|---|---|---|
| نمایش تصویر | `MudAvatar` | کامپوننت `Image` (مطابق فروشگاه عادی) |
| برش عنوان | `Substring(0, 20) + "…"` | `Truncate(20, true)` (extension method مشترک) |
| گالری تصاویر | `ProductFormDialog` (کلاینت‌ساید) | `GalleryDialog` سرور-محور (مطابق فروشگاه عادی) |
| پیش‌نمایش تصویر | HTML inline در `ShowMessageBox` | `ImagePreviewDialog` (مطابق فروشگاه عادی) |
| عنوان تولبار | «مدیریت محصولات تخفیفی» | «مدیریت محصولات» |

**اکشن‌های جدید اضافه‌شده:**
- ✅ دکمه «مدیریت دسته‌بندی (درگ و دراپ)» → ناوبری به `ProductCategoriesDragDropPage`

**فایل‌های تغییر یافته:**
- `Pages/DiscountShop/DiscountProductsMainPage.razor`
- `Pages/DiscountShop/DiscountProductsMainPage.razor.cs`

---

### ۲. صفحه دسته‌بندی‌ها (`DiscountCategoriesMainPage`)

**اکشن‌های جدید اضافه‌شده:**
- ✅ دکمه «مدیریت محصولات این دسته (درگ و دراپ)» → ناوبری به `CategoryProductsDragDropPage`

**فایل‌های تغییر یافته:**
- `Pages/DiscountShop/DiscountCategoriesMainPage.razor`
- `Pages/DiscountShop/DiscountCategoriesMainPage.razor.cs`

---

### ۳. صفحه سفارشات (`DiscountOrdersMainPage`) — بازنویسی کامل

| تغییر | قبل | بعد |
|---|---|---|
| الگوی فیلتر | فیلترهای inline با دکمه جستجو | `BasePageComponent` با OnSubmit/OnClear (مطابق فروشگاه عادی) |
| لایه‌بندی | `MudPaper` تو در تو | `BasePageComponent > Filters + Content` |
| اکشن‌ها | فقط مشاهده جزئیات + تغییر وضعیت | جزئیات + تغییر وضعیت + حذف (مطابق فروشگاه عادی) |
| آیکون‌های اکشن | `Visibility` + `Edit` | `Info` + `LocalShipping` + `DeleteOutline` (مطابق فروشگاه عادی) |
| ساختار تولبار | بدون تولبار | تولبار با عنوان + دکمه Excel (مطابق فروشگاه عادی) |

**ستون‌ها (حفظ شده — خاص فروشگاه تخفیفی):**
- شماره سفارش، تاریخ ثبت، مبلغ کل، **تخفیف کیف‌پول**، **پرداخت درگاه**، تعداد آیتم، وضعیت، پرداخت

**فایل‌های تغییر یافته:**
- `Pages/DiscountShop/DiscountOrdersMainPage.razor` ← بازنویسی کامل
- `Pages/DiscountShop/DiscountOrdersMainPage.razor.cs` ← بازنویسی کامل

---

### ۴. گزارش فروش (`SalesReports`)

| تغییر | قبل | بعد |
|---|---|---|
| نمودارها | روند فروش + محصولات پرفروش | روند فروش + محصولات پرفروش + **وضعیت سفارش‌ها** |
| عنوان | «گزارش فروش فروشگاه تخفیفی» | «گزارش فروش فروشگاه» |
| توضیح | «آمار فروش، تخفیف و وضعیت سفارش‌های فروشگاه تخفیفی...» | «آمار فروش و وضعیت سفارش‌ها بر اساس بازه تاریخ و وضعیت سفارش» |

**نمودار جدید:**
- ✅ «وضعیت سفارش‌ها» — نمودار میله‌ای تعداد سفارش بر اساس وضعیت (مطابق فروشگاه عادی)

**فایل‌های تغییر یافته:**
- `Pages/DiscountShop/SalesReports.razor`

---

### ۵. هاب سفارشات (`DiscountShopHub`)

| تغییر | قبل | بعد |
|---|---|---|
| عنوان | «فروشگاه تخفیفی» | «سفارشات فروشگاه تخفیفی» |
| آیکون تب سفارشات | `ShoppingCart` | `ReceiptLong` (مطابق `OrdersHub` فروشگاه عادی) |

**فایل‌های تغییر یافته:**
- `Pages/DiscountShop/DiscountShopHub.razor`

---

### ۶. تغییرات فروشگاه عادی (مزایای تخفیفی ← عادی)

#### CategoryMainPage
- ✅ ستون **«ترتیب»** (`SortOrder`) اضافه شد (از تخفیفی)
- ✅ **غیرفعال‌سازی حذف** دسته‌بندی دارای زیردسته (از تخفیفی)

**فایل‌های تغییر یافته:**
- `Pages/Category/CategoryMainPage.razor`
- `Pages/Category/CategoryMainPage.razor.cs`

---

## تغییرات فاز ۲ — ارتقاء به Admin RPC و فیلدهای پیشرفته

### ۷. سرویس سفارشات تخفیفی — سوئیچ به Admin RPC

| تغییر | قبل | بعد |
|---|---|---|
| RPC مورد استفاده | `GetUserOrders` (user-scoped) | `GetAllDiscountOrders` (admin-scoped) |
| DTO | `OrderSummaryDto` (محدود) | `AdminOrderDto` (کامل با user_full_name, user_mobile, shipping_address, payment_date, vat_amount...) |
| فیلترها | فقط userId, paymentCompleted, deliveryStatus | userId, paymentStatus, deliveryStatus, userMobile, trackingCode, fromDate, toDate, minAmount, maxAmount |
| گزارش فروش | محاسبه کلاینت‌ساید + N+1 (۵۰ فراخوان gRPC جداگانه!) | `GetDiscountSalesReport` RPC سرور-ساید با fallback |

**فایل‌های تغییر یافته:**
- `Services/DiscountOrder/IDiscountOrderService.cs` ← فیلترهای جدید + DTOهای گزارش فروش
- `Services/DiscountOrder/DiscountOrderService.cs` ← سوئیچ به `GetAllDiscountOrdersAsync` + `GetDiscountSalesReportAsync`

### ۸. ستون‌ها و فیلترهای ادمین در سفارشات تخفیفی

**ستون‌های جدید اضافه‌شده:**
- ✅ **نام کاربر** (لینک به پروفایل — مطابق فروشگاه عادی)
- ✅ **موبایل کاربر**
- ✅ **وضعیت پرداخت** (Pending/Completed/Failed/Refunded — مطابق فروشگاه عادی)
- ✅ **تاریخ پرداخت**
- ✅ **آدرس** (truncated با tooltip — مطابق فروشگاه عادی)
- ✅ **وضعیت ارسال** (جدا از وضعیت پرداخت — مطابق فروشگاه عادی)

**فیلترهای جدید اضافه‌شده:**
- ✅ شناسه سفارش
- ✅ جستجوی کاربر (UserAutoComplete)
- ✅ موبایل کاربر
- ✅ کد رهگیری
- ✅ از تاریخ / تا تاریخ
- ✅ وضعیت پرداخت (Pending/Completed/Failed/Refunded)
- ✅ وضعیت ارسال

**فایل‌های تغییر یافته:**
- `Pages/DiscountShop/DiscountOrdersMainPage.razor` ← ستون‌ها + فیلترها
- `Pages/DiscountShop/DiscountOrdersMainPage.razor.cs` ← فیلدها + متدهای وضعیت پرداخت

### ۹. گزارش فروش تخفیفی — حذف مشکل N+1

| تغییر | قبل | بعد |
|---|---|---|
| محصولات پرفروش | ۵۰ فراخوان gRPC جداگانه (`GetByIdAsync` × 50) | یک فراخوان `GetDiscountSalesReport` |
| خلاصه آماری | محاسبه کلاینت‌ساید | سرور-ساید (دقیق‌تر + سریع‌تر) |
| نمودار روند | GroupBy کلاینت‌ساید | `SalesPeriodDto` از سرور |
| جدول سفارش‌ها | فقط شماره سفارش | شناسه + نام کاربر (لینک) |
| خروجی Excel/PDF | فقط OrderNumber | شناسه + نام کاربر + موبایل |

**فایل‌های تغییر یافته:**
- `Pages/DiscountShop/SalesReports.razor`

### ۱۰. دسته‌بندی فروشگاه عادی — فیلد ImagePath

- ✅ فیلد `ImagePath` به دیالوگ ایجاد/ویرایش دسته‌بندی اضافه شد (مطابق فروشگاه تخفیفی)

**فایل‌های تغییر یافته:**
- `Pages/Category/Components/CreateOrUpdateCategoryDialog.razor`
- `Pages/Category/Components/CreateOrUpdateCategoryDialog.razor.cs`

### ۱۱. گزارش فروش عادی — نمودار محصولات پرفروش + خروجی PDF

- ✅ نمودار «محصولات پرفروش (بر اساس مبلغ)» از FactorDetails سفارشات
- ✅ دکمه خروجی PDF (نسخه متنی) — مطابق فروشگاه تخفیفی

**فایل‌های تغییر یافته:**
- `Pages/UserOrder/OrderSalesReports.razor`
- `Pages/UserOrder/OrderSalesReports.razor.cs`

---

## تغییرات فاز ۳ — تگ‌های محصول و نهایی‌سازی

### ۱۲. تگ‌های محصول در فروشگاه تخفیفی

- ✅ دکمه «تگ‌های محصول» (`Label` icon) به ستون عملیات صفحه محصولات تخفیفی اضافه شد
- ✅ از همان `AssignTagsDialog` فروشگاه عادی استفاده شد (کامپوننت مشترک)
- ✅ سرویس `ProductTagContract` مشترک بین هر دو فروشگاه — بدون نیاز به API جدید

> **نکته:** `ProductTagContract` یک سرویس ژنریک `product_id ↔ tag_id` است و محدود به فروشگاه خاصی نیست.

**فایل‌های تغییر یافته:**
- `Pages/DiscountShop/DiscountProductsMainPage.razor` ← دکمه تگ
- `Pages/DiscountShop/DiscountProductsMainPage.razor.cs` ← متد `OpenTagAssignment` + using

---

## تغییرات فاز ۴ — یکسان‌سازی دیالوگ‌ها و جزئیات تکمیلی

### ۱۳. دیالوگ جزئیات سفارش تخفیفی — Timeline + ویرایش Inline

| تغییر | قبل | بعد |
|---|---|---|
| Timeline وضعیت | ❌ فاقد | ✅ ۵ مرحله (ثبت → پرداخت → آماده‌سازی → ارسال → تحویل/مرجوعی) |
| ویرایش وضعیت | ❌ فقط خواندنی | ✅ درون‌خطی (وضعیت + کد رهگیری + یادداشت ادمین) |
| دکمه ذخیره | ❌ فقط «بستن» | ✅ «ثبت تغییرات» + اسپینر بارگذاری |
| هشدارهای شرطی | ❌ فاقد | ✅ هشدار لغو/مرجوعی + اطلاع‌رسانی ارسال |
| Code-behind | `@code` درون‌خطی | فایل جداگانه `.razor.cs` |

**فایل‌های تغییر یافته:**
- `Pages/DiscountShop/Components/OrderDetailsDialog.razor` ← Timeline + ویرایش inline
- `Pages/DiscountShop/Components/OrderDetailsDialog.razor.cs` ← فایل جدید — timeline + save logic

### ۱۴. دیالوگ تغییر وضعیت فروشگاه عادی — ارتقاء

| تغییر | قبل | بعد |
|---|---|---|
| فرم | `MudStack` ساده | `MudForm` با validation |
| فیلدها | فقط وضعیت | ✅ وضعیت + **کد رهگیری** + **توضیحات ارسال** |
| هشدارهای شرطی | ❌ فاقد | ✅ هشدار مرجوعی + اطلاع‌رسانی ارسال |
| دکمه | رنگ ثابت `Primary` | ✅ رنگ داینامیک بر اساس وضعیت + اسپینر |
| عنوان | بدون آیکون | ✅ آیکون `Edit` + عنوان |
| RPC | فقط `UpdateOrderStatusAsync` | ✅ `UpdateOrderStatusAsync` + `UpdateUserOrderAsync` (کد رهگیری + توضیحات) |

**فایل‌های تغییر یافته:**
- `Pages/UserOrder/Components/ChangeOrderStatusDialog.razor`
- `Pages/UserOrder/Components/ChangeOrderStatusDialog.razor.cs`

### ۱۵. گزارش فروش تخفیفی — Empty chart guard + ترتیب نمودارها

| تغییر | قبل | بعد |
|---|---|---|
| نمودار روند فروش | بدون بررسی خالی بودن | ✅ نمایش «داده کافی برای نمایش نمودار وجود ندارد» |
| ترتیب نمودارها | روند → پرفروش → وضعیت | ✅ روند → **وضعیت** → پرفروش (مطابق فروشگاه عادی) |

**فایل‌های تغییر یافته:**
- `Pages/DiscountShop/SalesReports.razor`

### ۱۶. گزارش فروش عادی — لینک نام کاربر

- ✅ نام کاربر در جدول سفارش‌ها از متن ساده به `MudLink` تبدیل شد (لینک به پروفایل کاربر)

**فایل‌های تغییر یافته:**
- `Pages/UserOrder/OrderSalesReports.razor`

### ۱۷. دیالوگ دسته‌بندی فروشگاه عادی — MudForm + UX

| تغییر | قبل | بعد |
|---|---|---|
| اعتبارسنجی | ❌ بدون validation | ✅ `MudForm` با `Required` + `RequiredError` |
| فیلد فعال | `MudCheckBox` | ✅ `MudSwitch` رنگی (مطابق فروشگاه تخفیفی) |
| Helper text | ❌ فاقد | ✅ «عدد کمتر = اولویت بالاتر» + «برای دسته اصلی خالی بگذارید» |
| دکمه ذخیره | همیشه «ثبت» | ✅ «ذخیره تغییرات» / «ایجاد دسته‌بندی» (داینامیک) |
| اسپینر بارگذاری | ❌ فاقد | ✅ `MudProgressCircular` + غیرفعال‌سازی دکمه |
| عنوان | بدون آیکون | ✅ آیکون `Edit`/`Add` + عنوان داینامیک |
| غیرفعال‌سازی دکمه | ❌ فاقد | ✅ غیرفعال تا validation سبز نشود |

**فایل‌های تغییر یافته:**
- `Pages/Category/CreateOrUpdateCategoryDialog.razor`
- `Pages/Category/CreateOrUpdateCategoryDialog.razor.cs`

### ۱۸. سفارشات تخفیفی — لغو سفارش واقعی

| تغییر | قبل | بعد |
|---|---|---|
| دکمه «حذف» | آیکون `DeleteOutline` — فقط snackbar (بدون API) | ✅ آیکون `Cancel` — فراخوان `UpdateStatusAsync` با `Cancelled` |
| متن تأییدیه | «آیا از حذف مطمئن هستید؟» | «آیا از لغو سفارش مطمئن هستید؟ وضعیت به لغو شده تغییر می‌کند» |
| عملکرد | ❌ هیچ | ✅ واقعی — `UpdateStatusAsync(Cancelled)` |

**فایل‌های تغییر یافته:**
- `Pages/DiscountShop/DiscountOrdersMainPage.razor` ← آیکون + tooltip
- `Pages/DiscountShop/DiscountOrdersMainPage.razor.cs` ← فراخوان API

---

## تغییرات فاز ۵ — فرمت‌بندی قیمت، زیردسته و برچسب فیلدها

### ۵.۱ فرمت‌بندی قیمت در لیست محصولات عادی

**مشکل:** ستون قیمت عدد خام بدون separator و بدون واحد نشان می‌داد.  
**راه‌حل:** تبدیل `PropertyColumn` به `TemplateColumn` با `Price.ToString("N0") ریال` — مطابق فروشگاه تخفیفی.

**فایل تغییر یافته:**
- `Pages/Products/ProductsMainPage.razor` ← TemplateColumn + فرمت N0 + ریال

### ۵.۲ دکمه «افزودن زیردسته» در دسته‌بندی‌های عادی

**مشکل:** فروشگاه تخفیفی دکمه «افزودن زیردسته» در ستون عملیات داشت ولی فروشگاه عادی نداشت.  
**راه‌حل:** افزودن `MudIconButton` با آیکون `CreateNewFolder` + رنگ `Color.Primary` + متد `CreateSubcategory(parent)` که دیالوگ را با `ParentId = parent.Id` باز می‌کند.

**فایل‌های تغییر یافته:**
- `Pages/Category/CategoryMainPage.razor` ← دکمه جدید در ستون عملیات
- `Pages/Category/CategoryMainPage.razor.cs` ← متد `CreateSubcategory`

### ۵.۳ برچسب واحد ریال در دیالوگ‌های محصول

**مشکل:** فیلد قیمت در دیالوگ‌های ایجاد/ویرایش محصول عادی `Label="قیمت"` داشت — بدون واحد.  
**راه‌حل:** تغییر به `Label="قیمت (ریال)"` — مطابق فروشگاه تخفیفی.

**فایل‌های تغییر یافته:**
- `Pages/Products/Components/CreateDialog.razor` ← قیمت (ریال)
- `Pages/Products/Components/UpdateDialog.razor` ← قیمت (ریال)

---

## تغییرات فاز ۶ — تغییرات بکند (Proto + Handler + gRPC Service)

این فاز تمام موارد "محدودیت API" که در فازهای قبلی شناسایی شده بودند را حل می‌کند.

### ۶.۱ ستون وضعیت فعال/غیرفعال محصولات (`is_active`)

**مشکل:** پروتوباف `GetAllProductsByFilterResponseModel` فیلد `is_active` نداشت. محصولات عادی ستون وضعیت نداشتند.  
**راه‌حل (end-to-end):**
- **Proto:** افزودن `bool is_active = 15` به `GetAllProductsByFilterResponseModel` + `google.protobuf.BoolValue is_active = 15` به `GetAllProductsByFilterFilter`
- **DTO:** افزودن `bool IsActive` به `CustomerProductModel`
- **Query:** افزودن `bool? IsActive` به `GetCustomerProductsByFilterQuery`
- **Handler:** فیلتر `IsDeleted != IsActive` + مپ `IsActive = !p.IsDeleted`
- **gRPC Service:** مپ `IsActive` در فیلتر و ریسپانس `ProductsService`
- **Frontend:** ستون `TemplateColumn` با `MudChip` رنگی در `ProductsMainPage.razor`

**فایل‌های تغییر یافته:**
- `CMS/.../Protos/products.proto`
- `CMS/.../GetCustomerProductsByFilterResponseDto.cs`
- `CMS/.../GetCustomerProductsByFilterQuery.cs`
- `CMS/.../GetCustomerProductsByFilterQueryHandler.cs`
- `CMS/.../Services/ProductsService.cs`
- `BackOffice/.../Pages/Products/ProductsMainPage.razor`

### ۶.۲ ستون تعداد محصولات دسته‌بندی (`product_count`)

**مشکل:** پروتوباف `GetAllCategoryByFilterResponseModel` فیلد `product_count` نداشت.  
**راه‌حل (end-to-end):**
- **Proto:** افزودن `int32 product_count = 9` به `GetAllCategoryByFilterResponseModel`
- **DTO:** افزودن `int ProductCount` به `GetAllCategoryByFilterResponseModel` (C#)
- **Handler:** تغییر از `ProjectToType<>()` (Mapster auto-map) به manual `Select()` با `ProductCount = x.ProductCategories.Count`
- **gRPC Service:** auto-map Mapster (نام یکسان)
- **Frontend:** ستون `PropertyColumn` جدید در `CategoryMainPage.razor`

**فایل‌های تغییر یافته:**
- `CMS/.../Protos/category.proto`
- `CMS/.../GetAllCategoryByFilterResponseDto.cs`
- `CMS/.../GetAllCategoryByFilterQueryHandler.cs`
- `BackOffice/.../Pages/Category/CategoryMainPage.razor`

### ۶.۳ فیلتر بازه تاریخ سفارشات (`from_date` / `to_date`)

**مشکل:** پروتوباف `GetAllUserOrderByFilterFilter` فقط یک `payment_date` داشت. امکان فیلتر بازه تاریخ وجود نداشت.  
**راه‌حل (end-to-end):**
- **Proto:** افزودن `google.protobuf.Timestamp from_date = 11` و `google.protobuf.Timestamp to_date = 12` به فیلتر
- **gRPC Service:** مپ `FromDate` از `from_date` (با fallback به `payment_date`)، `ToDate` از `to_date`
- **Handler:** بدون تغییر — از قبل `FromDate`/`ToDate` را ساپورت می‌کرد
- **Frontend:** افزودن `MudDatePicker` دوم (تا تاریخ)، مپ به `Filter.FromDate`/`Filter.ToDate`

**فایل‌های تغییر یافته:**
- `CMS/.../Protos/userorder.proto`
- `CMS/.../Services/UserOrderService.cs`
- `BackOffice/.../Pages/UserOrder/UserOrderMainPage.razor`
- `BackOffice/.../Pages/UserOrder/UserOrderMainPage.razor.cs`

### ۶.۴ تصویر محصول در آیتم‌های سفارش تخفیفی (`image_path`)

**مشکل:** `OrderItemDto` در proto و C# فیلد `image_path` نداشت. آیتم‌های سفارش بدون تصویر بودند.  
**راه‌حل (end-to-end):**
- **Proto:** افزودن `string image_path = 9` و `string thumbnail_path = 10` به `OrderItemDto` در `discountorder.proto`
- **Backend DTO:** افزودن `ImagePath`/`ThumbnailPath` به `OrderItemDto` (C# Application layer)
- **Handler:** مپ `ImagePath = od.Product.ImagePath` در `GetOrderByIdQueryHandler` (Product nav property از قبل Include شده بود)
- **Frontend DTO:** افزودن فیلدها به `IDiscountOrderService.OrderItemDto`
- **Frontend Service:** مپ در `DiscountOrderService`
- **Frontend Dialog:** `MudImage` + `MudStack` برای نمایش تصویر کنار نام محصول

**فایل‌های تغییر یافته:**
- `CMS/.../Protos/discountorder.proto`
- `CMS/.../GetOrderByIdQuery.cs` (OrderItemDto)
- `CMS/.../GetOrderByIdQueryHandler.cs`
- `BackOffice/.../Services/DiscountOrder/IDiscountOrderService.cs`
- `BackOffice/.../Services/DiscountOrder/DiscountOrderService.cs`
- `BackOffice/.../Pages/DiscountShop/Components/OrderDetailsDialog.razor`

---

## وضعیت مقایسه‌ای نهایی

### محصولات
| قابلیت | عادی | تخفیفی |
|---|:---:|:---:|
| لیست با MudDataGrid + server-side | ✅ | ✅ |
| فیلتر با BasePageComponent | ✅ | ✅ |
| نمایش تصویر (Image component) | ✅ | ✅ |
| برش عنوان (Truncate) | ✅ | ✅ |
| ایجاد/ویرایش/حذف | ✅ | ✅ |
| گالری تصاویر (GalleryDialog سرور-محور) | ✅ | ✅ |
| پیش‌نمایش تصویر (ImagePreviewDialog) | ✅ | ✅ |
| مدیریت دسته‌بندی (درگ و دراپ) | ✅ | ✅ |
| خروجی Excel | ✅ | ✅ |
| تگ‌های محصول (AssignTagsDialog مشترک) | ✅ | ✅ |
| فرمت قیمت (N0 + ریال) | ✅ | ✅ |
| ستون وضعیت فعال/غیرفعال | ✅ | ✅ |
| Bulk Edit/Delete/Toggle | ✅ | ❌ (طبق درخواست — بیخیال) |

### دسته‌بندی‌ها
| قابلیت | عادی | تخفیفی |
|---|:---:|:---:|
| درخت سایدبار | ✅ | ✅ |
| گرید با MudDataGrid | ✅ | ✅ |
| ستون‌ها: شناسه، نام لاتین، عنوان، والد، ترتیب، فعال | ✅ | ✅ |
| ستون تعداد محصولات | ✅ | ✅ |
| ایجاد/ویرایش/حذف | ✅ | ✅ |
| غیرفعال‌سازی حذف دارای زیردسته | ✅ | ✅ |
| افزودن زیردسته | ✅ | ✅ |
| درگ‌اندراپ محصولات دسته | ✅ | ✅ |

### سفارشات
| قابلیت | عادی | تخفیفی |
|---|:---:|:---:|
| BasePageComponent با فیلتر | ✅ | ✅ |
| MudDataGrid + تولبار | ✅ | ✅ |
| فیلتر شناسه / کاربر / تاریخ / وضعیت | ✅ | ✅ |
| فیلتر بازه تاریخ (از تاریخ + تا تاریخ) | ✅ | ✅ |
| ستون نام کاربر (لینک به پروفایل) | ✅ | ✅ |
| ستون وضعیت پرداخت (Chip رنگی) | ✅ | ✅ |
| ستون وضعیت ارسال (Chip رنگی) | ✅ | ✅ |
| ستون تاریخ پرداخت | ✅ | ✅ |
| ستون آدرس (truncated + tooltip) | ✅ | ✅ |
| جزئیات سفارش (Timeline + ویرایش inline) | ✅ | ✅ |
| تصویر محصول در آیتم‌های سفارش | ✅ | ✅ |
| تغییر وضعیت (MudForm + کد رهگیری + هشدار) | ✅ | ✅ |
| لغو سفارش | ✅ | ✅ (via UpdateStatus) |
| خروجی Excel | ✅ | ✅ |
| ستون‌های مالی تخفیف (DiscountBalanceUsed/GatewayAmount) | ❌ (مربوط نیست) | ✅ |
| اعمال تخفیف | ✅ | ❌ (API ندارد) |

### گزارش فروش
| قابلیت | عادی | تخفیفی |
|---|:---:|:---:|
| فیلتر تاریخ + وضعیت | ✅ | ✅ |
| کارت‌های خلاصه | ✅ | ✅ |
| نمودار روند فروش | ✅ | ✅ |
| نمودار وضعیت سفارش‌ها | ✅ | ✅ |
| نمودار محصولات پرفروش | ✅ | ✅ |
| خروجی Excel | ✅ | ✅ |
| خروجی PDF | ✅ | ✅ |

---

## موارد باقی‌مانده

این موارد نیاز به تغییرات بیشتر دارند:

| مورد | جزئیات | وضعیت |
|---|---|---|
| **اعمال تخفیف سفارش تخفیفی** | `discountorder.proto` فاقد `ApplyDiscountToOrder` RPC | نیاز به RPC جدید + لاجیک سرور |
| **لغو سفارش با بازپرداخت** | لغو وضعیت ✅ ولی refund/بازگشت موجودی نیاز به RPC اختصاصی | نیاز به `CancelOrder` RPC |

> **نکته:** موارد قبلی (is_active، product_count، from_date/to_date، image_path) در **فاز ۶** حل شدند.

---

## ساختار فایل‌های تغییریافته

```
CMS/src/
├── CMSMicroservice.Protobuf/Protos/
│   ├── products.proto              ← is_active (filter + response field 15)
│   ├── category.proto              ← product_count (response field 9)
│   ├── userorder.proto             ← from_date/to_date (filter fields 11,12)
│   └── discountorder.proto         ← image_path/thumbnail_path (OrderItemDto fields 9,10)
├── CMSMicroservice.Application/
│   ├── ProductsCQ/Queries/GetCustomerProductsByFilter/
│   │   ├── GetCustomerProductsByFilterQuery.cs          ← IsActive filter
│   │   ├── GetCustomerProductsByFilterQueryHandler.cs   ← IsActive filter + mapping
│   │   └── GetCustomerProductsByFilterResponseDto.cs    ← IsActive field
│   ├── CategoryCQ/Queries/GetAllCategoryByFilter/
│   │   ├── GetAllCategoryByFilterQueryHandler.cs        ← manual Select + ProductCount
│   │   └── GetAllCategoryByFilterResponseDto.cs         ← ProductCount field
│   └── DiscountShopCQ/Queries/GetOrderById/
│       ├── GetOrderByIdQuery.cs                         ← ImagePath/ThumbnailPath
│       └── GetOrderByIdQueryHandler.cs                  ← Product image mapping
└── CMSMicroservice.WebApi/Services/
    ├── ProductsService.cs          ← IsActive filter + response mapping
    └── UserOrderService.cs         ← FromDate/ToDate mapping

BackOffice/src/BackOffice/
├── Services/DiscountOrder/
│   ├── IDiscountOrderService.cs        ← OrderItemDto + ImagePath/ThumbnailPath
│   └── DiscountOrderService.cs         ← image mapping
├── Pages/
│   ├── Category/
│   │   ├── CategoryMainPage.razor      ← ستون ProductCount + SortOrder + زیردسته
│   │   ├── CategoryMainPage.razor.cs   ← HasChildren + CreateSubcategory
│   │   ├── CreateOrUpdateCategoryDialog.razor    ← MudForm + ImagePath
│   │   └── CreateOrUpdateCategoryDialog.razor.cs ← validation + loading
│   ├── DiscountShop/
│   │   ├── DiscountShopHub.razor
│   │   ├── DiscountProductsMainPage.razor/.cs
│   │   ├── DiscountCategoriesMainPage.razor/.cs
│   │   ├── DiscountOrdersMainPage.razor/.cs
│   │   ├── SalesReports.razor
│   │   └── Components/
│   │       ├── OrderDetailsDialog.razor     ← تصویر محصول + Timeline
│   │       └── OrderDetailsDialog.razor.cs
│   ├── UserOrder/
│   │   ├── UserOrderMainPage.razor         ← فیلتر بازه تاریخ (از + تا)
│   │   ├── UserOrderMainPage.razor.cs      ← FromDate/ToDate mapping
│   │   ├── OrderSalesReports.razor/.cs
│   │   └── Components/ChangeOrderStatusDialog.razor/.cs
│   └── Products/
│       ├── ProductsMainPage.razor         ← ستون IsActive + فرمت قیمت
│       └── Components/
│           ├── CreateDialog.razor         ← قیمت (ریال)
│           └── UpdateDialog.razor         ← قیمت (ریال)
```