الدروسكيف تحفظ إرساليات النماذج في قاعدة بيانات

درس مصغّر 10 من 30 · جعل موقعك مفيدًا

حدّد ما المقصود بالحفظ

لمن هذا الدرس؟

لمن يريدون حفظ إرسالات الموقع. يستطيع مساعد برمجة تطبيق الإعداد المرفق وربط النموذج؛ لا تحتاج إلى كتابة SQL أو كود خادم.

يجب أن يوجد السجل خارج صفحة المتصفح الحالية.

هدف هذا الدرس

  • أرسل سجلًا من النموذج إلى تخزين فعلي.
  • تحقق من بقاء البيانات في عرض الجدول لدى المزود.
  • ارفض المدخلات غير الصالحة دون كشف سجلات الجميع.
شرح ومثال محلول وتدريب

قبل أن تبدأ

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

تحقّق من مهارات البداية

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

  1. كيف تنشر موقعك من GitHub

    اربط مستودعًا تجريبيًا بالاستضافة.

الوقت المتوقع: 20–37 دقيقة

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

افهم الفكرة

افتح النموذج الجاهز مع مساعدك واختر رسالة وهمية مميزة. سنحفظها عبر الخادم المرفق في قاعدة بيانات تدريب منفصلة.

بقاء قيمة معروضة في الصفحة لا يثبت تخزينها في قاعدة البيانات. خطّط للعثور على الرسالة نفسها لدى المزود وبعد إعادة الفتح.

مثال عملي

جدول المزود والصفحة المفتوحة في المتصفح مكانان مختلفان. بقاء الرسالة في الجدول بعد إغلاق التطبيق يثبت أكثر من مجرد جملة ظاهرة بجوار زر الإرسال.

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

ملفات هذه الخطوة

ابدأ هناملفات ورشة العمل

افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.

جرّب بنفسك

أين ستبحث لتتحقق من حفظ رسالتك فعلًا؟

عرض حل نموذجي مشروح

مثال إجابة: سأرسل النص الافتراضي “D1 — blue notebook”، وأجد الرسالة نفسها في عرض جدول feedback الخاص بالمالك، ثم أغلق التطبيق وأعيد فتحه وأتحقق من بقائها هناك. العبارة على النموذج مجرد أول استجابة مرئية.

ما تتضمنه الإجابة السليمة

  • يحدد السجل المطابق المحفوظ لدى مزود قاعدة البيانات بوصفه دليل الحفظ.
  • يتضمن إعادة فتح أو تحميل، بدل الاعتماد على علامة نجاح مؤقتة.
كيف يعمل؟ (اختياري)

خزّن سجلًا خارج المتصفح

ينبغي أن يبقى صف قاعدة بيانات محفوظ موجودًا بعد إغلاق الصفحة.

يختفي متغير JavaScript عند إغلاق صفحته. يبقى التخزين المحلي للمتصفح في ذلك المتصفح. تخزن قاعدة البيانات سجلات في خدمة يستطيع تطبيقك الوصول إليها بأذونات صريحة.

سنستخدم جدول Supabase خاصًا ودالة خادم. يرسل المتصفح رسالة صغيرة؛ ويتحقق منها الخادم ويكتب الصف. لا يكشف هذا الدرس نقطة نهاية عامة تسرد رسائل الجميع.

مثال محلول

بعد إرسال «Database test D1»، أغلق الصفحة واعثر على الرسالة نفسها في محرر جداول مشروعك. الرسالة المعروضة في الصفحة وحدها ليست دليل تخزين.

Supabase: قاعدة البيانات

تمرين تقني إضافي

تعرض صفحتك الرسالة المرسلة من متغير محلي. هل يثبت ذلك حفظ قاعدة البيانات لها؟

عرض حل نموذجي مشروح

لا. تحقق من الصف الفعلي في قاعدة البيانات. قد يعرض المتصفح المدخل حتى إن لم يحدث طلب خادم.

  • تفصل الحالة المعروضة عن التخزين.
  • تفحص الصف المطابق عبر عرض قاعدة بيانات مصرح به.

