اربط مشروع Atoms بـ Supabase عندما تريد أن يستخدم التطبيق قاعدة بيانات 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 — إيقاف المشروع مؤقتًا

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

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

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

مرجع خارجي: Supabase — إيقاف المشروع مؤقتًا