Tudo o que o cliente e o admin podem fazer

Prefácio

Este documento é o manual funcional da plataforma da barbearia, escrito para ser lido por qualquer pessoa — o dono, a equipe do balcão e o cliente — sem exigir conhecimento técnico. Serve como material de treinamento, onboarding e consulta do dia a dia.

Está dividido em duas partes: o App do Cliente (o que a pessoa que agenda vê e faz) e o Painel do Admin (o que a barbearia usa para operar). Cada tela é explicada em "O que é", "Passo a passo" e, quando útil, "Observações / Regras". As telas são citadas pelo nome que aparece no aplicativo. O manual reflete o comportamento atual da plataforma.

Visão geral da plataforma

Aplicativo de agendamento + fidelização por assinatura para barbearia, com duas visões: App do Cliente e Painel do Admin.

• Pagamento no local, após o atendimento (PIX, crédito, débito ou dinheiro) — não há cobrança online.
• Avisos automáticos ao cliente, principalmente por WhatsApp (e e-mail em alguns casos).
• Várias telas atualizam em tempo real: a fila de solicitações do admin e a tela de acompanhamento do cliente.
• Cada barbearia é isolada: o cliente entra por um link próprio (/b/nome-da-barbearia) e fica vinculado a ela; o app do cliente vive em /client e o painel em /admin — dá para estar logado como cliente e admin ao mesmo tempo, em abas diferentes.

Conceitos-chave

• Solicitação → Aprovação: agendar e assinar/trocar/cancelar plano viram solicitações que a barbearia aprova no painel.
• Saldo de cortes: quem tem plano tem saldo mensal; agendar pelo plano consome 1 corte, cancelar devolve.
• Pedido / Comanda: um agendamento pode ter vários itens (serviços e produtos).
• Avulso × coberto pelo plano: o plano cobre 1 corte; extras são avulsos, pagos no local.
• Tempo real: novas solicitações tocam som e aparecem sozinhas; a confirmação do cliente muda sozinha.

Cadastro e acesso

O que é

Criar conta, entrar e recuperar a senha.

Criar conta

1. Na tela de login, tocar em Cadastrar.
2. Preencher nome, e-mail, telefone e senha.
3. Aceitar Termos de Uso e Política de Privacidade (obrigatório).
4. Concluir — chega um e-mail de boas-vindas.

Entrar / Recuperar senha

Entrar com e-mail e senha. Em Esqueci minha senha, informar o e-mail, abrir o link recebido e definir a nova senha (já entra logado).

Tela inicial (Home)

O que aparece

• Saudação com nome e data.
• Card do próximo agendamento com Adicionar serviço, Reagendar e Cancelar.
• Medidor de cortes (assinantes): cortes restantes, plano e dia de renovação, com Ver meu plano.
• Botão grande Agendar (com plano e saldo, vai direto ao horário) e atalho Suporte.

Menu inferior: Início · Agendar · Pedidos · Meu plano · Perfil.

Agendar (passo a passo)

1) Escolher em Serviços

Ver serviços avulsos (preço + tempo médio) ou planos (benefícios). Escolher um serviço e tocar em Continuar leva ao montador com esse serviço já selecionado.

2) Montar o pedido

1. Barbeiro.
2. Serviços — quem tem plano vê "Corte do plano · incluído" (escolhe qual corte usa o saldo) e "Adicionar avulso" abaixo.
3. Produtos (opcional, com quantidade).
4. Corte infantil → escolher/registrar criança (nome, idade, foto).
5. Data e horário — ocupados riscados, horários passados bloqueados.
6. Forma de pagamento (no local) e Observações para o barbeiro.

3) Enviar e acompanhar

O Resumo mostra itens, total no local e tempo estimado. Após Solicitar agendamento, a tela de acompanhamento muda sozinha: Confirmado, Não confirmado ou Outro horário sugerido.

Planos e assinatura

Ver e assinar

Cada plano mostra os benefícios (ex.: 4 cortes/mês, 1ª mensalidade = adesão, valor cheio depois, desconto em produtos). Assinar abre um modal de confirmação e cria uma solicitação com aprovação do admin; o cliente recebe WhatsApp e, ao ser aprovado, a confirmação detalhada.

Meu plano

Plano ativo, saldo e renovação. Trocar e Cancelar viram pedido que aguarda aprovação (com aviso de pendência).

Meus pedidos

A aba Pedidos reúne todos os pedidos (futuros, em atendimento e passados). Tocar em um abre o detalhamento (itens, valor, barbeiro, status).

• Itens já no pedido ficam selecionados; tocar adiciona/remove — sem duplicar.
• O item coberto pelo plano fica travado (não removível).
• Durante o atendimento: "Em atendimento" + cronômetro.

Produtos

Catálogo de produtos. O cliente pode reservar para retirada (com quantidade) e acompanhar o status. Produtos também podem ser adicionados dentro de um pedido de agendamento.

Perfil

• Dados pessoais: nome, telefone e foto.
• Minhas crianças: registrar/remover criança (nome, idade, foto) — usadas no corte infantil.
• Sair.

Suporte

Tocar em Suporte abre a conversa no WhatsApp da barbearia, pronta para enviar.

Avisos que o cliente recebe

Enviados automaticamente por WhatsApp (e e-mail em alguns casos):

