glam/schemas/20251121/linkml/modules/classes/GhcidBlock.yaml

88 lines
3 KiB
YAML

# GhcidBlock - GHCID generation metadata and history
# Extracted from custodian_source.yaml per Rule 38 (modular schema files)
# Extraction date: 2026-01-08
id: https://nde.nl/ontology/hc/classes/GhcidBlock
name: GhcidBlock
title: GhcidBlock
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
prov: http://www.w3.org/ns/prov#
xsd: http://www.w3.org/2001/XMLSchema#
dcterms: http://purl.org/dc/terms/
imports:
- linkml:types
- ./GhcidHistoryEntry
- ./LocationResolution
default_range: string
classes:
GhcidBlock:
description: >-
GHCID (Global Heritage Custodian Identifier) generation metadata
and history. Contains current GHCID string, UUID variants (v5, v8),
numeric form, generation timestamp, and history of GHCID changes
due to relocations, mergers, or collision resolution.
Ontology mapping rationale:
- class_uri is dcterms:Identifier because GHCID is fundamentally
an identifier assignment with associated metadata
- close_mappings includes prov:Entity as identifier blocks are
traceable provenance entities themselves
- related_mappings includes schema:PropertyValue (identifier as
property) and prov:Generation (identifier creation event)
class_uri: dcterms:Identifier
close_mappings:
- prov:Entity
related_mappings:
- schema:PropertyValue
- prov:Generation
attributes:
ghcid_current:
range: string
required: true
description: Current GHCID string (e.g., NL-NH-AMS-A-NBA)
ghcid_original:
range: string
description: Original GHCID if changed
ghcid_uuid:
range: string
required: false
description: UUID v5 (SHA-1) form (can be null if not yet generated)
ghcid_uuid_sha256:
range: string
required: false
description: UUID v8 (SHA-256) form (can be null if not yet generated)
ghcid_numeric:
range: integer
required: false
description: 64-bit numeric form (stored as integer in YAML, can be null)
record_id:
range: string
description: UUID v7 database record ID
generation_timestamp:
range: datetime
description: When GHCID was generated
ghcid_history:
range: GhcidHistoryEntry
multivalued: true
inlined_as_list: true
description: History of GHCID changes
location_resolution:
range: LocationResolution
description: How settlement was resolved
geonames_id:
range: integer
description: GeoNames ID for settlement
base_ghcid_before_collision:
range: string
description: Original GHCID before collision resolution suffix was added
collision_resolved:
range: boolean
description: Whether a collision was detected and resolved