المستودع المحلي والالتزامات

لفهم الإيداعات، يجب أولاً تصوّر المناطق الثلاث التي يمرّر عبرها Git ملفاتك.

تشبيه: تجهيز طرد. مجلد العمل مكتبك المبعثر؛ منطقة التجهيز الصندوق الذي تضع فيه ما تريد إرساله؛ الإيداع لحظة ختم الصندوق وأرشفته.

لتحويل مجلد عادي إلى مستودع Git:

# الانتقال إلى مجلد المشروع
cd mon-projet

# تهيئة المستودع
git init

هذا ينشئ مجلداً فرعياً مخفياً .git/ يحتوي السجل كله وإعداد المستودع.

# التحقق من حالة المستودع المُنشأ للتو
git status

تحذير: لا تحذف مجلد .git/ أبداً: إنه يحتوي السجل كله. حذفه يعني فقدان الأرشفة (دون فقدان ملفاتك الحالية).

تمرين مصغّر — اكتب الأمر الذي يحوّل المجلد الحالي إلى مستودع Git، ثم الأمر الذي يعرض حالته.

git init
git status

يمكن أن يكون الملف متتبَّعاً (tracked) أو غير متتبَّع (untracked) من Git.

# تجهيز ملف محدَّد
git add fichier.txt

# تجهيز كل تغييرات المجلد
git add .

# رؤية الحالة (متتبَّع / غير متتبَّع / مجهَّز)
git status

git status أفضل صديق لك: استخدمه قبل وبعد كل git add لترى بالضبط ما يستعد Git لتسجيله.

تمرين مصغّر — عدّلت للتو index.html و style.css. اكتب الأمر الذي يجهّز (stage) index.html فقط.

git add index.html

الإيداع (commit) لقطة (snapshot) لمشروعك في لحظة معيّنة، مرفوقة برسالة تفسّر التغيير.

# التجهيز ثم التسجيل
git add .
git commit -m "إضافة صفحة الاستقبال"

كل إيداع يملك:

# رؤية سجل الإيداعات
git log
git log --oneline   # نسخة مختصرة

الإيداع الجيد ذرّي: يفعل شيئاً واحداً متماسكاً. تجنّب الإيداع الجامع «أشياء كثيرة» — فضّل عدة إيداعات صغيرة واضحة.

تمرين مصغّر — جهّز كل تغييراتك وأنشئ إيداعاً رسالته «يضيف صفحة الاتصال».

git add .
git commit -m "يضيف صفحة الاتصال"

رسالة الإيداع تروي قصة المشروع. رسالة جيدة توفّر ساعات على الفريق كله (وعليك بعد 6 أشهر).

القواعد الأساسية

• الكتابة بصيغة الأمر في المضارع: «أضف…»، «صحّح…»، «احذف…».
• سطر ملخص قصير (≤ 50 حرفاً)، ثم متن مفصَّل إن لزم.
• اشرح لماذا، لا ماذا فقط.

مقارنة

عرف شائع (Conventional Commits)

feat: يضيف المصادقة بالرمز
fix: يصحّح ترقيم صفحات النتائج
docs: يكمّل README التثبيت

تلميح للتذكّر: الرسالة الجيدة تُكمل الجملة «إذا طبّقت هذا الإيداع، فسوف…». مثال: «…إضافة صفحة الاستقبال».

بعض الملفات يجب ألا تُؤرشف أبداً: ملفات مؤقتة، تبعيات ضخمة، أسرار، ملفات مجمَّعة. ملف .gitignore يخبر Git بتجاهلها.

# مثال محتوى ملف .gitignore
target/
node_modules/
*.log
.env
.DS_Store

قاعدة ذهبية للأمن: لا تودع أبداً كلمات مرور أو مفاتيح API أو أسراراً. ما إن يدخل السر سجل Git، يبقى فيه — حتى لو حُذف لاحقاً. ضع .env في .gitignore منذ البداية.

تمرين مصغّر — اكتب السطر الذي يُضاف إلى .gitignore لمنع Git من أرشفة ملف الأسرار .env.

.env

السؤال 1: أي أمر يحوّل مجلداً عادياً إلى مستودع Git؟

a) git start

b) git init

c) git new

d) git create

السؤال 2: ما الترتيب الصحيح للمناطق الثلاث في Git؟

a) المستودع → التجهيز → مجلد العمل

b) مجلد العمل → التجهيز → المستودع المحلي

c) التجهيز → المستودع → مجلد العمل

d) مجلد العمل → المستودع → التجهيز

السؤال 3: لماذا يُستخدم git add؟

a) لإنشاء إيداع

b) لتجهيز تغييرات في منطقة التجهيز

c) لحذف ملف

d) لإرسال الشفرة إلى GitHub

السؤال 4: أيها رسالة إيداع جيدة؟

a) truc

b) wip

c) يصحّح الانهيار عند البدء إن غاب الإعداد

d) .

السؤال 5: لماذا نستخدم .gitignore؟

a) لتسريع الحاسوب

b) لمنع Git من أرشفة ملفات معيّنة (مؤقتة، أسرار، تبعيات)

c) لحذف السجل

d) لتجاهل الإيداعات

المطلوب

أنشئ مستودعاً محلياً، أضف ملفاً، تجاهل ملف سر، وقم بإيداعين نظيفين.

التصحيح — سلسلة الأوامر المتوقعة

# 1. إنشاء المجلد والدخول إليه
mkdir mon-premier-depot
cd mon-premier-depot

# 2. تهيئة المستودع
git init

# 3. إنشاء ملف محتوى و .gitignore
echo "# مشروعي" > README.md
echo ".env" > .gitignore
echo "SECRET=123" > .env        # يجب تجاهل هذا الملف

# 4. التحقق من الحالة (.env يجب ألا يظهر)
git status

# 5. الإيداع الأول
git add README.md .gitignore
git commit -m "يهيئ المشروع مع README و gitignore"

# 6. تعديل ثم إيداع ثانٍ
echo "وصف المشروع" >> README.md
git add README.md
git commit -m "يكمّل الوصف في README"

# 7. استشارة السجل
git log --oneline

النتيجة المتوقعة:

b2c3d4e يكمّل الوصف في README
a1b2c3d يهيئ المشروع مع README و gitignore

تحقق من أن .env لا يظهر أبداً في git status: هذا دليل أن .gitignore يعمل وأن سرك محمي.

النقاط التي يجب تذكّرها

1. ثلاث مناطق: مجلد العمل → التجهيز (git add) → المستودع المحلي (git commit).
2. git init ينشئ المستودع (مجلد .git/).
3. الإيداع لقطة + رسالة، مرتبط بإيداع الأب.
4. رسائل جيدة: أمر، واضحة، ذرّية، تفسّر لماذا.
5. .gitignore يحمي الأسرار ويستبعد الملفات غير المفيدة.

ما يلي

الدرس 07 — الفروع والسجل: العمل على عدة إصدارات بالتوازي دون كسر الإصدار الرئيسي.