النشر والتوثيق

الـ API يعمل على جهازك، والخطوة الأخيرة أن يعمل على الإنترنت ويستعمله غيرك: واجهة React، أو تطبيق هاتف، أو مبرمج آخر.

النشر على استضافة تدعم Node.js

ثلاثة خيارات شائعة:

  • استضافة cPanel فيها «Setup Node.js App»: متوفرة عند كثير من المستضيفين في الجزائر. تنشئ تطبيقًا، وتحدد مجلده وملف البداية server.js، وترفع الملفات، ثم تضغط Run NPM Install وRestart.
  • خادم خاص (VPS): تحكّم كامل، مع PM2 ليبقي التطبيق يعمل ويعيد تشغيله إذا توقف:
npm install -g pm2
pm2 start server.js --name tasks-api
pm2 save
  • منصات جاهزة مثل Render أو Railway: تربطها بمستودع GitHub فتنشر مع كل push.

مهما كان الخيار، اقرأ المنفذ من البيئة (process.env.PORT)، لأن المستضيف هو من يحدده.

متغيرات البيئة في الإنتاج

لا ترفع ملف .env إلى الخادم ولا إلى GitHub. كل الاستضافات توفر مكانًا في لوحتها لإضافة المتغيرات: DATABASE_URL و JWT_SECRET وغيرها.

  • استعمل في الإنتاج قيمًا مختلفة عن جهازك، خاصة JWT_SECRET.
  • ولّد الأسرار عشوائيًا وطويلة: node -e "console.log(require('crypto').randomBytes(48).toString('hex'))".
  • تأكد أن القيمة NODE_ENV=production مضبوطة؛ كثير من المكتبات تعمل أسرع وأكثر أمانًا معها.

كتابة توثيق واضح

الـ API بلا توثيق لا يستعمله أحد، حتى أنت بعد ستة أشهر. في README.md اكتب لكل مسار:

### إنشاء مهمة
`POST /api/tasks` (يتطلب تسجيل الدخول)

الجسم:
{ "title": "تصميم الشعار" }

الاستجابة 201:
{ "id": 7, "title": "تصميم الشعار", "done": false }

الأخطاء: 400 بيانات غير صحيحة، 401 لم تسجّل الدخول

وللمشاريع الأكبر، معيار OpenAPI يصف الـ API في ملف واحد، وتولّد منه أدوات صفحة توثيق تفاعلية يجرب فيها القارئ الطلبات مباشرة.

مراقبة الأخطاء

  • أضف مسارًا بسيطًا يخبرك أن الخادم حي:
app.get("/health", (req, res) => res.json({ ok: true }));
  • اربطه بخدمة مراقبة مجانية مثل UptimeRobot، ترسل لك تنبيهًا إذا توقف الخادم.
  • راجع السجلات (Logs) في لوحة الاستضافة أو بـ pm2 logs بعد كل نشر.
  • وعندما يكبر المشروع، خدمة مثل Sentry تجمع الأخطاء مع تفاصيلها في مكان واحد.

مهمتك

انشر الـ API على استضافة تدعم Node.js، واضبط متغيرات البيئة في لوحتها، واكتب توثيقًا لكل المسارات في README. ثم اربط به واجهة قائمة المهام من دليل React بدل localStorage، واربط /health بخدمة مراقبة.