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 트리거로 Slack | webhook 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-apidmReport.ts두 곳에 있다(앱 간 패키지 의존이 없음). 양쪽 주석이 서로를 가리킨다.
이 결정을 다시 열어야 할 때
- 신고가 주당 수십 건을 넘어 Slack·대시보드로 감당이 안 될 때 → 처리 UI 또는 BE 이관 검토.
- DM이 채팅방 단위로 묶이게 되거나(chatUrl 저장), 집행부가 DM 신고를 봐야 한다는 운영 요구가 생길 때.
- DM 푸시가 서버 발송으로 바뀔 때 → “조용히 삼킴” 차단이 다시 선택지가 된다.
Last updated on