Backend-Api/CHANGELOG.md

خلاصه تغییرات سیستم گزارش خرابی

📝 فایل‌های اضافه شده (23 فایل)

1️⃣ Domain Layer (3 فایل)

✓ AccountManagement.Domain/BugReportAgg/
  ├── BugReport.cs
  ├── BugReportLog.cs
  └── BugReportScreenshot.cs

2️⃣ Application Contracts (6 فایل)

✓ AccountManagement.Application.Contracts/BugReport/
  ├── IBugReportRepository.cs
  ├── IBugReportApplication.cs
  ├── CreateBugReportCommand.cs
  ├── EditBugReportCommand.cs
  ├── BugReportViewModel.cs
  └── BugReportDetailViewModel.cs

3️⃣ Application Service (1 فایل)

✓ AccountManagement.Application/
  └── BugReportApplication.cs

4️⃣ Infrastructure EFCore (4 فایل)

✓ AccountMangement.Infrastructure.EFCore/
  ├── Mappings/
  │   ├── BugReportMapping.cs
  │   ├── BugReportLogMapping.cs
  │   └── BugReportScreenshotMapping.cs
  └── Repository/
      └── BugReportRepository.cs

5️⃣ API Controller (1 فایل)

✓ ServiceHost/Controllers/
  └── BugReportController.cs

6️⃣ Admin Pages (8 فایل)

✓ ServiceHost/Areas/AdminNew/Pages/BugReport/
  ├── BugReportPageModel.cs
  ├── Index.cshtml.cs
  ├── Index.cshtml
  ├── Details.cshtml.cs
  ├── Details.cshtml
  ├── Edit.cshtml.cs
  ├── Edit.cshtml
  ├── Delete.cshtml.cs
  └── Delete.cshtml

7️⃣ Documentation (2 فایل)

✓ BUG_REPORT_SYSTEM.md
✓ FLUTTER_BUG_REPORT_EXAMPLE.dart

---

✏️ فایل‌های اصلاح شده (2 فایل)

1. AccountManagement.Configuration/AccountManagementBootstrapper.cs

تغییر: اضافه کردن using برای BugReport

using AccountManagement.Application.Contracts.BugReport;

تغییر: رجیستریشن سرویس‌ها

services.AddTransient<IBugReportApplication, BugReportApplication>();
services.AddTransient<IBugReportRepository, BugReportRepository>();

2. AccountMangement.Infrastructure.EFCore/AccountContext.cs

تغییر: اضافه کردن using

using AccountManagement.Domain.BugReportAgg;

تغییر: اضافه کردن DbSets

#region BugReport
public DbSet<BugReport> BugReports { get; set; }
public DbSet<BugReportLog> BugReportLogs { get; set; }
public DbSet<BugReportScreenshot> BugReportScreenshots { get; set; }
#endregion

---

🔧 موارد مورد نیاز قبل از استفاده

1. Database Migration

# در Package Manager Console
cd AccountMangement.Infrastructure.EFCore

Add-Migration AddBugReportSystem
Update-Database

2. الگوی Enum برای Flutter

enum BugReportType {
  crash, // 1
  ui, // 2
  performance, // 3
  feature, // 4
  network, // 5
  camera, // 6
  faceRecognition, // 7
  database, // 8
  login, // 9
  other, // 10
}

enum BugPriority {
  critical, // 1
  high, // 2
  medium, // 3
  low, // 4
}

---

🚀 نقاط ورود

API Endpoints

POST   /api/bugreport/submit          - ثبت گزارش جدید
GET    /api/bugreport/list            - دریافت لیست
GET    /api/bugreport/{id}            - دریافت جزئیات
PUT    /api/bugreport/{id}            - ویرایش وضعیت/اولویت
DELETE /api/bugreport/{id}            - حذف گزارش

Admin Pages

/AdminNew/BugReport                   - لیست گزارش‌ها
/AdminNew/BugReport/Details/{id}      - جزئیات کامل
/AdminNew/BugReport/Edit/{id}         - ویرایش
/AdminNew/BugReport/Delete/{id}       - حذف

---

📊 Database Schema

BugReports جدول

