Descrição

Plugin Barbearia Agenda – Descrição Completa

📋 Informações Gerais

Nome: Barbearia Agenda
Versão: 1.2.3
Autor: Elder Silva
Plataforma: WordPress
Domínio de Texto: barbearia

🎯 Objetivo

Sistema completo de agendamento online para barbearias e salões de beleza, permitindo que clientes agendem serviços com profissionais específicos através de uma interface moderna e intuitiva, com envio automático de confirmação via WhatsApp.

---

✨ Funcionalidades Principais

1. Sistema de Agendamento

1.1 Gestão de Profissionais (Barbeiros)

• Cadastro ilimitado de profissionais
• Foto de perfil para cada profissional
• Galeria de trabalhos realizados (portfólio)
• Associação de serviços específicos por profissional
• Número de WhatsApp personalizado por profissional
• Integração individual com Google Calendar

1.2 Horários de Trabalho Personalizados

• Configuração individual de horários por dia da semana
• Horários diferentes para cada dia (segunda a domingo)
• Ativação/desativação de dias específicos
• Intervalo de almoço configurável
• Sistema de datas bloqueadas (férias, folgas, feriados)
• Horários padrão: Segunda a Sexta (9h-18h), Sábado (9h-13h), Domingo (fechado)

1.3 Gestão de Serviços

• Cadastro ilimitado de serviços
• Preço individual por serviço
• Duração customizável (em minutos)
• Ícones personalizados (8 opções: tesoura, navalha, barba, pente, secador, cabelo, shampoo, máscara facial)
• Imagem destacada para cada serviço
• Associação de serviços aos profissionais

1.4 Sistema de Reservas

• Interface de agendamento via shortcode [barbearia_agendamento]
• Seleção de serviço → profissional → data → horário
• Calendário visual interativo
• Navegação entre meses
• Bloqueio automático de datas passadas
• Bloqueio de horários já reservados
• Validação de disponibilidade em tempo real
• Campos de dados do cliente: nome, telefone e email (opcional)
• Prevenção de agendamentos duplicados

1.5 Validações Inteligentes

• Horários passados são automaticamente bloqueados
• Margem de segurança de 30 minutos para agendamentos no dia atual
• Verificação de conflitos de horários
• Respeito ao intervalo de almoço
• Validação de datas bloqueadas
• Verificação de expediente do profissional

---

2. Segurança Avançada

2.1 Proteção Anti-Bot

• Honeypot: Campo oculto para detectar bots
• Timestamp: Validação de tempo mínimo de preenchimento (3 segundos)
• reCAPTCHA v3: Integração com Google reCAPTCHA
  • Score configurável (threshold ajustável)
  • Validação invisível ao usuário
  • Logs de tentativas bloqueadas

2.2 Rate Limiting

• Limite de 5 tentativas a cada 15 minutos por IP
• Proteção contra ataques de força bruta
• Sistema de bloqueio temporário

2.3 Cabeçalhos de Segurança HTTP

• X-Frame-Options: SAMEORIGIN (proteção contra clickjacking)
• X-Content-Type-Options: nosniff (prevenção de MIME sniffing)
• X-XSS-Protection: 1; mode=block (proteção XSS)
• Referrer-Policy: strict-origin-when-cross-origin
• Permissions-Policy (desabilita recursos não utilizados)
• Content-Security-Policy (em produção)

2.4 Validações de Dados

• Sanitização de todos os inputs
• Validação de formato de data (YYYY-MM-DD)
• Validação de formato de horário (HH:MM)
• Validação de telefone (apenas números, 10-11 dígitos)
• Validação de email (formato válido)
• Proteção contra SQL Injection
• Proteção contra XSS

2.5 Prevenção de Cache

• Desabilita cache na página de agendamento
• Garante validade dos nonces
• Headers específicos de no-cache

---

3. Integrações

3.1 WhatsApp

