دليل مصطلحات بناء التطبيقات للمؤسس غير التقني

ابدأ برحلة واحدة بدل قائمة تقنيات

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

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

الواجهة والخادم والبيانات ليست شيئًا واحدًا

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

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

قاموس عملي مرتبط بطلب صيانة

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

فرّق بين إثبات الهوية والسماح بالفعل

المصادقة تسأل: من المستخدم؟ والتفويض يسأل: ماذا يُسمح لهذا المستخدم أن يفعل؟ نجاح تسجيل الدخول لا يعني السماح بقراءة كل طلب. تؤكد إرشادات OWASP للتفويض ضرورة فحص الإذن لكل طلب؛ إخفاء زر في الواجهة ليس بديلًا عن هذا الفحص.

صياغة قابلة للفحص: «العميل يرى طلباته فقط، والفني يرى الطلبات المسندة إليه، والمسؤول يغيّر الإسناد». تجنّب عبارة «أمان كامل»؛ اكتب الأفعال المسموحة والممنوعة، واطلب اختبار محاولة الوصول إلى طلب شخص آخر.

المعاينة ليست إذنًا بتشغيل المشروع

نستخدم «المعاينة» لنسخة تفحصها قبل الإطلاق، و«النشر» لإتاحة نسخة في بيئة التشغيل المقصودة. قد تنجح شاشة تجريبية مع بيانات مؤقتة، بينما لم تُختبر إعادة التحميل أو الحسابات المنفصلة. لذلك افصل سؤال «هل تظهر الصفحة؟» عن «هل تحفظ العمل وتطبّق قواعده؟».

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

حوّل الكلمات إلى وصف قابل للتنفيذ

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

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

الوصف القابل للنسخ

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

قائمة الفحص

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

أسئلة شائعة

المصادر

• MDN — API — تعريف الواجهة البرمجية، لا إثبات تكامل في إطلاق (تاريخ التحقق: 2026-09-20)
• MDN — Browsing the web — مفاهيم التصفح والخوادم والعناوين (تاريخ التحقق: 2026-09-20)
• OWASP — Authorization Cheat Sheet — التحقق من الصلاحيات لكل طلب (تاريخ التحقق: 2026-09-20)
• إطلاق — الموقع الرسمي — التعريف العام للمنتج فقط، لا نتيجة بناء مجرّب (تاريخ التحقق: 2026-09-20)