https://www.figma.com/design/wDh3su4KrlhkzOM1d7vKBT/Django-%EA%B8%B0%EC%B4%88---%EA%B3%B5%EB%B6%80%EC%8B%9C%EA%B0%84-%EA%B8%B0%EB%A1%9D%EA%B8%B0-%EB%A7%8C%EB%93%A4%EA%B8%B0-2-?node-id=0-1&t=v5jE7SjThGqnU9an-1

가상환경 설정부터 프로젝트 생성, 앱 등록, 모델 작성, 마이그레이션, admin 확인, URL 연결, 템플릿과 CSS 적용, 함수형 View를 이용한 목록 페이지 구현까지 아주 자세히 실습합니다.

파일	역할
manage.py	Django 명령 실행 진입점
config/settings.py	프로젝트 전체 설정 파일
config/urls.py	최상위 URL 연결 파일
config/wsgi.py	배포용 서버 연결
config/asgi.py	비동기 서버 연결

---

manage 관리하다
config 구성
setting 환경

---

프로젝트생성과 앱생성의 차이

7. Django 프로젝트 생성

이제 Django 프로젝트 자체를 생성합니다.

django-admin startproject config .
terminal

이 명령어의 의미
초보자 입장에서는 이 명령어가 조금 낯설 수 있습니다.

startproject config .

config 는 Django 설정 패키지 이름 (보통 수업 때 mysite로 생성했었습니다!)
마지막 . 은 “현재 폴더에 바로 생성하라”는 뜻
입니다.

즉 지금 작업 중인 study_time_tracker 폴더 안에 Django 프로젝트를 바로 생성하겠다는 의미입니다.

생성 후 구조
study_time_tracker/
├── .venv/
├── config/
│ ├── init.py
│ ├── asgi.py
│ ├── settings.py
│ ├── urls.py
│ └── wsgi.py
└── manage.py

---

9. 앱 생성

Django에서는 기능 단위를 앱(App) 으로 나누어 관리합니다.

이번 실습에서는 공부 기록 기능을 담당할 study 앱을 생성합니다.

python manage.py startapp study

생성 후 구조는 아래와 비슷합니다.

study/
├── init.py
├── admin.py
├── apps.py
├── migrations/
├── models.py
├── tests.py
└── views.py

---

dir 디펙토리
contrib 기여하다
auth 인증
contenttypes 콘텐츠 유형
staticfiles 정적 파일
insecure 불안정한
ALLOWED_HOSTS 허용된 호스트
MIDDLE WARE 중간 제품?
security 보안
common 흔한
Authentication 입증
context 문맥
process 진행
request 요구
template 보받이
APPLICATION 신청 적용 원서
'config 구성
'default 기본 디폴트값
'ENGINE 기관 차 수단
VALIDATORS 검증자
AUTH_PASSWORD_VALIDATORS 인증 비밀번호 검증자
validation 확인
User 사용자
Attribute
Similarity 유사성
Attribute 속성
Validator 검증인
Minimum 최소한의
Length 길이
Validator 검증인
CommonPasswordValidator 일반 비밀번호 유효성 검사기
NumericPasswordValidator 숫자 비밀번호 유효성 검사기

LANGUAGE_CODE 언어 코드
TIME_ZONE 시간대

STATICFILES 정적 파일
FIELD 분야

---

11번까지는 최소한의 세팅

12번부터 중요!

--> 기본적인 기초적인 개념이 필요.

---

---

CATEGORY 범주
algorithm 연산
verbose 말 수가 많은
PositiveInteger 양의 정수
ordering 주문
verbose_name
plural 복수의
return 반환하다
property 재산 소유하다
import 수입
blank 공백

---

1️⃣ "무엇을 담을까" 생각하는 법

모델을 설계할 때는 코드보다 "이 서비스가 기억해야 할 정보가 뭔가?" 를 먼저 생각합니다.

공부 기록 앱이 기억해야 할 것들을 메모지에 적듯이 나열

→ 무슨 공부를 했나?        (title)
→ 어떤 카테고리인가?       (category)
→ 언제 공부했나?           (study_date)
→ 몇 시간 했나?            (hours / minutes)
→ 메모할 게 있나?          (memo)
→ 언제 이 기록을 만들었나? (created_at)
→ 마지막으로 수정한 건?    (updated_at)

