🛠️ UberFix - نظام إدارة الصيانة

📖 نظرة عامة

UberFix هو نظام متكامل لإدارة طلبات الصيانة مصمم خصيصاً للسوق المصري، يوفر منصة شاملة لربط العملاء بالفنيين وإدارة جميع عمليات الصيانة من البداية للنهاية.

🎨 التقنيات المستخدمة

Frontend

React 18 - مكتبة واجهة المستخدم
TypeScript - لغة البرمجة
Vite - أداة البناء والتطوير
Tailwind CSS - إطار تصميم CSS
Shadcn/ui - مكتبة مكونات UI
React Router - التنقل بين الصفحات
React Query - إدارة البيانات والتخزين المؤقت
React Hook Form - إدارة النماذج
Zod - التحقق من صحة البيانات

Backend

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

👥 الأدوار والصلاحيات

أدوار النظام

العميل (Customer) - إنشاء ومتابعة طلبات الصيانة
الفني (Technician) - استلام وتنفيذ طلبات الصيانة
المدير (Admin) - إدارة كاملة للنظام

إعداد المسؤول الأول

راجع دليل ADMIN_SETUP.md للحصول على تعليمات مفصلة.

📱 الميزات الرئيسية

✨ للعملاء

📝 إنشاء طلبات صيانة بسهولة
📍 تحديد الموقع عبر الخريطة
📊 متابعة حالة الطلبات في الوقت الفعلي
💬 التواصل المباشر مع الفنيين
⭐ تقييم الخدمة
📧 إشعارات عبر البريد والرسائل

🔧 للفنيين

📋 لوحة تحكم لإدارة المهام
🗺️ عرض المواقع على الخريطة
✅ تحديث حالة الطلبات
📸 رفع صور العمل المنجز
💰 إنشاء عروض الأسعار
📱 إشعارات فورية

👨‍💼 للمديرين

📊 لوحة تحكم شاملة
👥 إدارة المستخدمين والأدوار
📈 تقارير وإحصائيات مفصلة
⚙️ إعدادات النظام
🔍 سجل التدقيق (Audit Logs)
💳 إدارة الفواتير والمدفوعات

🎯 نظام SLA (اتفاقية مستوى الخدمة)

يتضمن النظام مراقبة تلقائية لـ SLA مع مهل زمنية محددة:

مستويات الأولوية

عالية (High): قبول خلال ساعة، وصول خلال ساعتين، إنجاز خلال 8 ساعات
متوسطة (Medium): قبول خلال ساعتين، وصول خلال 4 ساعات، إنجاز خلال 24 ساعة
منخفضة (Low): قبول خلال 4 ساعات، وصول خلال 8 ساعات، إنجاز خلال 48 ساعة

إشعارات SLA

تلقائياً عند تجاوز المواعيد المحددة
إرسال عبر البريد الإلكتروني و SMS
تسجيل في نظام الإشعارات

📧 نظام الإشعارات

قوالب البريد الإلكتروني

تم تطوير قوالب احترافية باستخدام React Email:

🔔 إشعارات طلبات الصيانة
✅ طلبات الموافقة
💰 الفواتير الإلكترونية
📝 تأكيد التسجيل

القوالب المتاحة

// في: supabase/functions/_shared/email-templates/
- maintenance-notification.tsx  // إشعارات الصيانة
- approval-request.tsx           // طلبات الموافقة
- invoice-email.tsx              // الفواتير

تصميم القوالب

✅ دعم كامل للغة العربية (RTL)
🎨 ألوان العلامة التجارية: #f5bf23 (أصفر)، #111 (أسود)
📱 تصميم متجاوب لجميع الأجهزة
🖼️ شعار UberFix في الترويسة

🗂️ هيكل المشروع

راجع PROJECT_STRUCTURE.md للحصول على شرح مفصل لهيكل الملفات.

🔐 الأمان

Row Level Security (RLS)

✅ تفعيل RLS على جميع الجداول الحساسة
🔒 سياسات وصول دقيقة حسب الدور
🛡️ حماية بيانات العملاء والفنيين

