الوحدة الثانية: سير العمل الأساسي

في هذه الوحدة، سنتعلم الأوامر الأساسية لإدارة مشروعك محلياً وكيفية مزامنته مع منصة GitHub. سنركز على "سير العمل الاحترافي" لتحويل مشروع محلي إلى مشروع منشور للعالم.

1. دورة الحياة المحلية

قبل الانتقال للسحابة، لنتقن الدورة المحلية. تذكر المراحل الثلاث: مجلد العمل (Working Directory)، منطقة التحضير (Staging Area)، والالتزام (Commit).

# أ. تحقق من الحالة (افعل ذلك باستمرار!)
git status

# ب. إضافة التغييرات لـ "رصيف التحميل"
git add filename.js
# أو إضافة كل شيء
git add .

# ج. حفظ التغييرات بوصف احترافي
git commit -m "feat: implement user authentication"

---

2. كيفية رفع مشروع جديد إلى GitHub

هذه هي المهمة الأكثر شيوعاً للمطور. هناك سيناريوهان رئيسيان:

السيناريو أ: لديك مشروع على جهازك وتريد رفعه لـ GitHub

1. أنشئ مستودعاً (Repo) على GitHub: اذهب لـ GitHub.com > New Repository. اختر اسماً، لكن لا تضغط على "Add a README" حالياً.
2. الربط والدفع (Push):

# 1. تهيئة Git في مجلدك (إذا لم تفعل ذلك سابقاً)
git init

# 2. إضافة الملفات وعمل commit
git add .
git commit -m "feat: initial commit"

# 3. التأكد من أن اسم الفرع الرئيسي هو 'main'
git branch -M main

# 4. ربط مشروعك المحلي بـ GitHub (المستودع البعيد)
git remote add origin https://github.com/username/repo-name.git

# 5. رفع الكود ('Push')
git push -u origin main

TIP

العلم -u يربط فرعك المحلي بفرع GitHub بشكل دائم، بحيث تحتاج مستقبلاً لكتابة git push فقط.

السيناريو ب: البدء بمشروع موجود بالفعل على GitHub (git clone)

إذا كان المشروع موجوداً بالفعل أو قمت بإنشائه مع ملف README:

# 1. انسخ الرابط من GitHub
# 2. قم بتحميل المشروع لجهازك
git clone https://github.com/username/repo-name.git

# 3. ادخل للمجلد وابدأ العمل!
cd repo-name

لماذا نستخدم Clone؟ لأنه يقوم بإعداد الربط مع GitHub تلقائياً لك.

---

3. التعامل مع مشاكل التزامن

أحياناً يحتوي المستودع على GitHub على ملفات (مثل README) ليست موجودة على جهازك، مما يمنع عملية الـ Push.

الحل:

# 1. اسحب التغييرات من GitHub أولاً
git pull origin main --allow-unrelated-histories

# 2. أصلح أي تعارضات (إن وجدت)، ثم ارفع مجدداً
git push origin main

---

4. التحقق من الاتصال

كيف تتأكد أن Git مرتبط بالمكان الصحيح؟

# عرض كافة الروابط البعيدة
git remote -v

يجب أن ترى رابطين (fetch و push) يشيران لمستودعك على GitHub.

---

ماذا بعد؟

الآن وقد أصبح مشروعك آمناً على GitHub، حان الوقت لتعلم كيفية العمل مع الآخرين باستخدام الفروع (Branches)!