glam/data/examples/schema_v0.2.2_enrichment_example.yaml
2025-11-19 23:25:22 +01:00

66 lines
2.7 KiB
YAML

# =============================================================================
# SCHEMA v0.2.2 enrichment_history DEMONSTRATION
# =============================================================================
#
# This file demonstrates the NEW structured enrichment tracking introduced
# in schema v0.2.2 (November 2025).
#
# KEY FEATURES:
# - Provenance.enrichment_history: List of EnrichmentHistoryEntry objects
# - enrichment_type: Controlled vocabulary (EnrichmentTypeEnum)
# - match_score: Queryable confidence metric (0.0-1.0)
# - verified: Boolean flag for manual verification status
# - enrichment_source: Source URL for traceability
# - enrichment_notes: Human-readable description
#
# ONTOLOGY ALIGNMENT:
# - PROV-O: enrichment_type values map to prov:Activity subclasses
# - ADMS: verified field maps to adms:status
# - Dublin Core: enrichment_date maps to dcterms:modified
#
# =============================================================================
- id: https://w3id.org/heritage/custodian/cl/example-schema-v0.2.2
name: Example Chilean Library
institution_type: LIBRARY
description: Synthetic example demonstrating schema v0.2.2 enrichment_history structure
locations:
- city: Santiago
country: CL
latitude: -33.4489
longitude: -70.6693
identifiers:
- identifier_scheme: Wikidata
identifier_value: Q12345678
identifier_url: https://www.wikidata.org/wiki/Q12345678
- identifier_scheme: VIAF
identifier_value: '987654321'
identifier_url: https://viaf.org/viaf/987654321
provenance:
data_source: CONVERSATION_NLP
data_tier: TIER_4_INFERRED
extraction_date: '2025-11-06T08:00:00+00:00'
extraction_method: AI agent NER extraction from Chilean GLAM conversation
confidence_score: 0.92
conversation_id: edc75d66-ee42-4199-8e22-65b0d2347922
enrichment_history:
- enrichment_date: '2025-11-10T14:30:00+00:00'
enrichment_method: Wikidata SPARQL query with fuzzy name matching
enrichment_type: WIKIDATA_IDENTIFIER
match_score: 0.952
verified: false
enrichment_source: https://www.wikidata.org
enrichment_notes: Matched to 'Biblioteca Ejemplo de Santiago' (Q12345678)
- enrichment_date: '2025-11-10T14:30:05+00:00'
enrichment_method: VIAF identifier extracted from Wikidata entity
enrichment_type: VIAF_IDENTIFIER
verified: false
enrichment_source: https://viaf.org
enrichment_notes: Extracted from Wikidata Q12345678
- enrichment_date: '2025-11-10T14:35:00+00:00'
enrichment_method: Nominatim geocoding API
enrichment_type: GEOCODING
match_score: 1.0
verified: false
enrichment_source: https://nominatim.openstreetmap.org
enrichment_notes: 'Geocoded address: Santiago, Chile'