Initial commit

2026-10-26 12:28:48 +09:00
commit 18f10cece4
269 changed files with 33654 additions and 0 deletions
@@ -0,0 +1,81 @@
+# ==========================================
+# 프로젝트 전역 설정
+# ==========================================
+PROJECT_NAME=project
+APP_ENV=development
+BUILD_MODE=development
+FRONTEND_DIR=frontend
+BACKEND_DIR=backend
+
+# ==========================================
+# 포트 설정
+#
+# 컨테이너 포트 매핑뿐 아니라 **호스트에서 띄우는 vite dev 서버**도 이 값을 따른다.
+# (frontend/vite.config.ts 가 이 파일을 직접 읽는다 — FRONTEND_PORT 로 열고
+#  /api 프록시는 BACKEND_PORT 로 보낸다. 포트를 바꾸면 CORS_ORIGIN 도 함께 고칠 것)
+# ==========================================
+FRONTEND_PORT=5173
+BACKEND_PORT=3000
+WEBSOCKET_PORT=3001
+DB_PORT=5432
+REDIS_PORT=6379
+
+# ==========================================
+# Database 설정
+# ==========================================
+DB_IMAGE=postgres:15-alpine
+DB_USER=app_user
+DB_PASSWORD=change-me-in-local-env
+DB_NAME=project_db
+DB_DATA_DIR=./data/postgres
+
+# ==========================================
+# Redis 설정
+# ==========================================
+REDIS_IMAGE=redis:7-alpine
+REDIS_PASSWORD=change-me-in-local-env
+REDIS_DATA_DIR=./data/redis
+
+# ==========================================
+# API 경로 설정
+# ==========================================
+BACKEND_API_URL=http://localhost:3000/api
+CORS_ORIGIN=http://localhost:5173
+
+# ==========================================
+# Rate Limiting (API 남용 방지)
+# 미설정 시 백엔드 기본값(60초 / 100회) 사용
+# ==========================================
+THROTTLE_TTL_MS=60000
+THROTTLE_LIMIT=100
+
+# ==========================================
+# DB 스키마 동기화 (개발 전용, 기본 false)
+# true 로 켜면 엔티티 변경이 DB 에 자동 반영되어 빠르게 실험할 수 있지만,
+# 그 상태에서는 migration:generate 가 "변경 없음"만 내놓는다.
+# 운영으로 갈 코드라면 꺼둔 채 마이그레이션으로 관리할 것.
+# (운영 환경에서는 이 값과 무관하게 항상 비활성화된다)
+# ==========================================
+DB_SYNCHRONIZE=false
+
+# ==========================================
+# 선택적 서비스 (Compose profiles)
+#
+# 기본값(비어 있음) = redis 와 frontend 컨테이너를 기동하지 않는다.
+#
+#   redis     캐시·세션 공유가 필요해질 때        → COMPOSE_PROFILES=redis
+#   frontend  vite 를 컨테이너로 띄워야 할 때      → COMPOSE_PROFILES=frontend
+#   둘 다                                        → COMPOSE_PROFILES=redis,frontend
+#
+# 일회성으로 켜려면: docker compose --profile redis ... up -d
+#
+# ⚠️ 개발 환경의 프론트엔드는 호스트에서 띄우는 것이 기본이다 (`cd frontend && npm run dev`).
+#    컨테이너 vite 는 바인드 마운트 때문에 첫 서빙까지 수 분이 걸린다.
+# ==========================================
+COMPOSE_PROFILES=
+
+# ==========================================
+# 파일 업로드 (로컬 디스크)
+# ==========================================
+UPLOAD_DATA_DIR=./data/uploads
+UPLOAD_MAX_SIZE_MB=5