Developer Foundations

1. Terminal & Command Line

الشرح: الـ Terminal هو الطريقة الأساسية للتفاعل مع نظام التشغيل بأوامر نصية بدل الواجهة الرسومية — كل أدوات التطوير (Git, Python, Docker) بتتحكم فيها عن طريق Terminal.

أوامر أساسية:

pwd            # عرض المسار الحالي
ls / dir       # عرض محتويات الفولدر
cd folder_name # الدخول لفولدر
mkdir new_folder
touch file.py  # إنشاء ملف (Linux/Mac)
rm file.py     # حذف ملف
cat file.py    # عرض محتوى الملف

2. Linux Basics

الشرح: غالبية السيرفرات اللي هتنشر (Deploy) عليها مشاريعك بتشتغل بـ Linux. فهم أوامره الأساسية ضروري: sudo, apt, chmod, ps, top, grep, find.

sudo apt update && sudo apt upgrade
chmod +x script.sh   # إعطاء صلاحية تنفيذ
grep "error" logs.txt

3. VS Code

الشرح: أشهر محرر أكواد مجاني ومرن، بيدعم Extensions بتسهّل التطوير (Python, GitLens, Prettier, Docker). إضافات مهمة لمهندس الأتمتة: Python, Pylance, GitLens, REST Client, Docker.

4. تنظيم المشاريع (Project Structure)

الشرح: هيكل منظم يخلي المشروع قابل للصيانة والتوسع.

my_project/
├── src/
│   ├── main.py
│   └── utils.py
├── tests/
├── .env
├── .gitignore
├── requirements.txt
└── README.md

5. Git — الأساسيات

الشرح: نظام تحكم بالإصدارات (Version Control) بيسجل كل تغيير في الكود، ويخليك ترجع لأي نسخة سابقة، وتشتغل مع فريق من غير ما تدوس على شغل بعض.

git init
git status
git add file.py
git add .
git commit -m "Add customer processing script"
git log

6. GitHub

الشرح: منصة سحابية لاستضافة مستودعات Git، وبتسمح بالتعاون بين المطورين ومشاركة الكود ونشره.

git remote add origin https://github.com/username/repo.git
git push -u origin main
git pull origin main

7. Commits

الشرح: كل Commit هو "لقطة" (Snapshot) لحالة الكود في وقت معين، مع رسالة توضح إيه اللي اتغير. أفضل ممارسة: اكتب رسائل واضحة ومختصرة (Conventional Commits).

feat: add WhatsApp webhook handler
fix: handle empty response from API
docs: update README with setup steps

8. Branches

الشرح: فرع منفصل من الكود تقدر تشتغل عليه من غير ما تأثر على النسخة الرئيسية (main)، مفيد لما تطور ميزة جديدة أو تجرب حاجة.

git branch feature/whatsapp-integration
git checkout feature/whatsapp-integration
# أو في أمر واحد:
git checkout -b feature/whatsapp-integration

9. Pull Requests

الشرح: طلب رسمي لدمج التغييرات من فرع (Branch) لفرع تاني (غالبًا main)، بيسمح بمراجعة الكود قبل الدمج (Code Review) — أساسي في العمل الجماعي.

10. Environment Variables & .env

الشرح: (تفصيل تكميلي لما اتعلمته في Level 02) — أهم قاعدة: ملف .env لازم يتحط في .gitignore عشان متترفعش المفاتيح السرية على GitHub بالخطأ.

# .gitignore
.env
__pycache__/
venv/
*.pyc

11. إدارة Dependencies

الشرح: تسجيل كل المكتبات اللي المشروع محتاجها في ملف واحد عشان أي حد يقدر يجهز نفس البيئة.

pip freeze > requirements.txt
pip install -r requirements.txt

12. Debugging & قراءة Error Messages

الشرح: كل خطأ في بايثون بيديك Traceback بيوضح: نوع الخطأ (Exception Type)، رسالة توضيحية، والسطر اللي حصل فيه بالظبط. اقرأ من "تحت لفوق" — آخر سطر هو الأهم.

Traceback (most recent call last):
  File "main.py", line 12, in <module>
    result = 10 / 0
ZeroDivisionError: division by zero

13. Logging

الشرح: بدل استخدام print() في مشروع حقيقي، استخدم مكتبة logging عشان تسجل الأحداث بمستويات مختلفة (INFO, WARNING, ERROR) وتقدر تتبع المشكلة في الإنتاج (Production).

import logging
logging.basicConfig(level=logging.INFO, filename="app.log")
logging.info("Process started")
logging.error("API call failed")

14. Documentation

الشرح: توثيق الكود والمشروع بيسهّل الصيانة والتعاون. أساسيات: README.md واضح، Docstrings في الدوال.

def calculate_total(price: float, quantity: int) -> float:
    """
    يحسب السعر الإجمالي لطلب معين.
    Args:
        price: سعر الوحدة
        quantity: الكمية
    Returns:
        السعر الإجمالي شامل الضريبة
    """
    return price * quantity * 1.14

15. أساسيات Clean Code

الشرح: مبادئ أساسية لكتابة كود مقروء وقابل للصيانة:

• أسماء متغيرات ودوال واضحة ومعبّرة (get_customer_by_id بدل func1).
• كل دالة تعمل حاجة واحدة بس (Single Responsibility).
• تجنب تكرار الكود (DRY — Don't Repeat Yourself).
• علّق (Comment) على "ليه" مش على "إيه" (الكود نفسه بيوضح إيه).
• خلي الدوال قصيرة (لو الدالة أطول من شاشة واحدة، فكر تقسمها).