- id (bigint, PK)
- Title (nvarchar(200))
- Description (ntext)
- UserEmail (nvarchar(150))
- AccountId (bigint, nullable)
- DeviceModel (nvarchar(100))
- OsVersion (nvarchar(50))
- Platform (nvarchar(50))
- Manufacturer (nvarchar(100))
- DeviceId (nvarchar(200))
- ScreenResolution (nvarchar(50))
- MemoryInMB (int)
- StorageInMB (int)
- BatteryLevel (int)
- IsCharging (bit)
- NetworkType (nvarchar(50))
- AppVersion (nvarchar(50))
- BuildNumber (nvarchar(50))
- PackageName (nvarchar(150))
- InstallTime (datetime2)
- LastUpdateTime (datetime2)
- Flavor (nvarchar(50))
- Type (int)
- Priority (int)
- Status (int)
- StackTrace (ntext, nullable)
- CreationDate (datetime2)
- UpdateDate (datetime2, nullable)

BugReportLogs جدول

- id (bigint, PK)
- BugReportId (bigint, FK)
- Message (ntext)
- Timestamp (datetime2)

BugReportScreenshots جدول

- id (bigint, PK)
- BugReportId (bigint, FK)
- Base64Data (ntext)
- FileName (nvarchar(255))
- UploadDate (datetime2)

---

✨ مثال درخواست API

POST /api/bugreport/submit
Content-Type: application/json

{
  "title": "برنامه هنگام ورود خراب می‌شود",
  "description": "هنگام فشار دادن دکمه ورود، برنامه کرش می‌کند",
  "userEmail": "user@example.com",
  "accountId": 123,
  "deviceModel": "Samsung Galaxy S21",
  "osVersion": "Android 12",
  "platform": "Android",
  "manufacturer": "Samsung",
  "deviceId": "device-12345",
  "screenResolution": "1440x3200",
  "memoryInMB": 8000,
  "storageInMB": 256000,
  "batteryLevel": 75,
  "isCharging": false,
  "networkType": "4G",
  "appVersion": "1.0.0",
  "buildNumber": "100",
  "packageName": "com.example.app",
  "installTime": "2024-01-01T10:00:00Z",
  "lastUpdateTime": "2024-12-07T14:30:00Z",
  "flavor": "production",
  "type": 1,
  "priority": 2,
  "stackTrace": "...",
  "logs": ["log line 1", "log line 2"],
  "screenshots": ["base64-string"]
}

---

🔐 Security Features

• ✅ Authorization برای Admin Pages (AdminAreaPermission required)
• ✅ API Authentication
• ✅ XSS Protection (Html.Raw محدود)
• ✅ CSRF Protection (ASP.NET Core default)
• ✅ Input Validation
• ✅ Safe Delete with Confirmation

---

📚 Documentation Files

1. BUG_REPORT_SYSTEM.md - راهنمای کامل سیستم
2. FLUTTER_BUG_REPORT_EXAMPLE.dart - مثال پیاده‌سازی Flutter
3. CHANGELOG.md (این فایل) - خلاصه تغییرات

---

✅ Checklist پیاده‌سازی

• Domain Models
• Database Mappings
• Repository Pattern
• Application Services
• API Endpoints
• Admin UI Pages
• Dependency Injection
• Error Handling
• Documentation
• Flutter Example
• Database Migration (باید دستی اجرا شود)
• Testing

---

🎯 مراحل بعدی

1. اجرای Migration:

   Add-Migration AddBugReportSystem
   Update-Database
   

2. تست API:

   • استفاده از Postman/Thunder Client
   • تست تمام endpoints

3. تست Admin Panel:

   • دسترسی به /AdminNew/BugReport
   • تست فیلترها و جستجو
   • تست ویرایش و حذف

4. Integration Flutter:

   • کپی کردن FLUTTER_BUG_REPORT_EXAMPLE.dart
   • سازگار کردن با پروژه Flutter
   • تست ثبت گزارش‌ها

---

📞 پشتیبانی

برای هر سوال یا مشکل:

1. بررسی کنید BUG_REPORT_SYSTEM.md
2. بررسی کنید logs و error messages
3. مطمئن شوید Migration اجرا شده است