아래는 위 파일 본문을 그대로 옮긴 문서입니다.

Vercel + Supabase Bootstrap Guide (ISSUE-003)

ISSUE-003의 외부 검증(External Verification) 단계를 처음부터 끝까지 따라가기 위한 단계별 가이드입니다. 기존 docs/runbooks/deployment.md는 참조용(환경변수 목록, 승인-게이트 명령)이고, 이 문서는 운영자가 직접 실행해야 하는 절차를 시간 순서대로 정리합니다.

이 가이드를 끝내면 다음이 보장됩니다.

Vercel 프로젝트가 GitHub 저장소와 연동되어 PR마다 Preview, main 머지 시 Production이 자동 배포된다.
Supabase 호스티드 프로젝트가 Prisma 헬스체크 대상으로 동작한다.
Preview/Production URL 모두에서 GET /api/health가 { "db": "ok", ... }를 200으로 반환한다.

0. Prerequisites

항목	확인 방법
GitHub 저장소 owner/maintainer 권한	`wild-mental/lecture-hub`의 Settings 접근 가능
Vercel 계정 (Hobby 이상)	https://vercel.com — GitHub 계정과 연결
Supabase 계정	https://supabase.com
로컬 CLI: `pnpm`, `git`, `vercel`, `supabase`	`pnpm -v && git --version && vercel --version && supabase --version`
Node 22.x (`.nvmrc` 기준)	`node -v`

Vercel CLI가 없다면:

pnpm add -g vercel

모든 단계는 main 워크트리에서 수행해도 되고, issue-003 워크트리에서 수행해도 됩니다. CLI 명령은 모두 사용자가 직접 실행합니다 — 자동화하지 마세요(비가역적 공유 부수효과).

1. Supabase 프로덕션 프로젝트 생성

https://supabase.com/dashboard → New project.
권장 설정:
- Project name: lecture-hub-prod (Preview/Production 공용; Preview 전용 분리는 5단계에서 결정).
- Region: Northeast Asia (Seoul) 또는 사용자 지역 가까운 곳. Vercel 배포 region(icn1)과 가깝게 맞춥니다.
- Database password: 임의 강한 값 생성, 즉시 1Password 등 비밀 보관소에 저장. 이후 화면에서 다시 볼 수 없습니다.
프로젝트 프로비저닝 완료까지 1~3분 대기.

Vercel + Supabase Bootstrap Guide (ISSUE-003)

0. Prerequisites

1. Supabase 프로덕션 프로젝트 생성

1-1. Preview 환경 정책 결정