तपाईंले कस्टम यूजर मडेल किन र कसरी प्रयोग गर्नुपर्छ?

Question

Accepted Answer

एक **कस्टम यूजर मडेल** 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` यूजर मडेलमा पूर्ण नियन्त्रण दिन्छ (जस्तै email-मात्र लगइनको लागि username पूर्णतः हटाउन) — बढी काम, तर अधिकतम लचकपन।

## यूजर मडेलको सही सन्दर्भ

```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 (authentication, admin, sessions) मा गहिरो सन्दर्भित छ र तपाईंको सम्पूर्ण डेटाबेसमा foreign keys द्वारा परिवर्तन गर्न जटिल, त्रुटि-प्रवण डेटा migrations आवश्यक हुन्छ।

यही कारण हो कि Django को आफ्नै दस्तावेज प्रत्येक नयाँ परियोजनाको लागि कस्टम यूजर मडेल दृढताइसाथ सुझाव दिन्छ, तात्कालीन आवश्यकता फरक पर्सेनै — यो भविष्यको migrations दुःस्वप्नको विरुद्ध बीमा हो।

यो महत्वपूर्ण समय सल्लाहभन्दा परे, कस्टम यूजर मडेलहरु कसरी सिर्जना गर्ने भनेर बुझ्न — **`AbstractUser`** Django को auth व्यवहार राख्न साधारण क्षेत्रहरु थप्नको लागि (सामान्य, सजिलो केस), र **`AbstractBaseUser`** email-आधारित लगइनलाई पूर्ण नियन्त्रणको लागि (username पूर्णतः हटाइयो) — वास्तविक अनुप्रयोग आवश्यकताहरु पूरा गर्नको लागि (अतिरिक्त यूजर क्षेत्रहरु, वैकल्पिक लगइन पहिचायकहरु, कस्टम auth) मूल्यवान हुन्छ।

समान रुपमा महत्वपूर्ण यूजर मडेलको **सही सन्दर्भ** गर्न जानिनु हो (`settings.AUTH_USER_MODEL` र `get_user_model()` मार्फत, कहिले पनि सीधा आयात नगर्ने) ताकि कोड जेनेकोसमा कस्टम मडेल कन्फिगर गरियो वर्क गर्छ।

लगभग हरेक वास्तविक अनुप्रयोगमा Django को पूर्वनिर्धारितहरुभन्दा परे यूजर-विशिष्ट आवश्यकताहरु हुन्छन् (र त्यीहरु पनि जो हुँदैनन् लचकपनको लाभ प्राप्त गर्छन्), र यो अगाडि स्थापना नगर्नुको खर्च यति उच्च हुन्छ कारण, कस्टम यूजर मडेलहरु बुझ्न — विशेषगरी परियोजा सुरु गर्दा एक स्थापना गर्नको अनिवार्यता — महत्वपूर्ण, व्यावहारिक-गम्भीर ज्ञान हो जुन सामान्य र गम्भीर परियोजा-स्तरको गलती रोक्छ, यसलाई Django उत्तम-अभ्यास ज्ञान को बारम्बार उद्धृत टुक्रा बनाइयो।