데이터 분석 가이드

national_audit DB · 스키마 public·digstg·procurement_delivery · 테이블 63개 · 뷰 4개 · FK 3개 (관계는 논리 컬럼 연결) · 전체 119,335,287행 (추정치) · 85.9GB

LLM·에이전트용 전체 분석 가이드 (Markdown)두 몰 수집 구조, 스냅샷/관측 모델, 가격 종류, 상품 매핑 규칙, 실제 납품 실적 조인, 분석 산출물 읽는 법, 검증된 SQL을 한 문서에 정리

설명이 없는 객체는 "구조 확인됨 · 의미 미검증"입니다. 추측으로 채우지 않습니다. 검토 결정은 별도 DB(audit_review)의 review_decisions / review_decision_history 에 저장됩니다.

핵심 관계도 (ER)

파란 상자: 핵심 엔티티 · 흰 상자: 종속 테이블

적용된 마이그레이션

2026-10-04 13:10001_init.sql 2026-09-12 01:02002_explorer_ro.sql 2026-09-12 08:47003_throttle_log.sql 2026-09-12 09:34004_log_indexes.sql 2026-09-12 09:42005_listing_attachment_index.sql 2026-09-12 12:51006_web_indexes.sql 2026-09-13 00:45007_search_doc.sql 2026-10-04 17:20008_section_head.sql 2026-10-04 13:11009_sort_and_misc.sql 2026-10-04 13:11010_anomaly_tables.sql 2026-10-04 13:11011_anomaly_hedonic.sql 2026-10-04 13:11012_anomaly_score_all.sql 2026-10-04 13:11013_anomaly_label.sql 2026-10-04 13:11014_source_observation.sql 2026-10-04 13:12015_cross_xref.sql 2026-10-04 13:12

웹 뷰어 인덱스(006_web_indexes.sql): 24/24개 적용

뷰

public.deleted_candidates정의 보기

 SELECT ctrt_item_mng_no,
    last_seen_snapshot
   FROM listing l
  WHERE (last_seen_snapshot < ( SELECT max(collection_run.snapshot_id) AS max
           FROM collection_run
          WHERE ((collection_run.kind = 'listing'::text) AND (collection_run.status = 'done'::text))));

public.listing_current정의 보기

 SELECT l.ctrt_item_mng_no,
    l.item_idnf_no,
    l.ctent_unty_grp_no,
    l.ctrt_no,
    l.ctrt_chg_ord,
    l.ctrt_item_sqno,
    l.shop_ctrt_ty_cd,
    l.ctrt_ty_cd,
    l.mall_no,
    l.l_cate,
    l.m_cate,
    l.detail_url,
    l.unty_atch_file_no,
    l.current_version_id,
    l.first_seen_snapshot,
    l.last_seen_snapshot,
    l.is_active,
    l.id_format,
    v.ctrt_uprc,
    v.dscnt_aplcn_uprc,
    v.ctrt_end_ymd,
    v.content_hash
   FROM (listing l
     JOIN listing_version v ON ((v.version_id = l.current_version_id)));

public.price_history정의 보기

 SELECT v.ctrt_item_mng_no,
    v.valid_from_snapshot,
    v.valid_to_snapshot,
    v.ctrt_uprc,
    v.dscnt_aplcn_uprc,
    v.evnt_dscnt_rate,
    ctrt_chg_ord_v.ctrt_chg_ord
   FROM (listing_version v
     JOIN LATERAL ( SELECT (v.raw ->> 'ctrtChgOrd'::text) AS ctrt_chg_ord) ctrt_chg_ord_v ON (true));

public.search_doc정의 보기

 SELECT l.ctrt_item_mng_no AS id,
    l.is_active,
    btrim(concat_ws(' '::text, i.item_idnf_nm_raw, i.item_cfnm, i.model_raw, i.spec_raw, i.mnftr_etps_nm, i.item_idnf_no, v.snym_nm, vd.name, vd.bzmn_reg_no, l.ctrt_item_mng_no, l.ctrt_no)) AS txt
   FROM (((listing l
     JOIN listing_version v ON ((v.version_id = l.current_version_id)))
     JOIN item i ON ((i.item_idnf_no = l.item_idnf_no)))
     LEFT JOIN vendor vd ON ((vd.ctent_unty_grp_no = l.ctent_unty_grp_no)));

인덱스 (93개)

anomaly_candidate

anomaly_candidate_pkey

anomaly_hedonic

anomaly_hedonic_pkeyix_anomaly_hedonic_excess

anomaly_label

anomaly_label_pkeyix_anomaly_label_level

anomaly_market_judge

anomaly_market_judge_pkey

anomaly_score

anomaly_score_pkeyix_anomaly_score_z

api_call_log

api_call_log_pkeyix_api_call_log_ts

digstg.attachment

첨부 문서(규격서·계약조건) 메타와 추출 본문. 원본 파일은 저장하지 않는다.

23,586행

506.0MB

설명 0/14

컬럼	타입	null
unty_atch_file_no	text	not null
atch_file_sqno	integer	not null
kind_cd	text
orgnl_file_nm	text
ext	text
file_sz	bigint
sha256	text

digstg.attachment_section

첨부 본문의 절 단위 분리(제목·본문).

2,257,961행

957.5MB

설명 0/5

컬럼	타입	null
unty_atch_file_no	text	not null
atch_file_sqno	integer	not null
seq	integer	not null
heading	text
body_text	text

digstg.attachment_version

digstg의 첨부 버전(스테이징). 분석에는 public.attachment_version을 사용.

23,427행

499.8MB

설명 0/10

