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이면 유효)