AI CodeOps

ما بوابات الجودة؟

آخر تحديث

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

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

من أين جاءت بوابات الجودة

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

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

واليوم تعني بوابة الجودة عادة مزيجا من ذلك: أدلة مؤتمتة من CI، وملاحظات من أدوات مراجعة الكود، وموافقات بشرية، تقيّم معا عند نقطة محددة في خط التسليم.

ما الذي تفحصه بوابة الجودة

تبنى البوابات من الأدلة. والأنواع الشائعة:

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

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

بوابات الجودة مقابل الفحوص

كثيرا ما تستخدم الكلمتان بتساهل. لكن التمييز يستحق الحفاظ عليه، لأنه يحدد ما الذي يوقف التغيير السيئ فعلا.

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

يصبح الفحص جزءا من بوابة حين يرفض شيء ما المضي بسبب نتيجته.

خصائص بوابة الجودة الجيدة

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

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

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

الأسباب مقروءة. «مرفوض» لا تكفي. ينبغي أن تقول البوابة أي ملاحظة، أو أي اختبار، أو أي قاعدة أوقفت التغيير، ليتمكن الكاتب من التصرف.

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

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

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

بوابات الجودة للكود الذي يكتبه الذكاء الاصطناعي

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

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

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

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

كيف تصمم بوابات الجودة

  1. ارسم الطريق إلى بيئة الإنتاج. اسرد كل طريقة يمكن أن يصل بها تغيير إلى فرعك الرئيسي وبيئة الإنتاج لديك: الدمج من لوحة التحكم، والدمج على خدمة استضافة Git، والدفع المباشر، ونصوص الإصدار. فالبوابة لا تحمي إلا الطرق التي تعبرها.
  2. اختر نقاط البوابات. تحتاج معظم الفرق إلى بوابة واحدة على الأقل قبل الدمج وأخرى قبل بيئة الإنتاج.
  3. اسرد الأدلة لكل نقطة. الاختبارات على الإصدار الحالي، وملاحظات المراجعة، والموافقات، والتراخيص، والنشر السابق. واكتب مصدر كل منها.
  4. ضع عتبات صريحة. مثل: المنع عند الملاحظات بخطورة high و critical، وعند أي اختبار فاشل، وعند غياب المراجعة. واكتب القواعد حيث يستطيع الفريق قراءتها.
  5. قرر حالات غياب الأدلة. ماذا يحدث حين لا توجد اختبارات، أو لا قائمة SBOM، أو لا مراجعة؟ قرر ذلك عن قصد، ولا تعرض أبدا الدليل الغائب على أنه نجاح.
  6. اجعلها تغلق عند الخطأ. الأخطاء في البوابة ترفض التغيير وتذكر ذلك.
  7. أتحها لـ CI. اجعل القرار نفسه متاحا لخط النشر لديك، لكي يمكن إخضاع عمليات الدمج خارج أدواتك له.
  8. حدد الفرز والتجاوزات. من يستطيع صرف ملاحظة، وكيف يسجل ذلك.
  9. راجع البوابة نفسها. انظر فيما منعته وما تسلل منها. وشدد العتبات كلما تحسنت قاعدة الكود.

كيف يفعل AI CodeOps ذلك

في AI CodeOps، يجتاز كل تغيير من الذكاء الاصطناعي بوابة جودة قبل أن يصبح طلب سحب، ومرة أخرى قبل أن تدمجه لوحة التحكم. ويحتجز التغيير إذا لم تكتمل مراجعة الملاحظات بالذكاء الاصطناعي، أو إذا كانت ملاحظة بخطورة high أو critical ما زالت بحالة open أو acknowledged أو in progress، أو إذا فشلت اختبارات المشروع في البيئة المعزولة. ولا تحتسب نتيجة الاختبار إلا للإصدار الذي عملت عليه. ويجب أن يوافق شخص، ومن بدأ الجلسة لا يستطيع الإدلاء بصوت الموافقة ما دام في مساحة العمل موافق آخر. وتستطيع سياسات مساحة العمل رفض طلب السحب أو اشتراط تلك الموافقة للمسارات الحساسة. والبوابات مبنية لتغلق عند الخطأ، مع استثناءات قليلة موثقة.

ويستطيع CI لديك أن يطلب من البوابة نفسها حكما على طلب سحب أو إيداع، بمفتاح API لمساحة العمل، وأن يضيف قواعد أشد في كل استدعاء، كما يلي:

curl -s -X POST "https://<your-console>/api/release/check" \
  -H "Authorization: Bearer $WORKSPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pullRequestURL":"https://github.com/acme/checkout/pull/42","blockingSeverity":"medium","requireDeployedTo":"staging"}'

وهذه إجابة بالرفض، مختصرة إلى الحقول الرئيسية:

{
  "allowed": false,
  "evidenceComplete": true,
  "summary": "HIGH security: Coupon code is passed to the pricing query without validation",
  "reasons": [
    "HIGH security: Coupon code is passed to the pricing query without validation",
    "Not yet deployed to \"staging\" — promote there before releasing"
  ],
  "testFailures": [],
  "coverageShortfall": null,
  "priorEnvironmentMissing": { "required": "staging" },
  "requiredGatesPassed": true,
  "missingRequiredWorkflows": []
}

تعيد نقطة النهاية رمز HTTP 200 في الحالتين، فاقرأ allowed. والتغيير الذي لا جلسات مطابقة له يرفض، وخطأ التقييم يعيد allowed: false. ومن الخيارات الأخرى minCoveragePct و requiredWorkflows و blockOnInFlight و disallowedLicenses، وهذا الأخير يفحص أحدث قائمة SBOM مسجلة للمشروع. ويرفض الفحص أيضا حين تغيب الأدلة: تغيير في الكود لا نتيجة اختبار له فيها أعداد، وحد أدنى للتغطية دون تغطية مبلغ عنها، وقاعدة تراخيص دون قائمة SBOM. والمشروع الذي لا مجموعة اختبارات له يستثني نفسه بالخيار Don't run tests for this project في إعداداته.

راجع بوابات جودة كود الذكاء الاصطناعي لنظرة عامة، وبوابات الجودة للفرز ومواضع ظهور النتائج، ومرجع API لكل حقل.

للتعمق أكثر

الأسئلة الشائعة

ما الفرق بين بوابة الجودة وفحص CI؟

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

هل ينبغي أن تفتح بوابة الجودة عند الخطأ أم تغلق عنده؟

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

هل الموافقة البشرية بوابة جودة؟

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

ماذا لو لم تكن للمشروع اختبارات؟

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

من ينبغي أن يستطيع تجاوز البوابة؟

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