الخطوة 1 · كيف تحفظ إرساليات النماذج في قاعدة بيانات

جهّز مشروع التخزين المعزول

دع المساعد يطبق الإعداد المرفق بأمان.

شرح ومثال محلول وتدريب

افهم الفكرة

أنشئ مشروع Supabase التجريبي القابل للحذف أو اختره. اطلب من المساعد مراجعة schema.sql والمساعدة في تطبيقه هناك، وضبط القيم الخاصة، وتشغيل المشروع الكامل باتباع run-locally.txt.

تأكد من المشروع الصحيح قبل تطبيق التعديلات. أبقِ الزوار العامين غير قادرين على تصفح كل الملاحظات، واستخدم Table Editor بحساب المالك لفحص صف الاختبار.

مثال عملي

يحتوي جدول feedback المرفق على رسالة ومعرّف مولّد ووقت إنشاء. يستطيع مالك المشروع فحصه لدى المزود؛ ولا يحتاج الزوار إلى صلاحية قراءة ملاحظات الجميع كي ينجح هذا الاختبار.

ملفات هذه الخطوة

ابدأ هناملفات ورشة العمل

افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.

جرّب بنفسك

أي مشروع تجريبي جهّزت؟ وهل تستطيع تحديد عرض الجدول الخاص بمالكه؟

عرض حل نموذجي مشروح

مثال سجل إعداد: طبّق المساعد schema.sql في مشروعي التدريبي المؤقت وحده، وأعد قيم الخادم الخاصة، ثم شغّل التطبيق المرفق. أستطيع فحص feedback بصفتي مالك المشروع في Table Editor. وما زال الزوار غير قادرين على تصفح الجدول.

ما تتضمنه الإجابة السليمة

  • يحدد المشروع المؤقت وحالة إكمال أو تعذر إعداد المخطط والخادم المرفقين.
  • يصل إلى feedback في Table Editor الخاص بالمالك دون منح الزوار صلاحية القراءة.
كيف يعمل؟ (اختياري)

أنشئ جدول تدريب خاصًا

فعّل الأمان على مستوى الصفوف وأبقِ وصول المتصفح المباشر مغلقًا في هذا المسار المشروح.

شغّل هذا المخطط فقط في مشروع Supabase التدريبي المعزول المسمى في إعدادك. وصول المتصفح مقيّد عمدًا؛ تحقق من الصف كمالك المشروع في Dashboard → Table Editor. لا تشغّل مخطط المختبر على قاعدة إنتاج.

أنشئ مشروع Supabase منفصلًا للتدريب وشغّل schema.sql في محرر SQL الخاص به. للجدول معرّف مولّد ورسالة مقيّدة وطابع زمني من الخادم. لا تنفذ تغييرات مخطط تجريبية على قاعدة إنتاج غير مرتبطة.

يفعّل السكربت الأمان على مستوى الصفوف ويزيل صلاحيات الجدول من أدوار المتصفح. يستطيع مفتاح الخادم السري أو service-role إجراء الكتابة ذات الامتيازات؛ ويجب أن يبقى في الخادم. المفتاح القابل للنشر في المتصفح مختلف ولا يمنح أذونات الإدارة هذه.

افتح Table Editor في لوحة مشروع Supabase لفحص صف التدريب؛ هذه ليست وحدة مطوّر المتصفح. لإدراج فاشل، افحص استجابة الخادم وإعداد قاعدة البيانات والمخطط في المشروع. لا تفعّل SELECT مجهولًا لمجرد معرفة ما إذا نجح الإدراج.

للتسلسل المحلي الكامل، افتح run-locally.txt: جهز بيئة الجذر الخاصة، واربط مشروع التدريب فقط، وابدأ وكيل دوال Netlify. يسرد server-env.example.txt أسماء المتغيرات دون أسرار حقيقية. فتح HTML وحده لا يشغّل الخادم.

