From 2401f4cd4a3d91b0c5b1820512048ca76002fd91 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B9=80=EB=B3=B4=EA=B3=A4?=
 <lightone2017@codebridge-x.com>
Date: Mon, 23 Feb 2026 10:17:33 +0900
Subject: [PATCH] =?UTF-8?q?chore:=20[env]=20.env.example=20=EC=B6=94?=
 =?UTF-8?q?=EA=B0=80=20=EB=B0=8F=20.gitignore=20=EC=A0=95=EB=A6=AC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- .env.example 생성 (서버 설정 시 참조 템플릿)
- .gitignore에 !.env.example 예외 추가
- 공유 API 키, 프로젝트 전용 키 구분 문서화
---
 .env.example | 119 +++++++++++++++++++++++++++++++++++++++++++++++++++
 .gitignore   |   1 +
 2 files changed, 120 insertions(+)
 create mode 100644 .env.example

diff --git a/.env.example b/.env.example
new file mode 100644
index 00000000..9768b489
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,119 @@
+# ─────────────────────────────────────────────────
+# SAM MNG (관리자 웹) 환경 변수
+# ─────────────────────────────────────────────────
+# 이 파일을 .env로 복사한 후 실제 값을 입력하세요.
+# cp .env.example .env && php artisan key:generate
+# ─────────────────────────────────────────────────
+
+APP_NAME=SAM-MNG
+APP_ENV=local
+APP_KEY=
+APP_DEBUG=true
+APP_URL=https://mng.sam.kr
+
+APP_LOCALE=en
+APP_FALLBACK_LOCALE=en
+APP_FAKER_LOCALE=en_US
+
+APP_MAINTENANCE_DRIVER=file
+
+BCRYPT_ROUNDS=12
+
+LOG_CHANNEL=stack
+LOG_STACK=single
+LOG_DEPRECATIONS_CHANNEL=null
+LOG_LEVEL=debug
+
+# ─── Database ───
+DB_CONNECTION=mysql
+DB_HOST=sam-mysql-1
+DB_PORT=3306
+DB_DATABASE=samdb
+DB_USERNAME=samuser
+DB_PASSWORD=sampass
+
+SESSION_DRIVER=database
+SESSION_LIFETIME=120
+SESSION_ENCRYPT=false
+SESSION_PATH=/
+SESSION_DOMAIN=null
+
+BROADCAST_CONNECTION=log
+FILESYSTEM_DISK=local
+QUEUE_CONNECTION=database
+
+CACHE_STORE=database
+
+MEMCACHED_HOST=127.0.0.1
+
+REDIS_CLIENT=phpredis
+REDIS_HOST=127.0.0.1
+REDIS_PASSWORD=null
+REDIS_PORT=6379
+
+# ─── Mail ───
+MAIL_MAILER=smtp
+MAIL_HOST=smtp.gmail.com
+MAIL_PORT=587
+MAIL_USERNAME=
+MAIL_PASSWORD=
+MAIL_ENCRYPTION=tls
+MAIL_FROM_ADDRESS=
+MAIL_FROM_NAME="${APP_NAME}"
+
+# ─── AWS (미사용) ───
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+AWS_DEFAULT_REGION=us-east-1
+AWS_BUCKET=
+AWS_USE_PATH_STYLE_ENDPOINT=false
+
+VITE_APP_NAME="${APP_NAME}"
+
+# ─── SAM API 서버 연동 ───
+API_BASE_URL=https://api.sam.kr
+FLOW_TESTER_API_KEY=
+
+# ─── 내부 통신 키 (API 서버 간 HMAC 검증) ───
+# API 프로젝트의 INTERNAL_EXCHANGE_SECRET과 동일한 값 사용
+INTERNAL_EXCHANGE_SECRET=
+
+# ─── 메뉴 동기화 전용키 ───
+MENU_SYNC_API_KEY=
+
+# ─────────────────────────────────────────────────
+# 공유 API 키 (API 프로젝트와 동일한 값 사용)
+# ─────────────────────────────────────────────────
+
+# ─── Google Gemini AI ───
+GEMINI_API_KEY=
+GEMINI_MODEL=gemini-2.0-flash
+GEMINI_BASE_URL=https://generativelanguage.googleapis.com/v1beta
+GEMINI_PROJECT_ID=codebridge-chatbot
+
+# ─── Claude AI ───
+CLAUDE_API_KEY=
+
+# ─── Vertex AI (Veo 영상 생성) ───
+VERTEX_AI_PROJECT_ID=codebridge-chatbot
+VERTEX_AI_LOCATION=us-central1
+
+# ─── Google Cloud (STT + GCS Storage) ───
+GOOGLE_APPLICATION_CREDENTIALS=/var/www/sales/apikey/google_service_account.json
+GOOGLE_STORAGE_BUCKET=codebridge-speech-audio-files
+GOOGLE_STT_LOCATION=asia-southeast1
+
+# ─── Notion API ───
+NOTION_API_KEY=
+NOTION_VERSION=2025-09-03
+
+# ─── FCM (Firebase Cloud Messaging) ───
+FCM_PROJECT_ID=
+FCM_SA_PATH=secrets/firebase-service-account.json
+FCM_BATCH_CHUNK_SIZE=200
+FCM_BATCH_DELAY_MS=100
+FCM_LOGGING_ENABLED=true
+FCM_LOG_CHANNEL=stack
+
+# ─── 기상청 공공데이터포털 API ───
+KMA_SERVICE_KEY=
diff --git a/.gitignore b/.gitignore
index ffce19b6..8206959a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -11,6 +11,7 @@
 !storage/.gitignore
 .env
 .env.*
+!.env.example
 .phpunit.result.cache
 Homestead.yaml
 Homestead.json