Como marcar e gerenciar horários na agenda do Genda

A Agenda

A Agenda é a tela principal do sistema. Ela abre em /admin/calendar e mostra sempre o mesmo dia até você trocar.

Duas formas de ver o dia: Lista e Grade

No topo da Agenda há dois botões: Lista e Grade.

• Listaé a visão que abre por padrão. Ela mostra os agendamentos do dia em ordem de horário, um embaixo do outro, com os horários livres aparecendo no meio como convite para marcar. É a visão pensada para o dia a dia: “quem vem agora?”.
• Grade mostra a agenda em colunas, uma por profissional, como um calendário de horas. É a visão para enxergar encaixe — ver rapidinho onde cabe mais um cliente.

Trocar de dia

No cabeçalho da Agenda você tem os botões de dia anterior, dia seguinte, um botão Hoje que volta direto para a data de hoje, e um seletor de data para pular direto para qualquer dia.

Ver por profissional

• No computador, se a barbearia tem mais de um profissional, aparecem “pílulas” com a foto (ou a inicial) de cada um, incluindo uma pílula Todos. Clique numa pílula para ver só a agenda daquele profissional; clique em Todos para ver a casa inteira.
• No celular a tela mostra sempre um profissional por vez — não existe a opção “Todos” no celular, porque a tela é estreita demais para mostrar várias colunas ao mesmo tempo.
• Se você é um profissional com acesso restrito (só enxerga a própria agenda), o seletor nem aparece: você já vê direto a sua agenda.

O resumo do dia

No cabeçalho, ao lado da data, a Agenda mostra um resumo rápido do dia — quantos agendamentos, faltas e cancelamentos — considerando só os profissionais que estão sendo exibidos no momento (se você filtrou por um barbeiro, o resumo é dele, não da casa toda).

O que cada status significa

Cada agendamento tem uma cor e um rótulo, e o significado é o mesmo em toda a tela — na grade, na lista e na ficha do agendamento.

Filtrar e buscar

Na barra logo abaixo do cabeçalho você encontra:

• Um campo de busca por nome ou telefone do cliente.
• Chips de status (Agendado, Confirmado, Concluído, Cancelado, Não compareceu, Aguardando Pix) — clique para ligar/desligar cada um.
• Um chip 💰 Pagos — mostra só quem já pagou algum sinal adiantado.
• No computador, se há mais de um profissional, chips com o nome de cada um para filtrar por quem atende.

No celular essa barra vem recolhida por padrão (para não ocupar espaço); toque no ícone de filtro para abri-la. Se algum filtro diferente do padrão estiver ligado, aparece uma bolinha no ícone avisando que a agenda não está mostrando tudo.

A timeline: vagas livres, intervalo e convites de encaixe

Quando a Lista está focada em um único profissional (seja porque você escolheu uma pílula no computador, seja porque é assim que o celular sempre mostra), o primeiro dia da lista ganha uma “timeline”: além dos agendamentos, aparecem também:

• Linhas de vaga livre(“vago”) — um convite para marcar alguém ali. Clique para abrir o formulário já com aquele horário e profissional preenchidos.
• O intervalo do turno (o almoço, por exemplo), marcado como indisponível.
• Convites de encaixeantes da abertura e depois do fechamento do expediente (“Encaixar antes do expediente” / “Encaixar após o expediente”), quando fizer sentido.

Se a agenda estiver cheia de vagas livres e isso estiver atrapalhando a leitura, use o botão Ocultar vagas / Mostrar vagas no topo do grupo do dia. Bloqueios e intervalos continuam aparecendo mesmo com as vagas ocultas, porque eles explicam por que aquele período não está disponível.

Como marcar um horário

Você pode marcar um novo horário de duas formas: clicando num espaço vazio da agenda, ou pelo botão de novo agendamento.

Pelo botão

1. No computador, clique em Novo agendamento no canto superior direito.
2. No celular, toque no botão redondo azul (+) no canto inferior direito da tela.
3. Preencha o formulário (veja os campos abaixo) e toque em Confirmar Agendamento.

Clicando direto na vaga

Na Lista, toque numa linha “vago” da timeline — o formulário abre com o profissional e o horário já preenchidos. Na Grade, clique num espaço vazio da coluna do profissional.

Os campos do formulário

