AI CodeOps

بوابة الجودة (Quality gate)

آخر تحديث

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

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

التعريف

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

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

الأهمية

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

في AI CodeOps

كل جلسة ذكاء اصطناعي تنتهي بفروقات. وقبل أن تصبح طلب سحب، يفحص AI CodeOps بالترتيب:

  1. سياسة مساحة العمل: القرار deny يوقفها، والقرار ask يحتاج إلى مراجعة موافق عليها.
  2. الموافقة: الموافقة التي في حالة الانتظار أو المرفوضة توقفها.
  3. بوابة الجودة نفسها: لم تفشل الاختبارات على الإصدار الحالي، واكتملت مراجعة الملاحظات بالذكاء الاصطناعي، ولا توجد ملاحظة بخطورة high (عالية) أو critical (حرجة) ما زالت بحالة open أو acknowledged أو in progress.

وتعرض لوحة Quality gates في صفحة التشغيل Release-ready (جاهز للإصدار) أو Not release-ready (غير جاهز للإصدار)، مع الأسباب. وتعمل البوابة نفسها مرة أخرى قبل أن تدمج لوحة التحكم طلب سحب فتحته جلسة.

ويستطيع CI لديك أن يطرح السؤال نفسه عن أي طلب سحب أو إيداع، كما يلي:

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

وهذه إجابة بالرفض، مختصرة:

{
  "allowed": false,
  "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"],
  "testFailures": [],
  "coverageShortfall": null
}

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

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

هل بوابة الجودة هي نفسها فحص CI؟

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

ماذا يحدث في AI CodeOps إذا أخطأت البوابة نفسها؟

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

هل يستطيع خط CI لدي أن يطلب حكما من بوابة AI CodeOps؟

نعم. الطلب POST /api/release/check بمفتاح API لمساحة العمل وعنوان طلب سحب أو تجزئة إيداع SHA يعيد allowed بقيمة true أو false مع الأسباب.