كيف تضيف قاعدة بيانات لتطبيقك في ChanTan Studio

امنح تطبيقك ذاكرة في نحو دقيقة: اربط قاعدة بيانات بنقرة واحدة، شاهد ما حفظه تطبيقك، عدّل الصفوف يدويًا، واسأل عن بياناتك بلغتك العادية.

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

خذ مطعم "دار زيتون" مثالًا: بلا قاعدة بيانات، نموذج الحجز مجرد شكل جميل. ومعها، يصل كل حجز ويبقى محفوظًا.

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

1. افتح "الإدارة ▾" ← "قاعدة البيانات"

أعلى مشروعك، اضغط "الإدارة ▾"، ثم "قاعدة البيانات".

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

2. اختر "⚡ قاعدة بيانات Chantan"

اضغط "اتصل الآن →" تحت "⚡ قاعدة بيانات Chantan". هذا هو خيار النقرة الواحدة، وهو الجواب الصحيح لأغلب الناس.

لا تختر "🔷 Supabase الخاص بك" إلا إذا كان لديك حساب Supabase فعلًا وتريد تحديدًا أن تسكن بياناتك فيه.

3. انتظر نحو دقيقة

تُختار أقرب منطقة إليك تلقائيًا. سترى "جارٍ إعداد قاعدة بياناتك…" — "ننشئ قاعدة بياناتك المُدارة — يستغرق ذلك عادةً نحو دقيقة. سيُفتح المدير الكامل تلقائيًا عند الجاهزية."

✅ تم! يفتح المدير من تلقاء نفسه. يفترض أن ترى الآن شاشة بيانات تطبيقك بدل شاشة الاختيار — وصار تطبيقك قادرًا على الحفظ الدائم.

يمكنك أيضًا أن تطلبها في المحادثة ببساطة

اكتب شيئًا مثل "أضف تسجيل دخول" أو "احفظ البيانات"، وسيعرض عليك الذكاء الاصطناعي الخيار نفسه.

وحين يستنتج أن ميزة ما تحتاج بيانات محفوظة، يتوقف قبل كتابة أي سطر كود ويعرض بطاقة داخل المحادثة:

"تطبيقك يحتاج إلى قاعدة بيانات" — "سنستخدم قاعدة بيانات Chantan افتراضيًا ما لم تختر خيارًا آخر."

خيار ChanTan موسوم بـ "الافتراضي" ومعه عدّاد تنازلي مدته 7 ثوانٍ — "اتصال تلقائي خلال {seconds} ث" — أي أن عدم فعل أي شيء جواب صحيح تمامًا. أما البديلان فهما "اربط Supabase الخاص بك" و**"بلا قاعدة بيانات — بناء بحالة محلية فقط"**. وعند النجاح سترى "تم الاتصال — نواصل بناء تطبيقك…"

النظر إلى بياناتك

بعد الربط، يفتح "الإدارة ▾" ← "قاعدة البيانات" صفحة "قاعدة البيانات" — "اعرض البيانات المخزنة في تطبيقك وأدرها."

سترى القوائم التي يحفظها تطبيقك، وأمام كل واحدة عدد صفوفها. اضغط أي واحدة لفتح سجلاتها.

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

أن تسأل عن بياناتك بلغتك العادية

صندوق "استعلم عن بياناتك" يتيح لك أن تسأل أشياء مثل "اعرض جميع المستخدمين الذين سجّلوا خلال آخر 7 أيام". وله ثلاثة أوضاع — "محادثة" و**"SQL"** و**"رسم بياني"** — ويستطيع رسم مخطط بعد أن تختار المحورين.

هذا الصندوق يرى فقط، ولا يغيّر أبدًا. اطلب منه تعديل شيء فيجيبك "لا يمكنك تعديل بنية قاعدة البيانات مباشرة — استخدم المحادثة بدلًا من ذلك". وهذه هي النصيحة الصحيحة فعلًا: التغييرات البنيوية تُطلب في المحادثة.

⚠️ "محرّر SQL" الموجود تحت "متقدم" شيء آخر مختلف تمامًا، وهو قوي. ينبّهك أولًا — "Heads up: Commands here run on your live database and can change or remove data. Double-check before you run." (تنبيه: الأوامر هنا تُنفَّذ على قاعدة بياناتك الحية وقد تغيّر بياناتك أو تحذفها؛ تحقق جيدًا قبل التنفيذ) — ثم ينفّذ فورًا، بلا تأكيد ثانٍ وبلا تراجع. أغلب أصحاب المواقع لا يحتاجونه أبدًا.

ربط Supabase الخاص بك

اختيار "🔷 Supabase الخاص بك" يفتح نموذجًا مُرشِدًا عنوانه "إعداد في 3 دقائق — اتبع هذه الخطوات":

