glam/schemas/20251121/linkml/modules/classes/OrganizationBranch.yaml
2025-11-25 12:48:07 +01:00

500 lines
18 KiB
YAML

# Heritage Organization Branch Class
# Represents formal organizational branches/sub-organizations of a heritage custodian
# W3C Org: org:Organization subclass for formal branches
id: https://nde.nl/ontology/hc/class/organization-branch
name: organization-branch-class
title: OrganizationBranch Class
imports:
- linkml:types
- ./Custodian
- ./CustodianObservation
- ./ReconstructionActivity
- ./OrganizationalStructure
- ./TimeSpan
- ../enums/OrganizationBranchTypeEnum
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
org: http://www.w3.org/ns/org#
dcterms: http://purl.org/dc/terms/
prov: http://www.w3.org/ns/prov#
skos: http://www.w3.org/2004/02/skos/core#
foaf: http://xmlns.com/foaf/0.1/
classes:
OrganizationBranch:
class_uri: org:OrganizationalUnit
description: >-
Formal organizational branch or sub-organization of a heritage custodian
that operates at a specific physical location (AuxiliaryPlace).
**CRITICAL DISTINCTION FROM OrganizationalStructure**:
| OrganizationBranch | OrganizationalStructure |
|-------------------|------------------------|
| **Formal** branches with administrative status | **Informal** operational units |
| Tied to PHYSICAL LOCATION (AuxiliaryPlace) | May or may not have fixed location |
| Semi-autonomous (may have own budget, staff) | Part of main organizational hierarchy |
| Examples: Regional archive, branch library | Examples: Department, team, division |
**W3C ORG ALIGNMENT**:
`org:OrganizationalUnit` - "An Organization such as a University Support Unit
which is part of some larger FormalOrganization and only has full recognition
within the context of that FormalOrganization."
Key properties:
- `org:unitOf` - links unit to parent organization
- `org:hasSite` - links organization to physical site
- `org:hasSubOrganization` - links to sub-branches
**THREE-TIER ORGANIZATIONAL MODEL**:
1. **Custodian** (hub): The main heritage institution
2. **OrganizationBranch** (formal sub-organization):
- Located at AuxiliaryPlace
- Semi-autonomous branch
3. **OrganizationalStructure** (informal units):
- Departments, teams within branch or main org
- Can be assigned to branch via has_operational_unit
**RELATIONSHIP PATTERN**:
```
Custodian (hub)
├── place_designation → CustodianPlace (main headquarters)
│ └── auxiliary_places → AuxiliaryPlace (branch sites)
│ └── hosts_branch → OrganizationBranch (THIS CLASS)
│ └── has_operational_unit → OrganizationalStructure
└── organizational_structure → OrganizationalStructure (main org units)
```
**USE CASES**:
1. **Regional Archive Branches**:
- National Archives → Regional Office Noord-Holland
- Regional office has own staff, reading room, collections
2. **University Library Branches**:
- Main library → Science Library → Medical Library
- Each branch at different campus location
3. **Museum Satellite Galleries**:
- Main museum → Contemporary Art Wing (off-site)
- Separate building, curated exhibitions
4. **Conservation/Research Centers**:
- Main institution → Conservation Lab (different building)
- Specialized facility with own staff
**Example - National Archives Branch**:
```yaml
AuxiliaryPlace:
place_name: "Regionaal Historisch Centrum Noord-Holland"
auxiliary_place_type: BRANCH_OFFICE
hosts_branch:
- branch_id: "https://nde.nl/ontology/hc/branch/na-rhc-noord-holland"
branch_name: "RHC Noord-Holland"
branch_type: REGIONAL_OFFICE
has_operational_unit:
- unit_name: "Reading Room Services"
- unit_name: "Digitization Team"
is_branch_of: "https://nde.nl/ontology/hc/nl-na"
```
**DISTINCTION FROM schema:branchOf**:
Schema.org `branchOf` links commercial branches (e.g., bank branches).
`org:unitOf` is more appropriate for heritage institutions as it:
- Models public sector organizational hierarchies
- Allows for semi-autonomous units
- Integrates with formal organizational structures
exact_mappings:
- org:OrganizationalUnit
close_mappings:
- schema:Organization
- foaf:Organization
related_mappings:
- org:subOrganizationOf
- schema:branchOf
- schema:department
slots:
- branch_id
- branch_name
- branch_type
- branch_description
- located_at
- has_operational_unit
- is_branch_of
- has_sub_branch
- branch_head
- staff_count
- contact_point
- valid_from
- valid_to
- temporal_extent
- was_derived_from
- was_generated_by
- refers_to_custodian
slot_usage:
branch_id:
slot_uri: dcterms:identifier
description: >-
Unique identifier for this organizational branch.
Format: URI following NDE Heritage Custodian ontology conventions.
range: uriorcurie
required: true
identifier: true
examples:
- value: "https://nde.nl/ontology/hc/branch/rm-schiphol-exhibition"
description: "Rijksmuseum Schiphol exhibition branch"
branch_name:
slot_uri: skos:prefLabel
description: >-
Official name of this organizational branch.
SKOS: prefLabel for preferred name.
This is the formal name of the branch as used in official documents.
range: string
required: true
examples:
- value: "Rijksmuseum Schiphol"
description: "Airport branch name"
- value: "Conservation Division - Amersfoort"
description: "Off-site conservation facility"
branch_type:
slot_uri: dcterms:type
description: >-
Type of organizational branch using OrganizationBranchTypeEnum.
Types include:
- REGIONAL_OFFICE: Geographic regional branch
- BRANCH_LIBRARY: Library at satellite location
- SATELLITE_GALLERY: Museum exhibition space
- CONSERVATION_LAB: Specialized conservation facility
- DIGITIZATION_CENTER: Digital production facility
- RESEARCH_CENTER: Research/scholarly unit
- EDUCATION_CENTER: Education/outreach facility
- ADMINISTRATIVE_OFFICE: Non-public administration
- STORAGE_MANAGEMENT: Collection storage operations
- EXHIBITION_SPACE: Exhibition-focused branch
Dublin Core: type for classification.
range: OrganizationBranchTypeEnum
required: true
examples:
- value: "EXHIBITION_SPACE"
description: "Exhibition branch type"
- value: "CONSERVATION_LAB"
description: "Conservation facility type"
branch_description:
slot_uri: dcterms:description
description: >-
Free-text description of this organizational branch.
Include:
- Mission/purpose of branch
- Services provided
- Collections managed
- Relationship to main organization
range: string
examples:
- value: "Small exhibition space at Schiphol Airport featuring rotating highlights from the Rijksmuseum collection."
description: "Branch purpose description"
located_at:
slot_uri: org:hasSite
description: >-
Physical location (AuxiliaryPlace) where this branch operates.
W3C ORG: org:hasSite links organization to physical site.
This is the inverse of AuxiliaryPlace.hosts_branch:
- OrganizationBranch → located_at → AuxiliaryPlace
- AuxiliaryPlace → hosts_branch → OrganizationBranch
A branch may operate at multiple locations (rare but possible).
range: AuxiliaryPlace
multivalued: true
inlined_as_list: true
examples:
- value: "https://nde.nl/ontology/hc/aux-place/rijksmuseum-schiphol"
description: "Airport location"
has_operational_unit:
slot_uri: org:hasUnit
description: >-
OrganizationalStructure units (departments, teams) within this branch.
W3C ORG: org:hasUnit links organization to sub-units.
Branches can have their own internal departmental structure:
- Branch → Reading Room Services (team)
- Branch → Digitization Team
- Branch → Public Programs Department
These are INFORMAL units within the formal branch.
range: OrganizationalStructure
multivalued: true
inlined_as_list: true
examples:
- value:
unit_name: "Exhibition Curation Team"
unit_type: TEAM
description: "Team within branch"
is_branch_of:
slot_uri: org:unitOf
description: >-
Parent Custodian or OrganizationBranch that this branch belongs to.
W3C ORG: org:unitOf - "Indicates an Organization of which this Unit is a part"
Can link to:
- Custodian (direct branch of main institution)
- OrganizationBranch (sub-branch of another branch)
Enables hierarchical branch structures:
- National Archives → Regional Branch → Local Office
range: uriorcurie
required: true
examples:
- value: "https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804"
description: "Branch of Rijksmuseum"
has_sub_branch:
slot_uri: org:hasSubOrganization
description: >-
Sub-branches of this organizational branch.
W3C ORG: org:hasSubOrganization for hierarchical organization.
Inverse of is_branch_of when linking branches to sub-branches.
range: OrganizationBranch
multivalued: true
inlined_as_list: true
examples:
- value:
branch_name: "Schiphol Terminal 2 Kiosk"
description: "Sub-branch of Schiphol exhibition"
branch_head:
slot_uri: org:headOf
description: >-
Person heading this branch (if known).
W3C ORG: org:headOf - links person to headed organization.
Can be name string or PersonObservation reference.
range: string
examples:
- value: "Dr. Maria van der Berg"
description: "Branch director name"
staff_count:
slot_uri: org:hasMember
description: >-
Approximate number of staff (FTE) working at this branch.
W3C ORG: hasMember property (count rather than list).
range: integer
examples:
- value: 8
description: "Small branch staff"
contact_point:
slot_uri: schema:contactPoint
description: >-
Contact information for this branch.
Schema.org: contactPoint for organizational contact.
Can be email, phone, or URL.
range: string
examples:
- value: "schiphol@rijksmuseum.nl"
description: "Branch email"
valid_from:
slot_uri: schema:validFrom
description: >-
Date when this branch was established.
Track when branches opened, organizations restructured.
range: date
examples:
- value: "2002-10-01"
description: "Branch opened October 2002"
valid_to:
slot_uri: schema:validThrough
description: >-
Date when this branch was closed or merged.
NULL if still active.
range: date
examples:
- value: "2020-03-15"
description: "Branch closed March 2020"
temporal_extent:
slot_uri: crm:P4_has_time-span
description: >-
Temporal period during which this branch was operational.
CIDOC-CRM: P4_has_time-span for fuzzy temporal boundaries.
range: TimeSpan
examples:
- value:
begin_of_the_begin: "2000-01-01"
end_of_the_begin: "2002-12-31"
description: "Established sometime 2000-2002"
was_derived_from:
slot_uri: prov:wasDerivedFrom
description: >-
CustodianObservation(s) documenting this branch.
PROV-O: wasDerivedFrom for observation provenance.
range: CustodianObservation
multivalued: true
required: false
was_generated_by:
slot_uri: prov:wasGeneratedBy
description: >-
ReconstructionActivity that generated this branch record.
PROV-O: wasGeneratedBy for generation activity.
range: ReconstructionActivity
required: false
refers_to_custodian:
slot_uri: org:unitOf
description: >-
The Custodian hub that this branch is part of.
W3C ORG: org:unitOf - links unit back to parent organization.
All branches MUST reference the main custodian hub,
even if they are sub-branches of another branch.
range: Custodian
required: true
examples:
- value: "https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804"
description: "Rijksmuseum custodian hub"
comments:
- "OrganizationBranch models FORMAL branches with administrative status"
- "OrganizationalStructure models INFORMAL operational units"
- "Branches are LOCATED AT AuxiliaryPlace (physical sites)"
- "Branches CONTAIN OrganizationalStructure (internal departments/teams)"
- "W3C ORG org:OrganizationalUnit for semi-autonomous sub-organizations"
- "Temporal validity tracks branch lifecycle (opened/closed/merged)"
- "Hierarchical: branches can have sub-branches via has_sub_branch"
see_also:
- "https://www.w3.org/TR/vocab-org/#org:OrganizationalUnit"
- "https://www.w3.org/TR/vocab-org/#org:hasSite"
- "https://www.w3.org/TR/vocab-org/#org:unitOf"
examples:
- value:
branch_id: "https://nde.nl/ontology/hc/branch/rm-schiphol"
branch_name: "Rijksmuseum Schiphol"
branch_type: EXHIBITION_SPACE
branch_description: "Small exhibition space at Schiphol Airport featuring rotating highlights from the collection."
located_at:
- "https://nde.nl/ontology/hc/aux-place/rijksmuseum-schiphol"
has_operational_unit:
- unit_name: "Exhibition Curation Team"
unit_type: TEAM
staff_count: 3
is_branch_of: "https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804"
staff_count: 8
contact_point: "schiphol@rijksmuseum.nl"
valid_from: "2002-10-01"
refers_to_custodian: "https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804"
description: "Rijksmuseum Schiphol exhibition branch"
- value:
branch_id: "https://nde.nl/ontology/hc/branch/rm-depot-operations"
branch_name: "Collection Storage Operations - Amersfoort"
branch_type: STORAGE_MANAGEMENT
branch_description: "Off-site collection storage facility managing overflow objects and art storage."
located_at:
- "https://nde.nl/ontology/hc/aux-place/rijksmuseum-depot-amersfoort"
has_operational_unit:
- unit_name: "Storage Management Team"
unit_type: TEAM
- unit_name: "Climate Control Monitoring"
unit_type: SERVICE
is_branch_of: "https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804"
staff_count: 12
valid_from: "1995-06-01"
refers_to_custodian: "https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804"
description: "Rijksmuseum off-site storage operations branch"
- value:
branch_id: "https://nde.nl/ontology/hc/branch/na-rhc-nh"
branch_name: "Regionaal Historisch Centrum Noord-Holland"
branch_type: REGIONAL_OFFICE
branch_description: "Regional archives center serving Noord-Holland province, providing reading room services and archival research support."
is_branch_of: "https://nde.nl/ontology/hc/nl-na"
staff_count: 25
valid_from: "2001-01-01"
refers_to_custodian: "https://nde.nl/ontology/hc/nl-na"
description: "Regional historical center branch of National Archives"
# Slot definitions (basic - detailed in class slot_usage)
slots:
branch_id:
description: Unique identifier for organizational branch
range: uriorcurie
branch_name:
description: Official branch name
range: string
branch_type:
description: Type of organizational branch
range: OrganizationBranchTypeEnum
branch_description:
description: Description of branch
range: string
located_at:
description: Physical location (AuxiliaryPlace) of branch
range: AuxiliaryPlace
has_operational_unit:
description: OrganizationalStructure units within branch
range: OrganizationalStructure
is_branch_of:
description: Parent organization (Custodian or OrganizationBranch)
range: uriorcurie
has_sub_branch:
description: Sub-branches of this branch
range: OrganizationBranch
branch_head:
description: Person heading this branch
range: string