Recorrência e versionamento
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ência | Quando nasce a execução | Período |
|---|---|---|
abertura, fechamento, diaria | Todo dia em que a tarefa está publicada. | O dia de hoje no fuso da rede. |
semanal | Nos diasSemana informados. | O dia de hoje. |
unica | Quando 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:
horarioLimiteemHH:MM. É a hora em que a execução vale. A geração grava esse instante comolimite_em.prazoMinutos, inteiro maior que zero. O prazo de conclusão élimite_emmais esses minutos.diasSemanasó na semanal, com ao menos um dia de 1 a 7.dataUnicaemYYYY-MM-DDsó 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:
- No agendador da API, a cada 5 minutos, para cada rede ativa.
SCHEDULER=offdesliga essa passada. - 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
atrasadoo que já passou deprazo_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
- Criar a tarefa grava a versão 1 como rascunho, sem
publicado_em. - Editar o rascunho substitui as atividades dessa versão.
- Publicar preenche
publicado_em, passa a tarefa parapublicadoe congela a versão. Publicar exige ao menos uma atividade. Sem rascunho aberto, publicar responde que não há rascunho. - 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.
- Publicar esse rascunho congela a versão nova. A partir daí, as execuções novas nascem nela.
- 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.