شعار واحة أدوات الذكاء الاصطناعي
واحة أدواتالذكاء الاصطناعي
المستشار الذكي
بناء تطبيق Node.js مع Supabase: الإعداد والاتصال بقاعدة البيانات
سلسلة: دورة بناء تطبيق Node.js مع Supabase
مبتدئ

بناء تطبيق Node.js مع Supabase: الإعداد والاتصال بقاعدة البيانات

45 دقيقة
٢٩ ديسمبر ٢٠٢٥
المرحلة 1 من 5

مقدمة عن Node.js وSupabase وأدوات التطوير

الفصل الثاني: مقدمة عن Node.js وSupabase وأدوات التطوير

في هذا الفصل، سنتعمق في البنية الأساسية التي سنبني عليها تطبيقنا. لن نكتفي بالتعريفات السطحية، بل سنفهم الفلسفة التقنية وراء كل أداة، وكيف تتفاعل معًا لإنشاء بيئة تطوير قوية وفعّالة للمشاريع الحديثة. نحن نستهدف بناء نظام قابل للتوسع والصيانة، واختيار الأدوات هو الخطوة الأولى الحاسمة نحو هذا الهدف.

Node.js: محرك وقت التشغيل وليس مجرد بيئة

يُفهم Node.js غالبًا على أنه بيئة لتشغيل JavaScript على الخادم، لكن هذا التعريف يقلل من قيمته الجوهرية. Node.js هو في الأساس محرك وقت تشغيل (Runtime) مبني على محرك V8 الخاص بـ Chrome، ولكنه مدمج مع libuv، وهي مكتبة C تركز على التعامل مع عمليات الإدخال/الإخراج (I/O) بطريقة غير متزامنة تعتمد على الحدث (Event-Driven). هذه التركيبة هي ما يمنح Node.js قوته.

  • النموذج غير المتزامن أحادي الخيط (Single-Threaded Event Loop): على عكس الخوادم التقليدية متعددة الخيوط، يدير Node.js طلبات متعددة على خيط واحد. حلقة الأحداث (Event Loop) توزع العمليات، مما يجعله مثالياً للتطبيقات كثيفة I/O (مثل واجهات برمجة التطبيقات، وقواعد البيانات، وخدمات الشبكة) حيث يكون وقت الانتظار هو العائق الرئيسي، وليس معالجة وحدة المعالجة المركزية.
  • نمطية CommonJS و ES Modules: يدعم Node.js نظامين للوحدات. بينما كان CommonJS (`require/module.exports`) هو النظام التقليدي، فإن دعم ES Modules (`import/export`) أصبح مستقراً. في هذا المشروع، سنستخدم ES Modules لمواكبة المعايير الحديثة للغة.
  • إدارة الحزم عبر npm: نظام إدارة الحزم (npm) هو أكبر نظام للمكتبات المفتوحة المصدر في العالم. القدرة على استيراد وإدارة التبعيات بسهولة هي أحد أركان النظام البيئي لـ Node.js.
نصيحة للمحترفين: لفهم أداء Node.js حقاً، ادرس حلقة الأحداث (Event Loop) وطريقة عمل libuv مع مجمع مؤشرات الترابط (Thread Pool) للمهام الثقيلة مثل عمليات الملفات. هذا الفهم سيساعدك في تحسين تطبيقك وتجنب حجب حلقة الأحداث (Blocking the Event Loop) بالمهام المتزامنة طويلة المدى.

Supabase: أكثر من مجرد بديل لـ Firebase

Supabase يُسوَّق غالبًا كبديل مفتوح المصدر لـ Firebase، لكن هذا يخفي قوته الحقيقية. في جوهره، Supabase هو طبقة تجميع (Abstraction Layer) وواجهة برمجة تطبيقات (API) تعمل فوق PostgreSQL مباشرة. هذا يعني أنك تحصل على قوة وقابلية توسع قاعدة بيانات علائقية حقيقية، مع سهولة استخدام تشبه قاعدة البيانات كخدمة (DBaaS).

  • PostgreSQL في الصميم: كل مشروع Supabase هو قاعدة بيانات PostgreSQL فعلية. يمكنك الاتصال بها مباشرة باستخدام أدوات مثل `psql` أو `pgAdmin`. هذا يمنحك المرونة الكاملة للاستفادة من ميزات PostgreSQL المتقدمة مثل الاستعلامات الجانبية (JSONB)، والمؤشرات (Indexes) المتخصصة، والمهام المجدولة (Functions)، والمشغلات (Triggers).
  • الاستيثاق التلقائي (Auto-generated APIs): يقوم Supabase تلقائيًا بإنشاء واجهة برمجة تطبيقات RESTful وواجهة برمجة تطبيقات في الوقت الفعلي (Realtime) بناءً على مخطط قاعدة البيانات الخاص بك. واجهة برمجة التطبيقات هذه ليست عامة؛ فهي محمية بسياسات أمان دقيقة.
  • المصادقة والإدارة (Auth & Storage): يوفر نظام مصادقة جاهز يدير المستخدمين، الجلسات، وتكامل OAuth. كما يوفر خدمة تخزين ملفات (Object Storage) مشابهة لـ Amazon S3 ولكن مع واجهة برمجة تطبيقات مبسطة.
