304 lines
8.7 KiB
Markdown
304 lines
8.7 KiB
Markdown
# کارهای باقیمانده - BackOffice
|
|
|
|
> آخرین بروزرسانی: December 6, 2025
|
|
|
|
## وضعیت کلی
|
|
|
|
**Build Status**: ✅ SUCCESS (0 Errors)
|
|
**Enabled Modules**: 7 ماژول کامل
|
|
**Remaining Tasks**: 3 فیچر
|
|
|
|
---
|
|
|
|
## 🔴 وظایف فوری (Critical)
|
|
|
|
### 1. Product Image Management API
|
|
|
|
**اولویت**: بالا
|
|
**وضعیت**: نیاز به Backend Implementation
|
|
|
|
#### فایلهای Blocked:
|
|
- `Pages/Products/Components/GalleryDialog.razor` - گالری تصاویر محصول
|
|
- `Pages/Products/Components/CreateDialog.razor` - ایجاد محصول با تصویر
|
|
- `Pages/Products/Components/UpdateDialog.razor` - ویرایش محصول با تصویر
|
|
|
|
#### Proto Changes Required:
|
|
|
|
**Location**: `BackOffice.BFF/src/Protobufs/BackOffice.BFF.Products.Protobuf/Protos/products.proto`
|
|
|
|
```protobuf
|
|
service ProductsContract {
|
|
// Image management RPCs
|
|
rpc AddProductImage(AddProductImageRequest) returns (AddProductImageResponse);
|
|
rpc RemoveProductImage(RemoveProductImageRequest) returns (google.protobuf.Empty);
|
|
|
|
// Create/Update with images
|
|
rpc CreateProductWithImage(CreateProductWithImageRequest) returns (CreateProductResponse);
|
|
rpc UpdateProductWithImage(UpdateProductWithImageRequest) returns (google.protobuf.Empty);
|
|
}
|
|
|
|
// New messages
|
|
message ImageFileModel {
|
|
bytes file = 1; // فایل به صورت binary
|
|
string mime = 2; // نوع فایل (image/jpeg, image/png)
|
|
string file_name = 3; // نام فایل بدون extension
|
|
}
|
|
|
|
message AddProductImageRequest {
|
|
int64 product_id = 1;
|
|
string title = 2;
|
|
ImageFileModel image_file = 3;
|
|
}
|
|
|
|
message AddProductImageResponse {
|
|
int64 product_gallery_id = 1;
|
|
string image_url = 2;
|
|
string thumbnail_url = 3;
|
|
}
|
|
|
|
message RemoveProductImageRequest {
|
|
int64 product_gallery_id = 1;
|
|
}
|
|
|
|
message CreateProductWithImageRequest {
|
|
string title = 1;
|
|
string description = 2;
|
|
int64 price = 3;
|
|
int32 stock = 4;
|
|
// ... سایر فیلدهای محصول
|
|
|
|
ImageFileModel image_file = 20; // تصویر اصلی
|
|
ImageFileModel thumbnail_file = 21; // تصویر کوچک
|
|
}
|
|
|
|
message UpdateProductWithImageRequest {
|
|
int64 id = 1;
|
|
string title = 2;
|
|
string description = 3;
|
|
int64 price = 4;
|
|
int32 stock = 5;
|
|
// ... سایر فیلدها
|
|
|
|
google.protobuf.BoolValue update_image = 20; // آیا تصویر آپدیت شود؟
|
|
ImageFileModel image_file = 21;
|
|
google.protobuf.BoolValue update_thumbnail = 22;
|
|
ImageFileModel thumbnail_file = 23;
|
|
}
|
|
```
|
|
|
|
#### Backend Implementation Steps:
|
|
|
|
1. **افزودن Messages به Proto** ✅ (فقط تعریف)
|
|
2. **پیادهسازی RPCs در Backend**:
|
|
- AddProductImage: دریافت فایل، ذخیره در storage، ثبت در DB
|
|
- RemoveProductImage: حذف فایل از storage و DB
|
|
- CreateProductWithImage: ایجاد محصول + آپلود تصاویر
|
|
- UpdateProductWithImage: ویرایش محصول + آپلود تصاویر (اختیاری)
|
|
|
|
3. **File Storage**:
|
|
- پیشنهاد: MinIO, Azure Blob, یا local file system
|
|
- ذخیره تصویر اصلی و thumbnail
|
|
- برگرداندن URL های قابل دسترسی
|
|
|
|
4. **تست و Enable فایلها در UI**
|
|
|
|
**زمان تخمینی**: 2-3 روز کاری
|
|
|
|
---
|
|
|
|
### 2. BulkEdit Refactoring
|
|
|
|
**اولویت**: متوسط
|
|
**وضعیت**: نیاز به Refactoring
|
|
|
|
#### فایل Blocked:
|
|
- `Pages/Products/BulkEdit.razor` - ویرایش دستهجمعی محصولات
|
|
|
|
#### مشکل فعلی:
|
|
استفاده مستقیم از `CMSMicroservice.Protobuf.Protos` که:
|
|
- وابستگی مستقیم به CMS ایجاد میکند
|
|
- معماری BFF را نقض میکند
|
|
- قابلیت نگهداری کد را کاهش میدهد
|
|
|
|
#### راهحل:
|
|
|
|
**مرحله 1: Proto Changes**
|
|
|
|
```protobuf
|
|
// در products.proto
|
|
service ProductsContract {
|
|
rpc BulkUpdateProducts(BulkUpdateProductsRequest) returns (BulkUpdateProductsResponse);
|
|
}
|
|
|
|
message BulkUpdateProductsRequest {
|
|
repeated int64 product_ids = 1; // لیست محصولات
|
|
|
|
// Optional updates (null = بدون تغییر)
|
|
google.protobuf.Int64Value new_price = 2;
|
|
google.protobuf.Int32Value new_discount = 3;
|
|
google.protobuf.Int32Value new_club_discount_percent = 4;
|
|
google.protobuf.BoolValue new_status = 5;
|
|
|
|
// Stock update
|
|
StockUpdateOperation stock_operation = 6;
|
|
google.protobuf.Int32Value stock_quantity = 7;
|
|
}
|
|
|
|
enum StockUpdateOperation {
|
|
STOCK_NO_CHANGE = 0; // بدون تغییر
|
|
STOCK_SET = 1; // تنظیم مقدار دقیق
|
|
STOCK_ADD = 2; // اضافه کردن
|
|
STOCK_SUBTRACT = 3; // کم کردن
|
|
}
|
|
|
|
message BulkUpdateProductsResponse {
|
|
int32 total_count = 1; // تعداد کل
|
|
int32 updated_count = 2; // تعداد موفق
|
|
repeated int64 failed_product_ids = 3; // محصولات ناموفق
|
|
repeated string error_messages = 4; // پیامهای خطا
|
|
}
|
|
```
|
|
|
|
**مرحله 2: Backend Implementation**
|
|
- پیادهسازی bulk update با transaction
|
|
- اعتبارسنجی دادهها
|
|
- مدیریت خطاها
|
|
|
|
**مرحله 3: UI Refactoring**
|
|
- حذف dependency به CMSMicroservice.Protobuf
|
|
- استفاده از BackOffice.BFF.Products.Protobuf
|
|
- Enable فایل در csproj
|
|
|
|
**زمان تخمینی**: 1-2 روز کاری
|
|
|
|
---
|
|
|
|
## 🟡 وظایف اختیاری (Optional)
|
|
|
|
### 3. Transactions API Implementation
|
|
|
|
**اولویت**: پایین
|
|
**وضعیت**: UI آماده، API نیاز به پیادهسازی
|
|
|
|
#### فایل:
|
|
- `Pages/Payment/Transactions.razor` - ✅ Enabled اما TODO
|
|
|
|
#### وضعیت فعلی:
|
|
```csharp
|
|
private async Task<GridData<TransactionModel>> LoadData(GridState<TransactionModel> state)
|
|
{
|
|
// TODO: Connect to BackOffice.BFF Transactions when API is ready
|
|
await Task.CompletedTask;
|
|
|
|
return new GridData<TransactionModel>
|
|
{
|
|
Items = Array.Empty<TransactionModel>(),
|
|
TotalItems = 0
|
|
};
|
|
}
|
|
```
|
|
|
|
#### نیاز:
|
|
- ایجاد Transaction proto در BackOffice.BFF
|
|
- پیادهسازی GetTransactions RPC
|
|
- اتصال UI به API
|
|
|
|
**زمان تخمینی**: 1 روز کاری
|
|
|
|
---
|
|
|
|
## 📊 آمار پیشرفت
|
|
|
|
### Modules Status:
|
|
|
|
| Module | Status | Files | Notes |
|
|
|--------|--------|-------|-------|
|
|
| DiscountShop | ✅ Complete | 10+ | Products, Categories, Orders, Reports |
|
|
| PublicMessages | ✅ Complete | 4 | CRUD + Templates |
|
|
| ManualPayments | ✅ Complete | 2 | Create, Approve, Reject |
|
|
| Tag Management | ✅ Complete | 3 | CRUD Tags |
|
|
| Dashboard Widget | ✅ Complete | 1 | DiscountShop Stats |
|
|
| Transactions | ⚠️ Partial | 1 | UI ready, API TODO |
|
|
| DragDrop Pages | ✅ Complete | 2 | Category ↔ Products |
|
|
| **Product Images** | ❌ Blocked | 3 | Need API |
|
|
| **BulkEdit** | ❌ Blocked | 1 | Need Refactoring |
|
|
|
|
### Overall Progress:
|
|
|
|
- **Enabled**: 32+ صفحه و کامپوننت
|
|
- **Blocked**: 4 فایل
|
|
- **Proto Projects**: 14 فعال
|
|
- **Build Errors**: 0
|
|
- **Completion**: ~88%
|
|
|
|
---
|
|
|
|
## 🎯 Next Steps
|
|
|
|
### Week 1: Product Image Management
|
|
1. ✅ تعریف Proto Messages (Done)
|
|
2. ⬜ پیادهسازی Backend RPCs
|
|
3. ⬜ تست با Postman/gRPC tools
|
|
4. ⬜ Enable UI files
|
|
5. ⬜ تست کامل end-to-end
|
|
|
|
### Week 2: BulkEdit
|
|
1. ⬜ تعریف Proto Messages
|
|
2. ⬜ پیادهسازی Backend
|
|
3. ⬜ Refactor UI
|
|
4. ⬜ Enable و تست
|
|
|
|
### Week 3: Polish
|
|
1. ⬜ Transactions API (اختیاری)
|
|
2. ⬜ بهبود UX
|
|
3. ⬜ رفع باگها
|
|
4. ⬜ مستندسازی نهایی
|
|
|
|
---
|
|
|
|
## 📝 نکات مهم
|
|
|
|
### برای Backend Developer:
|
|
|
|
1. **Image Upload**:
|
|
- استفاده از streaming برای فایلهای بزرگ
|
|
- اعتبارسنجی نوع و سایز فایل
|
|
- تولید thumbnail خودکار
|
|
- مدیریت storage (MinIO recommended)
|
|
|
|
2. **Bulk Update**:
|
|
- استفاده از Transaction برای atomicity
|
|
- مدیریت concurrent updates
|
|
- Logging تغییرات برای audit
|
|
|
|
3. **Security**:
|
|
- اعتبارسنجی سمت سرور
|
|
- محدودیت سایز فایل
|
|
- sanitize file names
|
|
|
|
### برای Frontend Developer:
|
|
|
|
1. **Image Upload**:
|
|
- Progress indicator
|
|
- Preview قبل از upload
|
|
- مدیریت خطاها
|
|
- Retry mechanism
|
|
|
|
2. **BulkEdit**:
|
|
- Confirmation قبل از تغییرات
|
|
- نمایش نتایج
|
|
- Undo capability (آینده)
|
|
|
|
---
|
|
|
|
## 🔗 Related Docs
|
|
|
|
- [BUILD-FIX-STATUS.md](./BUILD-FIX-STATUS.md) - وضعیت کلی build
|
|
- [EXCLUDED-FILES.md](./EXCLUDED-FILES.md) - لیست فایلهای exclude
|
|
- [PROTO-DEPENDENCIES.md](./PROTO-DEPENDENCIES.md) - وابستگیهای proto
|
|
|
|
---
|
|
|
|
**Last Updated**: December 6, 2025
|
|
**By**: GitHub Copilot (Claude Sonnet 4.5)
|