Agenda: visualizações, filtros e popup rápido

Referência completa da Agenda (/admin/<slug>/calendar) — o painel operacional onde você gerencia o seu dia a dia.

Visualizações

Você troca no botão Dia / Semana. Sua escolha fica salva por negócio e por tipo de dispositivo: se escolher “Semana” no computador, no celular vai continuar abrindo em “Dia”.

Na visualização semana, o cabeçalho de cada dia é um link: toque nele e você vai para a visualização dia daquela data.

A data não é salva. A agenda sempre abre no dia de hoje.

Navegar entre datas

Filtros

Dois filtros ficam sempre visíveis acima da agenda, e o resto está no painel “Mais filtros”.

Filtros principais

Mais filtros (painel recolhível)

Por padrão a agenda mostra Pendente, Confirmada, Remarcada e Concluída. As canceladas, rejeitadas e no-show ficam ocultas até você marcar o chip delas.

Os filtros ficam salvos na sua sessão, por negócio e por tipo de dispositivo — voltam a valer na próxima vez que você abrir a agenda. O botão “Limpar filtros” devolve tudo aos valores iniciais.

Status visuais

Abaixo da agenda há uma legenda com as mesmas cores dos blocos:

Cada bloco de reserva mostra:

• O horário de início e o nome do cliente (com o avatar do profissional).
• Os serviços, se o bloco for alto o bastante.
• Duração e preço, se for ainda mais alto.
• Uma barra vertical colorida na borda esquerda, com a cor do profissional.

A altura do bloco é a duração: uma reserva de 60 min ocupa o dobro de uma de 30.

Os bloqueios são desenhados com listras diagonais e um ícone conforme o alcance: Todo o negócio, Unidade inteira ou o avatar do membro da equipe.

Detalhe de uma reserva

Ao tocar um bloco abre um popup flutuante (dá para movê-lo arrastando o cabeçalho; Esc fecha) com:

• Status e código da reserva.
• Nome do cliente, data e horário.
• Profissional atribuído.
• Serviços com a duração e o total.
• Email e WhatsApp do cliente.
• Observações do cliente.

Ações disponíveis no popup

Rejeitar não está no popup da agenda: está na página da reserva e na lista “Pendentes de confirmação” do Dashboard.

Criar reserva arrastando

1. Em um espaço vazio, arraste para baixo com o mouse a duração que quiser. O intervalo se ajusta de 15 em 15 minutos.
2. Ao soltar, abre o formulário rápido com data, hora e intervalo já preenchidos.

Se você só clicar em um espaço vazio (sem arrastar), abre o mesmo formulário com aquele horário de início; o fim é calculado pelo serviço que você escolher.

Os espaços clicáveis são de meia hora. Na visualização por dia eles aparecem só dentro do horário da unidade e do horário daquele profissional naquele dia, e pulam os horários em que o profissional já tem uma reserva em outra unidade. Se a unidade está fechada naquele dia, a coluna não tem nenhum espaço clicável. Na visualização por semana o recorte é só pelo horário da unidade: não há coluna por profissional para estreitar mais.

As pausas não são removidas: o card de “Pausa” é desenhado por cima do espaço, mas deixa o clique passar, então o espaço é clicável do mesmo jeito e o formulário rápido abre. É ali que você é barrado — ele avisa que aquele profissional não está disponível nesse horário e não deixa criar a reserva.

Reagendar uma reserva

1. Toque na reserva na agenda.
2. Toque em Reagendar.
3. No popup você muda data, hora, serviços e profissional. O cliente não pode ser trocado aqui.
4. Toque em Salvar novo horário.

O que o sistema faz ao reagendar:

• Mantém o status: uma reserva confirmada continua confirmada, uma pendente continua pendente.
• Reenvia ao cliente o email da reserva, com um .ics que atualiza o evento no calendário dele em vez de duplicar.
• Move o lembrete para o novo horário.
• Se você trocou de profissional, o anterior recebe um cancelamento de calendário e o novo recebe o convite.
• Escreve uma linha no Histórico da reserva com o horário antigo e o novo.

Só dá para reagendar reservas pendentes ou confirmadas. Uma concluída, cancelada, rejeitada ou no-show não se move: o botão não aparece.

Se o profissional não estiver livre no novo horário, ou o local estiver fechado naquele dia da semana, o formulário recusa a mudança e diz o motivo.

Criar bloqueio pela agenda

No formulário rápido, no alto à esquerda, há duas abas: Reserva e Bloqueio. Ao passar para “Bloqueio”, o intervalo que você arrastou é mantido.

O formulário de bloqueio pede:

Não há repetição automática: uma pausa semanal fixa se cadastra no horário de trabalho do profissional, não como bloqueio. Veja Bloquear horários.

Sincronização com calendário externo

Cada profissional com “Receber convites de calendário” ativado (vem ativado) recebe um .ics por email a cada nova reserva. Ao abrir, o evento entra no Google Calendar, Apple Calendar, Outlook ou qualquer app que suporte .ics.

Se a reserva mudar de horário, sai um novo .ics com o mesmo identificador — os calendários atualizam o evento em vez de duplicar. Se for cancelada, sai o cancelamento.

Atalhos de teclado

A agenda não tem atalhos de teclado. Não existem teclas para trocar de visualização, navegar entre datas ou abrir o formulário, e o duplo clique não faz nada diferente de um clique.

A única tecla que responde é Esc, que fecha o popup aberto.

Os espaços da agenda são botões, então dá para navegar com Tab e abrir com Enter.

Comportamento no celular

Atualização automática

A agenda se atualiza sozinha a cada dois minutos e meio, sem recarregar a página, sem perder sua posição de rolagem e sem mexer num popup aberto.

Permissões por papel

Problemas comuns