Skip to Content
DatabaseSupabase 프로젝트 지도 — 어디에 무엇이 사는가

Supabase 프로젝트 지도 — 어디에 무엇이 사는가

얼마집은 Supabase 프로젝트를 여러 개 쓴다. 각각 역할이 다르고, 프로젝트 표시 이름이 담긴 데이터와 꼭 맞지는 않는다 — 그래서 “이건 어느 프로젝트?”가 자주 헷갈린다. 이 문서가 그 매핑의 단일 기준이다.

가장 흔한 함정: Supabase 대시보드의 howmuchhome-chat 은 채팅 프로젝트가 아니다(세무 AI챗 + 사내 챗봇 데이터다). 실시간 채팅은 howmuchhome-community 에 있다. 이름이 아니라 아래 표로 판단하라.

관련 결정: 영속 브랜칭/마이그레이션은 ADR-0022, 범용 2번째 프로젝트는 ADR-0029, 공용 접근 패키지는 ADR-0024.

한눈에

표시 이름 (대시보드)코드상 명칭ref역할env 접두
howmuchhome-communitycommunity-v2rvbpczkrxvzlszpdxady실시간 채팅 + 모더레이션COMMUNITY_V2_SUPABASE_*
howmuchhome-chattax-chat / 사내봇lundjydllqpaklxbckgt앱 세무 AI챗 + 사내 슬랙 챗봇·운영 자동화TAX_CHAT_SUPABASE_*
howmuchhome-etcetcrxfuihvilcbugihudzfk범용 — 리셉션 · 아케이드 · 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_id claim)로 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(좋아요) + RPC arcade_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_id claim)를 쓴다.
  • 마이그레이션: supabase-etc/migrations/ (CI: supabase-migrate-etc.yml). community-v2 와 같은 apply-migrations.sh 를 MIGRATIONS_DIR 만 바꿔 재사용한다.

nebuspace — 앱 데이터 아님

Claude 워크스페이스(nebuspace MCP)의 백엔드다. 얼마집 앱과 무관하니 앱 데이터 조사 대상에서 제외한다.

기능 → 프로젝트 매핑

기능프로젝트핵심 테이블/함수
실시간 채팅(그룹·DM)community-v2channel, message, channel_member, reaction
채팅 모더레이션community-v2chat_block, chat_report, chat_moderation_audit
총회 접수대(리셉션)etcreception_session, pair_reception_station*
아케이드 점수·업적·좋아요etcarcade_score, arcade_achievement, arcade_like, arcade_toggle_like(), arcade_my_bests()
앱 세무 AI챗tax-chatassessed_prices_unit, chat_logs, chat_feedback
사내 슬랙 챗봇·운영 자동화tax-chatchat_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-v2 0029/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”).

Last updated on