ㄷㄷ

Tables (22)

data_source

  • id — BIGINT — Primary key — NOT NULL — 출처ID
  • code — VARCHAR(50) — NOT NULL — 출처코드(MFDS_INGR_API/MFDS_RSTRC_API/EU_COSING/CN_IECIC)
  • jurisdiction — VARCHAR(10) — Foreign key → jurisdiction.code — NOT NULL — 대상관할(다국가 출처는 INTL)
  • name — VARCHAR(200) — NOT NULL — 출처명
  • data_kind — VARCHAR(20) — NOT NULL — 데이터종류(INGREDIENT/REGULATION)
  • source_type — VARCHAR(20) — NOT NULL — 수집방식(API/CRAWL/PDF/FILE/MANUAL)
  • base_url — VARCHAR(500) — 수집URL
  • is_official — BOOLEAN — NOT NULL — 해당국 공식출처 여부
  • priority — SMALLINT — NOT NULL — 우선순위(공홈100/타기관정리50/내부30)
  • collector_key — VARCHAR(50) — NOT NULL — 수집기 구현키
  • parser_key — VARCHAR(50) — 조건 파서 구현키(국가별 LIMIT_COND 양식 상이)
  • page_size — SMALLINT — 페이지 크기(식약처 상한 500)
  • schedule_cron — VARCHAR(50) — 수집주기
  • active — BOOLEAN — NOT NULL — 사용여부

function_code

  • code — VARCHAR(50) — Primary key — NOT NULL — 기능·용도코드(PRESERVATIVE/UV_FILTER/COLORANT/FRAGRANCE 등)
  • name — VARCHAR(100) — NOT NULL — 기능명
  • description — VARCHAR(500) — 설명

ingredient

  • id — BIGINT — Primary key — NOT NULL — 내부ID
  • ingredient_code — VARCHAR(20) — NOT NULL — 공개 원료코드(ING-0000001, 불변·재사용금지)
  • inci_norm — VARCHAR(500) — 정체성 기준 INCI(정규화, 없으면 NULL)
  • display_name — VARCHAR(500) — NOT NULL — 대표표시명(캐시)
  • origin_definition — TEXT — 기원 및 정의(식물 부위·가공법, 판정 근거)
  • origin_note — TEXT — 출처 주석(식약처 ※ 이하)
  • status — VARCHAR(20) — NOT NULL — 상태(ACTIVE/MERGED/RETIRED)
  • merged_into_id — BIGINT — Foreign key → ingredient.id — 병합대상ID(중복 판명 시)
  • created_at — DATETIME — NOT NULL — 생성일시
  • updated_at — DATETIME — 수정일시

ingredient_code

  • id — BIGINT — Primary key — NOT NULL — ID
  • ingredient_id — BIGINT — Foreign key → ingredient.id — NOT NULL — 원료ID
  • code_type — VARCHAR(20) — NOT NULL — 코드종류(CAS/EC/CI/UNII)
  • code_value — VARCHAR(50) — NOT NULL — 코드값(정규화 후)
  • code_raw — VARCHAR(100) — 원문(12/5/85 등 비정상값 보존)
  • qualifier — VARCHAR(50) — 한정어(L-/DL-/generic/hydrate)
  • is_valid — BOOLEAN — NOT NULL — 체크디지트 검증 통과 여부
  • data_source_id — BIGINT — Foreign key → data_source.id — NOT NULL — 출처ID
  • match_method — VARCHAR(20) — 연결방법(SOURCE_ROW/CAS_EXACT/NAME_EXACT/MANUAL)
  • verified — BOOLEAN — NOT NULL — 검수여부
  • verified_by — BIGINT — 검수자ID
  • verified_at — DATETIME — 검수일시

ingredient_function

  • ingredient_id — BIGINT — Foreign key → ingredient.id — NOT NULL — 원료ID
  • function_code — VARCHAR(50) — Foreign key → function_code.code — NOT NULL — 기능코드(PRESERVATIVE 등)
  • data_source_id — BIGINT — Foreign key → data_source.id — NOT NULL — 출처ID(식약처 미제공 → CosIng 이후)

