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
+8 -5
View File
@@ -1,7 +1,10 @@
# ==========================================
# 프론트엔드 고유 env — 현재 사용하는 고유 키는 없다.
# VITE_API_BASE_URL 은 docker-compose 가 루트 .env.development 의 BACKEND_API_URL 을
# build arg(VITE_API_BASE_URL)로 주입하므로 여기에 작성할 필요가 없다.
# 단독 실행(non-Docker)으로 vite dev 를 띄울 때만 아래 줄의 주석을 풀어 사용한다.
# 프론트엔드 env (development)
# VITE_ 변수는 docker-compose 가 루트 .env.development 값을 build arg 로 주입한다:
# VITE_API_BASE_URL ← BACKEND_API_URL
# VITE_AI_TIMEOUT_MS ← AI_TIMEOUT_MS
# 따라서 Docker 로 띄울 땐 이 파일에 작성할 필요가 없다.
# 단독 실행(non-Docker)으로 vite dev 를 띄울 때만 아래 주석을 풀어 사용한다.
# ==========================================
# VITE_API_BASE_URL=http://localhost:3100/api
# ==========================================
# VITE_AI_TIMEOUT_MS=60000
+8 -5
View File
@@ -1,7 +1,10 @@
# ==========================================
# 프론트엔드 고유 env — 현재 사용하는 고유 키는 없다.
# VITE_API_BASE_URL 은 docker-compose 가 루트 .env.production 의 BACKEND_API_URL 을
# build arg(VITE_API_BASE_URL)로 주입하므로 여기에 작성할 필요가 없다.
# 단독 빌드(non-Docker)로 vite build 할 때만 아래 줄의 주석을 풀어 운영 도메인으로 사용한다.
# 프론트엔드 env (production)
# VITE_ 변수는 docker-compose 가 루트 .env.production 값을 build arg 로 주입한다:
# VITE_API_BASE_URL ← BACKEND_API_URL
# VITE_AI_TIMEOUT_MS ← AI_TIMEOUT_MS
# 따라서 Docker 로 빌드할 땐 이 파일에 작성할 필요가 없다.
# 단독 빌드(non-Docker)로 vite build 할 때만 아래 주석을 풀어 운영 도메인으로 사용한다.
# ==========================================
# VITE_API_BASE_URL=https://your-domain.com/api
# ==========================================
# VITE_AI_TIMEOUT_MS=60000