omarket_final

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 — 실행 상태: completed/failed (내부 단계는 커밋되지 않음)
  • failure_code — VARCHAR(10) — 실패 시 API 에러 코드(예: E-SYSTEM)
  • failed_at — TIMESTAMPTZ — 실패 시각
  • error_message — TEXT — 실패 시 오류 상세(내부 로그용, API 미노출)
  • thresholds — JSONB — 판정에 적용된 기준값 스냅샷 JSONB(roas_base/roas_high/cost_threshold/min_impressions/min_clicks/account_roas)
  • preprocess_summary — JSONB — 전처리 요약 JSONB(rawRowCount/keywordCount/excludedRows/period/totals/accountRoas) — 새로고침 복원용(API §3.2)
  • 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 — NOT NULL — LLM 생성 설명 JSONB. 키: classificationReason/actionDetail/possibleCauses/checkItems
  • llm_model — VARCHAR(100) — NOT NULL — 생성에 사용한 모델명
  • is_latest — BOOLEAN — NOT NULL — 최신 설명 여부. P0에서는 무효화 경로 없음(항상 true)
  • generated_at — TIMESTAMPTZ — NOT NULL — 최초 생성 시각

keyword_result

  • id — BIGSERIAL — Primary key — NOT NULL — PK. API keywordId
  • analysis_run_id — UUID — Foreign key → analysis_run.id — NOT NULL — FK → analysis_run(id). 실행 삭제 시 CASCADE
  • search_keyword — VARCHAR(255) — NOT NULL — 검색어(합산 단위)
  • impressions — INTEGER — 노출 합계 = SUM(노출수)
  • clicks — INTEGER — 클릭 합계 = SUM(클릭수)
  • ctr — NUMERIC(10,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
  • performance_type_code — VARCHAR(30) — Foreign key → performance_type.code — FK → performance_type(code). completed 상태에서는 전 행 NOT NULL(커버리지 100%)
  • 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 — 등록 시각