docs: 템플릿 규칙 정비 및 환경변수 예제·README 추가

- CLAUDE.md: 모노레포 개요·표준 응답 포맷·에러 코드 맵(구현 일치)·환경변수 위임 구조(SSOT) 정리
- nestjs/vue3/flutter 규칙을 실제 구현(클래스명, env키, 디렉터리)과 정합화
- 루트 .env 단일 진실 공급원 구조에 맞춰 docker-compose 변수명 정정(BACKEND_API_URL, DB/REDIS_DATA_DIR)
- backend/frontend/flutter 예제 env 추가(루트 위임 반영, 서비스 고유 값만 작성)
- README.md 신규 작성, command.md 범용화, .gitignore에 *.example 재포함 규칙 추가

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-15 11:14:42 +09:00
parent 543d7b85fa
commit f5a18a52f4
15 changed files with 423 additions and 51 deletions
+34
View File
@@ -0,0 +1,34 @@
# ==========================================
# 백엔드 환경변수 (NestJS) — 개발용
# 사용법: cp .env.development.example .env.development
#
# ⚠️ 도커로 실행하면 이 파일에 값을 적을 필요가 거의 없다.
# 루트 .env.development → docker-compose 가 아래 값을 주입(override)한다:
# NODE_ENV, PORT, WEBSOCKET_PORT, CORS_ORIGIN,
# DB_HOST(=db), DB_PORT(=5432), DB_USER, DB_PASSWORD, DB_NAME,
# REDIS_HOST(=redis), REDIS_PORT(=6379), REDIS_PASSWORD
# (docker-compose 의 env_file 지시자 때문에 이 파일은 "존재"해야 한다.)
#
# 아래 항목은 ⓐ 백엔드 단독(npm run start:dev) 실행 시 또는
# ⓑ 루트에서 내려주지 않는 서비스 고유 값일 때만 채운다.
# ==========================================
# ----- 단독 실행(non-Docker) 시에만 필요 — 도커 실행 시 무시됨 -----
# NODE_ENV=development
# PORT=3000
# WEBSOCKET_PORT=3001
# CORS_ORIGIN=http://localhost:5173
# DB_HOST=localhost
# DB_PORT=5432
# DB_USER=dev_ttipo
# DB_PASSWORD=dev_960426
# DB_NAME=prelude_db
# REDIS_HOST=localhost
# REDIS_PORT=6379
# REDIS_PASSWORD=dev_960426
# ----- 백엔드 고유 값 (루트에서 내려주지 않음 / 인증 구현 시 사용) -----
# JWT_SECRET=changeme_jwt_secret
# JWT_EXPIRES_IN=1h
# JWT_REFRESH_SECRET=changeme_refresh_secret
# JWT_REFRESH_EXPIRES_IN=7d