Mengapa dan bagaimana Anda harus menggunakan model pengguna khusus?

Question

Accepted Answer

Sebuah **model pengguna khusus** menggantikan `User` default Django untuk memenuhi kebutuhan aplikasi Anda — menambahkan field, mengubah identifikasi login (misalnya email daripada username), atau menyesuaikan perilaku. Saran penting yang sering diulang: atur model pengguna khusus **di awal proyek**, bahkan jika Anda tidak memerlukan perubahan sekarang, karena mengubahnya nanti sangat menyakitkan.

## Mengapa ini penting

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

## Alasan kritis untuk melakukannya TERLEBIH DAHULU

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

Ini adalah pelajaran praktis kunci: hampir tidak ada biaya untuk menyiapkan model pengguna khusus di hari pertama, tetapi menambahkan model yang sudah ada ke proyek yang sudah mapan adalah usaha yang besar dan rawan kesalahan — jadi Anda melakukannya di awal sebagai asuransi.

## Cara: memperluas AbstractUser (cara mudah)

```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` mempertahankan semua field default Django dan mesin auth — Anda hanya menambahkan field. Pendekatan paling sederhana dan paling umum.

## Cara: AbstractBaseUser (kontrol penuh, misalnya login 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` memberikan kontrol penuh atas model pengguna (misalnya menghapus username sepenuhnya untuk login email saja) — lebih banyak pekerjaan, tetapi fleksibilitas maksimal.

## Mereferensikan model pengguna dengan benar

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

Selalu referensikan model pengguna melalui `settings.AUTH_USER_MODEL` (di model) dan `get_user_model()` (di kode), jangan pernah dengan mengimpor `User` default secara langsung — sehingga kode Anda bekerja dengan model khusus.

## Mengapa ini penting

Menggunakan model pengguna khusus adalah pengetahuan penting dengan pelajaran praktis yang kritis dan sering ditekankan yang harus diinternalisasi setiap pengembang Django: **atur di awal setiap proyek**.

Alasan ini sangat penting adalah asimetri kesulitan yang parah — mendefinisikan model pengguna khusus di hari pertama (bahkan subkelas `AbstractUser` kosong) hampir tidak ada biayanya dan memberikan fleksibilitas yang sangat berharga, sementara beralih ke model pengguna khusus *setelah* proyek memiliki migrasi dan data sangat menyakitkan dan berisiko, karena model User direferensikan secara mendalam di seluruh Django (otentikasi, admin, sesi) dan oleh kunci asing di seluruh database Anda, memerlukan migrasi data yang kompleks dan rawan kesalahan untuk mengubah.

Inilah mengapa dokumentasi Django sendiri sangat merekomendasikan model pengguna khusus untuk setiap proyek baru, terlepas dari kebutuhan segera — ini adalah asuransi terhadap mimpi buruk migrasi di masa depan.

Beyond this critical timing advice, understanding *how* to create custom user models — **`AbstractUser`** untuk sekadar menambahkan field sambil mempertahankan perilaku auth Django (kasus umum dan mudah), dan **`AbstractBaseUser`** untuk kontrol penuh seperti login berbasis email (menghapus username sepenuhnya) — berharga untuk memenuhi persyaratan aplikasi nyata (field pengguna tambahan, identifikasi login alternatif, auth khusus).

Sama pentingnya adalah mengetahui untuk **mereferensikan model pengguna dengan benar** (melalui `settings.AUTH_USER_MODEL` dan `get_user_model()`, jangan pernah impor langsung) sehingga kode bekerja dengan model pengguna apa pun yang dikonfigurasi.

Karena hampir setiap aplikasi nyata memiliki kebutuhan spesifik pengguna di luar default Django (dan bahkan yang tidak mendapat manfaat dari fleksibilitas), dan karena biaya tidak menyiapkan ini sejak awal sangat tinggi, memahami model pengguna khusus — terutama imperasi untuk membentuk model pada awal proyek — adalah pengetahuan penting secara praktis dan kritis yang mencegah kesalahan tingkat proyek yang umum dan serius, menjadikannya bagian dari kebijakan best-practice Django yang sering dikutip.