ingredient_name

  • id — BIGINT — Primary key — NOT NULL — ID
  • ingredient_id — BIGINT — Foreign key → ingredient.id — NOT NULL — 원료ID
  • jurisdiction — VARCHAR(10) — Foreign key → jurisdiction.code — NOT NULL — 관할(INTL=국제공통)
  • lang — VARCHAR(10) — NOT NULL — 언어(BCP47: ko/en/zh-Hans/zh-Hant/ja/th)
  • name_type — VARCHAR(20) — NOT NULL — 유형(STANDARD/INCI/INCI_ALT/CI/SYNONYM)
  • name — VARCHAR(500) — NOT NULL — 명칭 원문
  • name_norm — VARCHAR(500) — NOT NULL — 검색용 정규화명(공백·구표기 통일)
  • data_source_id — BIGINT — Foreign key → data_source.id — NOT NULL — 출처ID
  • verified — BOOLEAN — NOT NULL — 검수여부
  • verified_by — BIGINT — 검수자ID
  • verified_at — DATETIME — 검수일시

ingredient_source_link

  • source_record_id — BIGINT — Foreign key → source_record.id — NOT NULL — 원본행ID
  • ingredient_id — BIGINT — Foreign key → ingredient.id — 연결된 원료ID(매칭 실패 시 NULL)
  • match_method — VARCHAR(20) — NOT NULL — 방법(NAME_EXACT/CAS_EXACT/SYNONYM/MANUAL/UNMATCHED)
  • match_status — VARCHAR(20) — NOT NULL — 상태(AUTO/VERIFIED/PENDING/REJECTED)

jurisdiction

  • code — VARCHAR(10) — Primary key — NOT NULL — 관할코드(KR/EU/CN/JP/US/TW/ASEAN/BR/AR/CA/TH 등)
  • name — VARCHAR(100) — NOT NULL — 관할명
  • parent_code — VARCHAR(10) — Foreign key → jurisdiction.code — 상위관할(TH→ASEAN)
  • judgeable — BOOLEAN — NOT NULL — 판정 대상 여부(커버리지 부족국은 FALSE)
  • coverage_note — VARCHAR(300) — 커버리지 메모(예: 식약처 385건, 색소·자외선차단제 위주)

jurisdiction_alias

  • alias — VARCHAR(50) — Primary key — NOT NULL — 출처 원문 표기(EU/유럽/아세안/ASEAN)
  • jurisdiction — VARCHAR(10) — Foreign key → jurisdiction.code — NOT NULL — 정규 관할코드

jurisdiction_regime_rule

  • id — BIGINT — Primary key — NOT NULL — 규칙ID
  • jurisdiction — VARCHAR(10) — Foreign key → jurisdiction.code — NOT NULL — 관할
  • use_purpose — VARCHAR(50) — Foreign key → function_code.code — 적용 용도(NULL=기본 규칙)
  • regime — VARCHAR(20) — NOT NULL — 방식(NEGATIVE/POSITIVE)
  • required_list_id — BIGINT — Foreign key → regulation_list.id — POSITIVE일 때 등재 필요한 목록
  • effective_from — DATE — 시행일
  • effective_to — DATE — 종료일(NULL=현행)
  • legal_basis — VARCHAR(300) — 법적근거

record_change

  • id — BIGINT — Primary key — NOT NULL — 변경ID
  • snapshot_id — BIGINT — Foreign key → source_snapshot.id — NOT NULL — 발견 스냅샷ID
  • record_type — VARCHAR(20) — NOT NULL — 대상(SOURCE_RECORD/REGULATION_ENTRY/INGREDIENT)
  • record_id — BIGINT — NOT NULL — 대상ID
  • change_type — VARCHAR(20) — NOT NULL — 유형(ADDED/UPDATED/REMOVED)
  • field — VARCHAR(50) — 필드
  • old_value — TEXT — 이전값
  • new_value — TEXT — 새값
  • changed_at — DATETIME — NOT NULL — 발견일시

regulation_condition

  • id — BIGINT — Primary key — NOT NULL — 조건ID
  • entry_id — BIGINT — Foreign key → regulation_entry.id — NOT NULL — 규제항목ID
  • seq — SMALLINT — NOT NULL — 한 항목 내 조건 순번((a)(b)(c) 분기)
  • raw_text — TEXT — 해당 조건 원문 블록(파싱 전에도 근거 표시 가능)
  • parse_status — VARCHAR(20) — NOT NULL — 파싱상태(RAW/PARSED/REVIEW/FAILED)
  • product_scope — VARCHAR(30) — 제품유형 표준코드(LEAVE_ON/RINSE_OFF/ORAL/HAIR 등)
  • product_scope_raw — VARCHAR(500) — 제품유형 원문
  • use_purpose — VARCHAR(50) — Foreign key → function_code.code — 적용 용도(NULL=모든 용도)
  • body_part — VARCHAR(100) — 사용부위
  • max_conc — DECIMAL(12, 6) — 최대농도
  • conc_unit — VARCHAR(10) — 단위(%/ppm/g_per_100g)
  • max_inclusive — BOOLEAN — NOT NULL — 경계 포함 여부(이하 TRUE / 미만 FALSE)
  • calc_basis — VARCHAR(200) — 환산기준(산으로서, H2O2로서 등)
  • min_age — SMALLINT — 최소연령
  • ph_min — DECIMAL(4, 2) — pH 하한
  • ph_max — DECIMAL(4, 2) — pH 상한
  • professional_only — BOOLEAN — 전문가용 한정
  • warning_text — TEXT — 경고문구
  • other_text — TEXT — 기타조건 원문

