glam/frontend/public/schemas/20251121/linkml/modules/classes/BackupStatus.yaml
2026-01-19 00:09:28 +01:00

166 lines
6 KiB
YAML

# BackupStatus - Status class for backup and disaster recovery state
#
# Following the Type/Types naming convention (Rule 0b):
# This is a STATUS class (not Type/Types) because it represents
# the current state of a backup configuration, not a taxonomy of types.
#
# Generation date: 2026-01-13 (migrated from backup_status slot)
# Rule compliance: 37 (specificity scores), 38 (slot centralization)
#
# ONTOLOGY ALIGNMENT: PROV-O prov:Entity for status as entity with provenance
id: https://nde.nl/ontology/hc/class/BackupStatus
name: backup_status_class
title: Backup Status Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
prov: http://www.w3.org/ns/prov#
skos: http://www.w3.org/2004/02/skos/core#
dcterms: http://purl.org/dc/terms/
premis: http://www.loc.gov/premis/rdf/v3/
default_prefix: hc
imports:
- linkml:types
# Shared slots (centralized)
- ../slots/has_or_had_identifier
- ../slots/has_or_had_type
- ../slots/has_or_had_label
- ../slots/has_or_had_description
- ../slots/has_or_had_note
- ../slots/begin_of_the_begin
- ../slots/end_of_the_end
# Import the BackupType for type references
- ./BackupType
classes:
BackupStatus:
class_uri: prov:Entity
description: |
Represents the current backup and disaster recovery status for a heritage custodian.
**DEFINITION**:
BackupStatus captures the current state of backup configurations including:
- The type(s) of backup being used (via has_or_had_type → BackupType)
- Status description (free text details)
- Temporal validity (when this status was recorded/changed)
**ONTOLOGY ALIGNMENT**:
| Ontology | Class/Property | Notes |
|----------|----------------|-------|
| **PROV-O** | `prov:Entity` | Primary - entity with provenance |
| **PREMIS** | `premis:fixity` | Related - data integrity |
| **SKOS** | `skos:Concept` | For type classification |
**RELATIONSHIP TO OTHER CLASSES**:
```
CustodianAdministration
└── has_or_had_status → BackupStatus (THIS CLASS)
├── has_or_had_type → BackupType (type hierarchy)
├── has_or_had_description (free text details)
└── begin_of_the_begin / end_of_the_end (validity period)
```
**SLOT MIGRATION** (2026-01-13):
This class replaces the backup_status string slot.
Old pattern: `backup_status: "Daily backup to Azure, replicated to secondary site"`
New pattern: `has_or_had_status: BackupStatus` with structured type and description
exact_mappings:
- prov:Entity
close_mappings:
- premis:fixity
slots:
- has_or_had_identifier
- has_or_had_type
- has_or_had_label
- has_or_had_description
- has_or_had_note
- begin_of_the_begin
- end_of_the_end
slot_usage:
has_or_had_identifier:
range: uriorcurie
identifier: true
required: true
pattern: "^https://nde\\.nl/ontology/hc/backup-status/[a-z0-9-]+$"
has_or_had_type:
range: BackupType
multivalued: true
inlined_as_list: true
description: "The backup type(s) in use for this status."
examples:
- value:
- has_or_had_short_code: DAILY_AUTOMATED
- has_or_had_short_code: CLOUD_AZURE
description: Daily automated backup to Azure
has_or_had_description:
range: string
description: "Free text description of the backup status."
examples:
- value: "Daily backup to Azure, replicated to secondary site in Rotterdam."
has_or_had_note:
range: string
multivalued: true
description: "Additional notes or concerns about the backup status."
examples:
- value: "Encryption at rest enabled since 2024-01"
- value: "Annual disaster recovery test passed 2025-06"
begin_of_the_begin:
description: "When this backup status configuration began."
end_of_the_end:
description: "When this backup status configuration ended (if changed)."
annotations:
specificity_score: "0.60"
specificity_rationale: "Backup status relevant to all heritage custodians with digital assets."
has_or_had_score: # was: template_specificity - migrated per Rule 53 (2026-01-17)
# NOTE: slot_usage may need manual review for range/description updates '{"digital_platform": 0.85, "organizational_change": 0.40, "general_heritage": 0.50}'
slot_migration: |
2026-01-13: Migrated from backup_status string slot
- backup_status (string) → has_or_had_status (BackupStatus)
comments:
- "BackupStatus represents the current backup configuration state"
- "Linked to BackupType for structured type classification"
- "Supports temporal validity tracking"
- "MIGRATED 2026-01-13: Replaces backup_status string slot"
examples:
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/backup-status/example-001
has_or_had_type:
- has_or_had_short_code: DAILY_AUTOMATED
- has_or_had_short_code: CLOUD_AZURE
has_or_had_description: |
Daily automated backup to Azure with replication to secondary site.
30-day retention, encrypted at rest.
begin_of_the_begin: "2024-01-15T00:00:00Z"
description: Example backup status with multiple types
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/backup-status/critical-001
has_or_had_type:
- has_or_had_short_code: NOT_BACKED_UP
has_or_had_description: "Legacy system not yet included in backup. Migration planned for Q2 2026."
has_or_had_note:
- "CRITICAL: Data at risk until migration complete"
description: Critical status - not backed up