DM (1:1 다이렉트 메시지)
얼마집 앱의 1:1 다이렉트 메시지입니다. 채팅방에서 상대 프로필을 통해 1:1 대화를 시작하고, 실시간 송수신·안읽음·읽음 표시·푸시를 제공합니다.
DM은 통합 채팅(Supabase
channel/channel_member/message)의 일부입니다. 과거 별도 cv2 DM 스택(cv2_dm_*테이블·features/dm/*)이 있었으나, DM 통합 cutover(WS7,dm_unified_enabledprod=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) 중복을 방지. 생성/조회는 멱등 RPCcv2_create_or_get_dm(0018 — 이름에 cv2 접두가 남아있으나 통합 채널을 만든다). - channel_member / message: 그룹과 공유(멤버당 1행, 메시지 텍스트/첨부/리액션). 표시 신원은 front-api 가 생성 맥락(chatUrl) 방의 백엔드 ChatProfile 로 서버 결정합니다(클라 스냅샷 위조 방지, HMH-10094).
- 차단/신고:
chat_block(user-pair 차단, 0019) ·chat_report_dmRPC(대화 단위 신고 + 메시지 스냅샷, 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 |
| 메시지 렌더·입력·차단 footer | features/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 채팅」 — 채팅 메시지 아바타 탭 →
ChatProfileSheet버튼 →routes.chatDmThread({peerId}). - 채팅 헤더 DM함 진입 —
CommunityHeader의DmEntryButton(안읽음 뱃지, 통합 unread). 채팅 탭에서만 노출.
데이터 보안은 RLS가 담당합니다(채널 멤버만 조회).
푸시 알림
통합 DM 푸시는 클라이언트가 전송 성공 후 백엔드 푸시 API를 직접 호출합니다(HMH-10143).
- 요청
data: { type: 'DM', senderId: <내 id> }(전송 시 snakesender_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.ts | COMMUNITY_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)