raceCoupon

테이블 (12)

리프레시 토큰 (refresh_tokens)

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — NOT NULL — users.id 값 참조. UNIQUE — 사용자당 1건만 유지(재로그인 시 rotate)
  • token — VARCHAR(512) — NOT NULL
  • expires_at — DATETIME(6) — NOT NULL

발급 쿠폰 (issued_coupon)

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — NOT NULL — user_service.users.id 값 참조 (다른 스키마라 FK 불가)
  • coupon_id — BIGINT — NOT NULL — coupon.id 값 참조. UNIQUE(user_id, coupon_id) — 사용자당 동일 쿠폰 한 장 + 컨슈머 재소비 멱등성
  • status — VARCHAR(255) — NOT NULL — IssuedCouponStatus — ISSUED / USED
  • order_id — BIGINT — order_service.orders.id 값 참조. UNIQUE지만 FK가 아니라 멱등 키 — 미사용 시 null(MySQL은 UNIQUE에 NULL 다수 허용)
  • issued_at — DATETIME(6) — NOT NULL
  • used_at — DATETIME(6) — 미사용이면 null

사용자 (users)

  • id — BIGINT — 기본 키 — NOT NULL — JWT의 sub 클레임이 되는 값
  • username — VARCHAR(255) — NOT NULL — UNIQUE
  • email — VARCHAR(255) — NOT NULL — UNIQUE
  • password — VARCHAR(255) — NOT NULL — BCrypt 해시. 평문 금지
  • role — VARCHAR(255) — NOT NULL — UserRole — USER / ADMIN
  • enabled — BIT(1) — NOT NULL
  • created_at — DATETIME(6) — NOT NULL

상품 (product)

  • id — BIGINT — 기본 키 — NOT NULL
  • name — VARCHAR(255) — NOT NULL
  • price — BIGINT — NOT NULL — 단가(원). 주문 금액의 권위는 product-service에 있고 주문에는 시점 스냅샷으로 전달
  • stock — BIGINT — NOT NULL — 두 번째 레이스 지점(Product.decrease). DB 락을 걸지 않고 Kafka 파티션 키(productId)로 직렬화한다
  • created_at — DATETIME(6) — NOT NULL

상품서비스 응답 Outbox (product_order_outbox)

  • id — CHAR(36) — 기본 키 — NOT NULL — 응답 메시지 식별자. payload 안의 id와 같은 값
  • saga_id — CHAR(36) — NOT NULL — 사가 상관 키. 요청에서 받은 값을 그대로 반환
  • order_id — BIGINT — NOT NULL — order_service.orders.id 값 참조
  • type — VARCHAR(255) — NOT NULL — 사가 종류. 폴링 인덱스 idx_order_outbox_poll(type, outbox_status)의 선두 컬럼
  • payload — LONGTEXT — NOT NULL — 응답 DTO의 JSON. 네이티브 JSON 타입 미사용(H2 역직렬화 문제)
  • outbox_status — VARCHAR(255) — NOT NULL — OutboxStatus — STARTED / COMPLETED / FAILED
  • stock_status — VARCHAR(255) — NOT NULL — StockStatus — RESERVED / RESTORED / FAILED. 참여자가 실제로 무엇을 했는지
  • request_status — VARCHAR(255) — NOT NULL — StockOrderStatus — PENDING / CANCELLED. UNIQUE(saga_id, request_status)
  • publish_attempts — INT — NOT NULL — 발행 시도 횟수. 진단용
  • version — INT — NOT NULL — @Version — 동시 중복 응답 방어선
  • created_at — DATETIME(6) — NOT NULL
  • processed_at — DATETIME(6) — 발행 완료 시각

재고 예약 (stock_reservation)

  • id — BIGINT — 기본 키 — NOT NULL
  • order_id — BIGINT — NOT NULL — order_service.orders.id 값 참조. UNIQUE지만 FK가 아니라 멱등 키 — Kafka at-least-once로 같은 커맨드를 두 번 받아도 재고가 두 번 깎이지 않게 DB가 막는다
  • product_id — BIGINT — 외래 키 → 상품.id — NOT NULL — 같은 스키마라 실제 FK + @ManyToOne(LAZY)
  • quantity — BIGINT — NOT NULL
  • status — VARCHAR(255) — NOT NULL — ReservationStatus — RESERVED / RESTORED