1. أنشئ مشروع Supabase إن لم يكن لديك واحد.
2. انسخ رابط المشروع (URL) والمفتاح العام (anon). "⚠ لا تستخدم service_role — لديه صلاحيات إدارية كاملة ويجب ألا يُشارك أبدًا."
3. شغّل أمر الإعداد الذي يعطيك إياه، عبر زر "نسخ SQL الإعداد" — "هذا ينشئ جدول البيانات ومخازن التخزين التي يحتاجها تطبيقك. مرة واحدة، وآمن لإعادة التشغيل."
4. اختياري: صندوق متقدم يتيح للذكاء الاصطناعي بناء تكاملات من جهة الخادم على Supabase الخاص بك. وبدونه تبقى كل ميزات بياناتك وملفاتك تعمل.

ثم اضغط "اختبار واتصال".

وهناك حد واحد يجدر أن تعرفه: ما دام مشروعك يستخدم Supabase الخاص بك، لا يستطيع ChanTan إضافة مستخدمي تطبيقك أو تعديلهم أو حذفهم — ويقول لك "Open the Auth tab in your Supabase dashboard." (افتح تبويب Auth في لوحة تحكم Supabase لديك). كما يُتابَع استخدامك هناك: "الاستخدام يُدار في Supabase الخاص بك".

بياناتك مؤمّنة نيابةً عنك

لست أنت من يشغّل ذلك. "بياناتك مؤمّنة تلقائيًا" — "يفعّل Chantan حماية البيانات (أمان مستوى الصفوف) لكل جدول عند النشر — لا حاجة لفعل أي شيء."

وشاشة "الاقتراحات" تعرض إضافات اختيارية (جعل الملفات العامة خاصة، منع كلمات المرور المعروف تسرّبها، إضافة تسجيل دخول بخطوتين). ولا يوجد لأي منها زر إصلاح — كل اقتراح يطلب منك أن تسأل ChanTan في المحادثة، وهذا هو الطريق الصحيح.

كم يكلّفك هذا

مشمول مجانًا مع كل مشروع: 0.5 غيغابايت من تخزين قاعدة البيانات، و1 غيغابايت للملفات، و50,000 مستخدم نشط شهريًا — إضافةً إلى مخصّص الخطة المجانية: 10,000 صف و1,000 مستخدم و500 ميغابايت.

وفوق المخصّص المجاني، يفصح المنتج عن الأسعار — 31.25 رصيدًا لكل غيغابايت من تخزين قاعدة البيانات شهريًا، و5.25 رصيد لكل غيغابايت من تخزين الملفات شهريًا، و0.8125 رصيد لكل مستخدم نشط شهريًا. والمحاسبة على هذا الاستخدام المقنَّن مُعطَّلة حاليًا، أي أن هذه المبالغ تُعرض ولا تُخصم اليوم. لكن لا تفترض أنها ستبقى مجانية إلى الأبد.

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

مستويات السرعة ("أداء قاعدة البيانات")

كل مستوى مدفوع يحتاج موافقة سريعة من المسؤول، حتى لو لم تُصرّح بذلك سوى بطاقة "مخصَّص". وبعد إرسال الطلب سترى "تم إرسال الطلب. سيراجع المسؤول ترقيتك قريبًا — وسيتم التبديل تلقائيًا فور الموافقة." والتبديل نفسه يستغرق نحو دقيقة، وتبقى بياناتك آمنة طوال الوقت.

حدود نقولها لك بصراحة

• "التراجع" يستعيد ملفاتك وكودك، لا بياناتك أبدًا. السجلات المحذوفة تذهب بلا رجعة. ولهذا بالضبط يتوقف الذكاء الاصطناعي ويطلب تأكيدك في المحادثة قبل تنفيذ أي شيء يحذف بيانات نهائيًا — خذ ذلك السؤال على محمل الجد.
• لا يوجد زر استعادة ذاتية لبيانات قاعدة البيانات. إن احتجت استعادة بيانات، تواصل مع الدعم.
• تصدير كل بيانات تطبيقك ليس ميزة بزر واحد. "تصدير CSV" ينزّل ما هو ظاهر على الشاشة؛ ولما هو أكبر، اطلب من الذكاء الاصطناعي في المحادثة أن يبني ميزة تصدير داخل تطبيقك نفسه.
• "إعدادات تسجيل الدخول" مكتوبة بلغة المبرمجين ومن السهل كسرها. اتركها وشأنها ما لم يطلب منك الذكاء الاصطناعي تحديدًا تغيير شيء فيها — واسأل في المحادثة بدلًا من ذلك. ولا يمكن تغيير سوى قائمة محددة من الإعدادات من داخل ChanTan؛ وما عداها يُرفض برسالة "One or more auth settings are not allowed." (واحد أو أكثر من إعدادات المصادقة غير مسموح به).

إذا بدا شيء غريبًا