omarketlab_final_v3

Tables (4)

analysis_run

  • id — UUID — Primary key — NOT NULL — PK. API analysisId와 동일 값(순번 비노출)
  • file_name — VARCHAR(255) — NOT NULL — 업로드한 CSV 파일명(네이버 다차원 보고서>검색어 보고서)
  • file_path — VARCHAR(500) — 원본 파일 저장 위치(스토리지 키/경로)
  • file_size — BIGINT — 파일 크기(bytes)
  • file_checksum — VARCHAR(64) — SHA-256 체크섬(동일 파일 재업로드 감지)
  • uploaded_at — TIMESTAMPTZ — NOT NULL — 업로드 시각
  • status — VARCHAR(30) — NOT NULL — 실행 상태: uploaded/preprocessing/awaiting_thresholds/classifying/completed/failed
  • failure_code — VARCHAR(10) — 실패 시 API 에러 코드(예: E-SYS-002)
  • failed_at — TIMESTAMPTZ — 실패 시각
  • error_message — TEXT — 실패 시 오류 상세(내부 로그용, API 미노출)
  • recommended_thresholds — JSONB — 서버 산출 추천 기준값 JSONB(roas_base/roas_high/cost_threshold/min_impressions/min_clicks/account_roas)
  • thresholds — JSONB — 사용자 확정 기준값 JSONB. 판정에 실제 적용
  • total_rows — INTEGER — 원본 CSV 데이터 행 수
  • filtered_rows — INTEGER — 전처리 후 유효 행 수
  • keyword_count — INTEGER — 집계된 검색어 수
  • started_at — TIMESTAMPTZ — 분석 시작 시각
  • completed_at — TIMESTAMPTZ — 분석 완료 시각

classification_reason

  • id — BIGSERIAL — Primary key — NOT NULL — PK
  • keyword_result_id — BIGINT — Foreign key → keyword_result.id — NOT NULL — FK → keyword_result(id). CASCADE
  • explanation — JSONB — LLM 생성 설명 JSONB. 키: classification_reason/action_detail/possible_causes/check_items
  • status — VARCHAR(20) — NOT NULL — pending/success/failed
  • error_code — VARCHAR(10) — 생성 실패 시 오류 코드(E-AI-001/E-AI-002)
  • llm_model — VARCHAR(100) — 생성에 사용한 모델명
  • is_latest — BOOLEAN — NOT NULL — 최신 설명 여부. 재생성·재분류 시 이전 행 false
  • generated_at — TIMESTAMPTZ — 생성 시각

keyword_result

  • id — BIGSERIAL — Primary key — NOT NULL — PK
  • analysis_run_id — UUID — Foreign key → analysis_run.id — NOT NULL — FK → analysis_run(id). 실행 삭제 시 CASCADE
  • performance_type_code — VARCHAR(30) — Foreign key → performance_type.code — FK → performance_type(code). 분류 전 NULL, completed 상태에서는 전 행 NOT NULL
  • search_keyword — VARCHAR(255) — NOT NULL — 검색어(합산 단위)
  • impressions — INTEGER — 노출 합계 = SUM(노출수)
  • clicks — INTEGER — 클릭 합계 = SUM(클릭수)
  • ctr — NUMERIC(5,2) — CTR(%) = 클릭 합계 ÷ 노출 합계 × 100. 노출 0이면 NULL
  • cost — NUMERIC(14,2) — 광고비 합계(원) = SUM(총비용)
  • cpc — NUMERIC(12,2) — CPC(원) = 비용 합계 ÷ 클릭 합계. 클릭 0이면 NULL
  • cvr — NUMERIC(10,2) — CVR(%) = 전환 합계 ÷ 클릭 합계 × 100. 클릭 0이면 NULL, 1000% 초과 가능
  • conversions — NUMERIC(10,2) — 전환 합계(건) = SUM(총 전환수). 간접전환 가중치로 소수점 발생
  • conv_sales — NUMERIC(14,2) — 전환매출 합계(원) = SUM(총 전환매출). ROAS 산출 근거
  • cpa — NUMERIC(14,2) — CPA(원) = 비용 합계 ÷ 전환 합계. 전환 0이면 NULL
  • roas — NUMERIC(10,2) — ROAS(%) = 전환매출 합계 ÷ 비용 합계 × 100. 비용 0이면 NULL
  • rule_id — VARCHAR(8) — 적용된 결정 트리 규칙(R0, R1a~R1d, R2a~R2d). 판정 경로 추적용
  • calculated_at — TIMESTAMPTZ — KPI 계산 시각(전처리 단계)
  • classified_at — TIMESTAMPTZ — 유형 분류 시각(분류 단계)

performance_type

  • code — VARCHAR(30) — Primary key — NOT NULL — PK. 유형 코드(의미 기반 영문 소문자)
  • name_ko — VARCHAR(50) — NOT NULL — 한글명(화면 표시명)
  • rule_id — VARCHAR(8) — 결정 트리 규칙 ID (R0, R1a~R1d, R2a~R2d). 판단 보류는 R0/R2d
  • description — TEXT — 유형 설명(판정 규칙 요약)
  • sort_order — INTEGER — 화면 표시 정렬 순서(판정 우선순위가 아님)
  • is_active — BOOLEAN — NOT NULL — 사용 여부. FK 참조 중인 유형은 물리 삭제 금지, false 처리
  • created_at — TIMESTAMPTZ — 등록 시각