ADR-0018: 채팅 데이터 모델을 DM·그룹 통합 channel/channel_member/message + scope 신원으로 한다
- Status: Accepted (Amended 2026-10-20 — DM 채널 식별·생성·member 신원 구체화, 아래 Amendment)
- Date: 2026-10-08
- 관련: HMH-9787 (이 ADR·WS1-a) · HMH-9765 (Sendbird 탈출 에픽, 전체 설계) · ADR-0015 (DM을 Supabase+커스텀 JWT+RLS로 올린 선례 — 이 모델이 일반화하는 대상) · HMH-10093 (Amendment)
Context
Sendbird 탈출(에픽 HMH-9765)로 그룹채팅을 Supabase로 이관한다. DM은 이미 Supabase에 있다(ADR-0015): cv2_dm_thread/cv2_dm_message/cv2_dm_read/cv2_dm_block/cv2_dm_report, 커스텀 JWT의 app_user_id claim 기준 RLS. 이제 그룹채팅까지 담을 데이터 모델을 정해야 한다.
제약·전제:
- 스케일: MAU ~7.5K, 동시접속 피크 ~95. 부하는 병목이 아니다.
- DM과 그룹을 하나로: 제품상 DM·그룹을 통합 채팅 경험으로 가져가기로 했다(에픽 결정). 클라이언트도 단일 레이어로 통합(WS3).
- 방별 신원: 같은 유저라도 방마다 채팅 프로필(닉네임·동/호·역할)이 다르다. 현재 Sendbird는 전역 닉네임 1개뿐이라 메시지
metaArray에 방별 닉네임을 스탬핑하는 해킹으로 우회 중(packages/chat). 프로필 데이터의 소유자는 백엔드ChatProfile이다. - 현 그룹 기능 실측(
packages/chat): 메시지 text/이미지/영상/파일/og(링크 미리보기)/admin/삭제(soft), 리액션은like만, 답글(parent 스냅샷), hide-for-me, 검색(text/og), operator/mute/ban/freeze. 멘션·타이핑·메시지 핀·편집·번역·forward·읽음 영수증은 미사용. - 그때 불확실했던 것: 그룹방당 메시지 볼륨(파티셔닝 필요 여부)은 백필(WS6) 전 미측정.
검토한 대안
| 대안 | 채택 안 한 이유 |
|---|---|
DM(cv2_dm_*) 유지 + 그룹용 별도 스키마 | 스키마 2벌·클라 데이터 경로 2벌. “통합 채팅” 목표와 배치되고, 리치 기능(첨부/리액션/핀)을 두 번 구현해야 함 |
멤버십을 2-컬럼 쌍으로(cv2_dm_thread의 user_low_id/user_high_id처럼) | 2인 전용. 그룹(N인)은 멤버당 1행이 필요 → 멤버 테이블 불가피. (DM의 2-컬럼도 통합 시 멤버행으로 이관해야 함 → WS6) |
프로필·닉네임을 channel_member에 복제 | 실명↔익명 전환 시 전 멤버 row 동기화 부담. 신원 소유자(백엔드 ChatProfile)와 이중 소스. → scope 파생(옵션1′) 선택 |
| dev/prod Supabase 프로젝트 분리 / 지금 브랜칭 | 이번 스키마는 additive(기존 DM 미접촉·inert)라 공유 프로젝트 직접 적용해도 prod 영향 0. 격리는 위험 단계(WS6 백필·alter)에서 — 지금 분리/브랜칭은 과한 셋업(레포에 Supabase CLI 인프라도 없음) |
Decision
통합 코어 3테이블 — supabase/migrations/0014_community_v2_chat_unified.sql:
channel:type(DM/GROUP)·entity_kind/entity_id(그룹↔앱 엔티티 링크)·identity_scope·name/image·nickname_format·is_frozen·last_message_at. DM=2인 채널, 그룹=N인 채널.channel_member: context-free 런타임 상태만(role·last_read_at·muted_until·is_banned·joined_at/left_at), PK(channel_id, user_id). 프로필 포인터 없음 — 신원은 아래 scope로 파생.message: 코어(type·body·parent_id·발신자 스냅샷·created_at/edited_at/deleted_at).typeenum =text/image/video/file/admin. 리치 payload(첨부·리액션·핀)는 WS2.- 테이블명은
cv2_접두 없이channel/channel_member/message(public 스키마에 동명 없음, DM은cv2_dm_*라 충돌 없음). - og(링크 미리보기)는 별도 타입이 아니다 —
text(body에 URL)로 두고, 미리보기 카드는 send 시점 1회 fetch한 스냅샷을 메시지 메타로 저장(WS2). Supabase엔 Sendbird 같은 자동 OG 크롤이 없고, 미리보기는 콘텐츠 종류가 아니라 렌더링 보강이라 타입을 늘리지 않는다. (매 렌더 refetch 대신 스냅샷 = 일관·저비용·오프라인 OK)
- 테이블명은
신원 = scope 기반(옵션1′): 멤버가 프로필을 들지 않고 channel.identity_scope로 파생한다. community:<chat_id> → 백엔드 ChatProfile(user, chat_id) live 참조 / global → 미래 글로벌 프로필 / 없으면 message의 발신자 스냅샷 fallback. 프로필 데이터는 백엔드 소유, Supabase에 복제하지 않음(cross-DB 머지는 현 chatSenderDisplay 패턴 재사용).
RLS = 멤버십 기반, auth.jwt() ->> 'app_user_id' 기준. 멤버십 판정은 security definer 함수 is_channel_member() 로 한다(채널멤버 RLS가 자기 테이블을 재조회하면 무한재귀 → RLS 우회 함수로 끊음). 쓰기는 최소화한다 — RLS의 행 검사는 “쓸 수 있는 컬럼”을 제한하지 못하므로: (a) 채널/멤버 생성은 클라에 열지 않는다(그룹=service_role 프로비저닝[선결 #4], DM=향후 security-definer RPC로 2인 강제·role 고정·원자 생성 — DM 클라 작업 WS3/WS6에서), (b) 허용하는 쓰기도 컬럼 GRANT로 좁힌다(channel_member는 last_read_at만 update, message는 서버생성 컬럼[created_at/deleted_* 등] 제외 insert). 결과적으로 클라 권한 = 채널/멤버/메시지 읽기 + message 안전-컬럼 insert + 본인 channel_member.last_read_at 수정. last_message_at 트리거는 전진만(백필 시각 역전 방지).
환경: 별도 프로젝트 신설 없이 기존 howmuchhome-community 재사용. 마이그레이션은 additive. 백엔드의 Supabase 접근·그룹 프로비저닝은 front-api 게이트웨이 경유(백엔드 직접 접근 금지)로 한다(선결 HMH-9769, 별도 ADR 후보).
범위 분할: 모더레이션 enforce(muted_until/is_banned/is_frozen를 실제로 막기)는 WS4, 리치 메시지·리액션·핀·block/report 일반화는 WS2, DM cv2_dm_* → 통합 이관과 dev/prod 브랜칭 격리는 WS6.
Consequences
좋아지는 것
- DM·그룹이 단일 모델. 클라 레이어·RLS·realtime을 한 벌로. DM 데이터도 같은 테이블로 백필(WS6).
- 방별 닉네임의
metaArray스탬핑 해킹 제거 →identity_scope한 곳에서 신원 파생(실명 전환이 자동 추적됨). - additive라 적용해도 운영 중 DM·그룹(Sendbird)에 영향 0, 롤백=DROP.
감수하는 것
- 멤버십 RLS에
security definer함수가 필요(재귀 회피) — 함수 소유자 권한으로 도는 코드가 하나 생김(리뷰 포인트). - 리치 기능(첨부/og/리액션/핀/편집·삭제/hide)이 아직 비어 있음 → WS2/WS4에서 채워야 실제 패리티.
- 신원이 cross-DB(Supabase 멤버십 + 백엔드 프로필)라 표시에 머지 한 단계가 늘 필요.
- 당분간 공유 프로젝트에서 dev 작업(브랜칭 격리는 WS6 전까지 없음) — additive라 저위험이지만 위험 작업은 WS6까지 미룸.
이 결정을 다시 열어야 할 때
- 그룹방 메시지 볼륨이 커져 단일
message가 버거우면 → 파티셔닝(백필 전 총량 측정으로 판단, WS6). - 동시접속이 Supabase Realtime
postgres_changes한도에 근접하면 → broadcast 전환. - 그룹 요구가 DM과 충분히 갈라져 통합이 오히려 복잡도를 키우면 → 모델 분리 재검토.
Amendment (2026-10-20, HMH-10093) — DM 채널 식별·생성·member 신원
본 ADR은 “DM=2인 채널(type=DM), 멤버 insert 는 향후 security-definer RPC”로 방향만 남겼다. DM 을 통합 스키마로 실제 전환(리액션·첨부 등 공용 레이어 재사용)하면서 DM 고유의 두 지점을 구체화한다. DM 은 메시지/렌더 레이어를 “2인 그룹처럼” 재사용하되, 다음은 그룹과 다르다:
① 쌍 멱등 식별 — 그룹 멱등키는 백엔드가 발급하는 community:<chatUrl>. DM 은 발급자 없이 두 사람 쌍으로 멱등해야 한다(cv2_dm 의 (user_low,user_high) unique 대응). → channel.identity_scope = 'dm:<low>:<high>'(user id 정렬쌍) + partial unique index(type='DM' and deactivated_at is null). 그룹 scope 와 같은 축이라 충돌 없음.
② 상대 비대칭 표시(viewer-relative) — 그룹은 channel.name 하나로 충분하지만, DM 은 A 가 B 를·B 가 A 를 봐야 한다(channel 레벨 이름으로 표현 불가). → channel_member 에 display_nickname/display_image(nullable) 스냅샷 컬럼 추가. DM 생성 시 각 멤버에 방 닉네임 스냅샷(예: “113동 홍길동”, cv2_dm 과 동일 동작)을 기록. 그룹은 null(메시지 sender_nickname 스냅샷 사용) — 무영향.
생성 경로 — 클라 channel/member insert 정책이 없는 경계(그룹=service_role 프로비저닝)를 보존하면서 DM 은 사용자 개시다. → cv2_create_or_get_dm(peer_id, my_nick, my_img, peer_nick, peer_img) security-definer RPC(execute = authenticated). caller(app_user_id)·상대 스냅샷으로 (low,high) 정렬 → scope 조회(멱등) → 없으면 channel + 2 member 생성. 동시 레이스는 unique index + unique_violation 재조회. (그룹의 service_role 프로비저닝 RPC/엔드포인트와 별개 — DM 만 이 RPC.)
type='DM' 컬럼은 유지한다(RLS·렌더·목록·푸시의 “DM이면” 분기가 명확 — 없애고 GROUP 으로 동일시하면 위 ①②·푸시·차단 분기를 다른 신호로 재구현해야 해 득보다 실).
마이그레이션 0018_community_v2_dm_channel.sql. 후속(별도 티켓): DM 화면 통합 전환(리액션·첨부 획득) → cv2_dm_* 데이터 마이그 → DM 기능 포팅(차단·신고·읽음).