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
+17
View File
@@ -0,0 +1,17 @@
# ==========================================
# 백엔드 환경변수 (NestJS) — 운영용
# 사용법: cp .env.production.example .env.production
#
# ⚠️ 운영은 도커로 구동된다. DB/Redis/CORS/포트 등은 루트 .env.production →
# docker-compose 가 모두 주입하므로 여기에 중복 작성하지 않는다.
# (env_file 지시자 때문에 이 파일은 "존재"하기만 하면 된다.)
#
# 아래는 루트에서 내려주지 않는 백엔드 고유 시크릿이다. 인증 구현 시 채운다.
# ⚠️ 반드시 강력한 임의값으로 교체할 것.
# ==========================================
# ----- 백엔드 고유 값 (인증 구현 시 사용) -----
# JWT_SECRET=__CHANGE_ME_STRONG_JWT_SECRET__
# JWT_EXPIRES_IN=15m
# JWT_REFRESH_SECRET=__CHANGE_ME_STRONG_REFRESH_SECRET__
# JWT_REFRESH_EXPIRES_IN=7d