이렇게 자연어로 먼저 나열한 다음, 각 항목에 맞는 필드 타입을 골라 코드로 옮기는 순서입니다.

---

2️⃣ models.py 큰 구조---

3️⃣ 코드 한 줄씩 해석

① 선택지 상수 CATEGORY_CHOICES

CATEGORY_CHOICES = [
    ('python', 'Python'),
    ('django', 'Django'),
]
# ('DB에 저장되는 값', '화면에 보이는 값')
# DB엔 'python' 저장, 사용자 눈엔 'Python' 표시

② 필드 정의

title = models.CharField(max_length=200, verbose_name='공부 제목')
#                         ↑ 최대 200자    ↑ admin에 표시될 이름

category = models.CharField(
    max_length=30,
    choices=CATEGORY_CHOICES,  # ← 위에서 만든 선택지 연결
    default='django',          # ← 기본값
)

study_date = models.DateField(verbose_name='공부 날짜')
# 날짜만 저장 (2026-03-12)

hours = models.PositiveIntegerField(default=0)
# 0 이상의 정수만 허용

memo = models.TextField(blank=True)
# 긴 글, 선택 입력

created_at = models.DateTimeField(auto_now_add=True)
# 처음 저장할 때 자동으로 현재 시각 기록, 이후 변경 안 됨

updated_at = models.DateTimeField(auto_now=True)
# 저장할 때마다 자동으로 현재 시각으로 갱신

③ class Meta

class Meta:
    ordering = ['-study_date', '-created_at']
    # 조회 시 최신 날짜순 자동 정렬 (- = 내림차순)

④ __str__

def __str__(self):
    return f'{self.title} ({self.study_date})'
# admin 페이지나 shell에서 객체를 출력하면
# "Django ORM 복습 (2026-03-12)" 형태로 보임

⑤ @property

@property
def total_minutes(self):
    return self.hours * 60 + self.minutes
# DB에 저장 안 함. 그냥 계산해서 돌려주는 값
# study.total_minutes → 150 (2시간 30분)

---

4️⃣ 모델 설계 순서 요약

1단계  기억해야 할 정보를 자연어로 나열
          "제목, 날짜, 시간, 메모..."

2단계  각 정보에 맞는 필드 타입 선택
          글자 → CharField / TextField
          숫자 → IntegerField
          날짜 → DateField

3단계  각 필드에 옵션 추가
          필수인지? 기본값은? 최대 길이는?

4단계  Meta, __str__, property 추가
          정렬 방식, 표시 이름, 계산 속성

이 순서로 생각하면 어떤 모델이든 막히지 않고 작성할 수 있어요! 더 궁금한 부분 있으면 알려주세요 😊

---

CharField는 Django 모델에서 가장 자주 쓰는 필드 중 하나로, 짧은 텍스트를 저장하는 칸입니다. 이름, 제목, 주소처럼 한 줄짜리 글자를 담을 때 씁니다.

아래 흐름도로 전체 개념을 한눈에 확인해 보세요.---

핵심 개념 정리

CharField = "짧은 글자를 저장하는 칸"

엑셀의 셀 하나라고 생각하면 쉬워요. 이름, 제목, 브랜드명처럼 한 줄짜리 텍스트를 담는 용도입니다.

name = models.CharField(max_length=100)

이 한 줄이 DB에 VARCHAR(100) 컬럼 하나를 만들어 줍니다.

---

옵션 설명

옵션	역할	예시
max_length	최대 글자 수 (필수!)	max_length=100
blank=True	폼에서 비워도 됨	선택 입력 항목에 사용
null=True	DB에 NULL 저장 허용	blank와 함께 쓸 때가 많음
default=''	기본값 설정	아무것도 안 입력하면 이 값

blank와 null의 차이가 헷갈릴 수 있는데, blank는 "폼 입력 검증", null은 "DB 저장" 의 문제입니다.

---

CharField를 써야 할 때 vs 말아야 할 때

• 써야 할 때: 이름, 제목, 주소, 전화번호처럼 짧은 한 줄 텍스트
• TextField 써야 할 때: 게시글 본문, 리뷰 내용처럼 길고 제한 없는 텍스트
• IntegerField 써야 할 때: 나이, 가격처럼 숫자

