From df268d3b5ec2eb238988a8d93dc1ac897c1bfe1d Mon Sep 17 00:00:00 2001 From: ttipo Date: Fri, 19 Jun 2026 22:01:59 +0900 Subject: [PATCH] =?UTF-8?q?chore:=20env.example=20=ED=8C=8C=EC=9D=BC=20?= =?UTF-8?q?=ED=98=84=ED=96=89=ED=99=94=20(development=20=EA=B8=B0=EC=A4=80?= =?UTF-8?q?)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - backend/.env.development.example: CLAUDE_API_KEY 추가(dev 실제와 키 셋 일치) - backend/.env.production.example: 소셜 OAuth·APP_API_URL/FRONTEND_URL·CLAUDE_API_KEY 추가(운영 placeholder) - frontend/.env.*.example: 고유 키 없음 + VITE_API_BASE_URL docker 주입 설명 헤더 추가 실제 시크릿/인프라 값은 미포함(전부 placeholder). Co-Authored-By: Claude Opus 4.8 (1M context) --- backend/.env.development.example | 4 ++++ backend/.env.production.example | 22 ++++++++++++++++++++++ frontend/.env.development.example | 7 +++++++ frontend/.env.production.example | 7 +++++++ 4 files changed, 40 insertions(+) diff --git a/backend/.env.development.example b/backend/.env.development.example index 9c6fd07..e86ebbc 100644 --- a/backend/.env.development.example +++ b/backend/.env.development.example @@ -47,3 +47,7 @@ GITEA_TEMPLATE_REPO=project-base # 동기화는 시스템 작업이라 실행 주체가 없으므로 여기서 지정한다. # 비우거나 미가입 이메일이면 import 저장소는 멤버 0명으로 남고(초대 불가), 가입 후 다음 동기화에서 지정된다. REPO_IMPORT_ADMIN_EMAIL=admin@example.com + +# --- AI 에이전트 (Claude) --- +# Claude(Anthropic) API 키 — AI 에이전트 패널 연동용(추후). 미설정 시 AI 기능 비활성. +CLAUDE_API_KEY=change-me-claude-api-key diff --git a/backend/.env.production.example b/backend/.env.production.example index 507b8f5..d0a3bba 100644 --- a/backend/.env.production.example +++ b/backend/.env.production.example @@ -13,6 +13,24 @@ 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 로 폴백하므로 운영 도메인으로 반드시 교체. +APP_API_URL=https://your-domain.com/api +# FRONTEND_URL: 프론트 공개 주소 — 인증 완료/소셜 로그인 후 이 주소로 리다이렉트. +# 미설정 시 CORS_ORIGIN → http://localhost:5273 순으로 폴백하므로 운영 도메인으로 교체. +FRONTEND_URL=https://your-domain.com + +# --- 소셜 로그인 (OAuth) --- +# 각 제공자 콘솔에서 발급한 키. CLIENT_ID 가 비어 있으면 해당 소셜 로그인은 비활성화된다. +# 콜백 URL 은 각 콘솔에 등록한 운영 도메인 값과 정확히 일치해야 한다(글로벌 prefix /api 포함). +KAKAO_CLIENT_ID=change-me-kakao-rest-api-key +KAKAO_CLIENT_SECRET=change-me-kakao-client-secret +KAKAO_CALLBACK_URL=https://your-domain.com/api/auth/kakao/callback +GOOGLE_CLIENT_ID=change-me-google-client-id +GOOGLE_CLIENT_SECRET=change-me-google-client-secret +GOOGLE_CALLBACK_URL=https://your-domain.com/api/auth/google/callback + # --- Gitea 연동 (외부 Gitea 인스턴스) --- # 세 값(BASE_URL/TOKEN/ORG)이 모두 채워져야 연동 활성화. 비우면 Gitea 동기화 없이 동작한다. # 저장소 생성/수정/삭제 시 GITEA_ORG 조직 아래 repo 가 자동 동기화된다. @@ -29,3 +47,7 @@ GITEA_TEMPLATE_REPO=project-base # 동기화는 시스템 작업이라 실행 주체가 없으므로 여기서 지정한다. # 비우거나 미가입 이메일이면 import 저장소는 멤버 0명으로 남고(초대 불가), 가입 후 다음 동기화에서 지정된다. REPO_IMPORT_ADMIN_EMAIL=admin@example.com + +# --- AI 에이전트 (Claude) --- +# Claude(Anthropic) API 키 — AI 에이전트 패널 연동용(추후). 미설정 시 AI 기능 비활성. +CLAUDE_API_KEY=change-me-claude-api-key diff --git a/frontend/.env.development.example b/frontend/.env.development.example index e69de29..1351664 100644 --- a/frontend/.env.development.example +++ b/frontend/.env.development.example @@ -0,0 +1,7 @@ +# ========================================== +# 프론트엔드 고유 env — 현재 사용하는 고유 키는 없다. +# VITE_API_BASE_URL 은 docker-compose 가 루트 .env.development 의 BACKEND_API_URL 을 +# build arg(VITE_API_BASE_URL)로 주입하므로 여기에 작성할 필요가 없다. +# 단독 실행(non-Docker)으로 vite dev 를 띄울 때만 아래 줄의 주석을 풀어 사용한다. +# VITE_API_BASE_URL=http://localhost:3100/api +# ========================================== diff --git a/frontend/.env.production.example b/frontend/.env.production.example index e69de29..be38eea 100644 --- a/frontend/.env.production.example +++ b/frontend/.env.production.example @@ -0,0 +1,7 @@ +# ========================================== +# 프론트엔드 고유 env — 현재 사용하는 고유 키는 없다. +# VITE_API_BASE_URL 은 docker-compose 가 루트 .env.production 의 BACKEND_API_URL 을 +# build arg(VITE_API_BASE_URL)로 주입하므로 여기에 작성할 필요가 없다. +# 단독 빌드(non-Docker)로 vite build 할 때만 아래 줄의 주석을 풀어 운영 도메인으로 사용한다. +# VITE_API_BASE_URL=https://your-domain.com/api +# ==========================================