GitHub

في LaunchCal، يمكن للإطلاق أن يتبع عمله في GitHub: مشروعًا لمؤسسة، أو مرحلة رئيسية لمستودع. تتغير حالته حين تتغير حالة المشروع أو المرحلة الرئيسية، ويعرض تقدمهما، وتظهر تحديثات حالة المشروع في الإطلاق.

يقرأ Taktoria من GitHub فقط: لا يُنشئ شيئًا هناك ولا يغيّره ولا يعلّق عليه أبدًا. ويُربط كتطبيق مثبّت على مؤسستك لا كشخص، فلا يرى إلا المستودعات التي اختارتها المؤسسة، ويبقى يعمل أيًّا كان من ربطه.

لا يربط GitHub إلا مالك مساحة العمل أو أحد مسؤوليها.

1. افتح الإعدادات ← التكاملات.
2. ضمن أنظمة التذاكر، اختر ربط GitHub.
3. في GitHub، ثبّت تطبيق Taktoria على المؤسسة، واختر المستودعات التي يمكنه قراءتها، ووافق.

يطلب التطبيق قراءة مشاريع المؤسسة، وتذاكر مستودعاتها وطلبات السحب فيها وبياناتها الوصفية. وإن كان على أحد مالكي المؤسسة الموافقة عليه أولًا، يخبرك Taktoria بذلك: اختر ربط GitHub مرة أخرى بعد موافقته. تذكر البطاقة عندئذ بأي مؤسسة هي مرتبطة. وتربط كل مساحة عمل في Taktoria مؤسسة واحدة.

يمكن لكل من يستطيع تعديل الإطلاق ربطه أو مزامنته أو فك ارتباطه.

1. افتح علامة تبويب التفاصيل في الإطلاق.
2. ضمن مشروع التذاكر، الصق عنوان مشروع المؤسسة، أو المرحلة الرئيسية للمستودع، في رابط المشروع.
3. اختر ربط المشروع.

يجب أن يكون المشروع تابعًا للمؤسسة المرتبطة، والمرحلة الرئيسية في مستودع يستطيع التطبيق قراءته. ويُزامَن فورًا. أما المستودع، أو أي شيء آخر في GitHub، فيُحفظ كرابط عادي، وكذلك الرابط الذي يُلصق قبل ربط GitHub، حتى يُربط.

ويمكن لمساعد ذكاء اصطناعي مرتبط بـ LaunchCal، وللواجهة البرمجية REST، ربط الإطلاق ومزامنته وفك ارتباطه أيضًا، وفق القواعد نفسها.

يُزامَن الإطلاق المرتبط مرة يوميًا حتى يُطلق، وكلما اختار أحدهم المزامنة الآن.

بالنسبة للمشروع:

• الحالة: يحددها أحدث تحديث حالة للمشروع. على المسار أو في خطر أو خارج المسار يصبح قيد التطوير (ويبقى الإطلاق الموجود أصلًا في التصميم أو الاختبار حيث هو)، وغير النشط يصبح موقوف مؤقتًا، والمكتمل يعني الاكتمال. وما لم يوجد تحديث حالة بعد، يبقى الإطلاق في تحديد النطاق حتى يُنجز أحد عناصر المشروع. والمشروع المغلق مكتمل، إلا إذا كان غير نشط.
• التقدم: نسبة عناصره المغلقة أو المدمجة أو الموجودة في عمود الإنجاز.
• تحديثات الحالة: يصبح كل منها تحديثًا من تحديثات الإطلاق في علامة تبويب النشاط، موسومًا من GitHub مع رابط إليه، وتتبع صحة الإطلاق أحدثها.

بالنسبة للمرحلة الرئيسية: المفتوحة دون أي تذكرة مغلقة تكون تحديد النطاق، والمفتوحة مع بعض التذاكر المغلقة تكون قيد التطوير، والمغلقة مكتملة. وتقدمها هو نسبة تذاكرها المغلقة. وليس للمرحلة الرئيسية تحديثات.

حين يكتمل المشروع أو المرحلة الرئيسية، يذكر الإطلاق أنه جاهز ويُبلَّغ المسؤولون عنه. تبقى الحالة التي تختارها في LaunchCal قائمة حتى تتغير حالة GitHub مجددًا. ويظهر ما تغيّره المزامنة على أنه من GitHub، في سجل الإطلاق وفيما يُرسل إلى المسؤولين عنه وفي سجل التدقيق.

• لا يُطلق شيئًا أبدًا. المشروع أو المرحلة الرئيسية المكتملة يجعل الإطلاق جاهزًا؛ ويبقى على أحدهم اختيار اضغطوا للإطلاق! بعد البتّ في مراجعاته المطلوبة.
• لا يغيّر أبدًا إطلاقًا تم إطلاقه.
• لا يكتب أبدًا في GitHub.
• لا يقرأ أبدًا مستودعًا لم تمنحه إياه المؤسسة.

يوقف فك الارتباط، في علامة تبويب التفاصيل في الإطلاق، مزامنة ذلك الإطلاق؛ ويبقى ما جُلب.

ويوقف إلغاء الربط، في الإعدادات ← التكاملات، مزامنة جميع الإطلاقات من GitHub وينهي وصول Taktoria فورًا. تحتفظ الإطلاقات بما ترتبط به وبكل ما زُومن حتى ذلك الحين، وتستأنف المزامنة بمجرد ربط GitHub مجددًا. ويبقى التطبيق مثبّتًا على المؤسسة حتى يزيل أحد مالكيها تثبيته من إعدادات المؤسسة في GitHub.

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