컬럼	타입	null
attachment_version_id	bigint	not null
unty_atch_file_no	text	not null
atch_file_sqno	integer	not null
sha256	text	not null
text_extracted	text
text_len	integer
extract_method	text
extractor_version	text
extract_status	text
first_observed_at	timestamp with time zone	not null

digstg.collection_run

수집 실행(스냅샷) 단위. kind=listing(목록 파이프라인)/detail(상세). params에 m_cate·pipeline/trial 표시.

4행

16KB

설명 1/10

컬럼	타입	null	설명
snapshot_id	bigint	not null
kind	text	not null
started_at	timestamp with time zone	not null
finished_at	timestamp with time zone
params	jsonb
status	text	not null	실행 상태(done/running/aborted/failed)
totals	jsonb
source_system	text	not null
scope_hash	text
parent_snapshot_id	bigint

digstg.collection_task

목록 수집의 체크포인트(중분류×가격구간). 시작 시 총건수와 실제 수집 건수를 대조한다.

21행

16KB

설명 0/15

컬럼	타입	null
snapshot_id	bigint	not null
task_key	text	not null
kind	text	not null
m_cate	text
l_cate	text
price_from	bigint
price_to	bigint
total_size_at_start	integer
fetched	integer
pages	integer
status	text	not null
attempts	integer
raw_file	text
last_error	text
updated_at	timestamp with time zone

digstg.contract_xref

digstg의 계약 교차 링크(스테이징). 분석에는 public.contract_xref를 사용.

50행

16KB

설명 2/4

컬럼	타입	null	설명
ctrt_no	text	not null
digital_listings	integer	not null	이 계약번호로 디지털몰에 관측된 등재 수
shop_listings	integer	not null	이 계약번호로 종합몰에 관측된 등재 수
updated_snapshot	bigint

digstg.item

digstg의 상품(스테이징). 분석에는 public.item을 사용.

10,041행

3.7MB

설명 0/12

컬럼	타입	null
item_idnf_no	text	not null
item_clsf_no	text
dtls_prnm_no	text
dtls_prnm	text
item_cfnm	text
item_idnf_nm_raw	text
mnftr_etps_nm	text
model_raw	text
spec_raw	text
parse_status	text
first_seen	bigint
last_seen	bigint

digstg.item_attribute

상품 속성(속성명·값·단위). 상세 화면 '상품속성및특성정보'.

50,982행

4.8MB

설명 0/5

컬럼	타입	null
item_idnf_no	text	not null
atrb_nm	text	not null
snapshot_id	bigint	not null
atrb_value	text
atrb_unit	text

digstg.item_description

업체가 등록한 상품설명 HTML과 추출 텍스트, 포함 이미지 URL. 이미지만 있으면 is_image_only.

10,045행

25.4MB

설명 0/6

컬럼	타입	null
item_idnf_no	text	not null
snapshot_id	bigint	not null
html_raw	text
text_extracted	text
image_urls	jsonb
is_image_only	boolean

digstg.item_xref

digstg의 상품 교차 링크(스테이징). 분석에는 public.item_xref를 사용.

544행

72KB

설명 4/5

컬럼	타입	null	설명
digital_item_idnf_no	text	not null	디지털몰 상품의 물품식별번호
shop_item_idnf_no	text	not null	종합몰 상품의 물품식별번호
match_type	text	not null	연결 규칙: maker_model(고정밀) / maker_model_family(중정밀)
shared_vendors	integer	not null	양쪽 상품 모두에 등재로 연결된 공급업체 수
first_seen_snapshot	bigint

digstg.listing

디지털몰 슬라이스 운영 이관용 스테이징 복사본(public 정합 확인용). 분석에는 public 스키마를 사용.

10,180행

2.2MB

설명 0/18

컬럼	타입	null
ctrt_item_mng_no	text	not null
item_idnf_no	text
ctent_unty_grp_no	text
ctrt_no	text
ctrt_chg_ord	text
ctrt_item_sqno	integer
shop_ctrt_ty_cd	text
ctrt_ty_cd	text
mall_no	text
l_cate	text
m_cate	text
detail_url	text
unty_atch_file_no	text
current_version_id	bigint
first_seen_snapshot	bigint
last_seen_snapshot	bigint
is_active	boolean
id_format	text

digstg.listing_attachment_observation

스냅샷별 '등재↔첨부' 관측 — 그 시점에 어떤 문서 버전이 붙어 있었는지.

49,747행

6.4MB

설명 0/8

컬럼	타입	null
snapshot_id	bigint	not null
ctrt_item_mng_no	text	not null
unty_atch_file_no	text	not null
atch_file_sqno	integer	not null
attachment_version_id	bigint
document_kind_raw	text
document_role	text
fetch_status	text

digstg.listing_contract_terms

계약사항(계약번호+차수 단위): 계약일·기간·공급지역·특수조건 본문·담당부서.

3,241행

9.2MB

설명 0/12

컬럼	타입	null
ctrt_no	text	not null
ctrt_chg_ord	text	not null
snapshot_id	bigint	not null
ctrt_dt	text
ctrt_bgng_ymd	text
ctrt_end_ymd	text
sppl_rgn_nm	text
special_terms_text	text
org_nm	text
pic_nm	text
pic_tel	text
raw	jsonb

digstg.listing_delivery_case

납품사례(어느 수요기관이 언제 샀는지). 1페이지(18건)만.

0행빈 테이블

8KB

설명 0/5

컬럼	타입	null
ctrt_item_mng_no	text	not null
seq	integer	not null
snapshot_id	bigint	not null
dminstt_nm	text
rgst_dt	text

digstg.listing_detail_part

상세 기본정보의 배열 파트(옵션 dlCtrtOptnItmltL, 인증 dlCertInfoL, 녹색 dlGreenInfoL, 구매정보 dlBuyInfoL).

11,780행

3.8MB

