Version: 1.0.0Documentation Index
Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
Use this file to discover all available pages before exploring further.
Last Updated: 2026-03-20
Spec: HR-03 Onboarding & Offboarding
Constitution Reference: Section 1.2 (Core Independence), Section 1.3 (Integration Patterns)
Overview
HR-03 manages employee onboarding and offboarding workflows. It publishes events to trigger IT-08 (IT Onboarding/Offboarding) workflows for IT provisioning and access revocation.Integration Points
Platform Foundation (PF) Dependencies
Required PF Features:- PF-10 (Notifications): Onboarding task reminders, offboarding completion alerts
- PF-11 (Document Management): Store onboarding documents, I-9 forms, agreements
- PF-04 (Audit Logging): Track onboarding/offboarding progress and completion
- FW (Forms & Workflow): Onboarding/offboarding workflow templates
Consumer Core Dependencies (Downstream)
Internal HR Features:- HR-01 (Employee Directory): Creates
hr_employeesrecord during onboarding - HR-02 (Credentialing): Onboarding checklist includes credential uploads
- IT-08 (IT Onboarding/Offboarding): IT provisioning and access revocation triggered via events
Event Contracts
Event: hr_onboarding_started
Publisher: HR (HR-03)Subscribers: IT-08 (IT Onboarding/Offboarding)
Status: 📝 Planned Purpose: Create IT provisioning instance when onboarding starts Trigger:
hr_onboarding_instances INSERT
Payload Schema:
Event: hr_onboarding_task_created
Publisher: HR (HR-03)Subscribers: IT-08 (IT Onboarding/Offboarding)
Status: 📝 Planned Purpose: Create IT task instance when onboarding task with category ‘it_setup’ is created Trigger:
hr_onboarding_task_instances INSERT (category: ‘it_setup’)
Payload Schema:
Event: hr_offboarding_started
Publisher: HR (HR-03)Subscribers: IT-08 (IT Onboarding/Offboarding)
Status: 📝 Planned Purpose: Create IT offboarding instance when offboarding starts Trigger:
hr_offboarding_instances INSERT
Payload Schema:
Event: hr_offboarding_task_created
Publisher: HR (HR-03)Subscribers: IT-08 (IT Onboarding/Offboarding)
Status: 📝 Planned Purpose: Create IT access revocation task when offboarding checklist item with category ‘access_revocation’ is created Trigger:
hr_offboarding_checklist_items INSERT (category: ‘access_revocation’)
Payload Schema:
Implementation (Database Triggers)
Trigger: hr_onboarding_started
Trigger: hr_offboarding_started
Platform Integration Layer Usage
Consumes:- PF-10 (Notifications): Onboarding task reminders, offboarding completion alerts
- PF-11 (Document Management): Store onboarding documents, I-9 forms, agreements
- PF-04 (Audit Logging): Track onboarding/offboarding progress and completion
- FW (Forms & Workflow): Onboarding/offboarding workflow templates
Security Considerations
Multi-Tenancy
- ✅ RLS Enforcement: All
hr_onboarding_*andhr_offboarding_*tables filtered byorganization_idvia RLS policies
Role-Based Access Control
- ✅ HR Admin: Full access to all onboarding/offboarding instances
- ✅ Manager: View onboarding/offboarding for direct reports
- ✅ Staff: View own onboarding/offboarding only
Data Protection
- ✅ PII Handling: Onboarding documents may contain PII; stored securely in PF-11
- ✅ Audit Trail: All onboarding/offboarding progress logged via PF-04
Testing Requirements
- Event payload structure validation
- Event fires on trigger condition (onboarding/offboarding instance creation, task creation)
- Correct
organization_idincluded in all events - Subscribers handle events correctly (IT-08)
- Database triggers execute correctly
- RLS policies enforce org isolation on onboarding/offboarding queries