AI CodeOps

طلب سحب في Next.js: ثلاث مراجعات واختباراتك وفحص إصدار من CI

آخر تحديث

تغيير في Next.js يراجعه سير العمل Parallel Review من حيث الصحة والأمان وتغطية الاختبارات، ويختبر بمجموعة اختباراتك، ثم يفحص مرة أخرى من CI قبل الدمج.

استخدم هذا القالب

معالج المسار الذي يقبل مدخلات من المتصفح يستحق أكثر من عين واحدة. وهذا القالب يشغل ثلاث مراجعات مركزة على تغيير في Next.js، ويشغل مجموعة اختباراتك على الكود الذي كتب، ويتيح لـ CI لديك أن يطرح السؤال نفسه مرة أخرى قبل الدمج.

الوكلاء الذين يعملون

الخطوةالوكيل
Correctness reviewReviewer
Security reviewSecurity Auditor
Test coverage reviewTester
Merge findingsArchitect

يجمع وكيل Architect المراجعات الثلاث في قائمة واحدة. ثم تكتب جولة كتابة الكود التغيير، وتشغل خطوة التحقق (verify) سكربت الاختبار في ملف package.json، بمدير الحزم الذي يشير إليه ملف القفل لديك، داخل بيئة معزولة غير متصلة بالشبكة. وتحلل مخرجات Vitest و Jest إلى إجماليات.

البوابات السارية

  • الملاحظات. تقرأ مراجعة الملاحظات الفروقات الفعلية، والمراجعات الثلاث سياق لها. والملاحظات المفتوحة بخطورة high أو critical تمنع طلب السحب إلى أن تفرز.
  • الاختبارات على هذا الإصدار. الاختبارات الفاشلة تمنع. وتعديل التغيير بعد تشغيل اختباراته يسمه بأنه غير مختبر.
  • الموافقة. لا يستطيع من بدأ الجلسة الإدلاء بصوت الموافقة ما دام في مساحة العمل شخص آخر يستطيع الموافقة.

افحص مرة أخرى من CI

تفتح لوحة التحكم طلب السحب على فرع باسم codeops/run-<id>. وفي GitHub Actions، أضف خطوة إلى سير العمل الذي يعمل على طلبات السحب، مع مفتاح API لمساحة العمل محفوظ سرا، كما يلي:

- name: AI CodeOps release check
  if: startsWith(github.head_ref, 'codeops/run-')
  env:
    AICODEOPS_API_KEY: ${{ secrets.AICODEOPS_API_KEY }}
    PR_URL: ${{ github.event.pull_request.html_url }}
  run: |
    curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
      -H "Authorization: Bearer $AICODEOPS_API_KEY" \
      -H "Content-Type: application/json" \
      -d "{\"pullRequestURL\":\"$PR_URL\",\"blockOnInFlight\":true}" \
      | jq -e '.allowed == true'

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

الخطوة التالية

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

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

هل تعمل المراجعات الثلاث في الوقت نفسه؟

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

هل ترفض خطوة CI طلبات السحب المكتوبة يدويا؟

نعم، فطلب السحب الذي لا جلسة وراءه يحصل على الرسالة No workflow runs found. ولهذا لا تعمل الخطوة إلا على الفروع التي تبدأ بـ codeops/run-.