WaitPop

Tables (15)

checkins

  • checkin_id — BIGINT — Primary key — NOT NULL
  • qr_ticket_id — BIGINT — Foreign key → qr_tickets.qr_ticket_id — NOT NULL
  • checked_by — BIGINT — Foreign key → users.user_id — NOT NULL — 환불 차감액
  • checked_at — DATETIME — NOT NULL

event_images

  • image_id — BIGINT — Primary key — NOT NULL
  • event_id — BIGINT — Foreign key → events.event_id — NOT NULL
  • image_url — VARCHAR(500) — NOT NULL — 필수 확인 여부 (공통 LMS=1)
  • sort_order — INT — NOT NULL

event_operation_guides

  • guide_id — BIGINT — Primary key — NOT NULL
  • event_id — BIGINT — Foreign key → events.event_id — 만료 처리 일시 (Batch 기록)
  • guide_type — VARCHAR(20) — NOT NULL — 최초 확인 일시
  • title — VARCHAR(200) — NOT NULL — 동일 가이드 중복 확인 방지
  • content — TEXT — 연결 행사 ID. NULL = 공통 퀴즈
  • file_url — VARCHAR(500) — 연결 가이드 ID
  • is_required — TINYINT(1) — NOT NULL — 퀴즈 문항
  • created_at — DATETIME — NOT NULL

events

  • event_id — BIGINT — Primary key — NOT NULL
  • organizer_id — BIGINT — Foreign key → users.user_id — NOT NULL — 카테고리 필터용
  • title — VARCHAR(200) — NOT NULL
  • description — TEXT
  • category — VARCHAR(50) — 지역 필터용 (서울/경기/부산 등)
  • region — VARCHAR(50) — 장소명 (명화라이브홀 등)
  • venue_name — VARCHAR(200) — 상세주소 (주소 검색 API 입력)
  • venue_address — VARCHAR(500) — 위도 (주소 입력 시 지오코딩 자동 채움)
  • venue_lat — DECIMAL(10, 7) — 경도 (자동 채움)
  • venue_lng — DECIMAL(10, 7) — 행사 시작일
  • start_date — DATE — 행사 종료일
  • end_date — DATE — 예약 오픈 예정 일시 (ACTIVE->OPEN 스케줄러 기준)
  • opened_at — DATETIME — PENDING(승인대기)->ACTIVE(상세공개,예약불가)->OPEN(예약가능)->CLOSED(종료) / SUSPENDED(중단) / REJECTED(반려)
  • status — VARCHAR(20) — NOT NULL — REJECTED 상태 시 반려 사유
  • rejection_reason — TEXT — 부스 배치도 PDF S3 URL (참가사 개별 안내)
  • booth_layout_url — VARCHAR(500) — 세부 타임라인 이미지 S3 URL
  • timeline_image_url — VARCHAR(500) — 대표 썸네일
  • thumbnail_url — VARCHAR(500) — 일반 / VIP / 1일권 등
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

guide_read_logs

  • log_id — BIGINT — Primary key — NOT NULL
  • guide_id — BIGINT — Foreign key → event_operation_guides.guide_id — NOT NULL
  • user_id — BIGINT — Foreign key → users.user_id — NOT NULL — 선택지 B
  • score — INT — 선택지 C
  • is_certified — TINYINT(1) — NOT NULL — 선택지 D
  • is_valid — TINYINT(1) — NOT NULL — 정답 (A/B/C/D)
  • certified_at — DATETIME — 정답 해설
  • expired_at — DATETIME — MANUAL(수동 작성) / AI(Spring AI 자동생성)
  • read_at — DATETIME — NOT NULL — 노출 여부

payments

  • payment_id — BIGINT — Primary key — NOT NULL
  • reservation_id — BIGINT — Foreign key → reservations.reservation_id — NOT NULL
  • payment_key — VARCHAR(200) — NOT NULL — 예약:결제 1:1 보장
  • order_id — VARCHAR(100) — NOT NULL — UUID + HMAC-SHA256 서명
  • method — VARCHAR(30) — NOT NULL — UNUSED / USED / EXPIRED
  • amount — INT — NOT NULL
  • status — VARCHAR(30) — NOT NULL — 체크인 처리 EVENT_ADMIN / STAFF
  • paid_at — DATETIME
  • cancelled_at — DATETIME

qr_tickets

  • qr_ticket_id — BIGINT — Primary key — NOT NULL
  • reservation_id — BIGINT — Foreign key → reservations.reservation_id — NOT NULL
  • qr_token — VARCHAR(512) — NOT NULL — 적용된 환불 정책 박제
  • status — VARCHAR(20) — NOT NULL — REQUESTED->PROCESSING->COMPLETED / REJECTED
  • issued_at — DATETIME — NOT NULL
  • used_at — DATETIME

quiz_submissions

  • submission_id — BIGINT — Primary key — NOT NULL
  • quiz_id — BIGINT — Foreign key → quizzes.quiz_id — NOT NULL
  • user_id — BIGINT — Foreign key → users.user_id — NOT NULL
  • selected_answer — CHAR(1) — NOT NULL

