@ontoboom/hr

A human-resources ontology covering the complete employee lifecycle — from job architecture and recruiting through employment, compensation, performance, learning, leave, and payroll.

Coverage

Org structure

• Organization — the employing legal entity.
• Department → Team hierarchy, each linked to a CostCenter.
• WorkLocation (office / remote / hybrid) with city and country.

Workforce types

• Employee — active employee with ID, start date, employment type, and status.
• Contractor — contingent worker with agency and contract dates.
• Alumni — former employee (termination date, reason, eligibility for rehire).

Job architecture

• JobFamily — a cluster of related roles (Engineering, Sales, Finance …).
• JobGrade — level / band (IC1–IC6, M1–M5, E1–E3 …) with salary band min / max.
• JobPosition — an approved headcount slot in a Department, tied to a JobGrade and JobFamily.

Recruiting pipeline

• JobRequisition — open headcount with status tracking.
• Candidate — person in the hiring pipeline (sourced, applied …).
• JobApplication — a Candidate's application to a Requisition.
• Interview — scheduled interview event with type, outcome, and interviewer.
• JobOffer — formal offer with base salary, expiry, and status.

Employment & compensation

• Employment — the active engagement record linking a Person to a JobPosition.
• Compensation — total package attached to an Employment.
• Salary — base salary with amount, currency, and effective date.
• Bonus — variable pay (performance / signing / retention / spot).
• EquityGrant — RSU / ISO / NSO / ESPP grant with vesting schedule.
• Benefit — employer benefit plan (health, dental, 401k, PTO …).
• BenefitEnrollment — an Employee's enrolment in a Benefit.

Performance management

• PerformanceCycle — annual / semi-annual / quarterly review cycle.
• PerformanceReview — individual review with overall rating and reviewer.
• Goal — OKR or KPI tied to an Employee and a PerformanceCycle.

Skills & learning

• Skill — a discrete skill or competency (technical / leadership / functional / language).
• SkillAssessment — an Employee's assessed level on a Skill.
• LearningCourse — a training course with format, duration, and mandatory flag.
• LearningEnrollment — an Employee's enrolment and completion record.

Leave

• LeavePolicy — leave type with entitlement and carry-over rules.
• LeaveRequest — individual leave request with dates, days, and approval status.

Payroll

• PayrollRun — a payroll processing cycle.
• Payslip — individual payslip with gross, net, deductions, and payment date.

SHACL highlights

• Employee.workEmail required; employeeId required.
• Employment.employmentStatus enumerated active | on-leave | terminated | retired.
• JobApplication.applicationStatus enumerated applied | screening | interview | offer | hired | rejected | withdrawn.
• PerformanceReview.reviewStatus enumerated draft | submitted | calibrated | acknowledged.
• LeaveRequest.requestStatus enumerated pending | approved | rejected | cancelled.
• PayrollRun.payrollFrequency enumerated weekly | bi-weekly | semi-monthly | monthly.
• All monetary amounts (salary, bonus, grant value, payslip amounts) are >= 0; currency fields match ^[A-Z]{3}$.

Forking

For a multi-entity group structure, extend Organization with Subsidiary and add a parentOrganization object property. For equity-heavy tech companies, add VestingSchedule as a class and link EquityGrant → VestingSchedule → VestingEvent.