ما ستتعلمه

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

حدد المشروع وحدوده بوضوح

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

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

ارسم البنية قبل تنفيذ الواجهة

يحمل المتصفح واجهتك وSDK الموثق، ثم يتصل بخدمة Gammal Tech API المستضافة. لا تثبت المنصة على سيرفر الموقع. توضح وثائق API الدوال الخاصة بتسجيل الدخول وفحص الجلسة وبيانات المستخدم.

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

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

اكتب شكلًا محددًا للسجل

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

{
  "schemaVersion": 1,
  "progress": {
    "http": false,
    "sessions": false,
    "safeOutput": false
  },
  "notes": {
    "http": "",
    "sessions": "",
    "safeOutput": ""
  }
}

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

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

نفذ المشروع في أربع مراحل قابلة للمراجعة

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

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

اختبر حالات تكشف الأخطاء المحتملة

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

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

جهز العرض واشرح قيمة المشروع للعميل

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

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

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

قيم العمل واختر المهارة التالية

تقييم أصلي للمشروع من 100 درجة
الجانبالدرجةالدليل
النطاق وبنية النظام20وظائف ومسؤوليات محددة
الجلسات والبيانات25ملاحظات قبول مكتملة
العرض والتحقق20حالات نص وسجل غير صالح
الفشل وسهولة الاستخدام20حالة صادقة ومراجعة لوحة المفاتيح
شرح قابل لإعادة التطبيق15خطوات إعداد وحدود مفهومة

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

أسئلة شائعة

هل يمكنني عرض تقدم الجميع في لوحة للمدير؟

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

هل تصلح مربعات التقدم لإصدار شهادة معتمدة؟

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

مراجع الدرس

تمت مراجعة التوثيق في 12 أكتوبر 2026. راجع التوثيق الحالي قبل تنفيذ مشروع عميل أو تحديد أسعاره.

ابدأ تمرينك على Gammal Tech

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

العودة إلى المقالات والأدلة