커피숍 주문 시스템
테이블 (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