بوابة بوابة جودة بوابة الجودة هي اختبار يجب أن تجتازه الأعمال قبل أن تتقدم. البوابات هي ما يحول معيار «الجاهزية للإرسال» من قرار ذاتي إلى قاعدة يفرضها النظام بنفس الطريقة في كل مرة.
حجبية وإرشادية
كل بوابة إما حجبية أو إرشادية، وهذا التمييز هو جوهر التصميم:
- حجبية — فالفشل في الاختبار يوقف المهمة. لا تتقدم الأعمال حتى تجتاز الاختبار أو يتدخل إنسان لإلغاء الحظر.
- إرشادية — يتم تسجيل الفشل كملاحظة وربطه بطلب السحب، لكن المهمة تستمر.
ابدأ باستخدام البوابات الإرشادية. راقب ما الذي تكتشفه البوابات في الأعمال الفعلية لمدة أسبوع أو اثنين، ثم حوّل تلك التي تستحق ذلك إلى بوابات حجبية. أي بوابة تُعيق العمل من اليوم الأول دون تعديل مسبق، غالبًا ما تدفع الفرق لتجاوزها.
بوابة حاجزة
- تغطية أقل من 80٪فاشل
تتوقف المهمة
تعاد كعمل إعادة صياغة بدلاً من فتح طلب سحب لـ pull request كنت سترفضه حتمًا.
- يمكن لشخص ذي صلاحية تجاوز ذلك؛ يُسجل التجاوز من قام به ومتى وعلى ماذا.
بوابة استشارية
- تغطية أقل من 80٪فاشل
يتم تسجيل النتيجة
تستمر المهمة حتى المراجعة.
- تُرفق النتيجة بطلب السحب لـ pull request لتقيّمها أنت.
ما الذي يمكن للبوابات فحصه
تقع البوابات فوق مرحلة التحقق ويمكن أن تشمل:
- نجاح مجموعة اختباراتك الخاصة
- حدود تغطية الكود
- تدقيق الكود والتحليل الثابت
- فحص الأمان، المُعدّ في أمان
- اختبارات المتصفح على نسخة معاينة قيد التشغيل
- أدلة من مزودين خارجيين مرفقة بـ pull request
أثمن بوابة تقريبًا هي مجموعة الاختبارات الحالية لديك، لأنها تضم بالفعل ما قرر فريقك أنّه مهم.
أين يمكن للبوابة أن توقف العمل
تعمل البوابات أثناء التحقق، بعد انتهاء وكيل المطوّر وقبل المراجعة. ويعيد الإخفاق الحاجب المهمة إلى مرحلة إعادة العمل بدلًا من إنشاء pull request سترفضه حتمًا.
هذا الترتيب مقصود: فالفشل داخل عملية التنفيذ أقل تكلفة من الفشل عند عرضه على شاشتك.
سياسات
تُجمَّع البوابات ضمن سياسات، وهي ما تربطه فعليًا بالمشاريع. السياسة هي مجموعة مسماة من البوابات مع إعداداتها الحجبية/الإرشادية، حتى تتمكن من تطبيق معيار واحد لخدمات الإنتاج ومعيار أخف للأدوات الداخلية.
السياسات ذات إصدارات؛ عند نشر تغيير، يمكنك العودة إلى الإصدار السابق إذا تبين أن البوابة الجديدة صارمة للغاية.
تجاوزات
يمكن لتجاوز البوابة الحجبية أن يتم بواسطة شخص لديه الصلاحية لذلك. يتم تسجيل التجاوز — من، متى، وعلى ماذا.
هذا التسجيل هو الغاية؛ فالبوابة التي لا يمكن تجاوزها تصبح شيئًا يتجاوزه الناس، والبوابة التي يمكن تجاوزها دون أثر ليست بوابة حقيقية. التجاوز الذي يترك أثرًا يكون قابلاً للاستخدام والمساءلة في آن واحد.
ما لا تفعله البوابات
تفحص البوابات الخصائص، ولا تحكم على ما إذا كانت الأعمال تحل المشكلة الصحيحة — هذا ما تحدده معايير القبول في المواصفات وهو الغرض من مراجعتك.
قد تجتاز كل البوابات وتظل التغييرات خاطئة.