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)