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)
Wo in der App
Abschnitt betitelt „Wo in der App“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.
Beziehungen
Abschnitt betitelt „Beziehungen“| Zu | Art | Pflicht | Beim Archivieren | Beim Löschen |
|---|---|---|---|---|
| Benutzer | gehört zu (1:1) | ja | — | bleibt |
Zustände
Abschnitt betitelt „Zustände“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.
Regeln & Automatik
Abschnitt betitelt „Regeln & Automatik“- 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.