Criar agendamento recorrente pelo painel admin

Você pode marcar um agendamento como recorrente direto pelo painel admin, sem pedir para o cliente abrir o site da barbearia. O agendamento principal é criado imediatamente; os demais (próximos 3 meses) entram automaticamente na agenda.

Pré-requisitos

Plano com o recurso recurring_bookings habilitado. Se o plano não tiver, a seção "Agendamento recorrente" no formulário não aparece — veja como liberar.
O agendamento precisa ter um cliente cadastrado (não funciona com visitante anônimo / sem cadastro) — uma série exige um cliente para associar as próximas ocorrências.
Não é possível marcar como recorrente:
- um agendamento passado (retroativo)
- um encaixe / walk-in com cliente avulso (sem cadastro). Encaixe com cliente cadastrado funciona — veja abaixo.
- uma edição de um agendamento já criado

Onde aparece o controle

A seção "Agendamento recorrente" fica disponível em duas formas de criar agendamento pelo painel:

Nova reserva (agendamento programado para uma data/hora futura): controle visível e habilitado assim que você preenche cliente, serviço e horário.
Atender agora (encaixe / walk-in): controle visível somente quando você seleciona um cliente cadastrado. Com visitante anônimo (campos "Nome" e "Telefone" preenchidos manualmente), o controle aparece desabilitado com a dica "Selecione um cliente registrado para criar série".

A engine por trás é a mesma nos dois fluxos — depois de salvar, a série gera as próximas ocorrências automaticamente independente de qual formulário a criou.

Como ativar

Abra Nova reserva pela agenda ou pelo botão de criar agendamento. Funciona também em Atender agora (encaixe), desde que você selecione um cliente cadastrado em vez de digitar nome/telefone manualmente.

Preencha cliente, serviço, profissional, data e horário normalmente.

Role até a seção Agendamento recorrente (logo acima de Produtos). Clique para expandir.

Ative o botão Repetir agendamento. Escolha a frequência:

Semanal (toda semana, no mesmo dia)
A cada 2 semanas (quinzenal)
A cada 3 semanas
A cada 4 semanas (mensal por semana — sempre no mesmo dia da semana)

Salve. O sistema cria o primeiro agendamento (visível na agenda) e fica gerando os próximos automaticamente até cobrir os próximos 3 meses.

O que acontece depois

O sistema cria a série (BookingSeries) e vincula o primeiro agendamento a ela.
As próximas ocorrências são criadas imediatamente (até o horizonte de 3 meses configurado para o seu negócio, ou o limite máximo definido em "Configurações > Regras > Antecedência máxima", o que for menor).
Um cron rodando todos os dias estende a série automaticamente, mantendo sempre 3 meses de agendamentos pré-marcados à frente.
Conflitos de horário em datas futuras são ignorados (a série pula a data conflitante sem cancelar a série inteira).
Se o primeiro agendamento cair em cima de outro e você usar sobrescrever conflito para forçar o horário, a série continua sendo criada normalmente. A sobrescrita vale só para o primeiro horário; cada ocorrência futura é checada de forma independente e as que estiverem ocupadas são puladas.

Gerenciar a série depois

Veja Gerenciar séries recorrentes (pausar, retomar, cancelar, reagendar) para os controles de ciclo de vida da série (pausar para férias, reagendar para outro dia da semana, cancelar inteira).

Diferenças vs. o agendamento recorrente do cliente

O recurso é o mesmo — o cliente pelo site da barbearia e o admin pelo painel batem na mesma engine. As únicas diferenças:

Cliente: marca pelo card "Repetir agendamento" na etapa de confirmação do site.
Admin: marca pela seção "Agendamento recorrente" no formulário de nova reserva.
IA (chat / WhatsApp): quando o cliente pede "marca toda semana", a ferramenta scheduleSeries cria a série. Mesmo gate de plano se aplica.

Todos os caminhos passam pelo mesmo serviço canônico (createBookingByOwner → createSeriesOccurrences), então a fan-out, os conflitos, e o cron de extensão se comportam exatamente igual.

Limitações conhecidas (Fase 4)

A interface atual só expõe frequência semanal com intervalo de 1 a 4 semanas. O backend já suporta:

Frequência mensal (mesmo dia do mês)
Limite total de ocorrências (count)
Data de término (until)
Datas excluídas (exceptions[] — pular feriados ou férias específicas)

Esses campos estão disponíveis via Reagendar série e via ferramentas de IA, mas a interface do formulário ainda não expõe controles diretos para eles. Uma fase futura adiciona esses controles na própria seção do formulário.