Schedule - Manual do Sistema

Bem-vindo ao Schedule, um sistema completo de agendamentos desenvolvido em Laravel. Este manual irá guiá-lo através de todas as funcionalidades do sistema, desde a instalação inicial até recursos avançados como pagamentos online e programa de fidelidade.

Principais Funcionalidades

Instalação via Navegador (Recomendado)

O sistema possui um instalador web integrado que guia você por todo o processo de configuração.

Requisitos Mínimos

Extensões PHP Necessárias

Permissões de Diretório

Os seguintes diretórios precisam de permissão de escrita (chmod 755 ou 775):

• storage/ - Logs, cache e arquivos temporários
• bootstrap/cache/ - Cache do framework
• public/uploads/ - Upload de imagens

O sistema possui tarefas automáticas que precisam ser executadas periodicamente para funcionar corretamente. Estas tarefas incluem lembretes de agendamento, cancelamento automático e marcação de no-show.

Configurando o Token de Segurança

Primeiro, defina um token seguro no arquivo .env:

CRON_TOKEN=seu-token-secreto-aqui-12345

Tarefas Disponíveis

Configuração no Servidor (cPanel)

No cPanel, vá em "Cron Jobs" e adicione:

# A cada 5 minutos - Tarefas gerais
*/5 * * * * curl -s "https://seusite.com/cron/booking-tasks?token=SEU_TOKEN" > /dev/null

# A cada hora - Envio de lembretes
0 * * * * curl -s "https://seusite.com/cron/send-reminders?token=SEU_TOKEN" > /dev/null

Opções de Automação

Acesse Menu > Agendamentos > Configurações para ajustar as opções do sistema.

Configurações de Agendamento

O sistema suporta pagamentos online via Mercado Pago e Stripe. Configure suas credenciais em Menu > Configurações > Integrações.

Configurando Mercado Pago

Credenciais Necessárias

Configurando Stripe

Se preferir usar o Stripe, obtenha suas credenciais em dashboard.stripe.com.

O sistema utiliza a API do Menuia para envio de mensagens via WhatsApp. Isso permite enviar notificações automáticas de agendamento, lembretes e confirmações.

Configurando a Integração

Personalize as mensagens enviadas aos clientes. Acesse Menu > Agendamentos > Configurações > Notificações.

Eventos Disponíveis

Variáveis Disponíveis

Use estas variáveis nas mensagens para personalização automática:

Exemplo de Mensagem

Olá {client_name}! 👋

Seu agendamento foi confirmado:
📅 Data: {date}
⏰ Horário: {time}
💈 Serviço: {service}
👤 Profissional: {professional}
💰 Valor: R$ {price}

Esperamos você!
{company}

Configure os horários em que o estabelecimento está aberto para agendamentos.

Horário Padrão (Global)

Em Configurações > Horários, defina o horário de funcionamento para cada dia da semana. Este será o horário padrão para todos os funcionários.

Horários Personalizados por Funcionário

Cada funcionário pode ter seu próprio horário. Na edição do funcionário, ative "Usar horário personalizado" e defina os horários específicos.

Intervalos e Pausas

Configure pausas para almoço, descanso ou outras atividades:

• Pausas recorrentes: Se repetem todos os dias (ex: almoço 12h-13h)
• Pausas específicas: Apenas em determinado dia da semana

Gerencie os profissionais que realizarão os atendimentos. Acesse Menu > Agendamentos > Funcionários.

Criando um Funcionário

Campos do Funcionário

Preço Personalizado por Serviço

Ao vincular um serviço, você pode definir um preço e duração personalizados para aquele funcionário. Por exemplo: um profissional sênior pode cobrar mais pelo mesmo serviço.

Cadastre os serviços oferecidos pelo seu estabelecimento. Acesse Menu > Agendamentos > Serviços.

Campos do Serviço

Configurações de Fidelidade

Se o programa de fidelidade estiver ativo, você verá campos adicionais:

• Pontos Ganhos: Quantos pontos o cliente ganha ao realizar este serviço
• Preço em Pontos: Quantos pontos são necessários para trocar por este serviço

Gerencie usuários do sistema e suas permissões. Acesse Menu > Usuários.

Tipos de Usuários

Gerenciando Pontos de Fidelidade

Na edição de um usuário cliente, administradores podem:

• Ver saldo atual: Quantidade de pontos disponíveis
• Ajustar saldo: Adicionar ou remover pontos manualmente
• Motivo do ajuste: Registrar porque o ajuste foi feito

Administradores podem criar agendamentos diretamente pelo painel. Acesse Menu > Agendamentos > Novo Agendamento.

Passo a Passo

Clientes podem fazer agendamentos através da página pública. O link é: /booking

Fluxo do Cliente

Dados Solicitados ao Cliente

