آپ کو کسٹم یوزر ماڈل کو کیوں اور کیسے استعمال کرنا چاہیے؟

Question

Accepted Answer

ایک **کسٹم یوزر ماڈل** Django کے ڈیفالٹ `User` کی جگہ لیتا ہے تاکہ آپ کی ایپلیکیشن کی ضروریات کو پورا کیا جا سکے — فیلڈز شامل کرنا، لاگ ان کی شناخت تبدیل کرنا (مثال کے طور پر صارف نام کی جگہ ای میل)، یا رویہ کو اپنی مرضی کے مطابق بنانا۔ اہم، بار بار دیا جانے والا مشورہ: کسٹم یوزر ماڈل **بالکل شروعات میں** سیٹ اپ کریں، یہاں تک کہ اگر آپ کو ابھی تبدیلیوں کی ضرورت نہ ہو، کیونکہ اسے بعد میں تبدیل کرنا انتہائی دردناک ہے۔

## کیوں: ڈیفالٹ 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 (مکمل کنٹرول، مثال کے طور پر ای میل لاگ ان)

```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` یوزر ماڈل پر مکمل کنٹرول دیتا ہے (مثال کے طور پر صرف ای میل لاگ ان کے لیے صارف نام کو مکمل طور پر ہٹانا) — زیادہ کام، لیکن زیادہ سے زیادہ لچک۔

## یوزر ماڈل کو صحیح طریقے سے حوالہ دینا

```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` کو import نہ کریں — تاکہ آپ کا کوڈ کسٹم ماڈل کے ساتھ کام کرے۔

## یہ کیوں اہم ہے

کسٹم یوزر ماڈل کا استعمال اہم علم ہے جس میں ایک اہم، بار بار دیا جانے والا عملی سبق ہے جو ہر Django ڈیولپر کو سمجھ لینا چاہیے: **ہر منصوبے کی بالکل شروعات میں اسے سیٹ اپ کریں**۔

یہ بات اتنی اہم کیوں ہے اس کی وجہ مشکل میں شدید عدم توازن ہے — پہلے دن کسٹم یوزر ماڈل کی تعریف (یہاں تک کہ خالی `AbstractUser` subclass) کی لگ بھگ کوئی قیمت نہیں ہے اور بیش قیمت لچک فراہم کرتی ہے، جبکہ منصوبے میں migrations اور ڈیٹا کے بعد کسٹم یوزر ماڈل میں تبدیل کرنا انتہائی مشکل اور خطرناک ہے، کیونکہ User ماڈل Django میں گہری طور پر حوالہ دیا جاتا ہے (authentication، admin، sessions) اور پورے ڈیٹا بیس میں foreign keys کے ذریعے، جس میں پیچیدہ، غلطی کا شکار ڈیٹا migrations کی ضرورت ہے۔

یہی وجہ ہے کہ Django کی اپنی documentation ہر نیے منصوبے کے لیے کسٹم یوزر ماڈل کی سختی سے سفارش کرتی ہے، فوری ضرورت سے قطع نظر — یہ مستقبل کی migration nightmare کے خلاف بیمہ ہے۔

اس اہم ٹائمنگ کی سفارش سے ہٹ کر، کسٹم یوزر ماڈلز کو بنانے کا طریقہ سمجھنا — **`AbstractUser`** صرف فیلڈز شامل کرنے کے لیے Django کے auth رویے کو برقرار رکھتے ہوئے (عام، آسان صورت)، اور **`AbstractBaseUser`** مکمل کنٹرول کے لیے جیسے email-based login (صارف نام کو مکمل طور پر ہٹانا) — حقیقی ایپلیکیشن کی ضروریات کو پورا کرنے کے لیے قیمتی ہے (اضافی یوزر فیلڈز، متبادل لاگ ان شناخت کنندہ، کسٹم auth)۔

یوزر ماڈل کو صحیح طریقے سے حوالہ دینے کا علم یکساں اہم ہے (`settings.AUTH_USER_MODEL` اور `get_user_model()` کے ذریعے، براہ راست import کبھی نہیں) تاکہ کوڈ جو بھی یوزر ماڈل ترتیب دی گئی ہو اس کے ساتھ کام کرے۔

کیونکہ لگ بھگ ہر حقیقی ایپلیکیشن کی Django کے ڈیفالٹ سے ماوری یوزر سے متعلق ضروریات ہیں (اور یہاں تک کہ جو ضروریات نہیں رکھتے وہ بھی لچک سے فائدہ اٹھاتے ہیں)، اور کیونکہ اس کو جلدی سیٹ نہ کرنے کی قیمت اتنی زیادہ ہے، کسٹم یوزر ماڈلز کو سمجھنا — خاص طور پر منصوبے کی شروعات میں ایک قائم کرنے کی ضرورت — اہم، عملی طور پر نازک علم ہے جو ایک عام اور سنگین منصوبے کی سطح کی غلطی سے بچاتا ہے، اسے Django کی بہترین عملی حکمت کا بار بار حوالہ دیا جانے والا ٹکڑا بناتے ہوئے۔