# Registo de tempo no Todomator: temporizadores, entradas manuais e o tempo mínimo

> Como o Todomator regista o tempo gasto num ticket: um temporizador de início/paragem, entradas manuais, os minutos mínimo e máximo, e como o total de um ticket é mantido.

Framework: todomator
Product: Todomator (todomator@1.7)
Language: pt
Content-SHA256: 25e7eb325308c01cd57764a27145cb37e724023c089f86ec46dab9eb7cd7fd8a
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: 
Review: not-recorded

O Todomator regista o tempo de trabalho na tabela `tbl_ticket_time` e guarda a soma no campo `worked` (minutos) do ticket. As ações estão em `schemas/tickets.js`.

## O temporizador

- **Início** (`logwork_start`): abre um temporizador num ticket para o utilizador atual. Se o ticket estava `pending`, o seu estado muda automaticamente para `open`.
- **Paragem** (`logwork_stop`): fecha o temporizador e soma ao ticket os minutos decorridos (arredondados por excesso). Um único temporizador conta no máximo **8 horas**, e nunca menos do que a definição `minlogtime`.
- **Temporizadores abertos** (`logwork_open`): lista os temporizadores que o utilizador tem a correr.

## Entradas manuais

`logwork_create` acrescenta uma entrada com o ticket, os minutos, uma data e uma nota opcional; `logwork_update` e `logwork_remove` alteram-na ou apagam-na, e após uma atualização o total do ticket é recalculado a partir de todas as suas entradas. As entradas nunca são menores do que `minlogtime`. Pode também passar `worked` ao criar um ticket (também através da [API](/en/todomator/create-tickets-with-the-api/)): o Todomator regista então uma entrada com esses minutos.

## A definição

`minlogtime` (minutos, 1 por predefinição) está nas [definições](/en/todomator/settings-and-database/). É a entrada mais curta que o Todomator regista, o que evita linhas de zero minutos.

## Notificações e faturação

Cada tempo registado notifica as outras pessoas do ticket e atualiza-o em direto para quem o pode ver. O indicador `isbillable` do ticket (herdado da pasta) marca o tempo que fatura, e os plugins premium de relatórios e carga de trabalho dos utilizadores assentam nestes registos.