الدليل‹GitHub والعمل الجماعي
GitHub والعمل الجماعيمتوسّط‏١٢ دقيقة قراءة

مزامنة GitHub

اربط مستودعًا، واحتفظ بالكود المُولّد ضمن نظام التحكم في الإصدارات، وأعِد التغييرات الخارجية إلى محرّر مايندلاب دون مغادرة المنصّة.

لماذا تربط GitHub؟

افتراضيًا، يخزّن مايندلاب الكود المُولّد لمشروعك داخليًا. ربط مستودع GitHub يتيح لك:

  • الاحتفاظ بسجلّ كامل وقابل للتدقيق لكل بناء وتكرار
  • التعاون مع المطوّرين الذين يفضّلون العمل محليًا في محرّرهم الخاص
  • تشغيل خط CI/CD الحالي لديك (الاختبارات، التحقق من الكود، عمليات النشر) عند كل دفع
  • استخدام طلبات السحب (pull requests) لمراجعة الكود قبل اعتماد التغييرات
  • الاعتماد على المستودع إن توقّفت يومًا عن استخدام مايندلاب — فالكود ملكك

ربط مستودع

1
افتح إعدادات المشروع
من شاشة البناء، انقر على اسم المشروع أعلى الشريط الأيسر ← Settings ← Git.
2
المصادقة عبر GitHub
انقر على 'Connect GitHub'. سيُعاد توجيهك إلى GitHub لتثبيت تطبيق مايندلاب على GitHub في حسابك أو مؤسستك. امنح الوصول إلى المستودعات التي تريد استخدامها.
3
اختر مستودعًا
اختر مستودعًا موجودًا من القائمة المنسدلة، أو دع مايندلاب ينشئ مستودعًا فارغًا جديدًا. إن كان المستودع يحتوي على كود بالفعل، فسيقرؤه مايندلاب قبل أي عمليات بناء لاحقة.
4
اختر فرعًا
اختر الفرع الذي ينبغي لمايندلاب الدفع إليه. الافتراضي هو 'main'. لمشاريع الفِرق نوصي باستخدام فرع مخصّص مثل 'myndlab' أو 'generated'.
5
احفظ
انقر على Save. سيقوم مايندلاب بدفع أوّلي لكود المشروع الحالي إلى الفرع المحدّد.
ℹ
ملاحظة.يطلب تطبيق مايندلاب على GitHub صلاحية القراءة/الكتابة فقط للمستودعات التي تختارها صراحةً أثناء الإعداد. ولا يصل أبدًا إلى المستودعات الأخرى في حسابك.

دفع الكود المُولّد

بمجرد ربط مستودع، يدفع كل بناء ناجح تلقائيًا commit إلى الفرع المُهيّأ. تتضمّن رسالة الـ commit مقتطفًا من الموجّه ومُعرّف البناء:

git log
commit 3f8a2c1
Author: Myndlab Build Agent <builds@myndlab.ai>
Date:   Mon May 25 11:42:03 2026

    [myndlab] Add real-time search filter to contacts list

    Build: ml-20260525-114203
    Changed: src/components/ContactsList.tsx, api/routes/contacts.py

يمكنك أيضًا تشغيل عملية دفع يدويًا في أي وقت من Settings ← Git ← Push now. هذا مفيد إن ربطت GitHub بعد البناء الأوّلي وأردت مزامنة الحالة الراهنة.

سحب التغييرات الخارجية

إن عدّل مطوّر في فريقك ملفات في المستودع مباشرةً (خارج مايندلاب)، يمكنك سحب تلك التغييرات إلى محرّر مايندلاب:

1
افتح Settings ← Git
سترى شريط 'Changes available' إن كان الفرع البعيد متقدّمًا على النسخة المحلّية لمايندلاب.
2
انقر على Pull
يجلب مايندلاب التغييرات البعيدة ويطبّقها على ملفات المشروع. يعرض ملخّص فروقات (diff) ما الذي تغيّر.
3
راجع الفروقات
افحص الفروقات في مستكشف الملفات. يُبرز مايندلاب الملفات التي عُدّلت خارجيًا حتى تتمكّن من رصد التغييرات غير المتوقّعة.
4
تابع البناء
يعكس المحرّر الآن التغييرات المسحوبة. سيستخدم بناؤك التالي قاعدة الكود المُحدّثة كنقطة انطلاق.

سير عمل الفروع

لمشاريع الفِرق أو حين تريد التجربة دون التأثير على الإنتاج، استخدم سير عمل فرع لكل ميزة:

1
أنشئ فرعًا في Settings ← Git
انقر على 'New branch'، وسمِّه (مثل 'feature/search-filter')، واختره كفرع نشط. يبدّل مايندلاب هدف الدفع فورًا.
2
ابنِ على الفرع
كل عمليات البناء أثناء نشاط الفرع تدفع commits إليه، وليس إلى main.
3
افتح PR على GitHub
عندما تجهز الميزة، افتح طلب سحب (pull request) من واجهة GitHub. يعمل خط CI لديك، ويراجع زملاؤك، ثم تدمج كالمعتاد.
4
عُد إلى main
ارجع إلى Settings ← Git وأعِد اختيار فرع main. يستأنف مايندلاب الدفع إليه.
💡
نصيحة.سمِّ الفروع بأسماء وصفية. يُدرج مايندلاب اسم الفرع ضمن مدخلات سجلّ البناء، ما يسهّل تتبّع الميزة التي كان بناء معيّن مخصّصًا لها عند مراجعة السجلّ.

معالجة التعارضات

يحدث التعارض عندما يعدّل كلٌّ من الكود المُولّد من مايندلاب وتغيير خارجي الملفَّ نفسه بطرق غير متوافقة. يكتشف مايندلاب ذلك قبل الدفع ويُظهر الملفات المتعارضة في المحرّر.

لديك خياران عند اكتشاف تعارض:

1
اقبل نسخة مايندلاب
يكون للكود المُولّد من مايندلاب الأسبقية. تُهمل التغييرات الخارجية على الملف المتعارض. استخدم هذا حين تثق في أحدث مخرجات البناء.
2
اقبل النسخة الخارجية
يُحتفظ بالملف المُعدّل خارجيًا كما هو. ولا تُطبَّق تغييرات مايندلاب على ذلك الملف. استخدم هذا حين يكون المطوّر قد أنجز عملاً يدويًا كبيرًا لا تريد الكتابة فوقه.
⚠
انتبه.غالبًا ما تعني التعارضات المتكرّرة أن عددًا كبيرًا من الأشخاص يحرّرون الملفات نفسها بأدوات مختلفة في آنٍ واحد. النمط الأنظف هو: دع مايندلاب يملك الملفات المُولّدة، واحتفظ بأي منطق مخصّص مكتوب يدويًا في ملفات منفصلة يُطلب من مايندلاب ألّا يمسّها.
الخطوات التالية
→ العودة إلى الدليل