glam/schemas/20251121/linkml/modules/classes/Policy.yaml
kempersc 2d09776856 Refactor StorageCondition schema: Migrate compliance_status to has_or_had_status with ComplianceStatus class
- Removed compliance_status slot and replaced it with has_or_had_status.
- Updated has_or_had_status to use ComplianceStatus for structured representation.
- Adjusted examples to reflect new structure for compliance status.
- Updated documentation to indicate migration and provide details on the ComplianceStatus class.
2026-01-22 16:22:16 +01:00

102 lines
3.2 KiB
YAML

# Policy base class
# Created 2026-01-22 per slot_fixes.yaml revision for condition_policy (Rule 53)
#
# Generation date: 2026-01-22
# Rule compliance: 53 (slot_fixes.yaml), 39 (RiC-O naming), 0b (Type/Types pattern)
#
# Base class for all policy types (TransferPolicy, ConditionPolicy, AccessPolicy, etc.)
id: https://nde.nl/ontology/hc/class/Policy
name: policy_class
title: Policy Base Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
odrl: http://www.w3.org/ns/odrl/2/
dcterms: http://purl.org/dc/terms/
schema: http://schema.org/
default_prefix: hc
imports:
- linkml:types
- ../slots/policy_id
- ../slots/policy_name
- ../slots/policy_description
- ../slots/policy_effective_from
- ../slots/policy_effective_to
- ../slots/note
classes:
Policy:
class_uri: odrl:Policy
abstract: true
description: |
Abstract base class for all policy types.
**DEFINITION**:
A Policy defines rules, constraints, and conditions that govern
activities, resources, or entities within a heritage custodian context.
**SUBCLASSES**:
- **TransferPolicy**: Policies governing custody/ownership transfers
- **ConditionPolicy**: Policies specifying required conditions
- **AccessPolicy**: Policies defining access rights and restrictions
- **RetentionPolicy**: Policies for record retention schedules
**ODRL ALIGNMENT**:
`odrl:Policy` - "A Policy is a named entity for a rule-based system
for specifying permissions, prohibitions, and obligations."
**SEMANTIC PATTERN**:
Policy classes define WHAT SHOULD BE (normative).
Observation classes capture WHAT IS (descriptive).
The gap between policy and observation is a key quality metric.
Created as part of condition_policy migration per slot_fixes.yaml (Rule 53).
exact_mappings:
- odrl:Policy
close_mappings:
- schema:GovernmentService
- dcterms:Policy
slots:
- policy_id
- policy_name
- policy_description
- policy_effective_from
- policy_effective_to
- note
slot_usage:
policy_id:
required: false
description: Unique identifier for the policy.
policy_name:
required: true
description: Human-readable name for the policy.
policy_description:
description: Detailed description of the policy's scope and requirements.
policy_effective_from:
description: Date when this policy became/becomes effective.
policy_effective_to:
description: Date when this policy expired/expires.
note:
description: Additional notes about the policy.
annotations:
custodian_types: '["*"]'
custodian_types_rationale: Policies apply to all heritage custodian types.
specificity_score: 0.35
specificity_rationale: General base class for all policy types.
comments:
- "Abstract base class - use subclasses for specific policy types"
- "Follows ODRL policy model for rule-based systems"
- "Created 2026-01-22 per slot_fixes.yaml condition_policy migration"