كيف تعمل النماذج والمجمّع الكائني-العلائقي (ORM)؟

Question

Accepted Answer

**النموذج** (Model) هو فئة Python تحدد بنية بياناتك — يرسم كل نموذج إلى جدول قاعدة بيانات، وكل خاصية إلى عمود. **المجمّع الكائني-العلائقي (ORM)** يسمح لك بالتفاعل مع قاعدة البيانات باستخدام كائنات وطرق Python بدلاً من كتابة SQL خام.

## تعريف النموذج

```python
from django.db import models

class Article(models.Model):
    title = models.CharField(max_length=200)       # → VARCHAR column
    body = models.TextField()                        # → TEXT column
    published = models.BooleanField(default=False)
    created_at = models.DateTimeField(auto_now_add=True)  # set on creation
    views = models.IntegerField(default=0)

def __str__(self):
        return self.title                            # readable representation (admin, shell)
```

يرسم كل حقل في النموذج إلى عمود قاعدة بيانات بنوع مناسب. يؤدي تشغيل الهجرات (Migrations) إلى إنشاء الجدول المقابل — لن تكتب `CREATE TABLE` بنفسك أبداً.

## عمليات CRUD مع ORM (بدون SQL)

```python
# CREATE
article = Article.objects.create(title="Hello", body="...")

# READ — query with Python methods
Article.objects.all()                            # all rows → SELECT *
Article.objects.get(id=1)                         # one row by primary key
Article.objects.filter(published=True)            # WHERE published = true
Article.objects.filter(title__icontains="django") # WHERE title ILIKE '%django%'
Article.objects.exclude(views=0).order_by("-created_at")  # complex queries, chained

# UPDATE
article.title = "Updated"
article.save()
Article.objects.filter(published=False).update(published=True)  # bulk update

# DELETE
article.delete()
```

يترجم ORM استدعاءات Python هذه إلى SQL تلقائياً. عمليات البحث عن الحقول (`__icontains`، `__gte`، `__in`، إلخ) تعبر عن شروط WHERE بطريقة Pythonic.

## لماذا ORM؟ الفوائد والمقارنات

```text
✓ Write database code in Python — no SQL, more readable, less error-prone
✓ Database-agnostic — the same code works on PostgreSQL, MySQL, SQLite
✓ SECURITY — parameterized queries by default → prevents SQL injection
✓ Integrates with migrations, admin, forms (define the model once)
⚠️ Trade-off: can generate inefficient queries (e.g. N+1) if used carelessly —
   sometimes you need select_related/prefetch_related or raw SQL for complex cases
```

## النماذج هي المصدر الوحيد للحقيقة (DRY)

```text
One model definition drives: the database schema (migrations), the admin interface,
ModelForms, and serializers (DRF) — define it once, reuse everywhere.
```

## لماذا يهم هذا

النماذج و ORM هي ركيزة Django — إنها الطريقة التي تحدد بها وتعمل مع بيانات تطبيقك، وهي قلب معظم تطبيقات الويب.

فهمها أمر ضروري معرفة يومية: تحدد النماذج بنية بياناتك (ترسم الفئات إلى الجداول، والخصائص إلى الأعمدة) وتخدم كمصدر **وحيد للحقيقة** يقود مخطط قاعدة البيانات، وواجهة المسؤول، والنماذج، وفئات API (فلسفة DRY).

يسمح لك ORM بكتابة عمليات قاعدة البيانات بلغة Python نظيفة وقابلة للقراءة **بدلاً من SQL**، مع فوائد كبيرة: نقل قاعدة البيانات (يعمل نفس الكود على قواعد بيانات مختلفة)، والتكامل الوثيق مع بقية Django، والأهم من ذلك **الأمان** (يستخدم استعلامات معاملات بشكل افتراضي، مما يمنع حقن SQL).

معرفة كيفية تعريف النماذج بحقول مناسبة، وإجراء عمليات CRUD، والاستعلام باستخدام بناء جملة البحث في ORM أمر أساسي لبناء أي تطبيق Django.

من المهم بنفس القدر الوعي بـ **المقارنة** الخاصة بـ ORM — أن الاستعلامات الملائمة يمكن أن تصبح غير فعالة (مشكلة N+1) دون عناية — مما يؤدي إلى تقنيات التحسين.

طبقة النموذج/ORM هي المكان الذي تقضي فيه تطبيقات Django الكثير من منطقها، مما يجعلها مادة أساسية يجب إتقانها.