About this site 한국어

Unofficial explanatory translation of the Korean AI-Ready Data (AIRD) draft standard. The Korean text prevails.

Reference

Manifest example

Type · ReferenceReading time · about 2 minAll readersAgent and AI developers (data users)

ContentsContents
  1. Properties read for each judgment
  2. Discovery layer — a manifest that has completed stage 1
  3. Understanding layer — what stage 2 adds
  4. One verified fact
  5. The whole pack as one RDF graph

This is the complete manifest of the example data (20 business registration records). It shows how discovery-layer and understanding-layer properties are written in JSON-LD.

The discovery layer reproduces the sample entry from the example file (meta.json). Only the identifiers were replaced with this site’s example identifiers. With a single manifest, an agent starts the four judgments (fitness · reliability · joinability · usability). How to assemble and distribute a pack is described in Packaging and distribution.

Properties read for each judgment

JudgmentProperties read in this manifest
Fitnessdct:description · csvw:tableSchema · dct:type
Reliabilityaird:lifecycleStatus · dct:accrualPeriodicity · spdx:checksum
Joinabilitydct:identifier · csvw:tableSchema
Usabilitydct:license · dct:rights · dct:accessRights

Discovery layer — a manifest that has completed stage 1

All 23 required discovery-layer metadata elements and the column schema (csvw:tableSchema) are filled in. The checksum is the actual SHA-256 of example.csv. This example uses a simplified notation that merges the manifest and the dataset into one node. The standard gives the dataset (the resource) and the manifest (the description document) separate identifiers; the separated structure appears in the manifest excerpt in Packaging and distribution — files needed for each readiness state.

{
  "@context": [
    "https://datahub.kr/ns/aird-context-3.0.jsonld",
    {
      "dct": "http://purl.org/dc/terms/",
      "dcat": "http://www.w3.org/ns/dcat#",
      "aird": "http://vocab.datahub.kr/def/aird/",
      "aird-ml": "http://vocab.datahub.kr/def/aird-ml/",
      "aird-kg": "http://vocab.datahub.kr/def/aird-kg/",
      "csvw": "http://www.w3.org/ns/csvw#",
      "dqv": "http://www.w3.org/ns/dqv#",
      "prov": "http://www.w3.org/ns/prov#",
      "spdx": "http://spdx.org/rdf/terms#",
      "adms": "http://www.w3.org/ns/adms#",
      "vcard": "http://www.w3.org/2006/vcard/ns#",
      "rai": "http://mlcommons.org/croissant/RAI/",
      "dpv": "https://w3id.org/dpv#",
      "cr": "http://mlcommons.org/croissant/",
      "sc": "https://schema.org/",
      "void": "http://rdfs.org/ns/void#",
      "dcatkr": "http://vocab.datahub.kr/def/dcat-ap-kr/",
      "foaf": "http://xmlns.com/foaf/0.1/"
    }
  ],
  "@id": "https://data.example.go.kr/id/dataset/biz-registry/manifest/1.0.0",
  "@type": "dcat:Dataset",
  "aird:lifecycleStatus": "http://vocab.datahub.kr/def/aird/lifecycle-status/Discoverable",
  "dct:identifier": "https://data.example.go.kr/id/dataset/biz-registry",
  "dct:title": "예시 사업장 등록 정보",
  "dct:description": "지역별 사업장의 등록 정보와 영업 상태를 수록한 예시 데이터셋이다. 이 표준의 적용 절차를 보이기 위하여 작성하였다.",
  "dcat:keyword": [
    "사업장",
    "산업분류",
    "지역",
    "영업상태"
  ],
  "dct:type": [
    "http://vocab.datahub.kr/def/dcat-ap-kr/service-type/FILE",
    "http://vocab.datahub.kr/def/aird/dataset-type/Structured"
  ],
  "dct:language": [
    "http://publications.europa.eu/resource/authority/language/KOR"
  ],
  "csvw:tableSchema": {
    "columns": [
      {
        "name": "bizId",
        "datatype": "string",
        "dc:description": "사업장 고유 등록번호. B-YYYY-NNNN 형식",
        "required": true
      },
      {
        "name": "bizName",
        "datatype": "string",
        "dc:description": "사업장 명칭"
      },
      {
        "name": "industryCode",
        "datatype": "string",
        "dc:description": "한국표준산업분류 세세분류 코드"
      },
      {
        "name": "regionCode",
        "datatype": "string",
        "dc:description": "행정표준코드 법정동 시군구 코드"
      },
      {
        "name": "employeeCount",
        "datatype": "integer",
        "dc:description": "상시 종업원 수. 0 이상 100000 이하"
      },
      {
        "name": "revenueBand",
        "datatype": "string",
        "dc:description": "매출 구간 코드. B1부터 B4까지"
      },
      {
        "name": "registeredOn",
        "datatype": "date",
        "dc:description": "최초 등록일. ISO 8601-1 날짜"
      },
      {
        "name": "closedFlag",
        "datatype": "integer",
        "dc:description": "폐업 여부. 0은 영업, 1은 폐업"
      }
    ],
    "primaryKey": "bizId"
  },
  "dct:creator": [
    "https://data.example.go.kr/org/example-agency"
  ],
  "dct:publisher": "https://data.example.go.kr/org/example-agency",
  "dcat:contactPoint": {
    "@type": "vcard:Contact",
    "vcard:fn": "예시기관 데이터관리팀",
    "vcard:hasEmail": "mailto:data@example.go.kr"
  },
  "aird:creationMethod": "http://vocab.datahub.kr/def/aird/creation-method/collected",
  "dct:accrualPeriodicity": "http://publications.europa.eu/resource/authority/frequency/ANNUAL",
  "dct:license": "http://vocab.datahub.kr/def/dcat-ap-kr/license/KOGL-1",
  "dct:rights": "공공누리 제1유형. 출처를 표시하면 상업적 이용과 변형을 허용한다.",
  "dct:accessRights": "http://publications.europa.eu/resource/authority/access-right/PUBLIC",
  "dcat:distribution": [
    {
      "@type": "dcat:Distribution",
      "dcat:accessURL": "https://data.example.go.kr/aird/example-registry/data/example.csv",
      "dcat:mediaType": "text/csv",
      "dct:format": "http://publications.europa.eu/resource/authority/file-type/CSV",
      "spdx:checksum": {
        "spdx:algorithm": "SHA-256",
        "spdx:checksumValue": "7ad8add25d7a638322dd869f08b2fc7d64a4b12a3755c58ca9a10ee8646d78ea"
      }
    }
  ],
  "dcat:theme": [
    "http://vocab.datahub.kr/def/dcat-ap-kr/data-theme/INDUSTRY_EMPLOYMENT"
  ],
  "dcat:landingPage": "https://data.example.go.kr/dataset/biz-registry",
  "dcatkr:maintainer": {
    "@type": "foaf:Agent",
    "foaf:name": "예시기관 데이터관리팀"
  }
}

