BackOffice/docs/EXCLUDED-FILES.md

# فایل‌های Exclude شده از Build

> آخرین بروزرسانی: December 6, 2025
> 
> این فایل‌ها از build خارج شدند ولی **حذف نشدند**

## ✅ فایل‌های برگردانده شده (Enabled)

این فایل‌ها قبلاً exclude بودند و حالا **فعال** شدند:

### DiscountShop Module
- ✅ `Pages/DiscountShop/**` - تمام صفحات فروشگاه تخفیفی
- ✅ `Services/DiscountProduct/**` - سرویس محصولات تخفیفی
- ✅ `Services/DiscountCategory/**` - سرویس دسته‌بندی‌ها
- ✅ `Services/DiscountOrder/**` - سرویس سفارشات

### Tag Module
- ✅ `Pages/Tag/**` - صفحات مدیریت تگ
- ✅ `Services/Tag/**` - سرویس تگ

### PublicMessages Module
- ✅ `Pages/PublicMessages/**` - مدیریت پیام‌های عمومی
- ✅ `Services/PublicMessage/**` - سرویس پیام‌ها

### Payment Module
- ✅ `Pages/Payment/ManualPayments.razor*` - پرداخت‌های دستی
- ✅ `Pages/Payment/Components/ManualPaymentDialog.razor*` - دیالوگ پرداخت
- ✅ `Pages/Payment/Transactions.razor*` - صفحه تراکنش‌ها

### Dashboard
- ✅ `Pages/Dashboard/DiscountShopWidget.razor*` - ویجت آمار فروشگاه

### DragDrop Pages
- ✅ `Pages/Category/CategoryProductsDragDropPage.razor*` - مدیریت محصولات دسته
- ✅ `Pages/Products/ProductCategoriesDragDropPage.razor*` - مدیریت دسته‌های محصول

### BulkEdit Module
- ✅ `Pages/Products/BulkEdit.razor*` - ویرایش گروهی محصولات (ENABLED)

### BulkEdit Module
- ✅ `Pages/Products/BulkEdit.razor*` - ویرایش گروهی محصولات (ENABLED)

### Product Image Management
- ✅ `Pages/Products/Components/GalleryDialog.razor*` - گالری تصاویر (ENABLED)
- ✅ `Pages/Products/Components/CreateDialog.razor*` - ایجاد محصول با تصویر (ENABLED)
- ✅ `Pages/Products/Components/UpdateDialog.razor*` - ویرایش محصول با تصویر (ENABLED)

---

## ❌ فایل‌های هنوز Exclude

**هیچ فایلی Exclude نیست!** ✨

تمامی فایل‌ها فعال شدند. Proto Messages و RPCهای لازم برای Image Upload اضافه شدند.

### ✅ وضعیت نهایی:
همه چیز کامل و آماده است:
- ✅ `GetProductGalleryAsync` - دریافت لیست تصاویر محصول (READY)
- ✅ `AddProductImageAsync` - آپلود تصویر جدید (READY)
- ✅ `RemoveProductImageAsync` - حذف تصویر (READY)

**Backend Implementation**: ✅ COMPLETED
- ProductsService.cs: Methods uncommented
- CQRS Handlers: Fully implemented
- CMS Integration: Connected
- Image Processing: Optimized with SixLabors.ImageSharp

---

## آمار

- **✅ فایل‌های Enabled**: ~38+ صفحه و ~15 سرویس
- **❌ فایل‌های Excluded**: 0 فایل ✅

---

## آمار

- **✅ فایل‌های Enabled**: ~30+ صفحه و ~15 سرویس
- **❌ فایل‌های Excluded**: 4 فایل
- **Proto Projects ساخته شده**: 14
- **Build Errors**: 0

---

## Exclude های فعلی در csproj

