قائمة تسليم مشروع التخرج: اختبر التشغيل من جهاز جديد

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

حدد النسخة التي ستسلّمها

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

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

git status --short
git log -1 --format="%h %s"
git ls-files

جرّب تشغيل نسخة جديدة من البداية

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

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

مصفوفة محتويات التسليم

افحص الأسرار وبيانات التجربة

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

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

اختبر ما يراه المشرف وما قد يتعطل

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

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

سجل النتيجة ولا تخلطها بالخطة

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

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