PuzzleMeet

테이블 (11)

검색어 즐겨찾기 (favorite_searches)

  • 즐겨찾기ID (id) — BIGINT — 기본 키 — NOT NULL
  • 유저ID (user_id) — BIGINT — 외래 키 → 유저.유저ID — NOT NULL — 유저 ID
  • 검색어 (keyword) — VARCHAR(100) — NOT NULL — 사용자가 저장한 검색어
  • 정규화 검색어 (normalized_keyword) — VARCHAR(100) — NOT NULL — UNIQUE(user_id, normalized_keyword) (DDL 필요)
  • 생성일시 (created_at) — DATETIME — NOT NULL

리액션메시지 (reaction_messages)

  • 리액션ID (id) — BIGINT — 기본 키 — NOT NULL
  • 참여ID (sender_member_id) — BIGINT — 외래 키 → 약속참여자.참여ID — NOT NULL — 공지를 보낸 참여자 id
  • 프리셋ID (reaction_preset_id) — BIGINT — 외래 키 → 리액션프리셋.프리셋ID — NOT NULL — 발송한 프리셋
  • 메시지내용 (content) — VARCHAR(50) — NOT NULL — 발송 시점 문구 스냅샷 (프리셋 수정·비활성화와 무관하게 보존)
  • 발송일시 (sent_at) — DATETIME — NOT NULL

리액션프리셋 (reaction_presets)

  • 프리셋ID (id) — BIGINT — 기본 키 — NOT NULL
  • 문구 (content) — VARCHAR(50) — NOT NULL — 프리셋 문구
  • 노출여부 (is_active) — BOOLEAN — NOT NULL — 노출 여부(비활성화 시 신규 선택 불가, 기존 발송 이력은 보존)

리프레시 토큰 (refresh_tokens)

  • 토큰ID (id) — BIGINT — 기본 키 — NOT NULL
  • 토큰 해시 (token_hash) — VARCHAR(64) — NOT NULL — UNIQUE (DDL 필요). SHA-256 토큰 해시
  • 만료일시 (expires_at) — DATETIME — NOT NULL — 리프레시 토큰 만료 시각
  • 유저ID (user_id) — BIGINT — 외래 키 → 유저.유저ID — NOT NULL — 유저 ID

약속방 (meetings)

  • 약속ID (id) — BIGINT — 기본 키 — NOT NULL
  • 방장ID (host_user_id) — BIGINT — 외래 키 → 유저.유저ID — NOT NULL — 방장 user id
  • 약속이름 (title) — VARCHAR(50) — NOT NULL — 약속 이름
  • 약속일시 (meeting_at) — DATETIME — NOT NULL — 약속 일시
  • 목적지장소명 (destination_name) — VARCHAR(100) — NOT NULL — 목적지 장소명
  • 목적지주소 (destination_address) — VARCHAR(200) — 목적지 주소
  • 목적지위도 (destination_latitude) — DECIMAL(10, 7) — NOT NULL — 목적지 위도
  • 목적지경도 (destination_longitude) — DECIMAL(10, 7) — NOT NULL — 목적지 경도
  • 도착판정반경 (arrival_radius_m) — INT — NOT NULL — 도착 판정 반경(m)
  • 초대코드 (invite_code) — VARCHAR(20) — NOT NULL — UNIQUE (DDL 필요). 초대 코드
  • 상태 (status) — VARCHAR(20) — NOT NULL — WAITING/IN_PROGRESS/COMPLETED/CANCELED
  • 생성일시 (created_at) — DATETIME — NOT NULL
  • 수정일시 (updated_at) — DATETIME — NOT NULL

