ADR-0029: 범용 2번째 Supabase 프로젝트(howmuchhome-etc)를 같은 org 에 두고, raw SQL 단일 마이그 스트림 + 키-기반 접근으로 쓴다
- Status: Accepted
- Date: 2026-11-12
- 관련: HMH-10800 (이번 작업 티켓) · 아케이드 랭킹(후속 Phase 1) · ADR-0028(아케이드 통합) · ADR-0022(community-v2 Supabase 환경) · ADR-0024(supabase-auth 패키지)
Context
아케이드(ADR-0028) 위에 서버 연동 기능(랭킹, 실시간 대결) 과 향후 다른 기능을 올릴 백엔드 DB 가 필요하다. 요구를 보면 랭킹은 어느 Postgres든 되지만, 실시간 대결은 Supabase Realtime(presence/broadcast)이 거의 유일한 선택이라 Neon(= 앱 핵심 DB, realtime 없음)으로는 안 된다.
제약·동기:
- 이 레포엔 이미 DB 가 둘이다 — Neon + Drizzle(앱 핵심 데이터)과 community-v2 Supabase(채팅). 기존 Supabase 배선(마이그레이션 CI·커스텀 JWT·RLS)은 전부 community-v2 단일 프로젝트에 하드코딩돼 있다.
- 비용: 아케이드용으로 별도 프로젝트를 만들면 추가 비용이 걱정이었는데, Supabase 과금은 org 단위라 기존 org 에 프로젝트를 추가하는 건 새 org($25~)이 아니라 그 프로젝트 compute 증분(소액)뿐이다.
- 채팅 Supabase 는 cutover 완료로 프로덕션 크리티컬이다 — 실험적·고변동 게임 기능과 blast radius 를 섞고 싶지 않다.
- 나중에 Neon 테이블을 하나씩 이 프로젝트로 이사해 올 수 있어야 한다(장기적으로 Neon 축소 여지).
그때 확정 안 된 것: 실시간 대결의 정확한 네트워크 모델, Neon 전체 이전 여부.
검토한 대안
| 대안 | 채택 안 한 이유 |
|---|---|
| A. 아케이드를 community-v2 프로젝트에 넣기(스키마만 분리) | 프로덕션 채팅과 compute·blast radius 공유. 실험적 기능을 크리티컬 프로젝트에 얹는 리스크 |
| B. Neon 그대로 두고 랭킹만 Neon | realtime 대결이 불가(Neon은 pub/sub 없음) → 저장소·실시간이 갈려 글루 증가 |
| C. Neon → Supabase 전체 이전 | 핵심 데이터 이전은 크고 위험(서버리스 커넥션 풀링 재설계·Neon 브랜칭 워크플로 손실·컷오버). 아케이드가 끌고 갈 결정이 아님 |
| D. 새 org 에 별도 프로젝트 | Pro $25~ 추가 비용. 같은 org 추가 프로젝트가 더 쌈 |
Decision
같은 Supabase org 에 범용 2번째 프로젝트 howmuchhome-etc(ref rxfuihvilcbugihudzfk, ap-northeast-2)를
도입한다. 아케이드가 첫 사용처지만 전용이 아니라 범용이다(향후 기능·점진적 Neon 이사 타깃).
- 접근모델 = 서버(secret) 쓰기 / publishable 공개 읽기. 새 Supabase API 키를 쓴다 — publishable
키로 클라이언트가 공개 데이터를 읽고(RLS 적용), secret 키로 서버(route handler/server action)가
세션 유저를 검증한 뒤 쓴다(RLS 우회). 랭킹 리더보드는 공개 데이터라 per-user 커스텀 JWT 가 필요 없다
(채팅은 클라 직접 쓰기라 커스텀 JWT 가 필요했다). per-user RLS 가 필요해지면 그때 커스텀 JWT 경로를 끼운다
(env
ETC_SUPABASE_JWT_SECRET자리만 예약, 미구현).- 클라이언트:
packages/supabase-auth/etc.ts(getEtcSupabaseBrowserClient, publishable) ·etc-server.ts(getEtcSupabaseServerClient, secret). community-v2 의 커스텀 JWT 경로(index.ts/server.ts)는 건드리지 않는다(채팅 보호).
- 클라이언트:
- 마이그레이션 = raw SQL 단일 스트림.
supabase-etc/migrations/(+verify/) +config.toml. 적용은 community-v2 와 공유 스크립트(supabase/scripts/apply-migrations.sh,MIGRATIONS_DIR로 디렉터리만 바꿈) + 전용 워크플로.github/workflows/supabase-migrate-etc.yml. Drizzle-on-etc 는 도입하지 않는다 — 나중에 Neon 테이블이 이사 오면 그것도 raw SQL 로 변환한다(etc 의 스키마 toolchain 을 하나로). - 스키마 = public + 도메인 접두(예:
arcade_*). 커스텀 스키마는 PostgREST Data API 노출이 플랫폼 config(마이그레이션 SQL 로 재현 불가)라, “raw SQL 단일 재현 스트림” 원칙과 충돌한다. public 은 기본 노출이라 추가 설정이 없다. - dev/prod = 당장 단일 프로젝트. 데이터가 없고 저스테이크라 develop·main 둘 다 같은 프로젝트에 적용한다(마이그 추적으로 재적용 skip). 데이터가 쌓여 격리가 필요해지면 community-v2 처럼 dev 브랜치 + 환경 분리를 추가한다.
env: NEXT_PUBLIC_ETC_SUPABASE_URL · NEXT_PUBLIC_ETC_SUPABASE_PUBLISHABLE_KEY(클라) ·
ETC_SUPABASE_SECRET_KEY(서버) · ETC_SUPABASE_DB_URL(마이그 CI, Session pooler).
Consequences
좋아지는 것
- 저비용(같은 org compute 증분)으로 격리된 2번째 DB 확보 — 프로덕션 채팅과 blast radius 분리.
- Supabase 라 실시간 대결(Realtime) 이 가능하고, 랭킹·대결이 한 집에서 간다.
- 범용이라 Neon 테이블을 점진적으로 이사해 올 길이 열린다(Neon→etc, raw SQL 로).
- 접근모델이 단순(서버 쓰기/공개 읽기) — 클라 점수 위조를 서버 검증으로 막는다.
감수하는 것
- DB 가 셋(Neon + community-v2 Supabase + etc Supabase) — 운영 표면 증가.
- etc 는 단일 프로젝트라 develop 변경이 그 프로젝트에 바로 적용된다(dev=prod). 데이터가 생기기 전까지만 허용되는 타협.
- 도메인 분리가 스키마가 아니라 접두로만(public 안에서) — 커스텀 스키마의 깔끔함을 포기(재현성과 맞바꿈).
- supabase-auth 가 두 프로젝트를 담게 됨(community-v2 커스텀 JWT + etc 키-기반). 3번째가 생기면 레지스트리로 일반화 필요.
이 결정을 다시 열어야 할 때
- etc 에 실데이터가 쌓여 dev/prod 격리가 필요해질 때(dev 브랜치 추가 — ADR-0022 패턴).
- Neon 전체 이전이 비용·플랫폼 방향으로 정당화될 때(그땐 별도 ADR + 단계 컷오버).
- 커스텀 스키마 Data API 노출을 감수하고 스키마 분리가 필요할 만큼 도메인이 늘 때.
- etc 에 per-user RLS 데이터가 생겨 커스텀 JWT 경로가 필요해질 때(예약 자리 구현).
Last updated on