설명 0/5

컬럼	타입	null
ctrt_item_mng_no	text	not null
snapshot_id	bigint	not null
part	text	not null
seq	integer	not null
data	jsonb

digstg.listing_image

등재 이미지 URL(목록 썸네일, 상세 원본).

30,411행

6.3MB

설명 0/5

컬럼	타입	null
ctrt_item_mng_no	text	not null
seq	integer	not null
snapshot_id	bigint	not null
url	text
kind	text

digstg.listing_observation

수집 실행(스냅샷)별 관측 기록. 어떤 시점에 어떤 버전의 등재가 실제로 보였는지의 근거 — 수집률·시점 분석은 이 테이블 기준.

10,186행

1.4MB

설명 1/6

컬럼	타입	null	설명
snapshot_id	bigint	not null
ctrt_item_mng_no	text	not null
listing_version_id	bigint		그 스냅샷에서 관측된 등재 버전 → listing_version.version_id
observed_at	timestamp with time zone	not null
raw_ref	text
category_memberships	jsonb

digstg.listing_source

digstg의 출처 상태(스테이징). 분석에는 public.listing_source를 사용.

10,180행

1.0MB

설명 3/8

컬럼	타입	null	설명
source_system	text	not null	출처: shop(종합쇼핑몰) / digital(디지털서비스몰)
ctrt_item_mng_no	text	not null
source_detail_url	text
first_seen_snapshot	bigint	not null
last_seen_snapshot	bigint	not null
last_verified_full_snapshot	bigint		마지막으로 전체-목록 수집에 이 등재가 확인된 스냅샷
presence_status	text	not null	active / missing_candidate(최신 전체수집에서 미관측 후보, 자동 삭제 아님)
consecutive_missing_count	integer	not null

digstg.listing_version

digstg의 등재 버전(스테이징). 분석에는 public.listing_version을 사용.

10,180행

54.2MB

설명 3/57

컬럼	타입	null	설명
version_id	bigint	not null
ctrt_item_mng_no	text	not null
valid_from_snapshot	bigint	not null
valid_to_snapshot	bigint
content_hash	text	not null
ctrt_uprc	numeric
srch_uprc	numeric
dscnt_aplcn_uprc	numeric
evnt_dscnt_rate	numeric
evnt_bgng_ymd	text
evnt_end_ymd	text
ctrt_bgng_ymd	text
ctrt_end_ymd	text
ctrt_ymd	text
ctrt_qty	numeric
ctrt_unt_val	text
ctrt_cncltn_yn	text
last_ctrt_yn	text
mas_ctrt_yn	text
mas_compe_yn	text
onc_max_dlreq_amt	numeric
min_ordr_qty	numeric
devy_cndt_cd	text
devy_cndt_nm	text
dlvgds_term_nody	integer
sppl_rgn_no	text
sppl_rgn_nm	text
apml_no	text
apml_nm	text
item_cert	text
ftal_prchs_trgt_cert	text
sment_btwn_cmpet_prd_yn	text
exc_prod_yn	text
bsam_cmpt_prod_yn	text
ndfm_rgst_trgt_yn	text
ai_gds_yn	text
ntsl_qnty	numeric
ntsl_qnty1	numeric
ntsl_qnty2	numeric
ntsl_qnty3	numeric
ntsl_qnty4	numeric
sppl_revw_cnt	integer
grde	numeric
pdct_eval_cnt	integer
img_src	text
s_img_src	text
pdct_atrb_cd_dtl	text
snym_nm	text
raw	jsonb
raw_ref	text
data_source	text	not null
endpoint_version	text
disclosure_default	text	not null
created_at	timestamp with time zone
ctlg_ctrt_yn	text		카탈로그 계약 여부(Y=수요기관 협상으로 실제 가격 결정)
price_kind	text		가격 성격: registered_unit(등재 단가) / catalog_reference(카탈로그 계약 참고가 — 실제 구매가 아님)
observed_at	timestamp with time zone	not null	이 버전을 관측한 시각

digstg.source_category

digstg의 디지털 카테고리(스테이징). 분석에는 public.source_category를 사용.

34행

16KB

설명 1/8

컬럼	타입	null	설명
source_system	text	not null
category_code	text	not null
parent_category_code	text
mall_code	text		몰 구분 코드(디지털몰 5개 영역 식별)
level	integer
name	text
first_seen_snapshot	bigint
last_seen_snapshot	bigint

digstg.vendor

digstg의 업체(스테이징). 분석에는 public.vendor를 사용.

1,371행

384KB

설명 0/10

컬럼	타입	null
ctent_unty_grp_no	text	not null
bzmn_reg_no	text
name	text
ent_form_se_cd	text
ent_form_se_nm	text
hdofc_lctn_cd	text
hdofc_lctn_nm	text
addr	text
first_seen	bigint
last_seen	bigint

digstg.vendor_contact

판매자 정보(대표자·이메일·전화·주소·담당자). 나라장터 공개 정보.

1,408행

760KB

설명 0/9

컬럼	타입	null
ctent_unty_grp_no	text	not null
snapshot_id	bigint	not null
rprsv_nm	text
email	text
tel	text
addr	text
pic_nm	text
pic_tel	text
raw	jsonb

procurement_delivery.delivery_order_line

나라장터쇼핑몰 납품요구 물품 내역(공식 자료요청 CSV 적재, 2026-09-28). 행=납품요구 1건의 품목 1라인. 기관·계약·상품·수량·실제 단가·금액·증감 포함 — 실제 지출 분석의 원천. product_id+contract_no로 listing과 연결 가능.

2,830,216행

4.0GB

PK: delivery_request_no, delivery_request_revision, line_no

설명 10/47