약속참여자 (meeting_members)

  • 참여ID (id) — BIGINT — 기본 키 — NOT NULL
  • 약속ID (meeting_id) — BIGINT — 외래 키 → 약속방.약속ID — NOT NULL — 참여 중인 약속 id
  • 유저ID (user_id) — BIGINT — 외래 키 → 유저.유저ID — NOT NULL — UNIQUE(meeting_id, user_id) (DDL 필요). 참여자 user id
  • 역할 (role) — VARCHAR(10) — NOT NULL — HOST/GUEST
  • 상태 (status) — VARCHAR(20) — NOT NULL — NOT_STARTED/MOVING/ARRIVED/LEFT
  • 이동수단 (transport_type) — VARCHAR(10) — SUBWAY/BUS/WALK (지도 API 호출 파라미터, 환승 시 갱신)
  • 이용노선 (transport_line) — VARCHAR(50) — 탑승 노선명 (환승 시 갱신될 수 있음)
  • 출발시각 (departed_at) — DATETIME — 출발 선언 시각
  • 도착시각 (arrived_at) — DATETIME — 도착 완료 시각
  • 예상소요시간 (estimated_duration_seconds) — INT — 지도 API 기반 예상 소요시간(초), 이동 중 재계산되어 갱신됨
  • 소요시간계산일시 (duration_calculated_at) — DATETIME — 예상 소요시간 마지막 계산/갱신 시각
  • 생성일시 (created_at) — DATETIME — NOT NULL
  • 수정일시 (updated_at) — DATETIME — NOT NULL
  • 닉네임 (nickname) — VARCHAR(30) — NOT NULL — 약속 내 표시 닉네임
  • 마지막 ETA 샘플 시각 (last_eta_sampled_at) — DATETIME — ETA 갱신 요청의 sampledAt; 오래된 sample이 최신 ETA를 덮지 않게 검증
  • 나간 시각 (left_at) — DATETIME — 약속 나가기 처리 시각

유저 (users)

  • 유저ID (id) — BIGINT — 기본 키 — NOT NULL
  • 카카오ID (kakao_id) — BIGINT — NOT NULL — UNIQUE (DDL 필요). 카카오 고유 회원번호
  • 닉네임 (nickname) — VARCHAR(50) — NOT NULL — 닉네임
  • 프로필이미지 (profile_image_url) — VARCHAR(500) — 카카오 프로필 이미지
  • 생성일시 (created_at) — DATETIME — NOT NULL
  • 수정일시 (updated_at) — DATETIME — NOT NULL

참여자이미지 (member_images)

  • 이미지ID (id) — BIGINT — 기본 키 — NOT NULL
  • 참여ID (meeting_member_id) — BIGINT — 외래 키 → 약속참여자.참여ID — NOT NULL — 이미지를 제공한 참여자
  • 이미지URL (image_url) — VARCHAR(500) — NOT NULL — 참여자가 업로드한 원본 이미지 URL
  • 기본이미지여부 (is_default_image) — BOOLEAN — NOT NULL — 시스템 기본 이미지 여부
  • 생성일시 (created_at) — DATETIME — NOT NULL

퍼즐조각 (puzzle_pieces)

  • 조각ID (id) — BIGINT — 기본 키 — NOT NULL
  • 페이지ID (puzzle_page_id) — BIGINT — 외래 키 → 퍼즐페이지.페이지ID — NOT NULL — 조각이 속한 퍼즐 페이지 id
  • 참여ID (meeting_member_id) — BIGINT — 외래 키 → 약속참여자.참여ID — NULL이면 시스템이 채운 빈 조각
  • 조각위치 (piece_index) — TINYINT — NOT NULL — 페이지 내 위치(1~4)
  • 공개여부 (is_revealed) — BOOLEAN — NOT NULL — 조각 공개(잠금 해제) 여부
  • 공개일시 (revealed_at) — DATETIME — 조각 공개 시각
  • 시스템채움여부 (is_system_filled) — BOOLEAN — NOT NULL — 시스템이 빈 조각을 채웠는지 여부

퍼즐컬렉션 (puzzle_collections)

  • 컬렉션ID (id) — BIGINT — 기본 키 — NOT NULL
  • 유저ID (user_id) — BIGINT — 외래 키 → 유저.유저ID — NOT NULL — 컬렉션 소유자 user id
  • 페이지ID (puzzle_page_id) — BIGINT — 외래 키 → 퍼즐페이지.페이지ID — NOT NULL — 적립한 퍼즐 페이지 id
  • 이미지URL (image_url) — VARCHAR(500) — NOT NULL — 적립 시점의 대표 이미지 스냅샷 (meeting/member 삭제와 무관하게 보존)
  • 적립일시 (collected_at) — DATETIME — NOT NULL — 퍼즐 페이지 적립 시각

퍼즐페이지 (puzzle_pages)

  • 페이지ID (id) — BIGINT — 기본 키 — NOT NULL
  • 약속ID (meeting_id) — BIGINT — 외래 키 → 약속방.약속ID — NOT NULL — 퍼즐이 속한 약속 id
  • 대표이미지ID (representative_member_image_id) — BIGINT — 외래 키 → 참여자이미지.이미지ID — 페이지 대표로 선정된 이미지
  • 페이지번호 (page_number) — INT — NOT NULL — 페이지 순번(1부터)
  • 생성일시 (created_at) — DATETIME — NOT NULL