종합프로젝트
테이블 (12)
app_user
- user_id — BIGINT — 기본 키 — NOT NULL
- login_id — VARCHAR(50) — 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 전용 상한
- 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 — 1인(ROLE_MEMBER) 최대 발급 수
- 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 — 멱등 요청 ID
- status — VARCHAR(20) — NOT NULL
- issued_at — DATETIME(6)
- used_at — DATETIME(6)
- canceled_at — DATETIME(6)
- failed_at — DATETIME(6) — v3 발급 실패 확정 시각 (DLQ 격리 시점)
- fail_reason — VARCHAR(200) — v3 실패 사유 요약 (상세는 issue_message.last_error)
- expires_at — DATETIME(6)
- version — BIGINT — NOT NULL — 낙관적 락
- created_at — DATETIME(6) — NOT NULL — 신청 시각
- 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/ROLE_OPERATOR 기대 (앱 레이어 검증)
- 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 미설정, 핫 패스)
- 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_failed_count — BIGINT — NOT NULL — v3 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