البرمجيات
| الإصدار | ملاحظات | |
|---|---|---|
| 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 إذا شغّلت أكثر من خادم، أو إذا كانت استضافتك توفر قاعدة بيانات مُدارة.
في
prisma/schema.prismaغيّر المزوّد:datasource db { provider = "postgresql" url = env("DATABASE_URL") }في
.envضع سلسلة الاتصال:DATABASE_URL="postgresql://souq:password@localhost:5432/souq?schema=public"أنشئ الجداول والبيانات التجريبية:
npm run setup.
لا حاجة إلى تغيير أي كود: البحث يستخدم مرشحات contains بسيطة تعمل على القاعدتين، والمبالغ أعداد صحيحة في الحالتين.
المتصفحات
يعمل المتجر واللوحة على الإصدارات الحالية من Chrome وSafari وEdge وFirefox، على الهواتف وأجهزة الحاسوب. اختصار البحث السريع Ctrl K على Windows وLinux، وCmd K على Mac.