ix_delivery_line_agency_date · ix_delivery_line_contract · ix_delivery_line_product · ix_delivery_line_source_file · ix_delivery_line_supplier

컬럼	타입	null	설명
delivery_request_noPK	text	not null
delivery_request_revisionPK	text	not null
line_noPK	integer	not null
agency_code	text
agency_name	text		납품요구 기관명
request_date_raw	text
request_date	date
request_name	text
supplier_business_no	text		공급업체 사업자번호(→ vendor.bzmn_reg_no 조인 가능)
supplier_name	text
item_class_code	text
item_class_name	text
detail_class_code	text
detail_class_name	text
product_id	text		물품식별번호(→ item.item_idnf_no 조인 가능)
product_name	text
delivery_deadline_raw	text
delivery_deadline	date
contract_type	text
contract_no	text		계약번호(→ listing.ctrt_no 조인 가능)
contract_revision	text
mas_flag	text
direct_purchase_flag	text
excellent_product_flag	text
certifications	text
purchase_method	text
final_request_flag	text
agency_type	text
agency_region	text
supplier_size	text
supplier_region	text
women_business_flag	text
disabled_business_flag	text
social_enterprise_flag	text
procurement_office	text
contract_unit_price	numeric		계약단가(계약 시점)
delivery_unit_price	numeric		납품 실제 단가
unit	text
delivery_quantity	numeric		납품 수량
delivery_amount	numeric		납품 금액(단가×수량 기반 실제 지출)
quantity_adjustment	numeric		수량 조정(+/-)
amount_adjustment	numeric		금액 조정(+/-)
cumulative_quantity_adjustment	numeric
cumulative_amount_adjustment	numeric
source_file	text	not null
source_row_no	bigint	not null
imported_at	timestamp with time zone	not null

procurement_delivery.import_source

납품요구 내역 적재 이력 — 원본 CSV 파일명·행 수·헤더 해시·적재 시각.

4행

32KB

PK: source_file

설명 0/4

컬럼	타입	null
source_filePK	text	not null
row_count	bigint	not null
header_sha256	text	not null
imported_at	timestamp with time zone	not null

public.anomaly_candidate

초기 규칙 기반 이상가격 후보(~999건). ratio=등재가/기준가. excess_est는 미검증 판매지표를 곱한 추정값 — 실제 지출·낭비액 아님. 재검증 결과는 웹의 anomaly/review JSON이 권위.

999행

328KB

PK: id

설명 2/10

컬럼	타입	null	설명
idPK	text	not null
kind	text	not null	수집 종류(listing=목록, detail=상세)
dtls_prnm	text		세부품명
nm	text
vendor	text
listed_price	numeric
ref_price	numeric
ratio	numeric
ntsl	bigint
excess_est	numeric

public.anomaly_hedonic

헤도닉 가격모형 기반 상위 1,000 후보. fitted=모형 기대가격, z=세부품명 그룹 내 강건 잔차, q=BH-FDR(남아있으나 재검증 패널은 사용 중지), excess=(price−fitted)×판매지표.

1,000행

384KB

PK: id

설명 4/14

ix_anomaly_hedonic_excess

컬럼	타입	null	설명
idPK	text	not null
dtls	text
nm	text
mnftr	text
model	text
vendor	text
price	numeric
fitted	numeric		모형 기대가격 exp(ŷ)
ratio	numeric
z	numeric		세부품명 그룹 내 studentized 잔차(MAD 스케일)
q	numeric		Benjamini–Hochberg q(재검증 패널에서는 오탐 보장으로 사용하지 않음)
gn	integer
ntsl	bigint
excess	numeric		(가격−기대가격)×판매지표 — 지표 미검증이라 실제 금액 아님

public.anomaly_label

종합 의심도 점수(0~100)와 레벨 L1~L5 — 통계+규모+외부증거+구조신호 가중합. 재검증 이후 이 레이블만으로 확정 판단하지 않음.

1,000행

592KB

PK: id

설명 2/7

ix_anomaly_label_level

컬럼	타입	null	설명
idPK	text	not null
score	integer	not null	통계+규모+외부증거+구조 가중합(0~100)
level	integer	not null	L1(낮음)~L5(높음) — 점수 구간, 확정 판단 아님
llm_known	boolean
llm_fair	numeric
parts	jsonb
reasons	text

public.anomaly_market_judge

후보별 외부 시장가 조사(네이버 쇼핑 매칭)와 LLM 동일상품 판정 결과.

193행

72KB

PK: id

설명 1/7

컬럼	타입	null	설명
idPK	text	not null
query	text
listed	numeric
same	boolean
fair_price	numeric
reason	text		조절 사유
industrial	boolean

public.anomaly_score

전수 이상가격 스코어(종합몰 1,037,690건, 디지털몰 미포함). id=등재번호. 드릴다운·차트용.

1,037,690행

163.2MB

PK: id

설명 0/6

ix_anomaly_score_z

컬럼	타입	null
idPK	text	not null
z	numeric
q	numeric
price	numeric
fitted	numeric
excess	numeric

public.api_call_log

API 호출 로그(응답시간·상태). 기준선·감속 판단용.

4,615,354행

733.1MB

PK: id

설명 6/8

ix_api_call_log_ts

컬럼	타입	null	설명
idPK	bigint	not null
ts	timestamp with time zone		호출 시각
endpoint	text		요청 URL
ms	integer		응답 소요(ms)
status	integer		HTTP 상태 코드(0=전송 실패·타임아웃)
ok	boolean		성공 여부
queue	text		큐 이름(listing/detail/attach)
source_system	text

public.attachment

첨부 문서(규격서·계약조건) 메타와 추출 본문. 원본 파일은 저장하지 않는다.

360,623행

10.9GB

