# 운영 환경(Production) 설정 및 환경 변수 명세

> **일시**: 2026-02-11 03:00
> **상태**: 🟢 완료 (운영 배포 준비)
> **주제**: 실제 웹(Vercel/Firebase) 배포 시 필수 설정값 안내

---

## 1. 개요
부장님의 `InsuWiki`를 로컬호스트가 아닌 실제 웹 환경(`Vercel`, `Firebase Hosting`)에 배포할 때 필요한 환경 변수(Environment Variables)와 필수 설정값을 정의합니다.

## 2. 필수 환경 변수 목록 (Environment Variables)

배포 플랫폼(Vercel 대시보드 등)의 환경 변수 설정 섹션에 아래 항목들을 정확히 입력해야 합니다.

| 변수명 | 설명 | 값 (예시/출처) |
| :--- | :--- | :--- |
| `NEXT_PUBLIC_FIREBASE_API_KEY` | Firebase API 키 | `.env.local` 참조 |
| `NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN` | Firebase 인증 도메인 | `insuwiki-j2h.firebaseapp.com` |
| `NEXT_PUBLIC_FIREBASE_PROJECT_ID` | 프로젝트 ID | `insuwiki-j2h` |
| `NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET` | 스토리지 버킷 | `insuwiki-j2h.firebasestorage.app` |
| `NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID` | 메시징 발신자 ID | `.env.local` 참조 |
| `NEXT_PUBLIC_FIREBASE_APP_ID` | 앱 ID | `.env.local` 참조 |
| `NEXT_PUBLIC_FIREBASE_MEASUREMENT_ID` | 분석 ID | `.env.local` 참조 |
| `NEXT_PUBLIC_USE_EMULATOR` | 에뮬레이터 사용 여부 | **`false`** (운영 필수) |

## 3. 운영 환경 최적화 설정

### 3.1. 에뮬레이터 비활성화 (Critical)
운영 환경에서는 `NEXT_PUBLIC_USE_EMULATOR`를 반드시 `false`로 설정하십시오. `true`로 설정될 경우, 실 서버 데이터가 아닌 부장님의 로컬 컴퓨터(localhost)로 연결을 시도하여 서비스가 작동하지 않습니다.

### 3.2. Firebase 보안 도메인 등록
Vercel에서 배포가 완료되면 부여받는 최종 도메인(예: `insuwiki.vercel.app`)을 반드시 **Firebase Console > Authentication > 설정 > 승인된 도메인** 목록에 추가해야 합니다. 이 작업이 누락되면 구글 로그인이 차단됩니다.

## 4. 보안 주의사항 (Security)
- `.env` 파일은 절대 GitHub 등 공용 저장소에 직접 업로드하지 마십시오.
- 운영용 API 키가 노출된 경우, Google Cloud Console에서 할당량 제한 및 도메인 제한 설정을 권장합니다.

---

*본 문서는 `.agent/workflows/create-doc.md` 지침에 따라 관리되는 공식 기술 명세입니다.*