From 2fe60ab0cd8cc1f7f7e7a0ac92fc457529f226ff Mon Sep 17 00:00:00 2001
From: Haewon Kam <haewonkam@Haewons-MacBook-Pro.local>
Date: Wed, 10 Jun 2026 09:22:28 +0900
Subject: [PATCH] Track .env.example (template, no secrets) with AI model
 config
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- .gitignore: .env* 무시 유지 + !.env.example 예외(템플릿 추적)
- .env.example: 3 AI 모델 키 슬롯 + 최신 모델 ID + Gemini 함정 노트

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 .env.example | 38 ++++++++++++++++++++++++++++++++++++++
 .gitignore   |  3 ++-
 2 files changed, 40 insertions(+), 1 deletion(-)
 create mode 100644 .env.example

diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..451e595
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,38 @@
+# ===== TriplePick 환경 변수 (.env.local 로 복사 후 채우기) =====
+# 새 Firebase 프로젝트 생성 후 웹앱 config 6키 (Firebase 콘솔 > 프로젝트 설정 > 웹앱)
+NEXT_PUBLIC_FIREBASE_API_KEY=
+NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=
+NEXT_PUBLIC_FIREBASE_PROJECT_ID=
+NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=
+NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=
+NEXT_PUBLIC_FIREBASE_APP_ID=
+# (선택) GA4
+NEXT_PUBLIC_FIREBASE_MEASUREMENT_ID=
+NEXT_PUBLIC_GA_ID=
+
+# Cloud Functions 호출 리전 (서울 권장)
+NEXT_PUBLIC_FUNCTIONS_REGION=asia-northeast3
+
+# 공유/딥링크 베이스 URL
+NEXT_PUBLIC_SITE_URL=https://triplepick-web.vercel.app
+
+# ===== 서버 전용 (Cloud Functions 환경 · 클라이언트 노출 금지) =====
+# 결과 알림 이메일 (Resend)
+RESEND_API_KEY=
+RESEND_FROM="TriplePick <noreply@triplepick.ai>"
+
+# 관리자 HTTP 엔드포인트 보호용 베어러 토큰 (경기/예측/결과 입력)
+ADMIN_API_TOKEN=
+
+# 시드 스크립트용 서비스 계정 키 경로 (firebase-admin)
+GOOGLE_APPLICATION_CREDENTIALS=./serviceAccount.json
+
+# ===== AI 예측 생성 (3모델 · 상세 docs/AI-PREDICTIONS.md) =====
+# 매일 KST 0시 남은 경기 예측 생성. 모델 ID는 각 콘솔 GET /models 로 최신 확인.
+OPENAI_API_KEY=
+OPENAI_MODEL=gpt-5.5
+ANTHROPIC_API_KEY=
+ANTHROPIC_MODEL=claude-opus-4-8
+GEMINI_API_KEY=
+GEMINI_MODEL=gemini-3.5-flash
+# ⚠️ Gemini는 generationConfig(responseMimeType/thinkingConfig) 주면 빈 응답 → 평문 본문 + 응답 JSON 파싱
diff --git a/.gitignore b/.gitignore
index 5cdaf11..b72d1c4 100644
--- a/.gitignore
+++ b/.gitignore
@@ -30,8 +30,9 @@ yarn-debug.log*
 yarn-error.log*
 .pnpm-debug.log*
 
-# env files (can opt-in for committing if needed)
+# env files (secrets ignored; template tracked)
 .env*
+!.env.example
 
 # vercel
 .vercel