car-smart-park

نظام إدارة المواقف الذكي - دليل النشر

تطبيق ويب متقدم لإدارة مواقف السيارات باستخدام الذكاء الاصطناعي والرؤية الحاسوبية.

🌐 خيارات النشر المتاحة

يدعم المشروع خيارين للنشر:

1. 🚀 Vercel (موصى به)

• الرابط: https://car-smart-park.vercel.app
• المميزات: SSR، نشر تلقائي، تحليلات مدمجة
• الدليل الكامل: راجع VERCEL_DEPLOYMENT.md

2. 📄 GitHub Pages

• الرابط: https://husam05.github.io/car-smart-park/
• المميزات: استضافة مجانية، نشر تلقائي من GitHub Actions
• الحالة: ✅ يعمل حالياً

---

خطوات النشر السريع على Vercel

الطريقة الأولى: عبر لوحة التحكم (الأسهل)

1. اذهب إلى vercel.com
2. سجل الدخول بحساب GitHub
3. اضغط “Add New…” → “Project”
4. اختر repository: husam05/car-smart-park
5. اضغط “Deploy”
6. انتظر 2-3 دقائق
7. التطبيق سيكون جاهزاً على: https://car-smart-park.vercel.app

الطريقة الثانية: عبر سطر الأوامر

# تثبيت Vercel CLI
npm install -g vercel

# الانتقال لمجلد المشروع
cd car-smart-park

# تسجيل الدخول
vercel login

# النشر للإنتاج
vercel --prod

---

خطوات النشر على GitHub Pages

1. تجهيز المشروع

cd car-smart-park
npm install
npm run build

2. إعداد GitHub Repository

1. أنشئ repository جديد باسم car-smart-park على GitHub
2. ارفع جميع الملفات إلى الـ repository

3. تفعيل GitHub Pages

1. اذهب إلى Settings > Pages في الـ repository
2. اختر Source: GitHub Actions
3. سيتم النشر تلقائياً عند كل push للـ main branch

4. الوصول للتطبيق

التطبيق سيكون متاحاً على: https://husam05.github.io/car-smart-park/

---

🔧 الملفات المهمة للنشر

• vercel.json - إعدادات نشر Vercel
• .github/workflows/deploy.yml - إعدادات النشر التلقائي لـ GitHub Pages
• next.config.ts - إعدادات Next.js (يتعرف تلقائياً على بيئة النشر)
• package.json - سكريبتات البناء والتصدير

🆚 مقارنة بين Vercel و GitHub Pages

الميزة	Vercel	GitHub Pages
سرعة البناء	2-3 دقائق	3-5 دقائق
SSR	✅ مدعوم	❌ غير مدعوم
نشر تلقائي	✅	✅
معاينة PR	✅ تلقائي	❌ يدوي
التحليلات	✅ مدمج	❌ يحتاج إعداد
API Routes	✅ مدعوم	❌ غير مدعوم

📊 حالة النشر الحالية

• ✅ GitHub Pages: يعمل على https://husam05.github.io/car-smart-park/
• ⏳ Vercel: جاهز للنشر (راجع VERCEL_DEPLOYMENT.md)

🎯 المميزات المتاحة

جميع المميزات تعمل على كلا المنصتين:

• ✅ خريطة المواقف - 100 موقف عبر طابقين
• ✅ المحاكاة التلقائية - اضغط “تشغيل المحاكاة”
• ✅ بوابات الدخول/الخروج - رسوم متحركة مرئية
• ✅ كاميرات المراقبة - كشف لوحات السيارات
• ✅ رمز QR في الإيصال - يظهر عند تأكيد الدخول
• ✅ سجل الأحداث - تتبع الدخول والخروج
• ✅ لوحة التحكم بالبوابات - تحكم يدوي
• ✅ التقارير المالية - تتبع الإيرادات

🐛 استكشاف الأخطاء

مشاكل البناء

# اختبر البناء محلياً
npm run build

مشاكل النشر على Vercel

1. راجع سجلات البناء في لوحة تحكم Vercel
2. تأكد من إضافة متغيرات البيئة إن وجدت
3. راجع VERCEL_DEPLOYMENT.md

مشاكل النشر على GitHub Pages

1. تحقق من GitHub Actions: اذهب إلى تبويب Actions في الـ repository
2. راجع السجلات: انظر لرسائل الخطأ في سجل البناء
3. تأكد من الملفات: تأكد أن جميع الملفات تم رفعها بشكل صحيح

📚 دعم إضافي

للمساعدة الإضافية، راجع:

• Vercel Documentation
• GitHub Pages Documentation
• Next.js Static Export
• Next.js Deployment