---
title: "الجلسة الأولى | Git, GitHub & AI Engineer Workflow"
aliases:
  - "Session 01 - Git & GitHub"
  - "AI Camp v2 - Session 01"
tags:
  - AI-Camp-v2
  - Foundations
  - Git
  - GitHub
  - AI-Engineering
session: 1
duration: "2 hours"
duration_minutes: 120
track: Foundations
status: planned
language: ar
---

# الجلسة الأولى: Git, GitHub & AI Engineer Workflow

> [!info] معلومات الجلسة
> - **المسار:** Foundations — الأساسيات الهندسية
> - **المدة:** ساعتان
> - **عنوان الجلسة:** Git, GitHub & the AI Engineer's Workflow
> - **الطابع:** مفاهيم أساسية + إعداد بيئة العمل + تطبيق عملي

##  نظرة عامة

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

سيتعرّف الطلاب على إدارة إصدارات الشيفرة، والعمل الجماعي على GitHub، وتجهيز بيئة التطوير، والاستفادة الأولية من أدوات البرمجة المدعومة بالذكاء الاصطناعي.

> [!abstract] الهدف الرئيسي
> تمكين الطالب من إعداد مشروعه البرمجي، وإدارة تعديلاته باستخدام Git، والمساهمة في مستودع مشترك عبر Pull Request، تمهيدًا لتسليم واجبات ومشروعات المعسكر بطريقة احترافية.

##  مخرجات التعلّم

بنهاية الجلسة، يُتوقع أن يكون الطالب قادرًا على:

- التمييز بين Git وGitHub ووظيفة كل منهما.
- استخدام المفاهيم الأساسية: `Commit` و`Branch` و`Merge` و`Pull Request`.
- فهم سبب حدوث `Merge Conflict` وكيفية التعامل معه.
- تجهيز بيئة Python مناسبة للمشروعات التطبيقية.
- استخدام GitHub Copilot في الإكمال التلقائي للشيفرة بصورة أولية.
- إنشاء Pull Request وإرساله للمراجعة ضمن مستودع المعسكر.

---

##  المحاور النظرية

### 1. Git & GitHub — إدارة الإصدارات والتعاون

**المفاهيم الأساسية:**

| المفهوم | الشرح |
|---|---|
| **Git** | نظام لإدارة إصدارات الشيفرة وتتبع التغييرات التي تطرأ على المشروع. |
| **GitHub** | منصة لاستضافة مستودعات Git ومشاركة العمل ومراجعة التعديلات والتعاون بين المطورين. |
| **Commit** | نقطة محفوظة في تاريخ المشروع تمثل مجموعة من التغييرات. |
| **Branch** | فرع مستقل يُستخدم لتطوير ميزة أو إصلاح مشكلة دون التأثير مباشرة في الفرع الرئيسي. |
| **Pull Request (PR)** | طلب لمراجعة تعديلات فرع ودمجها في فرع آخر عند الموافقة عليها. |
| **Merge Conflict** | تعارض بين تعديلات لا يستطيع Git دمجها تلقائيًا، ويستلزم تدخّل المطور لحله. |

**موضوعات مكملة:**

- فكرة **Working Directory → Staging Area → Commit**.
- إنشاء الفروع والتنقل بينها.
- الفرق الأساسي بين `Merge` و`Rebase` ومتى يُستخدم كل منهما.
- مبادئ **Code Review** وتبادل الملاحظات على Pull Requests.
- أهمية `README.md` و`.gitignore` في تنظيم المشروع.

> [!tip] سير العمل المستهدف
> `Clone / Fork → Branch → Edit → Stage → Commit → Push → Pull Request → Review → Merge`

### 2. Environment Setup — تجهيز بيئة التطوير

يتعرّف الطلاب على الأدوات التي سيحتاجون إليها خلال المعسكر:

| الأداة | الاستخدام |
|---|---|
| **Python** | لغة البرمجة الأساسية للمشروعات والتطبيقات. |
| **VS Code** | محرر الشيفرة وبيئة التطوير. |
| **uv** | إدارة بيئات Python والحزم واعتماديات المشروع. |
| **Google Colab** | تشغيل Notebooks والتجارب عند الحاجة إلى بيئة سحابية. |
| **`.env`** | حفظ إعدادات التشغيل ومفاتيح الخدمات في البيئة المحلية. |

