hesabix/arc

Watch

Fork 1

Babak Alizadeh 0764deeaa1 change file permissions

2026-04-14 19:34:55 +03:30

10 KiB

Executable file

Raw Permalink Blame History

✅ وضعیت نهایی افزونه مدیریت تعمیرگاه

🎯 خلاصه پیاده‌سازی

✅ Backend (100% Complete)

دیتابیس

✅ 7 جدول ایجاد شد
✅ Migration ها اجرا شدند
✅ افزونه در marketplace ثبت شد (ID: 3)
✅ 2 پلن قیمت‌گذاری (ماهانه، سالانه)

کد Backend

✅ 10 فایل Python ایجاد شد
✅ 7 Repository کامل
✅ 3 Service Layer
✅ 25+ API Endpoint
✅ Integration کامل با تمام سیستم‌ها

✅ Frontend (UI اولیه Complete)

منوی کناری

✅ بخش "تعمیرگاه" 🔧 اضافه شد
✅ آیکون: build_circle
✅ موقعیت: بعد از "گارانتی"
✅ بررسی فعال بودن پلاگین (توسط business_shell.dart)

صفحات

✅ repair_orders_list_page.dart - لیست سفارشات
- نمایش لیست با کارت‌های زیبا
- فیلتر بر اساس وضعیت
- جستجو
- دکمه "سفارش جدید"
- رنگ‌بندی وضعیت‌ها (10 وضعیت)

مسیریابی

✅ Route: /business/:business_id/repair-shop
✅ Import انجام شد
✅ بدون خطای lint

📊 جزئیات پیاده‌سازی Frontend

صفحه لیست سفارشات

ویژگی‌ها:

📋 نمایش لیست سفارشات در قالب Card
🎨 رنگ‌بندی وضعیت‌ها:
- 🔵 دریافت شده (received)
- 🟣 اختصاص داده شده (assigned)
- 🟠 در حال تعمیر (in_progress)
- 🟡 منتظر قطعات (waiting_parts)
- 🔵 در حال تست (testing)
- 🟢 تعمیر موفق (completed_fixed)
- 🔴 غیرقابل تعمیر (completed_unfixable)
- 🟦 آماده تحویل (ready_for_pickup)
- ⚫ تحویل داده شده (delivered)
- ⚪ لغو شده (cancelled)

اطلاعات نمایش داده شده در هر کارت:

کد سفارش (مثلاً REC-2025-0001)
نام مشتری + شماره تماس
نام کالا
شرح مشکل
نام تعمیرکار (اگر اختصاص داده شده باشد)
هزینه نهایی
تاریخ دریافت

عملکردها:

✅ کلیک روی کارت → باز کردن جزئیات (TODO)
✅ دکمه + → ثبت سفارش جدید (TODO)
✅ Pull to refresh
✅ فیلتر وضعیت (منوی dropdown)
✅ جستجو (در کد، مشتری، تلفن، کالا)

🔗 یکپارچگی با سیستم موجود

بررسی فعال بودن پلاگین

در business_shell.dart:

bool _isRepairShopPluginActive() {
  try {
    final repairShopPlugin = _businessPlugins.firstWhere(
      (plugin) => plugin['plugin_code'] == 'repair_shop_management',
      orElse: () => <String, dynamic>{},
    );
    return repairShopPlugin['is_active'] == true;
  } catch (e) {
    return false;
  }
}

استفاده در فیلتر منو:

if (section == 'repair_shop') {
  if (!_isRepairShopPluginActive()) {
    return false; // منو نمایش داده نمی‌شود
  }
}

نتیجه:

✅ اگر افزونه فعال نباشد → بخش تعمیرگاه در منو نمایش داده نمی‌شود
✅ اگر افزونه فعال باشد → بخش تعمیرگاه در منو ظاهر می‌شود

🚀 مراحل استفاده

1. فعال‌سازی افزونه

کاربر باید از یکی از روش‌های زیر افزونه را فعال کند:

روش A: Trial (14 روز رایگان)

بازار افزونه‌ها → مدیریت تعمیرگاه → شروع 14 روز رایگان

