glam/schemas/20251121/linkml/modules/classes/StaffRole.yaml
2025-12-23 13:27:35 +01:00

286 lines
11 KiB
YAML

# Staff Role Base Class
# Base class for all official staff role/job title classifications in heritage institutions
#
# CRITICAL CONCEPTUAL NOTE:
# These classes represent OFFICIAL JOB APPELLATIONS/TITLES - the formal designation
# assigned to a position. The ACTUAL DE FACTO WORK performed by an individual may
# differ from or extend beyond these classifications.
#
# Example: A "Curator" by title may also perform collections management, research,
# education, and administrative duties not captured by the formal title alone.
#
# PiCo Integration:
# Staff roles are observed via PersonObservation and linked to staff members.
# A person may hold multiple roles simultaneously or over time.
id: https://nde.nl/ontology/hc/class/StaffRole
name: staff_role_class
title: Staff Role Base Class
prefixes:
linkml: https://w3id.org/linkml/
schema: http://schema.org/
org: http://www.w3.org/ns/org#
prov: http://www.w3.org/ns/prov#
dcterms: http://purl.org/dc/terms/
pico: https://personsincontext.org/model#
wd: http://www.wikidata.org/entity/
imports:
- linkml:types
- ../metadata
- ../slots/description
- ../slots/martyred
- ../slots/deceased
- ../slots/date_of_death
- ../slots/circumstances_of_death
- ../slots/typical_domains
- ../slots/temporal_extent
- ./TimeSpan
classes:
StaffRole:
class_uri: org:Role
abstract: true
description: |
Abstract base class for official staff role/job title classifications in heritage institutions.
**CRITICAL: FORMAL TITLE vs DE FACTO WORK**
These classes represent OFFICIAL JOB APPELLATIONS/TITLES - the formal designation
assigned to a position by the institution. This is the title that appears on:
- Employment contracts
- Business cards
- Organizational charts
- HR systems
- Official correspondence
**The ACTUAL DE FACTO WORK performed may differ or extend beyond these classifications.**
| Aspect | Official Title (This Class) | De Facto Work (PersonObservation) |
|--------|----------------------------|-----------------------------------|
| **Nature** | Formal job appellation | Actual tasks and responsibilities |
| **Scope** | Narrow, defined by HR | Often broader, cross-functional |
| **Stability** | Changes with promotion/reassignment | Evolves with projects and needs |
| **Documentation** | Contract, org chart | Work logs, project records |
**Examples of Title vs Reality**:
- **Title**: "Curator" → **Reality**: Also does collections management, grant writing, public speaking
- **Title**: "Archivist" → **Reality**: Also trains volunteers, manages digitization, writes blog posts
- **Title**: "IT Specialist" → **Reality**: Also manages digital preservation, trains staff, procures equipment
- **Title**: "Librarian" → **Reality**: Also curates exhibitions, teaches workshops, manages social media
**Multi-Role Handling**:
Staff may hold multiple official roles simultaneously:
- A person may be both "Curator" AND "Department Head"
- A person may be "Researcher" during 50% appointment AND "Educator" for 50%
- Roles may overlap in time with different temporal extents
Each role is captured as a separate PersonObservation record with its own temporal bounds.
**Ontology Alignment**:
- org:Role - W3C Organization Ontology role concept
- schema:Role - Schema.org role (for structured values)
- schema:roleName - The name of the role
- pico:PersonObservation - PiCo pattern for role observations
**Subclasses**:
Specific role types inherit from this base class:
- Curatorial: Curator, CollectionsManager
- Conservation: Conservator
- Archival: Archivist, RecordsManager
- Library: Librarian
- Digital: DigitalPreservationSpecialist, DigitizationSpecialist, DataManager, etc.
- Education: Educator, PublicEngagementSpecialist
- Governance: Chairperson, ViceChairperson, Secretary, Treasurer, BoardMember
- Leadership: Director, DeputyDirector, DepartmentHead
- Research: Researcher, ResearcherInResidence, Historian, Genealogist, OralHistorian
- Technical: FacilitiesManager, ITSpecialist, FrontendDeveloper, BackendDeveloper, etc.
- Support: SecurityGuard, Janitor, Cleaner, Receptionist, TourGuide, etc.
- Creative: ArtistInResidence
- External: Consultant, LegalConsultant, Lawyer, Volunteer, NewsletterEditor, EventCoordinator
exact_mappings:
- org:Role
- schema:Role
close_mappings:
- pico:PersonObservation
- schema:Occupation
related_mappings:
- schema:JobPosting
- schema:EmployeeRole
slots:
- role_id
- role_name
- role_name_local
- role_category
- description
- common_variants
- typical_domains
- typical_responsibilities
- requires_qualification
- temporal_extent
- deceased
- martyred
- date_of_death
- circumstances_of_death
slot_usage:
role_id:
identifier: true
required: true
description: Unique identifier for this role type
role_name:
required: true
description: |
Official English name for this role type.
This is the canonical name used for cross-institutional comparison.
role_name_local:
required: false
description: |
Official name in the local language of the institution.
May differ from English canonical name.
Examples: "Conservator" (EN) = "Restaurator" (NL) = "Restaurateur" (FR)
role_category:
required: false
description: |
High-level category for grouping related roles.
Values: CURATORIAL, CONSERVATION, ARCHIVAL, LIBRARY, DIGITAL, EDUCATION,
GOVERNANCE, LEADERSHIP, RESEARCH, TECHNICAL, SUPPORT, CREATIVE, EXTERNAL
deceased:
required: false
description: |
Boolean flag indicating that the person holding this role has died.
Set to true when the staff member is no longer living, regardless
of the cause of death.
martyred:
required: false
description: |
Boolean flag indicating that the person holding this role was martyred.
Indicates death resulting from armed conflict, persecution, or violence
related to their heritage work or cultural identity.
Examples: Cultural heritage workers killed during conflicts,
librarians and archivists targeted for their work.
When true, deceased is implicitly also true.
date_of_death:
required: false
description: |
Time span capturing when the person holding this role died.
Uses CIDOC-CRM E52_Time-Span fuzzy temporal bounds when exact
date is not known.
circumstances_of_death:
required: false
description: |
Description of the circumstances surrounding the death.
Particularly relevant for martyred information workers where
documenting the context (conflict, attack, persecution) is
important for historical record.
comments:
- "Abstract base class - use specific subclasses (Curator, Archivist, etc.)"
- "Represents OFFICIAL JOB TITLES, not de facto work performed"
- "Actual work may differ or extend beyond formal title classification"
- "A person may hold multiple roles simultaneously"
- "Each role observation has independent temporal extent"
- "Links to PersonObservation via role_type slot"
- "deceased/martyred slots track vital status of staff member holding this role"
- "martyred flag specifically for information workers killed due to conflict or persecution"
- "date_of_death uses TimeSpan for fuzzy temporal bounds when exact date unknown"
see_also:
- "https://www.w3.org/TR/vocab-org/#class-role"
- "https://schema.org/Role"
- "https://github.com/FICLIT/PiCo"
slots:
role_id:
description: Unique identifier for this staff role
range: uriorcurie
slot_uri: schema:identifier
role_name:
description: |
Official English name for this role type.
Used as canonical name for cross-institutional comparison and queries.
range: string
slot_uri: schema:roleName
role_name_local:
description: |
Official name in local language(s).
Maps to language-tagged literals in RDF.
Example: {"nl": "Conservator", "de": "Restaurator", "fr": "Restaurateur"}
range: string
multivalued: true
slot_uri: schema:alternateName
role_category:
description: |
High-level category for grouping related roles.
Enables filtering and analysis by role family.
range: RoleCategoryEnum
slot_uri: schema:category
common_variants:
description: |
Common variant titles that map to this role.
Used for title normalization and matching.
Example for Curator: ["Senior Curator", "Assistant Curator", "Chief Curator"]
range: string
multivalued: true
slot_uri: schema:alternateName
typical_responsibilities:
description: |
Typical (but not exhaustive) responsibilities associated with this role.
Note: Actual responsibilities may vary by institution and individual.
range: string
multivalued: true
slot_uri: schema:responsibilities
requires_qualification:
description: |
Common qualifications or certifications for this role.
Not always required but frequently expected.
Example for Conservator: ["MA/MSc Conservation", "AIC membership"]
range: string
multivalued: true
slot_uri: schema:qualifications
enums:
RoleCategoryEnum:
description: High-level categories for staff role classification
permissible_values:
CURATORIAL:
description: Roles focused on collections, exhibitions, and scholarly interpretation
CONSERVATION:
description: Roles focused on preservation and restoration of heritage objects
ARCHIVAL:
description: Roles focused on archival management, appraisal, and description
LIBRARY:
description: Roles focused on library services, cataloging, and reference
DIGITAL:
description: Roles focused on digitization, digital preservation, data management
EDUCATION:
description: Roles focused on public education, outreach, and engagement
GOVERNANCE:
description: Board and committee roles in associations, cooperatives, and societies
LEADERSHIP:
description: Executive and management roles
RESEARCH:
description: Roles focused on scholarly research and fellowship programs
TECHNICAL:
description: Roles focused on IT, facilities, and technical operations
SUPPORT:
description: Roles supporting daily operations (security, cleaning, reception)
CREATIVE:
description: Roles for creative practitioners (artists, designers)
EXTERNAL:
description: External roles (consultants, volunteers, legal advisors)