Skip to Content
DecisionsADR-0015: DM 신고는 운영팀(Supabase + Slack)으로 보내고, 차단은 RLS로 강제한다

ADR-0015: DM 신고는 운영팀(Supabase + Slack)으로 보내고, 차단은 RLS로 강제한다

  • Status: Accepted
  • Date: 2026-09-26
  • 관련: HMH-9533 · HMH-9532(#6071, web DM 잔존 삭제) · HMH-7612(#5101, native 이관) · HMH-7252(#4890, DM 푸시 설계) · 스펙 docs/superpowers/specs/2026-09-26-dm-block-report-design.md

Context

1:1 채팅(DM)을 production 전체에 열려면 스토어 UGC 정책(Apple 1.2, Google Play)이 요구하는 신고·차단 수단이 필요했다. 2026-09-26 기준 DM에는 둘 다 없었고, production 게이트(CHAT_MODERATION_ENABLED_CHAT_URLS)가 빈 배열이라 실사용자는 0명이었다.

제약:

  • DM은 Sendbird가 아니라 Supabase(community-v2)에 있고, 쓰레드(cv2_dm_thread)는 채팅방(chatUrl)에 묶이지 않은 두 사람 간 전역 대화다.
  • 기존 채팅·카페 신고는 BE chat_report에 chatUrl 단위로 쌓여 집행부 dashboard 신고 목록에 노출된다.
  • DM 푸시는 서버가 아니라 보내는 쪽 클라이언트가 전송 성공 직후 메인 백엔드 푸시 API를 호출한다(HMH-7252).
  • community-v2 Supabase는 dev·prod가 같은 프로젝트다.

검토한 대안

대안채택 안 한 이유
BE chat_report에 DM_MESSAGE 타입 추가, 집행부가 검토비공개 1:1 대화가 집행부에 노출된다. 쓰레드에 chatUrl이 없어 BE·스키마 변경이 필요하다
클라이언트가 cv2_dm_report insert + pg_net 트리거로 Slackwebhook URL을 Vault에 둬야 하고 로직이 SQL에 숨는다(DM 푸시 설계 때도 DB 트리거·Vault는 배제)
클라이언트 insert + 클라이언트가 알림 API 별도 호출저장과 알림이 따로 성공·실패할 수 있고, 알림 API가 스팸 통로가 된다
차단 시 조용히 삼킴(보낸 쪽엔 전송된 것처럼)푸시가 보내는 쪽 클라이언트에서 나가므로 서버 측 푸시 억제를 새로 만들어야 한다

Decision

  • 신고: front-api POST app/community-v2/dm-report(apps/api/src/app/app/community-v2/dm-report/route.ts)가 신고자를 verifyMe로 확인한 뒤, 신고자 본인으로 서명한 JWT로 security definer 함수 cv2_dm_report_thread(supabase/migrations/0013_community_v2_dm_report_rpc.sql)를 호출한다. 함수가 참여자 확인·피신고자 계산·최근 20개 스냅샷·저장을 DB 안에서 하고, cv2_dm_report에는 insert 정책을 두지 않는다 — 앱이 anon key와 사용자 JWT를 갖고 있어 정책이 있으면 PostgREST 직접 insert로 스냅샷을 위조할 수 있기 때문이다(브랜치 리뷰에서 발견). 저장 후 DM_REPORT_SLACK_WEBHOOK_URL로 운영팀에 알리며 본문의 & < >는 이스케이프한다. service role 키는 쓰지 않는다. Slack 실패는 신고 실패가 아니다(204).
  • 차단: cv2_dm_block + security definer 함수 cv2_dm_thread_blocked + cv2_dm_message_insert 정책(supabase/migrations/0012_community_v2_dm_block_report.sql). 차단이 있으면 양방향 전송을 거부한다. 전송이 실패하므로 클라이언트가 푸시를 호출하지 않아 푸시 억제가 따로 필요 없다.
  • 검증: supabase/verify/0012_community_v2_dm_block_report.sql(차단), supabase/verify/0013_community_v2_dm_report_rpc.sql(신고). 둘 다 트랜잭션 + rollback.

Consequences

좋아지는 것

  • 비공개 대화 내용이 운영팀 밖(집행부)으로 나가지 않는다.
  • BE 변경 없이 web 레포 안에서 끝나고, 푸시 억제를 따로 만들 필요가 없다.
  • 신고 대상은 서버가 쓰레드에서 계산하므로 클라이언트가 임의의 유저를 신고할 수 없다.

감수하는 것

  • 신고 처리 상태·통계는 Supabase 대시보드 조회뿐이다(처리 UI 없음).
  • 차단당한 쪽은 “메시지를 보낼 수 없어요”로 차단을 짐작할 수 있다.
  • 채팅 신고(집행부)와 DM 신고(운영팀)의 검토 주체가 다르다.
  • 신고 사유 목록이 native ReportBottomSheet와 front-api dmReport.ts 두 곳에 있다(앱 간 패키지 의존이 없음). 양쪽 주석이 서로를 가리킨다.

이 결정을 다시 열어야 할 때

  • 신고가 주당 수십 건을 넘어 Slack·대시보드로 감당이 안 될 때 → 처리 UI 또는 BE 이관 검토.
  • DM이 채팅방 단위로 묶이게 되거나(chatUrl 저장), 집행부가 DM 신고를 봐야 한다는 운영 요구가 생길 때.
  • DM 푸시가 서버 발송으로 바뀔 때 → “조용히 삼킴” 차단이 다시 선택지가 된다.
Last updated on