glam/schemas/20251121/linkml/modules/classes/AuxiliaryDigitalPlatform.yaml
kempersc eff2f47f6f Add auxiliary enums and slots for digital platforms and physical locations
- Created AuxiliaryDigitalPlatformTypeEnum.yaml to classify types of secondary digital platforms.
- Created AuxiliaryPlaceTypeEnum.yaml to classify types of secondary physical locations.
- Added OrganizationBranchTypeEnum.yaml for formal organizational branches at auxiliary locations.
- Introduced auxiliary_places.yaml slot to link CustodianPlace to subordinate physical locations.
- Introduced auxiliary_platforms.yaml slot to link DigitalPlatform to subordinate digital properties.
- Added located_at.yaml slot to connect OrganizationalStructure to physical locations.
2025-11-25 15:06:43 +01:00

610 lines
22 KiB
YAML

# Heritage Auxiliary Digital Platform Class
# Represents subordinate/project-based digital platforms of a heritage custodian
# DCAT: dcat:Catalog for secondary digital services
id: https://nde.nl/ontology/hc/class/auxiliary-digital-platform
name: auxiliary-digital-platform-class
title: AuxiliaryDigitalPlatform Class
imports:
- linkml:types
- ./Custodian
- ./DigitalPlatform
- ./CustodianObservation
- ./ReconstructionActivity
- ./TimeSpan
- ../enums/AuxiliaryDigitalPlatformTypeEnum
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
dcat: http://www.w3.org/ns/dcat#
dcterms: http://purl.org/dc/terms/
foaf: http://xmlns.com/foaf/0.1/
prov: http://www.w3.org/ns/prov#
skos: http://www.w3.org/2004/02/skos/core#
classes:
AuxiliaryDigitalPlatform:
class_uri: dcat:Catalog
description: >-
Subordinate or project-based digital platform associated with a heritage custodian.
**CRITICAL DISTINCTION - THREE-TIER DIGITAL PLATFORM MODEL**:
1. **DigitalPlatform** (main digital entry point):
- Primary web presence of the custodian
- Main website, primary API, flagship digital platform
- Like CustodianPlace is the preferred place reference
- Examples: rijksmuseum.nl, europeana.eu, nationaalarchief.nl
2. **AuxiliaryDigitalPlatform** (subordinate platforms) - THIS CLASS:
- Secondary digital properties: project sites, exhibition microsites
- Like CustodianAppellation is to CustodianName
- Examples: project websites, temporary exhibition portals, specialized tools
3. **DigitalPlatformType** (custodian type classification):
- For digital-FIRST custodians (no physical building)
- Applied at Custodian.custodian_type level
- Examples: Europeana (aggregation platform), Internet Archive
**DCAT ALIGNMENT**:
`dcat:Catalog` - "A curated collection of metadata about datasets"
Key properties:
- `dcat:dataset` - links to datasets/collections
- `dcat:service` - data services provided
- `dcterms:isPartOf` - links to parent catalog
**RELATIONSHIP TO DIGITALPLATFORM**:
AuxiliaryDigitalPlatform represents SUBORDINATE digital presence
DigitalPlatform represents PRIMARY digital entry point
```
Custodian (hub)
└── digital_platform → DigitalPlatform (main digital entry)
└── auxiliary_platforms → AuxiliaryDigitalPlatform (project sites)
```
**USE CASES**:
1. **Project Websites**:
- Rijksmuseum → Rijksstudio API (separate from main website)
- National Archives → WW2 Portal (thematic project)
2. **Exhibition Microsites**:
- Temporary exhibition with dedicated website
- Virtual tour for specific collection
3. **Specialized Tools/Apps**:
- Mobile app (separate from responsive website)
- Collection browser tool
- Crowdsourcing platform
4. **Legacy/Archived Platforms**:
- Previous website versions
- Deprecated APIs still in use
5. **Grant-Funded Projects**:
- EU-funded digitization project portal
- Research project data portal
6. **Educational Platforms**:
- Teacher resources portal
- Student learning modules
- Workshop booking system
**Example - Rijksmuseum Auxiliary Platforms**:
```yaml
Custodian:
hc_id: "https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804"
preferred_label: "Rijksmuseum"
digital_platform:
- platform_name: "Rijksmuseum Website"
homepage_web_address: "https://www.rijksmuseum.nl/"
auxiliary_platforms:
- platform_name: "Rijksstudio"
auxiliary_platform_type: PROJECT_WEBSITE
platform_url: "https://www.rijksmuseum.nl/nl/rijksstudio"
platform_purpose: "Personal collection creation and high-res image downloads"
- platform_name: "Rijksmuseum Data API"
auxiliary_platform_type: API_ENDPOINT
platform_url: "https://data.rijksmuseum.nl/"
platform_purpose: "Developer access to collection metadata and images"
- platform_name: "Night Watch Experience"
auxiliary_platform_type: EXHIBITION_MICROSITE
platform_url: "https://www.rijksmuseum.nl/en/stories/operation-night-watch"
platform_purpose: "Interactive exploration of Night Watch research project"
```
**TEMPORAL VALIDITY**:
Auxiliary platforms often have finite lifespans:
- Exhibition microsite: opens with exhibition, archived after closure
- Project portal: funded period, then deprecated or integrated
- Legacy platforms: valid_to when replaced by new system
exact_mappings:
- dcat:Catalog
close_mappings:
- schema:WebSite
- dcat:DataService
- foaf:Document
related_mappings:
- dcterms:isPartOf
- schema:isRelatedTo
- dcat:servesDataset
slots:
- auxiliary_platform_id
- platform_name
- auxiliary_platform_type
- platform_url
- platform_purpose
- platform_description
- api_documentation
- technology_stack
- is_auxiliary_of
- provides_access_to
- related_project
- funding_source
- iiif_support
- linked_data
- valid_from
- valid_to
- temporal_extent
- archival_status
- archived_at
- was_derived_from
- was_generated_by
- refers_to_custodian
slot_usage:
auxiliary_platform_id:
slot_uri: dcterms:identifier
description: >-
Unique identifier for this auxiliary digital platform.
Format: URI following NDE Heritage Custodian ontology conventions.
range: uriorcurie
required: true
identifier: true
examples:
- value: "https://nde.nl/ontology/hc/aux-platform/rijksmuseum-rijksstudio"
description: "Rijksstudio platform ID"
platform_name:
slot_uri: dcterms:title
description: >-
Name of this auxiliary digital platform.
Dublin Core: title for resource name.
This is the human-readable name of the secondary platform.
range: string
required: true
examples:
- value: "Rijksstudio"
description: "Personal collection tool"
- value: "Operation Night Watch"
description: "Research project microsite"
- value: "WW2 Portal"
description: "Thematic archive portal"
auxiliary_platform_type:
slot_uri: dcterms:type
description: >-
Type of auxiliary platform using AuxiliaryDigitalPlatformTypeEnum.
Types include:
- PROJECT_WEBSITE: Dedicated project site
- EXHIBITION_MICROSITE: Temporary exhibition portal
- API_ENDPOINT: Programmatic interface (separate from main API)
- MOBILE_APP: Native or hybrid mobile application
- COLLECTION_BROWSER: Specialized collection exploration tool
- CROWDSOURCING_PLATFORM: User contribution portal
- EDUCATIONAL_PORTAL: Learning resources
- DATA_PORTAL: Dataset download/access
- LEGACY_PLATFORM: Deprecated but maintained platform
- VIRTUAL_TOUR: 360° or immersive experience
Dublin Core: type for classification.
range: AuxiliaryDigitalPlatformTypeEnum
required: true
examples:
- value: "PROJECT_WEBSITE"
description: "Project site type"
- value: "EXHIBITION_MICROSITE"
description: "Exhibition microsite type"
platform_url:
slot_uri: foaf:homepage
description: >-
URL of this auxiliary digital platform.
FOAF: homepage for web address.
This is the entry point URL for the platform.
range: uri
required: true
pattern: "^https?://"
examples:
- value: "https://www.rijksmuseum.nl/nl/rijksstudio"
description: "Rijksstudio URL"
- value: "https://data.rijksmuseum.nl/"
description: "Data API URL"
platform_purpose:
slot_uri: dcterms:description
description: >-
Brief description of what this platform provides/enables.
Dublin Core: description for purpose statement.
Focus on user benefit and functionality.
range: string
examples:
- value: "Personal collection creation and high-res image downloads"
description: "Rijksstudio purpose"
- value: "Interactive exploration of Night Watch research project"
description: "Exhibition microsite purpose"
platform_description:
slot_uri: dcterms:abstract
description: >-
Detailed description of this auxiliary platform.
Dublin Core: abstract for longer description.
Include:
- Full functionality description
- Target audience
- Technical requirements
- Relationship to main platform
range: string
examples:
- value: "Rijksstudio allows users to create personal collections from the Rijksmuseum's digitized artworks, download high-resolution images, and share curated sets with others."
description: "Detailed platform description"
api_documentation:
slot_uri: dcat:endpointDescription
description: >-
URL to API documentation (for API-type platforms).
DCAT: endpointDescription for API documentation.
range: uri
examples:
- value: "https://data.rijksmuseum.nl/object-metadata/api/"
description: "API documentation URL"
technology_stack:
slot_uri: schema:programmingLanguage
description: >-
Technologies used to build this platform.
Schema.org: programmingLanguage for technical implementation.
Include frameworks, languages, services.
range: string
multivalued: true
examples:
- value: "React"
description: "Frontend framework"
- value: "Python/Django"
description: "Backend stack"
is_auxiliary_of:
slot_uri: dcterms:isPartOf
description: >-
Link back to the DigitalPlatform that this is an auxiliary of.
Dublin Core: isPartOf links part to whole.
Like CustodianAppellation.variant_of_name → CustodianName,
this links AuxiliaryDigitalPlatform → DigitalPlatform (main platform).
range: DigitalPlatform
required: true
examples:
- value: "https://nde.nl/ontology/hc/platform/rijksmuseum-website"
description: "Main Rijksmuseum website"
provides_access_to:
slot_uri: dcat:servesDataset
description: >-
Collections or datasets accessible through this platform.
DCAT: servesDataset for data service relationship.
Link to CustodianCollection or dataset identifiers.
range: uriorcurie
multivalued: true
examples:
- value: "https://nde.nl/ontology/hc/collection/rm-paintings"
description: "Paintings collection"
related_project:
slot_uri: dcterms:isPartOf
description: >-
Research project or initiative this platform supports.
Dublin Core: isPartOf for project relationship.
Useful for grant-funded or research project platforms.
range: string
examples:
- value: "Operation Night Watch"
description: "Research project name"
- value: "EU Horizon 2020 Grant #123456"
description: "Grant reference"
funding_source:
slot_uri: schema:funder
description: >-
Organization or grant funding this platform.
Schema.org: funder for funding relationship.
range: string
examples:
- value: "European Commission Horizon 2020"
description: "EU funding"
- value: "Mondriaan Fund"
description: "Dutch cultural fund"
iiif_support:
slot_uri: dcterms:conformsTo
description: >-
Does this platform support IIIF?
Dublin Core: conformsTo for standard compliance.
range: boolean
examples:
- value: true
description: "IIIF enabled"
linked_data:
slot_uri: dcterms:conformsTo
description: >-
Does this platform provide linked open data?
Dublin Core: conformsTo for LOD compliance.
range: boolean
examples:
- value: true
description: "Provides RDF/JSON-LD"
valid_from:
slot_uri: schema:validFrom
description: >-
Date when this auxiliary platform was launched.
Track when project sites, microsites opened.
range: date
examples:
- value: "2018-06-01"
description: "Platform launched June 2018"
valid_to:
slot_uri: schema:validThrough
description: >-
Date when this auxiliary platform was decommissioned.
NULL if still active.
Important for temporary exhibition sites and project portals.
range: date
examples:
- value: "2021-12-31"
description: "Exhibition site closed end of 2021"
temporal_extent:
slot_uri: crm:P4_has_time-span
description: >-
Temporal period during which this platform was operational.
CIDOC-CRM: P4_has_time-span for fuzzy temporal boundaries.
range: TimeSpan
examples:
- value:
begin_of_the_begin: "2018-01-01"
end_of_the_end: "2021-12-31"
description: "Project period 2018-2021"
archival_status:
slot_uri: schema:creativeWorkStatus
description: >-
Current status of platform if no longer active.
Schema.org: creativeWorkStatus for lifecycle status.
Values:
- ACTIVE: Currently operational
- DEPRECATED: Still accessible but not maintained
- ARCHIVED: Preserved in web archive
- OFFLINE: No longer accessible
range: string
examples:
- value: "ARCHIVED"
description: "Preserved in web archive"
- value: "DEPRECATED"
description: "Still accessible but not maintained"
archived_at:
slot_uri: schema:archivedAt
description: >-
URL to archived version (e.g., Internet Archive Wayback Machine).
Schema.org: archivedAt for archive location.
range: uri
examples:
- value: "https://web.archive.org/web/20211231/https://example.nl/exhibition/"
description: "Wayback Machine URL"
was_derived_from:
slot_uri: prov:wasDerivedFrom
description: >-
CustodianObservation(s) documenting this platform.
PROV-O: wasDerivedFrom for observation provenance.
range: CustodianObservation
multivalued: true
required: false
was_generated_by:
slot_uri: prov:wasGeneratedBy
description: >-
ReconstructionActivity that generated this platform record.
PROV-O: wasGeneratedBy for generation activity.
range: ReconstructionActivity
required: false
refers_to_custodian:
slot_uri: dcterms:references
description: >-
The Custodian hub that operates this auxiliary platform.
Dublin Core: references for entity reference.
All auxiliary platforms MUST reference the main custodian hub.
range: Custodian
required: true
examples:
- value: "https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804"
description: "Rijksmuseum custodian hub"
comments:
- "AuxiliaryDigitalPlatform models SUBORDINATE digital properties"
- "DigitalPlatform models PRIMARY digital entry point"
- "Analogous to CustodianAppellation for alternative names"
- "DCAT dcat:Catalog for secondary data catalogs/services"
- "Temporal validity tracks platform lifecycle (launched/deprecated/archived)"
- "Links back to DigitalPlatform via is_auxiliary_of"
- "Important for project-based and exhibition microsites with finite lifespans"
see_also:
- "https://www.w3.org/TR/vocab-dcat-2/#Class:Catalog"
- "https://www.w3.org/TR/vocab-dcat-2/#Property:catalog_service"
- "https://schema.org/archivedAt"
examples:
- value:
auxiliary_platform_id: "https://nde.nl/ontology/hc/aux-platform/rijksmuseum-rijksstudio"
platform_name: "Rijksstudio"
auxiliary_platform_type: PROJECT_WEBSITE
platform_url: "https://www.rijksmuseum.nl/nl/rijksstudio"
platform_purpose: "Personal collection creation and high-res image downloads"
platform_description: "Rijksstudio allows users to create personal collections from the Rijksmuseum's digitized artworks, download high-resolution images, and share curated sets with others."
is_auxiliary_of: "https://nde.nl/ontology/hc/platform/rijksmuseum-website"
provides_access_to:
- "https://nde.nl/ontology/hc/collection/rm-paintings"
- "https://nde.nl/ontology/hc/collection/rm-prints"
iiif_support: true
linked_data: false
valid_from: "2012-10-01"
archival_status: "ACTIVE"
refers_to_custodian: "https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804"
description: "Rijksstudio personal collection platform"
- value:
auxiliary_platform_id: "https://nde.nl/ontology/hc/aux-platform/rijksmuseum-data-api"
platform_name: "Rijksmuseum Data API"
auxiliary_platform_type: API_ENDPOINT
platform_url: "https://data.rijksmuseum.nl/"
platform_purpose: "Developer access to collection metadata and images"
api_documentation: "https://data.rijksmuseum.nl/object-metadata/api/"
technology_stack:
- "REST"
- "JSON"
is_auxiliary_of: "https://nde.nl/ontology/hc/platform/rijksmuseum-website"
iiif_support: true
linked_data: true
valid_from: "2013-03-01"
archival_status: "ACTIVE"
refers_to_custodian: "https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804"
description: "Rijksmuseum developer API"
- value:
auxiliary_platform_id: "https://nde.nl/ontology/hc/aux-platform/rm-night-watch-experience"
platform_name: "Operation Night Watch"
auxiliary_platform_type: EXHIBITION_MICROSITE
platform_url: "https://www.rijksmuseum.nl/en/stories/operation-night-watch"
platform_purpose: "Interactive exploration of Night Watch research project"
related_project: "Operation Night Watch"
funding_source: "ING Bank"
is_auxiliary_of: "https://nde.nl/ontology/hc/platform/rijksmuseum-website"
iiif_support: true
valid_from: "2019-07-01"
archival_status: "ACTIVE"
refers_to_custodian: "https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804"
description: "Night Watch research project microsite"
- value:
auxiliary_platform_id: "https://nde.nl/ontology/hc/aux-platform/na-ww2-portal"
platform_name: "WW2 Archives Portal"
auxiliary_platform_type: PROJECT_WEBSITE
platform_url: "https://www.nationaalarchief.nl/onderzoeken/zoekhulpen/ww2"
platform_purpose: "Thematic portal for World War 2 archival research"
platform_description: "Specialized portal providing access to WW2-related archives including resistance records, persecution documents, and liberation materials."
is_auxiliary_of: "https://nde.nl/ontology/hc/platform/nationaal-archief-website"
provides_access_to:
- "https://nde.nl/ontology/hc/collection/na-resistance-archives"
- "https://nde.nl/ontology/hc/collection/na-liberation-photos"
valid_from: "2015-05-05"
archival_status: "ACTIVE"
refers_to_custodian: "https://nde.nl/ontology/hc/nl-na"
description: "National Archives WW2 thematic portal"
# Slot definitions (basic - detailed in class slot_usage)
slots:
auxiliary_platform_id:
description: Unique identifier for auxiliary digital platform
range: uriorcurie
auxiliary_platform_type:
description: Type of auxiliary platform
range: AuxiliaryDigitalPlatformTypeEnum
platform_url:
description: URL of auxiliary platform
range: uri
platform_purpose:
description: Brief purpose statement
range: string
api_documentation:
description: URL to API documentation
range: uri
technology_stack:
description: Technologies used
range: string
is_auxiliary_of:
description: Link to main DigitalPlatform
range: DigitalPlatform
provides_access_to:
description: Collections/datasets accessible
range: uriorcurie
related_project:
description: Related research project
range: string
funding_source:
description: Funding organization/grant
range: string
archival_status:
description: Current status (ACTIVE/DEPRECATED/ARCHIVED/OFFLINE)
range: string
archived_at:
description: URL to archived version
range: uri