PK: unty_atch_file_no, atch_file_sqno

설명 13/14

ix_attach_fname_trgm · ix_attachment_status

컬럼	타입	null	설명
unty_atch_file_noPK	text	not null	통합첨부파일번호
atch_file_sqnoPK	integer	not null	첨부 파일 순번
kind_cd	text		첨부 종류 코드
orgnl_file_nm	text		원본 파일명
ext	text		확장자
file_sz	bigint		파일 크기(byte)
sha256	text		파일 SHA-256 해시
text_extracted	text		추출 본문
text_len	integer		추출 텍스트 길이
extract_method	text		추출 도구(hwp5txt 등)
extract_status	text		추출 상태(ok/pending/failed:사유)
extracted_at	timestamp with time zone		추출 완료 시각
is_common_doc	boolean		공통 문서 여부
current_attachment_version_id	bigint

public.attachment_section

첨부 본문의 절 단위 분리(제목·본문).

36,153,413행

18.6GB

PK: unty_atch_file_no, atch_file_sqno, seq

설명 2/5

컬럼	타입	null	설명
unty_atch_file_noPK	text	not null	통합첨부파일번호
atch_file_sqnoPK	integer	not null	첨부 파일 순번
seqPK	integer	not null
heading	text
body_text	text

public.attachment_section_head

attachment_section 본문 앞 2,000자만 떼어 놓은 읽기 캐시(상세 페이지 속도용). 비분석용.

33,962,805행

15.1GB

PK: unty_atch_file_no, atch_file_sqno, seq

설명 2/6

컬럼	타입	null	설명
unty_atch_file_noPK	text	not null	통합첨부파일번호
atch_file_sqnoPK	integer	not null	첨부 파일 순번
seqPK	integer	not null
heading	text
body	text
truncated	boolean

public.attachment_version

첨부 파일의 내용(sha256) 버전. 같은 파일번호라도 내용이 바뀌면 별도 행으로 추적된다.

23,427행

504.1MB

PK: attachment_version_id

설명 7/10

attachment_version_unty_atch_file_no_atch_file_sqno_sha256_key

컬럼	타입	null	설명
attachment_version_idPK	bigint	not null
unty_atch_file_no	text	not null	통합첨부파일번호
atch_file_sqno	integer	not null	첨부 파일 순번
sha256	text	not null	파일 SHA-256 해시
text_extracted	text		추출 본문
text_len	integer		추출 텍스트 길이
extract_method	text		추출 도구(hwp5txt 등)
extractor_version	text
extract_status	text		추출 상태(ok/pending/failed:사유)
first_observed_at	timestamp with time zone	not null

public.code

코드표(계약구분·기업구분·인증 등).

0행빈 테이블

16KB

PK: code_grp, code

설명 0/5

컬럼	타입	null
code_grpPK	text	not null
codePK	text	not null
label	text
source	text
first_seen	bigint

public.collection_run

수집 실행(스냅샷) 단위. kind=listing(목록 파이프라인)/detail(상세). params에 m_cate·pipeline/trial 표시.

327행

232KB

PK: snapshot_id

설명 7/10

ix_crun_started

컬럼	타입	null	설명
snapshot_idPK	bigint	not null	스냅샷(collection_run)
kind	text	not null	수집 종류(listing=목록, detail=상세)
started_at	timestamp with time zone	not null	수집 시작 시각
finished_at	timestamp with time zone		수집 종료 시각
params	jsonb		수집 파라미터(JSONB)
status	text	not null	실행 상태(done/running/aborted/failed)
totals	jsonb		수집 결과 요약(JSONB)
source_system	text	not null
scope_hash	text
parent_snapshot_id	bigint

public.collection_task

목록 수집의 체크포인트(중분류×가격구간). 시작 시 총건수와 실제 수집 건수를 대조한다.

439행

168KB

PK: snapshot_id, task_key

설명 15/15

ix_ctask_done_cate

컬럼	타입	null	설명
snapshot_idPK	bigint	not null	스냅샷(collection_run)
task_keyPK	text	not null	작업 키(중분류:가격대)
kind	text	not null	수집 종류(listing=목록, detail=상세)
m_cate	text		대상 중분류 코드
l_cate	text		대상 대분류 코드
price_from	bigint		가격 분할 하한
price_to	bigint		가격 분할 상한
total_size_at_start	integer		시작 시점 전체 건수
fetched	integer		수집된 건수
pages	integer		조회 페이지 수
status	text	not null	실행 상태(done/running/aborted/failed)
attempts	integer		시도 횟수
raw_file	text		원시 NDJSON 파일 경로
last_error	text		마지막 오류 메시지
updated_at	timestamp with time zone		작업 갱신 시각

public.contract_xref

양쪽 몰에 같은 계약번호가 존재하는 계약. '같은 계약 체계'라는 뜻이며 계약 안 상품이 같다는 뜻이 아니다(실측 상품명 일치 0건).

50행

32KB

PK: ctrt_no

설명 3/4

컬럼	타입	null	설명
ctrt_noPK	text	not null	계약번호
digital_listings	integer	not null	이 계약번호로 디지털몰에 관측된 등재 수
shop_listings	integer	not null	이 계약번호로 종합몰에 관측된 등재 수
updated_snapshot	bigint

public.item

상품(물품식별번호 8자리). 품명·제조사·모델·규격 파싱 결과와 원문. 여러 등재(listing)가 한 상품을 가리킬 수 있다.

987,662행

521.4MB

PK: item_idnf_no

설명 10/12

ix_item_cfnm_trgm · ix_item_dtls · ix_item_idnfno_trgm · ix_item_mnftr_trgm · ix_item_model_trgm · ix_item_raw_trgm · ix_item_spec_trgm

