Arbeitszeit-Wächter ausprobieren → Die Seite prüft eine Eingabe direkt im Browser und zeigt ein Live-Diagramm. Die echten Formulare liegen auf mikweb.eu/form/zeitwaechter (Stunden) und /zeitwaechter-abwesenheit. Die Demo-Daten sind erfunden (Musterbüro GmbH); im Betrieb laufen echte Nextcloud-Konten, siehe unten.
Warum überhaupt
Seit dem Urteil des Bundesarbeitsgerichts vom 13.09.2022 (1 ABR 22/21) müssen Arbeitgeber die Arbeitszeit erfassen. Eine Tabelle reicht dafür oft aus. Was sie nicht tut: sagen, dass jemand gestern 11 Stunden ohne ausreichende Pause gearbeitet hat und heute um 06:00 wieder anfängt. Das fällt meist erst auf, wenn jemand die Liste am Monatsende liest. Ich wollte, dass der Verstoß am selben Abend eine Karte und eine Nachricht auslöst, und dass der Workflow dafür ohne Spezialsoftware auskommt: n8n, Nextcloud, eine CSV.
Stand der Rechtslage: Die Erfassungspflicht gilt seit 2022. Eine Reform des Arbeitszeitgesetzes (Referentenentwurf des BMAS) war nach meinem Stand im Juni 2026 noch nicht beschlossen. Prüfe selbst, wie es heute aussieht. Das hier ist ein technisches Beispiel und keine Rechtsberatung.
Was der Workflow tut
- Zwei n8n-Formulare: Stunden (Person, Datum, Beginn, Ende, Pause, Projekt, Tätigkeit) und Abwesenheit (Person, von, bis, Art: Urlaub, Krankheit oder Gleitzeitausgleich).
- Prüfung der Eingabe (Format, Zeiten, Datum) und Speichern in
zeiten.csvin Nextcloud über WebDAV. - ArbZG-Check über alle Zeilen, danach Vergleich mit dem Stand vor der Eingabe: nur neue Verstöße lösen etwas aus.
- Bei neuem Verstoß: eine Karte in Nextcloud Deck, eine Nachricht in Talk.
- Abwesenheiten werden CalDAV-Termine. Ein zweiter Check findet Stunden an einem Abwesenheitstag.
- Freitag 15:00: Wochenbericht als Markdown und als SVG-Dashboard in Nextcloud, dazu Talk.
- Montag: Reset der Demo-Daten.
- Pro Konto: Kalender, Deck-Board, Talk-Chat und Ordner entstehen automatisch (siehe „Echte Nextcloud-Konten“ unten).
Die Regeln
- § 3: höchstens 10 Stunden pro Tag, im Schnitt 8 Stunden.
- § 4: 30 Minuten Pause ab mehr als 6 Stunden, 45 Minuten ab mehr als 9 Stunden.
- § 5: 11 Stunden ununterbrochene Ruhezeit zwischen zwei Arbeitstagen.
- § 9: Sonntagsarbeit.
- Hinweis: mehr als 48 Stunden in einer Woche. Das ist ein Hinweis, kein Verstoß: das Gesetz arbeitet mit Durchschnitten.
Das alles ist deterministischer Code (core.js, über 100 Prüfungen laufen durch, node test_core.js). Die KI (IONOS gpt-oss-120b) schreibt nur drei Sätze im Wochenbericht, und sie sieht dabei keine Namen, nur Zahlen. Wer gegen das Gesetz verstößt, entscheidet nie ein Sprachmodell.
Gleichzeitige Schreibzugriffe: ETag und If-Match
Zwei Leute senden gleichzeitig ein Formular, beide lesen die CSV, beide schreiben zurück: eine Eingabe ist weg. Deshalb optimistisches Locking über WebDAV: GET holt die Datei samt ETag, das PUT schickt If-Match: <ETag>. Hat sich die Datei inzwischen geändert, antwortet Nextcloud mit 412 Precondition Failed. Dann liest der Workflow neu und versucht es noch einmal, bis zu dreimal. Nach dem dritten Fehlschlag meldet er das ehrlich zurück, statt still etwas zu überschreiben.
Was ich auf n8n 2.46.6 gelernt habe
- „Respond When“ nicht auf „Using Respond to Webhook“ stellen. Form Trigger v2.5 mit dem n8n-Form-Knoten meldet dann „Respond to Webhook not supported in workflows initiated by Form Trigger“ bzw. „No Respond to Webhook node found“. Den Standard lassen: die Antwort kommt vom Form-Knoten.
- Der Form-Knoten mit „Completion“ und „Show Text“ nimmt vollständiges HTML. Die Antwort ist damit eine ganze Seite, auch mit einem inline-SVG-Diagramm. Technisch: Der POST des Formulars liefert JSON mit
formWaitingUrl, der Browser springt auf/form-waiting/<id>, und dort erscheint die Seite. - HTTP Request mit „Full Response“ und Text: der Inhalt steckt in
data, nicht inbody. Meinres.bodywarundefined, die CSV wurde mit einer einzigen Zeile zurückgeschrieben. Seitdem gibt es eine Schutzprüfung gegen Datenverlust: ergibt das Parsen null Zeilen, obwohl die Datei nicht leer ist, bricht der Lauf ab, statt zu schreiben. - Welcher der fünf Trigger lief? Mit
$('Knoten').isExecutedprüfen, so läuft alles in einem Workflow. - Im Code-Knoten gibt es keine Klasse
URL. Reguläre Ausdrücke nehmen. - CSV-Injection. Zellen, die mit
=,+,-oder@beginnen, bekommen ein'davor. Sonst führt Excel eine Formel aus dem Projektnamen aus. - Nextcloud WebDAV:
If-Matchmit dem ETag aus dem GET funktioniert, ein veralteter ETag ergibt 412. Genau das braucht man.
Stempeln per QR-Code: kein Formular mehr
Formulare sind für Büro-Leute. Wer am Band, im Lager oder unterwegs arbeitet, will nur scannen. Deshalb gibt es einen zweiten Weg, ebenfalls komplett in n8n und Nextcloud:
- Telefon einmal registrieren (/zeit/anmelden/): Person wählen, das Telefon bekommt ein zufälliges Geräte-Token. Im Workflow landet nur der SHA-256-Hash in
geraete.jsonin Nextcloud. Mit echten Konten läuft die Anmeldung über Nextcloud Login Flow v2 (siehe unten); die Demo-Seite arbeitet mit den fiktiven Personen. - Tages-QR am Eingang (/zeit-qr/): vier Codes (Beginn, Pause, Weiter, Ende). Jeder ist ein HMAC-SHA-256 aus Datum und Art, der Schlüssel liegt nur auf dem Server. Morgen sind alle Codes anders, ein Foto von gestern bringt nichts.
- Scannen mit der Kamera: die Seite stempelt allein. Die Uhrzeit setzt n8n (Berliner Zeit des Servers), nie das Telefon. Nur beim Ende erscheint ein Feld für die Tätigkeit.
- Zustandsautomat pro Person und Tag: Beginn, (Pause, Weiter) beliebig oft, Ende. Zweimal Beginn gibt
wrong_state. Alle Stempel stehen instempel.csv. - Beim Ende wird daraus eine Buchung, und die läuft durch dieselben Knoten wie das Formular: Überschneidung, ArbZG-Check, Deck, Talk, Abwesenheitskalender.
Zwei Dinge dazu: SHA-256 und HMAC sind in reinem JavaScript im Code-Knoten (kein crypto, kein require), geprüft mit den RFC-4231-Testvektoren. Und ehrlich: Ein QR-Code lässt sich fotografieren und weiterschicken. Das Geräte-Token und der Tages-Code erschweren das, verhindern es nicht. Ein Bildschirm mit wechselndem Code oder eine Standortprüfung wären die nächste Stufe. Zeitdaten an einem privaten Telefon sind personenbezogen: im Betrieb brauchen Sie Information und Rechtsgrundlage (Betriebsrat, Datenschutz).
Jeder sieht seine Zeit, der Chef sieht alles: echte Nextcloud-Konten
Zuerst war der Wächter ein Demo mit vier erfundenen Namen in einer gemeinsamen CSV. Jetzt läuft er mit echten Nextcloud-Konten, und jede Person bekommt ihre eigenen Sichten.
Drei Gruppen
- zeit-team: die Mitarbeitenden.
- zeit-chef: der Chef.
- zeit-demo: die fiktiven Demo-Konten Anna, Ben, Chiara, Dario und „Chef demo“, mit 20 MB Quota und ohne Recht, etwas zu teilen. Besucher dieser Seite melden sich nicht an: sie nutzen die Demo „Person wählen“.
Mein eigenes Konto ist kein Admin-Konto. Es ist Mitarbeiter und Chef zugleich, also in beiden Gruppen.
Das Telefon anmelden: Login Flow v2 ohne gespeichertes Passwort
- Die PWA öffnet die Nextcloud-Anmeldung (Login Flow v2).
- n8n bekommt dabei ein App-Passwort, prüft, ob die Person in
zeit-teamist, und widerruft das App-Passwort sofort. - Ausgestellt wird nur ein Geräte-Token. Gespeichert wird sein SHA-256-Hash.
Ergebnis: Weder im Browser noch in n8n bleibt ein Nextcloud-Passwort zurück.
Der Bot „zeitwaechter“ richtet alles ein
Ein Bot-Konto ohne Adminrechte legt für jede Person an und hält aktuell:
- den Kalender „Arbeitszeit“, für die Person und die Chef-Gruppe nur lesbar,
- das Deck-Board „Meine Zeit“ (Wochen und Verstöße),
- einen privaten Talk-Chat für Bestätigungen und Warnungen,
- den Ordner
Zeit/<Person>/mit der CSV,Woche.svg(Diagramm der Woche) undWochen.md(Tabelle).
Für den Chef kommen dazu: das Deck-Board „Zeit-Übersicht“ (eine Spalte pro Person plus „Da chiarire“), der Talk-Raum „Zeit-Team (Chef)“ und der Ordner Zeit/Team/ mit Dashboard.svg, Uebersicht.md und den Freitagsberichten. Der Bot ist nur Subadmin von zeit-team und zeit-chef, damit er die Mitglieder lesen kann, mehr nicht.
Grafiken in der PWA
Unter /zeit/grafik/ gibt es „Meine Woche“ für alle und „Team“ für den Chef, jeweils mit Diagramm, Tabelle, CSV-Export und Druck/PDF.
Wiederholbar, und geprüft
Das Onboarding lässt sich beliebig oft wiederholen. Schlägt eine Freigabe fehl, versucht der Bot es einmal erneut, und das Ergebnis des Seeds meldet Probleme als Warnung. Geprüft mit occ und OCS: Ben sieht nur seinen eigenen Kalender und sein eigenes Board, der Chef sieht alles.
Für andere Nextcloud-Instanzen
Anleitung und Skripte (setup.sh, uninstall.sh) stehen auf /arbeitszeit-waechter/nextcloud/, das Setup-Skript auch als Datei zeitwaechter-setup.sh.
Ehrliche Grenzen
- Stundendaten mit Personenbezug sind personenbezogene Daten: Information der Beschäftigten, Rechtsgrundlage und Betriebsrat sind Ihre Aufgabe.
- Der Chef sieht alles, by design.
- Ein Demo-Konto mit Login könnte andere Konten auflisten. Darum gibt es keinen öffentlichen Demo-Login.
- Das ist keine Rechtsberatung.
Wie es in Nextcloud aussieht
Echte Bildschirmfotos vom Demo-Betrieb auf meiner Nextcloud (fiktive Personen der Musterbüro GmbH, aufgenommen als Chef-Konto).




