omarketlabv1.1

Tables (3)

analysis_run

  • id — BIGSERIAL — Primary key — NOT NULL
  • file_name — VARCHAR(255) — NOT NULL — 업로드한 CSV 파일명 (네이버 다차원 보고서>검색어 보고서)
  • file_path — VARCHAR(500) — 원본 파일 저장 위치 — Raw DB 적재 대신 파일로 원본 추적 (Raw 적재는 P1)
  • file_size — BIGINT — 파일 크기(bytes)
  • file_checksum — VARCHAR(64) — 원본 파일 식별용 체크섬 (동일 파일 재업로드 감지)
  • uploaded_at — TIMESTAMPTZ — NOT NULL — 업로드 시각
  • status — VARCHAR(30) — NOT NULL — 실행 상태: uploaded → preprocessing → awaiting_thresholds → classifying → completed / failed
  • error_message — TEXT — 실패 시 오류 내용
  • recommended_thresholds — JSONB — 서버 산출 추천 기준값 (예: {"roas_base":312,"roas_high":480,"cost_threshold":12000,"min_impressions":10,"min_clicks":3})
  • thresholds — JSONB — 사용자 확정 기준값 스냅샷 (추천값 확인 후 입력, 8유형 판정에 실제 적용된 값) — 규칙 기반 판단 근거 생성 시 이 스냅샷을 참조
  • total_rows — INTEGER — 원본 CSV 데이터 행 수
  • filtered_rows — INTEGER — 전처리 후 유효 행 수 (쇼핑검색만 필터링, 불필요 행 제거 후)
  • keyword_count — INTEGER — 집계된 검색어 수
  • started_at — TIMESTAMPTZ — 분석 시작 시각
  • completed_at — TIMESTAMPTZ — 분석 완료 시각

keyword_result

  • id — BIGSERIAL — Primary key — NOT NULL
  • analysis_run_id — BIGINT — Foreign key → analysis_run.id — NOT NULL — 소속 분석 실행 (analysis_run.id 참조, 실행 삭제 시 결과도 삭제)
  • search_keyword — VARCHAR(255) — NOT NULL — 검색어 (합산 단위, 실행 내 유일)
  • impressions — INTEGER — 노출 합계 = SUM(impressions)
  • clicks — INTEGER — 클릭 합계 = SUM(clicks)
  • ctr — NUMERIC(5,2) — CTR(%) = SUM(clicks) / SUM(impressions) * 100 — 비율값 단순 평균 금지, 원천 합산값으로 재계산
  • cost — NUMERIC(14,2) — 광고비 합계 = SUM(total_cost)
  • cpc — NUMERIC(12,2) — CPC(원) = SUM(cost) / SUM(clicks)
  • cvr — NUMERIC(5,2) — CVR(%) = SUM(conversions) / SUM(clicks) * 100
  • conversions — INTEGER — 전환 합계 = SUM(total_conversions)
  • conv_sales — NUMERIC(14,2) — 전환매출 합계 = SUM(total_conv_sales) — ROAS 산출 근거
  • cpa — NUMERIC(14,2) — CPA(원) = SUM(cost) / SUM(conversions)
  • roas — NUMERIC(10,2) — ROAS(%) = SUM(conv_sales) / SUM(cost) * 100
  • performance_type_code — VARCHAR(30) — Foreign key → performance_type.code — 8유형 분류 결과 (performance_type.code 참조)
  • calculated_at — TIMESTAMPTZ — KPI 계산 시각 (전처리 단계)
  • classified_at — TIMESTAMPTZ — 유형 분류 시각 (분류 단계)

performance_type

  • code — VARCHAR(30) — Primary key — NOT NULL — 유형 코드 (keyword_result가 FK로 참조)
  • name_ko — VARCHAR(50) — NOT NULL — 한글명
  • description — TEXT — 유형 설명 (판정 규칙 요약)
  • sort_order — INTEGER — 표시 정렬 순서
  • is_active — BOOLEAN — NOT NULL — 사용 여부 (FK 참조 중인 유형은 삭제 대신 false 처리)
  • created_at — TIMESTAMPTZ — 등록 시각