팩 구조: 모든 팩에 공통인 파일 배치
예시 팩 내려받기(136 KB)예시: 한국석유공사_알뜰주유소 현황(15076635)
1 · manifest.json · 꾸러미 명세 · 무결성(봉인)
「내려받은 파일이 발행본 그대로인가?」
팩의 시작 파일(목차)입니다. 포함된 파일마다 역할 · 형식 · 크기 · SHA-256 지문을 기록합니다. 지문이 하나라도 다르면 변경된 파일입니다. 준비 상태(lifecycleStatus)도 여기에 기록됩니다.
{
"aird:lifecycleStatus": "ls:Quality-Ready",
"aird:describedVersion": "1.0.0",
"dct:modified": "2026-10-22",
"assets": [
{
"@type": "aird:Asset",
"role": "ar:data",
"href": "data/dataset-15076635.csv",
"mediaType": "iana:text/csv",
"spdx:checksum": {
"spdx:algorithm": "sha256",
"spdx:checksumValue": "48337a9baa145930…"
},
"size": 205600,
"datasetVersion": "1.0.0"
},
"… 외 8개 파일"
]
} 2 · metadata/metadata-1.0.0.json · 데이터 설명서
「무슨 데이터이고, 누가 냈고, 써도 되나?」
제목 · 설명 · 제공 기관 · 원천 주소 · 이용허락 · 개인정보 포함 여부를 국제 표준 어휘(DCAT)로 기록합니다. 사람과 프로그램이 모두 읽을 수 있는 구조입니다.
{
"dct:title": "한국석유공사_알뜰주유소 현황",
"dct:publisher": "한국석유공사",
"dcat:landingPage": "https://www.data.go.kr/data/15076635/fileData.do",
"dct:license": "이용허락범위 제한 없음",
"aird:containsPersonalData": false,
"dct:modified": "2026-02-09"
} 3 · schema/columns-1.0.0.json · 항목 정의서
「이 열은 무슨 뜻이고, 어떤 값이 들어 있나?」
열마다 의미 · 자료형 · 관측된 결측률 · 값의 분포를 기록합니다. AI가 열 이름으로 의미를 추측하지 않고 정의를 참조하도록 하는 파일입니다.
{
"@type": "csvw:Column",
"csvw:name": "셀프여부",
"csvw:datatype": "xsd:boolean",
"csvw:required": true,
"aird:columnIndex": 5,
"csvw:titles": {
"@value": "셀프여부",
"@language": "ko"
},
"dct:description": {
"@value": "주유소가 고객이 직접 주유하는 셀프 방식으로 운영되는지의 여부",
"@language": "ko"
},
"aird:descriptionKind": "http://vocab.datahub.kr/def/aird/description-kind/DEFINITION",
"aird:semanticType": "http://vocab.datahub.kr/def/aird/semantic-type/CODE",
"aird:observedDatatype": "문자형(VARCHAR)",
"aird:observedMaxLength": 1,
"aird:observedMissingRate": 0.0,
"aird:observedDistribution": "통제어휘 후보(2종)",
"skos:example": [
{
"@value": "Y",
"@language": "ko"
},
{
"@value": "N",
"@language": "ko"
}
],
"aird:codeListCandidate": true
} 4 · data/dataset-15076635.csv · 데이터(원본 + 정제)
「실제 값은? 무엇이 바뀌었나?」
원본 열은 그대로 유지하고, 정리한 값은 「정제_」로 시작하는 열에 추가합니다. 규칙으로 확정할 수 없는 값은 변경하지 않고 [E]를 표시하여 「확인 필요」로 구분합니다(이 데이터 43행). 동일한 내용의 Parquet 파일을 함께 제공합니다.
{
"columns": [
"상호",
"주소",
"정제_주소"
],
"rows": [
[
"도초농협주유소 화도지점",
"전남 신안군 도초면 서남문로 1311",
"전라남도 신안군 도초면 서남문로 1311"
],
[
"남신안농협주유소",
"전남 신안군 하의면 곰실길 11-33",
"전라남도 신안군 하의면 곰실길 11-33"
],
[
"서진도농협 조도지점주유소",
"전남 진도군 조도면 조도대로 419",
"전라남도 진도군 조도면 조도대로 419"
],
[
"북신안농협주유소",
"전남 신안군 증도면 증도길 389",
"[E]전남 신안군 증도면 증도길 389"
]
]
} 5 · gates/G1 · G2-1.0.0.json · 판정서
「정해진 기준을 통과했나?」
게이트(G1 등록 요건 · G2 품질 기준)마다 통과 여부 · 판정 대상 판 · 판정 시각 · 근거 기준을 기록합니다. 사이트는 판정서가 있는 단계만 인정합니다. 등록 요건(G1)과 품질 기준(G2) 판정서가 따로 있고, 미통과면 gateResult가 gr:FAIL입니다.
[
{
"gateType": "gt:G1",
"gateResult": "gr:PASS",
"aird:datasetVersion": "1.0.0",
"기준": "등록 요건: 발견 계층 필수 18개 기재 + 배포 digest"
},
{
"gateType": "gt:G2",
"gateResult": "gr:PASS",
"aird:datasetVersion": "1.0.0",
"기준": "G2 결과 = 진단리포트 qTier.qualityReadyEligible 그대로(판정은 진단리포트가 함)"
}
] 6 · diagnosis/report-1.0.0.json · 진단 기록
「어떤 점검을 거쳤나?」
형식 · 결측 · 중복 등 품질 차원별 진단 결과를 기계가 읽는 형태로 수록합니다. 판정의 근거 자료이며, 수치는 이 화면에 표시하지 않습니다.
7 · profiles/TP-KR-2026-1.0.json · 판정 기준표
「어떤 기준으로 판정했나?」
판정에 사용한 임계값 묶음(임계 프로파일)입니다. 기준표가 변경되면 동일한 데이터도 재판정합니다.
{
"profileId": "http://vocab.datahub.kr/def/aird/threshold-profile/operator/TP-KR-2026-1.0",
"version": "1.0",
"authority": "operator",
"status": "OFFICIAL"
} 8 · conversion-report.md · 변환 기록
「어떤 값을 어떤 규칙으로 옮겼나?」
원천 파일에서 팩을 생성한 과정의 단계 · 원값 · 변환값 · 적용 규칙을 표로 기록합니다.
| 단계 | 항목 | 출처 | 원값 | 변환값 | 규칙/기본값 | 경고 | |---|---|---|---|---|---|---| | 1단계 메타데이터 1차 입력 | dct:identifier | 데이터키 | 15076635 | 15076635 | 데이터키 그대로 | | | 1단계 메타데이터 1차 입력 | 헤더 탐지 | 데이터 파일 | CSV 구분자 ',' | 헤더 1행 · 일치율 1.0 | 정의서 항목명과 일치 비율이 가장 높은 행을 헤더로(CSV 구분자도 같은 방식으로 고름) | |
9 · context.jsonld · 용어 사전 연결
「AI가 용어를 어떻게 해석하나?」
팩 내 약어(ls:, gr: 등)를 표준 어휘 주소로 변환하는 대응표입니다. 다른 시스템에서도 동일한 의미로 해석할 수 있도록 합니다.
{
"aird": "http://vocab.datahub.kr/def/aird/",
"aird-dt": "http://vocab.datahub.kr/def/aird/dataset-type/",
"ls": "http://vocab.datahub.kr/def/aird/lifecycle-status/",
"qt": "http://vocab.datahub.kr/def/aird/quality-tier/",
"gr": "http://vocab.datahub.kr/def/aird/gate-result/",
"gt": "http://vocab.datahub.kr/def/aird/gate-type/"
} 10 · LICENSE.txt · 이용 조건
「어떤 조건으로 쓸 수 있나?」
원천의 이용허락 · 출처 표시 문구 · 문의처를 기록합니다. AI 학습 등 활용 범위도 이 조건을 따릅니다.
이용허락 — 한국석유공사_알뜰주유소 현황 (데이터별 품질개선 팩 1.0.0) 이용허락 유형: kr-license:KOGL-0 — 이용허락범위 제한 없음 이 팩은 공공데이터포털 원천 데이터(15076635, 제공기관 한국석유공사)의 정제본 · 메타데이터 · 진단 결과를 담는다. 원천의 이용허락 조건을 따르며, 원천 기관의 별도 고지가 있는 경우 그 고지가 우선한다.
준비 단계: 판정(게이트) 통과에 따른 단계
준비 단계는 데이터의 상태를 나타냅니다. 팩 manifest의 aird:lifecycleStatus에 이 값이 기록됩니다. AI Ready에 해당하는 단계는 품질 기준 충족과 목적 적합입니다.
- G1 전원시
ls:Raw필수 메타데이터 부족 · 사이트에 게시하지 않음 - G1 등록 요건 통과준비 중
ls:Discoverable필수 메타데이터 18개 · 파일 지문. 품질 판정 보류 또는 기준 미달 · 1,401종 - G2 품질 기준 통과품질 기준 충족
ls:Quality-Ready공식 판정(DM-2)으로 기준 등급 이상 · 371종 - G3 목적 적합 통과목적 적합
ls:Purpose-ReadyAI 용도로 구성하여 변환 · 판정 · 5종
AI Ready
G2를 통과하지 못한 경우 판정서(gates/G2)의 gateResult는 gr:FAIL이며, 품질 판정 보류인지 기준 미달인지는 진단 리포트의 진단 성숙도 · 평가 상태로 구분합니다. 기준 문서: AIRD 어휘 v0.10.7.
활용 사례 팩
활용 사례 보기 →에이전트는 get_pack의 purpose.status로 목적 판정 상태를 확인합니다. 활용 사례 팩 중 검증 완료는 5종입니다.