witan_ingredient

Tables (17)

amending_acts

  • id — BIGINT — Primary key — NOT NULL — PK - 자동 증가 번호
  • jurisdiction_id — BIGINT — Foreign key → jurisdictions.id — NOT NULL — 관할 - FK(jurisdictions)
  • act_code — VARCHAR(40) — NOT NULL — 규정 번호 - CosIng CSV Regulation 값 그대로 (예: (EU) 2026/78)
  • oj_url — TEXT — 관보 링크 - https://eur-lex.europa.eu/eli/reg/{연도}/{번호}/oj
  • applies_from — DATE — 적용일 - 관보에서 확인한 효력 발생일. 판정 기준일과 비교

function_codes

  • id — BIGINT — Primary key — NOT NULL — PK - 자동 증가 번호
  • code — VARCHAR(60) — NOT NULL — 기능 코드 - PRESERVATIVE, SKIN_CONDITIONING 등 (유일)
  • name_en — TEXT — NOT NULL — 기능명(영문) - CosIng 원문

ingredient_functions

  • id — BIGINT — Primary key — NOT NULL — PK - 자동 증가 번호
  • ingredient_id — BIGINT — Foreign key → ingredients.id — NOT NULL — 원료 - FK(ingredients)
  • function_code_id — BIGINT — Foreign key → function_codes.id — NOT NULL — 기능 - FK(function_codes)
  • source_record_id — BIGINT — Foreign key → source_records.id — NOT NULL — 원본 행 - FK(source_records). 이 기능을 가져온 곳

ingredient_identifiers

  • id — BIGINT — Primary key — NOT NULL — PK - 자동 증가 번호
  • ingredient_id — BIGINT — Foreign key → ingredients.id — NOT NULL — 원료 - FK(ingredients)
  • id_type — VARCHAR(20) — NOT NULL — 식별자 유형 - CAS, EC, COSING_SUBSTANCE_ID(CosIng 물질 ID)
  • value — VARCHAR(100) — NOT NULL — 식별자 값
  • checksum_ok — BOOLEAN — 체크섬 통과 여부 - CAS·EC 마지막 자리 검증. FALSE면 오타로 보고 대조에 사용 안 함
  • source_record_id — BIGINT — Foreign key → source_records.id — 원본 행 - FK(source_records). 이 값을 가져온 곳

ingredient_names

  • id — BIGINT — Primary key — NOT NULL — PK - 자동 증가 번호
  • ingredient_id — BIGINT — Foreign key → ingredients.id — NOT NULL — 원료 - FK(ingredients)
  • source_record_id — BIGINT — Foreign key → source_records.id — 원본 행 - FK(source_records). 이 이름을 가져온 곳
  • name — TEXT — NOT NULL — 이름 - 원문 표기
  • name_norm — TEXT — NOT NULL — 정규화 이름 - 검색·대조용
  • name_type — VARCHAR(20) — NOT NULL — 이름 유형 - KOR_STD(한글 표준명), KOR_SYNONYM(한글 이명), INCI, EU_GLOSSARY(EU 용어집명), US_INCI(미국명), INN(국제일반명), PH_EUR(유럽약전명), CHEMI…

ingredient_regulation_links

  • id — BIGINT — Primary key — NOT NULL — PK - 자동 증가 번호
  • ingredient_id — BIGINT — Foreign key → ingredients.id — NOT NULL — 원료 - FK(ingredients)
  • regulation_entry_key — VARCHAR(80) — NOT NULL — 규제 항목 키 - regulation_entries.entry_key 값 (FK 아님: 수집이 바뀌어도 연결 유지)
  • matched_key — VARCHAR(20) — NOT NULL — 걸린 키 - INCI, NAME, CAS. CAS만 걸리면 '검토 필요' 판정
  • match_method — VARCHAR(20) — NOT NULL — 매칭 방식 - EXACT, NORMALIZED, VIA_MFDS(식약처 사용제한 경유), VIA_COSING_INV(CosIng 인벤토리 cosmeticRestriction 경유)
  • status — VARCHAR(20) — NOT NULL — 상태 - AUTO, PENDING, CONFIRMED, REJECTED

ingredient_source_links

  • id — BIGINT — Primary key — NOT NULL — PK - 자동 증가 번호
  • ingredient_id — BIGINT — Foreign key → ingredients.id — NOT NULL — 원료 - FK(ingredients)
  • source_record_id — BIGINT — Foreign key → source_records.id — NOT NULL — 원본 행 - FK(source_records)
  • match_key — VARCHAR(20) — NOT NULL — 매칭 키 - BASE(원료성분정보 자체), KOR_NAME(사용제한 원료정보 한글명), INCI, EU_GLOSSARY, US_INCI(CosIng 인벤토리)
  • candidate_count — SMALLINT — NOT NULL — 후보 수 - 같은 키로 걸린 원료 수. 2 이상이면 AUTO 불가 (예: CAMELLIA SINENSIS LEAF → 녹차·홍차잎)
  • status — VARCHAR(20) — NOT NULL — 상태 - AUTO(자동 확정), PENDING(검토 대기), CONFIRMED(사람 확정), REJECTED(기각)

