UberFix هو نظام متكامل لإدارة طلبات الصيانة مصمم خصيصاً للسوق المصري، يوفر منصة شاملة لربط العملاء بالفنيين وإدارة جميع عمليات الصيانة من البداية للنهاية.
- React 18 - مكتبة واجهة المستخدم
- TypeScript - لغة البرمجة
- Vite - أداة البناء والتطوير
- Tailwind CSS - إطار تصميم CSS
- Shadcn/ui - مكتبة مكونات UI
- React Router - التنقل بين الصفحات
- React Query - إدارة البيانات والتخزين المؤقت
- React Hook Form - إدارة النماذج
- Zod - التحقق من صحة البيانات
- Supabase - قاعدة بيانات PostgreSQL
- Edge Functions - وظائف خادم لا خدمية (Deno)
- Resend - إرسال البريد الإلكتروني
- Twilio - إرسال الرسائل النصية
- Google Maps API - الخرائط والمواقع
- Resend - نظام البريد الإلكتروني
- Twilio - الرسائل النصية والإشعارات
- Google Maps - تحديد المواقع والمسافات
Node.js >= 18
pnpm >= 8
Supabase CLI- استنساخ المشروع
git clone <repository-url>
cd uberfix- تثبيت التبعيات
pnpm install- إعداد المتغيرات البيئية
قم بإنشاء ملف
.envفي الجذر:
VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_ANON_KEY=your_supabase_anon_key- تشغيل المشروع
pnpm devللحصول على بناء إنتاجي نظيف مع تثبيت التبعيات من الصفر، استخدم السكربت الجاهز:
bash scripts/production-build.shراجع دليل التشغيل الإنتاجي لمعرفة التفاصيل الكاملة والخطوات اليدوية البديلة.
لديك فرع مخصص لتشغيل التطبيق عبر Expo على الهواتف الذكية بدلاً من نسخة الويب. اتبع دليل إعداد فرع Expo للهواتف للتبديل إلى الفرع الصحيح وتشغيل التطبيق على أجهزة Android أو iOS.
- العميل (Customer) - إنشاء ومتابعة طلبات الصيانة
- الفني (Technician) - استلام وتنفيذ طلبات الصيانة
- المدير (Admin) - إدارة كاملة للنظام
راجع دليل ADMIN_SETUP.md للحصول على تعليمات مفصلة.
- 📝 إنشاء طلبات صيانة بسهولة
- 📍 تحديد الموقع عبر الخريطة
- 📊 متابعة حالة الطلبات في الوقت الفعلي
- 💬 التواصل المباشر مع الفنيين
- ⭐ تقييم الخدمة
- 📧 إشعارات عبر البريد والرسائل
- 📋 لوحة تحكم لإدارة المهام
- 🗺️ عرض المواقع على الخريطة
- ✅ تحديث حالة الطلبات
- 📸 رفع صور العمل المنجز
- 💰 إنشاء عروض الأسعار
- 📱 إشعارات فورية
- 📊 لوحة تحكم شاملة
- 👥 إدارة المستخدمين والأدوار
- 📈 تقارير وإحصائيات مفصلة
- ⚙️ إعدادات النظام
- 🔍 سجل التدقيق (Audit Logs)
- 💳 إدارة الفواتير والمدفوعات
يتضمن النظام مراقبة تلقائية لـ SLA مع مهل زمنية محددة:
- عالية (High): قبول خلال ساعة، وصول خلال ساعتين، إنجاز خلال 8 ساعات
- متوسطة (Medium): قبول خلال ساعتين، وصول خلال 4 ساعات، إنجاز خلال 24 ساعة
- منخفضة (Low): قبول خلال 4 ساعات، وصول خلال 8 ساعات، إنجاز خلال 48 ساعة
- تلقائياً عند تجاوز المواعيد المحددة
- إرسال عبر البريد الإلكتروني و SMS
- تسجيل في نظام الإشعارات
تم تطوير قوالب احترافية باستخدام React Email:
- 🔔 إشعارات طلبات الصيانة
- ✅ طلبات الموافقة
- 💰 الفواتير الإلكترونية
- 📝 تأكيد التسجيل
// في: supabase/functions/_shared/email-templates/
- maintenance-notification.tsx // إشعارات الصيانة
- approval-request.tsx // طلبات الموافقة
- invoice-email.tsx // الفواتير- ✅ دعم كامل للغة العربية (RTL)
- 🎨 ألوان العلامة التجارية:
#f5bf23(أصفر)،#111(أسود) - 📱 تصميم متجاوب لجميع الأجهزة
- 🖼️ شعار UberFix في الترويسة
راجع PROJECT_STRUCTURE.md للحصول على شرح مفصل لهيكل الملفات.
- ✅ تفعيل RLS على جميع الجداول الحساسة
- 🔒 سياسات وصول دقيقة حسب الدور
- 🛡️ حماية بيانات العملاء والفنيين
- 📝 تسجيل جميع العمليات الحساسة
- 👤 تتبع المستخدمين والإجراءات
- ⏰ طوابع زمنية لكل عملية
- 🔐 تشفير كلمات المرور
- 🗝️ تخزين المفاتيح في Secrets
- ❌ عدم تخزين بيانات الدفع
pnpm dev # تشغيل في وضع التطوير
pnpm build # بناء للإنتاج
pnpm preview # معاينة بناء الإنتاج
pnpm lint # فحص الكودsupabase functions serve # تشغيل محلي
supabase functions deploy # نشر على الإنتاجهذا المشروع مخصص لشركة الأزعب للإنشاءات.
للحصول على الدعم:
- 📧 البريد الإلكتروني: support@uberfix.shop
- 🌐 الموقع: https://uberfix.shop
- 📚 التوثيق: راجع PROJECT_STRUCTURE.md
- امتثال البيانات: النظام يتوافق مع قانون حماية البيانات المصري رقم 151 لسنة 2020
- الأمان: لا تستخدم بيانات Demo في الإنتاج
- الترحيلات: ملفات
supabase/migrations/للقراءة فقط - استخدم أدوات Supabase للتعديل - Edge Functions: يتم نشرها تلقائياً عند التحديث
- تطبيق الهاتف المحمول الأصلي
- نظام المحادثة المباشرة
- التكامل مع بوابات الدفع
- تقارير متقدمة وتحليلات
- نظام نقاط الولاء