• Envio automático de confirmação após agendamento
• Mensagem personalizada com:
  • Nome do cliente
  • Serviço escolhido
  • Profissional selecionado
  • Data e horário formatados
  • Duração do serviço
  • Preço
• Número de WhatsApp global ou por profissional
• Link direto para conversa no WhatsApp

3.2 Google Calendar

• Sincronização automática de agendamentos
• Configuração individual por profissional
• OAuth 2.0 para autenticação segura
• Criação automática de eventos
• Informações do evento:
  • Título: Cliente + Serviço
  • Descrição: Telefone e detalhes
  • Horário de início e fim
  • Localização (se configurada)
• Atualização e exclusão de eventos
• Desconexão individual por profissional

3.3 Notificações Push

• Sistema de notificações web push
• Lembretes de agendamentos
• Notificações de confirmação
• Suporte a Service Workers
• Compatível com navegadores modernos

---

4. Painel Administrativo

4.1 Menu Principal

• Profissionais: Gerenciamento de barbeiros
• Serviços: Cadastro e edição de serviços
• Agendamentos: Visualização de todas as reservas
• Configurações: Painel de configurações gerais
• Analytics: Estatísticas e relatórios
• Customizar: Personalização visual

4.2 Gestão de Agendamentos

• Lista completa de agendamentos
• Filtros por data, profissional e serviço
• Visualização de detalhes:
  • Cliente (nome, telefone, email)
  • Profissional
  • Serviço
  • Data e horário
  • Duração
• Edição de agendamentos
• Exclusão de agendamentos
• Sincronização com Google Calendar

4.3 Configurações Gerais

• WhatsApp:
  • Número global
  • Mensagem personalizada
• Google Calendar:
  • Client ID
  • Client Secret
  • Redirect URI
• reCAPTCHA:
  • Site Key
  • Secret Key
  • Threshold (score mínimo)
  • Ativar/desativar
• Notificações Push:
  • Configuração de VAPID keys
  • Ativar/desativar

4.4 Analytics e Relatórios

• Dashboard com estatísticas
• Agendamentos por período
• Serviços mais populares
• Profissionais mais requisitados
• Taxa de ocupação
• Receita estimada

---

5. Personalização Visual (Customizer)

5.1 Cores Personalizáveis

• Cor primária do tema
• Cor de fundo das seções
• Cor de fundo dos cards
• Cor dos títulos
• Cor do texto
• Cor dos botões
• Cor dos horários disponíveis
• Cor dos horários selecionados

5.2 Tipografia

• Fonte do cabeçalho (Google Fonts)
• Fonte do corpo do texto
• Tamanhos de fonte ajustáveis

5.3 Layout

• Espaçamento entre elementos
• Bordas arredondadas
• Sombras e efeitos
• Responsividade automática

5.4 Pré-visualização em Tempo Real

• Visualização instantânea das mudanças
• Aplicação automática no frontend
• Salvar configurações personalizadas

---

6. Interface do Usuário (Frontend)

6.1 Design Moderno

• Layout responsivo (mobile-first)
• Cards com efeitos de hover
• Animações suaves
• Ícones SVG personalizados
• Gradientes e sombras
• Tema escuro por padrão

6.2 Experiência do Usuário

• Fluxo de agendamento intuitivo
• Feedback visual em cada etapa
• Validações em tempo real
• Mensagens de erro claras
• Loading states
• Confirmação visual de seleção

6.3 Componentes Interativos

• Grid de Serviços:
  • Cards visuais com ícones
  • Preço e duração visíveis
  • Seleção com destaque
• Grid de Profissionais:
  • Fotos dos profissionais
  • Carregamento dinâmico baseado no serviço
• Calendário:
  • Navegação entre meses
  • Dias bloqueados visualmente
  • Seleção de data intuitiva
• Horários:
  • Grid de horários disponíveis
  • Atualização dinâmica
  • Indicação de horários ocupados

6.4 Responsividade

