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

215 lines
9.7 KiB
YAML

id: https://nde.nl/ontology/hc/class/OrganizationalStructure
name: OrganizationalStructure
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
org: http://www.w3.org/ns/org#
prov: http://www.w3.org/ns/prov#
imports:
- linkml:types
- ./AuxiliaryPlace
- ./PersonObservation
- ./CustodianCollection
- ./Custodian
- ./OrganizationalUnitType
- ../slots/located_at
- ../slots/has_or_had_label # was: unit_name - migrated per Rule 53
- ../slots/has_or_had_type
- ../slots/parent_unit
- ../slots/staff_count
- ../slots/has_or_had_staff_member
- ../slots/has_or_had_managed_collection
- ../slots/contact_point
- ../slots/temporal_extent # was: valid_from + valid_to - migrated per Rule 53
- ./TimeSpan
# REMOVED 2026-01-14: valid_from + valid_to - migrated to temporal_extent (Rule 53)
- ../slots/refers_to_custodian
- ../slots/id
- ../slots/specificity_annotation
- ../slots/has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
- ./SpecificityAnnotation
- ./TemplateSpecificityScore # was: TemplateSpecificityScores - migrated per Rule 53 (2026-01-17)
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
classes:
OrganizationalStructure:
class_uri: org:OrganizationalUnit
description: "Informal organizational structure of a heritage custodian, representing\noperational departments, teams,\
\ divisions, or groups that are NOT formally\nregistered as separate legal entities.\n\n**Distinction from GovernanceStructure**:\n\
- **GovernanceStructure**: Formal structure from legal registration \n (e.g., \"National Archives is agency under Ministry\
\ OCW\")\n- **OrganizationalStructure**: Informal/operational units\n (e.g., \"Digital Preservation Team\", \"Public\
\ Services Department\")\n\n**W3C ORG Alignment**:\nMaps to `org:OrganizationalUnit` - \"An Organization such as a University\
\ \nSupport Unit which is part of some larger FormalOrganization and only has \nfull recognition within the context\
\ of that FormalOrganization, it is not \na Legal Entity in its own right.\"\n\n**Scope**:\n- Departments (Collections,\
\ Education, Research, IT)\n- Teams (Digital Preservation, Conservation, Cataloging)\n- Programs (Outreach programs,\
\ fellowship programs)\n- Working groups (Metadata standards group, acquisitions committee)\n- Service units (Reading\
\ room, reference desk, storage facilities)\n\n**NOT in Scope** (use GovernanceStructure instead):\n- Formal sub-organizations\
\ with legal registration\n- Legally recognized branches or subsidiaries\n- Governance bodies from articles of incorporation\n\
\n**Temporal Dynamics**:\nOrganizational units can be created, renamed, merged, or dissolved\nindependently of the custodian's\
\ legal status. Track changes with\n`valid_from`/`valid_to` dates.\n\n**Example - National Archives**:\n```yaml\nCustodianLegalStatus:\n\
\ governance_structure: # FORMAL (from legal registration)\n structure_type: \"Government agency\"\n governance_body:\
\ \"Reports to Ministry of OCW\"\n\nCustodian:\n organizational_structure: # INFORMAL (operational)\n - unit_name:\
\ \"Digital Preservation Department\"\n unit_type: \"department\"\n description: \"Manages born-digital archives\"\
\n - unit_name: \"Public Services Team\"\n unit_type: \"team\"\n description: \"Reading room, reference\
\ services\"\n```\n"
slots:
- contact_point
- id
- located_at
- has_or_had_managed_collection
- parent_unit
- refers_to_custodian
- specificity_annotation
- staff_count
- has_or_had_staff_member
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
- has_or_had_label # was: unit_name
- has_or_had_type
- temporal_extent # was: valid_from + valid_to - migrated per Rule 53
slot_usage:
id:
identifier: true
required: true
examples:
- value: https://nde.nl/ontology/hc/org-unit/na-digital-preservation
description: URI for National Archives Digital Preservation Dept
has_or_had_label: # was: unit_name
required: true
range: string
examples:
- value: Digital Preservation Department
- value: Public Services Team
- value: Research and Documentation Division
has_or_had_type:
range: OrganizationalUnitType
description: |
Type classification of this organizational unit.
Uses OrganizationalUnitType class hierarchy.
Replaces unit_type slot per slot_fixes.yaml migration.
examples:
- value: DEPARTMENT
- value: TEAM
parent_unit:
range: OrganizationalStructure
examples:
- value:
has_or_had_label: # was: unit_name (2026-01-18)
has_or_had_label: Collections Division
description: Parent of Acquisitions Dept
staff_count:
range: integer
examples:
- value: 12
description: 12 FTE in Digital Preservation Dept
has_or_had_staff_member:
range: PersonObservation
multivalued: true
inlined_as_list: true
examples:
- value:
- id: https://nde.nl/ontology/hc/person-obs/nl-na/john-doe/archivist-2015
person_name: John Doe
staff_role: ARCHIVIST
role_title: Digital Preservation Manager
description: Staff member in Digital Preservation Department
has_or_had_managed_collection:
range: CustodianCollection
multivalued: true
inlined_as_list: true
examples:
- value:
- id: https://nde.nl/ontology/hc/collection/rm-dutch-paintings
has_or_had_label: # was: collection_name (2026-01-18)
has_or_had_label: Dutch Golden Age Paintings
has_or_had_type: collection_name
extent: 1,200 objects
description: Collection managed by Paintings Department
located_at:
range: AuxiliaryPlace
multivalued: true
inlined_as_list: true
examples:
- value:
- place_name: Depot Amersfoort
auxiliary_place_type: STORAGE_FACILITY
description: Organizational unit located at off-site storage
contact_point:
range: string
examples:
- value: digitization@nationalarchives.nl
- value: https://nationalarchives.nl/services/reading-room
temporal_extent: # was: valid_from + valid_to - migrated per Rule 53
description: |
Validity period using CIDOC-CRM TimeSpan.
MIGRATED from valid_from + valid_to per slot_fixes.yaml (Rule 53).
range: TimeSpan
inlined: true
required: false
examples:
- value:
begin_of_the_begin: '2015-01-01'
description: Digital Preservation Dept founded 2015
- value:
begin_of_the_begin: '2015-01-01'
end_of_the_end: '2020-12-31'
description: Unit active 2015-2020
refers_to_custodian:
required: true
range: Custodian
examples:
- value:
hc_id: https://nde.nl/ontology/hc/cust/national-archives
description: Unit belongs to National Archives
comments:
- OrganizationalStructure models INFORMAL operational units
- GovernanceStructure models FORMAL legal structure
- Both use org:OrganizationalUnit but at different levels
- Units can be nested via parent_unit (hierarchical structure)
- Temporal validity tracks organizational changes
- NOT for legally registered sub-organizations (use CustodianLegalStatus)
- 'NEW: located_at links organizational units to AuxiliaryPlace locations (optional)'
- Enables tracking which departments/teams operate at which physical sites
examples:
- value:
id: https://nde.nl/ontology/hc/org-unit/na-digital-pres
has_or_had_label: # was: unit_name (2026-01-18)
has_or_had_label: Digital Preservation Department
has_or_had_type: DEPARTMENT
staff_count: 15
contact_point: digipres@nationalarchives.nl
temporal_extent: # was: valid_from (2026-01-18)
begin_of_the_begin: '2010-01-01'
refers_to_custodian:
hc_id: https://nde.nl/ontology/hc/cust/national-archives-nl
description: Digital preservation department example
- value:
id: https://nde.nl/ontology/hc/org-unit/rijks-conservation
has_or_had_label: # was: unit_name (2026-01-18)
has_or_had_label: Conservation Lab
has_or_had_type: LAB
parent_unit:
has_or_had_label: # was: unit_name (2026-01-18)
has_or_had_label: Collections Care Division
staff_count: 8
temporal_extent: # was: valid_from (2026-01-18)
begin_of_the_begin: '1885-07-13'
refers_to_custodian:
hc_id: https://nde.nl/ontology/hc/cust/national-archives-nl
description: Conservation lab with parent division example
- value:
id: https://nde.nl/ontology/hc/org-unit/rijks-conservation
has_or_had_label: # was: unit_name (2026-01-18)
has_or_had_label: Conservation Lab
has_or_had_type: LAB
parent_unit:
has_or_had_label: # was: unit_name (2026-01-18)
has_or_had_label: Collections Care Division
description: Painting, paper, and textile conservation
staff_count: 8
temporal_extent: # was: valid_from (2026-01-18)
begin_of_the_begin: '1885-07-13'
refers_to_custodian:
hc_id: https://nde.nl/ontology/hc/cust/rijksmuseum
description: Museum conservation lab with parent division