V4

Tables (13)

coupon_claim_request

  • coupon_claim_request_id — bigint — Primary key — NOT NULL — 식별자
  • coupon_event_id — bigint — NOT NULL — 쿠폰이벤트식별자
  • coupon_event_item_id — bigint — NOT NULL — 쿠폰식별자
  • user_id — bigint — NOT NULL — 유저식별자
  • request_status — varchar(30) — NOT NULL — 쿠폰발급상태
  • created_at — datetime(6) — NOT NULL — 생성시각
  • updated_at — datetime(6) — NOT NULL — 수정시각

coupon_event

  • coupon_event_id — bigint — Primary key — NOT NULL — 식별자
  • esports_match_id — bigint — Foreign key → esports_match.esports_match_id — NOT NULL — esports_match 식별자
  • event_type — varchar(50) — NOT NULL — 이벤트타입
  • description — varchar(500) — NOT NULL — 이벤트설명
  • started_at — datetime(6) — NOT NULL — 이벤트시작시각
  • closed_at — datetime(6) — NOT NULL — 이벤트종료시각
  • created_at — datetime(6) — NOT NULL — 생성시각
  • updated_at — datetime(6) — NOT NULL — 수정시각

coupon_event_item

  • coupon_event_item_id — bigint — Primary key — NOT NULL — 식별자
  • coupon_event_id — bigint — NOT NULL — 쿠폰이벤트식별자
  • coupon_type_id — bigint — NOT NULL — 쿠폰타입식별자
  • quantity — int — NOT NULL — 수량
  • success_count — int — NOT NULL — 발급수량
  • created_at — datetime(6) — NOT NULL — 생성시각
  • updated_at — datetime(6) — NOT NULL — 수정시각

coupon_type

  • coupon_type_id — bigint — Primary key — NOT NULL — 식별자
  • coupon_name — varchar(100) — NOT NULL — 쿠폰이름
  • discount_value — int — NOT NULL — 할인율
  • status — varchar(30) — NOT NULL — 쿠폰상태
  • created_at — datetime(6) — NOT NULL — 생성시각
  • updated_at — datetime(6) — NOT NULL — 수정시각

esports_game

  • esports_game_id — bigint — Primary key — NOT NULL — 내부 세트 식별자
  • external_game_id — varchar(32) — NOT NULL — LoL Esports gameId
  • match_id — bigint — Foreign key → match_team.match_id — NOT NULL — 내부 매치 식별자
  • game_number — int — NOT NULL — 매치 내 세트 번호
  • blue_match_team_id — bigint — Foreign key → match_team.match_team_id — 이 세트의 블루 진영 match_team 식별자
  • red_match_team_id — bigint — Foreign key → match_team.match_team_id — 이 세트의 레드 진영 match_team 식별자
  • lifecycle_status — varchar(20) — NOT NULL — unstarted/inProgress/completed 원본 상태
  • telemetry_state — varchar(30) — 마지막 Window frame gameState 원본
  • patch_version — varchar(50) — 피드 patch/build 버전
  • data_dragon_version — varchar(20) — 아이콘 조회용 Data Dragon 버전
  • started_at — datetime(6) — 게임 시작 시각 및 경과 시간 계산 기준(UTC)
  • ended_at — datetime(6) — 게임 종료 시각(UTC)
  • duration_seconds — int — 최종 게임 경과 초
  • final_window_frame_at — datetime(6) — 최종 Window 통계 frame 시각(UTC)
  • final_details_frame_at — datetime(6) — 최종 Details 통계 frame 시각(UTC)
  • blue_total_gold — bigint — 블루 최종 총 골드
  • red_total_gold — bigint — 레드 최종 총 골드
  • blue_total_kills — int — 블루 최종 킬
  • red_total_kills — int — 레드 최종 킬
  • blue_towers — int — 블루 최종 포탑 수
  • red_towers — int — 레드 최종 포탑 수
  • blue_inhibitors — int — 블루 최종 억제기 수
  • red_inhibitors — int — 레드 최종 억제기 수
  • blue_barons — int — 블루 최종 바론 수
  • red_barons — int — 레드 최종 바론 수
  • objectives_json — json — 그래프용 오브젝트 이벤트 배열
  • window_collection_status — varchar(20) — NOT NULL — Window 수집 상태
  • details_collection_status — varchar(20) — NOT NULL — Details 수집 상태
  • timeline_collection_status — varchar(20) — NOT NULL — Timeline 수집 상태
  • timeline_covered_from_seconds — int — 수집된 timeline 시작 경과 초
  • timeline_covered_to_seconds — int — 수집된 timeline 종료 경과 초
  • finalized_at — datetime(6) — 필수 데이터 최종 확정 시각
  • last_collection_error — varchar(1000) — 마지막 수집 오류 요약
  • created_at — datetime(6) — NOT NULL — 생성 시각
  • updated_at — datetime(6) — NOT NULL — 수정 시각

