🐳 Docker 환경별 설정 분리 및 실행 스크립트 추가

- docker-compose.dev.yml: 개발환경 전용 설정
- docker-compose.prod.yml: 프로덕션환경 전용 설정
- scripts/dev.sh, scripts/prod.sh: 환경별 실행 스크립트
- Dockerfile 및 nginx.conf 추가로 완전한 컨테이너화 구현
- 환경변수를 통한 유연한 API URL 설정

backend/Dockerfile

@@ -0,0 +1,28 @@
+# Python 3.9 베이스 이미지 사용
+FROM python:3.9-slim
+
+# 작업 디렉토리 설정
+WORKDIR /app
+
+# 시스템 패키지 업데이트 및 필요한 패키지 설치
+RUN apt-get update && apt-get install -y \
+    gcc \
+    g++ \
+    libpq-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+# requirements.txt 복사 및 의존성 설치
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# 애플리케이션 코드 복사
+COPY . .
+
+# 포트 8000 노출
+EXPOSE 8000
+
+# 환경변수 설정
+ENV PYTHONPATH=/app
+
+# 서버 실행
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]

docker-compose.dev.yml

@@ -0,0 +1,26 @@
+version: '3.8'
+
+# 개발 환경용 오버라이드
+services:
+  frontend:
+    environment:
+      - VITE_API_URL=http://localhost:8000
+    build:
+      args:
+        - VITE_API_URL=http://localhost:8000
+
+  backend:
+    volumes:
+      - ./backend:/app  # 개발 시 코드 변경 실시간 반영
+    environment:
+      - DEBUG=True
+      - RELOAD=True
+
+  # 개발용 포트 매핑
+  postgres:
+    ports:
+      - "5432:5432"
+
+  redis:
+    ports:
+      - "6379:6379"

docker-compose.prod.yml

@@ -0,0 +1,46 @@
+version: '3.8'
+
+# 프로덕션 환경용 오버라이드
+services:
+  frontend:
+    environment:
+      - VITE_API_URL=/api
+    build:
+      args:
+        - VITE_API_URL=/api
+    # 포트를 외부에 노출하지 않음 (리버스 프록시 사용)
+    ports: []
+
+  backend:
+    environment:
+      - DEBUG=False
+      - RELOAD=False
+    # 포트를 외부에 노출하지 않음
+    ports: []
+
+  # 프로덕션용 리버스 프록시 (예: Nginx)
+  nginx:
+    image: nginx:alpine
+    container_name: tk-mp-nginx
+    restart: unless-stopped
+    ports:
+      - "80:80"
+      - "443:443"
+    volumes:
+      - ./nginx/nginx.conf:/etc/nginx/nginx.conf
+      - ./nginx/ssl:/etc/nginx/ssl  # SSL 인증서
+    depends_on:
+      - frontend
+      - backend
+    networks:
+      - tk-mp-network
+
+  # 데이터베이스 접근 제한
+  postgres:
+    ports: []  # 외부 접근 차단
+
+  redis:
+    ports: []  # 외부 접근 차단
+
+  pgadmin:
+    ports: []  # 외부 접근 차단 (필요시 SSH 터널링)

frontend/Dockerfile

@@ -0,0 +1,36 @@
+# Node.js 18 베이스 이미지 사용
+FROM node:18-alpine
+
+# 작업 디렉토리 설정
+WORKDIR /app
+
+# 빌드 인자 받기
+ARG VITE_API_URL=http://localhost:8000
+ENV VITE_API_URL=$VITE_API_URL
+
+# package.json과 package-lock.json 복사
+COPY package*.json ./
+
+# 의존성 설치 (플랫폼별 바이너리 다운로드)
+RUN npm ci --force
+
+# 소스 코드 복사 (node_modules 제외)
+COPY . .
+
+# Vite 빌드
+RUN npm run build
+
+# Nginx 이미지로 멀티스테이지 빌드
+FROM nginx:alpine
+
+# 빌드된 파일을 nginx로 복사
+COPY --from=0 /app/dist /usr/share/nginx/html
+
+# nginx 설정 파일 복사 (필요시)
+COPY nginx.conf /etc/nginx/conf.d/default.conf
+
+# 포트 3000 노출
+EXPOSE 3000
+
+# nginx 실행
+CMD ["nginx", "-g", "daemon off;"]

frontend/nginx.conf

@@ -0,0 +1,26 @@
+server {
+    listen 3000;
+    server_name localhost;
+    root /usr/share/nginx/html;
+    index index.html index.htm;
+
+    # SPA를 위한 설정 (React Router 등)
+    location / {
+        try_files $uri $uri/ /index.html;
+    }
+
+    # API 프록시 설정
+    location /api/ {
+        proxy_pass http://tk-mp-backend:8000/;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+
+    # 정적 파일 캐싱
+    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
+        expires 1y;
+        add_header Cache-Control "public, immutable";
+    }
+}

scripts/dev.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+# 개발 환경 실행 스크립트
+
+echo "🚀 TK-MP 프로젝트 개발 환경 시작..."
+
+# 기존 컨테이너 정리
+docker-compose -f docker-compose.yml -f docker-compose.dev.yml down
+
+# 개발 환경으로 빌드 및 실행
+docker-compose -f docker-compose.yml -f docker-compose.dev.yml up --build -d
+
+echo "✅ 개발 환경이 실행되었습니다!"
+echo "📱 프론트엔드: http://localhost:3000"
+echo "🔧 백엔드 API: http://localhost:8000"
+echo "📚 API 문서: http://localhost:8000/docs"
+echo "🗄️ pgAdmin: http://localhost:5050"
+
+# 로그 출력
+docker-compose -f docker-compose.yml -f docker-compose.dev.yml logs -f

scripts/prod.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+# 프로덕션 환경 실행 스크립트
+
+echo "🚀 TK-MP 프로젝트 프로덕션 환경 시작..."
+
+# 기존 컨테이너 정리
+docker-compose -f docker-compose.yml -f docker-compose.prod.yml down
+
+# 프로덕션 환경으로 빌드 및 실행
+docker-compose -f docker-compose.yml -f docker-compose.prod.yml up --build -d
+
+echo "✅ 프로덕션 환경이 실행되었습니다!"
+echo "🌐 애플리케이션: http://localhost (또는 도메인)"
+echo "🔒 HTTPS: https://localhost (SSL 설정 시)"
+
+# 상태 확인
+docker-compose -f docker-compose.yml -f docker-compose.prod.yml ps