regulation_cross_check

  • id — BIGINT — Primary key — NOT NULL — 대조ID
  • ingredient_id — BIGINT — Foreign key → ingredient.id — NOT NULL — 원료ID
  • jurisdiction — VARCHAR(10) — Foreign key → jurisdiction.code — NOT NULL — 관할
  • primary_entry_id — BIGINT — Foreign key → regulation_entry.id — 우선출처 항목(공홈)
  • secondary_entry_id — BIGINT — Foreign key → regulation_entry.id — 대조출처 항목(식약처 정리본)
  • result — VARCHAR(20) — NOT NULL — 결과(AGREE/CONFLICT/ONLY_PRIMARY/ONLY_SECONDARY)
  • diff — JSON — 차이 내역(상태·농도 등)
  • review_status — VARCHAR(20) — NOT NULL — 검수(NOT_NEEDED/PENDING/RESOLVED)
  • reviewed_by — BIGINT — 검수자ID
  • reviewed_at — DATETIME — 검수일시
  • checked_at — DATETIME — NOT NULL — 대조일시

regulation_entry

  • id — BIGINT — Primary key — NOT NULL — 규제항목ID
  • data_source_id — BIGINT — Foreign key → data_source.id — NOT NULL — 출처ID
  • snapshot_id — BIGINT — Foreign key → source_snapshot.id — NOT NULL — 수집 스냅샷ID
  • source_record_id — BIGINT — Foreign key → source_record.id — 원본행ID
  • jurisdiction — VARCHAR(10) — Foreign key → jurisdiction.code — NOT NULL — 적용관할(alias 정규화 후)
  • regulation_list_id — BIGINT — Foreign key → regulation_list.id — NOT NULL — 소속 규제목록ID
  • logical_key — VARCHAR(255) — NOT NULL — 버전관통 키(관할+정규화 고시명+목록, 조건 제외)
  • external_ref — VARCHAR(100) — 출처 항목번호(Annex III/12, REGL_CODE 등)
  • substance_name — VARCHAR(1000) — NOT NULL — 고시 원문 명칭(NOTICE_INGR_NAME)
  • regulate_type_raw — VARCHAR(20) — 출처 원문 구분(금지/한도/한도금지)
  • is_group — BOOLEAN — NOT NULL — 그룹항목(염·에스터 등)
  • designation_type — VARCHAR(30) — NOT NULL — 지정방식(SUBSTANCE/GROUP/BOTANICAL_PART/CLASSIFICATION_REF)
  • provision_raw — TEXT — 단서조항 원문(PROVIS_ATRCL)
  • raw_text — TEXT — 조건 원문 전체(LIMIT_COND)
  • published_at — DATE — 공포일
  • effective_from — DATE — 시행일
  • effective_to — DATE — 종료일(NULL=현행)

regulation_entry_code

  • code_type — VARCHAR(20) — Primary key — NOT NULL — 코드종류(CAS/EC)
  • code_value — VARCHAR(50) — Primary key — NOT NULL — 코드값
  • entry_id — BIGINT — Foreign key → regulation_entry.id — NOT NULL — 규제항목ID
  • qualifier — VARCHAR(50) — 한정어
  • extracted — BOOLEAN — NOT NULL — 본문에서 추출한 값인지(별도 필드 아님)

regulation_entry_name

  • name_type — VARCHAR(20) — Primary key — NOT NULL — 유형(NOTICE/CHEMICAL/INN/INCI/LOCAL)
  • lang — VARCHAR(10) — Primary key — NOT NULL — 언어(BCP47)
  • name_norm — VARCHAR(500) — Primary key — NOT NULL — 매칭용 정규화명
  • entry_id — BIGINT — Foreign key → regulation_entry.id — NOT NULL — 규제항목ID
  • name — VARCHAR(1000) — NOT NULL — 명칭 원문

regulation_entry_scope

  • entry_id — BIGINT — Foreign key → regulation_entry.id — NOT NULL — 규제항목ID
  • jurisdiction — VARCHAR(10) — Foreign key → jurisdiction.code — NOT NULL — 하위관할(TH/MY 등)
  • applies — BOOLEAN — NOT NULL — 적용여부(FALSE=예외국)
  • effective_from — DATE — 하위관할별 시행일