esports_match

  • esports_match_id — bigint — Primary key — NOT NULL — 내부 매치 식별자
  • external_match_id — varchar(32) — NOT NULL — LoL Esports matchId
  • league_external_id — varchar(32) — NOT NULL — 수집 대상 리그 외부 식별자
  • league_name — varchar(100) — 경기 당시 리그 표시명
  • league_slug — varchar(100) — 경기 당시 리그 slug
  • season_key — varchar(50) — NOT NULL — H2H 집계 시즌 키(예: 2026)
  • tournament_external_id — varchar(32) — 확인된 경우 대회 외부 식별자
  • block_name — varchar(100) — 주차/라운드 표시명
  • scheduled_at — datetime(6) — NOT NULL — 예정 시작 시각(UTC)
  • started_at — datetime(6) — 실제 매치 시작 시각(UTC)
  • ended_at — datetime(6) — 매치 종료 시각(UTC)
  • lifecycle_status — varchar(20) — NOT NULL — unstarted/inProgress/completed 원본 상태
  • best_of — int — 다전제 수(1/3/5 등)
  • created_at — datetime(6) — NOT NULL — 생성 시각
  • updated_at — datetime(6) — NOT NULL — 수정 시각

game_player_stat

  • game_player_stat_id — bigint — Primary key — NOT NULL — 세트별 선수 기록 식별자
  • game_id — bigint — Foreign key → esports_game.esports_game_id — NOT NULL — 내부 세트 식별자
  • match_team_id — bigint — Foreign key → match_team.match_team_id — 선수가 속한 match_team 식별자
  • participant_no — int — NOT NULL — 세트 내부 참가 번호(1~10)
  • side — varchar(4) — NOT NULL — blue/red
  • external_player_id — varchar(32) — upstream esportsPlayerId
  • summoner_name — varchar(100) — 경기 당시 소환사명
  • champion_id — varchar(50) — 챔피언 식별자
  • role — varchar(20) — top/jungle/mid/bottom/support
  • level — int — 최종 레벨
  • kills — int — 최종 킬
  • deaths — int — 최종 데스
  • assists — int — 최종 어시스트
  • creep_score — int — 최종 CS
  • total_gold — bigint — Window scoreboard 총 골드
  • total_gold_earned — bigint — Details 획득 골드
  • kill_participation_ratio — decimal(7, 6) — 킬 관여율 원본 비율(0~1)
  • champion_damage_share_ratio — decimal(7, 6) — 챔피언 피해 비중 원본 비율(0~1)
  • wards_placed — int — 설치 와드 수
  • wards_destroyed — int — 파괴 와드 수
  • items_json — json — 최종 아이템 ID 순서 배열
  • perks_json — json — style/subStyle/perks 객체
  • created_at — datetime(6) — NOT NULL — 생성 시각
  • updated_at — datetime(6) — NOT NULL — 수정 시각

