Skip to Content
DM (1:1 다이렉트 메시지)

DM (1:1 다이렉트 메시지)

얼마집 앱의 1:1 다이렉트 메시지입니다. 채팅방에서 상대 프로필을 통해 1:1 대화를 시작하고, 실시간 송수신·안읽음·읽음 표시·푸시를 제공합니다.

DM은 통합 채팅(Supabase channel/channel_member/message)의 일부입니다. 과거 별도 cv2 DM 스택(cv2_dm_* 테이블·features/dm/*)이 있었으나, DM 통합 cutover(WS7, dm_unified_enabled prod=on) 후 레거시 cv2 코드는 제거됐습니다(HMH-10581). cv2_dm_* 테이블(데이터)은 백업·soak 후 별도 drop 예정입니다.

현재 DM은 native 앱(apps/native-app)에만 있습니다. web(apps/app)의 DM 페이지·진입점은 삭제됐습니다.

데이터 모델 (통합 채팅)

DM은 통합 채팅 데이터 모델을 그대로 씁니다 — 데이터 모델 결정은 ADR-0018 참고. community-v2 전용 Supabase 프로젝트에 저장되고, 백엔드가 발급한 커스텀 JWT의 app_user_id claim으로 RLS를 통제합니다.

  • channel(type='DM'): 1:1 채널. identity_scope = dm:<low>:<high>(두 user id 를 정렬한 쌍)로 (a,b)/(b,a) 중복을 방지. 생성/조회는 멱등 RPC cv2_create_or_get_dm(0018 — 이름에 cv2 접두가 남아있으나 통합 채널을 만든다).
  • channel_member / message: 그룹과 공유(멤버당 1행, 메시지 텍스트/첨부/리액션). 표시 신원은 front-api 가 생성 맥락(chatUrl) 방의 백엔드 ChatProfile 로 서버 결정합니다(클라 스냅샷 위조 방지, HMH-10094).
  • 차단/신고: chat_block(user-pair 차단, 0019) · chat_report_dm RPC(대화 단위 신고 + 메시지 스냅샷, 0020). 결정 근거 [ADR-0020] 및 과도기 설계 ADR-0015.

클라이언트 구조 (native)

역할경로 (apps/native-app/src/…)
대화방app/native/chat-dm/[peerId].tsx → features/chat/ChatDmScreen.tsx
DM함(목록)app/native/dm/index.tsx → features/chat/ChatDmListScreen.tsx
메시지 렌더·입력·차단 footerfeatures/chat/DmMessageList.tsx · DmMessageInput.tsx · DmBlockedFooter.tsx
안읽음 뱃지features/chat/DmEntryButton.tsx + useChannelDmTotalUnread.ts
채팅 core(병합·realtime)features/chat/useChannelChatCore.ts, @howmuchhome-web/chat-core
Supabase 클라이언트 + 토큰features/chat/supabaseClient.ts · useCommunityV2Supabase.ts
프로필 진입(1:1 채팅)features/community/chat/ChatProfileSheet.tsx

라우트(lib/navigation/routes.ts): dmList(/native/dm), chatDmThread({peerId, chatUrl?, …})(/native/chat-dm/[peerId]). 채널은 첫 전송 시 lazy 생성되므로 진입은 peer id 기준입니다.

토큰 발급: native는 쿠키 세션이 없어 CommunityV2API.getSupabaseToken이 front-api(apps/api/.../community-v2/supabase-token)를 호출합니다. front-api가 Authorization을 메인 백엔드 /user/me로 확인 후 커스텀 JWT를 서명합니다. useCommunityV2Supabase가 만료 전 Realtime auth 갱신·AppState 복귀 재구독·에러 backoff를 처리합니다(그룹/DM 공용).

진입점

  1. 프로필 「1:1 채팅」 — 채팅 메시지 아바타 탭 → ChatProfileSheet 버튼 → routes.chatDmThread({peerId}).
  2. 채팅 헤더 DM함 진입 — CommunityHeader의 DmEntryButton(안읽음 뱃지, 통합 unread). 채팅 탭에서만 노출.

데이터 보안은 RLS가 담당합니다(채널 멤버만 조회).

푸시 알림

통합 DM 푸시는 클라이언트가 전송 성공 후 백엔드 푸시 API를 직접 호출합니다(HMH-10143).

  • 요청 data: { type: 'DM', senderId: <내 id> } (전송 시 snake sender_id). 수신자는 상대.
  • 딥링크: 푸시 탭 시 data.type === 'DM' + sender_id → routes.chatDmThread({peerId: sender_id})로 통합 대화방 진입(lib/push.ts, 콜드스타트 navigation-ready 가드).
  • 엔드포인트: MessagingAPI.sendPush (POST v1/messaging/push/send).

백엔드 주도 DM 푸시(수신자 서버 해석)는 후속(HMH-10495).

환경변수

위치변수용도
front-api(apps/api)COMMUNITY_V2_SUPABASE_JWT_SECRET커스텀 JWT 서명
front-api(apps/api)COMMUNITY_V2_SUPABASE_URL, COMMUNITY_V2_SUPABASE_SECRET_KEY서버 라우트(토큰·채널 RPC·어드민 조회)
native config/env.tsCOMMUNITY_V2_SUPABASE(URL/anon key)DM/그룹 Supabase 접속

미구현 / 후속

  • cv2_dm_* 테이블·함수 drop: migration 0026_drop_cv2_dm.sql(HMH-10646, 백업 확보 후). prod 는 develop→main 릴리즈 시 CI 적용
  • 백엔드 주도 DM 푸시(HMH-10495)
Last updated on