ربط Supabase

يأخذك هذا الدليل خلال الرحلة الكاملة: إعداد حساب ومشروع Supabase، وتفويض المؤسسة الصحيحة، وربط المشروع، والتحقق من نجاح الاتصال، وفصله عند الحاجة.

كيف يعمل الاتصال

ينتمي كل مشروع Supabase إلى مؤسسة، وهي التي تتحكم في من يمكنه الوصول إلى المشاريع داخلها وإدارتها. عند ربط Supabase بـ Atoms، فإنك تفوض Atoms أولاً للوصول إلى المؤسسة التي تريد استخدامها، ثم تختار مشروعًا من تلك المؤسسة لربطه.

يمكن ربط كل مشروع Atoms بـ مشروع Supabase واحد في كل مرة. ومع ذلك، يمكن ربط مشروع Supabase نفسه بأكثر من مشروع Atoms واحد.

يُعد Supabase و سحابة Atoms خيارين بديلين للواجهة الخلفية. لا يمكنك ربطهما معًا بالمشروع نفسه في Atoms في الوقت نفسه.

قبل أن تبدأ

قبل ربط Supabase، تأكد مما يلي:

• أنت مالك مساحة العمل في Atoms التي تحتوي على المشروع. لا يمكن إلا لمالك مساحة العمل تفويض Supabase أو ربطه أو فصله.
• لديك حساب Supabase، أو أنك مستعد لإنشاء حساب أثناء الإعداد.
• لديك إذن لتفويض مؤسسة Supabase والوصول إلى المشروع الذي تريد ربطه.
• أنهى Agent مهمته الحالية وتم إيقاف وضع السباق.
• يسمح متصفحك بالنوافذ المنبثقة من Atoms.
• مشروع Atoms الخاص بك غير مرتبط بالفعل بـ سحابة Atoms.

إذا كنت تجرب هذا الاتصال للمرة الأولى، ففكر في استخدام مشروع تجريبي أثناء تعلمك للعملية.

لا تلصق أبدًا كلمة مرور Supabase أو مفتاح API أو access token أو أي بيانات اعتماد أخرى في Chat.

ربط Supabase

افتح موصل Supabase

1. افتح المشروع الذي تريد ربطه.
2. انقر على اسم المشروع في أعلى يمين لوحة الدردشة.
3. اختر Connectors من القائمة المنسدلة التي تظهر.
4. ابحث عن Supabase في قائمة الموصلات المتاحة، ثم انقر على connect.

يمكنك أيضًا فتح Settings → Connectors → Supabase واختيار Connect.

افتح Settings → Connectors واختر Connect لـ Supabase.

تفويض Atoms في Supabase

إذا كان Organizations يعرض بالفعل مؤسسة Supabase التي تريد استخدامها، فهذا يعني أنه تم تفويضها بالفعل. يمكنك المتابعة إلى اختيار مشروع Supabase.

1. يفتح Atoms نافذة تفويض Supabase. سجّل الدخول إلى حساب Supabase الذي تريد ربطه، أو أنشئ حسابًا جديدًا إذا لزم الأمر.
2. تحقق من أنك سجلت الدخول إلى حساب Supabase الصحيح، ثم اختر المؤسسة التي تريد أن يصل إليها Atoms.
3. راجع الأذونات التي يطلبها Atoms. لرؤية كل إذن، اختر Show detailed permissions. إذا كنت موافقًا، فاختر Authorize Atoms.
4. ارجع إلى Atoms وانتظر ظهور رسالة Connect success.
5. في Atoms، افتح Connectors → Supabase وتأكد من ظهور المؤسسة ضمن Organizations.

يطلب Atoms صلاحية القراءة والكتابة إلى قاعدة البيانات و Secrets و Auth و Edge Functions و Environment و Projects و PostgREST و Storage. كما يطلب صلاحية القراءة إلى Organizations و Domains. تتيح هذه الأذونات لـ Atoms ربط خدمات Supabase المدعومة التي يستخدمها مشروعك وإدارتها.

