Django 컨벤션
프로젝트 구조
project/
├── config/ # settings, urls, wsgi, asgi
│ ├── settings/ # base.py, local.py, production.py 분리
│ └── urls.py
├── apps/ # 기능별 앱 모음
│ └── {app}/
│ ├── models.py
│ ├── views.py
│ ├── serializers.py # DRF 사용 시
│ ├── urls.py
│ └── tests/
└── requirements/ # base.txt, local.txt, production.txt
네이밍 규칙
- 파일/모듈:
snake_case
- 클래스(모델, 뷰, 시리얼라이저):
PascalCase
- URL name:
{app}:{action} 형식 (예: users:detail)
- 모델 필드:
snake_case
에러 처리
- DRF 사용 시
ValidationError, PermissionDenied, NotFound 활용
- 커스텀 에러는
apps/core/exceptions.py에 정의
EXCEPTION_HANDLER 설정으로 전역 에러 포맷 통일
테스트
pytest-django + factory_boy 조합 권장TestCase 대신 pytest 스타일 선호- 모델/시리얼라이저 단위 테스트 + API 통합 테스트 분리