التدقيق

📝 تسجيل جميع العمليات الحساسة
👤 تتبع المستخدمين والإجراءات
⏰ طوابع زمنية لكل عملية

البيانات الحساسة

🔐 تشفير كلمات المرور
🗝️ تخزين المفاتيح في Secrets
❌ عدم تخزين بيانات الدفع

🔧 التطوير

الأوامر المتاحة

pnpm dev          # تشغيل في وضع التطوير
pnpm build        # بناء للإنتاج
pnpm preview      # معاينة بناء الإنتاج
pnpm lint         # فحص الكود

Edge Functions

supabase functions serve     # تشغيل محلي
supabase functions deploy    # نشر على الإنتاج

📄 الترخيص

هذا المشروع مخصص لشركة الأزعب للإنشاءات.

🤝 الدعم

للحصول على الدعم:

📧 البريد الإلكتروني: support@uberfix.shop
🌐 الموقع: https://uberfix.shop
📚 التوثيق: راجع PROJECT_STRUCTURE.md

📝 ملاحظات مهمة

امتثال البيانات: النظام يتوافق مع قانون حماية البيانات المصري رقم 151 لسنة 2020
الأمان: لا تستخدم بيانات Demo في الإنتاج
الترحيلات: ملفات supabase/migrations/ للقراءة فقط - استخدم أدوات Supabase للتعديل
Edge Functions: يتم نشرها تلقائياً عند التحديث

🗺️ خارطة الطريق

تطبيق الهاتف المحمول الأصلي
نظام المحادثة المباشرة
التكامل مع بوابات الدفع
تقارير متقدمة وتحليلات
نظام نقاط الولاء

Name		Name	Last commit message	Last commit date
Latest commit History 955 Commits
.github/workflows		.github/workflows
android/app		android/app
docs		docs
e2e		e2e
public		public
reports		reports
scripts		scripts
src		src
supabase		supabase
.env		.env
.env.production		.env.production
.env.vault		.env.vault
.eslintcache		.eslintcache
.gitattributes		.gitattributes
.gitignore		.gitignore
.npmrc		.npmrc
.nvmrc		.nvmrc
ACCELERATED_ROADMAP.md		ACCELERATED_ROADMAP.md
IMPLEMENTATION_ROADMAP.md		IMPLEMENTATION_ROADMAP.md
LICENSE		LICENSE
MEDIUM_PRIORITY_COMPLETE.md		MEDIUM_PRIORITY_COMPLETE.md
PERFORMANCE_OPTIMIZATION_REPORT.md		PERFORMANCE_OPTIMIZATION_REPORT.md
PRODUCTION_READINESS_REPORT.md		PRODUCTION_READINESS_REPORT.md
README.md		README.md
SEED_DATA_ANALYSIS.md		SEED_DATA_ANALYSIS.md
TESTING_SCRIPTS.md		TESTING_SCRIPTS.md
abuauf_branches_input.csv		abuauf_branches_input.csv
abuauf_branches_output.csv		abuauf_branches_output.csv
build-dev.js		build-dev.js
capacitor.config.ts		capacitor.config.ts
components.json		components.json
create-new-pages.txt		create-new-pages.txt
errors-warnings.txt		errors-warnings.txt
eslint.config.js		eslint.config.js
geocode_abuauf.mjs		geocode_abuauf.mjs
index.html		index.html
npm-fix.sh		npm-fix.sh
package-lock.json		package-lock.json
package.json		package.json
playwright.config.ts		playwright.config.ts
pnpm-workspace.yaml		pnpm-workspace.yaml
postcss.config.js		postcss.config.js
project-structure.txt		project-structure.txt
tailwind.config.ts		tailwind.config.ts
tsconfig.app.json		tsconfig.app.json
tsconfig.json		tsconfig.json
tsconfig.node.json		tsconfig.node.json
vite.config.ts		vite.config.ts
vitest.config.ts		vitest.config.ts

License

azab-construction/UberFix.shop

Folders and files

Latest commit

History

Repository files navigation