game_timeline_point

  • game_timeline_point_id — bigint — Primary key — NOT NULL — 게임 시계열 지점 식별자
  • game_id — bigint — Foreign key → esports_game.esports_game_id — NOT NULL — 내부 세트 식별자
  • game_time_seconds — int — NOT NULL — 게임 시작 기준 경과 초
  • blue_gold — bigint — NOT NULL — 블루 총 골드
  • red_gold — bigint — NOT NULL — 레드 총 골드
  • blue_kills — int — NOT NULL — 블루 총 킬
  • red_kills — int — NOT NULL — 레드 총 킬

match_team

  • (match_team_id) — bigint — Primary key — NOT NULL — 매치 참가 팀 식별자
  • match_id — bigint — Foreign key → esports_match.esports_match_id — NOT NULL — 내부 매치 식별자
  • external_team_id — varchar(32) — LoL Esports 팀 식별자; TBD이면 NULL
  • display_order — int — NOT NULL — 매치 헤더 표시 순서(1/2)
  • team_code — varchar(16) — 경기 당시 팀 코드
  • team_name — varchar(100) — 경기 당시 팀 이름
  • team_image_url — varchar(2048) — 경기 당시 팀 로고 URL
  • outcome — varchar(10) — 매치 기준 win/loss
  • game_wins — int — 해당 매치 세트 승수
  • record_wins_snapshot — int — 일정 응답 당시 전적 승수
  • record_losses_snapshot — int — 일정 응답 당시 전적 패수
  • created_at — datetime(6) — NOT NULL — 생성 시각
  • updated_at — datetime(6) — NOT NULL — 수정 시각

match_view_session

  • match_view_session_id — bigint — Primary key — NOT NULL — 식별자
  • user_id — bigint — NOT NULL — 유저식별자
  • esports_match_id — bigint — Foreign key → esports_match.esports_match_id — NOT NULL — esports_match 식별자
  • started_at — datetime(6) — NOT NULL — 시청시작시각
  • ended_at — datetime(6) — 시청종료시각
  • session_status — varchar(30) — NOT NULL — 세션상태
  • created_at — datetime(6) — NOT NULL — 생성시각
  • updated_at — datetime(6) — NOT NULL — 수정시각

user

  • user_id — bigint — Primary key — NOT NULL — 식별자
  • role — varchar(20) — NOT NULL — 권한(ADMIN, USER)
  • email — varchar(255) — NOT NULL — 이메일
  • point — bigint — NOT NULL — 포인트
  • created_at — datetime(6) — NOT NULL — 생성시각
  • updated_at — datetime(6) — NOT NULL — 수정시각

user_coupon

  • user_coupon_id — bigint — Primary key — NOT NULL — 식별자
  • user_id — bigint — NOT NULL — 유저식별자
  • coupon_event_id — bigint — NOT NULL — 쿠폰이벤트식별자
  • coupon_event_item_id — bigint — NOT NULL — 쿠폰식별자
  • coupon_code — varchar(100) — NOT NULL — 쿠폰코드
  • coupon_status — varchar(30) — NOT NULL — 쿠폰상태
  • created_at — datetime(6) — NOT NULL — 생성시각
  • updated_at — datetime(6) — NOT NULL — 수정시각
  • claim_id — bigint — NOT NULL — 발급요청식별자
  • discount_type — varchar(20) — NOT NULL — 할인타입(RATE 또는 AMOUNT)
  • discount_value — decimal(10, 2) — NOT NULL — 할인값(발급시점스냅샷)
  • expires_at — datetime(6) — NOT NULL — 만료시각
  • used_at — datetime(6) — 사용시각
  • cancelled_at — datetime(6) — 취소시각
  • cancel_reason — varchar(255) — 취소사유

wallet_outbox

  • id — bigint — Primary key — NOT NULL — 식별자
  • aggregate_id — bigint — NOT NULL — 집계식별자(userCouponId 또는 claimId)
  • topic — varchar(100) — NOT NULL — 발행토픽명
  • payload — json — NOT NULL — 이벤트페이로드
  • status — varchar(20) — NOT NULL — 발행상태(PENDING, SENT)
  • retry_count — int — NOT NULL — 재시도횟수
  • created_at — datetime(6) — NOT NULL — 생성시각
  • sent_at — datetime(6) — 발행시각