예약의 정석

테이블 (10)

객실 (Room)

  • 식별자 (id) — bigint — 기본 키 — NOT NULL — 고유 식별자 [추가 조건: 자동증가]
  • 객실명 (name) — varchar(255) — NOT NULL — 객실 이름(예: 디럭스 더블, 오션뷰 스위트)
  • 기본 가격 (base_price) — DECIMAL(10,2) — NOT NULL — 객실의 기본 가격 (최소 가격 산정용)
  • 수용 인원 (max_capacity) — int — NOT NULL — 객실 최대 수용 인원
  • 침대 유형 (bed_type) — varchar(30) — NOT NULL — 침대 유형 (예: Single, Double, Twin, King)
  • 설명 (description) — varchar(255) — 객실 상세 설명
  • 활성화 여부 (is_reservable) — boolean — 객실 기본 판매 가능 여부(관리자가 지정)
  • 생성 일시 (created_at) — datetime — NOT NULL — 객실 생성 일시
  • 수정 일시 (updated_at) — datetime — 객실 수정 일시
  • 숙소 ID (accommodation_id) — bigint — 외래 키 → 숙소.식별자 — NOT NULL — 숙소 테이블 PK
  • 호수 (room_label) — varchar(50) — NOT NULL — 객실 호수(101호, 102호)

객실 재고 및 가격 (RoomInventory)

  • 식별자 (id) — bigint — 기본 키 — NOT NULL — 고유 식별자 [추가 조건: 자동증가]
  • 재고 날짜 (inventory_date) — date — NOT NULL — 재고 정보를 관리할 날짜(예 : 20251019)
  • 가격 (price) — DECIMAL(10,2) — 해당 날짜의 1박 판매 가격
  • 활성화 여부 (is_stocked) — boolean — NOT NULL — 해당 날짜 판매 마감 여부(관리자가 지정)
  • 생성 일시 (create_at) — datetime — NOT NULL — 재고 생성 일시
  • 수정 일시 (update_at) — datetime — 재고 수정 일시
  • 객실 ID (room_id) — bigint — 외래 키 → 객실.식별자 — NOT NULL — 객실 테이블 PK

결제 (Payment)

  • 식별자 (id) — bigint — 기본 키 — NOT NULL — 고유 식별자 [추가 조건: 자동증가]
  • PG 결제 번호 (pg_transaction_number) — varchar(255) — NOT NULL — 결제 대행사(PG사)의 거래 고유 번호. (실제 연동 시 필수)
  • 결제 금액 (amount) — DECIMAL(10,2) — NOT NULL — 실제 결제 금액
  • 결제 수단 (payment_method) — varchar(20) — NOT NULL — 결제 수단( CARD, KAKAO_PAY, NAVER_PAY, TOSS_PAY)
  • 결제 카드사 (card_company) — varchar(20) — 결제 카드사 정보(KB, SINHAN, WOORI)
  • 결제 상태 (payment_status) — varchar(20) — NOT NULL — 결제 상태 (예: PAID, FAILED, CANCEL)
  • 결제 시간 (paid_at) — datetime — NOT NULL — 결제가 성공적으로 완료된 시간
  • 환불 시간 (refunded_at) — datetime — 환불이 성공적으로 완료된 시간
  • 예약 ID (reservation_id) — bigint — 외래 키 → 예약.식별자 — NOT NULL — 예약 테이블 PK

결제 취소 목록 (PaymentCancelHistory)

  • 식별자 (Key) — bigint — 기본 키 — NOT NULL — 고유 식별자 [추가 조건: 자동증가]
  • 취소 금액 (Field2) — DECIMAL(10,2) — 기본 키 — 취소 금액
  • 취소 이유 (Field) — varchar(255) — NOT NULL — 취소 사유
  • 결제 ID (id) — bigint — 외래 키 → 결제.식별자 — NOT NULL — 결제 테이블 PK
  • 생성 일시 (Field3) — datetime — NOT NULL — 생성 일시
  • 수정 일시 (Field4) — datetime — 수정 일시