궁금한 옵션이 있으면 다이어그램의 각 박스를 클릭해 더 물어볼 수 있어요! 😊

---

CharField blank 옵션이 뭔가요?

blank=True 옵션이란?

blank는 폼(Form) 입력 시 이 칸을 비워도 되는지 를 결정하는 옵션입니다.

---

가장 쉬운 비유

회원가입 페이지를 떠올려보세요.

• 이름 입력칸 → 필수 (비우면 "이름을 입력해주세요" 오류)
• 닉네임 입력칸 → 선택 (비워도 통과)

이 "선택 칸"을 만들 때 blank=True를 씁니다.

---

코드 비교

class User(models.Model):
    username = models.CharField(max_length=50)
    # blank 없음 = 기본값이 blank=False
    # → 폼에서 반드시 입력해야 함

    nickname = models.CharField(max_length=50, blank=True)
    # → 폼에서 비워도 통과됨

---

blank vs null 차이 (자주 헷갈리는 부분!)

옵션	언제 작동하나?	역할
blank=True	폼 입력할 때	"이 칸 안 채워도 됩니다"
null=True	DB에 저장할 때	"DB에 NULL 값 저장 허용"

CharField는 보통 null=True 없이 blank=True만 써도 충분합니다. 비어있을 때 DB에 NULL 대신 빈 문자열 ''을 저장하기 때문입니다.

# CharField 권장 패턴
nickname = models.CharField(max_length=50, blank=True, default='')
#                                           ↑ 폼 비워도 됨  ↑ 빈 문자열로 저장

---

한 줄 요약

blank=True = "이 항목은 선택 입력입니다" 라고 Django에게 알려주는 것

추가로 궁금한 옵션 있으면 알려주세요! 😊

---

CharField null 옵션이 뭔가요?

null=True 옵션이란?

null은 DB(데이터베이스)에 저장할 때 "값 없음"을 NULL로 저장할지 를 결정하는 옵션입니다.

---

가장 쉬운 비유

엑셀 셀을 떠올려보세요.

• 셀에 빈 문자열 '' 저장 → 셀이 존재하는데 내용이 없는 것
• 셀에 NULL 저장 → 셀 자체에 "아무 값도 없음" 표시

이 두 가지는 DB 입장에서 다른 값입니다.

---

코드 비교

class User(models.Model):

    nickname = models.CharField(max_length=50, blank=True)
    # null=True 없음 → 비어있으면 DB에 '' (빈 문자열) 저장

    bio = models.CharField(max_length=200, blank=True, null=True)
    # null=True 있음 → 비어있으면 DB에 NULL 저장

---

DB에 실제로 어떻게 저장되나?

상황	null=True 없을 때	null=True 있을 때
닉네임 입력 안 함	'' (빈 문자열)	NULL
닉네임 입력함	'heeyoung'	'heeyoung'

---

blank vs null 한눈에 비교

blank=True   →   폼(화면) 단계에서 작동   →   "입력 안 해도 됨"
null=True    →   DB 저장 단계에서 작동    →   "NULL로 저장 허용"

사용자가 폼에 아무것도 안 입력
        ↓
   blank=True?  ─── No ──→  "필수 항목입니다" 오류 발생
        │
       Yes
        ↓
   DB에 저장할 때
   null=True?  ─── No ──→  '' (빈 문자열) 로 저장
        │
       Yes
        ↓
    NULL 로 저장

---

CharField에서 권장하는 패턴

CharField는 null=True를 되도록 쓰지 않는 것이 Django 권장 방식입니다. "값 없음"을 표현하는 방법이 NULL과 '' 두 가지가 생겨서 나중에 조회할 때 혼란스럽기 때문입니다.

# 권장
nickname = models.CharField(max_length=50, blank=True, default='')

# 비권장 (CharField에서)
nickname = models.CharField(max_length=50, blank=True, null=True)

null=True는 CharField보다 IntegerField, DateField 같은 숫자/날짜 필드에서 더 자연스럽게 씁니다. 숫자 필드는 "값 없음"을 0으로 표현하면 의미가 달라지기 때문입니다.

---

한 줄 요약

null=True = "이 칸이 비어있을 때 DB에 NULL로 저장해도 됩니다" 라고 Django에게 알려주는 것

