종합프로젝트

테이블 (12)

app_user

  • user_id — BIGINT — 기본 키 — NOT NULL
  • uuid — CHAR(36) — NOT NULL — 외부 노출용 식별자. 애플리케이션에서 생성
  • name — VARCHAR(50) — NOT NULL — 응답·로그 마스킹 대상(MEMBER)
  • email — VARCHAR(255) — 응답·로그 마스킹 대상. ROLE_MEMBER 는 필수
  • phone — VARCHAR(20) — 응답·로그 마스킹 대상. ROLE_MEMBER 는 필수
  • role — VARCHAR(20) — NOT NULL
  • status — VARCHAR(20) — NOT NULL
  • created_at — DATETIME(6) — NOT NULL

coupon

  • coupon_id — BIGINT — 기본 키 — NOT NULL
  • event_id — BIGINT — 외래 키 → event.event_id — NOT NULL
  • name — VARCHAR(100) — NOT NULL
  • discount_type — VARCHAR(20) — NOT NULL
  • discount_value — INT — NOT NULL — FIXED_AMOUNT=원, RATE=%
  • min_order_amount — INT — NOT NULL
  • max_discount_amount — INT — RATE 전용 상한. FIXED_AMOUNT 면 반드시 NULL(ck_coupon_max_discount)
  • issue_start_at — DATETIME(6) — NOT NULL
  • issue_end_at — DATETIME(6) — NOT NULL
  • valid_days — INT — NOT NULL — 발급 후 유효일수
  • limit_per_member — INT — NOT NULL — v7 1인(ROLE_MEMBER) 최대 발급 수. 현재는 1로 고정(ck_coupon_limit)
  • status — VARCHAR(20) — NOT NULL
  • created_at — DATETIME(6) — NOT NULL
  • updated_at — DATETIME(6) — NOT NULL

coupon_issue

  • coupon_issue_id — BIGINT — 기본 키 — NOT NULL
  • coupon_id — BIGINT — 외래 키 → coupon.coupon_id — NOT NULL
  • user_id — BIGINT — 외래 키 → app_user.user_id — NOT NULL — app_user.user_id (ROLE_MEMBER 기대)
  • sequence_no — BIGINT — NOT NULL — 선착순 순번 (Redis INCR 값)
  • coupon_code — CHAR(32) — NOT NULL
  • request_id — VARCHAR(64) — NOT NULL — v7 Kafka Consumer 재처리 멱등 키. idempotency_key.idempotency_key 와 별개(코멘트 참고)
  • status — VARCHAR(20) — NOT NULL
  • used_at — DATETIME(6)
  • canceled_at — DATETIME(6)
  • expires_at — DATETIME(6) — NOT NULL — v8 만료 시각 = created_at + coupon.valid_days, 발급 확정 시 계산
  • version — BIGINT — NOT NULL — 낙관적 락
  • created_at — DATETIME(6) — NOT NULL — v6 발급 확정 시각 (행이 확정 시점에만 생성됨)
  • updated_at — DATETIME(6) — NOT NULL

coupon_issue_history

  • history_id — BIGINT — 기본 키 — NOT NULL
  • coupon_issue_id — BIGINT — 외래 키 → coupon_issue.coupon_issue_id — NOT NULL
  • coupon_id — BIGINT — NOT NULL — 검증 쿼리용 비정규화
  • user_id — BIGINT — NOT NULL — 검증 쿼리용 비정규화 (app_user.user_id)
  • from_status — VARCHAR(20) — NOT NULL
  • to_status — VARCHAR(20) — NOT NULL
  • actor_type — VARCHAR(20) — NOT NULL
  • actor_id — BIGINT — actor_type=USER/ADMIN 이면 app_user.user_id
  • reason — VARCHAR(200)
  • created_at — DATETIME(6) — NOT NULL

coupon_stock

  • coupon_id — BIGINT — 외래 키 → coupon.coupon_id — NOT NULL
  • total_quantity — INT — NOT NULL
  • issued_quantity — INT — NOT NULL
  • remaining_quantity — INT — NOT NULL
  • version — BIGINT — NOT NULL — 낙관적 락
  • updated_at — DATETIME(6) — NOT NULL

event

  • event_id — BIGINT — 기본 키 — NOT NULL
  • created_by — BIGINT — 외래 키 → app_user.user_id — NOT NULL — app_user.user_id. ROLE_ADMIN 기대 (앱 레이어 검증)
  • name — VARCHAR(100) — NOT NULL
  • description — VARCHAR(500)
  • open_at — DATETIME(6) — NOT NULL — 예약 오픈 시각
  • close_at — DATETIME(6) — NOT NULL
  • status — VARCHAR(20) — NOT NULL
  • created_at — DATETIME(6) — NOT NULL
  • updated_at — DATETIME(6) — NOT NULL