ingredients

  • id — BIGINT — Primary key — NOT NULL — PK - 자동 증가 번호
  • code — VARCHAR(20) — NOT NULL — 원료 코드 - ING-0000001 형식 표시용 (유일)
  • kor_std_name — TEXT — NOT NULL — 한글 표준명 - 식약처 원료성분정보 기준. 원료 동일성 기준 (유일)
  • inci_name — TEXT — 대표 INCI명 - 식약처 원료성분정보 영문명. 중복 허용 (녹차·홍차잎 모두 Camellia Sinensis Leaf)
  • origin_desc — TEXT — 기원 및 정의 - 식약처 원료성분정보
  • created_at — TIMESTAMPTZ — NOT NULL — 생성일시

jurisdictions

  • id — BIGINT — Primary key — NOT NULL — PK - 자동 증가 번호
  • code — VARCHAR(10) — NOT NULL — 관할 코드 - KR, EU, US, US-CA (유일)
  • name_ko — TEXT — NOT NULL — 관할명 - 한국어

regulation_conditions

  • id — BIGINT — Primary key — NOT NULL — PK - 자동 증가 번호
  • regulation_entry_id — BIGINT — Foreign key → regulation_entries.id — NOT NULL — 규제 항목 - FK(regulation_entries)
  • clause — VARCHAR(10) — 조건 기호 - (a), (b) ... 제품유형과 최대 농도를 짝짓는 기호
  • product_type — TEXT — 제품 유형·사용 부위 - CosIng 'Product Type, body parts' 원문
  • max_value — NUMERIC(12,6) — 최대 농도 값 - 숫자로 변환한 값
  • max_unit — VARCHAR(20) — 단위 - %, ppm, mg/kg
  • max_raw — TEXT — 최대 농도 원문 - CosIng 최대 농도 또는 식약처 조건 원문(LIMIT_COND)
  • other_text — TEXT — 기타 조건 원문 - CosIng 'Other'(표시 의무·경과 기간 문장 포함) 또는 식약처 단서조항
  • warning_text — TEXT — 경고문·사용 조건 원문 - CosIng 'Wording of conditions of use and warnings'

regulation_entries

  • id — BIGINT — Primary key — NOT NULL — PK - 자동 증가 번호
  • regulation_list_id — BIGINT — Foreign key → regulation_lists.id — NOT NULL — 규제 목록 - FK(regulation_lists)
  • source_snapshot_id — BIGINT — Foreign key → source_snapshots.id — NOT NULL — 수집 이력 - FK(source_snapshots). 어느 수집본의 항목인지
  • source_record_id — BIGINT — Foreign key → source_records.id — 원본 행 - FK(source_records)
  • amending_act_id — BIGINT — Foreign key → amending_acts.id — 개정 규정 - FK(amending_acts). 이 항목을 추가·최종 수정한 규정
  • entry_key — VARCHAR(80) — NOT NULL — 항목 키 - 목록코드|항목번호|행순번 (예: EU_ANNEX_II|1765|1). 수집이 바뀌어도 같은 항목은 같은 값
  • ref_no — VARCHAR(20) — 항목 번호 - CosIng Annex 참조번호 (1765, 2a). 식약처 행은 비움
  • row_seq — SMALLINT — NOT NULL — 행 순번 - 같은 항목 번호에 행이 여러 개일 때
  • substance_name — TEXT — NOT NULL — 물질명 - CosIng Chemical name / INN 또는 식약처 고시명 원문
  • source_updated_on — DATE — 항목 갱신일 - CosIng 항목별 Update Date
  • cmr — TEXT — CMR 분류 - 발암·변이원·생식독성 분류 원문
  • is_active — BOOLEAN — NOT NULL — 현행 여부 - Moved or deleted 행은 FALSE
  • is_secondary — BOOLEAN — NOT NULL — 2차 출처 여부 - 식약처가 옮겨 적은 해외 규제면 TRUE (판정에 직접 사용 안 함)

