Zum Inhalt

Stempeln

Unter Heute stempelt jede Person, die für den Betrieb arbeitet, ihre Arbeitszeit: am Handy, am Tablet oder im Browser. Externe und Geräte stempeln hier nicht; das Terminal kommt später.

Der Knopf

Der große Knopf zeigt immer den nächsten Schritt:

Zustand Großer Knopf Darunter
nicht eingestempelt Kommen –
eingestempelt Pause starten Gehen
in Pause Pause beenden Gehen

Es zählt die Uhr des Servers, nicht die des Geräts: Wer um 7:58 Uhr auf „Kommen“ tippt, ist um 7:58 Uhr eingestempelt, auch wenn das Handy falsch geht. Die Zeit des Geräts speichert Soll daneben, für das Stempeln ohne Netz.

Soll stempelt nie selbst aus. Wer das Gehen vergisst, bleibt eingestempelt; ab Mitternacht (bei einer Nachtschicht 16 Stunden nach Beginn) zeigt Heute den Hinweis „Gehen fehlt“ mit § 3 Abs. 2 Nr. 1 ArbSchG, bis die Zeit nachgetragen ist. Wie Soll aus den Stempelungen den Tag bildet, steht unter Arbeitstag aus Stempelungen.

Der laufende Tag

Über dem Knopf stehen:

  • der Zustand mit Uhrzeit („Eingestempelt seit 07:58“, „In Pause seit 12:00“),
  • die gearbeitete Zeit des Tages, groß, in Stunden und Minuten,
  • Soll, Ist und Pause. Das Soll kommt aus dem Arbeitszeitmodell der Person für den Wochentag. Ist ihr keins zugeordnet, steht dort „nicht hinterlegt“, nie ein geschätzter Wert.
  • der nächste Befund mit seiner Norm:
Was als Nächstes kommt Beispiel Norm
Pause nach 6 Stunden (30 min) oder nach 9 Stunden (45 min), oder nach 6 Stunden am Stück „Pause fällig in 1:48 · Mindestens 30 Minuten, spätestens ab 13:58“ § 4 ArbZG
8 Stunden am Tag „8 Stunden erreicht in 1:30 · Ab 16:30 nur mit Ausgleich an anderen Tagen“ § 3 ArbZG
10 Stunden am Tag „10 Stunden erreicht in 0:30 · Nach 18:30 ist Arbeit nicht erlaubt“ § 3 ArbZG
nach dem Gehen: Ende der Ruhezeit „Ruhezeit bis Sa., 21. Nov., 03:30“ § 5 Abs. 1 ArbZG

Gezählt wird, als ginge die Person jetzt: die angefangene Minute zählt mit, nie zu ihrem Nachteil. Ist eine Grenze schon überschritten, steht der Befund selbst darunter, etwa „Pause fehlt noch 30 min · Verstoß · § 4 Satz 1 ArbZG“. Die Prüfung ist dieselbe wie für den ganzen Tag (Prüfung nach §§ 3 bis 5 ArbZG): Höchstarbeitszeit, Ruhepausen und Ruhezeit. Den Ausgleichszeitraum über sechs Monate prüft Soll mit dem Monatsabschluss, weil er alle Tage des Zeitraums und die Feiertage am Standort braucht.

Nachtragen und Ändern

Unter dem Knopf stehen die Stempelungen des Tages. Jede lässt sich ändern (Art, Tag, Uhrzeit) oder entfernen; mit Nachtragen kommt eine vergessene dazu. Jede dieser Änderungen braucht einen Grund, ohne Grund speichert Soll nichts.

  • Jede Person ändert ihre eigenen Zeiten.
  • Inhaber und Planer ändern die Zeiten aller unter Zeiten: Person wählen, Tag wählen, ändern. Das Lohnbüro sieht die Zeiten aller, ändert sie aber nicht.
  • Eine Stempelung kann nicht in der Zukunft liegen. Für die Stunde, die im Oktober zweimal kommt, nimmt Soll die erste (Sommerzeit); eine Uhrzeit, die es im März nicht gibt, lehnt es ab.
  • Geändert wird bis zum Monatsabschluss. Danach ist der Monat gesperrt, eine Korrektur geht nur noch als Gegeneintrag.

Jede Änderung bleibt sichtbar

Soll überschreibt keine Stempelung. Eine Änderung ist eine neue Zeile, die auf die alte verweist; die alte bleibt, wie sie war, und beide stehen in der Audit-Kette. Unter Änderungen sieht die Person zu jedem Tag, wer was wann und warum geändert hat:

Jonas Weber hat Gehen 14:30 auf Gehen 13:30 geändert Fr., 20. Nov., 09:01 · Grund: Arzttermin, früher gegangen

Eine Änderung steht an dem Arbeitstag, zu dem die Stempelung gehört: Wird das Gehen einer Nachtschicht nach Mitternacht entfernt, steht das am Tag, an dem die Schicht begann. Eine korrigierte Stempelung trägt in der Liste die Marke „korrigiert“.

Arbeitszeitmodell zuordnen

Der Inhaber ordnet unter Zeiten jeder Person ein Arbeitszeitmodell zu; es gilt ab dem Tag der Zuordnung. Ein Modell, das einer Person zugeordnet ist, lässt sich nicht löschen.

Für Entwickler

Die Endpunkte liegen unter /api/v1/arbeitszeit und sind gesperrt, solange das Modul Arbeitszeit aus ist:

Endpunkt Was Wer
GET /tag?datum=&nutzerId= ein Tag: Soll, Stand (tagesstand), Stempelungen, Änderungen; ohne Datum der laufende Tag selbst, auch wer nicht mehr stempelt (etwa jetzt Extern), solange Stempelungen da sind, nur lesend (Art. 15 DSGVO); andere: Inhaber, Planer, Lohnbüro, auch für wen nicht mehr stempelt oder ausgeschieden ist (§ 16 Abs. 2 ArbZG)
POST /stempelungen { art, geraetZeitpunkt? }, Zeitpunkt vom Server selbst
POST /stempelungen/nachtrag { nutzerId?, art, zeitpunkt, grund } selbst; andere: Inhaber, Planer
PATCH /stempelungen/:id { art, zeitpunkt, grund }, hängt eine neue Zeile an selbst; andere: Inhaber, Planer
POST /stempelungen/:id/entfernen { grund }, hängt eine Entfernung an selbst; andere: Inhaber, Planer
GET /personen wer stempelt, mit dem Modell von heute Inhaber, Planer, Lohnbüro
PUT /personen/:nutzerId/modell { modellId, gueltigAb? } Inhaber

Die Tabelle stempelungen hat betrieb_id, die Person, Art, Zeitpunkt (Server) und Zeitpunkt des Geräts, Quelle, ersetzt (die Zeile, die diese ersetzt), entfernt, Grund, wer und wann. In Kraft ist eine Zeile, die keine andere ersetzt und die nichts entfernt. Vor jeder Änderung fragt der Server monatAbgeschlossen(), das bis zum Monatsabschluss (S-306) „offen“ sagt. Den laufenden Tag rechnet tagesstand() aus packages/arbeitszeit, auf dem Server und in der App mit derselben Funktion; die App zählt mit der Uhr des Servers weiter.