Skip to Content
DecisionsADR-0025: 그룹 채팅 모더레이션을 Supabase SECURITY DEFINER RPC + RLS로 실행한다

ADR-0025: 그룹 채팅 모더레이션을 Supabase SECURITY DEFINER RPC + RLS로 실행한다

  • Status: Accepted
  • Date: 2026-10-23
  • 관련: HMH-10232 (web-2e-1) · 에픽 HMH-9765 · 선례 ADR-0015(DM 신고·RLS 차단)·ADR-0018(통합 데이터 모델)·ADR-0020(chat-api 백엔드-facing 앱)

Context

Sendbird→Supabase 그룹 채팅 이관(에픽 HMH-9765)에서 대시보드 운영자 모더레이션(음소거·강퇴·동결·운영자 메시지 삭제)을 통합 모델로 옮겨야 한다.

통합 스키마(ADR-0018, migration 0014)에는 모더레이션 상태 컬럼이 이미 있다: channel_member.role(member/operator)·muted_until·is_banned, channel.is_frozen, message.deleted_by_operator. 감사 테이블 chat_moderation_audit(migration 0005)도 있다. 그러나 실행 함수와 서버 강제가 없었다 — 0014·0017 주석이 “enforce 는 WS4”로 미뤄둔 상태였다. 클라(authenticated)는 channel_member 의 last_read_at 만 쓸 수 있고 role/muted_until/is_banned 는 grant 가 없어, 이 컬럼을 바꾸려면 service_role 또는 SECURITY DEFINER RPC 가 필요하다.

핵심 제약: 대시보드는 웹 클라이언트라 chat-api(ADR-0020)의 internal-secret 을 들 수 없다. 그리고 UI 에서 버튼을 숨기는 것만으로는 음소거·강퇴가 강제되지 않는다 — 서버(RLS)에서 막아야 우회가 불가능하다.

검토한 대안

대안채택 안 한 이유
A: Supabase SECURITY DEFINER RPC 직결 (채택)—
B: chat-api 백엔드 엔드포인트(service_role)웹 대시보드가 internal-secret 을 못 들어 front-api 류 프록시를 신설해야 한다. 모더레이션은 운영자 JWT 로 당사자가 수행하는 동기 액션이라 프록시 1홉이 지연·장애면만 늘린다. DM 신고/차단(ADR-0015)·모더레이션 감사로그가 이미 클라→Supabase 패턴이라 경로 일관성도 깨진다.
클라가 channel_member 를 직접 UPDATE (컬럼 grant 확대)행 RLS 로는 “누가 누구를” 제어가 불가능하고, grant 를 열면 비운영자도 임의 멤버의 상태를 조작할 수 있다. 감사로그·권한검증을 한 트랜잭션에 묶지 못한다.

Decision

모더레이션 실행을 Supabase SECURITY DEFINER RPC로 둔다(경로 A). 대시보드가 운영자 커스텀 JWT(app_user_id claim)로 직접 호출한다 — ADR-0015 의 DM 신고 RPC + RLS 차단 패턴을 그룹으로 확장한 것이다.

  • RPC(supabase/migrations/0021_chat_moderation_actions.sql): mute_channel_member·unmute_channel_member·ban_channel_member·unban_channel_member·freeze_channel·unfreeze_channel·delete_channel_message_as_operator. 각 RPC 는 is_channel_operator() 로 호출자 권한을 검증하고 → 상태 변이 → chat_moderation_audit 기록을 한 트랜잭션(definer) 으로 수행한다.
  • 서버 강제: message insert 정책에 chat_channel_post_blocked() 가드를 추가해, 음소거(muted_until > now())·강퇴(is_banned)·동결(is_frozen, 비운영자만) 중이면 insert 를 거부한다. UI 숨김과 독립이다.
  • 감사 테이블(0005)에 channel_id 를 추가하고 Sendbird 시절 NOT NULL 이던 chat_url/union_id 를 완화해 통합 채널과 연결한다(기존 대시보드 writer 하위호환).

operator 임명(role 부여)은 이 ADR 범위 밖이다 — 그룹 프로비저닝(chat-api members, ADR-0020)이 소유한다.

Consequences

좋아지는 것

  • 신규 백엔드 인프라 0. DM 신고/차단·감사로그와 동일 경로(클라→Supabase RPC)로 수렴.
  • 권한검증·변이·감사를 한 트랜잭션에 묶어 부분실패가 없다.
  • RLS 서버 강제라 UI 를 우회한 직접 insert 도 막힌다.

감수하는 것

  • 모더레이션 로직이 SQL(RPC) 에 산다 — TS 보다 테스트·리뷰가 번거롭다(supabase/verify/0021_*.sql 로 커버).
  • 그룹 신고는 아직 백엔드(ChatAPI.reportChat)라, 모더레이션(Supabase)과 신고(백엔드)의 경로 불일치가 과도기 동안 지속된다. 통일은 운영 워크플로 소유권 문제라 별도 결정으로 미룬다.
  • chat-api(ADR-0020)는 프로비저닝·admin-message 전용으로 남고, 모더레이션은 안 맡는다 — 역할 경계를 기억해야 한다.

이 결정을 다시 열어야 할 때

  • 모더레이션이 백엔드 전용 데이터(외부 신고 접수·제재 이력 통합 등)를 필요로 하게 되면 경로 B(chat-api)로 이전을 재검토한다.
  • 그룹 신고를 Supabase 로 통일하기로 하면, 신고+모더레이션을 한 경로로 합치며 이 ADR 을 갱신한다.
Last updated on