ملاحظة مهمة: فلسفة Supabase هي "إعطائك التحكم الكامل ثم الابتعاد عن طريقك". هذا يعني أنه بينما توفر أدوات رائعة للبدء السريع، يمكنك دائمًا النزول إلى مستوى SQL الخام وإدارة البنية التحتية كما تريد عندما يكبر مشروعك.

أدوات التطوير الأساسية: بناء سلسلة العمل (Workflow)

اختيار الأدوات المساعدة هو ما يفصل بين التطوير العشوائي والتطوير الاحترافي المنظم. سنقوم بإعداد بيئة تضمن الاتساق، الجودة، والقابلية للصيانة.

1. إدارة البيئة والمتغيرات الحساسة

استخدام ملف `.env` مع حزمة `dotenv` هو المعيار. لكن في بيئة إنتاج، ستحتاج إلى حل أكثر قوة مثل تكامل مع نظام إدارة الأسرار (Secrets Manager).


// .env.example (يتم مشاركته في المستودع)
DATABASE_URL=postgresql://postgres:[YOUR-PASSWORD]@db.[YOUR-REF].supabase.co:5432/postgres
SUPABASE_URL=https://[YOUR-REF].supabase.co
SUPABASE_ANON_KEY=[YOUR-ANON-KEY]
SUPABASE_SERVICE_ROLE_KEY=[YOUR-SERVICE-ROLE-KEY] // حساس للغاية!

// app.js (استخدام dotenv للتحميل)
import 'dotenv/config'; // تحميل في بداية التطبيق
import { createClient } from '@supabase/supabase-js';

// إنشاء عميل باستخدام المفاتيح من البيئة
const supabaseUrl = process.env.SUPABASE_URL;
const supabaseAnonKey = process.env.SUPABASE_ANON_KEY;

// التحقق من وجود المتغيرات (مهم لأمان التطبيق)
if (!supabaseUrl || !supabaseAnonKey) {
    throw new Error('Supabase URL and Anon Key must be set in environment variables');
}

const supabase = createClient(supabaseUrl, supabaseAnonKey);
تحذير شائع: لا ترفع ملف `.env` الفعلي أبدًا إلى نظام التحكم في الإصدار (Git). تأكد من وجوده في `.gitignore`. استخدم دائمًا ملف `.env.example` لتوثيق المتغيرات المطلوبة. المفتاح `SUPABASE_SERVICE_ROLE_KEY` يتجاوز سياسات الأمان (RLS) - احتفظ به آمنًا على الخادم ولا تستخدمه في كود الواجهة الأمامية أبدًا.

2. إعداد مشروع Node.js مع ES Modules

لضمان استخدام أحدث معايير JavaScript، سنقوم بتكوين المشروع لاستخدام وحدات ES.


// package.json
{
  "name": "nodejs-supabase-app",
  "version": "1.0.0",
  "description": "تطبيق Node.js مع Supabase",
  "type": "module", // هذا هو السطر الحاسم! يخبر Node.js باستخدام ES Modules.
  "main": "src/index.js",
  "scripts": {
    "start": "node src/index.js",
    "dev": "nodemon src/index.js", // استخدام nodemon للتطوير
    "test": "jest"
  },
  "dependencies": {
    "@supabase/supabase-js": "^2.39.0",
    "dotenv": "^16.3.0",
    "express": "^4.18.2"
  },
  "devDependencies": {
    "nodemon": "^3.0.1",
    "jest": "^29.6.0"
  },
  "engines": {
    "node": ">=18.0.0" // تحديد إصدار Node

جاري تحميل التقييمات...