netmarble-chat

테이블 (5)

메시지 (message)

  • PK (message_id) — bigint — 기본 키 — NOT NULL
  • FK (chat_room_id) — bigint — 외래 키 → 채팅방.PK — NOT NULL
  • FK (user_id) — bigint — 외래 키 → 유저.PK — User 테이블 참조 (누가 보냈는지. 시스템 메시지일 경우 null)
  • (message_type) — varchar — NOT NULL — TEXT, SYSTEM 등 메시지의 기본 성격 정의. (이미지/스티커는 아래 Attachment에서 처리)
  • (content) — text — NOT NULL — (검색 기능 최적화를 위해 이 컬럼에 DB의 'Full-Text Index'를 적용합니다.)
  • (created_at) — timestamp — NOT NULL

유저 (user)

  • PK (user_id) — bigint — 기본 키 — NOT NULL
  • (nickname) — varchar — NOT NULL — 채팅방에서 사용
  • (is_active) — boolean — NOT NULL
  • (created_at) — timestamp — NOT NULL

참석자 (participant)

  • PK (participant_id) — bigint — 기본 키 — NOT NULL
  • FK (chat_room_id) — bigint — 외래 키 → 채팅방.PK — NOT NULL — ChatRoom 테이블 참조
  • FK (user_id) — bigint — 외래 키 → 유저.PK — NOT NULL — User 테이블 참조
  • FK (last_read_message_id) — bigint — 외래 키 → 메시지.PK — 이 방에서 유저가 마지막으로 읽은 메시지 ID. (메시지 읽음 처리 기능을 위한 워터마크 포인트)
  • (joined_at) — timestamp — NOT NULL — 채팅방에 새로 들어온 사람은 들어온 시점 이후의 메시지만 읽음 카운트에 포함되어야 합니다. (이 로직은 joined_at 컬럼과 비교하여 처리합니다.)
  • (left_at) — timestamp — 채팅방 나가기 기능, 값이 존재하면 퇴장한 유저로 간주, 이전까지의 채팅 내역은 유지

채팅방 (chat_room)

  • PK (chat_room_id) — bigint — 기본 키 — NOT NULL
  • (name) — varchar — NOT NULL
  • (is_active) — boolean — NOT NULL — 방 활성화 상태. (기본값 true. 방장이 방을 폭파하거나 모두가 나갔을 때 데이터를 삭제하지 않고 false로 변경하는 Soft Delete 방식 적용)
  • (created_at) — timestamp
  • (image_url) — varchar

첨부 파일 (스티커/이미지) (attachment)

  • PK (attachment_id) — bigint — 기본 키 — NOT NULL
  • PK (message_id) — bigint — 외래 키 → 메시지.PK — NOT NULL — Message 테이블 참조. (하나의 메시지에 여러 개의 이미지/스티커가 묶일 수 있는 1:N 구조)
  • (file_url) — varchar — NOT NULL — 실제 스티커 이미지 리소스 경로 또는 업로드된 이미지 URL
  • (file_type) — varchar — NOT NULL — IMAGE, STICKER 등으로 프론트엔드에서 렌더링 방식을 결정할 타입
  • (created_at) — timestamp — NOT NULL