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