Semantius Logo
HCMJune 27, 2026

Core Worker Record

The core worker module is where every employee profile lives: identity, status, manager, position, org unit, and the employment contracts that bind them. Capture each worker from pre-hire through active employment to termination, with personal-content fields protected by the access controls a workforce of record requires. Keep contracts and core attributes current and let downstream systems read from a single trusted source. When a worker is hired, promoted, or leaves, this module is the event that triggers payroll, access provisioning, benefits, and asset recall, so the data here stays clean and the handoffs stay reliable.

Use the Core Worker Record semantic blueprint

/semantius-admin use the architect, analyst and modeler skills to update the semantius platform with the model specified in https://www.semantius.com/blueprints/hcm-core-worker-semantic-blueprint.md

Entity summary

Name data_object Description
Emergency Contacts emergency_contacts People to contact in an emergency for a worker, with priority order and relationship. Holds personal data on third parties.
Employee Dependents employee_dependents Spouses, children, and other dependents of a worker, used by benefits administration for eligibility and beneficiary designation.
Employees employees Canonical records of people currently or formerly employed, carrying identity, employment metadata, and links to position, manager, and org unit.
Employment Contracts employment_contracts Contractual terms of employment: contract type, start and end dates, jurisdiction, working hours, notice period, and references to the signed document.
Employment Events employment_events Lifecycle events for an employee, such as hire, promotion, transfer, leave, comp change, and termination. The audit history of an employment.
National IDs national_ids Government-issued identity numbers for a worker, such as social security or national insurance numbers, held with restricted access and validity dates.
Work Eligibility Documents work_eligibility_documents Right-to-work evidence for a worker such as a visa or work permit, effective-dated with a tracked expiry, jurisdiction-conditional and access-restricted.
Worker Addresses worker_addresses Home, work, and mailing addresses for a worker, effective-dated and typed by purpose, supporting multi-jurisdiction formats.
Locations locations Physical or organizational locations referenced across the system, used to place and group other records.
Cost Centers cost_centers Organizational units for cost allocation, with code, manager, hierarchy, and currency, driving variance and departmental reporting.
Contingent Workers contingent_workers Non-employee resources such as contractors, agency staff, consultants, and interns, with supplier, role, rate, and end date.
MDM Source Records source_records Raw records pulled from source systems before match and merge, preserving origin and source identifier for lineage.
Onboarding Document Collections onboarding_document_collections Paperwork collected from a new hire during onboarding, such as tax and eligibility forms, with signature state and e-signature envelope references.
Pay Slips pay_slips Per-employee per-cycle gross-to-net pay statements, showing earnings, deductions, contributions, withholdings, net pay, and year-to-date totals.
People KPIs people_kpis Calculated workforce metrics such as time-to-fill, attrition, retention, and cost-per-hire, derived from HR, recruiting, learning, and payroll event streams.
Project Assignments project_assignments Allocations of a worker to a project, with role, bill rate, cost rate, planned hours, and period, driving utilization and availability reporting.
Project Resource Allocations project_resource_allocations Forward-looking plans committing resources to projects, with skill, planned utilization, and effective period, distinct from executed assignments.
Resource Skill Inventories resource_skill_inventories Inventories of skills and competencies across the resource base, with proficiency levels, used to forecast utilization.
Users users Platform users referenced as assignees, authors, approvers, and creators across records.
flowchart TD
  classDef master fill:#d4f4dd,stroke:#27ae60,color:#0b3d20;
  classDef embedded_master fill:#fff4cc,stroke:#c79100,color:#5b4500;
  classDef contributor fill:#cfe8ff,stroke:#1976d2,color:#0d3a66;
  classDef consumer fill:#e8def8,stroke:#7b1fa2,color:#3a155d;
  locations["Locations"]
  cost_centers["Cost Centers"]
  onboarding_document_collections["Onboarding Document Collections"]
  employees["Employees"]
  employment_contracts["Employment Contracts"]
  employment_events["Employment Events"]
  contingent_workers["Contingent Workers"]
  people_kpis["People KPIs"]
  users["Users"]
  project_assignments["Project Assignments"]
  project_resource_allocations["Project Resource Allocations"]
  resource_skill_inventories["Resource Skill Inventories"]
  emergency_contacts["Emergency Contacts"]
  work_eligibility_documents["Work Eligibility Documents"]
  national_ids["National IDs"]
  worker_addresses["Worker Addresses"]
  employee_dependents["Employee Dependents"]
  pay_slips["Pay Slips"]
  source_records["MDM Source Records"]
  employees -->|"finalized by"| onboarding_document_collections
  users -->|"receives pay slips"| pay_slips
  contingent_workers -->|"converts_to"| employees
  users -->|"publishes"| people_kpis
  employees -->|"signs"| employment_contracts
  employees -->|"generates"| employment_events
  employees -->|"is_linked_to"| users
  users -->|"approves"| employment_contracts
  users -->|"records"| employment_events
  users -->|"owns"| cost_centers
  users -->|"sponsors"| contingent_workers
  employment_events -->|"feeds"| people_kpis
  users -->|"approves"| onboarding_document_collections
  users -->|"manages"| contingent_workers
  contingent_workers -->|"reviewed_against"| employees
  locations -->|"rolls_up_to"| locations
  locations -->|"houses"| users
  project_assignments -->|"requires_skills_from"| resource_skill_inventories
  project_resource_allocations -->|"confirms_into"| project_assignments
  users -->|"staffed_on"| project_assignments
  users -->|"has_skill_profile"| resource_skill_inventories
  users -->|"allocates"| project_resource_allocations
  employees -->|"has"| emergency_contacts
  employees -->|"has"| work_eligibility_documents
  employees -->|"has"| national_ids
  employees -->|"has"| worker_addresses
  users -->|"verifies"| work_eligibility_documents
  employees -->|"has"| employee_dependents
  class locations embedded_master;
  class cost_centers contributor;
  class onboarding_document_collections consumer;
  class employees master;
  class employment_contracts master;
  class employment_events master;
  class contingent_workers consumer;
  class people_kpis consumer;
  class users consumer;
  class project_assignments consumer;
  class project_resource_allocations consumer;
  class resource_skill_inventories consumer;
  class emergency_contacts master;
  class work_eligibility_documents master;
  class national_ids master;
  class worker_addresses master;
  class employee_dependents master;
  class pay_slips consumer;
  class source_records consumer;
  style locations stroke-dasharray:5 5;
  style cost_centers stroke-dasharray:5 5;
  style onboarding_document_collections stroke-dasharray:5 5;
  style contingent_workers stroke-dasharray:5 5;
  style people_kpis stroke-dasharray:5 5;
  style project_assignments stroke-dasharray:5 5;
  style project_resource_allocations stroke-dasharray:5 5;
  style resource_skill_inventories stroke-dasharray:5 5;
  style emergency_contacts stroke-dasharray:5 5;
  style work_eligibility_documents stroke-dasharray:5 5;
  style national_ids stroke-dasharray:5 5;
  style worker_addresses stroke-dasharray:5 5;
  style employee_dependents stroke-dasharray:5 5;
  style pay_slips stroke-dasharray:5 5;
  style source_records stroke-dasharray:5 5;