커피숍 주문 시스템

테이블 (9)

Kafka 발행 예정 이벤트 (OutboxEvents)

  • 이벤트ID (id) — bigint — 기본 키 — NOT NULL
  • 이벤트 발생 도메인 (aggregate_type) — varchar(50) — NOT NULL — ORDER, POINT 등 이벤트 발생 도메인
  • 도메인의 PK (aggregate_id) — bigint — NOT NULL — 해당 도메인의 PK
  • 이벤트 유형 (event_type) — varchar(100) — NOT NULL — 이벤트 유형
  • 페이로드 (payload) — text — NOT NULL — Kafka로 발행할 JSON 페이로드
  • 발행 완료 여부 (published) — boolean — NOT NULL — 발행 완료 여부
  • 발행 완료 일시 (published_at) — datetime — 실제 발행 완료 일시
  • 생성일 (created_at) — datetime — NOT NULL
  • 수정일 (modified_at) — datetime — NOT NULL

Top3 스냅샷 (PopularMenus)

  • 스냅샷ID (id) — bigint — 기본 키 — NOT NULL
  • 메뉴ID (menu_id) — bigint — NOT NULL — 상위 3개 메뉴ID
  • 메뉴 이름 (menu_name) — varchar(100) — NOT NULL — 메뉴 이름
  • 누적 판매량 합계 (total_quantity) — bigint — NOT NULL — 해당 시점의 7일 누적 판매량 합계
  • 순위 (rank) — int — NOT NULL — 1, 2, 3위 구분
  • 스냅샷 시각 (snapshot_at) — datetime — NOT NULL — 스케쥴러가 Redis 스냅샷을 뜬 시각
  • 생성일 (created_at) — datetime — NOT NULL
  • 수정일 (modified_at) — datetime — NOT NULL

메뉴 (Menus)

  • 메뉴ID (id) — bigint — 기본 키 — NOT NULL
  • 메뉴 이름 (menu_name) — varchar(100) — NOT NULL
  • 가격 (menu_price) — int — NOT NULL
  • 재고 (menu_stock) — int — NOT NULL
  • 카테고리 (category) — enum — NOT NULL — HOT_DRINK, COLD_DRINK, DESSERT, CUSTOM_DRINK, LIMITED_ITEM
  • 상품 상태 (menu_status) — enum — NOT NULL — 판매중(ON_SALE), 품절(SOLD_OUT), 단종(DISCONTINUED)
  • 낙관적 락 (version) — bigint — NOT NULL — 동시성 제어용 낙관적 락 대비
  • 삭제 여부 (is_deleted) — boolean — NOT NULL — 빠른 조회를 위한 플래그
  • 삭제일 (deleted_at) — datetime — 유니크 제약 및 정보용
  • 생성일 (created_at) — datetime — NOT NULL
  • 수정일 (modified_at) — datetime — NOT NULL

사용자 (Users)

  • 사용자ID (id) — bigint — 기본 키 — NOT NULL
  • 이메일 (email) — varchar(100) — NOT NULL — UNIQUE
  • 비밀번호 (password) — varchar(255) — NOT NULL
  • 보유 포인트 (point) — bigint — NOT NULL
  • 역할 (role) — enum — NOT NULL — 기본값(USER)
  • 생성일 (created_at) — datetime — NOT NULL
  • 수정일 (modified_at) — datetime — NOT NULL

재고 관리 (MenuStockLogs)

  • 재고관리ID (id) — bigint — 기본 키 — NOT NULL
  • 메뉴ID (menu_id) — bigint — 외래 키 → 메뉴.메뉴ID — NOT NULL
  • 주문ID (order_id) — bigint — 외래 키 → 주문.주문ID
  • 변동 수량 (change_stock) — int — NOT NULL
  • 남은 재고 (remain_stock) — int — NOT NULL
  • 생성일 (created_at) — datetime — NOT NULL
  • 수정일 (modified_at) — datetime — NOT NULL

주문 (Orders)

  • 주문ID (id) — bigint — 기본 키 — NOT NULL
  • 사용자ID (user_id) — bigint — 외래 키 → 사용자.사용자ID — NOT NULL
  • 주문 UUID (order_uid) — varchar(30) — NOT NULL — UNIQUE
  • 해시값 (order_fingerprint) — varchar(64) — NOT NULL — 요청된 메뉴 구성의 해시값 (SHA-256), 멱등성 키
  • 주문총액 (total_amount) — bigint — NOT NULL
  • 상태 (order_status) — enum — NOT NULL — PENDING(주문 대기), COMPLETED(주문 완료), CANCELED("주문 취소")
  • 낙관적 락 (version) — bigint — NOT NULL — 동시성 제어용 낙관적 락 대비
  • 삭제 여부 (is_deleted) — boolean — NOT NULL — 빠른 조회를 위한 플래그
  • 삭제일 (deleted_at) — datetime — 소프트 삭제 일시, 유니크 제약 포함용
  • 생성일 (created_at) — datetime — NOT NULL
  • 수정일 (modified_at) — datetime — NOT NULL

주문메뉴 (OrderMenus)

  • 주문메뉴ID (id) — bigint — 기본 키 — NOT NULL
  • 메뉴ID (menu_id) — bigint — 외래 키 → 메뉴.메뉴ID — NOT NULL
  • 메뉴ID (order_id) — bigint — 외래 키 → 주문.주문ID — NOT NULL
  • 메뉴 이름 (menu_name) — varchar(100) — NOT NULL
  • 가격 (menu_price) — int — NOT NULL
  • 수량 (quantity) — int — NOT NULL
  • 생성일 (created_at) — datetime — NOT NULL
  • 수정일 (modified_at) — datetime — NOT NULL

포인트 관리 (PointLogs)

  • 포인트ID (id) — bigint — 기본 키 — NOT NULL
  • 사용자ID (user_id) — bigint — 외래 키 → 사용자.사용자ID — NOT NULL
  • 주문ID (order_id) — bigint — 외래 키 → 주문.주문ID — 주문 사용/취소 시에만 존재
  • 충전ID (charge_id) — bigint — 외래 키 → 포인트 충전.결제ID — 현금 충전 시에만 존재
  • 변동 사유 (type) — enum — NOT NULL — CHARGE(충전), USE(사용), CANCEL(취소), ADMIN_ADJUST(관리자 조정)
  • 변동 수량 (amount) — bigint — NOT NULL — 변동 수량
  • 잔여 포인트 (remain_point) — bigint — NOT NULL — 변동 후 최종 잔액 스냅샷
  • 생성일 (created_at) — datetime — NOT NULL
  • 수정일 (modified_at) — datetime — NOT NULL

포인트 충전 (PointCharges)

  • 결제ID (id) — bigint — 기본 키 — NOT NULL
  • 사용자ID (user_id) — bigint — 외래 키 → 사용자.사용자ID — NOT NULL
  • 현금 금액 (amount) — bigint — NOT NULL
  • 결제 수단 (payment_type) — enum — NOT NULL — CARD, KAKAO_PAY, TOSS_PAY
  • 결제 상태 (payment_status) — enum — NOT NULL — PENDING(대기), SUCCESS(성공), FAILED(실패)
  • PG사 거래 고유 번호 (pg_tid) — varchar(100) — PG사 거래 고유 번호
  • 결제 완료 일시 (paid_at) — datetime — 실제 결제 완료 일시
  • 생성일 (created_at) — datetime — NOT NULL
  • 수정일 (modified_at) — datetime — NOT NULL