- الرئيسية
- ساهم بوصفة بوابة
ساهم بوصفة بوابة
نجمع وصفات لبوابات الجودة: إعدادات CI يمكنك نسخها توقف التغيير السيئ قبل دمجه، وصفة لكل مجموعة تقنيات. أرسل لنا وصفة تعمل على مشاريعك، وسننشرها مع اسمك ورابط إليك.
ما هي الوصفة
الوصفة هي البوابة لمجموعة تقنيات واحدة، مثل Next.js أو Django أو FastAPI أو Go أو Rails أو Spring أو .NET أو Rust. وهي:
- تشغل اختبارات المشروع وتفشل عند فشل أي اختبار،
- تضع حدا أدنى للتغطية،
- تنشئ قائمة SBOM (بصيغة CycloneDX) للبناء،
- تفحص تراخيص التبعيات في ضوء سياسة،
- تفحص التغيير بحثا عن أسرار أودعت فيه.
اكتبها سير عمل CI عاديا (GitHub Actions أو GitLab CI أو Forgejo Actions أو ما شابهها)، لتعمل لمن لا يستخدمون AI CodeOps. وإذا كنت تستخدم AI CodeOps، فأضف أيضا استدعاء فحص الإصدار: يسأل CI لديك POST /api/release/check هل يجوز دمج طلب سحب، مع خيارات مثل minCoveragePct و disallowedLicenses و requiredWorkflows. راجع بوابات الجودة ومرجع API.
ما الذي يجعل الوصفة جيدة
- أنها تعمل. فقد استخدمتها على مستودع حقيقي، وتخبرنا بإصدارات الأدوات.
- كل خطوة تذكر ما تفحصه ولماذا، في تعليق أو في ملف README قصير.
- لا أسرار ولا رموز ولا أسماء مضيفين داخلية فيها.
- تغلق عند الخطأ: إذا تعذر تشغيل فحص، تقول البوابة ذلك بدل أن تسمح بالمرور.
جديد على البوابات؟ ابدأ بـدليل بوابات الجودة وبوابات التغطية والفتح عند الخطأ مقابل الإغلاق عند الخطأ.
النسبة إلى المؤلف
تذكر كل وصفة منشورة اسم مؤلفها، مع رابط إلى الموقع أو الملف الشخصي الذي تختاره.
كيف ترسل وصفة
مستودع الوصفات المفتوح قادم قريبا، وسيوضع رابطه هنا حين يصبح عاما. وحتى ذلك الحين، أرسل وصفتك بالبريد إلى [email protected] مع "Gate recipe" في الموضوع: الإعدادات، ومجموعة التقنيات والإصدارات التي اختبرت عليها، والاسم والرابط اللذين تريد النسبة إليهما.
تبحث عن نقطة تبدأ منها؟ تتضمن القوالب لدينا مسارات سير عمل خاضعة للبوابات لمشاريع Python و Next.js.