التثبيت اليدوي والنشر

ضع المتجر على خادم: البناء، والتشغيل بمدير عمليات، وHTTPS في الواجهة، والنسخ الاحتياطي.

«سوق» تطبيق Next.js معتاد، ويعمل على أي استضافة تشغّل Node.js: خادم افتراضي (VPS) أو خادم مخصص أو منصة فيها قرص دائم. فيما يلي الإعداد على خادم Linux افتراضي، وهو الخيار الأكثر شيوعًا في عُمان.

1. انسخ المشروع وثبّته

git clone <مستودعك> /var/www/souq
cd /var/www/souq
npm ci
cp .env.example .env

عدّل .env للإنتاج:

  • SITE_URL = عنوانك الحقيقي مع https:// (تعتمد عليه روابط العودة من «ثواني» وخريطة الموقع).
  • AUTH_SECRET = قيمة عشوائية جديدة (ليست التي على جهازك).
  • OWNER_EMAIL وOWNER_PASSWORD = المالك الأول. غيّر كلمة المرور من اللوحة بعد أول دخول.
  • DEMO_HINT="0" وSEED_DEMO_SHOPPER="0".

2. قاعدة البيانات

مع SQLite (مناسبة لخادم واحد وآلاف الطلبات شهريًا):

npm run setup

لتبدأ بكتالوج فارغ بدل المتجر التجريبي، شغّل npx prisma generate && npx prisma db push ثم احذف المنتجات التجريبية من اللوحة، أو عدّل prisma/catalog-data.mjs قبل التعبئة.

لاستخدام PostgreSQL راجع المتطلبات.

3. البناء والتشغيل

npm run build
npm start          # يستمع على المنفذ 3302

أبقِه يعمل بمدير عمليات مثل PM2:

npm install -g pm2
pm2 start npm --name souq -- start
pm2 save && pm2 startup

4. HTTPS في الواجهة

ضع أمامه خادم ويب يتولى HTTPS ويحوّل الطلبات إلى المنفذ 3302. مثال لـNginx:

server {
  server_name shop.example.om;
  client_max_body_size 6m;            # صور المنتجات حتى 5 ميغابايت
  location / {
    proxy_pass http://127.0.0.1:3302;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
  }
}

ثم احصل على شهادة (بأداة Certbot مثلًا). تُعلَّم ملفات تسجيل الدخول بـSecure تلقائيًا حين يبدأ SITE_URL بـhttps://.

ترويسة X-Forwarded-For مهمة: حدود الطلبات على تسجيل الدخول وإتمام الطلب ونموذج التواصل تُحسب لكل عنوان IP زائر.

5. الصور المرفوعة

تُحفظ الصور المرفوعة من اللوحة في public/uploads/. احتفظ بهذا المجلد عند نشر إصدار جديد (فهو في .gitignore)، وأدرجه في النسخ الاحتياطي. الملفات المرفوعة بعد آخر بناء تُقدَّم عبر /api/media فتعمل دون إعادة بناء.

6. النسخ الاحتياطي

انسخ شيئين كل يوم:

  • قاعدة البيانات: prisma/souq.db (انسخها والخادم يعمل بالأمر sqlite3 prisma/souq.db ".backup souq-$(date +%F).db")، أو نسخة PostgreSQL؛
  • المجلد public/uploads/.

7. التحديث

git pull
npm ci
npx prisma db push      # يضيف الأعمدة والجداول الجديدة ويحتفظ ببياناتك
npm run build
pm2 restart souq

ينبّهك prisma db push قبل أي تغيير قد يضيّع بيانات. اقرأ التنبيه، ولا تستخدم --force-reset أبدًا على متجر يعمل.

أكثر من نسخة من الخادم

يحفظ محدِّد الطلبات عدّاداته في الذاكرة لكل عملية. إن شغّلت أكثر من نسخة خلف موزّع أحمال، فانقل العدّادات إلى مخزن مشترك (Redis) في src/lib/api.ts، واستخدم PostgreSQL بدل SQLite.