Manutenção preventiva: agendamentos multiativo

Um agendamento preventivo define o que fazer, com que frequência e onde. O "onde" é plural por design — um agendamento pode se desdobrar em muitas ordens de serviço a cada ciclo.

Anatomia de um agendamento

Quando você clica em + Novo agendamento em Serviço de Campo → Preventiva, o formulário tem três seletores múltiplos (clientes, ativos, responsáveis), um seletor único de projeto e a cadência padrão (semanal / mensal / trimestral / semestral / anual + um multiplicador "a cada N").

O desdobramento: uma ordem de serviço por ativo vinculado, a cada ciclo.

• 1 agendamento × 8 ativos × mensal = 8 ordens todo mês.
• 1 agendamento × 0 ativos × mensal = 1 ordem genérica todo mês (comportamento legado de ordem única).

O ciclo

Uma tarefa agendada (Vercel Cron) diária roda às 5h UTC e:

1. Encontra todos os agendamentos ativos com nextDueAt <= now.
2. Para cada um, cria uma ordem por ativo vinculado.
3. Se houver um projeto vinculado, cada ordem gerada é anexada a esse projeto (útil para consolidação de contrato).
4. Avança o cursor do agendamento pela cadência (para o próximo disparo ficar corretamente espaçado).

Resolução da conta por ordem

Quando um ativo está vinculado a vários clientes, o Roldesk escolhe o cliente a colocar na ordem gerada usando:

1. O cliente principal vinculado ao ativo, se ele coincidir com os clientes do agendamento.
2. Caso contrário, o primeiro cliente do agendamento.

Efeito líquido: as ordens geradas são faturadas ao cliente certo sem você precisar pensar nisso.

Botão "Executar agora"

Precisa testar um agendamento? O botão Executar agora em qualquer linha força a geração das ordens independentemente da data de vencimento. O cursor ainda avança exatamente uma vez. Não afeta a cadência normal do cron.

Relacionado

• Configurar manutenção recorrente — o artigo original, ainda preciso
• Duplicar ordens de serviço em massa — a ferramenta certa para lotes pontuais