LogTracker - Rastreamento e Monitoramento de Logs

Rastreamento Inteligente de Logs e Erros para Perfex CRM

O módulo LogTracker - Rastreamento e Monitoramento de Logs é a solução essencial para desenvolvedores e administradores que precisam identificar, rastrear e resolver erros de forma ágil no Perfex CRM. Com interface visual intuitiva, sistema de notificações e categorização por níveis de severidade, você terá controle total sobre a saúde técnica do seu sistema.

Principais Funcionalidades

• Dashboard Widget Integrado: Widget no painel principal mostrando status dos logs em tempo real
• Níveis de Log Coloridos: Sistema visual com cores personalizáveis para cada nível (Critical, Error, Debug, Info, All, Date)
• Personalização de Cores: Configure cores específicas para cada tipo de log (critical: laranja #ff7a00, error: vermelho #e74c3c, debug: roxo #9b59b6, info: cinza escuro #2c3e50, all: verde #27ae60, date: azul #3498db)
• Notificações por Email: Sistema automático de alertas quando erros críticos são detectados
• Template de Email Personalizado: Email formatado com merge fields incluindo error_time, error_level, error_message e crm_url
• Controle de Ambiente: Alterne entre modos 'development' e 'production' diretamente pelas configurações
• Atualização Automática de index.php: Módulo atualiza automaticamente a constante ENVIRONMENT no arquivo index.php
• Permissões Granulares: Controle quem pode visualizar (view global), baixar (download), enviar por email (email) e deletar (delete) logs
• Integração com Settings: Link direto para configurações do módulo na lista de módulos instalados
• Merge Fields: Campos dinâmicos para personalização de emails e relatórios
• Biblioteca WpOrg Requests: Utiliza biblioteca robusta para requisições HTTP (via Composer/autoload)
• Sistema de Helpers: Funções auxiliares dedicadas para facilitar integração
• Menu Sidebar Dedicado: Acesso rápido via menu lateral do admin
• Sistema de Assets: Gerenciamento otimizado de CSS e JavaScript
• Multi-idioma: Suporte completo a arquivos de tradução

Sistema de Níveis de Log

Organize e identifique rapidamente a severidade dos problemas:

• CRITICAL: Erros críticos que requerem ação imediata (cor laranja personalizável)
• ERROR: Erros que afetam funcionalidades (cor vermelha personalizável)
• DEBUG: Informações de depuração para desenvolvimento (cor roxa personalizável)
• INFO: Mensagens informativas do sistema (cor cinza escuro personalizável)
• ALL: Visualização de todos os níveis de log (cor verde personalizável)
• DATE: Filtro por data específica (cor azul personalizável)

Notificações Automáticas

Fique informado sobre erros críticos em tempo real:

• Email automático quando erros de nível crítico são detectados
• Template personalizado com informações detalhadas do erro
• Merge fields dinâmicos: {error_time}, {error_level}, {error_message}, {crm_url}
• Assunto formatado: "Error log: [LEVEL] Error Reported at [TIME]"
• Integração com sistema de emails do Perfex CRM

Gestão de Ambiente

Controle o modo de operação do CRM de forma simples:

• Alternância fácil entre 'development' e 'production'
• Atualização automática do arquivo index.php
• Configuração salva nas opções do sistema
• Interface intuitiva nas configurações

Para Quem é Este Módulo?

• Desenvolvedores: Identifique e resolva bugs rapidamente durante o desenvolvimento
• Administradores de Sistema: Monitore a saúde do CRM em produção
• Equipes de Suporte: Diagnostique problemas reportados por usuários com logs detalhados
• Agências: Mantenha múltiplas instalações de CRM monitoradas
• DevOps: Integre rastreamento de erros ao fluxo de CI/CD
• Empresas de TI: Garanta SLA com monitoramento proativo de erros

Benefícios Práticos

• Reduza drasticamente o tempo de identificação de erros
• Receba alertas antes que usuários reportem problemas
• Facilite debugging com logs organizados e coloridos
• Melhore uptime com detecção precoce de falhas críticas
• Otimize desenvolvimento alternando facilmente entre ambientes
• Controle acesso a logs sensíveis com permissões granulares
• Economize horas de investigação com informações centralizadas
• Documente histórico de problemas para análise de padrões

Fluxo de Trabalho

1. Detecção: Sistema registra automaticamente erros e logs
2. Categorização: Logs são classificados por nível de severidade
3. Visualização: Dashboard widget mostra status atual dos logs
4. Notificação: Emails são enviados para erros críticos
5. Análise: Equipe acessa logs coloridos e organizados
6. Ação: Desenvolvedores resolvem problemas identificados
7. Download: Logs podem ser baixados para análise offline (com permissão)
8. Limpeza: Logs antigos podem ser deletados (com permissão)

Recursos Técnicos Avançados

• Composer/Autoload: Utiliza vendor/autoload.php para gerenciamento de dependências
• WpOrg Requests: Biblioteca robusta para requisições HTTP
• Hook System: Integração profunda via hooks do Perfex (before_settings_updated, after_email_templates, etc.)
• Merge Fields API: Sistema extensível de campos dinâmicos
• Widget API: Dashboard widget com posicionamento customizado (top-12)
• Permissions API: Sistema de permissões completo integrado ao staff
• Settings Group: Configurações organizadas em grupo dedicado
• Email Templates: Template de email criado automaticamente na instalação
• Options API: Configurações persistidas no banco de dados

Segurança e Controle

• Permissões de visualização global ou por usuário (view/view_own)
• Controle de download de logs por perfil de staff
• Restrição de envio de emails por permissão
• Controle de exclusão de logs por autorização
• Proteção de acesso direto aos arquivos do módulo

Informações Técnicas

• Versão: 1.0.0
• Autor: Taffarel Dev
• Compatibilidade: Perfex CRM 3.0.* ou superior
• Requisitos: PHP com suporte a Composer, permissão de escrita em index.php
• Tecnologias: PHP, WpOrg\Requests, Hook System, Merge Fields API

Este módulo está licenciado sob a Licença MIT.