kempersc/glam
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
glam/schemas/20251121/linkml/modules/classes/StaffRole.yaml
kempersc 626bd3a095 refactor(schemas): apply naming conventions to 261 class files 
- Apply Rule 39: RiC-O style hasOrHad*/isOrWas* for temporal slots
- Apply Rule 43: Singular noun convention (keywords → keyword)
- Update slot references to match renamed slot files
- Maintain schema integrity across all class definitions
2026-01-10 15:36:33 +01:00

270 lines
11 KiB
YAML
Raw Blame History

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_domain
- ../slots/temporal_extent
- ./TimeSpan
- ../slots/common_variant
- ../slots/requires_qualification
- ../slots/role_category
- ../slots/role_id
- ../slots/role_name
- ../slots/role_name_local
- ../slots/specificity_annotation
- ../slots/template_specificity
- ../slots/typical_responsibility
- ./SpecificityAnnotation
- ./TemplateSpecificityScores
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.
- 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:
- circumstances_of_death
- common_variant
- date_of_death
- deceased
- description
- martyred
- requires_qualification
- role_category
- role_id
- role_name
- role_name_local
- specificity_annotation
- template_specificity
- temporal_extent
- typical_domain
- typical_responsibility
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.\nIndicates death resulting from armed conflict, persecution,\
\ or violence\nrelated to their heritage work or cultural identity.\nExamples:\
\ Cultural heritage workers killed during conflicts, \nlibrarians and archivists\
\ targeted for their work.\nWhen true, deceased is implicitly also true.\n"
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.
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
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_variant:
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_responsibility:
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)
Reference in a new issue View git blame Copy permalink