python3 --version

pip3 install django

python3 -m django --version

django-admin startproject {mysite} {djangotutorial}

📂 djangotutorial/          # 루트 디렉토리
    ├── 📄 manage.py        # Django 프로젝트 관리 커맨드라인 유틸리티. 서버 실행, DB관리, 앱 생성 등 다양한 명령 실행
    └── 📂 mysite/          # 실제 프로젝트 설정 패키지
        ├── 📄 __init__.py  # Python 패키지임을 인식하게 해주는 빈 파일
        ├── 📄 settings.py  # 프로젝트의 모든 설정을 담고 있는 파일. DB설정, 설치된 앱 목록, 보안 설정 등
        ├── 📄 urls.py      # 프로젝트의 URL 패턴을 정의하는 파일
        ├── 📄 asgi.py      # ASGI(Asynchronous Server Gateway Interface) 호환 웹 서버의 진입점. 비동기 웹 서버를 위한 설정파일. 실시간 기능(웹소캣 등)을 구현할 때 사용
        └── 📄 wsgi.py      # WSGI(Web Server Gateway Interface) 호환 웹 서버의 진입점. 웹 서버와 Django 앱을 연결해주는 역할. 실제 서비스 배포할 때 주로 사용.

python3 manage.py runserver

python3 manage.py startapp {polls}

polls/                  # 앱 디렉토리
    ├── __init__.py    # Python 패키지라고 알려주는 파일
    ├── admin.py       # 관리자 페이지 설정
    ├── apps.py        # 앱 설정
    ├── models.py      # 데이터베이스 모델
    ├── tests.py       # 테스트 코드
    ├── views.py       # 뷰 함수들
    └── migrations/    # 데이터베이스 변경사항 폴더
        └── __init__.py

python manage.py migrate

from django.db import models

# Create your models here.

# Question 모델 (설문조사 질문)
class Question(models.Model):
  question_text = models.CharField(max_length=200) # 문자열을 저장하는 필드(최대 200자까지 저장 가능)
  pub_date = models.DateTimeField('date published') # 날짜와 시간을 저장하는 필드(관리자 페이지에서 보여질 이름)

# Choice 모델 (설문조사 선택지)
class Choice(models.Model):
  question = models.ForeignKey(Question, on_delete=models.CASCADE) # 외래키 관계 설정. Question 모델과 연결. 삭제되면 CASCADE 옵션에 따라 관련된 Choice 객체도 삭제
  choice_text = models.CharField(max_length=200) # 문자열을 저장하는 필드(최대 200자까지 저장 가능)
  votes = models.IntegerField(default=0) # 정수를 저장하는 필드(기본값은 0)

         열(Column) = 필드(Field)
         ↓        ↓         ↓
id       이름      나이       이메일
1        김철수    20        kim@email.com    ← 행(Row) = 레코드(Record)
2        이영희    22        lee@email.com    ← 행(Row) = 레코드(Record)
3        박지민    21        park@email.com   ← 행(Row) = 레코드(Record)

INSTALLED_APPS = [
    "polls.apps.PollsConfig", # 앱 추가
    #...
]

python manage.py makemigrations polls

python manage.py sqlmigrate polls 0001

BEGIN;
--
-- Create model Question
--
CREATE TABLE "polls_question" (
  "id" integer NOT NULL PRIMARY KEY AUTOINCREMENT, # 자동 증가하는 기본 키
  "question_text" varchar(200) NOT NULL, # 질문 내용(200자 제한)
  "pub_date" datetime NOT NULL # 게시 날짜
);
--
-- Create model Choice
--
CREATE TABLE "polls_choice" (
  "id" integer NOT NULL PRIMARY KEY AUTOINCREMENT, # 자동 증가하는 기본 키
  "choice_text" varchar(200) NOT NULL, # 선택지 내용(200자 제한)
  "votes" integer NOT NULL, # 투표 수
  "question_id" bigint NOT NULL REFERENCES # Question 테이블과의 연결 고리
  "polls_question" ("id") DEFERRABLE INITIALLY DEFERRED # 외래 키 제약조건의 검사 시점을 설정.
  # DEFERRABLE: 제약조건 검사를 나중으로 미룰 수 있다는 의미
  # INITIALLY DEFERRED: 트랜잭션 끝에서 제약조건을 검사한다는 의미
);
CREATE INDEX "polls_choice_question_id_c5b4b260" ON # question_id 컬럼에 대한 인덱스를 생성하는 명령
  "polls_choice" ("question_id");
COMMIT;

python3 manage.py check

python3 manage.py migrate

python manage.py shell

class MyClass:
    def __init__(self):      # 생성자
    def __str__(self):       # 문자열 표현
    def __len__(self):       # 길이 반환
    def __repr__(self):      # 개발자를 위한 문자열 표현
    def __add__(self):       # + 연산자 동작 정의

def show_text(self):         # ❌ 파이썬이 특별 메서드로 인식 못함
    return self.question_text

def my_str(self):           # ❌ 역시 특별 메서드로 인식 못함
    return self.question_text

def __str__(self):          # ✅ 정상 동작!
    return self.question_text

python3 manage.py createsuperuser

# polls/admin.py
from django.contrib import admin
from .models import Question
admin.site.register(Question)

// Redux store나 React의 state 같은 것
const [questions, setQuestions] = useState([{ id: 1, text: '좋아하는 색은?' }])

# Django의 models.py
class Question(models.Model):
  question_text = models.CharField(max_length=200)
  pub_date = models.DateTimeField()

// React 컴포넌트
function QuestionList() {
  return (
    <div>
      <h1>질문 목록</h1>
      {questions.map((q) => (
        <QuestionItem question={q} />
      ))}
    </div>
  )
}

# Django의 template.html
  <h1>질문 목록</h1>
  {% for question in questions %}
    <div>{{ question.text }}</div>
  {% endfor %}

// API 호출 함수
async function getQuestions() {
  const response = await fetch('/api/questions/')
  const data = await response.json()
  setQuestions(data)
}

# Django의 views.py
def question_list(request):
  questions=Question.objects.all()
  return JsonResponse(list(questions))