وصل ملف مضغوط يحمل اسم المشروع، وفتحته فوجدت مجلدات كثيرة. هل هذه النسخة التي طلبتها؟ وهل تضم المواد التي سيحتاجها فريق الصيانة؟ تسليم الكود يحتاج وصفًا للمحتوى والمرجع، لأن اسم الملف وحجمه وعدد المجلدات لا تجيب عن هذه الأسئلة.
حدد مادة التسليم قبل إرسالها
اطلب من شركة البرمجة تسمية ما ستسلمه: لقطة مصدر لنسخة محددة، أم نسخة مستودع تشمل التاريخ المتفق عليه، أم حزمة إضافية للتوثيق والمواد المساندة. يمكن أن تحتاج أكثر من مادة، لكن يجب أن تعرف أين توجد كل واحدة وما الذي استُبعد منها ولماذا.
في مثال افتراضي لمنصة تجهيز معارض، اتفق صاحب المشروع على استلام مصدر النسخة التي راجعها فريقه. وصل أرشيف يفتح بسهولة، لكن بعض الملفات الكبيرة كانت مؤشرات نصية، ولم يتضمن تاريخ التعديلات. المثال لتوضيح سؤال التسليم؛ ليس وصفًا لمشروع عميل أو تنزيلًا لمستودع حقيقي.
لقطة المصدر وتاريخ المستودع مادتان مختلفتان
توضح وثائق GitHub أن أرشيف المصدر الذي تولده المنصة لقطة لفرع أو وسم أو commit، ولا يشمل تاريخ المستودع كله. لذلك اسأل عن صيغة المادة المطلوبة بدل الاكتفاء بعبارة «الكود على GitHub». هذا وصف لسلوك أرشيفات المنصة، وليس حكمًا على كل ملف ZIP يعده منفذ يدويًا.
إذا كان التاريخ جزءًا من الاتفاق، فحدد ما المقصود به وما حدود تسليمه ومن يراجع استلامه. وقد يكون بعض تفسير قرارات التطوير في توثيق منفصل، لا داخل سجل التغييرات. لا تفترض أن وجود تاريخ تقني سيشرح وحده سبب كل قرار أو يستعيد نقاشات لم تُحفظ أصلًا.
بطاقة جرد للحزمة
املأ البطاقة مع ممثل الشركة والمراجع التقني. الغرض أن تقابل كل مادة بمكان ودليل، لا أن تجمع قائمة ملفات طويلة يصعب تفسيرها. إذا لم يستخدم المشروع ملفات كبيرة أو مكونًا معينًا، فاكتب ذلك بدل إضافة متطلب لا يحتاجه.
| المادة | ما تسأل عنه | دليل الاستلام |
|---|---|---|
| لقطة المصدر | أي نسخة وماذا يشمل النطاق؟ | مرجع نسخة ومحتوى يمكن مطابقته |
| تاريخ المستودع | هل يدخل في الاتفاق وبأي صيغة؟ | مادة مستقلة وحدود معلومة |
| الملفات الكبيرة | ملفات فعلية أم مؤشرات إليها؟ | توافر المادة التي يحتاجها المشروع |
| التوثيق والمواد المنفصلة | أين توجد وما نسختها؟ | مرجع استلام أو استثناء ومسؤول |
أضف حالة كل سطر: مستلم ومراجع، مستلم ولم يراجع، أو ناقص. الملف الذي وصل ولم يُفتح ليس مادة مفقودة، لكنه ليس تحققًا مكتملًا أيضًا. يوضح هذا الفصل ما ينتظر مراجعة وما يحتاج إعادة تسليم، دون إخفاء الفرق داخل علامة قبول عامة.
ما الذي يوجد خلف مؤشر الملف؟
بحسب وثيقة Git LFS في GitHub، تتضمن الأرشيفات مؤشرات افتراضيًا، ويمكن إعداد تضمين الكائنات المتتبعة بشروط؛ ولا تدخل ملفات خادم LFS خارجي بالطريقة نفسها. اطلب تحديد وضع مشروعك، دون افتراض أنه يستخدم LFS أصلًا أو أن خيارًا واحدًا يجلب كل أصل خارجي.
في منصة المعارض، يسجل المراجع أن مادة معينة لازمة للصيانة لم تصل بصيغتها المطلوبة، ويحدد صاحب استكمالها. لا يكفي أن يبدو اسم الملف صحيحًا. وفي المقابل، لا ينبغي طلب تضمين مواد لا يحق تسليمها أو أسرار تشغيل داخل الأرشيف؛ تُحسم الحقوق ومسارات الوصول في اتفاقها المناسب.
اربط الحزمة بالنسخة التي راجعتها
دوّن مرجع النسخة عند الاستلام، لا اسم فرع متحرك وحده. تفرق وثائق GitHub بين ثبات محتوى commit ضمن شروطها وإمكان تغير الفرع أو الوسم، كما قد تتغير بايتات الضغط دون تغير الملفات المستخرجة. لذا فاختلاف بصمة الأرشيف لا يشرح وحده اختلاف المصدر.
اتفق على طريقة المطابقة التي يستخدمها المختص وعلى تسجيل نتيجتها. المطابقة لا تعني تلقائيًا نجاح البناء أو التشغيل أو سلامة التطبيق؛ هذه فحوص أخرى لها نطاقها. وإذا تغير المرجع بعد المراجعة، فاحتفظ بسبب التغيير وما يلزم مراجعته مجددًا بدل استبدال المادة دون توضيح.
راجع أسئلة حقوق الكود والبيانات للاتفاق الأوسع، وأدلة البناء والنشر للتحقق التشغيلي المنفصل. وعند مناقشة تطوير برنامج مخصص مع نكست ويف، أرفق بطاقة الحزمة ونسختها والاستثناءات حتى يصبح التسليم قابلًا للمراجعة.
المراجع وحدودها
قُرئت وثيقتا GitHub عن أرشيفات المصدر وملفات LFS داخلها في 4 نوفمبر 2026. لا تنزيل أو نقل أو بناء فعليًا. إعداد بمساعدة الذكاء الاصطناعي مع مراجعة المعلومات والترجمة.