quizzes

  • quiz_id — BIGINT — Primary key — NOT NULL
  • event_id — BIGINT — Foreign key → events.event_id — NOT NULL
  • updated_at — DATETIME — NOT NULL

refund_requests

  • refund_id — BIGINT — Primary key — NOT NULL
  • reservation_id — BIGINT — Foreign key → reservations.reservation_id — NOT NULL
  • reason — VARCHAR(255)
  • refund_amount — INT — NOT NULL — 정산 지급액 (순매출 - 수수료)
  • policy_snapshot — VARCHAR(500) — PENDING -> PAID
  • status — VARCHAR(30) — NOT NULL — Excel 정산 파일 S3 경로
  • requested_at — DATETIME — NOT NULL
  • completed_at — DATETIME

reservations

  • reservation_id — BIGINT — Primary key — NOT NULL
  • user_id — BIGINT — Foreign key → users.user_id — NOT NULL — PENDING->CONFIRMED->(CANCEL_REQUESTED->REFUND_PROCESSING->REFUNDED) / EXPIRED / FAILED / USED
  • event_id — BIGINT — Foreign key → events.event_id — NOT NULL
  • ticket_option_id — BIGINT — Foreign key → ticket_options.ticket_option_id — NOT NULL
  • reservation_no — VARCHAR(30) — NOT NULL — 실제 참가자 이름(받는사람)
  • quantity — INT — NOT NULL
  • total_amount — INT — NOT NULL — TossPayments 결제 키
  • status — VARCHAR(30) — NOT NULL — 콜백 멱등 처리 기준
  • applicant_name — VARCHAR(50) — NOT NULL — 카드 / 간편결제 / 가상계좌
  • phone — VARCHAR(20) — NOT NULL
  • email — VARCHAR(100) — NOT NULL
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

settlements

  • settlement_id — BIGINT — Primary key — NOT NULL
  • event_id — BIGINT — Foreign key → events.event_id — NOT NULL
  • organizer_id — BIGINT — Foreign key → users.user_id — NOT NULL
  • period_start — DATE — NOT NULL
  • period_end — DATE — NOT NULL
  • gross_amount — INT — NOT NULL — 배너 이미지 경로 (S3)
  • refund_amount — INT — NOT NULL — 노출 우선순위
  • fee_rate — DECIMAL(5, 2) — NOT NULL — ACTIVE -> EXPIRED
  • fee_amount — INT — NOT NULL — NULL = 공통 LMS 가이드
  • net_amount — INT — NOT NULL — COMMON(공통 LMS) / INDIVIDUAL(참가사 개별 안내)
  • status — VARCHAR(20) — NOT NULL — 가이드/강의 제목
  • report_url — VARCHAR(500) — 가이드 본문 (HTML/Markdown)
  • created_at — DATETIME — NOT NULL
  • paid_at — DATETIME

ticket_options

  • ticket_option_id — BIGINT — Primary key — NOT NULL
  • event_id — BIGINT — Foreign key → events.event_id — NOT NULL
  • name — VARCHAR(100) — NOT NULL — 총 정원
  • price — INT — NOT NULL — 잔여 - 동시성 차감 대상
  • total_capacity — INT — NOT NULL — 1인 최대 구매 수량 (주최사 설정)
  • remaining_capacity — INT — NOT NULL — 회차 시간 (회차제일 때, 아니면 NULL)
  • max_per_user — INT — NOT NULL — 주문자(계정)
  • session_at — DATETIME — UUID 기반 예약번호
  • created_at — DATETIME — NOT NULL

users

  • user_id — BIGINT — Primary key — NOT NULL
  • email — VARCHAR(100) — NOT NULL
  • password — VARCHAR(255) — 소셜 로그인 시 NULL 허용
  • name — VARCHAR(255) — NOT NULL
  • phone — VARCHAR(255)
  • role — VARCHAR(30) — NOT NULL — USER / EVENT_ADMIN / STAFF / SUPER_ADMIN
  • parent_admin_id — BIGINT — Foreign key → users.user_id — STAFF인 경우 소속 EVENT_ADMIN의 user_id (자기참조)
  • status — VARCHAR(20) — NOT NULL — ACTIVE / SUSPENDED(정지) / DELETED(탈퇴)
  • provider — VARCHAR(20) — LOCAL / GOOGLE / KAKAO
  • must_change_pw — TINYINT(1) — NOT NULL — 발급계정 첫 로그인 시 비밀번호 변경 강제
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL
  • deleted_at — DATETIME — 탈퇴 시각 (소프트 딜리트, NULL이면 정상)

vip_banners

  • banner_id — BIGINT — Primary key — NOT NULL
  • event_id — BIGINT — Foreign key → events.event_id — NOT NULL
  • image_url — VARCHAR(500) — NOT NULL — 퀴즈 점수 (0~100). 퀴즈 없는 가이드는 NULL
  • priority — INT — NOT NULL — 이수 완료 여부 (퀴즈 80점 이상=1)
  • start_at — DATETIME — NOT NULL
  • end_at — DATETIME — NOT NULL
  • status — VARCHAR(20) — NOT NULL — 유효기간 내 여부 (만료 시 0)