مثال محلول

لا تلزم سياسة واسعة «تسمح بالكل» لهذا المختبر الذي يتوسط فيه الخادم. فتح SELECT مجهول لتشخيص خطأ يكشف أيضًا الرسائل المرسلة.

create table public.feedback (
 id uuid primary key default gen_random_uuid(),
 message text not null check (char_length(message) between 1 and 1000),
 created_at timestamptz not null default now()
);
alter table public.feedback enable row level security;
revoke all on public.feedback from anon, authenticated;
grant insert on public.feedback to service_role;
-- No browser read/write policies: the practice server uses its secret key.

Supabase: الأمان على مستوى الصفوف · Node.js: حالة دعم الإصدارات

تمرين تقني إضافي

يُرفض استعلام متصفح. هل ينبغي إصلاحه بالسماح للمجهولين بقراءة جدول الملاحظات كله؟

عرض حل نموذجي مشروح

لا. يرفض هذا التصميم قراءة المتصفح عمدًا. افحص إعداد كتابة الخادم وافحص الجدول بوصفك مالكه.

  • تحافظ على الحد المقصود للبيانات الخاصة.
  • تستخدم مسار الخادم أو لوحة مصرحًا بها بدل فتح القراءة للجميع.

الخطوة 2 · كيف تحفظ إرساليات النماذج في قاعدة بيانات

أرسل سجلًا من الصفحة

دع الخادم الجاهز يتولى الكتابة.

شرح ومثال محلول وتدريب

افهم الفكرة

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

اعثر على نص D1 نفسه في جدول المزود وافحص معرّفه ووقته المنشأين تلقائيًا. أبقِ قيم الحساب السرية خارج لقطات الشاشة والملاحظات المشتركة.

مثال عملي

أرسل D1، ثم ابحث عن النص نفسه في feedback. يميز المعرّف المولّد هذا الصف عن رسالة قديمة مشابهة؛ ولا ينبغي للزائر اختيار هذه الهوية أو استبدالها.

ملفات هذه الخطوة

ابدأ هناملفات ورشة العمل

افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.

جرّب بنفسك

ماذا ظهر في النموذج ولدى المزود بخصوص D1؟

عرض حل نموذجي مشروح

مثال سجل حفظ: أبلغ النموذج عن حفظ الرسالة. وجدت “D1 — blue notebook” في جدول feedback لدى مزود التدريب، مع معرّف مولّد ووقت إنشاء. احتفظت بالمعرّف في ملاحظاتي الخاصة لأميز الصف نفسه لاحقًا.

ما تتضمنه الإجابة السليمة

  • يطابق نص D1 المرسل مع صف لدى المزود له معرّف ووقت مولّدان.
  • يسجل نتائج الصفحة والحفظ بصورة منفصلة، دون مشاركة الإعدادات الخاصة.
كيف يعمل؟ (اختياري)

اربط كتابة خادم متحققًا منها

يختار الخادم الجدول والحقول المسموحة؛ ولا يقدم مقدم الطلب إلا الرسالة.

اضبط متغيرات الخادم الثلاثة المسماة وانشر أو شغّل مشروع الدالة المنفصل. يُدخل المختبِر رمز وصول التدريب. يفوّض ذلك نقطة النهاية المقيدة هذه، لا حساب Supabase.

اقرأ mini-feedback.mjs: تفحص الدالة الطريقة ورمز الوصول والحجم والرسالة قبل استدعاء المزوّد. تتجاهل معرّفات أو أسماء جداول يقدمها مقدم الطلب، ولا تعيد نجاح التخزين إلا بعد استجابة إدراج ناجحة.

مثال محلول

لا يتحول طلب يتضمن حقل admin إضافيًا إلى تحديث إداري: يبني الخادم كائنًا جديدًا يحتوي على message فقط.

تمرين تقني إضافي

