Manual Completo & Tutorial do Sistema
Tudo o que você precisa saber sobre o sistema em um só lugar.
Consulte como realizar cada operação no Studio: agendamentos, segregação de permissões da secretária, lançamento e edição de insumos com busca inteligente, fechamento de comandas, comissões e emissão de certificados.
Enquanto a chave de API externa não estiver configurada, a assistente responde instantaneamente com base neste manual.
✦1. Visão Geral, Perfis de Acesso e Segregação
Público: Todos os usuários (Secretária, Profissionais, Gestora e Administrador)Entenda os papéis de cada colaborador no Studio e o que cada um tem permissão para acessar.
O sistema conta com perfis de acesso estritamente segregados para proteger a confidencialidade financeira do salão e garantir que cada colaborador visualize exatamente o que precisa para exercer seu trabalho com excelência.
Passo a Passo Operacional
Secretária / Recepção (STUDIO_SECRETARIA)
Tem acesso à Agenda, cadastro de Clientes, atendimento no balcão e Fechamento Prévio da Comanda para liberação da cliente. NÃO tem acesso às comissões da equipe nem ao Demonstrativo Discriminado da Gestora.
Profissional na Cadeira (STUDIO_PROFISSIONAL)
Acessa a aba "Meu Painel" no celular, tablet ou computador. Visualiza apenas seus próprios agendamentos, inicia procedimentos, registra insumos consumidos em tempo real na cadeira, edita dosagens e faz upsell de produtos de balcão com seu código de comissão.
Gestora do Salão (STUDIO_ADMIN)
Acesso completo às regras de negócio do Studio: auditoria financeira definitiva em "/admin/pagamentos", conferência de comissões por profissional, retenção do fundo de insumos, lucro líquido do salão, tabela de serviços e estoque.
Administrador Geral / Dono (ADMIN / isOwner)
Controle irrestrito de todo o ecossistema: Studio, Academy (cursos, videoaulas, certificados), Loja Oficial, configurações do sistema, taxas de cartão e IA Assistente.
Quadro de Confidencialidade: O que cada perfil acessa?
| Recurso / Informação | Secretária (Recepção) | Profissional na Cadeira | Gestora & Admin |
|---|---|---|---|
| Visualizar Todos os Agendamentos da Casa | ✓ Total | Apenas os seus | ✓ Total |
| Fechamento Prévio (Comanda e Liberação da Cliente) | ✓ Sim | — | ✓ Sim |
| Comissões da Equipe e Faturamento Líquido | ✕ Oculto (Confidencial) | Apenas a própria | ✓ Completo |
| Lançamento e Edição de Insumos (g/ml) na Cadeira | ✓ Na Agenda | ✓ No Meu Painel | ✓ Total |
| Auditoria Definitiva do Caixa (/admin/pagamentos) | ✕ Sem acesso | — | ✓ Gestão Final |
Dúvidas Frequentes do Módulo
✦2. Fluxo Completo de Atendimento (Passo a Passo)
Público: Secretária, Profissionais e GestoraDo pedido do cliente no site até o recebimento no caixa e a auditoria financeira.
Como funciona o ciclo de vida de um agendamento no salão, garantindo sincronia perfeita entre a recepção, a bancada do profissional e o caixa.
Passo a Passo Operacional
Chegada do Pedido na Agenda
O cliente escolhe os serviços no site ou envia mensagem no WhatsApp. O agendamento entra na Agenda com o status "Agendado / Pendente" (card com borda neutra limpa). A secretária combina o horário exato e confirma.
Início do Procedimento na Cadeira
Quando a cliente senta na cadeira, o profissional abre o "Meu Painel" e clica em "Iniciar Atendimento". O status muda automaticamente na Agenda para "Em atendimento" (verde menta).
Lançamento de Insumos em Tempo Real
Conforme prepara descolorações, tonalizações ou tratamentos, o profissional ou seu assistente lança os produtos consumidos informando a etapa e a dosagem em gramas ou ml.
Edição de Insumo (Correção de Dosagem ou Troca)
Se o profissional usou menos ou mais produto, ou se precisou trocar o pó descolorante, basta clicar no ícone de Lápis (✏️). O sistema calcula a diferença e ajusta o estoque com débito adicional ou estorno automático.
Venda de Produtos na Cadeira (Upsell)
Se a cliente quiser levar um produto home care (shampoo, óleo reparador, máscara), o profissional clica em "Vender Produto (Upsell)". O produto é adicionado à comanda e a comissão da venda vai para a conta do profissional.
Encerramento na Cadeira e Envio para o Caixa
Ao concluir o procedimento, o profissional clica em "Encerrar Atendimento". Na Agenda visual, o agendamento muda para "Finalizou e vai para pagamento" (azul pastel).
Fechamento Prévio no Balcão pela Secretária
A secretária clica no card do agendamento para abrir o modal de checkout resumido. Confere os procedimentos, insumos, produtos de balcão levados, seleciona a forma de pagamento (PIX, Cartão, Dinheiro), o parcelamento e clica em "Liberar Cliente (Enviar p/ Gestão)".
Fechamento Definitivo e Auditoria pela Gestora
A Gestora ou o Admin acessam a aba "Financeiro e Caixa" (/admin/pagamentos), conferem o Demonstrativo Discriminado Completo com as comissões calculadas por profissional, o fundo de produtos retido e a margem líquida do salão, e confirmam o recebimento.
Dúvidas Frequentes do Módulo
✦3. Controle de Estoque & Insumos por Grama (g/ml)
Público: Estoquista, Gestora e ProfissionaisComo cadastrar produtos, precificar o custo por grama e controlar baixas automáticas.
Diferencial exclusivo do Studio Agnaldo Gomes: controle milimétrico de gramatura para descolorações, tinturas e tratamentos químicos, evitando desperdícios e apurando a margem líquida real de cada atendimento.
Passo a Passo Operacional
Diferença entre Insumo de Uso Interno e Produto de Venda
Na aba "/admin/estoque", ao cadastrar ou editar um produto, marque "Uso em Procedimento" para insumos de bancada/lavatório (ex: OX, pó descolorante, tonalizante) e "Permitir Venda Balcão" para produtos de revenda ao cliente (ex: shampoo home care, finalizadores).
Cálculo do Custo por Grama/ML
Ao cadastrar o produto (ex: Pó Keune 500g que custou R$ 250,00), o sistema calcula automaticamente o custo por grama (R$ 0,50/g). Quando o profissional lança 40g na cadeira, o sistema debita 40g do estoque e calcula o custo de R$ 20,00.
Busca Inteligente por Digitação (Combobox)
Em todos os campos de seleção de produto do sistema, não é necessário rolar listas compridas. Basta começar a digitar as primeiras letras do produto, marca ou categoria (ex: "keune", "blondor", "ox 30") para filtrar instantaneamente.
Movimentações e Alertas de Estoque Mínimo
O sistema registra cada saída com o tipo OUT_PROCEDURE (baixa por procedimento) ou OUT_SALE (venda no balcão) vinculada ao agendamento. Se o estoque cair abaixo do ponto de reposição, o sistema exibe alertas visuais em laranja/vermelho na aba de Estoque.
Dúvidas Frequentes do Módulo
✦4. Financeiro, Comissões e Auditoria do Caixa
Público: Gestora do Salão e AdministradorRegras de repasse, taxas de maquininha, retenção de fundo e fechamento definitivo.
Como a Gestora do Salão e o Admin auditam as comandas fechadas pela recepção, conferem o Demonstrativo Discriminado e consolidam o caixa com segurança e transparência.
Passo a Passo Operacional
Acesso à Tela de Pagamentos e Caixa (/admin/pagamentos)
Após a secretária realizar o Fechamento Prévio no balcão e liberar a cliente, o atendimento fica com status pendente de confirmação na aba "Financeiro e Caixa".
Análise do Demonstrativo Discriminado da Gestora
Para cada atendimento, a gestora visualiza: 1) Total cobrado da cliente; 2) Descontos concedidos; 3) Taxa da maquininha descontada; 4) Fundo de reposição de insumos retido pelo salão; 5) Comissão líquida calculada de cada profissional envolvido; 6) Margem líquida do salão.
Regras de Comissão Personalizadas
Na aba "Comissões", é possível configurar percentuais diferentes por profissional e categoria de serviço (ex: 40% em mechas, 50% em corte, 10% em produtos de balcão).
Confirmação Definitiva do Atendimento
Ao clicar em "Confirmar Pagamento e Comissões", o status financeiro muda para "CONFIRMED". Os valores entram no saldo a pagar do profissional e no fluxo de caixa consolidado do dia.
Dúvidas Frequentes do Módulo
✦5. Módulo Exclusivo: Dia da Noiva
Público: Secretária, Gestora e Mestre Agnaldo GomesGestão de orçamentos, contratos, sinal de 50% obrigatório e bloqueio de datas.
Fluxo especial para noivas no Studio Agnaldo Gomes, onde datas concorridas são reservadas com exclusividade mediante sinal e contrato assinado.
Passo a Passo Operacional
Recebimento do Pedido de Orçamento
A noiva preenche o formulário no site escolhendo a data do casamento, local (no Studio ou externa) e serviços para ela e acompanhantes (mães, madrinhas, daminhas).
Elaboração e Aprovação da Proposta
A secretária ou gestora entra em contato pelo WhatsApp, alinha os detalhes do cronograma (teste de penteado, maquiagem, pré-wedding) e define o Valor Total Fechado.
Regra Rígida do Sinal de 50% via PIX
Para a data ser bloqueada na agenda exclusiva do Agnaldo, é obrigatório o pagamento de 50% de sinal via PIX dinâmico gerado pelo sistema (Mercado Pago / Asaas).
Assinatura do Contrato e Bloqueio Definitivo
Após confirmar o sinal e o contrato assinado, o sistema cria automaticamente o bloqueio de agenda do mestre Agnaldo Gomes na data do casamento, garantindo atendimento VIP e sem conflitos de horários.
Dúvidas Frequentes do Módulo
✦6. Agnaldo Gomes Academy (Cursos & Alunos)
Público: Alunos, Instrutores e AdministradorGestão de turmas presenciais, cursos VIP, videoaulas e certificados autenticados.
Plataforma educacional voltada para cabeleireiros e profissionais da beleza que desejam se especializar nas técnicas autorais do mestre Agnaldo Gomes.
Passo a Passo Operacional
Estrutura dos Cursos (Presenciais, VIP e Online)
A Academy oferece turmas presenciais em grupo, Cursos VIP individuais (com prática em modelo) e cursos 100% online com videoaulas gravadas com player seguro.
Área do Aluno (/aluno)
O aluno faz login com seu e-mail e senha, acessa o catálogo de cursos adquiridos, assiste às aulas com controle de progresso e participa da comunidade interna.
Certificados Digitais com Autenticação e QR Code
Cada certificado gerado possui um código hash único criptográfico e um QR Code. Qualquer pessoa ou empregador pode verificar a autenticidade na página pública "/verificar-certificado".
Dúvidas Frequentes do Módulo
✦7. Loja Oficial & Afiliados Mercado Livre
Público: Recepção, Clientes e AdministradorVenda de cosméticos de estoque local vs equipamentos afiliados do Mercado Livre.
Como a loja online funciona com dois modelos complementares: cosméticos de estoque físico entregues pelo salão e equipamentos de ponta redirecionados com link oficial de afiliado.
Passo a Passo Operacional
Produtos de Estoque Local (LOCAL_STOCK)
Shampoos, condicionadores, máscaras e ampolas que o salão tem em prateleira. O cliente adiciona ao carrinho na loja (/loja), calcula o frete e finaliza no checkout próprio.
Produtos Afiliados Mercado Livre (AFFILIATE_ML)
Secadores profissionais, pranchas, babyliss e ferramentas de alto investimento. Ao clicar em "Ver Oferta", o sistema abre imediatamente o link oficial do produto no Mercado Livre em nova aba.
Links de Afiliados dos Profissionais (Vitrine na Cadeira)
No "Meu Painel", cada cabeleireiro possui links personalizados com seu identificador. Eles podem enviar via WhatsApp para suas clientes e receber comissão mesmo se a cliente comprar de casa.
Dúvidas Frequentes do Módulo
✦8. Robô de WhatsApp & Automações de CRM
Público: Secretária, Marketing e AdministradorLembretes automáticos, mensagens de aniversariantes e reativação de clientes inativos.
Recursos automatizados do sistema para manter a agenda cheia e fidelizar clientes sem sobrecarregar a recepção.
Passo a Passo Operacional
Lembrete Automático 24h Antes
O robô envia automaticamente uma mensagem personalizada de WhatsApp para o cliente na véspera do atendimento confirmando o horário e o profissional.
Mensagem de Aniversário com Cortesia
Todos os dias às 09:00, o sistema detecta os aniversariantes cadastrados e envia votos carinhosos com um desconto exclusivo para um procedimento no mês.
Reativação de Clientes Inativos (+45 dias)
Clientes que não visitam o salão há mais de 45 dias recebem uma mensagem carinhosa convidando para retoque de mechas, hidratação ou corte.
Dúvidas Frequentes do Módulo
Ainda restou alguma dúvida de processo?
Você pode abrir o botão flutuante da IA Assistente no canto inferior direito da tela a qualquer momento. Ela responderá suas perguntas operacionais com base neste manual integrado!