리뷰 (Review)

  • 식별자 (id) — bigint — 기본 키 — NOT NULL — 고유 식별자 [추가 조건: 자동증가]
  • 닉네임 (nickname) — varchar(50) — NOT NULL — 리뷰 작성자 활동명(작성 당시 기준)
  • 평점 (rating) — DECIMAL(3, 1) — NOT NULL — 총 평점 (정수 1~5까지 사용)
  • 내용 (content) — varchar(300) — NOT NULL — 리뷰 내용 (후기)
  • 생성 일시 (created_at) — datetime — NOT NULL — 리뷰 작성 일시
  • 숙소 ID (accommodation_id) — bigint — 외래 키 → 숙소.식별자 — NOT NULL — 숙소 테이블 PK
  • 유저 ID (user_id) — bigint — 외래 키 → 사용자.식별자 — NOT NULL — 유저 테이블 PK
  • 예약 ID (reservation_id) — bigint — 외래 키 → 예약.식별자 — NOT NULL — 예약 테이블 PK

사용자 (Member)

  • 식별자 (id) — bigint — 기본 키 — NOT NULL — 고유 식별자 [추가 조건: 자동증가]
  • 유저 로그인 이메일 (email) — varchar(100) — NOT NULL — 로그인 이메일, [제약조건: 유니크]
  • 비밀번호 (password) — varchar(255) — NOT NULL — 암호화된 비밀번호
  • 이름 (name) — varchar(20) — NOT NULL — 실명(예약자명 확인용)
  • 닉네임 (nickname) — varchar(20) — NOT NULL — 서비스 활동명(리뷰 등에 사용)
  • 휴대폰 번호 (phone_number) — varchar(13) — NOT NULL — 휴대폰 번호(예약 알림용)
  • 회원 등급 (grade) — varchar(20) — NOT NULL — 회원 등급 (예: BRONZE, SILVER, GOLD)
  • 계정 활성화 상태 (is_active) — BOOLEAN — NOT NULL — 계정 활성화 상태( 탈퇴 시 FALSE)
  • 탈퇴 일시 (deleted_at) — DATETIME — 탈퇴 일시 (Soft Delete용)
  • 생성 일시 (created_at) — DATETIME — NOT NULL — 계정 가입 일시
  • 수정 일시 (updated_at) — DATETIME — 계정 수정 일시

숙소 (Accommodation)

  • 식별자 (id) — bigint — 기본 키 — NOT NULL — 고유 식별자 [추가 조건: 자동증가]
  • 숙소명 (name) — varchar(50) — NOT NULL — 숙소 이름(예 : 제주 스위트 호텔)
  • 숙소 유형 (type) — varchar(30) — NOT NULL — 유형( HOTEL, PENSION, MOTEL, GUESTHOUSE)
  • 설명 (description) — varchar(255) — 숙소 상세 설명
  • 편의 시설 목록 (amenities) — varchar(255) — 편의 시설 목록 (JSON)
  • 체크인 시간 (check_in_time) — time — NOT NULL — 체크인 가능 시간 (예: 15:00:00)
  • 체크아웃 시간 (check_out_time) — time — NOT NULL — 체크아웃 시간 (예: 11:00:00)
  • 평점 (rating_average) — DECIMAL(3, 1) — NOT NULL — 사용자 평점(리뷰 등록 시, 리뷰 테이블 이용하여 계산)
  • 활성화 여부 (is_operational) — boolean — NOT NULL — 숙소 판매 활성화 여부(관리자가 지정)
  • 생성 일시 (created_at) — datetime — NOT NULL — 숙소 등록 일시
  • 수정 일시 (updated_at) — datetime — 숙소 수정 일시
  • 도시명 (city) — varchar(50) — NOT NULL — 시/도, 시/군/구
  • 우편번호 (zipcode) — varchar(10) — NOT NULL — 우편번호 (5자리)
  • 상세주소 (street) — varchar(255) — NOT NULL — 도로명/지번 및 상세 주소
  • 평점 총 합산 (total_rating_sum) — bigint — NOT NULL — 평점 총 합산(평점 계산 시 활용)
  • 평점 총 갯수 (review_count) — bigint — NOT NULL — 평점 총 갯수(평졈 계산 및 리뷰 총 갯수 보여줄 때 활용)