• Profissional — obrigatório quando você não veio de uma vaga já clicada.
• Data e Horário— a agenda mostra os horários livres em blocos (“chips”); toque no horário desejado. Horários já passados no dia de hoje ficam escondidos por padrão — use Ver horários passados se precisar lançar um atendimento esquecido. Se não houver vaga nenhuma naquele dia, o sistema oferece o botão Ver amanhã.
• Serviço — obrigatório. A lista mostra só os serviços que aquele profissional realmente presta, com o preço de cada um.
• Cliente — obrigatório. Você pode buscar um cliente já cadastrado ou digitar nome e telefone na hora (o sistema cria o cadastro sozinho). Se o telefone digitado já é de um cliente cadastrado, o sistema avisa e usa o nome da ficha existente.
• Se o telefone já tem um cliente titular com dependentes cadastrados, aparece um campo “Para quem é este horário?” para escolher se o atendimento é para o titular ou para um dos dependentes.
• Se você acabou de atender alguém, os últimos 3 clientes atendidos aparecem como atalhos de um toque acima do campo de cliente.

Ao final, o botão muda de nome: Confirmar Agendamento para um horário novo avulso, Criar série recorrente se você configurou uma recorrência (veja abaixo), ou Salvar Alterações quando está editando um agendamento existente.

Se o horário está ocupado

Se você escolher um horário onde já existe outro agendamento, aparece um aviso “Horário ocupado” mostrando quem já está marcado ali. Você pode confirmar mesmo assim — o novo agendamento entra como encaixe, e os dois ficam na agenda ao mesmo tempo.

Marcar um agendamento que se repete (recorrência)

Dentro de Mais opções, você encontra a seção Repetir (só aparece ao criar um agendamento novo — não dá para tornar um agendamento já existente recorrente).

• Frequência: Não repete, Semanal ou Mensal.
• Semanal: escolha “a cada quantas semanas” e o dia da semana.
• Mensal: escolha entre um dia fixo do mês (ex.: todo dia 15) ou uma posição (ex.: toda primeira segunda-feira).
• Termina: Nunca, numa data específica, ou depois de X vezes.

Um resumo em texto (“toda segunda-feira às 14:00”, por exemplo) aparece acima do botão de confirmar, para você conferir antes de criar a série.

Mexer num agendamento existente

Toque em qualquer agendamento na Lista ou na Grade para abrir os detalhes. De lá você pode:

Concluir o atendimento

Toque em Concluir atendimento. Abre a tela de pagamento, onde você registra:

• Forma de pagamento (Dinheiro, Pix, Cartão, etc.) — se o cliente já tinha dito no agendamento como pretendia pagar, essa forma já vem pré-selecionada.
• Tipo de cartão (débito ou crédito), se escolheu Cartão — importante porque a taxa da maquininha muda conforme o tipo.
• Valor do serviço — vem preenchido com o preço do serviço; se o campo ficar vazio, o sistema usa o preço de tabela.
• Pagamento único ou Dividir pagamento (parte em dinheiro, parte no cartão, por exemplo).
• Se recebeu em dinheiro, um campo para o valor recebido, que calcula o troco automaticamente.
• Você também pode adicionar produtos vendidos durante o atendimento (pomada, óleo de barba, etc.) direto nessa tela, antes de fechar.
• Se o cliente pagou um sinal adiantado pelo Pix na hora de agendar, a tela já desconta esse valor e mostra quanto falta receber no balcão.
• Se o atendimento estava coberto por mensalidade, a tela oferece fechar com Concluir com a mensalidade (sem cobrança) ou trocar para Cobrar um valor avulso, caso o cliente tenha pedido algo fora do plano.

Ao terminar, toque em Concluir.

Trocar o serviço depois de concluído (corrigir o caixa)

Depois que um atendimento já foi concluído, você ainda pode reabrir a mesma tela de pagamento para corrigir o que foi registrado — por exemplo, o cliente sentou para um Corte e acabou pedindo Corte + Barba na cadeira. Nesse caso a tela mostra o campo Serviço realizado, onde dá para trocar o serviço antes de salvar. Ao trocar, o botão principal diz Salvar, e o sistema avisa: “O serviço do atendimento será trocado ao salvar. Adicionais lançados no serviço anterior são removidos.”

Remarcar (arrastar ou editar)

Na visão Grade, você pode arrastar o card do agendamento e soltar em outro horário ou outra coluna — o sistema remarca na hora, sem precisar abrir formulário nenhum.

