# 260211-10.05-deployment-platform-selection

> **일시**: 260211-10.05
> **주제**: 배포 플랫폼 선정 (Vercel vs Firebase Hosting)
> **결정**: **Vercel (Frontend)** + **Firebase (Backend)** 하이브리드 방식 채택 권장

---

## 1. 배경
InsuWiki는 **Next.js 16 (App Router)** 기반의 웹 애플리케이션이며, 백엔드로 **Firebase (Firestore, Auth, Functions)**를 사용 중입니다.
배포 단계(Phase 6) 진입을 앞두고, 프론트엔드 호스팅 플랫폼으로 `Vercel`과 `Firebase Hosting` 중 어느 것이 더 적합한지 결정해야 합니다.

## 2. 비교 분석

| 비교 항목 | **Vercel** (`vercel.app`) | **Firebase Hosting** (`web.app`) |
| :--- | :--- | :--- |
| **호환성** | **완벽함** (Next.js 개발사가 직접 운영) | **지연 있음** (최신 Next.js 기능 지원이 한 박자 늦음) |
| **성능 (SSR)** | Edge Network 기반으로 **매우 빠름** | Cloud Functions 콜드 스타트로 인해 **다소 느릴 수 있음** |
| **이미지 최적화** | `next/image` 자동 최적화 지원 (Zero Config) | 별도 설정 필요하거나 추가 비용 발생 가능 |
| **배포 편의성** | GitHub 연동 시 `git push`로 자동 배포 | `firebase deploy` 명령어 수동 실행 또는 GitHub Action 설정 필요 |
| **비용** | 취미(Hobby) 플랜 **무료** (상업용 아니면 충분) | Spark(무료) / Blaze(종량제) |
| **URL** | `*.vercel.app` (깔끔함) | `*.web.app` / `*.firebaseapp.com` |

## 3. 제이 부장의 추천: **Vercel (Hybrid)**

**"Next.js 16 앱은 Vercel에 올리는 것이 국룰입니다."**

### 🎯 이유
1.  **Next.js 16 지원**: 현재 프로젝트가 최신 버전(Next.js 16.1.6)을 사용 중이므로, Vercel이 가장 안정적입니다. Firebase Hosting은 최신 Next.js 기능(Server Actions 등)에서 예기치 않은 호환성 문제가 발생할 수 있습니다.
2.  **속도**: 한국 리전(Seoul)을 포함한 전 세계 Edge Network가 자동으로 적용되어 페이지 로딩이 빠릅니다.
3.  **개발 경험**: GitHub에 푸시만 하면 빌드부터 배포까지 알아서 다 해줍니다. (CI/CD 구축 시간 절약)

## 4. 결론 및 향후 계획 (Next Steps)

1.  **Frontend**: **Vercel**에 배포합니다.
2.  **Backend**: **Firebase** (Firestore, Functions, Auth)는 그대로 사용합니다.
3.  **도메인**: Vercel에서 기본 제공하는 `insuwiki.vercel.app`을 사용하거나, 커스텀 도메인을 연결합니다.

---
*본 문서는 `.agent/workflows/create-doc.md` 지침에 따라 작성된 의사결정(Decision) 문서입니다.*