• Nome completo
• Email
• Telefone (para WhatsApp)
• Observações (opcional)
• Tipo de prioridade (se habilitado): idoso, gestante, PcD, lactante

Status Disponíveis

Status de Pagamento

O sistema suporta atendimento preferencial conforme legislação brasileira. Ative em Configurações > Permitir seleção de prioridade.

Tipos de Prioridade

Registre pagamentos manuais (dinheiro, cartão físico) ou receba pagamentos online.

Formas de Pagamento

Como Registrar Pagamento

1. Abra o agendamento clicando nele
2. Clique em "Registrar Pagamento"
3. Informe o valor recebido
4. Selecione a forma de pagamento
5. Confirme o registro

Você pode exigir pagamento antes de confirmar o agendamento. Configure em: Configurações > Pagamento

Tipos de Cobrança

Configuração

1. Ative "Habilitar pagamentos" nas configurações
2. Marque "Exigir pagamento para agendar"
3. Escolha o tipo: completo ou parcial
4. Se parcial, defina a porcentagem ou valor fixo
5. Configure as credenciais do gateway (Mercado Pago ou Stripe)

Bloqueie novos agendamentos de clientes que possuem dívidas pendentes. Ative em: Configurações > Pagamento > Bloquear clientes inadimplentes

Como Funciona

Relatório de Inadimplência

Em Relatórios > Financeiro, você encontra:

• Total de inadimplentes
• Valor total pendente
• Lista de agendamentos não pagos
• Dados de contato para cobrança

Registre despesas do negócio para calcular o lucro real. Acesse Menu > Agendamentos > Despesas.

Campos da Despesa

Cálculo do Lucro

Fidelize clientes com um sistema de pontos. Ative em: Configurações > Geral > Habilitar programa de fidelidade

Como Funciona

Configuração por Serviço

Na edição de cada serviço, defina:

• Pontos Ganhos: Quantos pontos o cliente ganha ao realizar este serviço
• Preço em Pontos: Quantos pontos são necessários para trocar por este serviço

Ajuste Manual pelo Admin

Em Usuários > Editar, o admin pode ajustar o saldo de pontos manualmente (bônus, correções, promoções).

A fila mostra os clientes aguardando atendimento. Acesse Menu > Agendamentos > Fila.

Funcionalidades

Exiba as chamadas em uma TV ou monitor para os clientes verem. Acesse: /booking/display

Recursos do Painel

Chamada por Voz

O painel pode anunciar automaticamente o nome do cliente usando síntese de voz. Configure o idioma em Configurações.

Após o atendimento, clientes podem avaliar o serviço. Ative em: Configurações > Habilitar avaliações

Como Funciona

1. Após concluir o atendimento, cliente recebe link para avaliar
2. Cliente dá nota de 1 a 5 estrelas
3. Pode deixar comentário opcional
4. Avaliação fica vinculada ao funcionário e serviço

Relatório de Avaliações

Em Relatórios > Avaliações você encontra:

• Média geral de avaliações
• Distribuição por estrelas
• Ranking de funcionários
• Comentários recentes

Acompanhe o desempenho do negócio com relatórios detalhados. Acesse Menu > Agendamentos > Relatórios.

Métricas Principais

Períodos Disponíveis

• Hoje
• Esta Semana
• Este Mês
• Este Ano
• Período Personalizado

Compare o desempenho dos profissionais.

Métricas por Funcionário

Informações Disponíveis

• Receita total do período
• Despesas do período
• Lucro líquido (receita - despesas)
• Gráfico de evolução
• Receita por serviço
• Receita por funcionário
• Relatório de inadimplência

Exporte relatórios em formato CSV para análise em planilhas.

Relatórios Exportáveis

• Lista de agendamentos
• Relatório financeiro
• Avaliações por profissional
• Relatório de inadimplentes

O sistema suporta múltiplos idiomas. Gerencie em Menu > Traduções.

Idiomas Disponíveis

• Português (Brasil) - pt_BR
• Inglês - en
• Espanhol - es

Detecção Automática

O sistema detecta automaticamente o idioma do navegador do usuário. Após login, o idioma selecionado é salvo na sessão.

Adicione campos extras ao cadastro de usuários. Acesse Menu > Configurações > Campos Personalizados.

Tipos de Campo

• Texto: Campo de texto simples
• Área de texto: Texto longo
• Número: Valores numéricos
• Data: Seletor de data
• Seleção: Lista de opções
• Checkbox: Sim/Não

O sistema verifica a licença periodicamente para habilitar recursos e atualizações.

Configuração da Licença

No arquivo .env:

LICENSE_SERVER_URL=https://seu-servidor-de-licencas.com
LICENSE_KEY=XXXX-XXXX-XXXX-XXXX

Verificação de Atualizações

No Dashboard, o sistema verifica automaticamente se há novas versões disponíveis e exibe um aviso quando uma atualização está disponível.