advertisement

테이블 (5)

광고_결제_내역 (advertisement_payment_histories)

  • id — bigint(20) — 기본 키 — NOT NULL — 생성 시각(=결제 시도/처리 시각)
  • 생성일 (created_at) — datetime(6) — NOT NULL — 마지막 수정 시각
  • 수정일 (last_updated_at) — datetime(6) — NOT NULL — PortOne 결제 식별자(멱등/조회 키)
  • Portone 결제 식별자(멱등키) (payment_id) — varchar(255) — NOT NULL — 결제 대상 구독(advertisement_subscriptions.id)
  • 광고_구독_id(fk) (advertisement_subscription_id) — bigint(20) — 외래 키 → 광고_구독.id — NOT NULL — 결제 시점의 광고 타입(스냅샷)
  • 광고 타입 (advertisement_type) — enum('A', 'B', 'C', 'D') — NOT NULL — 결제 금액(결제 시점 enum 가격의 스냅샷)
  • 가격 (price) — decimal(13, 2) — NOT NULL — 결제 결과: SUCCESS/FAILED/CANCELED
  • 결제 결과 (status) — enum('FAILED', 'SUCCESS', 'CANCELED') — NOT NULL — 결제 실패 코드(실패 시)
  • 결제 실패 코드 (error_code) — varchar(255) — 결제 실패 메시지(실패 시)
  • 결제 실패 메시지 (error_message) — TEXT — 광고주(users.id)
  • 광고주_id(fk) (advertiser_id) — bigint(20) — NOT NULL — PK

광고_구독 (advertisement_subscriptions)

  • id — bigint(20) — 기본 키 — NOT NULL — PK
  • 생성일 (created_at) — datetime(6) — NOT NULL — 생성 시각
  • 수정일 (last_updated_at) — datetime(6) — NOT NULL — 마지막 수정 시각
  • 광고주id(fk) (advertiser_id) — bigint(20) — NOT NULL — 광고주(users.id)
  • 광고 타입 (advertisement_type) — enum('A', 'B', 'C', 'D') — NOT NULL — 현재 적용 중인 광고 타입(가격/피드 위치는 코드 enum에서 조회)
  • 변경 예약 타입 (pending_advertisement_type) — enum('A', 'B', 'C', 'D') — 변경예약 타입(다음 결제일에 advertisement_type으로 적용). NULL=예약 없음/변경취소
  • 구독 상태 (status) — enum('ACTIVE', 'CANCELED', 'EXPIRED', 'INACTIVE', 'FAILED') — NOT NULL — 구독 상태 - ACTIVE=결제중 - FAILED=결제실패 - CANCELED=해지완료 - EXPIRED=만료 - INACTIVE=비활성
  • 해지예약 (auto_renew) — bit(1) — NOT NULL — false=해지예약(다음 결제일 미결제·이후 미게시, 기간까지는 게시 유지). 해지취소 시 true로 복원
  • 구독 시작일 (starts_at) — datetime(6) — NOT NULL — 구독 시작 시각
  • 구독 만료일 (expires_at) — datetime(6) — 현재 결제 주기 만료 시각(해지예약 시 마지막 게시 종료 시점)
  • 다음 정기결제 예정일 (next_payment_at) — datetime(6) — 다음 정기결제 예정 시각(결제 스케줄러 조회 키)

광고_미디어 (advertisement_media)

  • id — bigint(20) — 기본 키 — NOT NULL — PK
  • 생성일 (created_at) — datetime(6) — NOT NULL — 생성 시각
  • 수정일 (last_updated_at) — datetime(6) — NOT NULL — 마지막 수정 시각
  • 광고_id(fk) (advertisement_id) — bigint(20) — 외래 키 → 광고게시글.id — NOT NULL — 광고 게시글(advertisements.id)
  • 미디어_id(fk) (media_id) — bigint(20) — NOT NULL — 미디어(media.id) — 기존 S3 미디어 재사용

광고_일일_지표 (advertisement_daily_metrics)

  • id — bigint(20) — 기본 키 — NOT NULL — 생성 시각
  • 생성일 (created_at) — datetime(6) — NOT NULL — 마지막 수정 시각
  • 수정일 (last_updated_at) — datetime(6) — NOT NULL — 광고 게시글(advertisements.id)
  • 광고_id(fk) (advertisement_id) — bigint(20) — 외래 키 → 광고게시글.id — NOT NULL — 집계 일자(KST 기준 버킷)
  • 집계 일자 (stat_date) — date — NOT NULL — 해당 일자 노출 수
  • 노출수 (impression_count) — bigint(20) — NOT NULL — 해당 일자 클릭 수(CTR은 파생, 미저장)
  • 클릭수 (click_count) — bigint(20) — NOT NULL

광고게시글 (advertisements)

  • id — bigint(20) — 기본 키 — NOT NULL — PK(외부 노출 식별자)
  • 생성일 (created_at) — datetime(6) — NOT NULL — 생성 시각
  • 수정일 (last_updated_at) — datetime(6) — NOT NULL — 마지막 수정 시각
  • 광고_구독id (advertisement_subscription_id) — bigint(20) — 외래 키 → 광고_구독.id — NOT NULL — 연결된 정기결제 구독(UNIQUE로 구독당 광고 1개 강제). 광고 타입은 구독이 단일 소유
  • 광고주id(FK) (advertiser_id) — bigint(20) — NOT NULL — 광고주(users.id) — 소유권 체크/목록 조회용 비정규화
  • 제목 (title) — varchar(255) — NOT NULL — 광고명
  • 내용 (body) — text — 광고 문구/본문(DRAFT 단계 미입력 허용)
  • 이동 URL (landing_url) — varchar(2048) — 클릭 시 이동할 도착 URL(심사 제출 시 필수 검증)
  • 광고 버튼 종류 (cta_label) — varchar(10) — 광고 버튼 종류(표시 문자열은 코드 enum 매핑: PURCHASE=구입하기
  • 광고 상태 (status) — enum('DRAFT', 'PENDING', 'REJECTED', 'APPROVED', 'PUBLISHED', 'PAUSED', 'TERMINATED') — NOT NULL — 게시글 상태 - 심사 전 - 심사 대기 - 반려 - 승인 - 게시중 - 일시중지 - 영구 종료 (?)
  • 반려 사유 (reject_reason) — text — 반려 사유(REJECTED일 때)
  • 심사 제출 시각 (submitted_at) — datetime(6) — 심사 제출 시각(DRAFT→PENDING)
  • 심사 처리 시각 (reviewed_at) — datetime(6) — 심사 처리 시각(승인/반려)
  • 심사 관리자 id(fk) (reviewed_by) — bigint(20) — 심사 관리자 id(timora_admin.admin_accounts.id). 타 DB라 FK 없음, 앱 레벨 검증
  • 게시 시작일 (published_at) — datetime(6) — 게시(노출 시작) 시각
  • 영구 종료일 (terminated_at) — datetime(6) — 영구 종료 시각
  • 삭제일 (deleted_at) — datetime(6) — soft delete 시각(NULL이면 유효)