Repository navigation
Zeitwaechter Abgleich
In LOGA lässt sich über den Zeitwächter ein Zeitwirtschaftsreport („gesetzliche
Arbeitszeitverstöße") erzeugen und in Scout als .xlsx herunterladen. Diese Datei wird im Tab
Einträge auf die Karte „Zeitwächter-Report" gezogen (oder über einen Klick ausgewählt).
Der Report hat eine Zeile je Kalendertag. Verglichen wird die Spalte „Arbeitszeit täglich" – die ist netto, LOGA hat die Pause dort bereits abgezogen (ab 4 h 15 Minuten, ab 6 h weitere 30). Ihr gegenüber steht, was in der App für den Tag erfasst ist. Abweichungen über 15 Minuten fallen auf:
| Status | Bedeutung |
|---|---|
| stimmt | Differenz innerhalb der Toleranz |
| fehlt | LOGA kennt Stunden, hier ist nichts erfasst |
| teilweise | hier ist weniger erfasst als LOGA kennt |
| zu viel | hier ist mehr erfasst als LOGA kennt |
| offen | in LOGA ist nur „Kommen" gestempelt – der Tag ist dort noch nicht fertig |
„Offen" ist typischerweise der laufende Tag: solange das Gehen fehlt, steht „Arbeitszeit täglich" auf 0 oder auf einem Zwischenstand. Alles Erfasste sähe daneben nach zu viel aus, obwohl es LOGA nur noch nicht erreicht hat – deshalb bleiben solche Tage in dieser Richtung stumm. Das gilt absichtlich auch für ein vergessenes Gehen in der Vergangenheit: gegen eine 0 aus LOGA wäre jede erfasste Stunde „zu viel", und die Meldung stünde für immer da, obwohl sie in LOGA zu klären ist. Ein Fehlbetrag wird dagegen weiterhin gemeldet – was LOGA schon gutgeschrieben hat, wird durch ein späteres Gehen nicht weniger.
Für jeden auffälligen Tag schlägt die App einen Nachtrag vor, der sich einer Aktivität zuordnen lässt – einzeln oder für alle Tage auf einmal. Zwei Regeln stecken darin:
- Tage ohne Stempel mit genau einem halben oder ganzen Tagessatz sind Urlaub, Feiertag oder Gleittag – LOGA gibt alle drei identisch aus. Sie werden als Abwesenheit vorgeschlagen, nicht als Projektzeit.
- Gestempelte Tage werden zwischen „Erstes kommen" und „Letztes gehen" aufgefüllt. Bereits erfasste Zeiten bleiben unberührt, der Nachtrag legt sich in die freien Lücken.
Wie dabei gerechnet wird, hängt am automatischen Pausenabzug: ist er aktiv, trägt der Nachtrag die Anwesenheit ein (also inklusive Pause, wie ein durchlaufender Timer sie erfasst) und die App zieht sie anschließend ab. Ist er aus, spart der Nachtrag stattdessen eine Lücke in Höhe der Pause um die Mittagszeit aus. Beides ergibt am Ende die Stundenzahl aus dem Report – die LOGA-Zahl eins zu eins einzutragen wäre bei aktivem Abzug zu wenig, weil sie den Abzug ein zweites Mal bekäme.
Zwei Sonderfälle, die der echte Report zeigt:
- Meldet LOGA mehr Stunden, als zwischen Kommen und Gehen liegen (nachgebuchte Zeiten, Dienstreise), reicht der Nachtrag über „Letztes gehen" hinaus – sonst ließe sich der Tag nie vollständig erfassen. Die Zeile weist diesen Teil getrennt aus („+1:35 h über die Stempelzeiten hinaus") und bietet eine eigene Aktivitätsauswahl dafür an, vorbelegt mit „Others" – solche Stunden gehören selten auf dasselbe Projekt wie der gestempelte Tag.
- Zieht LOGA an einem Tag anders ab als die Hausregel (gestempelte Zusatzpause, Korrekturbuchung), bleibt nach dem Nachtrag eine Differenz stehen. Sie wird nicht mit erfundener Anwesenheit aufgefüllt; die Zeile sagt stattdessen, wie viel LOGA dort abgezogen hat. Im vorliegenden Report betrifft das rund 11 % der gestempelten Tage.
Nachgetragene Einträge tragen die Notiz „Zeitwächter" und werden beim nächsten Abgleich als bereits nachgetragen erkannt – ein zweiter Durchlauf erzeugt keine Dubletten. Die Verstoß-Spalten des Reports (Ruhepause, > 10 h, Sonntags-/Feiertagsarbeit) erscheinen als Badge am jeweiligen Tag.
Der eingelesene Report bleibt unter data/timereport-YYYY-MM.json liegen und wirkt danach im Tab
Einträge weiter, auch ohne geöffneten Abgleich:
- In der Tagesliste trägt jeder abweichende Tag seine Differenz:
−1:15in Amber, wo Zeit fehlt,+0:45in Blau, wo mehr erfasst ist als LOGA kennt (dieselben Farben wie im Abgleich). - Im Eintrags-Dialog steht die Abweichung des Tages unter den Uhrzeiten, mit einem Knopf „1:15 h ergänzen" bzw. „0:45 h abziehen". Er setzt die Dauer dieses Eintrags so, dass der Tag auf die LOGA-Stunden kommt: „Von" bleibt stehen und „Bis" wandert – außer der Tag reicht dahinter nicht mehr, dann bleibt „Bis" stehen und „Von" rückt zurück. Über Mitternacht geht es dabei nie, sonst würden daraus zwei Einträge und der Tag bekäme nur den ersten. Gespeichert wird nichts; die Zeiten stehen anschließend im Formular und lassen sich noch anfassen.
Gerechnet wird dabei über die übrigen Einträge des Tages, nicht über die angezeigte Differenz: so stimmt die Zahl auch, wenn im Dialog schon an den Zeiten gedreht wurde, und zweimal Drücken verdoppelt nichts. Ist der automatische Pausenabzug aktiv, zielt der Knopf wie der Nachtrag auf die Anwesenheit – die LOGA-Zahl ist netto und bekäme den Abzug sonst ein zweites Mal. Steht der Tag auch ohne diesen Eintrag schon zu voll, bleibt der Knopf weg: kürzer als leer geht ein Eintrag nicht.
Die heruntergeladene
.xlsxenthält Personalnummer und Klarnamen. Sie wird nicht ins Repo übernommen (.gitignore); für die Tests liegt eine anonymisierte Fassung untersrc/lib/testing/.