ينطبق هذا التفويض على مؤسسة Supabase المحددة، ولا يقتصر على مشروع Supabase الذي ستربطه لاحقًا بمشروع Atoms الحالي. لا يمكن لـ Atoms الوصول إلى المؤسسات أو المشاريع التي لا يستطيع حساب Supabase المتصل نفسه الوصول إليها، وقد تفرض أذونات Supabase قيودًا إضافية.

راجع المؤسسة والأذونات قبل تفويض Atoms.

اختر مشروع Supabase

1. ضمن Organizations، وسّع المؤسسة التي قمت بتفويضها.
2. ضمن Projects، ابحث عن مشروع Supabase النشط الذي تريد ربطه.
3. إذا لم تكن المؤسسة التي تحتاجها مدرجة، فاختر New Organization وقم بتفويضها. هذا لا ينشئ مؤسسة Supabase جديدة؛ بل يتيح لك تفويض مؤسسة أخرى موجودة بالفعل في حساب Supabase الخاص بك.
4. إذا لم يكن لديك مشروع بعد، فاختر Create Project وأنشئ واحدًا في Supabase. انتظر حتى يصبح المشروع نشطًا وجاهزًا للاستخدام، ثم ارجع إلى Atoms واختر Update لتحديث قائمة المشاريع.
5. بجانب المشروع الذي تريد استخدامه، اختر Connect.

اختر مشروع Supabase من المؤسسة التي تم تفويضها.

تأكيد المشروع

1. في نافذة التأكيد، تحقق من المؤسسة والمشروع المعروضين ضمن Supabase Project.
2. إذا لزم الأمر، استخدم Supabase Dashboard أو View Tables للتأكد من أنك اخترت المشروع الصحيح.
3. اختر Connect.
4. يضيف Atoms عنصر اتصال Supabase إلى Chat الخاص بالمشروع. أبقِ الصفحة مفتوحة وانتظر حتى يكتمل قبل أن تطلب من Agent إنشاء قاعدة بيانات أو مصادقة أو تخزين أو ميزة للواجهة الخلفية.

أكد مشروع Supabase المحدد قبل الربط.

تحقق من نجاح الاتصال

1. افتح Settings → Connectors → Supabase.
2. تأكد من عرض المؤسسة الصحيحة ومشروع Supabase الصحيح على أنهما متصلان.
3. اختر Dashboard أو Tables وتحقق من أنه يفتح المشروع نفسه في Supabase.

قد تتضمن لوحة المشروع المتصل أيضًا روابط إلى Manage Users و SQL Editor و Edge Functions و Manage Secrets. ما عليك سوى استخدام الأقسام ذات الصلة بالميزات التي تقوم بإنشائها.

راجع مشروع Supabase المتصل وروابط إدارته.

اختبر أن تطبيقك يمكنه حفظ البيانات

لا تؤدي عملية ربط Supabase إلى إضافة ميزة قاعدة بيانات إلى تطبيقك بمفردها. في Chat، اطلب من Agent إنشاء الميزة التي تريدها واستخدام مشروع Supabase المتصل لتخزين بياناتها. بعد أن ينتهي Agent، اختبر الرحلة الكاملة.

1. في Chat، صف الميزة التي تريدها، وما المعلومات التي يجب أن تحفظها، وأين يجب أن يرى المستخدمون تلك المعلومات مرة أخرى. أخبر Agent باستخدام مشروع Supabase المتصل.
2. انتظر حتى ينتهي Agent من إنشاء الميزة.
3. في عارض التطبيقات، استخدم الميزة كما يفعل المستخدم وأدخل بيانات اختبار غير ضارة. لا تستخدم معلومات شخصية أو سرية أو حساسة.
4. حدّث عارض التطبيقات أو أعد فتح الميزة. تأكد من أن المعلومات المحفوظة ما زالت موجودة وتظهر في المكان الصحيح.
5. افتح Settings → Connectors → Supabase، واختر Tables، وتأكد من ظهور السجل المطابق في الجدول الصحيح.

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

