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