컬럼	타입	null	설명
item_idnf_noPK	text	not null	물품식별번호 8자리
item_clsf_no	text		물품분류번호 8자리
dtls_prnm_no	text		세부품명번호 10자리(분류번호+2자리)
dtls_prnm	text		세부품명
item_cfnm	text		품명
item_idnf_nm_raw	text		'품명, 제조사, 모델, 규격' 원문
mnftr_etps_nm	text		제조사
model_raw	text		모델명(원문에서 분리)
spec_raw	text		규격(원문에서 분리)
parse_status	text		ok / no_spec / unparsed
first_seen	bigint
last_seen	bigint

컬럼	타입	null
old_noPK	text	not null
new_no	text	not null
source	text

public.item_attribute

상품 속성(속성명·값·단위). 상세 화면 '상품속성및특성정보'.

9,260,572행

1.1GB

PK: item_idnf_no, atrb_nm, snapshot_id

설명 5/5

컬럼	타입	null	설명
item_idnf_noPK	text	not null	물품식별번호 8자리
atrb_nmPK	text	not null	속성명
snapshot_idPK	bigint	not null	스냅샷(collection_run)
atrb_value	text		속성값
atrb_unit	text		단위

public.item_class

물품분류번호(8자리) 마스터 — 조달청 물품분류 코드표(9,797개).

0행빈 테이블

16KB

PK: item_clsf_no

설명 1/5

컬럼	타입	null	설명
item_clsf_noPK	text	not null	물품분류번호 8자리
lclsf_nm	text
mclsf_nm	text
clsf_nm	text
description	text

public.item_description

업체가 등록한 상품설명 HTML과 추출 텍스트, 포함 이미지 URL. 이미지만 있으면 is_image_only.

987,998행

1.1GB

PK: item_idnf_no, snapshot_id

설명 3/6

컬럼	타입	null	설명
item_idnf_noPK	text	not null	물품식별번호 8자리
snapshot_idPK	bigint	not null	스냅샷(collection_run)
html_raw	text
text_extracted	text		추출 본문
image_urls	jsonb
is_image_only	boolean

public.item_xref

종합몰↔디지털몰 상품 연결 후보. match_type: maker_model(제조사+모델 일치, 고정밀) / maker_model_family(버전 제외 제품군 일치, 중정밀). 규격·구매조건 동일성을 보장하지 않는다 — 비교 전엔 규격서 대조 필요.

544행

136KB

PK: digital_item_idnf_no, shop_item_idnf_no, match_type

설명 4/5

ix_item_xref_shop

컬럼	타입	null	설명
digital_item_idnf_noPK	text	not null	디지털몰 상품의 물품식별번호
shop_item_idnf_noPK	text	not null	종합몰 상품의 물품식별번호
match_typePK	text	not null	연결 규칙: maker_model(고정밀) / maker_model_family(중정밀)
shared_vendors	integer	not null	양쪽 상품 모두에 등재로 연결된 공급업체 수
first_seen_snapshot	bigint

public.listing

등재(계약품목관리번호) — 어느 업체가 어떤 계약으로 어떤 상품을 올렸는가. 현재 상태와 상세 링크·첨부그룹 번호.

1,053,300행

469.2MB

PK: ctrt_item_mng_no

설명 13/18

ix_listing_ctrtno_trgm · ix_listing_first_seen · ix_listing_item · ix_listing_l_cate_act · ix_listing_last_seen · ix_listing_m_cate_act · ix_listing_mngno_trgm · ix_listing_vendor_act

컬럼	타입	null	설명
ctrt_item_mng_noPK	text	not null	계약품목관리번호(등재 PK). 구형 002060827_1320000004 / 신형 R26TA… 두 형식
item_idnf_no	text		물품식별번호 8자리
ctent_unty_grp_no	text		업체 통합그룹번호(vendor PK)
ctrt_no	text		계약번호
ctrt_chg_ord	text		계약 변경차수
ctrt_item_sqno	integer		계약 품목순번
shop_ctrt_ty_cd	text		쇼핑몰 계약유형(계120004 다수공급자, 계120003 제3자단가, …)
ctrt_ty_cd	text
mall_no	text
l_cate	text		대상 대분류 코드
m_cate	text		대상 중분류 코드
detail_url	text		쇼핑몰 상세 화면 직행 링크
unty_atch_file_no	text		통합첨부파일번호
current_version_id	bigint		현재 버전(listing_version)
first_seen_snapshot	bigint
last_seen_snapshot	bigint
is_active	boolean		최신 스냅샷에 존재하는가
id_format	text

public.listing_attachment

등재↔첨부 연결.

4,231,041행

763.0MB

PK: ctrt_item_mng_no, unty_atch_file_no, atch_file_sqno

설명 3/3

ix_listing_attachment_file

컬럼	타입	null	설명
ctrt_item_mng_noPK	text	not null	계약품목관리번호(등재 PK). 구형 002060827_1320000004 / 신형 R26TA… 두 형식
unty_atch_file_noPK	text	not null	통합첨부파일번호
atch_file_sqnoPK	integer	not null	첨부 파일 순번

public.listing_attachment_observation

스냅샷별 '등재↔첨부' 관측 — 그 시점에 어떤 문서 버전이 붙어 있었는지.

49,747행

15.6MB

PK: snapshot_id, ctrt_item_mng_no, unty_atch_file_no, atch_file_sqno

설명 4/8

ix_lao_attachment · ix_lao_snapshot

컬럼	타입	null	설명
snapshot_idPK	bigint	not null	스냅샷(collection_run)
ctrt_item_mng_noPK	text	not null	계약품목관리번호(등재 PK). 구형 002060827_1320000004 / 신형 R26TA… 두 형식
unty_atch_file_noPK	text	not null	통합첨부파일번호
atch_file_sqnoPK	integer	not null	첨부 파일 순번
attachment_version_id	bigint
document_kind_raw	text
document_role	text
fetch_status	text