> [!warning] تنبيه أمني
> لا ينبغي رفع ملفات `.env` التي تحتوي أسرارًا أو مفاتيح API إلى GitHub. يُستخدم `.gitignore` لاستبعادها، ويمكن توفير ملف `.env.example` يشرح أسماء المتغيرات المطلوبة دون تضمين قيم سرية.

### 3. Introduction to GitHub Copilot — مقدمة عن البرمجة بمساعدة AI

- التعرف إلى فكرة الإكمال التلقائي للشيفرة باستخدام GitHub Copilot.
- تجربة اقتراحات بسيطة أثناء كتابة Python.
- فهم ضرورة قراءة الاقتراحات والتحقق منها قبل اعتمادها.

> [!note] نطاق هذا المحور
> الهدف هنا هو التعرف إلى **Autocomplete** فقط؛ أما وكلاء البرمجة المتقدمون وطرق توجيههم ومراجعة أعمالهم فستُناقش بصورة أوسع في جلسة **AI-Assisted Coding** اللاحقة.

---

## التطبيق العملي: First Pull Request

**الهدف:** مساهمة كل طالب في مستودع المعسكر من خلال GitHub، ثم تجربة حل تعارض دمج بالتعاون مع زميل.

### الجزء الأول — مساهمة فردية

- [ ] 1. إجراء **Fork** لمستودع `AI-Camp`.
- [ ] 2. تنزيل نسخة محلية من المستودع (**Clone**).
- [ ] 3. إنشاء **Branch** جديد باسم واضح.
- [ ] 4. إضافة اسم الطالب أو تعديل السطر الخاص به في ملف المشاركين.
- [ ] 5. حفظ التغييرات باستخدام **Commit** برسالة واضحة.
- [ ] 6. رفع التعديلات إلى GitHub باستخدام **Push**.
- [ ] 7. فتح **Pull Request** وكتابة وصف مختصر للتعديل.
- [ ] 8. متابعة التعليقات والتعديلات المطلوبة حتى تصبح المساهمة جاهزة للدمج.

### الجزء الثاني — تمرين ثنائي على Merge Conflict

1. يعمل طالبان على فرعين منفصلين.
2. يعدّلان الجزء نفسه من ملف تجريبي.
3. يحاولان دمج التغييرات لظهور التعارض.
4. يحددان الأسطر المتعارضة ويتفقان على النتيجة الصحيحة.
5. يحلان التعارض ويتحققان من الملف النهائي قبل إتمام الدمج.

> [!important] معيار النجاح
> يُعدّ التطبيق مكتملًا عند إنشاء **Pull Request صالح للمراجعة** والمشاركة في حل تعارض دمج، مع توفر بيئة تطوير محلية جاهزة للجلسات التالية. يعتمد دمج الـPR النهائي على مراجعة المشرف وصلاحيات المستودع.

## التسليم المطلوب (Deliverables)

- [ ] بيئة عمل محلية تتضمن Python والأدوات الأساسية المطلوبة.
- [ ] Branch يحتوي تعديلات الطالب.
- [ ] Pull Request يتضمن وصفًا واضحًا لما تم تغييره.
- [ ] مشاركة عملية في تمرين **Merge Conflict Resolution**.

## 🔗 مراجع ومصادر

- [GitHub Docs — Introduction to Git](https://docs.github.com/en/get-started/using-git/about-git)
- [GitHub Docs — Pull Requests](https://docs.github.com/en/pull-requests)
- [GitHub Docs — Reviewing Pull Requests](https://docs.github.com/en/pull-requests/how-tos/review-pull-requests)
- [uv Documentation](https://docs.astral.sh/uv/)
- [Visual Studio Code](https://code.visualstudio.com/docs)

---

##  خلاصة الجلسة

تؤسس الجلسة الأولى لمهارات العمل التي سيستخدمها الطالب طوال المعسكر: **تنظيم الشيفرة، وتتبع التعديلات، والتعاون عبر GitHub، ومراجعة العمل، وتجهيز أدوات التطوير**.

**النتيجة المتوقعة:** يصبح الطالب قادرًا على تسليم واجباته ومشروعاته اللاحقة باستخدام سير عمل قريب من ممارسات فرق التطوير الحقيقية.

> [!success] الرسالة الأساسية
> مهندس الذكاء الاصطناعي لا يحتاج فقط إلى بناء النماذج؛ بل يحتاج أيضًا إلى إدارة شيفرته والتعاون مع فريقه وتوثيق العمل وتقديمه للمراجعة.
