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)
Wo in der App
Abschnitt betitelt „Wo in der App“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 |
Beziehungen
Abschnitt betitelt „Beziehungen“| 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 |
Zustände
Abschnitt betitelt „Zustände“| 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.Regeln & Automatik
Abschnitt betitelt „Regeln & Automatik“- 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.
Kennzahlen
Abschnitt betitelt „Kennzahlen“„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.
Siehe auch
Abschnitt betitelt „Siehe auch“Zeiteintrag · Mitarbeitereinsatz · Guides › Zeit erfassen → freigeben → Projektkosten