public.listing_base_info

상세 '기본정보' API 원문(JSONB).

1,053,700행

2.9GB

PK: ctrt_item_mng_no, snapshot_id

설명 2/3

ix_lbi_rprs

컬럼	타입	null	설명
ctrt_item_mng_noPK	text	not null	계약품목관리번호(등재 PK). 구형 002060827_1320000004 / 신형 R26TA… 두 형식
snapshot_idPK	bigint	not null	스냅샷(collection_run)
data	jsonb

public.listing_contract_terms

계약사항(계약번호+차수 단위): 계약일·기간·공급지역·특수조건 본문·담당부서.

33,999행

124.2MB

PK: ctrt_no, ctrt_chg_ord, snapshot_id

설명 7/12

컬럼	타입	null	설명
ctrt_noPK	text	not null	계약번호
ctrt_chg_ordPK	text	not null	계약 변경차수
snapshot_idPK	bigint	not null	스냅샷(collection_run)
ctrt_dt	text
ctrt_bgng_ymd	text		계약 시작일
ctrt_end_ymd	text		계약 종료일
sppl_rgn_nm	text
special_terms_text	text		계약 특수조건 본문
org_nm	text
pic_nm	text
pic_tel	text
raw	jsonb		API 응답 원문(JSONB)

public.listing_delivery_case

납품사례(어느 수요기관이 언제 샀는지). 1페이지(18건)만.

45,745행

8.8MB

PK: ctrt_item_mng_no, seq, snapshot_id

설명 4/5

ix_ldc_snapshot

컬럼	타입	null	설명
ctrt_item_mng_noPK	text	not null	계약품목관리번호(등재 PK). 구형 002060827_1320000004 / 신형 R26TA… 두 형식
seqPK	integer	not null
snapshot_idPK	bigint	not null	스냅샷(collection_run)
dminstt_nm	text		수요기관명
rgst_dt	text		등록일자

public.listing_detail_part

상세 기본정보의 배열 파트(옵션 dlCtrtOptnItmltL, 인증 dlCertInfoL, 녹색 dlGreenInfoL, 구매정보 dlBuyInfoL).

13,444,694행

19.7GB

PK: ctrt_item_mng_no, snapshot_id, part, seq

설명 2/5

컬럼	타입	null	설명
ctrt_item_mng_noPK	text	not null	계약품목관리번호(등재 PK). 구형 002060827_1320000004 / 신형 R26TA… 두 형식
snapshot_idPK	bigint	not null	스냅샷(collection_run)
partPK	text	not null
seqPK	integer	not null
data	jsonb

public.listing_image

등재 이미지 URL(목록 썸네일, 상세 원본).

3,427,024행

839.7MB

PK: ctrt_item_mng_no, seq, snapshot_id

설명 3/5

컬럼	타입	null	설명
ctrt_item_mng_noPK	text	not null	계약품목관리번호(등재 PK). 구형 002060827_1320000004 / 신형 R26TA… 두 형식
seqPK	integer	not null
snapshot_idPK	bigint	not null	스냅샷(collection_run)
url	text
kind	text		수집 종류(listing=목록, detail=상세)

public.listing_observation

수집 실행(스냅샷)별 관측 기록. 어떤 시점에 어떤 버전의 등재가 실제로 보였는지의 근거 — 수집률·시점 분석은 이 테이블 기준.

1,053,267행

211.3MB

PK: snapshot_id, ctrt_item_mng_no

설명 3/6

ix_listing_observation_listing

컬럼	타입	null	설명
snapshot_idPK	bigint	not null	스냅샷(collection_run)
ctrt_item_mng_noPK	text	not null	계약품목관리번호(등재 PK). 구형 002060827_1320000004 / 신형 R26TA… 두 형식
listing_version_id	bigint		그 스냅샷에서 관측된 등재 버전 → listing_version.version_id
observed_at	timestamp with time zone	not null
raw_ref	text
category_memberships	jsonb

public.listing_source

등재의 출처별 현재 상태(shop=종합쇼핑몰, digital=디지털서비스몰). 어느 몰에서 보이는지의 권위 테이블 — 분석 시 출처 필터는 여기 기준.

1,053,261행

243.5MB

PK: source_system, ctrt_item_mng_no

설명 4/8

ix_listing_source_seen

컬럼	타입	null	설명
source_systemPK	text	not null	출처: shop(종합쇼핑몰) / digital(디지털서비스몰)
ctrt_item_mng_noPK	text	not null	계약품목관리번호(등재 PK). 구형 002060827_1320000004 / 신형 R26TA… 두 형식
source_detail_url	text
first_seen_snapshot	bigint	not null
last_seen_snapshot	bigint	not null
last_verified_full_snapshot	bigint		마지막으로 전체-목록 수집에 이 등재가 확인된 스냅샷
presence_status	text	not null	active / missing_candidate(최신 전체수집에서 미관측 후보, 자동 삭제 아님)
consecutive_missing_count	integer	not null

public.listing_version

등재의 버전 이력. 추적 필드 해시가 바뀔 때만 새 행. 단가·할인·계약기간·인증·정책·판매량지표·이미지·원문(raw JSONB).

1,052,892행

6.0GB

PK: version_id

설명 22/57

ix_listing_version_no · ix_lv_apml_gin · ix_lv_ctrtty · ix_lv_devy · ix_lv_ntsl_desc · ix_lv_revw_desc · ix_lv_rgn · ix_lv_snym_trgm · ix_lv_uprc

