بوابات الجودة
كيف يقرر AI CodeOps هل يجوز إطلاق تغيير: نتائج الاختبار، ومراجعة الملاحظات بالذكاء الاصطناعي، والموافقات، وفحص بوابة الإصدار الذي يستطيع CI لديك استدعاءه.
تنتهي كل جلسة ذكاء اصطناعي بتغيير: فروقات على مستودع مشروعك. وقبل أن يصبح ذلك التغيير طلب سحب، يفحصه AI CodeOps. والفحوص واحدة سواء فتحت طلب السحب من لوحة التحكم أو سألت من CI لديك.
ما تفحصه البوابة
يكون التغيير جاهزا للإصدار (release-ready) حين تتحقق كل هذه الشروط:
- الاختبارات تنجح. بعد كتابة التغيير، تشغل الجلسة أمر الاختبار الخاص بمشروعك في بيئتها المعزولة وتسجل النتيجة. والاختبارات الفاشلة تمنع التغيير.
- توجد نتيجة اختبار. الجلسة التي غيّرت كودا في مشروع تحتاج إلى نتيجة اختبار فيها أعداد. وإذا لم يعمل لها أي اختبار، أو عمل أمر الاختبار دون أن يذكر أعداد اختبارات، يمنع التغيير برسالة: "The test command ran but reported no test counts, so nothing shows a test passed. Check the project's test command". فغياب الدليل ليس نجاحا. وإذا لم تكن للمشروع مجموعة اختبارات، ففعّل Don't run tests for this project في إعداداته من Plan → Projects (المشاريع). وعندها لا تطلب البوابة من ذلك المشروع نتيجة اختبار. والجلسة التي لم تغير كودا لا تطلب منها نتيجة أيضا.
- مراجعة الملاحظات بالذكاء الاصطناعي اكتملت. تقرأ خطوة مراجعة الفروقات وتسجل الملاحظات (في تصنيفات security و quality و performance و reliability و test coverage وغيرها). وإذا تعذر إتمام تلك المراجعة، تكون الملاحظات مجهولة ويحتجز التغيير. وتذكر صفحة الجلسة السبب: لم يجب المراجع في الوقت المحدد، أو تعذرت قراءة إجابته على أنها ملاحظات، أو نفدت الميزانية قبل المراجعة. أعد تشغيل الجلسة (بعد رفع الميزانية، في الحالة الأخيرة).
- لا ملاحظات مانعة مفتوحة. الملاحظات بدرجة الخطورة high أو critical تمنع إلى أن تفرز.
- الاختبارات تحتسب للنسخة التي عملت عليها. إذا عدّل أحد التغيير بعد تشغيل اختباراته، فالنتيجة القديمة لا تجيزه ولا تمنعه: تذكر البوابة أن هذه النسخة غير مختبرة وتفتح الموافقة من جديد، فيقرر شخص قبل إطلاقها. أعد تشغيل الجلسة لاختبار النسخة الجديدة.
الموافقات فحص منفصل على المسار نفسه. راجع الموافقات والسياسات.
أين تراها
افتح صفحة تشغيل الجلسة. تعرض لوحة Quality gates إحدى الحالتين Release-ready أو Not release-ready، وإجماليات الاختبارات، وكل نتيجة اختبار، وأسباب عدم جاهزية التغيير بعد. وتسرد لوحة Findings كل ملاحظة مع درجة خطورتها وملفها وسطرها.
نتائج الاختبار والملاحظات المفتوحة على مستوى مساحة العمل موجودة في Build & Test → Quality.
فرز الملاحظات
لكل ملاحظة حالة. غيّرها من القائمة المنسدلة في قائمة Findings الخاصة بالتشغيل:
| الحالة | هل تمنع التغيير؟ |
|---|---|
| open, acknowledged, in progress | نعم، إذا كانت high أو critical |
| fixed, won't fix, false positive, duplicate | لا |
يمكنك أيضا اختيار Fix على ملاحظة لتشغيل جولة ذكاء اصطناعي تصلحها. وتغيير حالة الملاحظة يحتاج إلى دور له صلاحية الفرز. وهي لدى المالكين والمسؤولين والمطورين والأعضاء ومسؤولي الأمان؛ وليست لدى المشاهدين.
ما تمنعه البوابة
حين تختار فتح طلب سحب، يفحص AI CodeOps بهذا الترتيب:
- سياسة مساحة العمل. قاعدة deny توقف طلب السحب؛ وقاعدة ask تحتاج إلى مراجعة موافق عليها.
- الموافقة. الموافقة المرفوضة أو المعلقة توقفه.
- بوابة الجودة. التغيير غير الجاهز للإصدار يحصل على أول الأسباب، مثل "This change isn't release-ready: HIGH security: …".
وتعمل بوابة الجودة نفسها مرة أخرى قبل أن تدمج لوحة التحكم طلب سحب فتحته. ويفتح طلب السحب على فرع اسمه codeops/run-<id>.
بوابة الإصدار لخطوط CI
تقيّم صفحة Review & Gate → Release gate عنوان طلب سحب أو قيمة SHA لإيداع عبر كل جلسة مسته، وتعرض Allowed أو Denied مع الأسباب. ويستطيع CI لديك طرح السؤال نفسه عبر POST /api/release/check بمفتاح API لمساحة العمل. ويضيف فحص CI خيارات لا تستخدمها بوابة التشغيل الواحد: مسارات سير عمل مطلوبة، ونسبة تغطية دنيا، وتراخيص محظورة (تفحص على قائمة SBOM الخاصة بالمشروع)، وعملية نشر سابقة مطلوبة مثل staging. والحد الأدنى للتغطية يحتاج إلى رقم تغطية: إذا ضبطت حدا ولم يذكر أي تشغيل اختبار على التغيير التغطية، يرفض الفحص.
يطبق فحص CI قاعدة نتيجة الاختبار المذكورة أعلاه أيضا، ويسرد الجلسات التي ليست لها نتيجة اختبار في testEvidenceMissing. وإرسال "blockOnTestFailure": false يوقفها لذلك الاستدعاء.
الحقول والرد موجودة في صفحة API. وفي بوابة الإصدار في CI مهام جاهزة للنسخ لكل من GitHub Actions و GitLab CI و Bitbucket Pipelines، وشرح لطريقة جعل المهمة فحصا مطلوبا.
وإذا تعذر تشغيل فحص البوابة نفسه، مثلا أثناء انقطاع قصير، لا يفتح طلب السحب، وتظهر الرسالة "The release check couldn't run just now." حاول مرة أخرى بعد قليل.
الخطوات التالية
الأسئلة الشائعة
هل يمكنني فتح طلب سحب والملاحظات ما زالت مفتوحة؟
ليس ما دامت ملاحظة بخطورة high أو critical مفتوحة، أو الاختبارات فاشلة، أو مراجعة الذكاء الاصطناعي لم تكتمل. افرز الملاحظة أو أعد تشغيل الجلسة، ثم افتح طلب السحب.
ماذا لو لم يكن في مشروعي اختبارات؟
فعّل خيار "Don't run tests for this project" في إعدادات المشروع. ومن دونه، تحتاج الجلسة التي غيّرت كودا إلى نتيجة اختبار فيها أعداد. وإذا لم يعمل أي اختبار، أو لم يذكر أمر الاختبار أعدادا، يمنع التغيير، لأن غياب الدليل ليس نجاحا.