«معرفة» تطبيق Next.js قياسي، فأي استضافة تشغّل Node.js مع قرص دائم تكفي: خادم افتراضي، أو خادم مخصص، أو منصة حاويات. فيما يلي الإعداد على خادم لينكس.
1. انسخ المشروع وثبّته
git clone <مستودعك> /var/www/maarifa
cd /var/www/maarifa
npm ci
cp .env.example .env
عدّل .env للإنتاج:
SITE_URL= عنوانك الحقيقي يبدأ بـhttps://. تستخدمه روابط العودة من الدفع وروابط التحقق من الشهادات وخريطة الموقع.AUTH_SECRET= قيمة عشوائية جديدة.ADMIN_EMAILوADMIN_PASSWORD= أول مشرف. غيّر كلمة المرور من «اللوحة > المشرفون» بعد أول دخول.DEMO_HINT="0"وSEED_DEMO_STUDENT="0"وDEMO_INSTRUCTOR_PASSWORD="".
2. قاعدة البيانات
مع SQLite (تكفي لخادم واحد وآلاف المتعلّمين):
npm run setup
ولـ PostgreSQL راجع المتطلبات.
3. البناء والتشغيل
npm run build
npm start # يستمع على المنفذ 3305
أبقِه يعمل بمدير عمليات مثل PM2:
npm install -g pm2
pm2 start npm --name maarifa -- start
pm2 save && pm2 startup
4. HTTPS في الواجهة
ضع خادم ويب في الواجهة يتولى HTTPS ويحوّل الطلبات إلى المنفذ 3305. مع Nginx:
server {
server_name learn.example.om;
client_max_body_size 6m; # حجم الصور المرفوعة حتى 5 ميغابايت
location / {
proxy_pass http://127.0.0.1:3305;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
احصل على شهادة SSL (مثلًا عبر Certbot). تُعلَّم ملفات الدخول بـ Secure تلقائيًا حين يبدأ SITE_URL بـ https://. ولا تحذف X-Forwarded-For، فحدود محاولات الدخول والتسجيل والشراء والاختبارات تُحسب لكل زائر.
5. الصور والفيديوهات
تُحفظ الصور المرفوعة من اللوحة (أغلفة الدورات وصور المدرّبين وأغلفة المقالات) في public/uploads/. احتفظ بهذا المجلد بين عمليات النشر وضمّنه في النسخ الاحتياطي. والملفات المرفوعة بعد آخر بناء تُقدَّم عبر /api/media فتعمل دون إعادة البناء.
أما فيديوهات الدروس فلا تُرفع إلى الخادم: استضفها على YouTube (غير مدرجة) أو Vimeo أو أي تخزين يقدّم ملفات MP4 عبر https، والصق الرابط في الدرس.
6. النسخ الاحتياطي
انسخ كل يوم:
- قاعدة البيانات:
prisma/maarifa.db(أثناء التشغيل:sqlite3 prisma/maarifa.db ".backup maarifa-$(date +%F).db")، أو نسخة PostgreSQL؛ - مجلد
public/uploads/؛ - ملف
.env(في مكان خاص).
الشهادات صفوف في قاعدة البيانات، وضياع القاعدة يعني توقف روابط التحقق، فجرّب استعادة نسخة احتياطية مرة واحدة على الأقل.
7. التحديث
git pull
npm ci
npx prisma db push # يضيف الأعمدة الجديدة ويحفظ بياناتك
npm run build
pm2 restart maarifa
يرفض prisma db push أي تغيير يحذف بيانات ويشرح السبب، فاقرأ رسالته قبل المتابعة.
Docker (اختياري)
تكفي أي صورة Node 22: انسخ المشروع، وشغّل npm ci && npm run build، وابدأ بـ npm start، واجعل prisma/ (أو وجّه DATABASE_URL إلى PostgreSQL) وpublic/uploads/ مجلدات دائمة.