البيئة المحلية

الدليل التفصيلي. للطريق السريع راجع ابدأ الآن.

المتطلبات الأولية

• Node.js v22+ (يُنصح بـ LTS)
• Git
• محرر — VS Code يُنصح به

1. عمل Fork للمستودع

افتح github.com/databayt/hogwarts واضغط Fork أعلى يمين الصفحة.

اترك الإعدادات الافتراضية إلا إن احتجت اسماً مخصصاً. اضغط Create fork.

2. الاستنساخ في VS Code

افتح VS Code → أيقونة Git في الشريط الجانبي → Clone. الصق رابط الـ fork أو اختر المستودع من منتقي GitHub.

إن لم يكن الرابط متاحاً: افتح الـ fork في GitHub → اضغط زر Code الأخضر → انسخ رابط HTTPS.

اختر مجلداً أباً (مثلاً ~/Documents/projects/).

عند انتهاء الاستنساخ، افتح المشروع في VS Code.

3. تثبيت التبعيات

افتح Terminal المدمج (Ctrl/Cmd + ~):

Copypnpm install

4. إعداد البيئة

أنشئ ملف .env في جذر المشروع والصق محتواه من مجموعة WhatsApp. لا يوجد سوى .env واحد — لا .env.local ولا .env.development ولا غيرها.

5. توليد Prisma client وتشغيل الـ migrations

Copypnpm prisma generate
pnpm prisma migrate dev

6. تشغيل مخدّم التطوير

Copypnpm dev

افتح http://localhost:3000. سجّل الدخول بـ admin@balqalam.com / 1234.

التالي

• ابدأ الآن — النسخة السريعة من نفس التدفق
• المساهمة — أعراف الـcommits، أول PR
• البنية المعمارية — نمط المرآة، تعدد المستأجرين