event_status_history

  • event_history_id — BIGINT — 기본 키 — NOT NULL
  • event_id — BIGINT — 외래 키 → event.event_id — NOT NULL
  • from_status — VARCHAR(20) — NOT NULL
  • to_status — VARCHAR(20) — NOT NULL
  • actor_type — VARCHAR(20) — NOT NULL — ADMIN / SCHEDULER / SYSTEM
  • actor_id — BIGINT — actor_type=ADMIN 이면 app_user.user_id
  • reason — VARCHAR(200)
  • created_at — DATETIME(6) — NOT NULL

idempotency_key

  • idempotency_id — BIGINT — 기본 키 — NOT NULL
  • idempotency_key — VARCHAR(64) — NOT NULL
  • user_id — BIGINT — 외래 키 → app_user.user_id — NOT NULL — app_user.user_id
  • coupon_id — BIGINT — 외래 키 → coupon.coupon_id — NOT NULL
  • coupon_issue_id — BIGINT — 외래 키 → coupon_issue.coupon_issue_id — 성공 시 발급 결과
  • request_hash — CHAR(64) — NOT NULL — 요청 본문 SHA-256
  • status — VARCHAR(20) — NOT NULL
  • response_body — JSON
  • created_at — DATETIME(6) — NOT NULL
  • expires_at — DATETIME(6) — NOT NULL

issue_message

  • message_id — BIGINT — 기본 키 — NOT NULL
  • coupon_id — BIGINT — 외래 키 → coupon.coupon_id — NOT NULL
  • user_id — BIGINT — NOT NULL — app_user.user_id (FK 미설정, 핫 패스)
  • sequence_no — BIGINT — NOT NULL — v5 선착순 순번 (payload 비정규화, 결번 규명용)
  • message_key — VARCHAR(100) — NOT NULL — Kafka key (예: couponId:userId)
  • topic — VARCHAR(100) — NOT NULL
  • payload — JSON — NOT NULL
  • status — VARCHAR(20) — NOT NULL
  • retry_count — INT — NOT NULL
  • last_error — VARCHAR(500)
  • created_at — DATETIME(6) — NOT NULL
  • processed_at — DATETIME(6)

notification_log

  • notification_id — BIGINT — 기본 키 — NOT NULL
  • coupon_issue_id — BIGINT — 외래 키 → coupon_issue.coupon_issue_id
  • user_id — BIGINT — 외래 키 → app_user.user_id — NOT NULL — app_user.user_id
  • channel — VARCHAR(20) — NOT NULL
  • recipient_masked — VARCHAR(100) — NOT NULL — 예: 010-****-1234
  • content — VARCHAR(500)
  • status — VARCHAR(20) — NOT NULL
  • sent_at — DATETIME(6)
  • created_at — DATETIME(6) — NOT NULL

reconciliation_report

  • report_id — BIGINT — 기본 키 — NOT NULL
  • coupon_id — BIGINT — 외래 키 → coupon.coupon_id — NOT NULL
  • as_of_at — DATETIME(6) — NOT NULL — 검증 기준 시각(재현성 보장)
  • started_at — DATETIME(6) — NOT NULL
  • finished_at — DATETIME(6)
  • total_count — BIGINT — NOT NULL — 검증 대상 건수
  • success_count — BIGINT — NOT NULL
  • error_count — BIGINT — NOT NULL
  • stock_total — INT — NOT NULL
  • stock_issued — INT — NOT NULL
  • stock_remaining — INT — NOT NULL
  • db_active_count — BIGINT — NOT NULL — ISSUED + USED (현재 유효 보유, 재고 매칭용 아님)
  • db_canceled_count — BIGINT — NOT NULL
  • db_expired_count — BIGINT — NOT NULL
  • db_dlq_count — BIGINT — NOT NULL — v8 issue_message 기준 DLQ(최종 실패 확정) 건수만. FAILED(재시도 중)는 포함 안 함 — 결번 정상 범위 계산용
  • max_sequence_no — BIGINT — v2 발급된 최대 순번
  • redis_remaining — INT
  • result — VARCHAR(20) — NOT NULL

verification_detail

  • detail_id — BIGINT — 기본 키 — NOT NULL
  • report_id — BIGINT — 외래 키 → reconciliation_report.report_id — NOT NULL
  • error_type — VARCHAR(30) — NOT NULL
  • coupon_issue_id — BIGINT — 건단위 오류일 때만
  • user_id — BIGINT — 건단위 오류 대상 app_user.user_id
  • expected_value — VARCHAR(100)
  • actual_value — VARCHAR(100)
  • message — VARCHAR(500)
  • created_at — DATETIME(6) — NOT NULL