glam/frontend/public/schemas/20251121/linkml/modules/classes/BranchOffice.yaml
kempersc 6da794ee38 feat: Introduce new slots and classes for enhanced heritage data modeling
- Added `has_or_had_place_of_birth` slot to capture structured birth place information with historical context.
- Introduced `has_or_had_quantity` slot for capturing quantified values with units and provenance.
- Created `has_or_had_service_area` slot to define geographic service areas for heritage custodians.
- Implemented `is_or_was_approximate` slot to indicate uncertainty in values (dates, quantities).
- Added `is_or_was_asserted_by` slot to track the agent responsible for assertions.
- Introduced `Asserter` class to model agents making assertions, including types like human, automated, and AI.
- Created `Quantity` class to represent quantified values with optional units and types.
- Added enums for `AsserterTypeEnum` and `QuantityTypeEnum` to standardize types of asserters and quantities.
- Archived outdated slots and replaced them with new structured alternatives following RiC-O conventions.
2026-01-14 16:54:10 +01:00

259 lines
11 KiB
YAML

id: https://nde.nl/ontology/hc/class/branch-office
name: branch_office_class
title: BranchOffice Class
imports:
- linkml:types
- ./ReconstructedEntity
- ./CustodianObservation
- ./ReconstructionActivity
- ../slots/has_or_had_description
- ../slots/has_or_had_identifier
- ../slots/has_or_had_label
# REMOVED - migrated to has_or_had_service_area (Rule 53)
# - ../slots/branch_service_area
- ../slots/has_or_had_service_area
- ./ServiceArea
# REMOVED - migrated to has_or_had_quantity (Rule 53)
# - ../slots/branch_staff_count
- ../slots/has_or_had_quantity
- ./Quantity
- ../enums/QuantityTypeEnum
- ../slots/has_local_collection
- ../slots/is_public_facing
- ../slots/operating_hour
- ../slots/services_offered
- ../slots/specificity_annotation
- ../slots/template_specificity
- ../slots/was_derived_from
- ../slots/was_generated_by
- ./SpecificityAnnotation
- ./TemplateSpecificityScores
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/
crm: http://www.cidoc-crm.org/cidoc-crm/
prov: http://www.w3.org/ns/prov#
skos: http://www.w3.org/2004/02/skos/core#
classes:
BranchOffice:
is_a: ReconstructedEntity
class_uri: org:Site
description: "Regional or satellite office of a heritage custodian organization.\n\n**DEFINITION**:\n\nA BranchOffice\
\ is a secondary physical location where a heritage custodian\nmaintains operational presence, typically providing services\
\ to a specific\ngeographic area or community. Unlike the main headquarters, branch offices\nusually have more limited\
\ scope of activities.\n\n**W3C ORG ALIGNMENT**:\n\n`org:Site` - \"An office or other premise at which the organization\
\ is located.\"\n\nBranchOffice specializes org:Site for heritage custodian branch locations:\n- Regional archives serving\
\ provincial communities\n- Satellite library branches in neighborhoods\n- Museum outposts or study centers\n\n**DISTINCTION\
\ FROM OTHER AUXILIARY PLACE TYPES**:\n\n| Type | Purpose | Example |\n|------|---------|---------|\n| **BranchOffice**\
\ | Service delivery to geographic area | Regional archive office |\n| AdministrativeOffice | Non-public administrative\
\ functions | Finance department building |\n| ExhibitionSpace | Display of collections | Gallery annex |\n| ResearchCenter\
\ | Research and conservation | Conservation lab |\n\n**TYPICAL CHARACTERISTICS**:\n\n- **Public-facing**: Serves visitors,\
\ researchers, patrons\n- **Geographic coverage**: Serves specific region/community\n- **Core services**: Reference,\
\ access, programming (subset of main)\n- **Staff presence**: Permanent staff assignment\n- **Collection subset**: May\
\ hold locally-relevant materials\n\n**USE CASES**:\n\n1. **Regional Archive Branches**:\n - Noord-Hollands Archief\
\ Zaanstreek-Waterland branch\n - Serves researchers in Zaandam area\n - Holds local municipal records\n\n2. **Library\
\ Satellite Locations**:\n - University library branch at satellite campus\n - Public library neighborhood branches\n\
\n3. **Museum Study Centers**:\n - Off-site study/research center for scholars\n - Rijksmuseum Schiphol (airport\
\ exhibition space)\n\n**Example - Regional Archive Branch**:\n```yaml\nBranchOffice:\n has_or_had_identifier: \"https://nde.nl/ontology/hc/aux/nha-zaanstreek-branch\"\
\n has_or_had_label: \"Noord-Hollands Archief - Zaanstreek-Waterland\"\n has_or_had_description: |\n Regional\
\ branch serving Zaanstreek-Waterland area.\n Holds municipal records from Zaandam, Wormerland, Purmerend.\n Open\
\ to researchers Tuesday-Thursday.\n branch_service_area: \"Zaanstreek-Waterland region\"\n is_public_facing: true\n\
\ services_offered:\n - \"Archival research access\"\n - \"Genealogical consultations\"\n - \"Local history\
\ reference\"\n```\n"
exact_mappings:
- org:Site
close_mappings:
- schema:Place
- schema:LocalBusiness
- crm:E27_Site
related_mappings:
- org:OrganizationalUnit
- schema:branch
slots:
- has_or_had_description
- has_or_had_identifier
- has_or_had_label
# REMOVED - migrated to has_or_had_service_area (Rule 53)
# - branch_service_area
- has_or_had_service_area
# REMOVED - migrated to has_or_had_quantity (Rule 53)
# - branch_staff_count
- has_or_had_quantity
- has_local_collection
- is_public_facing
- operating_hour
- services_offered
- specificity_annotation
- template_specificity
- was_derived_from
- was_generated_by
slot_usage:
has_or_had_identifier:
range: uriorcurie
required: true
identifier: true
description: >-
Unique identifier for this branch office.
MIGRATED from branch_office_id (2026-01-14) per Rule 53.
examples:
- value: https://nde.nl/ontology/hc/aux/nha-zaanstreek-branch
description: Noord-Hollands Archief regional branch
has_or_had_label:
range: string
required: true
multivalued: false
description: >-
Name of this branch office.
MIGRATED from branch_office_name (2026-01-14) per Rule 53.
Typically includes parent organization name + branch location/function.
examples:
- value: Noord-Hollands Archief - Zaanstreek-Waterland
description: Regional archive branch
- value: Rijksmuseum Schiphol
description: Airport exhibition branch
- value: Universiteitsbibliotheek Science Park
description: University library satellite
has_or_had_description:
range: string
description: >-
Description of this branch office, including services offered,
target audience, and distinguishing features.
MIGRATED from branch_office_description (2026-01-15) per Rule 53.
examples:
- value: Regional branch serving Zaanstreek-Waterland area. Holds municipal records from Zaandam, Wormerland, Purmerend.
Open to researchers Tuesday-Thursday.
description: Archive branch description
# REMOVED - migrated to has_or_had_service_area (Rule 53)
# branch_service_area:
# range: string
# examples:
# - value: Zaanstreek-Waterland region
# description: Regional coverage
# - value: Amsterdam Schiphol Airport travelers
# description: Specific community served
has_or_had_service_area:
range: ServiceArea
inlined: true
description: >-
Geographic area or community served by this branch.
MIGRATED from branch_service_area (Rule 53) - changed from string to
ServiceArea class for richer geographic modeling.
examples:
- value:
service_area_id: https://nde.nl/ontology/hc/servicearea/zaanstreek-waterland
service_area_name: Zaanstreek-Waterland region
service_area_type: REGIONAL
description: Regional coverage as structured ServiceArea
is_public_facing:
range: boolean
required: true
ifabsent: 'true'
examples:
- value: true
description: Public-facing branch
services_offered:
range: string
multivalued: true
examples:
- value: Archival research access
description: Core research service
- value: Genealogical consultations
description: Specialized service
- value: Local history reference
description: Reference service
operating_hour:
range: string
examples:
- value: Tu-Th 09:00-17:00
description: Limited weekday hours
# REMOVED - migrated to has_or_had_quantity (Rule 53)
# branch_staff_count:
# range: integer
# examples:
# - value: 3
# description: Small branch staff
has_or_had_quantity:
range: Quantity
inlined: true
description: >-
Quantified values associated with this branch office (e.g., staff count).
MIGRATED from branch_staff_count (Rule 53) - changed from integer to
Quantity class for richer measurement context (units, dates, estimates).
examples:
- value:
quantity_value: 3
quantity_type: STAFF_COUNT
quantity_unit: FTE
has_or_had_description: Staff assigned to this branch
quantity_date: '2025-01-01'
is_estimate: false
description: Branch staff count as structured Quantity
has_local_collection:
range: boolean
examples:
- value: true
description: Branch holds local municipal records
was_derived_from:
range: CustodianObservation
multivalued: true
required: false
was_generated_by:
range: ReconstructionActivity
required: false
comments:
- BranchOffice models regional/satellite locations of heritage custodians
- Distinguished from AdministrativeOffice by public-facing nature
- W3C ORG org:Site specialized for branch locations
- Typically serves specific geographic area or community
- May hold local collection subset relevant to service area
see_also:
- https://www.w3.org/TR/vocab-org/#org:Site
- https://schema.org/LocalBusiness
- https://schema.org/branch
examples:
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/aux/nha-zaanstreek-branch
has_or_had_label: Noord-Hollands Archief - Zaanstreek-Waterland
has_or_had_description: Regional branch serving Zaanstreek-Waterland area. Holds municipal records from Zaandam,
Wormerland, Purmerend.
has_or_had_service_area:
service_area_id: https://nde.nl/ontology/hc/servicearea/zaanstreek-waterland
service_area_name: Zaanstreek-Waterland region
service_area_type: REGIONAL
is_public_facing: true
services_offered:
- Archival research access
- Genealogical consultations
- Local history reference
operating_hours: Tu-Th 09:00-17:00
has_or_had_quantity:
quantity_value: 3
quantity_type: STAFF_COUNT
quantity_unit: FTE
has_or_had_description: Staff assigned to Zaanstreek-Waterland branch
has_local_collection: true
description: Regional archive branch
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/aux/rijksmuseum-schiphol
has_or_had_label: Rijksmuseum Schiphol
has_or_had_description: Exhibition space at Schiphol Airport featuring rotating highlights from the Rijksmuseum
collection. Free admission.
has_or_had_service_area:
service_area_id: https://nde.nl/ontology/hc/servicearea/schiphol-travelers
service_area_name: Amsterdam Schiphol Airport travelers
service_area_type: COMMUNITY
is_public_facing: true
services_offered:
- Exhibition viewing
- Museum shop
operating_hours: Daily 07:00-20:00
has_or_had_quantity:
quantity_value: 5
quantity_type: STAFF_COUNT
quantity_unit: FTE
has_or_had_description: Staff assigned to Schiphol branch
has_local_collection: false
description: Museum airport branch