regulation_entry_identifiers

  • id — BIGINT — Primary key — NOT NULL — PK - 자동 증가 번호
  • regulation_entry_id — BIGINT — Foreign key → regulation_entries.id — NOT NULL — 규제 항목 - FK(regulation_entries)
  • id_type — VARCHAR(20) — NOT NULL — 식별자 유형 - CAS, EC, INCI, GLOSSARY(EU 용어집명), CI(색소 번호), NAME, IUPAC, IDENTIFIED_INCI(CosIng 성분 예시)
  • value — TEXT — NOT NULL — 값 - 원문
  • value_norm — TEXT — NOT NULL — 정규화 값 - 원료 쪽과 대조용
  • position — SMALLINT — 순서 - 여러 값이 나열될 때 용어집명과 CAS를 짝짓는 위치
  • checksum_ok — BOOLEAN — 체크섬 통과 여부 - CAS·EC일 때

regulation_entry_xrefs

  • id — BIGINT — Primary key — NOT NULL — PK - 자동 증가 번호
  • regulation_entry_id — BIGINT — Foreign key → regulation_entries.id — NOT NULL — 2차 출처 항목 - FK(regulation_entries). 식약처가 옮겨 적은 해외 규제 행
  • primary_entry_key — VARCHAR(80) — NOT NULL — 1차 출처 항목 키 - regulation_entries.entry_key 값 (FK 아님: 수집이 바뀌어도 연결 유지)
  • match_method — VARCHAR(20) — NOT NULL — 매칭 방식 - EXACT, NORMALIZED(정규화 후 이름 일치), CAS, INCI, MANUAL
  • status — VARCHAR(20) — NOT NULL — 상태 - AUTO, PENDING, CONFIRMED, REJECTED

regulation_lists

  • id — BIGINT — Primary key — NOT NULL — PK - 자동 증가 번호
  • jurisdiction_id — BIGINT — Foreign key → jurisdictions.id — NOT NULL — 관할 - FK(jurisdictions)
  • code — VARCHAR(40) — NOT NULL — 목록 코드 - EU_ANNEX_II~VI, KR_PROHIBITED, KR_RESTRICTED. 식약처 해외 규제는 적재 시 MFDS_{국가}_{유형}으로 생성 (유일)
  • name — TEXT — NOT NULL — 목록명
  • list_type — VARCHAR(20) — NOT NULL — 목록 성격 - PROHIBITED(금지), RESTRICTED(조건부 허용), POSITIVE(허용 목록: 없으면 사용 불가)
  • function_scope — VARCHAR(20) — 적용 기능 - POSITIVE일 때 어떤 목적에 적용되는지 (COLORANT 색소, PRESERVATIVE 보존제, UV_FILTER 자외선차단)
  • legal_basis — TEXT — 근거 법령 - 예: Regulation (EC) No 1223/2009 Annex II

source_records

  • id — BIGINT — Primary key — NOT NULL — PK - 자동 증가 번호
  • source_snapshot_id — BIGINT — Foreign key → source_snapshots.id — NOT NULL — 수집 이력 - FK(source_snapshots)
  • external_key — TEXT — 원천 키 - 출처 안에서 행을 구분하는 값 (한글명, CosIng reference 등)
  • raw — JSONB — NOT NULL — 원본 데이터 - 받은 행 그대로 (JSON)
  • is_active — BOOLEAN — NOT NULL — 현행 여부 - CosIng status가 Active가 아니면 FALSE

source_snapshots

  • id — BIGINT — Primary key — NOT NULL — PK - 자동 증가 번호
  • source_id — BIGINT — Foreign key → sources.id — NOT NULL — 출처 - FK(sources)
  • target — VARCHAR(40) — 수집 대상 - ingd, rstrc, Annex II, inventory 등
  • collected_at — TIMESTAMPTZ — NOT NULL — 수집일시 - 우리가 받은 시각
  • source_updated_on — DATE — 원천 갱신일 - 출처가 밝힌 최종 갱신일 (CSV 머리글 Last update 등)
  • total_count — INT — 원천 건수 - 출처가 밝힌 전체 건수 (totalCount 등)
  • row_count — INT — 수신 건수 - 실제로 받은 건수. total_count와 다르면 누락

sources

  • id — BIGINT — Primary key — NOT NULL — PK - 자동 증가 번호
  • code — VARCHAR(40) — NOT NULL — 출처 코드 - MFDS_INGD, MFDS_RSTRC, COSING_INV, COSING_ANNEX, EURLEX, MSDS (유일)
  • name — TEXT — NOT NULL — 출처명
  • jurisdiction_id — BIGINT — Foreign key → jurisdictions.id — 관할 - FK(jurisdictions). 공급사 자료 등은 비움
  • is_legal — BOOLEAN — NOT NULL — 법적 효력 여부 - EUR-Lex 관보만 TRUE. CosIng·식약처 API는 정보 제공용
  • is_primary — BOOLEAN — NOT NULL — 1차 출처 여부 - 모두 TRUE. 식약처가 옮긴 해외 규제는 항목 단위로 regulation_entries.is_secondary 표시
  • url — TEXT — 출처 주소