Reference & Data Model
Active timer (active_timer)
The active timer is the draft of a time span that is currently being measured – exactly one per user, identical on all devices.
Purpose
Section titled “Purpose”The active timer records since when a user has been measuring. It is not a time entry but a draft: stopping it creates a Timer. It is mirrored via the server to all of the user’s devices, so a timer started on the laptop can also be stopped on the tablet. (Private data, server only)
Where in the app
Section titled “Where in the app”Timer chip at the bottom of the sidebar (in every app) with „Start“ / „Stop“, and „Neuer Timer“ (New timer) in Workmanagement › Zeiterfassung › Erfassungsansicht (Guides › Time tracking). Starting shows the message „Timer gestartet“; the chip counts the elapsed time.
Fields
Section titled “Fields”| Field | Technical | Type | Required | Meaning | Notes |
|---|---|---|---|---|---|
| Running time | active.startedAt |
Timestamp | yes | Start timestamp from which the chip computes the elapsed time | System |
| Date | active.date |
Date | yes | Day of the start (weekday in the stop dialog) | System; becomes the day of the timer |
| Start time | active.startTime |
Time | yes | Time of day of the start | System; becomes the start time of the timer |
| User | app_user_id |
Reference | yes | Owner | Unique: one active timer per user |
active is empty when no timer is running.
Relations
Section titled “Relations”| Related to | Kind | Required | On archive | On delete |
|---|---|---|---|---|
| User | belongs to (1:1) | yes | — | kept |
States
Section titled “States”no timer ──„Start“──► running ──„Stop“──► no timer (+ new timer record)A second start replaces the running draft; a start on another device appears everywhere immediately.
Rules & automation
Section titled “Rules & automation”- Stopping immediately creates a Timer with date, start and end time and opens the dialog „Zeit erfasst“ (Time recorded). The timer chip stops even if saving fails („Timer gestoppt – Zeit konnte nicht gespeichert werden“).
- An unreadable draft is discarded („Timer-Daten ungültig – Timer verworfen“).
- The timer carries no project or task reference; the assignment follows in the tracking view.