Mitarbeiter-Onboarding (EmployeeOnboarding)
Zweck
Das Onboarding lässt neue Mitarbeiter ihre Stammdaten selbst erfassen: HR erzeugt einen Onboarding-Link (Token), der neue Mitarbeiter füllt darüber seinen Personalfragebogen aus (Steuer-, SV-, Ausweis-Daten u. a.), und die Daten fließen direkt in den Mitarbeiter-Datensatz. Welche Schritte abgefragt werden, steuern Vorlagen und die Onboarding-Einstellungen.
Voraussetzungen
- Berechtigung `view:FE_EmployeeOnboarding` und `view:EmployeeOnboarding`.
- Zum Starten eines Onboardings `create:EmployeeOnboarding`; für Vorlagen `update`/`delete:EmployeeOnboarding`.
- Der neue Mitarbeiter braucht **keinen** Account — er nutzt den Token-Link.
Berechtigungen (CASL)
| Action | Subject | Wirkung |
|---|
view | FE_EmployeeOnboarding, EmployeeOnboarding | Onboarding-Liste/Status aufrufbar |
create | EmployeeOnboarding | Onboarding starten / Vorlage anlegen |
update/delete | EmployeeOnboarding | Vorlage pflegen/löschen |
Ablauf
- Onboarding starten (
/employee-onboardings/new) — Mitarbeiter wählen, Vorlage/Schritte festlegen, Begrüßungstext + Kontakt-E-Mail setzen.
- SpeamCore erzeugt ein
EmployeeOnboarding mit Token und optionalem Ablaufdatum (expiresAt) und verschickt den Link (Mail-Vorlage konfigurierbar).
- Der neue Mitarbeiter öffnet den Link und durchläuft die aktivierten Schritte (
enabledSteps) — der Personalfragebogen erfasst u. a. Steuer-ID, Krankenkasse, Sozialversicherungsnummer, Ausweisdaten.
- Die erfassten Daten landen am Mitarbeiter-Datensatz; der
status des Onboardings zeigt den Fortschritt.
Felder (Auszug)
| Feld | Bedeutung |
|---|
employeeId | Verknüpfter Mitarbeiter. |
token | Geheimer Zugangs-Token für den Self-Service-Link. |
status | Fortschritt des Onboardings. |
enabledSteps | Welche Schritte/Abschnitte abgefragt werden. |
currentStep | Aktueller Schritt. |
welcomeText | Begrüßungstext auf der Onboarding-Seite. |
contactEmail | Ansprechpartner für Rückfragen. |
expiresAt | Ablauf des Links. |
Vorlagen und Einstellungen
- Vorlagen (
EmployeeOnboardingTemplate, Endpoints /employee-onboarding-templates): wiederverwendbare Schritt-Konfigurationen.
- Onboarding-Einstellungen: globale Vorgaben (u. a. IT-Optionen, Mail-Vorlage) —
update:Settings.
API/Schnittstellen
| Methode | Endpoint | Zweck | CASL |
|---|
GET/POST | /api/employee-onboardings | Liste / Onboarding starten | view/create EmployeeOnboarding |
GET | /api/employee-onboardings/meta · /mail-template | Metadaten / Mail-Vorlage | view EmployeeOnboarding |
GET/POST | /api/employee-onboarding-templates | Vorlagen lesen/anlegen | view/create EmployeeOnboarding |
PATCH/DELETE | /api/employee-onboarding-templates/:id | Vorlage ändern/löschen | update/delete EmployeeOnboarding |
Verknüpfungen zu anderen Modulen
Versionshinweise
- 2026-06-06: Initiale Veröffentlichung. Token-basiertes Self-Service-Onboarding (Personalfragebogen), Vorlagen, konfigurierbare Schritte. Verifiziert an
employeeOnboarding.model.ts, employeeOnboarding.router.ts, routes.tsx, casl.ts.