궁금한 게 있으면 더 물어보세요! 😊

---

CharField max_length 옵션이 뭔가요?

max_length 옵션이란?

max_length는 이 칸에 입력할 수 있는 최대 글자 수를 정하는 옵션입니다. CharField에서 반드시 써야 하는 필수 옵션입니다.

---

가장 쉬운 비유

종이 서류의 입력칸을 떠올려보세요.

• 이름 칸 → [ _ _ _ _ _ _ _ _ _ _ ] (10칸)
• 주소 칸 → [ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ ] (20칸)

max_length는 이 칸의 크기를 정하는 것입니다.

---

코드

class User(models.Model):
    username = models.CharField(max_length=50)
    # 최대 50글자까지만 저장 가능

    email = models.CharField(max_length=200)
    # 최대 200글자까지 저장 가능

---

max_length가 하는 일 2가지

max_length=50 설정 시

① DB 테이블 생성할 때
   → VARCHAR(50) 컬럼으로 만들어짐
   → DB 자체에서 50자 초과 저장 차단

② 폼(화면) 입력할 때
   → 51자 이상 입력하면 "이 필드의 최대 길이는 50입니다" 오류 발생
   → Django가 자동으로 검증해줌

---

적절한 max_length 값 가이드

저장할 내용	권장 값	이유
이름, 닉네임	50	대부분 50자 이내
이메일 주소	200	이메일 최대 길이 규격
제목, 상품명	100~200	여유 있게 설정
주소	255	긴 주소 대비
비밀번호(해시)	128	암호화된 문자열 길이

긴 글(게시글 본문, 리뷰 내용 등)은 max_length가 없는 TextField를 쓰는 게 맞습니다.

---

max_length를 빠뜨리면?

# 이렇게 쓰면 오류 발생!
name = models.CharField()

# Django가 이렇게 알려줌:
# TypeError: CharField requires a max_length attribute.

CharField는 max_length 없이는 아예 실행이 안 됩니다.

---

한 줄 요약

max_length = "이 칸에는 최대 몇 글자까지 쓸 수 있나요?" 를 Django와 DB에게 알려주는 필수 설정

궁금한 게 있으면 더 물어보세요! 😊

---

CharField default 옵션이 뭔가요?

default 옵션이란?

default는 아무것도 입력하지 않았을 때 자동으로 채워지는 기본값을 설정하는 옵션입니다.

---

가장 쉬운 비유

회원가입 폼을 떠올려보세요.

• 국가 선택칸 → 아무것도 안 고르면 자동으로 "대한민국" 이 선택됨
• 등급 칸 → 처음 가입하면 자동으로 "일반회원" 으로 설정됨

이 "자동으로 채워지는 값"이 바로 default입니다.

---

코드

class User(models.Model):

    username = models.CharField(max_length=50)
    # default 없음 → 반드시 값을 넣어야 함

    country = models.CharField(max_length=50, default='대한민국')
    # 아무것도 안 입력하면 자동으로 '대한민국' 저장

    grade = models.CharField(max_length=20, default='일반회원')
    # 아무것도 안 입력하면 자동으로 '일반회원' 저장

---

DB에 실제로 어떻게 저장되나?

상황	default 없을 때	default='일반회원' 있을 때
값을 입력함	'관리자' 저장	'관리자' 저장
값을 안 입력함	오류 발생	'일반회원' 자동 저장

---

default 값의 종류

# 1. 빈 문자열 (가장 많이 씀)
nickname = models.CharField(max_length=50, blank=True, default='')

# 2. 특정 문자열
grade = models.CharField(max_length=20, default='일반회원')

# 3. 함수로 동적 생성 (호출 가능한 객체)
import uuid
code = models.CharField(max_length=36, default=uuid.uuid4)
# → 저장할 때마다 자동으로 고유한 코드 생성

---

blank=True와 함께 쓰는 이유

blank=True  →  폼에서 비워도 됨
default=''  →  비웠을 때 DB에 '' 로 저장

이 두 개를 함께 써야 완전한 "선택 입력 칸"이 완성됨

# CharField 선택 입력 칸의 권장 패턴
nickname = models.CharField(max_length=50, blank=True, default='')
#                                          ↑ 폼에서 비워도 됨
#                                                        ↑ 비면 '' 로 저장

