> ## Documentation Index
> Fetch the complete documentation index at: https://developers.jobhandy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Mitarbeiter-Offboarding

> Sperren Sie den Zugriff, erhalten Sie referenzielle Integrität, dokumentieren Sie Grenzen und trennen Sie Kontostatus von Lösch- oder Erasure-Prozessen.

Die öffentliche Employee-Update-Operation stellt die Eigenschaft `blocked` bereit. Eine Sperrung ändert den Kontostatus; sie ist keine Löschoperation und darf nicht als Datenlöschung beschrieben werden.

## Empfohlener Offboarding-Ablauf

```mermaid theme={"theme":{"light":"github-light","dark":"github-dark"}}
sequenceDiagram
    participant HR as HR-System
    participant INT as Integration
    participant API as JobHandy API
    participant OPS as Betrieb

    HR->>INT: Mitarbeiter verlässt das Unternehmen oder Zugriff muss enden
    INT->>API: GET /employees/{id}
    API-->>INT: Aktueller Mitarbeiter
    INT->>API: PATCH /employees/{id}?dryRun=true {blocked:true}
    API-->>INT: Projizierter gesperrter Mitarbeiter
    INT->>API: PATCH /employees/{id} {blocked:true}
    API-->>INT: Gespeicherter Mitarbeiter + Request-ID
    INT->>OPS: Ergebnis und Folgeaufgaben dokumentieren
```

## Mitarbeiter sperren

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "blocked": true
}
```

Verwenden Sie zuerst einen Dry Run, wenn die Änderung Teil eines automatisierten Offboarding-Prozesses ist.

## Was der öffentliche Vertrag garantiert

* Die Mitarbeiterressource enthält den booleschen Status `blocked`.
* Der Update-Endpoint kann diesen Status ändern.
* Der Mitarbeiter bleibt über seine Ressourcen-ID adressierbar, solange er im Scope verfügbar ist.
* Die Public API bietet keine Löschung von Mitarbeitern an.

## Was der öffentliche Vertrag nicht festlegt

Der OpenAPI-Vertrag beschreibt nicht jeden nachgelagerten Portal- oder Facheffekt eines gesperrten Mitarbeiters. Gehen Sie nicht davon aus, dass eine Sperrung automatisch:

* Mitarbeiterdaten löscht
* bestehende Bestellungen storniert, ablehnt oder archiviert
* Vorfälle oder Anhänge löscht
* Payroll-Daten löscht
* ein rechtliches Löschersuchen erfüllt

Behandeln Sie diese Vorgänge über die verantwortlichen JobHandy- und Kundenprozesse.

## Reaktivierung

Wenn der fachliche Prozess eine Reaktivierung erlaubt, setzen Sie:

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "blocked": false
}
```

Validieren Sie Zielstatus und aktuellen Tenant-Scope vor der Ausführung.

## Betriebscheckliste

* [ ] JobHandy-Mitarbeiter-ID ist bekannt
* [ ] Aktueller Mitarbeiterstatus wurde gelesen
* [ ] `blocked=true` wurde per Dry Run validiert
* [ ] Realer Schreibvorgang war erfolgreich und die Request-ID wurde gespeichert
* [ ] Offene Bestellungen und Vorfälle wurden durch den verantwortlichen Prozesseigner geprüft
* [ ] Lokale Zugriffe, Zeitpläne, Secrets und Exporte wurden wie erforderlich behandelt
* [ ] Lösch- oder Betroffenenprozesse wurden separat weitergeleitet