예약 (Reservation)

  • 식별자 (id) — bigint — 기본 키 — NOT NULL — 고유 식별자 [추가 조건: 자동증가]
  • 체크인 날짜 (check_in_date) — date — NOT NULL — 체크인 날짜
  • 체크아웃 날짜 (check_out_date) — date — NOT NULL — 체크 아웃 날짜
  • 인원수 (guest_count) — int — NOT NULL — 예약 총 인원수
  • 금액 (total_price) — int — NOT NULL — 총 결제 금액 (할인, 수수료 포함 최종 금액)
  • 상태 (reservationStatus) — varchar(255) — NOT NULL — 예약 상태 (예: PENDING, CONFIRMED, CANCELED, COMPLETED, EXPIRED)
  • 예약 확정 일시 (confrimedAt) — datetime — 예약 확정 일시
  • 투숙자 이름 (guest_name) — varchar(50) — NOT NULL — 실제 투숙자 이름(예약자와 다를 수 있음)
  • 투숙자 휴대폰 번호 (guest_phone_number) — varchar(20) — NOT NULL — 실제 투숙자 연락처
  • 생성 일시 (created_at) — datetime — NOT NULL — 생성 일시
  • 수정 일시 (updated_at) — datetime — 수정 일시
  • 유저 ID (user_id) — bigint — 외래 키 → 사용자.식별자 — NOT NULL — 유저 테이블 PK
  • 숙소 ID (accommodation_id) — bigint — 외래 키 → 숙소.식별자 — NOT NULL — 숙소 테이블 PK
  • 객실 ID (room_id) — bigint — 외래 키 → 객실.식별자 — NOT NULL — 객실 테이블 PK
  • 예약 취소 일시 (cancledAt) — datetime — 예약 취소 시간

이미지 (Image)

  • 식별자 (id) — bigint — 기본 키 — NOT NULL — 고유 식별자 [추가 조건: 자동증가]
  • 유형 (target) — varchar(20) — NOT NULL — 이미지가 속한 대상 유형 (예: ACCOMMODATION, ROOM)
  • 경로 (url) — varchar(1000) — NOT NULL — 이미지가 저장된 경로 (S3 등 클라우드 스토리지 URL)
  • 대표 여부 (is_main) — boolean — NOT NULL — 해당 대상의 대표 이미지 여부
  • 이미지 순서 (sort_order) — int — NOT NULL — 이미지 표시 순서(0.....9999) 오름 차순
  • 생성 일시 (created_at) — datetime — NOT NULL — 이미지 생성 일시
  • 수정 일시 (updated_at) — datetime — 이미지 수정 일시
  • 객실 ID (room_id) — bigint — 외래 키 → 객실.식별자 — 객실 테이블 PK
  • 숙소 ID (accommodation_id) — bigint — 외래 키 → 숙소.식별자 — 숙소 테이블 PK

이벤트 로그 (EventLog)

  • 식별자 (id) — bigint — 기본 키 — NOT NULL — 고유 식별자 [추가 조건: 자동증가]
  • 이벤트 ID (event_id) — varchar(255) — NOT NULL — 이벤트 고유 식별자 (UUID), 제약조건: 유니크
  • 이벤트 타입 (event_type) — varchar(255) — NOT NULL — 이벤트 타입 (예: REVIEW_CREATED)
  • 이벤트 발생 PK 값 (aggregate_id) — bigint — NOT NULL — 관련 도메인 PK (예: review_id)
  • 생성 일시 (created_at) — datetime — NOT NULL — 이벤트 생성 일시