컬럼	타입	null	설명
version_idPK	bigint	not null
ctrt_item_mng_no	text	not null	계약품목관리번호(등재 PK). 구형 002060827_1320000004 / 신형 R26TA… 두 형식
valid_from_snapshot	bigint	not null
valid_to_snapshot	bigint
content_hash	text	not null	추적 필드 해시
ctrt_uprc	numeric		계약단가(원)
srch_uprc	numeric		검색용 단가
dscnt_aplcn_uprc	numeric		할인 적용 단가
evnt_dscnt_rate	numeric		행사 할인율
evnt_bgng_ymd	text
evnt_end_ymd	text
ctrt_bgng_ymd	text		계약 시작일
ctrt_end_ymd	text		계약 종료일
ctrt_ymd	text		계약일시
ctrt_qty	numeric
ctrt_unt_val	text
ctrt_cncltn_yn	text
last_ctrt_yn	text
mas_ctrt_yn	text		다수공급자계약 여부
mas_compe_yn	text		2단계경쟁 여부
onc_max_dlreq_amt	numeric		1회 최대 납품요구금액
min_ordr_qty	numeric
devy_cndt_cd	text
devy_cndt_nm	text
dlvgds_term_nody	integer
sppl_rgn_no	text
sppl_rgn_nm	text
apml_no	text
apml_nm	text		인증·정책 표시(사회적가치실현기업, 우수조달물품 등, 콤마 구분)
item_cert	text
ftal_prchs_trgt_cert	text
sment_btwn_cmpet_prd_yn	text		중소기업자간경쟁제품 여부
exc_prod_yn	text		우수제품 여부
bsam_cmpt_prod_yn	text
ndfm_rgst_trgt_yn	text
ai_gds_yn	text
ntsl_qnty	numeric		판매량 지표
ntsl_qnty1	numeric
ntsl_qnty2	numeric
ntsl_qnty3	numeric
ntsl_qnty4	numeric
sppl_revw_cnt	integer		납품사례 수
grde	numeric
pdct_eval_cnt	integer
img_src	text		썸네일 이미지 URL
s_img_src	text
pdct_atrb_cd_dtl	text
snym_nm	text
raw	jsonb		API 응답 원문(JSONB)
raw_ref	text
data_source	text	not null
endpoint_version	text
disclosure_default	text	not null
created_at	timestamp with time zone
ctlg_ctrt_yn	text		카탈로그 계약 여부(Y=수요기관 협상으로 실제 가격 결정)
price_kind	text		가격 성격: registered_unit(등재 단가) / catalog_reference(카탈로그 계약 참고가 — 실제 구매가 아님)
observed_at	timestamp with time zone	not null	이 버전을 관측한 시각

public.shop_category

쇼핑몰 카테고리 트리(level 1 몰, 2 대분류, 3 중분류). 물품몰 루트는 00441.

207행

64KB

PK: shop_cgry_no

설명 3/7

ix_shop_cate_up

컬럼	타입	null	설명
shop_cgry_noPK	text	not null
level	integer		카테고리 깊이(1=몰,2=대분류,3=중분류)
up_shop_cgry_no	text		상위 카테고리 코드
cgry_nm	text		카테고리명
mall_se_cd	text
first_seen	bigint
last_seen	bigint

public.source_category

출처별 카테고리 트리. shop_category 백필 + 디지털몰 카테고리.

241행

72KB

PK: source_system, category_code

설명 2/8

컬럼	타입	null	설명
source_systemPK	text	not null
category_codePK	text	not null
parent_category_code	text
mall_code	text		몰 구분 코드(디지털몰 5개 영역 식별)
level	integer		카테고리 깊이(1=몰,2=대분류,3=중분류)
name	text
first_seen_snapshot	bigint
last_seen_snapshot	bigint

public.throttle_log

적응형 속도조절 로그 — 큐별 응답시간(p50/p95) 기반 배속 결정 기록

170행

72KB

PK: id

설명 8/10

ix_throttle_log_ts

컬럼	타입	null	설명
idPK	bigint	not null
ts	timestamp with time zone		호출 시각
pid	integer		수집 프로세스 ID
queue	text		큐 이름(listing/detail/attach)
p50_ms	numeric		최근 p50 응답(ms)
p95_ms	numeric		최근 p95 응답(ms)
baseline_p95_ms	numeric		기준 p95(ms)
multiplier	numeric		적용 배속율
reason	text		조절 사유
source_system	text

public.vendor

계약업체(업체 통합그룹번호 기준). 사업자번호·기업구분·본사 소재지.

13,728행

6.5MB

PK: ctent_unty_grp_no

설명 6/10

ix_vendor_bzmn_trgm · ix_vendor_entform · ix_vendor_name_trgm

컬럼	타입	null	설명
ctent_unty_grp_noPK	text	not null	업체 통합그룹번호(vendor PK)
bzmn_reg_no	text		사업자등록번호
name	text
ent_form_se_cd	text		기업구분코드(기170003 중소 등)
ent_form_se_nm	text		기업구분(중소/중견/대기업 등)
hdofc_lctn_cd	text
hdofc_lctn_nm	text		본점 소재지
addr	text		주소
first_seen	bigint
last_seen	bigint

public.vendor_contact

판매자 정보(대표자·이메일·전화·주소·담당자). 나라장터 공개 정보.

22,648행

11.5MB

PK: ctent_unty_grp_no, snapshot_id

설명 4/9

컬럼	타입	null	설명
ctent_unty_grp_noPK	text	not null	업체 통합그룹번호(vendor PK)
snapshot_idPK	bigint	not null	스냅샷(collection_run)
rprsv_nm	text
email	text
tel	text
addr	text		주소
pic_nm	text
pic_tel	text
raw	jsonb		API 응답 원문(JSONB)