chore: 모든 env 파일 구조·주석 정리 및 env↔example 규격 통일

- 죽은 설정 제거: GITEA_*/REPO_IMPORT_ADMIN_EMAIL (저장소·Gitea 기능 삭제됨)
- 섹션 헤더 스타일을 # === 블록으로 전 파일 통일(루트/백엔드/프론트)
- 루트: AI 섹션(AI_TIMEOUT_MS) 형식 통일 + production 파일에 누락됐던 AI 섹션 추가
- 백엔드: JWT/앱URL/OAuth/AI 4섹션으로 일관 정렬, production 에 누락됐던 URL/OAuth/AI 추가
- 프론트: 빌드 주입 변수 안내(VITE_API_BASE_URL·VITE_AI_TIMEOUT_MS) 명시
- 각 .env 와 .example 의 키·순서·주석을 동일하게(값만 실값/placeholder 차이)

(실제 .env.* 는 gitignore 라 미커밋 — 로컬에선 동일 구조로 함께 정리함)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-21 13:21:40 +09:00
parent 042d724b3a
commit 1f2a93b01a
6 changed files with 100 additions and 76 deletions
+24 -18
View File
@@ -1,29 +1,33 @@
# ==========================================
# 백엔드 고유 설정 — 루트 .env 에서 내려주지 않는 값만 작성 (JWT/Gitea 등)
# DB/Redis/CORS/포트 등은 docker-compose 가 루트 .env.development 에서 주입한다.
# .example 을 복사해 .env.development 를 만들고 실제 값으로 채운다.
# 백엔드 고유 설정 (development)
# 루트 .env 에서 주입하지 않는 값만 여기에 둔다.
# DB/Redis/CORS/포트/AI_TIMEOUT_MS 는 docker-compose 가 루트 .env.development 에서 주입.
# .example 을 복사해 만들고 실제 값으로 채운다. (커밋 금지)
# ==========================================
# JWT 시크릿 (access/refresh 분리) — 임의의 강력한 랜덤 문자열로 교체
# 생성 예: node -e "console.log(require('crypto').randomBytes(48).toString('hex'))"
# ==========================================
# JWT / 인증 토큰
# ==========================================
# 시크릿은 강력한 랜덤 문자열로 교체:
# node -e "console.log(require('crypto').randomBytes(48).toString('hex'))"
JWT_ACCESS_SECRET=change-me-access-secret
JWT_REFRESH_SECRET=change-me-refresh-secret
# 토큰 만료 시간
JWT_ACCESS_TTL=15m
JWT_REFRESH_TTL=14d
# --- 앱 URL (소셜 로그인/이메일 인증 리다이렉트) ---
# APP_API_URL: 백엔드 공개 주소(글로벌 prefix /api 포함) — 인증 메일 링크 생성에 사용.
# 미설정 시 http://localhost:3100/api 로 폴백.
# ==========================================
# 앱 URL (리다이렉트)
# ==========================================
# APP_API_URL : 백엔드 공개 주소(/api 포함). 인증 메일 링크 생성용. 미설정 시 localhost:3100/api 폴백.
# FRONTEND_URL: 프론트 공개 주소. 인증 완료·소셜 로그인 후 리다이렉트. 미설정 시 CORS_ORIGIN→localhost:5273 폴백.
APP_API_URL=http://localhost:3100/api
# FRONTEND_URL: 프론트 공개 주소 — 인증 완료/소셜 로그인 후 이 주소로 리다이렉트.
# 미설정 시 CORS_ORIGIN → http://localhost:5273 순으로 폴백.
FRONTEND_URL=http://localhost:5273
# --- 소셜 로그인 (OAuth) ---
# 각 제공자 콘솔에서 발급한 키. CLIENT_ID 가 비어 있으면 해당 소셜 로그인은 비활성화된다.
# 콜백 URL 은 각 콘솔에 등록한 값과 정확히 일치해야 한다(글로벌 prefix /api 포함).
# ==========================================
# 소셜 로그인 (OAuth)
# ==========================================
# 각 제공자 콘솔 발급 키. CLIENT_ID 가 비면 해당 소셜 로그인 비활성.
# CALLBACK_URL 은 콘솔 등록값과 정확히 일치해야 함(/api 포함).
KAKAO_CLIENT_ID=change-me-kakao-rest-api-key
KAKAO_CLIENT_SECRET=change-me-kakao-client-secret
KAKAO_CALLBACK_URL=http://localhost:3100/api/auth/kakao/callback
@@ -31,8 +35,10 @@ GOOGLE_CLIENT_ID=change-me-google-client-id
GOOGLE_CLIENT_SECRET=change-me-google-client-secret
GOOGLE_CALLBACK_URL=http://localhost:3100/api/auth/google/callback
# --- AI 에이전트 (Claude) ---
# Claude(Anthropic) API 키 — AI 채팅 패널용. 미설정 시 AI 기능 비활성.
# ==========================================
# AI 에이전트 (Claude)
# ==========================================
# CLAUDE_API_KEY: Anthropic API 키. 미설정 시 AI 기능 비활성.
# CLAUDE_MODEL : 모델 ID. 미설정 시 claude-sonnet-4-6.
CLAUDE_API_KEY=change-me-claude-api-key
# 사용할 모델 ID — 미설정 시 claude-sonnet-4-6. 콘솔에서 사용 가능한 모델로 교체 가능.
CLAUDE_MODEL=claude-sonnet-4-6