```xml
<ItemGroup>
    <!-- BulkEdit - needs refactoring -->
    <Compile Remove="Pages\Products\BulkEdit.razor" />
    <Content Remove="Pages\Products\BulkEdit.razor" />
    <Compile Remove="Pages\Products\BulkEdit.razor.cs" />
    
    <!-- GalleryDialog - needs AddProductImageAsync/RemoveProductImageAsync -->
    <Compile Remove="Pages\Products\Components\GalleryDialog.razor" />
    <Content Remove="Pages\Products\Components\GalleryDialog.razor" />
    <Compile Remove="Pages\Products\Components\GalleryDialog.razor.cs" />
    
    <!-- CreateDialog/UpdateDialog - needs ImageFileModel -->
    <Compile Remove="Pages\Products\Components\CreateDialog.razor" />
    <Content Remove="Pages\Products\Components\CreateDialog.razor" />
    <Compile Remove="Pages\Products\Components\CreateDialog.razor.cs" />
    <Compile Remove="Pages\Products\Components\UpdateDialog.razor" />
    <Content Remove="Pages\Products\Components\UpdateDialog.razor" />
    <Compile Remove="Pages\Products\Components\UpdateDialog.razor.cs" />
</ItemGroup>
```

---

## نکات مهم

### برای فعال‌سازی فایل‌های Exclude:

1. **GalleryDialog, CreateDialog, UpdateDialog**:
   - نیاز به پیاده‌سازی Image Upload API در Backend
   - افزودن `ImageFileModel` message به proto
   - افزودن RPC methods برای upload/remove

2. **BulkEdit**:
   - حذف dependency به `CMSMicroservice.Protobuf`
   - استفاده از `BackOffice.BFF.Products.Protobuf`
   - افزودن `BulkUpdateProducts` RPC به backend

### فایل‌های کامل شده که دیگر exclude نیستند:

- ✅ تمام ماژول DiscountShop
- ✅ تمام ماژول Tag
- ✅ تمام ماژول PublicMessages
- ✅ تمام ماژول ManualPayments
- ✅ DiscountShopWidget
- ✅ Transactions
- ✅ DragDrop Pages

---
    
    <!-- BulkEdit -->
    <Compile Remove="Pages\Products\BulkEdit.razor" />
    <Content Remove="Pages\Products\BulkEdit.razor" />
    <Compile Remove="Pages\Products\BulkEdit.razor.cs" />
    
    <!-- UserOrder Components -->
    <Compile Remove="Pages\UserOrder\Components\CancelOrderDialog.razor" />
    <Content Remove="Pages\UserOrder\Components\CancelOrderDialog.razor" />
    <Compile Remove="Pages\UserOrder\Components\CancelOrderDialog.razor.cs" />
    <Compile Remove="Pages\UserOrder\Components\ApplyDiscountDialog.razor" />
    <Content Remove="Pages\UserOrder\Components\ApplyDiscountDialog.razor" />
    <Compile Remove="Pages\UserOrder\Components\ApplyDiscountDialog.razor.cs" />
    <Compile Remove="Pages\UserOrder\Components\ChangeOrderStatusDialog.razor" />
    <Content Remove="Pages\UserOrder\Components\ChangeOrderStatusDialog.razor" />
    <Compile Remove="Pages\UserOrder\Components\ChangeOrderStatusDialog.razor.cs" />
    
    <!-- Transactions -->
    <Compile Remove="Pages\Payment\Transactions.razor" />
    <Content Remove="Pages\Payment\Transactions.razor" />
    <Compile Remove="Pages\Payment\Transactions.razor.cs" />
    
    <!-- Product Dialogs -->
    <Compile Remove="Pages\Products\Components\CreateProductDialog.razor" />
    <Content Remove="Pages\Products\Components\CreateProductDialog.razor" />
    <Compile Remove="Pages\Products\Components\CreateProductDialog.razor.cs" />
    <Compile Remove="Pages\Products\Components\UpdateProductDialog.razor" />
    <Content Remove="Pages\Products\Components\UpdateProductDialog.razor" />
    <Compile Remove="Pages\Products\Components\UpdateProductDialog.razor.cs" />
    <Compile Remove="Pages\Products\Components\GalleryDialog.razor" />
    <Content Remove="Pages\Products\Components\GalleryDialog.razor" />
    <Compile Remove="Pages\Products\Components\GalleryDialog.razor.cs" />
</ItemGroup>
```