[250210] Django Admin 정리~

Django Admin이란?

1. Django Admin 정의

Django Admin은 Django에서 제공하는 자동화된 관리자 인터페이스로, 데이터베이스 모델을 쉽게 관리할 수 있도록 해준다.

개발자는 Django Admin을 통해 데이터를 추가, 수정, 삭제, 검색할 수 있으며, 이를 통해 별도의 관리 페이지를 개발하지 않고도

효율적인 데이터 관리를 할 수 있다.

Django 프로젝트를 생성하면 `admin` 앱이 기본적으로 포함되어 있으며, 최소한의 설정으로 바로 사용할 수 있다.

 

2. Django Admin 활성화하기

1️⃣ `admin` 앱이 설치되어 있는지 확인

Django의 `INSTALLED_APPS` 설정에 `django.contrib.admin`이 포함되어 있어야 한다.

# settings.py
INSTALLED_APPS = [
    'django.contrib.admin',  # 관리자 기능
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'myapp',  # 사용자 앱
]

2️⃣ 관리자 계정 생성

Django Admin을 사용하려면 슈퍼유저(Superuser) 계정을 만들어야 한다.

python manage.py createsuperuser

✅ 입력할 정보:

• 사용자 이름(username)
• 이메일 주소(email)
• 비밀번호(password)

3️⃣ urls.py에서 Admin URL 매핑 확인

프로젝트의 `urls.py`에서 `admin/` 경로가 설정되어 있어야 한다.

# urls.py
from django.contrib import admin
from django.urls import path

urlpatterns = [
    path('admin/', admin.site.urls),
]

4️⃣ 서버 실행 후 Django Admin 접속

python manage.py runserver

이후 브라우저에서 `http://127.0.0.1:8000/admin/`로 접속하여 로그인하면 Django Admin을 사용할 수 있다.

 

3. 모델을 Django Admin에 등록하기

Django Admin에서 직접 관리하려는 모델을 admin 패널에 등록해야 한다.

1️⃣ 기본적인 모델 등록

# admin.py
from django.contrib import admin
from .models import Student

admin.site.register(Student)

이제 `Student` 모델이 Django Admin에서 보이며, 데이터를 추가/수정/삭제할 수 있다.

2️⃣ admin.ModelAdmin을 사용한 커스텀 관리

기본적인 모델 등록뿐만 아니라, `ModelAdmin`을 사용하면 더 강력한 기능을 추가할 수 있다.

# admin.py
from django.contrib import admin
from .models import Student

class StudentAdmin(admin.ModelAdmin):
    list_display = ('id', 'name', 'age', 'grade', 'created_at')  # 목록에서 보이는 필드
    list_filter = ('grade', 'created_at')  # 필터 기능 추가
    search_fields = ('name', 'grade')  # 검색 기능 추가
    ordering = ('-created_at',)  # 정렬 기준

admin.site.register(Student, StudentAdmin)

✅ 설명:

• `list_display` → 목록 화면에서 표시할 필드
• `list_filter` → 우측에 필터 옵션 추가
• `search_fields` → 상단에 검색 기능 추가
• `ordering` → 기본 정렬 기준 설정

 

4. Django Admin 커스터마이징

Django Admin은 기본적으로 제공되는 UI 외에도 다양한 커스터마이징이 가능하다.

1️⃣ 모델 필드 수정 가능 여부 설정

class StudentAdmin(admin.ModelAdmin):
    readonly_fields = ('created_at',)  # 수정 불가능한 필드
    fields = ('name', 'age', 'grade', 'created_at')  # 폼에 표시할 필드 순서

✅ `readonly_fields` → 특정 필드를 읽기 전용으로 설정 ✅ `fields` → 필드 순서를 조정할 수 있음

2️⃣ 인라인(Inline) 모델 관리

하나의 모델이 다른 모델과 ForeignKey 관계를 맺고 있을 때, 한 화면에서 함께 관리할 수 있다.

from .models import Course, Enrollment

class EnrollmentInline(admin.TabularInline):
    model = Enrollment
    extra = 1  # 추가할 수 있는 빈 필드 개수

class CourseAdmin(admin.ModelAdmin):
    inlines = [EnrollmentInline]

admin.site.register(Course, CourseAdmin)

✅ ForeignKey 관계를 가진 모델을 한 화면에서 관리할 수 있다.

3️⃣ 관리자 사이트의 기본 정보 변경

admin.site.site_header = "My Django Admin"
admin.site.site_title = "Admin Panel"
admin.site.index_title = "Welcome to the Admin Dashboard"

✅ Admin 페이지의 기본 제목과 헤더를 변경하여 브랜드화 가능

 

5. Django Admin의 권한 및 사용자 관리

Django Admin에서는 사용자 계정과 권한을 관리할 수 있는 기능도 제공한다.

1️⃣ 사용자 및 그룹 관리

Django의 `auth` 시스템을 활용하면 특정 사용자에게 특정 권한을 부여할 수 있다.

• `is_staff = True` → Admin 페이지에 접근 가능
• `is_superuser = True` → 모든 권한을 가짐
• 그룹(Group)을 만들어 여러 사용자에게 공통 권한 부여 가능

2️⃣ 모델별 권한 설정

모델을 등록할 때 `permissions`를 설정할 수 있다.

class Student(models.Model):
    name = models.CharField(max_length=100)
    grade = models.IntegerField()

    class Meta:
        permissions = (
            ("can_change_grade", "Can change student grade"),
        )

✅ 특정 사용자에게 `"can_change_grade"` 권한을 부여할 수 있음

 

django admin 정리:
✅ Django Admin은 데이터를 효율적으로 관리할 수 있는 관리자 인터페이스다~
✅ `admin.site.register()`를 통해 모델을 Admin 패널에 등록해야 한다~
✅ `ModelAdmin`을 활용하면 검색, 필터, 정렬, 읽기 전용 필드 등의 기능을 추가할 수 있다~
✅ ForeignKey 관계 모델을 InlineAdmin으로 한 화면에서 관리가 가능하다~
✅ 사용자 및 권한 관리 기능을 활용하여 관리자 접근을 세분화할 수 있다~
✅ Django Admin을 활용하면 개발자는 프론트엔드를 별도로 만들지 않고도 데이터 관리가 가능하다~