Zeit/Team/Dashboard.svg, bei jeder Stempelung aktualisiert (dazu Uebersicht.md).Ausprobieren und herunterladen
Workflow-JSON herunterladen → Importieren, Nextcloud- und IONOS-Zugang als eigene Credentials eintragen, Nextcloud-Pfad, Deck-Board und Talk-Raum anpassen. Die Zugangsdaten stehen nicht im JSON. Die KI-Sätze sind optional: ohne Credential bleibt der Bericht bei den Zahlen.
Grenzen
Das ist ein Demo-Aufbau, keine Zeiterfassung für den Betrieb. Die Daten sind erfunden, kein Betriebsrat, keine Tarifregeln, keine Ausnahmen nach § 7 oder Branchenregeln (Pflegedienst, Gastronomie, Transport). Für Jugendliche, Schwangere oder Fahrpersonal gelten andere Vorgaben. Die Schwellen im Code folgen dem Gesetzestext, ersetzen aber nicht die Prüfung durch jemanden, der dein Unternehmen kennt. Und was die Reform bringt, steht nicht in diesem Artikel: bitte aktuell nachlesen.
Verwandt: der Durchwinker-Test zeigt, warum „ein Mensch schaut drauf“ allein nicht reicht. Hier macht es der Code, und der Mensch bekommt nur die Fälle zu sehen, die zählen.