Planejador de escala rotativa

Intervalos inválidos, dias de calendário impossíveis e campos de ciclo fora da faixa falham com invalid_input e nunca são cobrados.

O que um ciclo rotativo de trabalho e folga significa para um trabalhador

O dia zero do ciclo é o primeiro dia de um bloco de trabalho quando cycle_offset vale zero. Para qualquer índice de dia i contado a partir de start_date (base zero), day_in_cycle é o resto de i mais cycle_offset dividido por cycle_length, onde cycle_length é on_days mais off_days. Se esse resto for estritamente menor que on_days o dia está on; caso contrário está off. O clássico 4x4 usa portanto on_days quatro e off_days quatro, um ciclo de oito dias e uma razão de trabalho de longo prazo de um meio. Definir off_days como zero força todos os dias on dentro da janela, às vezes útil como escala base de disponibilidade total.

Contrato de entrada, formato da resposta e regras de validação

O campo formula reafirma a regra modular em texto simples para trilhas de auditoria. Envie por POST um corpo JSON com quatro campos obrigatórios e dois opcionais. start_date e end_date devem ser strings de calendário gregoriano reais na forma estrita YYYY-MM-DD; o intervalo é inclusivo nos dois extremos e end_date não deve preceder start_date. O trecho inclusivo pode ter no máximo trezentos e sessenta e seis dias para que o tamanho da resposta fique limitado no navegador e nos clientes da API. on_days é um inteiro positivo de um a noventa; off_days é um inteiro de zero a noventa. cycle_offset tem padrão zero e, quando informado, deve ficar entre zero e cycle_length menos um, para que uma fase de admissão no meio do ciclo não aponte além do fim do ciclo. worker_name é um rótulo opcional de no máximo cento e vinte caracteres ecoado no sucesso quando presente. Aliases são aceitos por ergonomia: from ou begin para start_date, to ou until para end_date, work_days para on_days, rest_days para off_days, offset ou phase para cycle_offset, e name ou employee para worker_name. No sucesso o corpo devolve as datas e parâmetros de ciclo normalizados, pattern como string curta do tipo four-on slash four-off, total_days, days_on, days_off, work_ratio arredondada half-up a seis decimais, um array roster de objetos com date, day_in_cycle e status on ou off, além dos arrays paralelos on_dates e off_dates para filtragem rápida. Datas impossíveis como trinta e um de abril, trecho negativo, trecho acima do máximo, on_days zero ou não inteiro, ou cycle_offset igual ou maior que cycle_length falham com invalid_input nomeando o campo; essas falhas não consomem saldo pré-pago. O preço das chamadas bem-sucedidas é um valor fixo US$ 0,002 com unidade item.

Onde a expansão da escala rotativa justifica o uso

Supervisores de site que planejam um mês 4x4 precisam de uma lista rápida de quais datas do calendário um técnico trabalha antes de publicar o quadro de avisos. Landings de conteúdo e SEO que ranqueiam por planejador de escala rotativa ou roster 4x4 se beneficiam de uma calculadora gratuita ao vivo cujas saídas batem byte a byte com o caminho de automação pago na lib compartilhada. Prefira esta capacidade quando a pergunta for expansão pura de ciclo para uma pessoa; equidade multi-equipe, regras sindicais, misturas de competências e calendários de afastamento exigem um produto de gestão de força de trabalho mais completo. Validação com falha é gratuita, assim clientes exploratórios podem testar offsets inválidos e datas ruins com segurança. Fluxos de admissão de RH podem passar a data de contratação como start_date com cycle_offset diferente de zero para que o novo colaborador entre na rotação existente no meio do ciclo em vez de reiniciar no dia zero. Pré-processadores de folha contam days_on dentro de um período de pagamento para cruzar as horas ordinárias esperadas antes de aplicar regras de hora extra. Simuladores de quadro comparam work_ratio entre padrões candidatos—2x2 versus 4x4 versus 5x2—sem escrever scripts sob medida a cada vez. Equipes de integração embutem a API em ferramentas internas para que programadores de escala nunca reescrevam tabelas modulares à mão. Mantenha as solicitações dentro do teto de trezentos e sessenta e seis dias; para planejamento plurianual, chame o endpoint uma vez por janela anual e una os resultados no cliente.