المتطلبات

ما يحتاجه المتجر ليعمل، وكيف تنقل قاعدة البيانات إلى PostgreSQL.

البرمجيات

الإصدار ملاحظات
Node.js 20.9 أو أحدث (يُفضَّل 22 LTS) يتطلبه Next.js 16
npm 10 أو أحدث يأتي مع Node.js
قاعدة البيانات SQLite (مضمّنة) أو PostgreSQL 14 فأحدث SQLite لا تحتاج إلى تثبيت
Python 3 اختياري فقط لـscripts/e2e_api.py وscripts/check_pages.py ومولّد الصور

الخادم

يكفي خادم افتراضي صغير لمتجر فيه بضعة آلاف من المنتجات: معالج واحد، و1 غيغابايت ذاكرة، و10 غيغابايت قرص. عملية البناء نفسها تستهلك نحو 1 غيغابايت من الذاكرة أثناء تشغيلها؛ على خادم بذاكرة 512 ميغابايت ابنِ المشروع على جهازك وانسخ مجلد .next.

الحزم الرئيسية

الحزمة استخدامها
Next.js 16 وReact 19 الصفحات والعرض على الخادم والـ API
next-intl 4 العربية والإنجليزية والاتجاه من اليمين، واللغة في كل رابط
Tailwind CSS 4 التنسيق، وألوان الهوية رموزٌ قابلة للتغيير
Prisma 6 الوصول إلى قاعدة البيانات ومخططها
zod 4 التحقق من كل طلب يصل إلى الخادم
jose ملفات الجلسات الموقّعة
marked صفحات هذا التوثيق
lucide-react الأيقونات

PostgreSQL

SQLite ملف واحد وهي الأبسط لخادم واحد. استخدم PostgreSQL إذا شغّلت أكثر من خادم، أو إذا كانت استضافتك توفر قاعدة بيانات مُدارة.

  1. في prisma/schema.prisma غيّر المزوّد:

    datasource db {
      provider = "postgresql"
      url      = env("DATABASE_URL")
    }
    
  2. في .env ضع سلسلة الاتصال:

    DATABASE_URL="postgresql://souq:password@localhost:5432/souq?schema=public"
    
  3. أنشئ الجداول والبيانات التجريبية: npm run setup.

لا حاجة إلى تغيير أي كود: البحث يستخدم مرشحات contains بسيطة تعمل على القاعدتين، والمبالغ أعداد صحيحة في الحالتين.

المتصفحات

يعمل المتجر واللوحة على الإصدارات الحالية من Chrome وSafari وEdge وFirefox، على الهواتف وأجهزة الحاسوب. اختصار البحث السريع Ctrl K على Windows وLinux، وCmd K على Mac.