Skip to content

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.

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)

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.

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.

Related to Kind Required On archive On delete
User belongs to (1:1) yes — kept
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.

  • 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.

Timer · Time log