قبل أن تبدأ
تحتاج إلى Node.js بالإصدار 20.9 أو أحدث، وإلى npm. لا شيء غير ذلك: قاعدة البيانات ملف SQLite يُنشأ داخل المشروع. لخوادم الإنتاج وPostgreSQL راجع المتطلبات.
1. ثبّت الحزم
npm install
2. أنشئ ملف الإعدادات
cp .env.example .env
افتح .env وغيّر هذين السطرين على الأقل:
AUTH_SECRET: نص عشوائي طويل يُوقَّع به ملف تسجيل الدخول. ولّده بالأمرnode -e "console.log(require('crypto').randomBytes(32).toString('hex'))".OWNER_PASSWORD: كلمة مرور حساب المالك الأول (OWNER_EMAIL).
شرح كل المتغيرات في صفحة متغيرات البيئة.
3. أنشئ قاعدة البيانات والمتجر التجريبي
npm run setup
ينفّذ هذا الأمر ثلاث خطوات: prisma generate (عميل قاعدة البيانات)، وprisma db push (ينشئ prisma/souq.db بكل جداوله)، وnode prisma/seed.mjs (المتجر التجريبي وحساب المالك). تشغيل التعبئة مرة ثانية آمن: فهي لا تملأ إلا ما كان فارغًا.
4. شغّل المتجر
npm run dev
- المتجر: http://localhost:3302 (يحوّلك إلى
/ar، والإنجليزية على/en) - اللوحة: http://localhost:3302/ar/dashboard (ادخل بـ
OWNER_EMAILوOWNER_PASSWORD) - التوثيق: http://localhost:3302/ar/docs
يعمل المتجر على المنفذ 3302. لتغييره عدّل أمري dev وstart في package.json وقيمة SITE_URL في .env.
5. تأكد أن كل شيء يعمل
npm test # اختبارات التسعير والتصفية وقواعد الطلبات والصلاحيات
npm run build && npm start # نسخة الإنتاج على المنفذ 3302
python scripts/e2e_api.py # اختبار شامل للـ API على الخادم العامل
python scripts/check_pages.py # كل الصفحات باللغتين وكل روابط التوثيق
ينشئ e2e_api.py بعض الطلبات التجريبية، فشغّله على قاعدة بيانات تجريبية جديدة لا على متجر حقيقي.
البدء من جديد
للعودة إلى المتجر التجريبي: أوقف الخادم، واحذف prisma/souq.db، ثم شغّل npm run setup مرة أخرى.
وضع العرض التجريبي
لعرض تجريبي عام، اضبط DEMO_HINT="1" (يُظهر بيانات دخول المالك في صفحة الدخول) وSEED_DEMO_SHOPPER="1" (ينشئ حساب عميل بطلبات وقائمة مفضلة). لا تستخدم أيًّا منهما في متجر حقيقي.