---

한 줄 요약

default = "아무것도 입력 안 하면 이 값으로 자동 저장해줘" 라고 Django에게 알려주는 것

---

from django.contrib import admin — Django 내장 모듈

django.contrib.admin은 Django가 기본 제공하는 자동 관리자 인터페이스(Admin Site) 모듈입니다.

---

핵심 개념

Django 프로젝트를 만들면 /admin URL에서 데이터베이스를 GUI로 관리할 수 있는 페이지가 자동 생성됩니다. 이걸 가능하게 해주는 게 바로 django.contrib.admin입니다.

---

주요 사용법

1. 모델 단순 등록

from django.contrib import admin
from .models import Article

admin.site.register(Article)

2. ModelAdmin으로 커스터마이징

from django.contrib import admin
from .models import Article

@admin.register(Article)
class ArticleAdmin(admin.ModelAdmin):
    list_display = ['id', 'title', 'author', 'created_at']  # 목록에 표시할 필드
    list_filter = ['author', 'created_at']                  # 오른쪽 필터 패널
    search_fields = ['title', 'content']                    # 검색창
    ordering = ['-created_at']                              # 정렬 기준
    readonly_fields = ['created_at']                        # 읽기 전용 필드

---

자주 쓰는 ModelAdmin 옵션 정리

옵션	설명
list_display	목록 페이지에 표시할 컬럼
list_filter	사이드바 필터
search_fields	검색 대상 필드
ordering	기본 정렬 (-는 내림차순)
readonly_fields	수정 불가 필드
fields	상세 페이지에 표시할 필드 순서
inlines	관련 모델을 같은 페이지에 표시
list_per_page	페이지당 항목 수 (기본 100)

---

설정에서 활성화 확인

settings.py의 INSTALLED_APPS에 반드시 포함되어 있어야 합니다:

INSTALLED_APPS = [
    'django.contrib.admin',      # ✅ 어드민
    'django.contrib.auth',       # 인증
    'django.contrib.contenttypes',
    ...
]

urls.py에도 등록:

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

urlpatterns = [
    path('admin/', admin.site.urls),  # /admin 접속 경로
]

---

어드민 계정 생성

python manage.py createsuperuser

이후 /admin에 접속하면 등록된 모델을 GUI로 CRUD 할 수 있습니다.

궁금한 부분이 있으면 더 설명해 드릴게요!

---

"등록된 모델을 GUI로 CRUD 할 수 있습니다" 의미

---

먼저 CRUD란?

데이터를 다루는 4가지 기본 동작의 앞글자를 딴 약자입니다.

약자	영어	한국어	예시
C	Create	생성	게시글 작성
R	Read	조회	게시글 목록 보기
U	Update	수정	게시글 내용 수정
D	Delete	삭제	게시글 삭제

---

"등록된 모델" 이란?

admin.py에 register한 모델을 말합니다.

admin.site.register(Article)  # Article 모델을 등록

→ 이렇게 등록해야 /admin에서 보입니다.

---

전체 문장 풀이

"브라우저에서 /admin 주소로 들어가면,
등록해 놓은 DB 테이블(모델)을
코드 한 줄 없이 화면 클릭만으로
추가 / 조회 / 수정 / 삭제 할 수 있다"

---

실제 흐름

① 브라우저에서 localhost:8000/admin 접속
        ↓
② 슈퍼유저로 로그인
        ↓
③ 등록된 모델(예: Article) 클릭
        ↓
④ 버튼 클릭으로 CRUD 가능
   - [추가] 버튼 → Create (생성)
   - 목록 확인   → Read   (조회)
   - 항목 클릭   → Update (수정)
   - [삭제] 버튼 → Delete (삭제)

---

핵심 요약

개발자가 별도의 관리 페이지를 만들지 않아도, Django가 자동으로 데이터 관리 화면을 만들어 준다는 뜻입니다! 🎉

---

GUI (Graphical User Interface)

그래픽 사용자 인터페이스 — 즉, 마우스로 클릭하고 눈으로 보면서 사용하는 화면입니다.

---

CLI vs GUI 비교

	CLI	GUI
