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