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 — 등록 시각