Django를 실무 흐름으로 이해하기
Django로 인증, ORM, 관리자 페이지, 템플릿, REST API까지 갖춘 웹 서비스를 만듭니다. 빠르게 제품 형태를 잡아야 하는 Python 웹 개발에 적합합니다. 이 가이드는 개념을 나열하기보다, 실제 프로젝트에서 판단해야 하는 순서대로 내용을 따라갈 수 있게 구성했습니다.
Python 풀스택 웹 프레임워크 가이드
Django 완전 가이드
Django로 인증, ORM, 관리자 페이지, 템플릿, REST API까지 갖춘 웹 서비스를 만듭니다. 빠르게 제품 형태를 잡아야 하는 Python 웹 개발에 적합합니다.
가이드 사용법
백엔드 / 시스템 개발
문법보다 요청이 들어와 검증, 처리, 저장, 응답으로 이어지는 경계를 먼저 잡습니다.
구조 다이어그램
글로 읽은 내용을 머릿속에 오래 남기려면 먼저 흐름을 그림으로 잡는 편이 좋습니다. 아래 두 그림은 Django를 학습할 때 계속 되돌아볼 수 있는 기준 지도입니다.
학습 흐름
다이어그램 렌더링 중…
아키텍처 관점
다이어그램 렌더링 중…
Django란?
Django를 처음 펼칠 때는 세부 명령보다 큰 그림이 먼저입니다. 이 섹션에서는 앞으로 배울 개념들이 어떤 문제를 풀기 위해 등장했는지부터 잡아봅니다.
Django는 batteries included 철학을 가진 Python 웹 프레임워크입니다. 라우팅, ORM, 인증, 관리자 페이지, 보안 기능이 기본 제공되어 서버 렌더링 웹앱과 백오피스를 빠르게 만들 수 있습니다.
| 구성 | 역할 |
|---|---|
| Model | 데이터 구조와 DB 테이블을 정의합니다. |
| View | 요청을 처리하고 응답을 반환합니다. |
| Template | HTML 화면을 렌더링합니다. |
| Admin | 관리자 CRUD 화면을 자동으로 제공합니다. |
프로젝트 생성
여기서는 프로젝트 생성을 실제 코드와 함께 확인합니다. 예제를 그대로 따라 하기보다, 입력과 출력, 그리고 바뀌기 쉬운 부분이 어디인지 보면서 읽어보세요.
Django 프로젝트와 앱을 만들고 개발 서버를 실행합니다.
BASH
uv venv
source .venv/bin/activate
uv pip install django
django-admin startproject config .
python manage.py startapp blog
python manage.py runserverModel & ORM
여기서는 Model & ORM을 실제 코드와 함께 확인합니다. 예제를 그대로 따라 하기보다, 입력과 출력, 그리고 바뀌기 쉬운 부분이 어디인지 보면서 읽어보세요.
Model은 데이터베이스 테이블을 Python 클래스로 표현합니다.
blog/models.pyPYTHON
from django.db import models
class Post(models.Model):
title = models.CharField(max_length=120)
body = models.TextField()
published = models.BooleanField(default=False)
created_at = models.DateTimeField(auto_now_add=True)
def __str__(self) -> str:
return self.titleView & URL
여기서는 View & URL을 실제 코드와 함께 확인합니다. 예제를 그대로 따라 하기보다, 입력과 출력, 그리고 바뀌기 쉬운 부분이 어디인지 보면서 읽어보세요.
URL 패턴과 View를 연결해 요청 흐름을 만듭니다.
PYTHON
from django.http import JsonResponse
from django.urls import path
from .models import Post
def post_list(request):
posts = Post.objects.filter(published=True).values("id", "title")
return JsonResponse({"posts": list(posts)})
urlpatterns = [path("posts/", post_list)]Admin
여기서는 Admin을 실제 코드와 함께 확인합니다. 예제를 그대로 따라 하기보다, 입력과 출력, 그리고 바뀌기 쉬운 부분이 어디인지 보면서 읽어보세요.
Admin에 모델을 등록하면 관리자 CRUD 화면을 즉시 사용할 수 있습니다.
blog/admin.pyPYTHON
from django.contrib import admin
from .models import Post
@admin.register(Post)
class PostAdmin(admin.ModelAdmin):
list_display = ("title", "published", "created_at")
list_filter = ("published",)
search_fields = ("title", "body")REST 확장
여기서는 REST 확장을 실제 코드와 함께 확인합니다. 예제를 그대로 따라 하기보다, 입력과 출력, 그리고 바뀌기 쉬운 부분이 어디인지 보면서 읽어보세요.
API 중심 서비스라면 Django REST Framework를 함께 사용합니다.
BASH
uv pip install djangorestframework
# settings.py INSTALLED_APPS에 rest_framework 추가Django 실무 설계
Django 실무 설계은 선택지가 갈리는 지점입니다. 표를 기준으로 각 방법의 쓰임새와 운영상의 차이를 비교해두면 이후 판단이 훨씬 쉬워집니다.
Django는 app 경계, model manager, service layer, serializer/form 책임을 나누어야 대규모 프로젝트에서 유지보수됩니다.
| 결정 지점 | 확인 질문 | 실무 기준 |
|---|---|---|
| 경계 | Django 코드에서 바뀌기 쉬운 부분은 어디인가? | 입출력, 설정, 외부 연동, 핵심 규칙을 분리합니다. |
| 상태 | 상태가 어디서 생성되고 어디서 사라지는가? | 상태 소유자와 수명 주기를 코드로 드러냅니다. |
| 장애 | 실패했을 때 호출자는 무엇을 받는가? | timeout, fallback, error contract를 먼저 정합니다. |
Django 운영 기준
이 섹션은 Django 운영 기준을 실무 관점에서 정리합니다. 개념을 외우기보다, 어떤 상황에서 이 기준을 꺼내 쓸지에 초점을 맞춰보세요.
운영에서는 ORM query count, transaction 범위, migration rollback, cache invalidation이 중요합니다.
Django 검증 전략
Django 검증 전략은 선택지가 갈리는 지점입니다. 표를 기준으로 각 방법의 쓰임새와 운영상의 차이를 비교해두면 이후 판단이 훨씬 쉬워집니다.
Django 테스트는 TestCase/TransactionTestCase 선택, factory, permission test, migration test를 포함해야 합니다.
| 품질 축 | 검증 방법 | 완료 기준 |
|---|---|---|
| 정확성 | 정상/실패 케이스를 자동화합니다. | 핵심 시나리오가 재현 가능하게 통과합니다. |
| 회귀 방지 | 버그 수정 시 동일 케이스를 테스트로 남깁니다. | 같은 장애가 다시 배포되지 않습니다. |
| 운영성 | 로그, 메트릭, 알림을 확인합니다. | 문제가 생겼을 때 원인 추적 경로가 있습니다. |