نشر المشروع على Vercel
المسار: تطوير نظام إدارة الأعراس ودعوات QR الوحدة: النشر والإنتاج
مدخل إلى الدرس: نشر المشروع على Vercel
نشر المشروع على Vercel — نظام إدارة الأعراس والمناسبات ودعوات QR | Next.js وPrisma | أديب الصلوي
طريقة الدراسة: اقرأ التعريف، تتبّع المثال في الشرح، نفّذه بنفسك، ثم اختبر النتيجة والحالات الاستثنائية قبل الانتقال.
أهداف هذا الدرس
- ربط مستودع Git بإصدار كما هو على المنصة Vercel.
- إعداد بيئة النشر (root، Node، Build Command).
- النشر الأول: من git push إلى URL حي.
المخطط: تدفق النشر على Vercel من الدفع إلى الربط
flowchart TD
A["git push (main)"] --> B["Vercel Build
npm install → prisma generate → npm run build"]
B --> M["prisma migrate deploy (release script)"]
M --> E["تعيين env vars
DATABASE_URL · SIGNING_SECRET"]
E --> U["URL: name.vercel.app + نطاق مخصص"]
مثال
# إعداد سكربت إصدار DB على Vercel
# package.json
"scripts": {
"postinstall": "prisma generate",
"build": "prisma migrate deploy && next build"
}مثال
pushd ../wedding-events && git add . && git commit -m "deploy wedding system" && git push origin main
أين يُضبط Node و Build؟
- افتراضياً Vercel يكشف Next أوتوماتيكياً (Framework Presets).
- ضبط Node في Project Settings → Node.js Version.
- Build Command المكتوب؛ نسخته الآمنة في package.json scripts كي يبقى موثقاً.
ترتيب المتغيرات أوّلاً
خطأ شائع: تُبنى على Vercel دون DATABASE_URL، فيرفعها prisma migrate deploy رفضاً. أدخل كل المتغيرات قبل أول build، فالمنصة لا تلمس .env.
تمرين تطبيقي: ارفع المستودع لـ GitHub ثم اربطه في Vercel، واضبط المتغيرات أولاً، وراقب سجل أول بناء يحيا URL.
أخطاء شائعة يجب تفاديها
- دعوة البناء الزراعي بلا prisma generate → العميل لا يتولَّد.
- رفع أسرار بيئة الإنتاج من واجهة خاطئة (Staging/Develop بدل Production).
- تجاهل الشروط prisma migrate deploy في Production حتى لا تفرغ الجداول.
معجم مصطلحات الدرس
- Framework Presets
- كشف Vercel عن نوع المشروع وتكوينه.
- release script
- خطوة تنجز قبل بدء الإنتاج (ترحيلات).
- env vars
- متغيرات بيئة تُضخ تحت وقت البدء للخادم.
مراجعة وتمرين تثبيت المهارة
اختبار سريع: اشرح بعبارتك معنى «نشر المشروع على Vercel»، ثم بيّن أين ستستخدمه داخل نظام تسجيل حضور دعوات مناسبة عبر رمز QR، وما الخطأ الذي يجب اختباره قبل الاعتماد على الحل.
تحدٍّ إضافي: غيّر شرطًا واحدًا في التطبيق، وتوقع النتيجة، ثم نفّذ الاختبار وفسّر الاختلاف.
الدرس التالي: قاعدة بيانات إنتاج مُدارة وأمانها. من الأفضل إنهاء التجربة الحالية قبل متابعة الدرس التالي.
