المتطلبات

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

الخادم

الحد الأدنى المريح
Node.js 20.9 22 LTS
الذاكرة 1 غيغابايت 2 غيغابايت (يحتاج البناء نحو 1.5 غيغابايت)
القرص 1 غيغابايت مع ملفاتك المرفوعة SSD
قاعدة البيانات SQLite (مضمّنة) PostgreSQL 14 فأحدث لعدة خوادم أو حركة كثيفة

لا يحتاج الخادم اتصالًا خارجيًا عبر HTTPS إلا للدفع عبر «ثواني» وخدمة الذكاء الاصطناعي الاختيارية.

المتصفحات

آخر إصدارين من Chrome وEdge وSafari (ماك وiOS) وFirefox، وSamsung Internet. تُقرأ الصفحات دون JavaScript (الكتالوج وصفحات الدورات والمدونة)، أما السلة وإتمام الشراء والاختبارات واللوحة فتحتاجه.

PostgreSQL

  1. غيّر مزوّد قاعدة البيانات في prisma/schema.prisma:
datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}
  1. اضبط الاتصال في .env:
DATABASE_URL="postgresql://maarifa:password@localhost:5432/maarifa?schema=public"
  1. شغّل npm run setup.

لا يتغير شيء آخر: الشيفرة تستخدم Prisma فقط، والبحث في الكتالوج يتم داخل التطبيق فيعمل بالطريقة نفسها في القاعدتين.

عدة خوادم

تُحفظ حدود المحاولات (الدخول والشراء ومحاولات الاختبار) في ذاكرة كل عملية. إن شغّلت أكثر من نسخة خلف موزّع أحمال فاستخدم الجلسات الثابتة، أو استبدل rateLimit() في src/lib/api.ts بمخزن مشترك مثل Redis. ويجب أن تكون الملفات المرفوعة على تخزين مشترك أيضًا.