Zum Inhalt springen

Referenz & Datenmodell

Zeiterfassung (time_log)

Eine Zeiterfassung ist der Kopf der erfassten Zeit einer Person an einem Tag für ein Projekt und optional eine Aufgabe; sie trägt Status, Abrechenbarkeit und Beschreibung.

Die Zeiterfassung bündelt alle Zeitspannen einer Person zu einem Tag-Projekt-Aufgabe-Bezug und durchläuft die Freigabe. Genehmigte Zeiterfassungen sind gesperrt und werden einmalig als Personalkosten gebucht. (Bewegungsdaten)

Workmanagement › Zeiterfassung (Guides › Zeiterfassung):

  • „Erfassungsansicht“ (/time-tracking): eigene Zeiterfassungen je Tag oder Woche; „Neue Zeiterfassung“; Klick öffnet den Dialog „Zeiterfassung“.
  • „Detailansicht“ (/detail-time-view): alle Zeiterfassungen eines Zeitraums, gruppiert nach Tag, Woche, Monat, Projekt, Aufgabe, Mitarbeiter, Abrechnung oder Status; Filter über Status, Datum, Beschreibung, Abrechenbar, „Genehmigt am“, „Abgelehnt am“, Mitarbeiter, Projekt, Aufgabe; Status direkt in der Zeile änderbar; Anlegen für andere Personen.
  • „Freigabeansicht“ (/time-approval): je Mitarbeiter Summen und „Genehmigen“ / „Ablehnen“; Einzelsicht mit „Auf Genehmigt wechseln“ / „Auf Abgelehnt wechseln“ (Guides › Zeiten des Teams freigeben).
Feld Technisch Typ Pflicht Bedeutung Besonderheit
Mitarbeiter employee_id Verweis nein Wessen Zeit Erfassungsansicht: eigener Mitarbeiter; Detailansicht: frei wählbar
Projekt project_id Verweis ja Bezugsprojekt
Aufgabe task_id Verweis nein Aufgabe des Projekts Ohne Aufgabe: „Projektzeiterfassungen ohne Aufgabenbezug“
Datum date Datum ja Tag der Arbeit Blättern mit „Vorheriger Tag“ / „Nächster Tag“
Status state Auswahl ja „Ausstehend“, „Genehmigt“, „Abgelehnt“ Standard „Ausstehend“; nach Genehmigung gesperrt
Abrechenbar billable Ja/Nein ja Fließt in „Abrechenbare Stunden (%)“ Standard Ja
Beschreibung description Text nein Freitext
Genehmigt am approved_at Datum nein Zeitpunkt der Genehmigung Anzeige im Dialog; wird derzeit von keiner Aktion gesetzt und bleibt daher leer
Abgelehnt am rejected_at Datum nein Zeitpunkt der Ablehnung wie oben
Erfasste Arbeitszeit Summe der Zeiteinträge Dauer — Angezeigt, nicht gespeichert
Zu Art Pflicht Beim Archivieren Beim Löschen
Mitarbeiter gehört zu nein — bleibt
Projekt gehört zu ja bleibt mitlöschen – verhindert, solange Zeiterfassungen vorhanden sind
Aufgabe gehört zu nein bleibt mitlöschen – verhindert, solange genehmigt
Zeiteintrag hat viele — bleibt mitlöschen
Wert Label Bedeutung Wer setzt
pending Ausstehend (in Summen „Offen (h)“) Erfasst, noch nicht entschieden Anlage; Rücknahme einer Entscheidung
approved Genehmigt Freigegeben, Inhalt gesperrt, Kosten gebucht „Genehmigen“, Statusauswahl
rejected Abgelehnt Zurückgewiesen, weiter bearbeitbar „Ablehnen“, Statusauswahl
„Genehmigen“ / Status → Genehmigt
Ausstehend ─────────────────────────────────► Genehmigt (gesperrt)
▲ │ │ ▲
│ │ „Ablehnen“ │ │ „Auf Genehmigt wechseln“
│ ▼ │ │
│ Abgelehnt ◄────„Auf Abgelehnt wechseln“───┘ │
│ └────────────────────────────────────────┘
└── Status zurück auf „Ausstehend“ (Detailansicht / Dialog)
Alle Übergänge sind über das Status-Auswahlfeld frei; ausführen darf sie, wessen [Zugriff](/referenz/01-organisation-zugriff/b1-permissions/) am Projekt es erlaubt.
  • Eindeutigkeit: Je Mitarbeiter, Datum, Projekt und Aufgabe gibt es höchstens eine nicht genehmigte Zeiterfassung. Der Dialog „Neue Zeiterfassung“ nutzt die vorhandene („Für diesen Mitarbeiter, dieses Datum, Projekt und Aufgabe existiert bereits ein Zeiteintrag“). Ist die vorhandene genehmigt, ist Anlegen gesperrt („… bereits freigegeben. Freigabe zurücknehmen …“). Ein dennoch doppelt eintreffender Datensatz wird serverseitig zusammengeführt.
  • Sperre nach Genehmigung: Datum, Beschreibung, Abrechenbar, Mitarbeiter, Projekt, Aufgabe und alle Zeiteinträge sind unveränderlich; Löschen ist abgewiesen („approved time log cannot be deleted — un-approve it first“). Nur der Status bleibt änderbar. Siehe Sperren.
  • Personalkosten: Die erste Genehmigung bucht einmalig „Personalkosten aus Zeiterfassung“ = Summe der Zeiteinträge × Stundensatz (Projektstundensatz des Projektmitglieds, sonst Stundenkosten des Mitarbeiters), Datum = Tag der Zeiterfassung. Rücknahme, Änderung und erneute Genehmigung buchen nicht neu. Siehe Ist-Personalkosten.
  • Löschschutz: Eine Aufgabe kann nicht gelöscht werden, solange genehmigte Zeiterfassungen daran hängen. Ein Projekt mit Zeiterfassungen lässt sich überhaupt nicht löschen; es wird stattdessen mit „Als fehlgeschlagen abschließen & archivieren“ beendet (Projekt).
  • Abgeschlossene Projekte: Für ein erfolgreich abgeschlossenes oder fehlgeschlagenes Projekt legt die Oberfläche keine neuen Zeiterfassungen an („Projekt abgeschlossen – keine neuen Einträge möglich.“).
  • Die Sammelaktion der Freigabeansicht setzt alle Zeiterfassungen der gewählten Mitarbeiter im Zeitraum, auch bereits abgelehnte.

„Ziel-Arbeitsstunden“ (Wochenstunden ÷ 5 × Werktage), „Gesamte Arbeitsstunden“, „Gesamt / Ziel (%)“, „Abrechenbare Stunden (%)“, „Offen (h)“, „Genehmigt (h)“, „Abgelehnt (h)“; Übersicht: Stunden diese Woche, Erfassungsquote, Offene Freigaben – siehe Arbeit und Zählwerte.

Zeiteintrag · Mitarbeitereinsatz · Guides › Zeit erfassen → freigeben → Projektkosten