Supabase 프로젝트 지도 — 어디에 무엇이 사는가
얼마집은 Supabase 프로젝트를 여러 개 쓴다. 각각 역할이 다르고, 프로젝트 표시 이름이 담긴 데이터와 꼭 맞지는 않는다 — 그래서 “이건 어느 프로젝트?”가 자주 헷갈린다. 이 문서가 그 매핑의 단일 기준이다.
가장 흔한 함정: Supabase 대시보드의
howmuchhome-chat은 채팅 프로젝트가 아니다(세무 AI챗 + 사내 챗봇 데이터다). 실시간 채팅은howmuchhome-community에 있다. 이름이 아니라 아래 표로 판단하라.
관련 결정: 영속 브랜칭/마이그레이션은 ADR-0022, 범용 2번째 프로젝트는 ADR-0029, 공용 접근 패키지는 ADR-0024.
한눈에
| 표시 이름 (대시보드) | 코드상 명칭 | ref | 역할 | env 접두 |
|---|---|---|---|---|
howmuchhome-community | community-v2 | rvbpczkrxvzlszpdxady | 실시간 채팅 + 모더레이션 | COMMUNITY_V2_SUPABASE_* |
howmuchhome-chat | tax-chat / 사내봇 | lundjydllqpaklxbckgt | 앱 세무 AI챗 + 사내 슬랙 챗봇·운영 자동화 | TAX_CHAT_SUPABASE_* |
howmuchhome-etc | etc | rxfuihvilcbugihudzfk | 범용 — 리셉션 · 아케이드 · Neon 이사 타깃 | ETC_SUPABASE_* |
nebuspace | (앱 무관) | — | Claude 워크스페이스. 앱 데이터 아님 | — |
프로젝트별 상세
community-v2 — 실시간 채팅 + 모더레이션
통합 채팅(Sendbird 대체)의 데이터 평면이다. ADR-0022 로 dev/prod 를 영속 브랜치 + raw SQL(psql) 마이그레이션으로 격리한다.
- 채팅:
channel,channel_member,message,reaction,message_hidden - 모더레이션:
chat_block,chat_report,chat_moderation_audit(ADR-0025) - 접근: 커스텀 HS256 JWT(
app_user_idclaim)로 per-user RLS. front-api/대시보드가 토큰을 발급하고 클라이언트가 주입한다(ADR-0024·ADR-0023). - 마이그레이션:
supabase/migrations/(CI:supabase-migrate.yml).
tax-chat / 사내봇 (howmuchhome-chat) — 세무 AI챗 + 사내 자동화
이름은 howmuchhome-chat 이지만 실시간 채팅과 무관하다. 두 묶음을 담는다:
- 앱 세무 AI챗: 공시가격 조회·세무 상담의 백킹 데이터.
assessed_prices_unit(국토부 호별 공시가격, 약 1,570만 행),assessed_prices_area_avg(면적 평균 fallback),chat_logs,chat_feedback,tax_documents,ai_evaluations. - 사내 슬랙 챗봇 · 운영 자동화:
chat_signal/chat_signal_run(대화 분류),ct_draft_log/ct_stop_log(채널톡 AI 초안),agent_pending_actions/agent_action_log(사내 에이전트 write 승인 큐),ops_ack,integrity_alert_log,receivable_followup,app_rating_snapshots,lead_sites등. - 접근: 서버(service_role) 중심 + 공개 anon. 스키마·파이프라인은 세무 AI챗/사내봇 툴링이 소유(이 레포 CI 가 관리하는 마이그레이션 스트림 아님).
- env:
NEXT_PUBLIC_TAX_CHAT_SUPABASE_URL,TAX_CHAT_SUPABASE_SERVICE_ROLE_KEY등.
etc — 범용 2번째 프로젝트
별도 프로젝트를 더 만들면 비용이 늘어, 범용 그릇을 하나 두고 작은 기능·이사 데이터를 모은다(ADR-0029). “범용이 커지면” 여기에 쌓는다.
- 리셉션(총회 접수대 PC↔태블릿 페어링):
reception_session+ 페어링 RPC. 원래 community-v2 에 있다가 etc 로 이전했다(아래 참고). - 아케이드: 미니게임 점수·업적·좋아요. 게임 자체는 별도 레포 정적 배포, 서버 데이터만 etc(ADR-0028). 테이블
arcade_score(점수)·arcade_achievement(업적)·arcade_like(좋아요) + RPCarcade_toggle_like·arcade_like_counts·arcade_my_bests, 전부 service_role 전용(앱 쉘 서버 액션만, anon/authenticated 차단). 게임↔쉘 postMessage 브리지 계약은 아케이드 레포CLAUDE.md. - Neon 이사 타깃(향후): Neon 테이블을 하나씩 옮겨올 때 raw SQL 마이그레이션으로 받는다.
- 접근: 키 세대가 새것이다 — publishable(
NEXT_PUBLIC_ETC_SUPABASE_PUBLISHABLE_KEY, 공개 읽기) / secret(ETC_SUPABASE_SECRET_KEY, 서버 쓰기). 리셉션처럼 per-user RLS 가 필요한 경로는 커스텀 JWT(ETC_SUPABASE_JWT_SECRET, community-v2 와 같은app_user_idclaim)를 쓴다. - 마이그레이션:
supabase-etc/migrations/(CI:supabase-migrate-etc.yml). community-v2 와 같은apply-migrations.sh를MIGRATIONS_DIR만 바꿔 재사용한다.
nebuspace — 앱 데이터 아님
Claude 워크스페이스(nebuspace MCP)의 백엔드다. 얼마집 앱과 무관하니 앱 데이터 조사 대상에서 제외한다.
기능 → 프로젝트 매핑
| 기능 | 프로젝트 | 핵심 테이블/함수 |
|---|---|---|
| 실시간 채팅(그룹·DM) | community-v2 | channel, message, channel_member, reaction |
| 채팅 모더레이션 | community-v2 | chat_block, chat_report, chat_moderation_audit |
| 총회 접수대(리셉션) | etc | reception_session, pair_reception_station* |
| 아케이드 점수·업적·좋아요 | etc | arcade_score, arcade_achievement, arcade_like, arcade_toggle_like(), arcade_my_bests() |
| 앱 세무 AI챗 | tax-chat | assessed_prices_unit, chat_logs, chat_feedback |
| 사내 슬랙 챗봇·운영 자동화 | tax-chat | chat_signal, ct_draft_log, agent_*, ops_ack |
접근 모델 — 프로젝트마다 다르다
- 커스텀 JWT(HS256): community-v2(채팅), etc(리셉션). 서버가
app_user_id(+리셉션은station_id/token_epoch) claim 을 레거시 JWT secret 으로 서명 → 클라이언트가 주입 → RLS 가 actor 를 검증. 발급·클라이언트는supabase-auth패키지(community-v2=기본 배럴, etc=./etc·./etc-server). - publishable / secret 키(새 세대): etc 의 공개 읽기/서버 쓰기. 아케이드 리더보드처럼 per-user 신원이 필요 없는 공개 데이터용.
- service_role / anon(레거시 세대): tax-chat, 그리고 community-v2 의 일부 서버 경로.
⚠️ 키 세대가 섞여 있다. community-v2 는 레거시 anon/service_role 과 새 secret 키 env 를 둘 다 두고 있고(
COMMUNITY_V2_SUPABASE_{ANON_KEY,SERVICE_ROLE_KEY,SECRET_KEY}), etc 는 처음부터 새 publishable/secret 로 시작했다. 새 프로젝트/경로는 publishable/secret 를 기본으로 한다.
리셉션: community-v2 → etc 이전
리셉션은 채팅과 무관한데도 처음엔 community-v2 에 얹혀 있었다. ADR-0029 의 “범용 기능은 etc 로” 원칙에 따라 etc 로 옮겼다.
- etc 스키마:
supabase-etc/migrations/0002_reception.sql(community-v2 리셉션 DDL 통합) +0003(옛 2인자 페어링 함수 드롭 — community-v20029/HMH-10803 parity). - 코드 전환은
USE_ETC_RECEPTION빌드-타임 플래그로 게이트한다(PC·태블릿·토큰 라우트가 한꺼번에 etc 를 바라봐야 세션·realtime 이 갈리지 않는다). PC 유저 세션은 etc 커스텀 JWT(/api/etc/supabase-token)로 붙는다.
community-v2 는 더 이상 “잡화점”이 아니다
초기엔 community-v2 가 Supabase 가 필요한 모든 걸 받는 그릇처럼 쓰였다. 지금은 역할이 갈렸다 — 채팅/모더레이션만 community-v2, 범용은 etc, 세무/사내봇은 tax-chat. 새로 Supabase 가 필요하면 이 문서의 경계로 어느 프로젝트인지 먼저 정하고 시작하라(기본값은 “범용이면 etc”).