풀네임	Command Line Interface	Graphical User Interface
사용 방식	명령어 타이핑	마우스 클릭 + 시각적 화면
예시	터미널, 명령 프롬프트	윈도우 탐색기, 카카오톡, 웹사이트

---

예시로 이해하기

CLI 방식 (명령어로 데이터 조회):

SELECT * FROM article WHERE id = 1;

GUI 방식 (Django Admin):

→ 브라우저에서 /admin 접속하면 아래처럼 버튼, 표, 입력창으로 똑같은 작업을 할 수 있음

┌─────────────────────────────────┐
│  Articles                  [+추가]│
├────┬──────────┬────────────────┤
│ ID │  제목    │    작성자       │
├────┼──────────┼────────────────┤
│  1 │ 안녕하세요│   admin        │
│  2 │ 테스트   │   user1        │
└────┴──────────┴────────────────┘

---

한마디 요약

CLI = 코드/명령어로 조작
GUI = 눈에 보이는 화면으로 조작

Django Admin이 GUI라는 건, 코드 없이 브라우저에서 클릭만으로 DB를 관리할 수 있다는 뜻입니다! 😊

---

---

from django.contrib import admin 설명

---

한 마디로

"Django가 만들어놓은 관리자 페이지 기능을 가져오는 것" 이에요!

---

구조 분석

from django.contrib import admin
  ↑       ↑         ↑      ↑
from    django    contrib  admin
가져와  장고에서  내장앱   관리자기능

---

django.contrib 란?

django
  └── contrib  ← "contributed(기여하다) apps" 의 약자
        ├── admin      → 관리자 페이지
        ├── auth       → 로그인/인증
        ├── sessions   → 세션 관리
        ├── messages   → 메시지 알림
        └── staticfiles → 정적 파일

한 마디로

Django 가 기본으로
제공하는 내장 앱 모음! 📦
→ 설치 없이 바로 사용 가능!

---

admin 이 제공하는 것

from django.contrib import admin

# 1. 모델 등록
admin.site.register(Study)

# 2. 커스텀 Admin 클래스
class StudyAdmin(admin.ModelAdmin):
    list_display = ['title', 'category']

# 3. 데코레이터 방식
@admin.register(Study)
class StudyAdmin(admin.ModelAdmin):
    list_display = ['title']

---

커스텀 Admin 클래스 의미

기본 등록 vs 커스텀 등록 비교

기본 등록 - 아무 설정 없이 그냥 등록

admin.site.register(Study)

→ /admin에서 Study 목록이 기본 형태로만 보임

커스텀 Admin 클래스 - 어떻게 보여줄지 직접 설정

class StudyAdmin(admin.ModelAdmin):
    list_display = ['title', 'category']

admin.site.register(Study, StudyAdmin)  # ← 둘을 연결

→ /admin에서 Study 목록을 원하는 형태로 보여줌

---

list_display = ['title', 'category'] 의미

/admin의 목록 페이지에 어떤 컬럼을 표시할지 지정하는 옵션입니다.

설정 전

┌─────────────────────┐
│ Study object (1)    │   ← 이렇게만 보임
│ Study object (2)    │
└─────────────────────┘

설정 후

┌──────────────┬──────────────┐
│    title     │   category   │  ← 컬럼이 보임
├──────────────┼──────────────┤
│ Django 공부  │   백엔드      │
│ React 공부   │   프론트엔드  │
└──────────────┴──────────────┘

---

한마디 요약

admin.ModelAdmin을 상속받아서,
/admin 페이지를 내가 원하는 대로 커스터마이징하는 클래스입니다! ✅

---

데코레이터 방식 @admin.register(Study) 의미

---

데코레이터란?

함수/클래스 위에 @를 붙여서, 추가 동작을 자동으로 실행시키는 문법입니다.

---

기존 방식 vs 데코레이터 방식 비교

기존 방식 (2단계)

# ① 클래스 정의
class StudyAdmin(admin.ModelAdmin):
    list_display = ['title', 'category']

# ② 따로 등록
admin.site.register(Study, StudyAdmin)

데코레이터 방식 (1단계)

# ① 정의 + 등록을 동시에!
@admin.register(Study)
class StudyAdmin(admin.ModelAdmin):
    list_display = ['title', 'category']

---

@admin.register(Study) 풀이

