Pular para o conteúdo principal

Recorrência e versionamento

ReferênciaParaQuem integra ou mantémLeitura4 min

A recorrência mora na atribuição, não na tarefa. A mesma tarefa pode abrir todo dia numa loja e uma vez só em outra.

Recorrência​

O relógio é o fuso de cliente.fuso. O dia da semana é o ISO: 1 é segunda e 7 é domingo.

RecorrênciaQuando nasce a execuçãoPeríodo
abertura, fechamento, diariaTodo dia em que a tarefa está publicada.O dia de hoje no fuso da rede.
semanalNos diasSemana informados.O dia de hoje.
unicaQuando dataUnica já chegou, inclusive se o dia passou.A própria dataUnica, então não repete.

abertura, fechamento e diaria usam o mesmo motor. O nome distingue o momento operacional. A hora de cada uma é o horarioLimite daquela atribuição.

Campos obrigatórios da agenda:

  • horarioLimite em HH:MM. É a hora em que a execução vale. A geração grava esse instante como limite_em.
  • prazoMinutos, inteiro maior que zero. O prazo de conclusão é limite_em mais esses minutos.
  • diasSemana só na semanal, com ao menos um dia de 1 a 7.
  • dataUnica em YYYY-MM-DD só na única.

Se a coluna nascer sem agenda explícita, o banco assume recorrência diária, limite 08:00 e prazo de 60 minutos.

Quando a execução aparece​

Não há endpoint para disparar a geração. Ela roda em dois lugares:

  1. No agendador da API, a cada 5 minutos, para cada rede ativa. SCHEDULER=off desliga essa passada.
  2. Quando alguém com permissão de ver o checklist chama a lista de hoje. A passada gera o que está devido e marca como atrasado o que já passou de prazo_em.

A geração não espera o relógio. Abertura, fechamento e diária criam a execução de hoje mesmo que horarioLimite ainda vá chegar, ou já tenha passado. Antes do limite, a lista de quem executa mostra Mais tarde. Depois do prazo, mostra Atrasado. Os dois abrem. A faixa depois de publicar pode dizer que a primeira execução libera amanhã, quando o horário de hoje já passou. A de hoje existe assim que alguém abre a lista.

Na tela, Libera às vira horarioLimite. Prazo é outro horário, no mesmo dia, e a diferença em minutos vira prazoMinutos. Os dias da semana só são enviados na recorrência semanal. O interruptor de avisar o dono não é gravado.

A geração só considera tarefa publicado, atribuição cargo_local ou pessoa, e a última versão com publicado_em preenchido. Local inativo não recebe execução por cargo. A exceção não cria linha: na hora de assumir, a pessoa excluída não vê aquela execução como sua.

Por cargo, a execução nasce sem usuario. O primeiro do cargo, naquele local, que abrir fica responsável. Por pessoa, a execução já nasce no nome dela.

Uma passada repetida não duplica. O conflito da chave tarefa + versão + local ou pessoa + período é ignorado.

Versionamento​

  1. Criar a tarefa grava a versão 1 como rascunho, sem publicado_em.
  2. Editar o rascunho substitui as atividades dessa versão.
  3. Publicar preenche publicado_em, passa a tarefa para publicado e congela a versão. Publicar exige ao menos uma atividade. Sem rascunho aberto, publicar responde que não há rascunho.
  4. Editar de novo uma tarefa já publicada cria a versão seguinte, ainda rascunho. A versão anterior continua publicada e é a que a geração usa.
  5. Publicar esse rascunho congela a versão nova. A partir daí, as execuções novas nascem nela.
  6. Arquivar tira a tarefa da geração. Arquivado não é editado nem publicado de novo.

A execução guarda versao_id. Um gatilho recusa trocar essa versão. Quem já começou continua no modelo em que abriu, mesmo depois de uma publicação nova.

Arquivar não apaga execuções já abertas. Elas seguem até serem concluídas, aprovadas ou devolvidas.