مشاريع المعاينة والمشاريع المؤقتة

فكرتان مترابطتان تهدفان إلى إبعاد العمل التجريبي عن المهام ذات الأهمية.

مشاريع مؤقتة#

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

القيمة الأساسية تكمن في العزل؛ فالتجارب داخل مشروع مؤقت لا تلوث سجل المهام أو المقاييس أو السياق الخاص بالمشروع الذي يعتمد عليه فريقك.

احذفه عند الانتهاء منه؛ فالمشروع المؤقت الذي يستمر لأكثر من ستة أشهر يتحول تدريجيًا إلى مشروع حقيقي، دون الحصول على العناية اللازمة في الإعدادات.

بيئات المعاينة#

المعاينة تمثل تطبيقك المعدل وهو يعمل فعليًا، ويتم بناؤه من الفرع الذي أنتجته المهمة.

وهذا أمر مهم لأن بعض الأمور لا يمكن التأكد منها عبر مجرد قراءة الاختلافات؛ سواء كان عرض الصفحة صحيحًا، أو هل يعمل المسار بشكل كامل، أو هل يبدو التغيير مناسبًا — كل ذلك يتطلب تشغيل النظام فعليًا.

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

معاينة تغييرات المهمة#

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

• بدء التشغيل: يتم تثبيت تبعيات الفرع وتشغيل التطبيق؛ وقد يستغرق التشغيل الأول بضع دقائق.
• جاهز: يظهر التطبيق الجاري تشغيله داخل النافذة. فتح يُظهره في علامة تبويب جديدة، وتوضح النافذة المدة المتبقية للمعاينة.
• إيقاف ينهيها مبكرًا؛ فالمعاينة التي تعمل في Coroid تتوقف تلقائيًا بعد ساعة.

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

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

مكان تشغيل المعاينة#

لا تختار مكان تشغيل المعاينة:

• بيئة عزل Coroid: هي الإعداد الافتراضي؛ يقوم Coroid ببناء فرع المهمة في حاوية معزولة لا تحتوي على أي من بياناتك السرية. ولا تحتاج إلى pull request ولا إلى دفع، لذا تعمل أيضًا مع المستودعات التي تبقى داخل Coroid.
• Vercel: عندما يكون المشروع متصلًا بـ Vercel للنشر المباشر (إعدادات المشروع → تكاملات → أدلة المراجعة)، يقوم Vercel ببناء الفرع وعرضه على عنوان معاينة من Vercel؛ وتنطبق حماية النشر الخاصة بـ Vercel، لذا تفتح المعاينة في علامة تبويب جديدة بدلاً من داخل النافذة.

المستودع في وضع الوصول المحلي لا يغادر Coroid أبدًا، ودائمًا ما تتم معاينته في بيئة عزل Coroid.

عنوان المعاينة طويل وصعب التخمين، لكن أي شخص يملكه يمكنه فتح المعاينة أثناء تشغيلها؛ تعامل معه كأي رابط للعمل غير المنشور.

كيف تصل بيئات المعاينة إلى pull request#

رابط pull request Coroid المفتوح لمهمة ما يؤدي إلى معاينتها: معاينة هذا التغيير في Coroid تفتح مراجعة المهمة وتبدأ المعاينة؛ يحتاج الرابط إلى تسجيل دخول إلى Coroid؛ ولا يتم نشر عنوان المعاينة نفسه في طلب السحب.

إذا كان لديك بالفعل نشرات معاينة — من تطبيق Git الخاص بمزود الاستضافة أو من نظام التكامل المستمر — فإن Coroid يربطها أيضًا كـ أدلة مراجعة، لذا تظهر الرابط بجانب التغيير بدلاً من أن تضطر للبحث عنه في مكان آخر.

الهدف هو أن تأتي أدلة التحقق من الصحة والكود الذي تتحقق منه معًا.

متى تستخدم كل نوع#

• لتجربة Coroid أو منهجية قد تتخلى عنها لاحقًا ← مشروع مؤقت
• للتأكد من أن تغييرًا معينًا يعمل بشكل صحيح ← بيئة معاينة

ويمكن دمجهما معًا؛ فالمشروع المؤقت يمكن أن يحتوي على بيئات معاينة مثل أي مشروع آخر.

ذات صلة#

• إنشاء مشروع وإعداده
• أدلة مراجعة
• مزودو أدلة المراجعة