تخطَّ إلى المحتوى
Uttra

ما هو المستودع (Repository)؟

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

آخر تحديث:

المستودع (Repository (Repo)): المستودع هو مجلد مشروع يديره نظام Git، يحتوي الملفات الحالية وتاريخ كل تعديلاتها على شكل إيداعات. يمكن نسخه ومزامنته بين الأجهزة والمنصات مع الحفاظ على التاريخ كاملًا.

التعريف المختصر

المجلد العادي يعرف شكل الملفات الآن فقط. المستودع يعرف شكلها الآن وكل شكل كانت عليه من قبل. داخله مجلد مخفي اسمه .git يحفظ هذا التاريخ، ولهذا إذا نسخت المستودع إلى جهاز آخر انتقل التاريخ معه.

شرح مبسط

أربع كلمات تكفيك لفهم أي حديث عن المستودعات:

المصطلحمعناهمثال
إيداع (Commit)لقطة محفوظة للتعديلات مع رسالة تشرحها«إضافة صفحة الأسعار»
فرع (Branch)خط عمل منفصل يتفرع من الأساسيفرع لتجربة تصميم جديد
دمج (Merge)إدخال تعديلات فرع إلى الفرع الأساسيبعد اعتماد التصميم الجديد
استنساخ (Clone)نسخ مستودع كامل بتاريخه إلى جهاز آخرمطور جديد ينضم للفريق

هذه أوامر الاستخدام اليومي كما يكتبها المطور في الطرفية:

دورة عمل يومية مع مستودع
git clone https://github.com/your-company/booking-app.git
cd booking-app
git checkout -b add-loyalty-points
# ... edit files ...
git add .
git commit -m "Add loyalty points to customer profile"
git push origin add-loyalty-points

وهناك ملف صغير مهم جدًا اسمه .gitignore: قائمة بما يجب ألا يدخل المستودع أبدًا، مثل ملف المفاتيح ومجلد المكتبات الضخم وقواعد البيانات المحلية:

.gitignore
.env
node_modules/
*.db
dist/

مثال من السوق السعودي

شركة ناشئة في الخبر تبني تطبيقًا لحجز مغاسل السيارات المتنقلة، وفيها مطوران. الأول يعمل على نقاط الولاء في فرع، والثاني يصلح خطأ في صفحة الدفع في فرع آخر. الفرع الأساسي يبقى دائمًا هو النسخة المستقرة التي تُنشر. حين ينتهي كل واحد يدمج فرعه بعد مراجعة سريعة. وفي أحد الأيام رفع أحدهما ملف .env بالخطأ وفيه مفتاح بوابة الدفع، فاضطروا إلى إلغاء المفتاح فورًا وإصدار مفتاح جديد، لأن حذف الملف من الإيداع التالي لا يحذفه من التاريخ. بعدها أضافوا .env إلى .gitignore من اليوم الأول في كل مشروع.

ولماذا يهمك المستودع إن لم تكن مبرمجًا؟ لأنه سجل محاسبي للكود: إذا قال لك مطور إن ميزة ما «جاهزة منذ أسبوع» تستطيع أن ترى الإيداع وتاريخه. وإذا ظهر خطأ بعد تحديث، يعرف أي مطور بالضبط ما الذي تغير بين النسخة السليمة والنسخة المعطوبة، فيصلح في دقائق بدل أن يبحث في المشروع كله. وحين تنتقل بين أدوات البناء أو بين فرق التطوير، المستودع هو الشيء الوحيد الذي ينتقل معك كاملًا.

كيف يظهر في أوترا

مشروعك في أوترا وكوده ملكك: تدفعه إلى مستودع GitHub خاص بك من تبويب «GitHub»، أو تنزّله وتنسخه عبر الترمينال، فلست محبوسًا داخل المنصة. وإن كان لديك مستودع قائم، تستورده عند إنشاء مشروع جديد وتكمل عليه بطلباتك، وأوامر git مثل git clone و git pull متاحة في الترمينال. وإن كنت قادمًا من أداة أخرى فاقرأ دليل الانتقال من Replit أو دليل مزامنة GitHub.

مصطلحات ذات صلة

أسئلة شائعة

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

صفحات ذات صلة