ForgeTodomator
pt

Todomator

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

Todomator · todomator@1.7 todomatortime trackingbilling

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): o Todomator regista então uma entrada com esses minutos.

A definição

minlogtime (minutos, 1 por predefinição) está nas definições. É 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.