Cén fáth agus conas ba chóir duit fréamhúsáideoir saincheaptha a úsáid?

Question

Accepted Answer

Cuireann **fréamhúsáideoir saincheaptha** ionad an `User` réamhshocraithe de Django — ag cur réimsí leis, ag athrú an aitheantóir logáil isteach (m.sh. ríomhphost in ionad ainm úsáideora), nó ag cur iompraíochta in ord. An comhairle chriticiúil, athdhéanta: socraigh fréamhúsáideoir saincheaptha **ag an tús an-tapa** de thionscadal, fiú mura bhfuil athruithe de dhíth ort fós, mar is geal-dhona atá sé a athrú níos déanaí.

## Cén fáth: tá an User réamhshocraithe teoranta agus deacair a athrú níos déanaí

```text
The default User has fixed fields (username, email, first/last name) and uses
USERNAME as the login field. Real apps often need:
  ✓ Email-based login (no username)
  ✓ Extra fields (phone, avatar, role, preferences) on the user itself
  ✓ Custom authentication behavior
```

## An fáth criticiúil é a dhéanamh AR AN DTÚS

```text
⚠️ Changing the user model AFTER migrations exist is VERY hard — the User model is
   referenced by auth, admin, sessions, foreign keys throughout the database.
   Swapping it later requires complex, risky data migrations.
→ ALWAYS define a custom user model at project START (before the first migration),
   even an empty one, so you can extend it freely later. Django's docs strongly
   recommend this for EVERY new project.
```

Is í seo an phríomhleacht phraiticiúil: cosnaíonn sé beagnach a dhada a bhunú fréamhúsáideoir saincheaptha ar an lá a haon, ach a chur ar ais ar thionscadal bunaithe is gníomhaireacht mhór, midhéanann-dhírithe — mar sin a dhéanann tú os cionn an chosaint.

## Conas: ag síneadh AbstractUser (an bealach éasca)

```python
# models.py — add fields, keep Django's auth behavior
from django.contrib.auth.models import AbstractUser

class User(AbstractUser):
    phone = models.CharField(max_length=20, blank=True)
    avatar = models.ImageField(upload_to="avatars/", blank=True)
    is_premium = models.BooleanField(default=False)
```

```python
# settings.py — tell Django to use it
AUTH_USER_MODEL = "myapp.User"
```

Coimeádann `AbstractUser` gach réimse réamhshocraithe Django agus meaisín fíordheimhnithe — ní dhéanann tú ach réimsí a chur leis. An cur chuige is simplí, is coitianta.

## Conas: AbstractBaseUser (smacht iomlán, m.sh. logáil isteach ríomhphoist)

```python
from django.contrib.auth.models import AbstractBaseUser, BaseUserManager, PermissionsMixin

class User(AbstractBaseUser, PermissionsMixin):
    email = models.EmailField(unique=True)
    USERNAME_FIELD = "email"          # log in with EMAIL instead of username
    REQUIRED_FIELDS = []
    objects = CustomUserManager()     # a manager defining create_user/create_superuser
```

Tugann `AbstractBaseUser` smacht iomlán ar an fhréamhúsáideoir (m.sh. ainm úsáideora a bhaint ar fad le haghaidh logáil isteach ríomhphoist amháin) — níos mó oibre, ach fíorfhillteacht uasta.

## An fhréamhúsáideoir a athrá i gceart

```python
from django.conf import settings
from django.contrib.auth import get_user_model

# in models — reference via settings.AUTH_USER_MODEL
author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)

# in code — get the active user model dynamically
User = get_user_model()              # NOT a direct import of the default User
```

Tagargh an fhréamhúsáideoir i gcónaí trí `settings.AUTH_USER_MODEL` (i múnlaí) agus `get_user_model()` (i gcód), ní thríd an `User` réamhshocraithe a iompórtáil go díreach — ionas go n-oibríonn do chód leis an fhréamhúsáideoir shaincheaptha.

## Cén fáth a bhíonn tábhacht ann

Is eolas tábhachtach a bhaineann le fréamhúsáideoir saincheaptha, agus leacht criticiúil, minic-bhréithnithe praiticiúil atá gach forbróir Django ba chóir a dhúraigint istigh: **socraigh sé ag an tús gach tionscadal**.

Is é an fáth a bhíonn an-tábhacht ar seo ná an t-éagothroime thromchúiseach i ndifríochta — fréamhúsáideoir saincheaptha a thuigeadh ar lá a haon (fiú a bheith folamh `AbstractUser` fofhaicsinne) cosnaíonn sé beagnach a dhada agus soláthraíonn sé fíorfhillteacht luachmhara, cé go bhfuil athrú ar fhréamhúsáideoir saincheaptha *tar éis* go bhfuil imircí agus sonraí ag an tionscadal tromchúiseach agus rioscrach, mar go bhfuil an User líonn bhreac ar fud Django (fíordheimhnithe, riarachán, seisiúin) agus ag eochracha eachtranna ar fud do bhhunachar sonraí ar fad, agus géilleadh do imircí sonraí casta, midhéanann-dhírithe a athrú.

Is dá bharr sin a bhíonn a dhíoladh a thíorunn fréamhúsáideoir saincheaptha do gach tionscadal nua — beag beann ar dhíth láithreach — ar fhonic do chosaint ar dhrochmhirir imircí níos déanaí.

Tuig an chaoi cheart a chruthú fréamhúsáideoir saincheaptha — **`AbstractUser`** ar shíneadh réimsí go simplí ag coimeád do Django's auth iompraíochta (an chás coitianta, éasca), agus **`AbstractBaseUser`** ar smacht iomlán cosúil le logáil isteach ríomhphoist (ainm úsáideora a bhaint ar fad) — is bainteach do chumais fhíor feidhmchlár (réimsí úsáideora sprioc-dhírithe, aitheantóirí logáil isteach eile, fíordheimhnithe saincheaptha).

Is chomh tábhachtach a bheith ar eolas gur an fhréamhúsáideoir a thagargh i gceart (trí `settings.AUTH_USER_MODEL` agus `get_user_model()`, ní a bhaint amach go díreach) ionas go n-oibríonn cód le go bhfuil an fhréamhúsáideoir a chumraíodh.

For gur is gach fíor fheidhmchlár ar dhíth ar úsáideora-sprioc sprioc-dhírithe thar na réamhshocruithe Django (agus fiú iad sin nach bhfuil de dhíth ar bhaint as an fhillteacht), agus as go bhfuil an costas ar gan seo a bhunú go tapa chomh ard, tá tuiscint ar fhréamhúsáideoir saincheaptha — go háirithe an beart a bhunú ar thús tionscadal — tábhachtach, geal-chriticiúil eolas praiticiúil a dhéanann cosc ar mhearlach coitianta agus dromchéile tionscadal-leibhéal, é a dhéanamh de phíosa minic-lua Django best-cleachtas eagna.