@admin.register(Study)   # ← "Study 모델에 아래 클래스를 연결해서 등록해줘"
class StudyAdmin(admin.ModelAdmin):
    list_display = ['title', 'category']

부분	의미
@	데코레이터 표시
admin.register	등록 동작을 수행하는 함수
(Study)	어떤 모델에 연결할지 지정
StudyAdmin	어드민 설정 클래스

---

한마디 요약

@admin.register(Study) =
admin.site.register(Study, StudyAdmin)을
자동으로 실행해주는 축약 문법

코드가 짧아지고, 모델과 설정 클래스가 한눈에 보여서 가독성이 좋아집니다! ✅

---

admin 을 import 하면 생기는 것

http://localhost:8000/admin

┌─────────────────────────┐
│   Django 관리자 페이지   │
├─────────────────────────┤
│ 📋 Study                │
│   + 추가                │
│   📝 목록보기            │
├─────────────────────────┤
│ 👤 Users                │
│ 🔑 Groups               │
└─────────────────────────┘

이게 다 자동으로 생성! ✅

---

settings.py 와의 관계

# settings.py
INSTALLED_APPS = [
    'django.contrib.admin',     # ← 여기 등록되어 있어야
    'django.contrib.auth',
    'django.contrib.sessions',
    ...
]

# 그래야 admin.py 에서
from django.contrib import admin  # 사용 가능! ✅

---

자주 쓰는 contrib 모음

# 관리자 페이지
from django.contrib import admin

# 로그인/인증
from django.contrib.auth.models import User

# 메시지 알림
from django.contrib import messages

# 로그인 필요 데코레이터
from django.contrib.auth.decorators import login_required

---

비유

django.contrib
= 스마트폰 기본 앱 📱

설치 없이 처음부터
제공되는 앱들!

admin      = 기본 파일관리앱
auth       = 기본 잠금화면
sessions   = 기본 메모리
messages   = 기본 알림

---

정리

코드	의미
from	가져와
django	Django 패키지에서
contrib	내장 앱 모음에서
admin	관리자 기능을
import	불러옴

💡 admin.py 파일에서
이 한 줄 없으면 아무것도 못해요!
Django 앱 만들면 자동으로 생성되는

필수 import 예요! ✅

from django.db import models — Django 내장 모듈

이건 Django가 기본으로 제공하는 내장 모듈입니다.

---

역할

Django에서 데이터베이스 모델을 정의할 때 사용하는 핵심 모듈이에요.

from django.db import models

class Study(models.Model):
    title = models.CharField(max_length=100)
    created_at = models.DateTimeField(auto_now_add=True)

---

models 안에 들어있는 주요 내장 기능들

📌 필드 (Field) — 컬럼 타입 정의

models.CharField()        # 짧은 문자열
models.TextField()        # 긴 문자열
models.IntegerField()     # 정수
models.FloatField()       # 실수
models.BooleanField()     # True/False
models.DateField()        # 날짜
models.DateTimeField()    # 날짜+시간
models.EmailField()       # 이메일
models.ImageField()       # 이미지 파일
models.FileField()        # 파일
models.ForeignKey()       # 1:N 관계
models.ManyToManyField()  # N:N 관계
models.OneToOneField()    # 1:1 관계

📌 Model 클래스 — 테이블 정의

class Study(models.Model):  # 이걸 상속받아야 DB 테이블이 됨
    ...

📌 Meta 옵션 — 모델 설정

class Study(models.Model):
    class Meta:
        ordering = ['-created_at']   # 기본 정렬
        db_table = 'my_study'        # 테이블 이름 지정
        verbose_name = '스터디'       # 관리자 페이지 표시명

---

자주 쓰는 Django 내장 import 모음

# DB 모델
from django.db import models

# 뷰
from django.shortcuts import render, redirect, get_object_or_404

# URL
from django.urls import path, include

# 인증
from django.contrib.auth.models import User
from django.contrib.auth.decorators import login_required

# 폼
from django.forms import ModelForm

# 설정
from django.conf import settings

---

핵심 요약: from django.db import models는 Django가 설치될 때 함께 제공되는 내장 모듈이고, 이걸 통해 Python 클래스를 DB 테이블로 변환할 수 있어요! 🎯