The column descriptions use dc:description on the assumption that an external context declares the dc prefix. The local context of this document does not contain that declaration. Being checked

Understanding layer — what stage 2 adds Example

This example records the measurement results for the same data as understanding-layer properties. No operating guideline was applied in this example. Therefore the quality tier (aird:qualityTier) and the threshold profile (aird:thresholdProfile) are empty. Empty values are a normal result. An agent interprets them not as a score of 0 but as “not judged: no operating guideline applied”.

D5-03 (Statistical plausibility) was measured provisionally with the example patterns in Part 2 Appendix I. Therefore the Diagnostic Maturity (DM) is DM-0 (provisional). The procedure that determines Diagnostic Maturity is described in Judgment procedure. Property names will follow the schema that the standard publishes once it is finalized.

{
  "@id": "https://data.example.go.kr/id/dataset/biz-registry/manifest/1.1.0",
  "dcat:previousVersion": "https://data.example.go.kr/id/dataset/biz-registry/manifest/1.0.0",
  "aird:lifecycleStatus": "http://vocab.datahub.kr/def/aird/lifecycle-status/Discoverable",
  "aird:dataType": "STRUCT",
  "dqv:computedOn": "https://data.example.go.kr/id/dataset/biz-registry",
  "prov:generatedAtTime": "2026-09-03",
  "aird:completenessScore": 1.0,
  "aird:validityScore": 1.0,
  "aird:uniquenessScore": 1.0,
  "aird:machineReadabilityScore": 1.0,
  "aird:diagnosticMaturity": "DM-0",
  "aird:qualityTier": null,
  "aird:thresholdProfile": null,
  "aird:diagnosticReport": {
    "@id": "https://data.example.go.kr/id/dataset/biz-registry/report/2026-09-03",
    "spdx:checksum": {
      "spdx:algorithm": "SHA-256",
      "spdx:checksumValue": "(SHA-256 of the diagnostic report file)"
    }
  },
  "rai:dataLimitations": [
    "폐업 신고 지연으로 closedFlag의 반영 시점이 실제 폐업 시점보다 늦을 수 있다"
  ]
}

The dimension scores (aird:completenessScore and so on) are a shortened notation for readability. AIRD vocabulary v0.10.5 records dimension scores as quality measurements (dqv:QualityMeasurement, 2.3.1 — one each for D1–D7). Being checked

One verified fact Example Proposed

This example records one fact confirmed by diagnosis as one measurement. It follows the DQV vocabulary that the standard already uses. aird:targetColumn · aird:referenceStandard · aird:validUntil are proposed properties.

{
  "@type": "dqv:QualityMeasurement",
  "dqv:isMeasurementOf": "aird:D2-02",
  "dqv:computedOn": "https://data.example.go.kr/id/dataset/biz-registry",
  "prov:generatedAtTime": "2026-09-03",
  "dqv:value": 0.997,
  "aird:targetColumn": "regionCode",
  "aird:referenceStandard": "행정표준코드 법정동 (버전 명시)",
  "aird:validUntil": "2026-12-03"
}

How to read these properties is described in Fields and handling by judgment, and the list of properties in Metadata elements. The release status of the schema and context is in Development status and upcoming releases.

The whole pack as one RDF graph

Merging the pack’s JSON-LD files (manifest · column schema · operation file · decision gate judgments) into one RDF graph reveals the references that cross file boundaries. The contents of each file are described in Packaging and distribution — files needed for each readiness state.

The whole pack as one RDF graph — references across file boundaries
The whole pack as one RDF graph — references across file boundaries The pack’s JSON-LD files merged into one RDF graph. Each box is the file that states those triples, and dashed lines are references that cross file boundaries. An agent follows this graph from the dataset to the grounds for a judgment.Source: AIRD information model v0.10.5, page 15 · click for full size
Last updated · 2026-10-07Report an error