Zum Inhalt springen

Referenz & Datenmodell

Laufender Timer (active_timer)

Der laufende Timer ist der Entwurf eines Zeitraums, der gerade gemessen wird – genau einer je Benutzer, auf allen Geräten gleich.

Der laufende Timer hält fest, seit wann ein Benutzer misst. Er ist kein Zeiteintrag, sondern ein Entwurf: Beim Stoppen entsteht daraus ein Timer. Er wird über den Server auf alle Geräte des Benutzers gespiegelt, damit ein auf dem Laptop gestarteter Timer auch am Tablet stoppt. (Private Daten, nur Server)

Timer-Chip unten in der Seitenleiste (in jeder App) mit „Start“ / „Stop“, sowie „Neuer Timer“ in Workmanagement › Zeiterfassung › Erfassungsansicht (Guides › Zeiterfassung). Start zeigt die Meldung „Timer gestartet“; der Chip zählt die verstrichene Zeit.

Feld Technisch Typ Pflicht Bedeutung Besonderheit
Laufzeit active.startedAt Zeitpunkt ja Startzeitpunkt, aus dem der Chip die verstrichene Zeit rechnet System
Datum active.date Datum ja Tag des Starts (Wochentag im Stopp-Dialog) System; wird der Tag des Timers
Startzeit active.startTime Uhrzeit ja Uhrzeit des Starts System; wird Startzeit des Timers
Benutzer app_user_id Verweis ja Besitzer Eindeutig: ein laufender Timer je Benutzer

active ist leer, wenn kein Timer läuft.

Zu Art Pflicht Beim Archivieren Beim Löschen
Benutzer gehört zu (1:1) ja — bleibt
kein Timer ──„Start“──► läuft ──„Stop“──► kein Timer (+ neuer Timer-Datensatz)

Ein zweiter Start ersetzt den laufenden Entwurf; ein Start auf einem anderen Gerät erscheint sofort überall.

  • Stoppen legt sofort einen Timer mit Datum, Start- und Endzeit an und öffnet den Dialog „Zeit erfasst“. Der Timer-Chip stoppt auch dann, wenn das Speichern fehlschlägt („Timer gestoppt – Zeit konnte nicht gespeichert werden“).
  • Ein unlesbarer Entwurf wird verworfen („Timer-Daten ungültig – Timer verworfen“).
  • Der Timer trägt keinen Projekt- oder Aufgabenbezug; die Zuordnung folgt in der Erfassungsansicht.

Timer · Zeiterfassung