재고요청 Outbox (product_outbox)

  • id — CHAR(36) — 기본 키 — NOT NULL — 애플리케이션이 발급한 UUID를 그대로 PK로 쓴다 — payload의 id와 같은 값이어야 로그에서 양쪽을 이어 볼 수 있다
  • saga_id — CHAR(36) — NOT NULL — 사가 상관 키. Outbox 조회의 주 키
  • order_id — BIGINT — NOT NULL — orders.id 값 참조. saga_id와 1:1이지만 SQL로 좇을 때는 이쪽이 편하다
  • type — VARCHAR(255) — NOT NULL — 폴링 인덱스 idx_product_outbox_poll(type, outbox_status, saga_status)의 선두 컬럼
  • payload — LONGTEXT — NOT NULL — 요청 DTO의 JSON. 조회에 필요한 값은 request_status·saga_status로 이미 꺼내 뒀다
  • outbox_status — VARCHAR(255) — NOT NULL — OutboxStatus — STARTED / COMPLETED / FAILED. 메시지를 보냈는가
  • saga_status — VARCHAR(255) — NOT NULL — SagaStatus — STARTED / PROCESSING / SUCCEEDED / FAILED / COMPENSATING / COMPENSATED. 이 단계가 어디까지 갔는가 (outbox_status와 직교하…
  • order_status — VARCHAR(255) — NOT NULL — 생성 시점 OrderStatus 스냅샷. 진단용이며 판단 근거로 쓰지 않는다
  • request_status — VARCHAR(255) — NOT NULL — StockOrderStatus — PENDING / CANCELLED. UNIQUE(saga_id, request_status) — 이걸 빼면 보상 요청 INSERT가 정상 요청과 충돌해 보상이 영영 발행되지 않는다
  • publish_attempts — INT — NOT NULL — 발행 시도 횟수. 진단용 — 상한 자동 정지는 아직 없다
  • version — INT — NOT NULL — @Version — 두 스레드가 같은 응답을 동시에 처리할 때 커밋 시점에 하나를 떨궈낸다
  • created_at — DATETIME(6) — NOT NULL
  • processed_at — DATETIME(6) — 발행 완료 시각

주문 (orders)

  • id — BIGINT — 기본 키 — NOT NULL — 도메인 조회 키
  • saga_id — CHAR(36) — NOT NULL — Saga 상관 키. UNIQUE, 생성 후 불변. Outbox 조회의 주 키다 — BINARY(16) 대신 CHAR(36)으로 둬 SQL로 눈으로 좇을 수 있게 한다
  • user_id — BIGINT — NOT NULL — user_service.users.id 값 참조 (다른 스키마라 FK 불가)
  • status — VARCHAR(255) — NOT NULL — OrderStatus — CREATED / STOCK_RESERVED / COMPLETED / COMPENSATING / FAILED. 별도 SAGA_INSTANCE 테이블 없이 이 row가 사가 인스턴스다
  • coupon_id — BIGINT — coupon_service.coupon.id 값 참조 — 발급 row의 PK가 아니라 쿠폰 템플릿 ID. null이면 쿠폰 없는 주문
  • total_amount — BIGINT — NOT NULL — 생성 시 0. 재고 예약 리플라이가 단가를 실어와야 확정된다
  • discount_amount — BIGINT — NOT NULL
  • final_amount — BIGINT — NOT NULL
  • failure_code — VARCHAR(255) — 실패 원인. 성공한 주문에서는 null
  • created_at — DATETIME(6) — NOT NULL
  • updated_at — DATETIME(6) — NOT NULL

주문 품목 (order_item)

  • id — BIGINT — 기본 키 — NOT NULL
  • order_id — BIGINT — 외래 키 → 주문.id — NOT NULL — 같은 스키마라 실제 FK. 1주문 1상품이 확정이라 실제로는 주문당 1행
  • product_id — BIGINT — NOT NULL — product_service.product.id 값 참조 (서비스 경계를 넘으므로 FK 불가)
  • product_name — VARCHAR(255) — 주문 시점 스냅샷. 재고 예약 리플라이가 도착해야 채워져 nullable
  • unit_price — BIGINT — 주문 시점 스냅샷. 상품 가격이 나중에 바뀌어도 지나간 주문 이력은 흔들리지 않는다
  • quantity — INT — NOT NULL

쿠폰 (coupon)

  • id — BIGINT — 기본 키 — NOT NULL — 비관적 락(SELECT ... FOR UPDATE)의 잠금 대상 row
  • title — VARCHAR(255) — NOT NULL
  • total_quantity — BIGINT — NOT NULL
  • issued_quantity — BIGINT — NOT NULL — 레이스 컨디션의 물리적 지점 — Coupon.issue()의 read → +1 → write. 불변식 0 <= issued_quantity <= total_quantity
  • discount_type — VARCHAR(255) — NOT NULL — DiscountType — PERCENT / FIXED_AMOUNT
  • discount_value — BIGINT — NOT NULL
  • max_discount_amount — BIGINT — 최대 할인 한도(선택). null이면 한도 없음 — MaxDiscountDecorator
  • min_order_amount — BIGINT — 최소 주문 금액(선택). null이면 조건 없음 — MinOrderAmountDecorator

쿠폰서비스 응답 Outbox (coupon_order_outbox)

  • id — CHAR(36) — 기본 키 — NOT NULL — 응답 메시지 식별자. payload 안의 id와 같은 값
  • saga_id — CHAR(36) — NOT NULL — 사가 상관 키. 요청에서 받은 값을 그대로 반환
  • order_id — BIGINT — NOT NULL — order_service.orders.id 값 참조
  • type — VARCHAR(255) — NOT NULL — 사가 종류. 폴링 인덱스 idx_order_outbox_poll(type, outbox_status)의 선두 컬럼
  • payload — LONGTEXT — NOT NULL — 응답 DTO의 JSON. 네이티브 JSON 타입을 쓰지 않는다 — H2가 문자열 리터럴로 저장해 역직렬화가 깨짐
  • outbox_status — VARCHAR(255) — NOT NULL — OutboxStatus — STARTED / COMPLETED / FAILED
  • coupon_status — VARCHAR(255) — NOT NULL — CouponStatus — APPLIED / RESTORED / FAILED. 참여자가 실제로 무엇을 했는지
  • request_status — VARCHAR(255) — NOT NULL — CouponOrderStatus — PENDING / CANCELLED. UNIQUE(saga_id, request_status) — 정상 응답과 보상 응답의 공존 근거
  • publish_attempts — INT — NOT NULL — 발행 시도 횟수. 진단용
  • version — INT — NOT NULL — @Version — 동시 중복 응답 방어선
  • created_at — DATETIME(6) — NOT NULL
  • processed_at — DATETIME(6) — 발행 완료 시각. 재발행 판정·지연 진단용

쿠폰요청 Outbox (coupon_outbox)

  • id — CHAR(36) — 기본 키 — NOT NULL — 애플리케이션이 발급한 UUID를 그대로 PK로 쓴다
  • saga_id — CHAR(36) — NOT NULL — 사가 상관 키. Outbox 조회의 주 키
  • order_id — BIGINT — NOT NULL — orders.id 값 참조
  • type — VARCHAR(255) — NOT NULL — 폴링 인덱스 idx_coupon_outbox_poll(type, outbox_status, saga_status)의 선두 컬럼
  • payload — LONGTEXT — NOT NULL — 요청 DTO의 JSON
  • outbox_status — VARCHAR(255) — NOT NULL — OutboxStatus — STARTED / COMPLETED / FAILED
  • saga_status — VARCHAR(255) — NOT NULL — SagaStatus — STARTED / PROCESSING / SUCCEEDED / FAILED / COMPENSATING / COMPENSATED
  • order_status — VARCHAR(255) — NOT NULL — 생성 시점 OrderStatus 스냅샷. 진단용
  • request_status — VARCHAR(255) — NOT NULL — CouponOrderStatus — PENDING / CANCELLED. 현재 사가에서는 PENDING만 생기지만(쿠폰 적용이 마지막 단계) product_outbox와 계약을 같게 맞춰 둔다
  • publish_attempts — INT — NOT NULL — 발행 시도 횟수. 진단용
  • version — INT — NOT NULL — @Version — 동시 중복 응답 방어선
  • created_at — DATETIME(6) — NOT NULL
  • processed_at — DATETIME(6) — 발행 완료 시각