روش B: خرید

بازار افزونه‌ها → مدیریت تعمیرگاه → خرید (ماهانه یا سالانه)

2. دسترسی به بخش تعمیرگاه

پس از فعال‌سازی:

پنل کسب‌وکار → منوی کناری → تعمیرگاه 🔧

3. استفاده از سیستم

لیست سفارشات → سفارش جدید → ثبت اطلاعات → پیگیری

📝 کارهای باقی‌مانده (TODO)

صفحات مورد نیاز

repair_order_form_page.dart - فرم ثبت/ویرایش سفارش
- انتخاب مشتری
- ورود اطلاعات کالا
- اسکن کد گارانتی
- شرح مشکل
- برآورد هزینه
repair_order_detail_page.dart - جزئیات و کارتابل
- نمایش کامل اطلاعات
- تاریخچه وضعیت‌ها (Timeline)
- افزودن قطعات
- محاسبه هزینه‌ها
- صدور فاکتور
- تحویل کالا
repair_technicians_page.dart - مدیریت تعمیرکاران
- لیست تعمیرکاران
- افزودن/ویرایش
- تنظیم حق‌الزحمه
repair_shop_settings_page.dart - تنظیمات
- فرمت شماره‌گذاری
- قالب‌های پیامک/ایمیل
- انبار و محصول پیش‌فرض
repair_kanban_board_page.dart - نمای کارتابل
- Drag & Drop
- ستون‌های وضعیت
- فیلتر تعمیرکار

سرویس‌های مورد نیاز

lib/services/repair_shop_service.dart

class RepairShopService {
  Future<Map<String, dynamic>> listOrders(...);
  Future<Map<String, dynamic>> getOrder(...);
  Future<Map<String, dynamic>> createOrder(...);
  Future<Map<String, dynamic>> updateStatus(...);
  Future<Map<String, dynamic>> addParts(...);
  Future<Map<String, dynamic>> createInvoice(...);
  // ...
}

مدل‌های مورد نیاز

lib/models/repair_shop/

repair_order.dart
repair_technician.dart
repair_order_part.dart
repair_order_status.dart

📸 تصاویر UI (طراحی مفهومی)

لیست سفارشات

┌─────────────────────────────────────────┐
│ 🔧 مدیریت تعمیرگاه            [⚙️][👥] │
├─────────────────────────────────────────┤
│ 🔍 [جستجو...]              کل: 2       │
├─────────────────────────────────────────┤
│ ┌─────────────────────────────────────┐ │
│ │ REC-2025-0001      🟠 در حال تعمیر │ │
│ │ ────────────────────────────────────│ │
│ │ 👤 علی احمدی          09121234567  │ │
│ │ 💻 لپتاپ ایسوس                     │ │
│ │ ⚠️  روشن نمی‌شود                    │ │
│ │ 👷 رضا رضایی      💰 1,500,000 ت   │ │
│ │ 🕐 دریافت: 1403/11/15 10:30        │ │
│ └─────────────────────────────────────┘ │
│                                         │
│ ┌─────────────────────────────────────┐ │
│ │ REC-2025-0002      🟢 تعمیر موفق   │ │
│ │ ...                                 │ │
│ └─────────────────────────────────────┘ │
└─────────────────────────────────────────┘
                  [➕ سفارش جدید]

🧪 نحوه تست

مرحله 1: بررسی منو

cd /var/www/ark/hesabixUI/hesabix_ui
flutter run -d chrome

وارد پنل کسب‌وکار شوید
در منوی کناری، بخش "تعمیرگاه" را جستجو کنید

نتیجه مورد انتظار:

اگر افزونه فعال نیست → منو نمایش داده نمی‌شود ❌
اگر افزونه فعال است → منو نمایش داده می‌شود ✅

مرحله 2: فعال‌سازی افزونه (از Backend)

curl -X POST "http://localhost:8000/api/v1/marketplace/business/51/plugins/3/start-trial" \
  -H "Authorization: Bearer YOUR_API_KEY"

مرحله 3: رفرش صفحه