Também dá para tocar no agendamento e escolher Editar / Remarcar nos detalhes, o que abre o mesmo formulário de criação já preenchido, pronto para você trocar data, hora, profissional ou serviço.

Trocar o serviço antes de atender

Ainda não concluiu? Abra Editar / Remarcar nos detalhes do agendamento — lá o campo Serviço pode ser trocado como qualquer outro campo do formulário.

Cancelar

Nos detalhes do agendamento (que ainda não foi concluído), toque em Cancelar agendamento. O sistema pede uma segunda confirmação — Confirmar cancelamento — antes de desmarcar de verdade.

Marcar falta (não compareceu)

Em um atendimento já concluído automaticamente pelo sistema mas onde o cliente na verdade não apareceu, toque em Não compareceu nos detalhes. O sistema explica o efeito antes de confirmar: “Sai do faturamento e da comissão. O horário continua no histórico como falta.” Depois, toque em Confirmar falta.

Agendamento recorrente: essa ocorrência ou a série toda?

Ao editar ou cancelar um agendamento que faz parte de uma série recorrente, o sistema pergunta o alcance da mudança antes de aplicar — se é só aquela data, as datas futuras, ou a série inteira.

Encaixe

Encaixe é um agendamento fora da grade normal de horários — seja porque cai em cima de outro atendimento, seja porque cai fora do expediente (na hora do almoço, antes de abrir ou depois de fechar).

Você usa encaixe quando:

• Escolhe um horário que já está ocupado por outro cliente (o sistema pergunta se você quer entrar como encaixe).
• Quer marcar alguém num intervalo do turno (almoço) ou fora do expediente — as linhas de “Encaixar antes/após o expediente” na timeline levam direto para isso.
• Ativa manualmente o interruptor Encaixe, dentro de Mais opções do formulário de agendamento, e escolhe Horário do encaixe livremente (qualquer horário, sem estar preso à grade de vagas).

Na tela de detalhes, um agendamento de encaixe leva a marca “Encaixe — fora da grade normal” para deixar claro que ele não segue o expediente padrão.

Clientes

A tela de Clientes fica em /admin/clients e lista todos os clientes cadastrados.

Buscar e filtrar

No topo da lista há um campo de busca por nome ou telefone. Abaixo, uma barra de filtros rápidos:

• Sumidos 30d / 60d / 90d — clientes que já vieram e não voltam há mais de 30, 60 ou 90 dias.
• Mensalistas — só clientes com assinatura ativa.
• Dependentes — alterna entre ver todos, só dependentes ou só titulares.
• Novos (30d) — cadastrados nos últimos 30 dias.
• Aniversariantes de [mês] — clientes que fazem aniversário no mês escolhido (o mês corrente por padrão).
• Arquivados — mostra só quem foi arquivado.

Há um botão Limpar para tirar todos os filtros de uma vez, que só aparece quando algum filtro está ativo.

Cadastrar um cliente novo

1. Clique em Novo cliente.
2. Preencha Nome (obrigatório) e Telefone (obrigatório na criação — é a identidade do cliente e o número que recebe as mensagens de lembrete).
3. E-mail, Aniversário, CPF e Notas são todos opcionais.
4. Se o cliente já era atendido antes de você usar o sistema, há um bloco “Já é cliente de antes?” onde você pode registrar a data do último atendimento (com serviço e profissional) — isso não lança nada no caixa, mas faz o cliente já entrar valendo nas suas regras de desconto por recência.
5. Toque em Criar cliente.

O que tem na ficha do cliente

Ao abrir um cliente (/admin/clients/:id), você vê várias seções:

Dados do cliente— Nome, Telefone (não editável direto — veja “Trocar telefone” abaixo), E-mail, Aniversário, CPF e Notas internas (o cliente nunca vê essas notas). O botão Salvar dados grava as mudanças.

Trocar telefone — como o telefone é a identidade do cliente, ele não pode ser editado como um campo qualquer. Clique em Trocar telefone, digite o novo número e confirme em Confirmar troca. O sistema avisa antes: essa troca invalida todos os links pessoais já enviados e desconecta os aparelhos do cliente — os lembretes passam a ir para o número novo.

Dependentes — pessoas atendidas no telefone deste cliente mas que não têm número próprio (um filho, por exemplo). Aqui você pode:

• Adicionar dependente (nome, nascimento, CPF e observações — sem telefone nem e-mail próprios).
• Editar um dependente já cadastrado.
• Promover um dependente a titular, quando ele ganha celular próprio.
• Mover um dependente para outro titular.
• Arquivar um dependente.

Se o titular tem mensalidade ativa, a seção avisa se o plano cobre ou não os dependentes.

Preço combinado (quando a barbearia usa preços dinâmicos) — permite registrar um preço combinado na mão com este cliente específico, que vence as regras automáticas de desconto.

Link pessoal de agendamento (quando ativado) — um link que identifica o cliente na página pública, para ele entrar já reconhecido. Os botões são Copiar link e Renovar link pessoal (renovar invalida os links antigos já enviados).

Histórico de agendamentos — lista os atendimentos passados do cliente, com serviço, data, valor e status. Mostra quantos de quantos estão carregados, com um botão Carregar mais para ver o restante.

Produtos comprados (quando a barbearia vende produtos) — lista o que o cliente já comprou, com o total gasto.

Arquivar cliente — tira o cliente da lista e das buscas sem apagar nada; o histórico continua e ele ainda pode agendar pela página pública. É reversível: o botão vira Desarquivar.

Bloquear cliente — impede que o cliente agende sozinho pela página pública ou pelo link pessoal, sem avisá-lo. Você continua podendo marcar horário por ele no painel, e o que já estava marcado continua na agenda. Também reversível (Desbloquear).

Excluir cliente (zona de risco, sem volta) — duas opções bem diferentes:

• Remover cliente: apaga os dados pessoais (nome, telefone, e-mail, CPF, notas) para sempre, mas o histórico de atendimentos e os relatórios de faturamento continuam intactos, sem identificação.
• Excluir definitivamente: apaga o cliente e tudo que está ligado a ele — atendimentos, mensalidades, vendas e dependentes. Os relatórios do passado mudam, inclusive meses já fechados.

Bloqueios e folgas

Use a tela Folgas e feriados (/admin/folgas) para fechar um profissional ou a barbearia inteira em um período — férias, folga, feriado ou um fechamento pontual. Você também pode criar um bloqueio direto pela Agenda, tocando em Bloquear no topo da tela.

Como criar um bloqueio

1. Na tela de Folgas, clique em Adicionar (ou, na Agenda, no botão Bloquear).
2. Escolha Quem fica indisponível: um profissional específico, ou a barbearia/salão inteiro.
3. Preencha Data inicial e Data final (pode ser o mesmo dia).
4. Marque Dia inteiro, ou desmarque para informar Hora início e Hora fim e bloquear só um trecho do dia.
5. Opcionalmente, escreva um Motivo interno (só você vê) e uma Mensagem pública (aparece para o cliente na página de agendamento).
6. Clique em Salvar.

Um texto logo acima do motivo resume o que o bloqueio vai fazer, para você conferir antes de salvar — por exemplo, se é um fechamento da casa inteira ou só de um profissional.

Se já existem agendamentos no período

Ao salvar, o sistema verifica se o bloqueio bate de frente com algum agendamento já marcado. Se bater, ele mostra a lista de quem conflita e pergunta o que fazer:

• Cancelar todos e avisar — cancela os agendamentos que conflitam.
• Remanejar (só quando o bloqueio é de um profissional, não da barbearia inteira)— sugere outro profissional para cada cliente; você pode trocar o destino sugerido de cada um, ou deixar “Sem remanejo” para cancelar aquele em específico.
• Manter mesmo assim — salva o bloqueio e deixa os agendamentos como estão.
• Voltar e mudar as datas — desiste e volta ao formulário para ajustar o período.

Editar ou remover um bloqueio

Na tela de Folgas, clique em qualquer bloqueio da lista para abrir o mesmo formulário em modo de edição, com o botão Remover disponível para apagar o bloqueio (isso não desfaz o que já foi feito com os agendamentos que conflitavam — só remove a restrição de horário).

Feriados

Na mesma tela, a seção Feriados lista os feriados nacionais do ano (você pode navegar entre o ano atual e o próximo). Cada feriado tem um interruptor: ligue para fechar automaticamente naquele dia, desligue para manter aberto. Por padrão a barbearia funciona normalmente nos feriados — o interruptor é só para quem quer fechar.

Perguntas frequentes