તમે કસ્ટમ યુઝર મોડેલ કેમ અને કેવી રીતે વાપરવું જોઈએ?

Question

Accepted Answer

A **custom user model** Django ના ડિફૉલ્ટ `User` ને બદલે તમારી એપ્લીકેશનની જરૂરિયાતો મુજબ તૈયાર કરે છે — ફીલ્ડ ઉમેરવા, લોગિન આઇડેન્ટિફાયર બદલવા (દા.ત. username ની જગ્યાએ email), અથવા વર્તન કસ્ટમાઇઝ કરવા માટે. ક્રિટિકલ, વારવાર રિપીટ કરવામાં આવતી સલાહ: કસ્ટમ યુઝર મોડેલ **પ્રોજેક્ટની શરૂઆતમાં** સેટ કરો, ભલે તમને હજુ ફેરફારોની જરૂર ન હોય, કારણ કે તેને બાદમાં બદલવું અત્યંત મુશ્કેલ છે.

## શા માટે: ડિફૉલ્ટ User મર્યાદિત છે અને બાદમાં બદલવો મુશ્કેલ છે

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

## બદલી શકો એવું ક્રિટિકલ કારણ આગળ કરવું

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

યह મુખ્ય વ્યવહારિક પાઠ છે: પ્રથમ દિવસે કસ્ટમ યુઝર મોડેલ સેટ કરવામાં લગભગ કોઈ ખર્ચ નથી, પરંતુ સ્થાપિત પ્રોજેક્ટમાં તેને ફિટ કરવું એક મોટું, ભૂલ-પ્રવણ પ્રયાસ છે — તેથી તમે તેને આગાહી તરીકે આગળ કરો છો.

## કેવું: AbstractUser વિસ્તૃત કરવું (સરળ રસ્તો)

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

`AbstractUser` Django ના બધા ડિફૉલ્ટ ફીલ્ડ અને auth મશીનરી રાખે છે — તમે માત્ર ફીલ્ડ ઉમેરો છો. સૌથી સરળ, સૌથી સામાન્ય પ્રવેશ.

## કેવું: AbstractBaseUser (સંપૂર્ણ નિયંત્રણ, દા.ત. email લોગિન)

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

`AbstractBaseUser` યુઝર મોડેલ પર સંપૂર્ણ નિયંત્રણ આપે છે (દા.ત. username પૂર્ણપણે દૂર કરીને email-માત્ર લોગિન માટે) — વધુ કામ, પરંતુ મહત્તમ લવચીકતા.

## યુઝર મોડેલને સાચો સંદર્ભ આપવો

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

હંમેશા યુઝર મોડેલને `settings.AUTH_USER_MODEL` (મોડેલમાં) અને `get_user_model()` (કોડમાં) દ્વારા સંદર્ભ આપો, ક્યારેય ડિફૉલ્ટ `User`ને સીધો ઇમ્પોર્ટ કરતા નહીં — જેથી તમારો કોડ કસ્ટમ મોડેલ સાથે કામ કરે.

## શા માટે અગત્ય છે

કસ્ટમ યુઝર મોડેલ વાપરવું એક મહત્વપૂર્ણ જ્ઞાન છે જેમાં એક ક્રિટિકલ, વારવાર-જોર આપવામાં આવતો વ્યવહારિક પાઠ છે જે દરેક Django ડેવલપરે આંતરિક કરવો જોઈએ: **દરેક પ્રોજેક્ટની શરૂઆતમાં તેને સેટ કરો**.

આ બાબત આટલી મહત્વપૂર્ણ છે તેનું કારણ છે મુશ્કેલીમાં આ તીવ્ર અસમતા — પ્રથમ દિવસે કસ્ટમ યુઝર મોડેલ વ્યાખ્યાયિત કરવું (એમ્પ્ટી `AbstractUser` સબક્લાસ પણ) લગભગ કોઈ ખર્ચ નથી અને અમૂલ્ય લવચીકતા આપે છે, જ્યારે પ્રોજેક્ટમાં migrations અને ડેટા થયા પછી કસ્ટમ યુઝર મોડેલમાં સ્વિચ કરવું અત્યંત પીડાદાયક અને જોખમી છે, કારણ કે User મોડેલ Django (પ્રામાણિકતા, admin, sessions) માં ઊંડાણપૂર્વક સંદર્ભિત છે અને તમારા આખા ડેટાબેસમાં ફોરેન કીઝ દ્વારા, જેમાં જટિલ, ભૂલ-પ્રવણ ડેટા migrations ની જરૂર છે બદલવા માટે.

એટલે Django ની પોતાની ડોક્યુમેન્ટેશન દરેક નવી પ્રોજેક્ટ માટે કસ્ટમ યુઝર મોડેલની મજબુતાઈ સાથે ભલામણ કરે છે, તાત્કાલિક જરૂરતમાં ફેર વગર — આ ભવિષ્યના migration અવસર માટે બીમો છે.

આ ક્રિટિકલ ટાઇમિંગ સલાહ ઉપરાંત, કસ્ટમ યુઝર મોડેલ કેવી રીતે બનાવવું તે સમજવું — **`AbstractUser`** ફીલ્ડ ઉમેરવા માટે Django ની auth વર્તન રક્ષણ કર્યા વગર (સામાન્ય, સરળ કેસ), અને **`AbstractBaseUser`** email-આધારિત લોગિનની જેમ સંપૂર્ણ નિયંત્રણ માટે (username પૂર્ણપણે દૂર કર્યા) — વાસ્તવિક એપ્લીકેશન જરૂરિયાતો (વધારાના યુઝર ફીલ્ડ, વૈકલ્પિક લોગિન આઇડેન્ટિફાયર, કસ્ટમ auth) પૂરી કરવા માટે મૂલ્યવાન છે.

સમાન રીતે મહત્વપૂર્ણ છે યુઝર મોડેલને સાચો સંદર્ભ આપવાનું જ્ઞાન રાખવું (`settings.AUTH_USER_MODEL` અને `get_user_model()` દ્વારા, કોઈ સીધો import નહીં) જેથી કોડ જે કોઈ પણ યુઝર મોડેલ કોન્ફિગર કરેલ હોય તેની સાથે કામ કરે.

કારણ કે લગભગ દરેક વાસ્તવિક એપ્લીકેશનમાં Django ના ડિફૉલ્ટ ઉપરાંત યુઝર-વિશેષ જરૂરિયાતો છે (અને જે તે તપાસ કરતા નથી તેઓ પણ લવચીકતાથી લાભ થાય છે), અને કારણ કે આ શરૂઆતમાં સેટ ન કરવાનો ખર્ચ આટલો વધારે છે, કસ્ટમ યુઝર મોડેલ સમજવું — ખાસ કરીને પ્રોજેક્ટ શરૂ કરતી વખતે એક સ્થાપિત કરવાની આવશ્યકતા — મહત્વપૂર્ણ, વ્યવહારીક-ક્રિટિકલ જ્ઞાન છે જે એક સામાન્ય અને ગંભીર પ્રોજેક્ટ-સ્તરીય ભૂલ રોકે છે, તેને Django શ્રેષ્ઠ-પ્રથા જ્ઞાનનો વારવાર-ટાંકેલ ભાગ બનાવે છે.