고투엑스코리아_ERD

테이블 (5)

chat_room

  • id — BIGINT — 기본 키 — NOT NULL — 내부 식별자
  • uuid — CHAR(36) — NOT NULL — 외부 노출용 식별자
  • name — VARCHAR(100) — NOT NULL — 1~100자, 렌더링 시 escape 처리
  • status — VARCHAR(20) — NOT NULL — ACTIVE / CLOSED (전원 퇴장 시 CLOSED, 삭제하지 않음)
  • last_sequence_no — BIGINT — NOT NULL — 방 내 최신 메시지 순번 캐시 (FOR UPDATE로 채번)
  • last_message_at — TIMESTAMP — 목록 정렬 기준. 메시지 없으면 NULL -> COALESCE(last_message_at, created_at)로 정렬
  • created_at — TIMESTAMP — NOT NULL

chat_room_member

  • room_id — BIGINT — 외래 키 → chat_room.id — NOT NULL — FK -> chat_room.id
  • user_id — BIGINT — 외래 키 → user.id — NOT NULL — FK -> user.id
  • role — VARCHAR(20) — NOT NULL — HOST(생성자, 상징적 표시) / MEMBER, 배타적 권한 없음, 승계 없음
  • status — VARCHAR(20) — NOT NULL — PENDING(초대됨) / ACTIVE(수락함) / LEFT(나감)
  • last_read_sequence_no — BIGINT — PENDING 동안 NULL. 수락 시점에 chat_room.last_sequence_no로 설정
  • visible_from_sequence_no — BIGINT — PENDING 동안 NULL. 수락 시점 값 이하 메시지는 조회 불가
  • joined_at — TIMESTAMP — PENDING 동안 NULL. 수락 시점에 설정

message

  • id — BIGINT — 기본 키 — NOT NULL — 내부 식별자, 전역 유일
  • uuid — CHAR(36) — NOT NULL — 외부 노출용 식별자
  • room_id — BIGINT — 외래 키 → chat_room.id — NOT NULL — FK -> chat_room.id
  • sender_id — BIGINT — 외래 키 → user.id — NOT NULL — FK -> user.id, 탈퇴해도 유지(FK 정합성 위해 User는 물리삭제 안함)
  • content — TEXT — NOT NULL — 최대 1000자(trim 이후 기준), 순수 텍스트, 렌더링 시 escape 필수
  • sequence_no — BIGINT — NOT NULL — 방 내 순번, sequence_no > visible_from_sequence_no 인 것만 조회 가능
  • created_at — TIMESTAMP — NOT NULL

refresh_token

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → user.id — NOT NULL — FK -> user.id
  • token_hash — VARCHAR(255) — NOT NULL — 원문이 아닌 해시로 저장
  • session_id — CHAR(36) — NOT NULL — 기기/로그인 세션 식별자, 멀티 디바이스 지원 + WebSocket 소켓 매핑에 사용
  • revoked_at — TIMESTAMP — Rotate 또는 탈취 탐지 시 폐기 시각
  • expires_at — TIMESTAMP — NOT NULL
  • created_at — TIMESTAMP — NOT NULL

user

  • id — BIGINT — 기본 키 — NOT NULL — 내부 식별자 (FK/조인용)
  • uuid — CHAR(36) — NOT NULL — 외부 노출용 식별자 (API/JWT)
  • email — VARCHAR(255) — NOT NULL — 탈퇴 시 익명화: withdrawn_{uuid}@deleted.local
  • password_hash — VARCHAR(255) — NOT NULL — bcrypt 또는 Argon2id
  • nickname — VARCHAR(50) — NOT NULL — 탈퇴 시 "탈퇴한 사용자"로 익명화
  • status — VARCHAR(20) — NOT NULL — ACTIVE / WITHDRAWN
  • created_at — TIMESTAMP — NOT NULL