مطاعم

# شرح موجز عن تطبيق "طبق" (TBQ)

## ? نظرة عامة

تطبيق توصيل طعام/منتجات مبني بـ Flutter**، يربط بين العملاء والمنتجين (المتاجر/المطاعم).

---

## ? الأدوار الرئيسية

### 1. **العميل (Customer)

- يتصفح المنتجات، يضيف للسلة، يطلب، ويتابع الطلبات

### 2. المنتج (Producer)

- يدير منتجاته، يتلقى الطلبات، ويحدّث حالة الطلب

### 3. الأدمن (Admin)

- يتحقق من المدفوعات المحلية (Wallet) ويوافق عليها

---

## ✨ الميزات الرئيسية

### ? للعملاء:

- ✅ تصفح المنتجات حسب الفئات

- ? البحث عن المنتجات

- ? عرض العروض والمنتجات الأكثر مبيعاً

- ? إضافة المنتجات للسلة

- ? إتمام الطلب (Checkout) بطريقتين:

- الدفع عند الاستلام (COD)

- التحويل المحلي (يتطلب إثبات تحويل)

- ? متابعة الطلبات (قيد المعالجة، مكتملة، ملغاة)

- ✅ تأكيد الاستلام وتقييم الطلب

- ? عرض المتاجر/المطاعم

### ? للمنتجين:

- ? لوحة تحكم لإدارة المنتجات

- ➕ إضافة/تعديل/حذف المنتجات

- ? عرض الطلبات وتحديث حالتها:

- قبول الطلب

- جاري التحضير

- في الطريق

- تم التسليم

- ? إحصائيات (الطلبات، المبيعات، التقييمات)

- ? عرض الملف الشخصي

### ? للأدمن:

- ? عرض الطلبات المعلقة في انتظار تأكيد الدفع

- ✅ تأكيد أو رفض المدفوعات المحلية

---

## ? التقنيات المستخدمة

- Flutter - واجهة المستخدم

- PHP - Backend API

- MySQL - قاعدة البيانات

- Clean Architecture - فصل الطبقات

- BLoC/Cubit - إدارة الحالة

- Dependency Injection (GetIt) - حقن التبعيات

- SharedPreferences - حفظ بيانات المستخدم محلياً

---

## ? دورة حياة الطلب

1. إنشاء الطلب → pending أو waiting_admin_confirmation (إذا كان الدفع محلي)

2. قبول المنتج → accepted

3. جاري التحضير → preparing

4. في الطريق → out_for_delivery

5. تم التسليم → delivered

6. تأكيد العميل → يمكن التقييم

7. أو إلغاء → cancelled

---

## ? المميزات التقنية

- ✅ حفظ حالة تسجيل الدخول (البقاء مسجلاً حتى بعد إغلاق التطبيق)

- ? واجهة عربية بالكامل

- ? دعم الوضع الليلي/النهاري

- ? تصميم متجاوب (ScreenUtil)

- ⚠️ معالجة الأخطاء والاتصال بالشبكة

## ? كيفية الاستخدام

### للعملاء:

1. تسجيل الدخول أو التسجيل

2. تصفح المنتجات من الصفحة الرئيسية

3. إضافة المنتجات للسلة

4. إتمام الطلب واختيار طريقة الدفع

5. متابعة الطلب من صفحة "طلباتي"

6. تأكيد الاستلام وتقييم الطلب

### للمنتجين:

1. تسجيل الدخول بحساب منتج

2. إدارة المنتجات من لوحة التحكم

3. متابعة الطلبات وتحديث حالتها

4. عرض الإحصائيات

### للأدمن:

1. تسجيل الدخول بحساب أدمن

2. عرض الطلبات المعلقة

3. تأكيد أو رفض المدفوعات

---

## ? ملاحظات

- التطبيق يدعم اللغة العربية بالكامل

- يتم حفظ حالة تسجيل الدخول تلقائياً

- يمكن الدفع نقداً عند الاستلام أو عبر التحويل المحلي

- كل طلب له دورة حياة كاملة من الإنشاء حتى التسليم

---

تم إنشاء هذا الملف بواسطة AI Assistant