لماذا نبني {message} بدل تمرير كائن JSON المتصفح كاملًا إلى قاعدة البيانات؟

عرض حل نموذجي مشروح

يبقي مخطط الخادم المقبول صريحًا ويمنع الحقول غير المتوقعة من التحول إلى كتابات. تحقق من الرسالة أيضًا؛ اختيار الحقول وحده غير كافٍ.

  • تحد الحقول القابلة للكتابة.
  • لا تثق بمعرّفات أو طوابع زمنية أو امتيازات يتحكم بها العميل.

الخطوة 3 · كيف تحفظ إرساليات النماذج في قاعدة بيانات

افحص بقاء البيانات وحالات الفشل

كرّر الإجراء بعد إغلاق الصفحة الأولى.

شرح ومثال محلول وتدريب

افهم الفكرة

أغلق التطبيق وأعد فتحه، ثم تحقق من بقاء D1 في التخزين. جرّب مدخلات ناقصة أو أكبر من الحد، ورمز تدريب خاطئًا في الإعداد التجريبي القابل للحذف.

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

مثال عملي

سجل الصف الصالح قبل الاختبارات السلبية، ثم افحص الجدول بعدها. «أظهر النموذج خطأ» و«لم يُضف صف غير صالح» جانبان مفيدان للتحقق.

ملفات هذه الخطوة

ابدأ هناملفات ورشة العمل

افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.

جرّب بنفسك

ما السجلات التي بقيت بعد إعادة الفتح؟ وماذا حدث لمحاولاتك غير الصالحة؟

عرض حل نموذجي مشروح

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

ما تتضمنه الإجابة السليمة

  • يتحقق من بقاء السجل المحدد بعد إعادة الفتح.
  • يتحقق من أن المدخلات غير الصالحة ومحاولات الوصول المرفوضة لا تضيف صفوفًا ولا تبقي حالة نجاح مضللة.
كيف يعمل؟ (اختياري)

تحقق من الديمومة والفشل

استخدم سجلات مميزة وافحص قاعدة البيانات مستقلة عن الصفحة.

أرسل D1 برمز التدريب الصحيح وافحص صفه المطابق في محرر الجدول. أغلق الصفحة وأعد فتحها، ثم أكد بقاء الصف. سجّل معرّفه وطابعه الزمني دون مشاركة أسرار الحساب.

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

مثال محلول

سجل صحيح مع طلبين غير صحيحين مرفوضين يعطي معلومات أكثر من ثلاث نقرات نجاح متكررة. تجنب استخدام ملاحظات شخصية حقيقية في المختبر الأول.

تمرين تقني إضافي

تعيد نقطة النهاية خطأ لكن المتصفح لا يزال يقول «Saved» من محاولة سابقة. ما الذي ينبغي التحقق منه؟

عرض حل نموذجي مشروح

تحقق مما إذا كان للقيمة الجديدة صف. ينبغي أن تعرض الواجهة الفشل الحالي، وألا يُحسب نجاح سابق نتيجة لهذه المحاولة.

  • تفحص الاستجابة الحالية وقيمة اختبار جديدة مميزة.
  • لا تعيد استخدام رسالة نجاح قديمة دليلًا على طلب فاشل.

الخطوة 4 · كيف تحفظ إرساليات النماذج في قاعدة بيانات

أضف موضوعًا دون كشف البيانات

استعن بالمساعد لتعديل الحقل وافحص النتيجة.

شرح ومثال محلول وتدريب

افهم الفكرة

اطلب من المساعد إضافة موضوعين، Project وQuestion، إلى النموذج وإعداد التخزين والتحقق في الخادم. القيم المحفوظة هي project وquestion. المرجع المرفق للمقارنة بعد محاولتك، وليس المكان الذي يجب أن تكتشف منه المتطلب.

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

مثال عملي

أضف الموضوعين المسموحين Project وQuestion. ينبغي حفظ كل قيمة مختارة بجوار رسالتها. Other لاختبار الرفض؛ لذا فوجود قائمة اختيار جميلة وحده لا يكمل تعديل التخزين.

