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) — 발행 완료 시각