이커머스 서비스

테이블 (10)

coupons (쿠폰)

  • coupon_id — BIGINT UNSIGNED — 기본 키 — NOT NULL — 쿠폰 ID
  • code — UNIQUE, NOT NULL — NOT NULL — 쿠폰 코드(비즈니스 키)
  • type — ENUM('PERCENT','FIXED') — NOT NULL — 할인 유형
  • value — DECIMAL(12,2) — NOT NULL — 할인 값(%) 또는 금액
  • starts_at — DATETIME — NOT NULL — 시작
  • ends_at — DATETIME — NOT NULL — 종료
  • created_at — DATETIME — NOT NULL — 생성일

orderItems (주문 아이템)

  • order_item_id — BIGINT UNSIGNED — 기본 키 — NOT NULL — 주문 아이템 ID
  • order_id — BIGINT UNSIGNED — 외래 키 → orders.order_id — NOT NULL — 주문 ID
  • product_id — BIGINT UNSIGNED — NOT NULL — 주문 상품 ID
  • unit_price — DECIMAL(12,2) — NOT NULL — 주문 시점의 단가(스냅샷)
  • quantity — INT UNSIGNED — NOT NULL — 주문 상품 수량
  • subtotal — DECIMAL(12,2) — NOT NULL — 소계(단가*수량)

orders (주문)

  • order_id — BIGINT UNSIGNED — 기본 키 — NOT NULL — 주문 ID
  • user_id — BIGINT UNSIGNED — 외래 키 → users.user_id — NOT NULL — 유저 ID
  • status — ENUM('CREATED','FAILED','PAID') — NOT NULL — 주문 상태
  • total_amount — DECIMAL(12,2) — NOT NULL — 총액(할인 전)
  • discount_amount — DECIMAL(12,2) — NOT NULL — 총 할인액
  • paid_amount — DECIMAL(12,2) — NOT NULL — 결제 금액
  • idempotency_key — VARCHAR(64) — NOT NULL — 멱등성 키 : “요청 식별자” 역할. 중복 요청/재시도에서도 주문이 1건만 생기도록 보장.
  • user_coupon_id — BIGINT UNSIGNED — 사용된 쿠폰 ID
  • created_at — DATETIME — NOT NULL — 주문일

outbox (데이터 분석을 위한 테이블)

  • id — BIGINT UNSIGNED — 기본 키 — NOT NULL — 이벤트 식별자
  • aggregate_type — VARCHAR(40) — NOT NULL — 이벤트 타입
  • aggregate_id — BIGINT UNSIGNED — NOT NULL — 이벤트와 연관된 ID
  • payload — JSON — NOT NULL — 외부 전송 데이터
  • status — ENUM('PENDING','SENT','FAILED') — NOT NULL — 전송 상태
  • created_at — DATETIME — NOT NULL — 생성일

payments (결제)

  • payment_id — BIGINT UNSIGNED — 기본 키 — NOT NULL — 결제 ID
  • order_id — BIGINT UNSIGNED — 외래 키 → orders.order_id — NOT NULL — 주문 ID
  • amount — DECIMAL(12,2) — NOT NULL — 결제 금액
  • status — ENUM('SUCCESS','FAILED') — NOT NULL — SUCCESS/FAILED
  • paid_at — DATETIME — NOT NULL — 결제일

point_ledger (포인트 사용 로그)

  • id — BIGINT UNSIGNED — 기본 키 — NOT NULL — 로그ID
  • user_id — BIGINT UNSIGNED — 외래 키 → users.user_id — NOT NULL — 유저 ID
  • order_id — ULONG — 외래 키 → orders.order_id — NOT NULL — 주문 ID
  • delta — DECIMAL(12,2) — NOT NULL — 증감(+/-) 금액
  • reason — ENUM('CHARGE','ORDER ') — 포인트 사용 상태
  • created_at — DATETIME — 기록일

products (상품)

  • id (u_product_id) — BIGINT UNSIGNED — 기본 키 — NOT NULL — 상품 ID
  • name — VARCHAR(250) — NOT NULL — 상품명
  • price — DECIMAL(12,2) — NOT NULL — 상품 가격
  • stock — INT UNSIGNED — NOT NULL — 잔여 재고
  • created_at — DATETIME — NOT NULL — 생성일

user_coupons (유저 보유 쿠폰)

  • id — BIGINT UNSIGNED — 기본 키 — NOT NULL — ID
  • user_id — BIGINT UNSIGNED — 외래 키 → users.user_id — NOT NULL — 유저 ID
  • coupon_id — BIGINT UNSIGNED — 외래 키 → coupons.coupon_id — NOT NULL — 쿠폰 ID
  • status — ENUM('CLAIMED','USED') — NOT NULL — 사용 상태
  • claimed_at — ULONG — NOT NULL — 발급일
  • used_at — DATETIME — 사용일

users (유저)

  • user_id — BIGINT UNSIGNED — 기본 키 — NOT NULL — 유저 ID
  • name — VARCHAR(250) — NOT NULL — 유저 이름
  • created_at — DATETIME — NOT NULL — 유저 생성일

wallets (지갑)

  • user_id — BIGINT UNSIGNED — 외래 키 → users.user_id — NOT NULL — 유저 ID
  • balance — DECIMAL(12,2) — NOT NULL — 현재 잔액