نظرة عامة
تُعد Supabase منصة سحابية مفتوحة المصدر تمكن المستخدمين من تخزين البيانات وتوفير وظائف خلفية متكاملة. يمكنك الاتصال بـ Supabase لحل مشكلة تخزين بيانات فريق "Atoms" في ذاكرة المتصفح فقط، والتي قد تُفقد عند تحديث الصفحة أو إغلاقها. من خلال دمج Atoms مع Supabase، يمكنك تحويل موقعك إلى تطبيق كامل الوظائف مع تخزين دائم وميزات متقدمة.
المزايا الرئيسية
بالإضافة إلى عدم الحاجة لخبرة برمجية، تتميز المنصة بثلاث مزايا أساسية:
إعداد سريع: ابدأ تشغيل خلفية موقعك فوراً وسرّع عملية التطوير.
قابلة للتوسع بشكل كبير: تتكيف مع نمو المستخدمين، مما يسمح لمشروعك بالتوسع دون قيود.
فعالة من حيث التكلفة: توفر باقة مجانية مثالية للمشاريع الصغيرة والشركات الناشئة.
ربط Supabase بـ Atoms
إليك دليل قصير لربط Atoms بـ Supabase:
بدء تكامل Supabase في Atoms: افتح واجهة دردشة مشروع Atoms الخاص بك.
تحديد موقع التبويب: ابحث عن تبويب Supabase في الزاوية العلوية اليمنى وانقر على زر Connect Supabase.
إعداد الاتصال: ستظهر لك واجهة إعداد الاتصال، اتبع الخطوات الموضحة.
المصادقة وتهيئة المشروع: ستظهر نافذة منبثقة تطلب منك تسجيل الدخول إلى حساب Supabase الخاص بك.
اختيار المنظمة: اختر منظمتك من القائمة المنسدلة.
التفويض: انقر على Authorize Atoms لتفويض حسابك (ينتهي الاتصال في ثوانٍ دون الحاجة لتكوين يدوي).
بعد التفويض، يمكنك:
اختيار مشروع Supabase موجود من القائمة.
أو النقر على +Add New One لإضافة منظمة جديدة فوراً. (يتوفر مساعد Atoms لإرشادك خلال عملية الربط إذا احتجت للمساعدة).
التكوين التلقائي
بمجرد اختيار مشروعك، سيقوم Atoms بالاتصال تلقائياً بمشروع Supabase الخاص بك، وسيجمع بنية قاعدة البيانات والجداول وإعدادات الأمان. عندما ترى إشعار "Supabase Connected"، فهذا يعني أن خلفية تطبيقك مهيأة بالكامل وجاهزة للاستخدام.
مصادقة المستخدمين (User Authentication)
بعد إنشاء تطبيقك، قد ترغب في تفعيل نظام تسجيل الدخول. يبسط نظام Supabase Auth إضافة المصادقة والصلاحيات. سيقوم Atoms بإرشادك عبر طريقتين: (1) البريد الإلكتروني وكلمة المرور و (2) تسجيل الدخول عبر الشبكات الاجتماعية (Google).
البريد الإلكتروني وكلمة المرور
ربط الحساب: تأكد من امتلاك حساب Supabase صالح وقم بتفويضه من الزاوية العلوية اليمنى.
حدد متطلباتك: اكتب في الدردشة مثلاً: "Add authentication" (أضف نظام مصادقة). سيؤدي هذا غالباً لإنشاء صفحة دخول وتسجيل أساسية مرتبطة بـ Supabase.
اختبار المستخدمين: استخدم الواجهة الجديدة لإنشاء مستخدم تجريبي، ثم حدّث الصفحة للتأكد من استمرار جلسة الدخول.
تسجيل الدخول عبر جوجل (Google OAuth)
تهيئه المشروع: من لوحة تحكم Supabase، فعل خيار Google من صفحة المصادقة (Authentication > Sign In/Up).
أخبر الوكلاء بمتطلباتك: اكتب في الدردشة: "Add Google authentication". سيتم إضافة زر "Continue with Google" إلى صفحة الدخول.
الاختبار: جرب تسجيل الدخول بحساب جوجل للتأكد من تحديث ملف المستخدم وإعادة توجيهه بشكل صحيح.
تخزين البيانات (Data Storage)
بمجرد الاتصال، أخبر Atoms بنوع البيانات التي تريد حفظها. سيقوم الوكلاء تلقائياً بإنشاء الجداول ودمجها في واجهة المستخدم.
تعريف المتطلبات: اكتب مثلاً: "يرجى التأكد من حفظ سجلات الرحلات الجديدة في قاعدة البيانات".
الاختبار: أضف بيانات تجريبية عبر واجهة تطبيقك، ثم تحقق من مزامنتها في لوحة تحكم Supabase. المزامنة تتم في الوقت الفعلي بين الطرفين.
وظائف الحافة (Edge Functions)
هي برامج خلفية تعمل على خوادم قريبة من المستخدمين، مما يلغي الحاجة لإدارة خوادم تقليدية ويقلل زمن الاستجابة. أمثلة للاستخدام:
إرسال بريد ترحيبي تلقائياً عند التسجيل.
استدعاء واجهات الذكاء الاصطناعي (AI APIs) لتحليل المحتوى.
دمج بوابات الدفع (مثل Stripe) ومعالجة الطلبات.
إدارة مفاتيح الأمان
يوفر Atoms وسيلة آمنة لإدارة مفاتيح الـ API. عندما تتطلب وظيفة ما مفتاحاً سرياً، سيكتشف Atoms ذلك ويطلب منك إدخاله عبر زر "Add API Key". يتم تشفير هذه المفاتيح وتخزينها في Supabase، ولا يمكن لـ Atoms الوصول إليها لاحقاً، مما يضمن أمان بياناتك.
الأسئلة الشائعة (FAQ)
كيف أضيف ميزات خلفية Supabase لتطبيقي؟ عبر تفويض الحساب، اختيار المشروع، ثم كتابة متطلباتك في الدردشة ليقوم الوكلاء بتطويرها.
هل تدعم Supabase تسجيل الدخول الاجتماعي؟ نعم، تدعم جوجل، تويتر، غيت هاب، بالإضافة إلى البريد الإلكتروني، والرسائل النصية، والدخول الموحد (SSO).
لماذا لا يظهر مشروعي في القائمة؟ في الباقة المجانية، يتم إيقاف المشاريع غير النشطة لمدة 7 أيام تلقائياً. استخدم مرشح "Inactive" في Atoms للعثور عليها.
لماذا تظهر رسالة "المنظمة مرتبطة بمستخدم آخر"؟ تفرض Supabase ربطاً فردياً بين المنظمة وحساب Atoms. يجب حذف التفويض القديم من إعدادات API في Supabase قبل إعادة الربط بحساب جديد.