Si funksionojnë modelet dhe ORM-ja?

Question

Accepted Answer

Një **model** është një klasë Python që përcakton strukturën e të dhënave tuaja — çdo model harton në një tabelë baze të dhënash, dhe çdo atribut në një kolumnë. **ORM-ja (Object-Relational Mapper)** ju lejon të bashkëveproni me bazën e të dhënash duke përdorur objekte dhe metoda Python në vend të shkrimit të SQL-it të papërpunuar.

## Përcaktimi i një modeli

```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)
```

Çdo fushë modeli harton në një kolumnë baze të dhënash me një lloj të përshtatshëm. Ekzekutimi i migracioneve krijon tabelën korresponduese — asnjëherë nuk shkruani `CREATE TABLE` vetë.

## CRUD me ORM-në (pa 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-ja përkthehet këto thirje Python në SQL automatikisht. Kërkimet në fushë (`__icontains`, `__gte`, `__in`, etj.) shprehin kushtet WHERE në mënyrë Pythonike.

## Pse një ORM? Përfitimet dhe kompromisët

```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
```

## Modelet janë burimi i vetëm i së vërtetës (DRY)

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

## Pse ka rëndësi

Modelet dhe ORM-ja janë qendrore në Django — ato janë se si përcaktoni dhe punoni me të dhënat e aplikacionit tuaj, i cili është zemra e shumicës së aplikacioneve të uebit.

Kuptimet e tyre është njohuri thelbësore e përditshme: modelet përcaktojnë strukturën e të dhënave tuaja (hartimin e klasave në tabela, atributeve në kolona) dhe shërbejnë si **burimi i vetëm i së vërtetës** që drejtojnë skemën e bazës së të dhënash, ndërfaqen admin, formularët dhe përgjigjet e API-t (filozofia DRY).

ORM-ja ju lejon të shkruani operacione baze të dhënash në Python të pastër dhe të lexueshëm **në vend të SQL**, me përfitime të mëdha: portabilitetin e bazës së të dhënash (kodi i njëjtë funksionon në baza të ndryshme të dhënash), integrimin e ngushtë me pjesën tjetër të Django, dhe në mënyrë vendimtare **sigurimin** (përdor pyetje të parametrizuara si parazgjedhje, duke parandaluar SQL injection).

Dija se si të përcaktohen modelet me fusha të përshtatshme, të kryhen operacione CRUD, dhe të bëhet pyetje me sintaksën e kërkimit të ORM-së është themelore për ndërtimin e ndonjë aplikacioni Django.

Njësoj i rëndësishëm është ndërgjegjja e **kompromisit** të ORM-së — se pyetjet e përshtatshme mund të bëhen joefikase (problemi N+1) pa kujdes — i cili çon në teknika optimizimi.

Shtresa e modelit/ORM-je është ajo ku aplikacionet Django shpenzojnë shumë të logjikës së tyre, duke e bërë atë material bazë, që duhet të zotërohet.