regulation_list

  • id — BIGINT — Primary key — NOT NULL — 규제목록ID
  • jurisdiction — VARCHAR(10) — Foreign key → jurisdiction.code — NOT NULL — 관할
  • code — VARCHAR(50) — NOT NULL — 목록코드(MFDS_EU_RESTRICTED/EU_ANNEX_V/CN_IECIC)
  • name — VARCHAR(200) — NOT NULL — 목록명
  • list_kind — VARCHAR(20) — NOT NULL — 성격(PROHIBITED/RESTRICTED/PERMITTED)
  • category — VARCHAR(50) — Foreign key → function_code.code — 대상 용도(function_code, NULL=전체)
  • data_source_id — BIGINT — Foreign key → data_source.id — NOT NULL — 이 목록을 제공한 출처
  • legal_basis — VARCHAR(300) — 법적근거(규정명·조항)

regulation_match

  • entry_id — BIGINT — Foreign key → regulation_entry.id — NOT NULL — 규제항목ID
  • ingredient_id — BIGINT — Foreign key → ingredient.id — NOT NULL — 원료ID
  • method — VARCHAR(20) — NOT NULL — 방법(SOURCE_PROVIDED/CAS_EXACT/NAME_EXACT/GROUP_RULE/FUZZY/MANUAL)
  • status — VARCHAR(20) — NOT NULL — 상태(AUTO/VERIFIED/PENDING/REJECTED)
  • strength — VARCHAR(10) — 매칭강도(STRONG/WEAK)
  • confidence — DECIMAL(4, 3) — 신뢰도
  • reviewed_by — BIGINT — 검수자ID
  • reviewed_at — DATETIME — 검수일시

review_queue

  • id — BIGINT — Primary key — NOT NULL — 검수ID
  • issue_type — VARCHAR(30) — NOT NULL — 유형(CAS_INVALID/NAME_UNMATCHED/COND_PARSE_FAILED/CROSS_CHECK_CONFLICT/GROUP_AMBIGUOUS)
  • target_type — VARCHAR(30) — NOT NULL — 대상(INGREDIENT/INGREDIENT_CODE/REGULATION_ENTRY/REGULATION_CONDITION)
  • target_id — BIGINT — NOT NULL — 대상ID
  • severity — VARCHAR(10) — NOT NULL — 심각도(HIGH/MID/LOW)
  • detail — TEXT — 내용
  • status — VARCHAR(20) — NOT NULL — 상태(OPEN/IN_PROGRESS/RESOLVED/IGNORED)
  • assigned_to — BIGINT — 담당자ID
  • resolved_by — BIGINT — 처리자ID
  • resolved_at — DATETIME — 처리일시
  • created_at — DATETIME — NOT NULL — 생성일시

source_record

  • id — BIGINT — Primary key — NOT NULL — ID
  • data_source_id — BIGINT — Foreign key → data_source.id — NOT NULL — 출처ID
  • record_kind — VARCHAR(20) — NOT NULL — 종류(INGREDIENT/REGULATION)
  • source_key — VARCHAR(500) — NOT NULL — 출처 내 식별값(식약처=표준명+국가, CosIng=ref no)
  • raw_payload — JSON — NOT NULL — 원본 행 그대로(재파싱 대비)
  • record_hash — VARCHAR(64) — NOT NULL — 원본해시(변경감지)
  • first_seen_snapshot_id — BIGINT — Foreign key → source_snapshot.id — NOT NULL — 최초 발견 스냅샷
  • last_seen_snapshot_id — BIGINT — Foreign key → source_snapshot.id — NOT NULL — 마지막 확인 스냅샷
  • removed_at — DATETIME — 원천에서 사라진 일시

source_snapshot

  • id — BIGINT — Primary key — NOT NULL — 스냅샷ID
  • data_source_id — BIGINT — Foreign key → data_source.id — NOT NULL — 출처ID
  • source_version — VARCHAR(50) — 원천버전(EU 2025/1175 등)
  • fetched_at — DATETIME — NOT NULL — 수집일시
  • content_hash — VARCHAR(64) — 원본해시(변경감지)
  • storage_path — VARCHAR(500) — 원본보관경로(raw/b/2026-09-23/*.json)
  • total_count — INT — 원천 전체건수(totalCount)
  • fetched_count — INT — 실제 수신건수
  • page_count — SMALLINT — 수집 페이지 수
  • status — VARCHAR(20) — NOT NULL — 상태(RUNNING/SUCCESS/FAILED/COUNT_MISMATCH)