فصل Supabase

افصل Supabase عندما لا تعود تريد أن يستخدم مشروع Atoms الحالي مشروع Supabase المتصل.

1. افتح Settings → Connectors → Supabase.
2. تأكد من أنك تعرض الاتصال الخاص بمشروع Atoms الصحيح.
3. اختر Disconnect Project.
4. انتظر حتى ينتهي عنصر فصل Supabase في Chat.
5. أعد فتح Connectors → Supabase وتأكد من أن المشروع لم يعد معروضًا على أنه متصل.

تؤدي عملية الفصل إلى إزالة الاتصال من مشروع Atoms الحالي. وهي لا تحذف مشروع Supabase أو بياناته، كما أنها لا تزيل التفويض الخاص بمؤسسة Supabase.

قد تتوقف أي ميزات في مشروع Atoms الخاص بك تعتمد على Supabase عن العمل بعد فصله. إذا كان تطبيقك منشورًا بالفعل، فقد تحتاج إلى تحديث الإصدار المنشور قبل أن يسري التغيير. اختبر كلاً من مشروعك والتطبيق المباشر بعد الفصل.

لا يؤثر فصل Supabase من مشروع Atoms واحد على مشاريع Atoms الأخرى المتصلة بمشروع Supabase نفسه.

الأسئلة الشائعة

لماذا توقف اتصال Supabase الخاص بي عن العمل؟

1. افتح Supabase Dashboard وتحقق من حالة المشروع المتأثر. قد يتم إيقاف مشروع في الباقة المجانية منخفض النشاط مؤقتًا بعد فترة سبعة أيام.
2. إذا كان متوقفًا مؤقتًا، فاختر Resume project وانتظر حتى يذكر Supabase أنه أصبح نشطًا.
3. ارجع إلى Atoms، وافتح لوحة Connectors الخاصة بالمشروع، وتحقق من اتصال Supabase. أعد محاولة الإجراء الذي فشل مرة واحدة.
4. إذا كان Supabase نشطًا بالفعل، فالتقط الخطأ الدقيق من Atoms أو Supabase وتحقق مما إذا كان الاتصال معروضًا على أنه مفصول أو منتهي الصلاحية. أعد الربط فقط عندما تشير الحالة إلى أن ذلك مطلوب.

لا تقم بتدوير المفاتيح أو إنشاء مشروع بديل حتى تعرف السبب وتكون قد حميت البيانات الحالية. إذا استمر الفشل، فاتصل بالدعم مع Chat Link والوقت والمنطقة الزمنية وحالة الاتصال ولقطة شاشة منقحة للخطأ.

مرجع خارجي: Supabase — Project Pausing

كيف أعيد ربط مشروع Supabase تم إيقافه مؤقتًا؟

1. سجّل الدخول إلى مؤسسة Supabase الصحيحة وافتح المشروع المتوقف مؤقتًا.
2. اختر Resume project وانتظر حتى تصبح حالته نشطة. تشير إرشادات Supabase الحالية إلى أن مشاريع الباقة المجانية منخفضة النشاط قد يتم إيقافها مؤقتًا بعد فترة انخفاض نشاط مدتها سبعة أيام.
3. ارجع إلى Atoms وافتح لوحة Connectors الخاصة بالمشروع. تأكد من أن Supabase متصل، ثم أعد محاولة العملية المتأثرة.
4. إذا كان Atoms لا يزال يعرض الموصل على أنه مفصول أو منتهي الصلاحية، فأعد ربطه وأكمل التفويض المطلوب.

لا تنشئ مشروع Supabase جديدًا أو تدوّر بيانات الاعتماد حتى تتم حماية البيانات الحالية. إذا فشلت إعادة الربط، فزوّد الدعم بـ Chat Link وحالة مشروع Supabase والوقت والمنطقة الزمنية ولقطة شاشة منقحة للخطأ.

مرجع خارجي: Supabase — Project Pausing