• Agendamento solicitado — aguardando confirmação.
• Agendamento confirmado — serviço, valor, pagamento, data/barbeiro (também quando o admin cria o agendamento).
• Item adicionado ao pedido — quando o cliente ou o admin adiciona um serviço/produto.
• Atendimento iniciado e finalizado (com total pago).
• Assinatura — solicitada, confirmada ou recusada.
• Cancelamentos — assinatura, agendamento ou reserva.

Acesso e navegação

• Login do admin em /admin/login — sessão separada da do cliente (admin numa aba e cliente em outra ao mesmo tempo).
• Menu lateral: Dashboard, Solicitações, Agenda, Pedidos, Clientes, Serviços, Produtos, Barbeiros, Financeiro, Marketing, Mensagens, Configurações.
• Badge de Solicitações em tempo real + som quando chega algo novo.
• Ver como cliente, Sair, tema claro/escuro e menu hambúrguer no celular.

Dashboard

Indicadores (faturamento do mês, agendamentos de hoje, assinantes ativos, pendências) e a agenda do dia.

Solicitações

Fila de aprovações em tempo real, com três tipos:

Agendamentos (timer de 10 min)

Cliente, serviço, data/hora, itens e total, forma de pagamento e cronômetro de 10 minutos. Mostra corte infantil + criança e observações. Ações: Aceitar / Liberar horário e botão Avisar no WhatsApp.

Pedidos de plano

Nova assinatura, Troca ou Cancelamento → Aprovar / Recusar (cliente é avisado).

Reservas de produto

Marcar como entregue ou cancelar.

Agenda

Visão Dia/Semana com navegação por setas. Os horários vêm dos horários de trabalho dos barbeiros.

Novo agendamento: seletor de cliente com busca por nome; se o serviço for infantil, escolhe-se a criança. Nasce confirmado, consome corte se for pelo plano, e dispara o WhatsApp de confirmação.

Confirmar presença (ao abrir um horário) abre a escolha: Iniciar atendimento (começa a comanda com cronômetro e leva para Pedidos com o cliente "em atendimento") ou Somente confirmar presença. Também há Não compareceu e Cancelar.

Pedidos (comanda ao vivo)

1. Lista os atendimentos de hoje.
2. Iniciar atendimento — dispara cronômetro + WhatsApp de boas-vindas.
3. Adicionar/remover itens ao vivo (total e tempo se ajustam).
4. Finalizar e lançar — escolhe pagamento → vira venda no financeiro + WhatsApp de agradecimento.

Clientes

• Lista com busca, filtro de status e coluna Crianças.
• Novo cliente e Convite (link para o cliente definir a senha).
• Visualizar: foto, plano + saldo, histórico de serviços, crianças e cancelar plano.
• Atribuir combo a um cliente.

Serviços e Planos

Serviços

Criar/editar/inativar (nome, duração, preço, categoria, switch "Serviço infantil", ativo). Serviços infantis exibem o selo Infantil e pedem a criança no app.

Planos (combos)

Criar/editar/inativar (nome, cortes/mês, escopo/benefícios, preço). O escopo vira a lista de benefícios mostrada ao cliente.

Produtos

Criar/editar/inativar produtos com preço, custo e estoque. Aparecem para o cliente reservar e podem ser lançados nas comandas.

Barbeiros

Criar/editar/inativar barbeiros e definir os horários de trabalho, que alimentam os horários disponíveis no agendar e a grade da Agenda.

Financeiro

Receitas e despesas (as vendas das comandas entram aqui), análise por forma de pagamento, registrar saque e fechamento do mês.

Marketing

Campanhas por segmento. Módulo condicionado ao plano da barbearia (aparece quando habilitado).

Mensagens

Modelos de WhatsApp prontos (boas-vindas, confirmação, retorno, aviso fora do expediente) com Copiar e link wa.me. Independentes dos avisos automáticos.

Configurações

Dados da unidade, horários e identidade visual (logo e cor de destaque).

Avisos que o admin dispara

• Aceitar agendamento (ou criar um novo pelo admin) → confirmação.
• Adicionar item ao pedido → item adicionado.
• Iniciar / Finalizar atendimento → boas-vindas / agradecimento.
• Aprovar assinatura/troca → confirmação do plano; Recusar → aviso.
• Cancelar assinatura, agendamento ou reserva → aviso.

Regras de negócio (resumo)

• Solicitação de agendamento expira em 10 minutos se o admin não responder.
• Saldo de cortes: agendar consome 1, cancelar devolve; renova no dia de cobrança.
• Pagamento no local (PIX/crédito/débito/dinheiro).
• Plano: 1ª mensalidade = adesão; assinar/trocar/cancelar passa por aprovação.
• Cancelamento: pelo app com 10 min de antecedência; WhatsApp até 30 min antes.
• Falta sem aviso pode restringir novos agendamentos.
• Agendamento confirmado não é reagendável pelo cliente — apenas cancelado.

Glossário

• Solicitação — pedido que aguarda aprovação do admin.
• Comanda / Pedido — agendamento com um ou mais itens.
• Avulso — item pago no local, fora do plano.
• Coberto pelo plano — item incluído (consome saldo).
• Adesão — valor da 1ª mensalidade.
• Saldo — cortes disponíveis no mês.
• No-show — falta sem aviso.
• Entitlement — recurso liberado conforme o plano da barbearia.