Skip to content

Project Directory Structure

Hyerin Sung edited this page Jul 24, 2026 · 1 revision
backend/
│
├── .github/                       # GitHub 관리
│   ├── ISSUE_TEMPLATE/            # 이슈 템플릿
│   └── PULL_REQUEST_TEMPLATE.md   # PR 템플릿
│
├── configs/                       # config 관리
│   ├── settings/                  # Django 설정 관리
│   │   ├── __init__.py            # 어떤 환경인지 파악하고 어떤 설정을 적용할지 결정
│   │   ├── base.py                # 공통 Django 설정
│   │   ├── development.py         # 개발환경 Django 설정
│   │   └── production.py          # 배포환경 Django 설정
│   ├── __init__.py                # 이 폴더가 패키지임을 표시
│   ├── asgi.py                    # ASGI 설정
│   ├── urls.py                    # URL 설정
│   └── wsgi.py                    # WSGI 설정
│
├── <앱>/                          # Django App
│   ├── migrations/                # 데이터베이스 마이그레이션
│   ├── __init__.py                # 이 폴더가 패키지임을 표시
│   ├── admin.py                   # Admin 사이트 설정
│   ├── apps.py                    # App 설정
│   ├── models.py                  # Model 정의
│   ├── serializers.py             # Serializer 정의
│   ├── services.py                # 비즈니스 로직
│   ├── tests.py                   # 테스트 코드
│   ├── urls.py                    # App URL 설정
│   └── views.py                   # View 정의
│
├── utils/                         # 공통 유틸리티
│   ├── decorators/                # 커스텀 데코레이터
│   │   ├── service.py             # 서비스 전용 데코레이터
│   │   └── view.py                # 뷰 전용 데코레이터
│   ├── __init__.py                # 이 폴더가 패키지임을 표시
│   ├── choices.py                 # 커스텀 Choices
│   ├── constants.py               # 상수
│   ├── helpers.py                 # 공통 헬퍼 함수
│   └── serializer_fields.py       # 커스텀 시리얼라이저 필드
│
├── env_example/                   # 환경변수 목록
│   ├── .env.base                  # 공통 환경변수
│   ├── .env.development           # 개발환경 환경변수
│   └── .env.production            # 배포환경 환경변수
│
├── .gitignore                     # Git 제외 설정
├── manage.py                      # 명령어 실행 도구
├── README.md                      # 레포지토리 리드미
└── requirements.txt               # 의존성 목록

Clone this wiki locally