• Layout adaptável para desktop, tablet e mobile
• Fonte maior em dispositivos móveis (16px mínimo)
• Botões e campos otimizados para toque
• Padding reduzido em telas pequenas
• Grid de uma coluna em mobile

---

7. Recursos Técnicos

7.1 Arquitetura

• Orientação a objetos (OOP)
• Separação de responsabilidades
• Classes modulares:
  • Barbearia_Agenda (principal)

  • Barbearia_Admin (painel admin)

  • Barbearia_Frontend (interface pública)
  • Barbearia_Customizer (personalização)
  • Barbearia_Analytics (estatísticas)
  • Barbearia_Google_Calendar (integração Google)
  • Barbearia_Push_Notifications (notificações)
  • Barbearia_ReCaptcha (segurança)
  • Barbearia_Shortcodes (shortcodes)

7.2 Custom Post Types

• barber: Profissionais
• service: Serviços
• booking: Agendamentos

7.3 AJAX Endpoints

• barbearia_get_services – Busca serviços de um profissional
• barbearia_get_barbers_by_service – Busca profissionais por serviço
• barbearia_get_timeslots – Busca horários disponíveis
• barbearia_check_day_availability – Verifica disponibilidade do dia
• barbearia_create_booking – Cria novo agendamento
• barbearia_update_booking – Atualiza agendamento existente
• barbearia_delete_booking – Exclui agendamento
• barbearia_get_available_times_for_edit – Horários para edição
• barbearia_save_frontend_config – Salva configurações visuais

7.4 Meta Boxes

• Serviços do profissional
• Horários de trabalho
• Google Calendar
• Contato do profissional
• Galeria de trabalhos
• Detalhes do serviço
• Detalhes do agendamento

7.5 Hooks e Filtros

• init – Registro de CPTs
• add_meta_boxes – Registro de meta boxes
• save_post – Salvamento de metadados
• wp_enqueue_scripts – Carregamento de assets
• admin_enqueue_scripts – Assets do admin
• send_headers – Cabeçalhos de segurança
• template_redirect – Prevenção de cache
• admin_init – Callback do Google Calendar

---

8. Funcionalidades Avançadas

8.1 Sistema de Horários

• Geração dinâmica de slots
• Intervalo baseado na duração do serviço
• Detecção automática de conflitos
• Respeito ao horário de almoço
• Bloqueio de horários passados
• Margem de segurança configurável

8.2 Validação de Disponibilidade

• Verificação em tempo real
• Bloqueio de dias sem expediente
• Bloqueio de datas específicas
• Validação de horário de trabalho
• Verificação de agendamentos existentes

8.3 Logs e Debugging

• Logs de segurança
• Logs de agendamentos
• Logs de integrações
• Logs de erros
• Sistema de debug configurável

8.4 Otimizações

• Cache de consultas
• Lazy loading de imagens
• Minificação de assets
• Versionamento de CSS/JS
• Prevenção de cache em páginas críticas

---

9. Compatibilidade

9.1 WordPress

• Versão mínima: 5.0
• Compatível com temas modernos
• Suporte a Gutenberg
• Compatível com page builders

9.2 Navegadores

• Chrome/Edge (últimas 2 versões)
• Firefox (últimas 2 versões)
• Safari (últimas 2 versões)
• Opera (últimas 2 versões)

9.3 Dispositivos

• Desktop (1920px+)
• Laptop (1366px – 1920px)
• Tablet (768px – 1366px)
• Mobile (320px – 768px)

---

10. Instalação e Ativação

10.1 Instalação

1. Upload do plugin via WordPress admin
2. Ativação do plugin
3. Criação automática da página “Agendamento”
4. Flush de rewrite rules
5. Suporte automático a thumbnails

10.2 Configuração Inicial

1. Cadastrar profissionais
2. Cadastrar serviços
3. Associar serviços aos profissionais
4. Configurar horários de trabalho
5. Configurar WhatsApp
6. Configurar reCAPTCHA (opcional)
7. Conectar Google Calendar (opcional)