ملفات هذه الخطوة

ابدأ هناملفات ورشة العمل

افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.

جرّب بنفسك

قدّم تعديل الموضوع والنتائج التي لاحظتها للتخزين الصحيح والمحاولات غير الصالحة.

ما المطلوب إنجازه: سجل تخزين بعد إزالة المعلومات الحساسة، يوضح بقاء البيانات الصالحة ورفض المحاولات غير الصالحة.

عرض حل نموذجي مشروح

مثال سجل الإضافة: حُفظت “D2 — project test” مع الموضوع project، و“D3 — question test” مع الموضوع question. رُفضت القيمة other دون إنشاء صف جديد. فحصت السجلات بصفتي المالك؛ وظلت قراءة الجدول الكامل محظورة على الزوار.

ما تتضمنه الإجابة السليمة

  • يحفظ قيمتي الموضوع Project وQuestion مع سجليهما التجريبيين المطابقين.
  • يرفض الموضوع غير المدعوم ويمنع الزوار من تصفح جدول الملاحظات.
كيف يعمل؟ (اختياري)

مهمتك: خزّن موضوعًا متحققًا منه

وسّع نموذج البيانات والخادم معًا دون فتح أذونات المتصفح.

أضف عمود topic مقيّدًا بالقيمتين project أو question. حدّث الخادم ليفحص قائمة السماح ويبني الكائن المدرج صراحة. أضف عنصر النموذج المقابل.

أنشئ سجلًا لكل موضوع مسموح وارفض قيمة غير مدعومة. أبقِ المعرّفات والطوابع الزمنية المولّدة تحت سيطرة قاعدة البيانات.

تُسنِد DEFAULT القيمة question إلى الصفوف الموجودة في هذا التدريب. دون قيمة أو افتراضي، قد تفشل إضافة عمود NOT NULL عندما توجد صفوف مسبقًا. في ترحيل حقيقي، اختر قيمة ملء الصفوف السابقة وفق البيانات بدل نسخ هذا الافتراضي التدريبي.

مثال محلول

يدعم قيد قاعدة البيانات تحقق الخادم. ولا يستبدل أي منهما دور الآخر في وضوح الأخطاء وسلامة البيانات.

يتوفر الشرح المرجعي الكامل في reference/assignment-walkthrough.txt. قارن خطواته بنتيجتك؛ واملأ سجل الاختبار بملاحظات من مشروعك أنت.

-- Existing rows need a value when the new column is NOT NULL.
alter table public.feedback add column topic text not null default 'question';
alter table public.feedback add constraint feedback_topic_allowed
 check (topic in ('project','question'));

تمرين تقني إضافي

أضف حقل الموضوع وأثبت بقاء البيانات الصحيحة ورفض البيانات غير الصحيحة.

عرض حل نموذجي مشروح

تتطلب توسعة الموضوع اتفاق الطبقات الثلاث: قائمة اختيار في المتصفح وقائمة سماح في الخادم وعمود وقيد تحقق في قاعدة البيانات. تعالج ALTER TABLE المرجعية صفوف البداية القائمة بإسناد الموضوع الافتراضي الموثق قبل فرض القيد.

يكتب الخادم {message,topic} فقط. يجب أن يرفض موضوعًا غير مدعوم قبل استخدام بيانات اعتماد قاعدة البيانات السرية. ويجب أن يتجاهل معرّفات وأسماء جداول يقدمها مقدم الطلب ويبلغ عن فشل كتابة المزوّد بوصفه فشلًا.

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

  • يوجد تحقق الموضوع في الخادم وقاعدة البيانات.
  • تبقى الصفوف الصحيحة المطابقة، ولا تنشئ القيم غير المدعومة صفوفًا.

هل أفادك هذا الدرس؟

اترك إعجابًا، أو شاركه مع شخص قد يستفيد منه.