خطط

إن الخطة هي مجموعة مرتبة من المهام تُجمع في مراحل؛ تقوم بالموافقة عليها قبل كتابة الكود.

استخدمها عندما تحتاج الأعمال إلى عدة تغييرات بترتيب معين، أو عندما ترغب في رؤية النهج الكامل قبل الالتزام بأي جزء منه.

دورة الحياة#

التخطيط يُعد مرحلة مستقلة بذاتها، وليس تحولًا فوريًا.

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

يمكنك الموافقة وتنفيذها في خطوة واحدة، أو الموافقة ثم بدء التنفيذ لاحقًا.

عدّل بدلاً من إعادة الضبط#

عندما تكون الخطة قريبة من الكمال، فإن تعديلها يحافظ على ما تعلمه المعماري عن قاعدة الكود ويطبق ملاحظاتك؛ أما إعادة الضبط فتلقي بكل ذلك وتبدأ من جديد.

أعد الضبط عندما يكون النهج بأكمله خاطئًا؛ وعدّل عندما يكون النهج صحيحًا لكن التفاصيل غير دقيقة. التعديل أقل تكلفة بكثير، ومحتوى الخطة المرفوض لا يضيع — بل يصبح مدخلًا للمحاولة التالية.

التحكم في خطة قيد التشغيل#

يمكن إيقاف خطة قيد التنفيذ أو استئنافها أو إلغاؤها، ويمكنك متابعة التقدم عبر مراحلها؛ كما يمكن استنساخ الخطط، وهو الأسلوب العملي لتكرار هيكل ناجح — مثل تطبيق عملية ترحيل على خدمة ثانية.

يمكن أرشفة الخطط المكتملة للحفاظ على وضوح العرض النشط.

منصة pull request واحدة، وليس منصة لكل مهمة#

مهام الخطة لا تفتح كل منها pull request منفصلاً؛ بل تعمل على فروعها الخاصة وتندمج في فرع مشترك فرع المسار؛ يتم ترقية هذا الفرع كطلب سحب واحد ضد فرعك الأساسي عندما تستوفي الأعمال الشروط.

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

الخطط عبر المشاريع هي الاستثناء: المهمة التابعة لمشروع مختلف عن مسار الخطة تُرقى بشكل منفصل، لذا تحصل على pull request لكل مستودع؛ ولا يمكن لـ pull request أن يشمل مستودعين.

عند تغيير الفرع الأساسي#

قد تستمر الخطة لساعات، وفي هذه الأثناء يواصل فريقك الدمج في الفرع الأساسي. تم بناء الخطة واختبارها ومراجعتها مقابل الفرع الأساسي كما كان عند بدء الخطة. وعندما يصبح pull request جاهزًا، قد لا يكون ذلك هو الفرع الذي يتم دمجه فيه.

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

إذا تم تحديث الفرع الأساسي، الموافقة والدمج يظل غير مفعّل، وتعرض قائمة مراجعة الترقية الالتزامات الجديدة والملفات التي غيّرتها. يمكنك اختيار ما سيحدث:

• قبول النسخة الرئيسية الجديدة (مسماة باسم فرعك الأساسي) — التغييرات لا تؤثر على هذا العمل. تسجل Coroid من قبل من قَبِل كل التزام ولماذا، ويصبح ذلك الالتزام هو الخط الأساسي الجديد. إذا تم تحديث الفرع مرة أخرى أثناء مراجعتك، ترفض Coroid ذلك وتعرض عليك الالتزامات الأحدث أولاً. لا يتم قبول أي شيء دون عرضه عليك.
• الدمج وإعادة التحقق — تدمج Coroid الفرع الأساسي في فرع المسار، وتحل أي تعارضات إذا وجدت. ثم تمرر المسار عبر مهندس التطوير وقسم ضمان الجودة والمراجع مرة أخرى، للتأكد من مطابقته لمعايير القبول المحددة في الخطة والالتزامات العليا. تظل الموافقة معلقة حتى اكتمال هذه الخطوة. فقط بعد ذلك يصبح الالتزام الجديد هو الخط الأساسي. إذا فشل الدمج أو إعادة التحقق، تعود القرارات إليك.

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

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

دمج إجباري يتخطى هذا الفحص أيضًا، ويسجل السبب المكتوب الذي يستدعي ذلك. انظر إلى الدمج.

المراحل والتوازي#

المراحل تحدد الترتيب، وليس التزامن؛ يمكن تنفيذ المهام ضمن مرحلة واحدة بشكل متوازٍ إذا سمحت السعة؛ بينما تنتظر المرحلة التالية انتهاء المرحلة الحالية.

خطة تحتوي على عشر مهام آمنة للتنفيذ المتوازي ومكان واحد لوكيل تنفيذ ستنفذها واحدة تلو الأخرى؛ الهيكل لا يخلق سعة — انظر السعة ومواقع الوكلاء.

خطة أم مهمة؟#

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

المعيار هو القابلية للمراجعة: pull request يمكن لزميل قراءته في جلسة واحدة تُعتبر مهمة؛ أما ما يتطلب عدة تغييرات مرتبة فهو خطة.

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

بوابات التسليم#

يمكن للخطة أن تحمل بوابة تسليم تحدد ما يجب تحقيقه قبل تقدم نتائجها؛ انظر إلى بوابات الجودة.

ذات صلة#

• المهام، الخطط، دورات العمل ومسارات التنفيذ
• دورات عمل
• مواصفات
• المنشأ