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

336 lines
13 KiB
YAML

id: https://nde.nl/ontology/hc/class/digital-platform
name: digital_platform_class
title: DigitalPlatform Class
imports:
- linkml:types
- ../classes/APIEndpoint
- ../slots/has_or_had_auxiliary_entities
- ../slots/has_or_had_endpoint
- ../slots/has_or_had_score
- ../slots/has_or_had_url
- ../slots/inventory_web_address
- ../slots/is_or_was_associated_with
- ../slots/is_or_was_checked_through
- ../slots/is_or_was_derived_from
- ../slots/is_or_was_generated_by
- ../slots/is_or_was_stored_at
- ../slots/linked_data
- ../slots/metadata_standard
- ../slots/oai_pmh_endpoint
- ../slots/platform_id
- ../slots/platform_name
- ../slots/platform_type
- ../slots/preservation_level
- ../slots/refers_to_custodian
- ../slots/repository_software
- ../slots/serves_finding_aid
- ../slots/sparql_endpoint
- ../slots/specificity_annotation
- ../slots/temporal_extent
- ./AuxiliaryDigitalPlatform
- ./CollectionManagementSystem
- ./Custodian
- ./CustodianObservation
- ./DataServiceEndpoint
- ./DataServiceEndpointTypes
- ./DigitalPlatformType
- ./DigitalPlatformTypes
- ./FixityVerification
- ./METSAPI
- ./OAIPMHEndpoint
- ./ReconstructedEntity
- ./ReconstructionActivity
- ./SearchAPI
- ./SpecificityAnnotation
- ./StorageLocation
- ./TemplateSpecificityScore
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
- ./TimeSpan
- ./URL
- ./WebPage
- ./APIEndpoint
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
foaf: http://xmlns.com/foaf/0.1/
dcat: http://www.w3.org/ns/dcat#
dcterms: http://purl.org/dc/terms/
crm: http://www.cidoc-crm.org/cidoc-crm/
doap: http://usefulinc.com/ns/doap#
premis: http://www.loc.gov/premis/rdf/v3/
prov: http://www.w3.org/ns/prov#
classes:
DigitalPlatform:
is_a: ReconstructedEntity
class_uri: schema:WebSite
description: "Digital platform or online system associated with a heritage custodian.\n\n**CRITICAL DISTINCTION**:\n\n**DigitalPlatform CLASS** (this class):\n- Represents the DIGITAL INFRASTRUCTURE of any custodian\n- Used by PHYSICAL institutions (museums, archives, libraries) to represent their websites\n- Used by DIGITAL-FIRST institutions to represent their primary platform\n- Examples: Rijksmuseum website, museum online catalog, archive digital portal\n\n**DigitalPlatformType** (custodian type):\n- Classification for DIGITAL-FIRST custodians (online-only, no physical building)\n- Example: Europeana (aggregation platform), Internet Archive (born-digital)\n\n**Decision Rules**:\n\n1. **Physical Institution with Website**:\n - Custodian.custodian_type = MUSEUM/ARCHIVE/LIBRARY (not DIGITAL_PLATFORM)\n - Custodian.digital_platform \u2192 DigitalPlatform instance (this class)\n - Example: Rijksmuseum (MUSEUM) has Rijksstudio (DigitalPlatform)\n\n2. **Digital-First Institution**:\n\
\ - Custodian.custodian_type = DIGITAL_PLATFORM (DigitalPlatformType)\n - Custodian.digital_platform \u2192 DigitalPlatform instance (primary platform)\n - Example: Europeana (DIGITAL_PLATFORM) operates at https://europeana.eu/\n\n**Relationship to Custodian Hub**:\n\nDigitalPlatform is DIRECTLY connected to Custodian via refers_to_custodian,\njust like CustodianPlace, CustodianName, and CustodianLegalStatus.\n\nThis allows modeling:\n- Multiple digital platforms per custodian (website + API + mobile app)\n- Platform evolution over time (temporal validity)\n- Platform features and technical capabilities\n- Access points for digital heritage\n\n- Schema.org: schema:WebSite (primary), schema:WebApplication\n- DCAT: dcat:Catalog (for aggregation platforms), dcat:DataService (for APIs)\n- FOAF: foaf:homepage, foaf:Document\n- CIDOC-CRM: crm:E73_Information_Object (digital objects)\n\n**Example - Physical Museum with Digital Platform**:\n```yaml\nCustodian:\n has_or_had_identifier: \"https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804\"\
\n preferred_label: \"Rijksmuseum\"\n custodian_type: MUSEUM # Physical institution\n digital_platform:\n - platform_name: \"Rijksmuseum Website\"\n homepage_web_address: \"https://www.rijksmuseum.nl/\"\n platform_type: DISCOVERY_PORTAL\n iiif_support: true\n linked_data: true\n```\n\n**Example - Digital-First Platform**:\n```yaml\nCustodian:\n has_or_had_identifier: \"https://nde.nl/ontology/hc/eu-europeana\"\n preferred_label: \"Europeana\"\n custodian_type: DIGITAL_PLATFORM # Digital-first\n digital_platform:\n - platform_name: \"Europeana Platform\"\n homepage_web_address: \"https://www.europeana.eu/\"\n platform_type: AGGREGATION_PLATFORM\n api_endpoint: \"https://api.europeana.eu/\"\n iiif_support: true\n linked_data: true\n programming_languages: [\"Java\", \"Python\", \"JavaScript\"]\n```\n"
exact_mappings:
- schema:WebSite
- foaf:homepage
close_mappings:
- schema:WebApplication
- dcat:Catalog
- dcat:DataService
- crm:E73_Information_Object
- doap:Project
- premis:IntellectualEntity
related_mappings:
- foaf:Document
- schema:SoftwareApplication
- dcat:accessURL
slots:
- has_or_had_endpoint
- has_or_had_auxiliary_entities
- is_or_was_checked_through
- has_or_had_url
- inventory_web_address
- linked_data
- metadata_standard
- oai_pmh_endpoint
- platform_id
- platform_name
- platform_type
- preservation_level
- refers_to_custodian
- repository_software
- serves_finding_aid
- sparql_endpoint
- specificity_annotation
- is_or_was_stored_at
- has_or_had_score
- temporal_extent
- is_or_was_derived_from
- is_or_was_generated_by
attributes:
platform_url:
range: uri
description: URL of the platform (enrichment data field)
platform_category:
range: string
description: Category of platform (can be string or list)
digital_collections:
range: string
description: Description of digital collections available
technology_stack:
range: string
description: Technology stack description
data_standards:
range: string
description: Data standards used (can be string or list)
user_services:
range: string
description: User services offered
sustainability_model:
range: string
description: Sustainability/funding model
enrichment_timestamp:
range: string
description: Timestamp of enrichment extraction
source_method:
range: string
description: Method used to extract data (automated_extraction, manual, etc.)
enrichment_source:
range: string
description: Source of enrichment data (kien_registry, KB Netherlands Library Network, manual_curation, web_research, website_scrape_and_google_maps, etc.)
provenance:
range: string
description: Provenance information for this platform record
inlined: true
slot_usage:
platform_id:
range: uriorcurie
required: false
examples:
- value: https://nde.nl/ontology/hc/platform/rijksmuseum-website
platform_name:
range: string
required: false
examples:
- value: Rijksmuseum Website
- value: Europeana Platform
platform_type:
range: string
multivalued: false
required: false
examples:
- value: DigitalArchivePlatform
description: Digital archive platform (wd:Q1224984)
- value: AggregationPlatform
description: Aggregation platform (wd:Q7894)
- value: WEBSITE
has_or_had_url:
range: uri
required: false
inlined: true
examples:
- value:
has_or_had_url: https://www.rijksmuseum.nl/
has_or_had_type: homepage
- value:
has_or_had_url: https://www.europeana.eu/
has_or_had_type: homepage
inventory_web_address:
range: uri
multivalued: true
examples:
- value: https://www.nationaalarchief.nl/onderzoeken/index
has_or_had_endpoint:
range: APIEndpoint
inlined: true
examples:
- value:
has_or_had_url: https://api.europeana.eu/record/v2/
has_or_had_description: Europeana REST API endpoint
sparql_endpoint:
range: uri
examples:
- value: https://api.europeana.eu/sparql
oai_pmh_endpoint:
range: uri
examples:
- value: https://www.europeana.eu/oai
repository_software:
range: string
examples:
- value: DSpace 7.2
linked_data:
range: boolean
examples:
- value: true
metadata_standard:
range: string
multivalued: true
examples:
- value: Dublin Core
- value: MARC21
is_or_was_associated_with:
range: AuxiliaryDigitalPlatform
multivalued: true
inlined_as_list: true
required: false
examples:
- value:
- platform_name: Rijksstudio
has_or_had_type:
has_or_had_label: PROJECT_WEBSITE
platform_url: https://www.rijksmuseum.nl/nl/rijksstudio
- platform_name: Rijksmuseum Data API
has_or_had_type:
has_or_had_label: API_ENDPOINT
platform_url: https://data.rijksmuseum.nl/
temporal_extent:
range: TimeSpan
examples:
- value:
begin_of_the_begin: '2008-11-20'
end_of_the_begin: '2008-11-20'
is_or_was_derived_from:
range: CustodianObservation
multivalued: true
required: false
is_or_was_generated_by:
range: ReconstructionActivity
required: false
refers_to_custodian:
range: Custodian
required: false
examples:
- value: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
preservation_level:
range: string
required: false
examples:
- value: full_preservation
- value: bit_preservation
is_or_was_stored_at:
range: StorageLocation
required: false
inlined: true
examples:
- value:
has_or_had_identifier: aws-s3-eu-west-1
has_or_had_label:
label_text: AWS S3 eu-west-1
language: en
- value:
has_or_had_identifier: dans-data-archive
has_or_had_label:
label_text: DANS Data Archive
language: en
is_or_was_checked_through:
range: FixityVerification
inlined: true
required: false
examples:
- value:
temporal_extent:
begin_of_the_begin: '2025-11-15'
has_or_had_label: Last full fixity check
serves_finding_aid:
range: uriorcurie
multivalued: true
inlined_as_list: true
required: false
examples:
- value: https://nde.nl/ontology/hc/finding-aid/na/voc-inventory
- value: https://nde.nl/ontology/hc/finding-aid/rm/paintings-catalogue
comments:
- DigitalPlatform is DIRECTLY linked to Custodian hub (not a subclass of CustodianObservation)
- Used by BOTH physical institutions (website) and digital-first custodians (primary platform)
- 'Multivalued on Custodian: one custodian can have multiple platforms (website + API + mobile app)'
- Temporal validity tracks platform lifecycle (launch, shutdown, migration)
- IIIF and linked data flags enable discovery of interoperable platforms
- "MIGRATED: auxiliary_platforms \u2192 has_or_had_auxiliary_entities for AuxiliaryDigitalPlatform sites (project portals, microsites, APIs)"
- "Hierarchical pattern mirrors CustodianName \u2192 CustodianAppellation relationship"
see_also:
- https://schema.org/WebSite
- https://www.w3.org/ns/dcat
- https://iiif.io/
- http://usefulinc.com/ns/doap#
- https://www.loc.gov/standards/premis/
examples:
- value:
platform_id: https://nde.nl/ontology/hc/platform/rijksmuseum-website
platform_name: Rijksmuseum Website
platform_type:
- DiscoveryPortal
has_or_had_url:
has_or_had_url: https://www.rijksmuseum.nl/
has_or_had_type: homepage
api_endpoint: https://www.rijksmuseum.nl/api/
linked_data: true
metadata_standard:
- Dublin Core
- LIDO
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
- value:
platform_id: https://nde.nl/ontology/hc/platform/europeana
platform_name: Europeana Platform
platform_type:
- AggregationPlatform
- APIService
has_or_had_url:
has_or_had_url: https://www.europeana.eu/
has_or_had_type: homepage
has_or_had_endpoint:
has_or_had_url: https://api.europeana.eu/record/v2/
sparql_endpoint: https://api.europeana.eu/sparql
oai_pmh_endpoint: https://www.europeana.eu/oai
linked_data: true
metadata_standard:
- EDM (Europeana Data Model)
- Dublin Core
- LIDO
- EAD
temporal_extent:
begin_of_the_begin: '2008-11-20'
end_of_the_begin: '2008-11-20'
refers_to_custodian: https://nde.nl/ontology/hc/eu-europeana
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"