Sobre o projeto

Laravisit é um pacote Laravel gerenciado pelo Composer, projetado para adicionar rastreamento de visitas e análises de visualizações de página a qualquer modelo Eloquent por meio de uma interface limpa e fluente. A instalação é feita via Composer com `composer require coderflexx/laravisit`, seguida pela publicação do arquivo de configuração e a execução de migrations para configurar as tabelas de banco de dados necessárias. Para usar o pacote, um modelo deve importar e aplicar a trait `HasVisits` enquanto implementa a interface `CanVisit`. Uma vez configurado, os desenvolvedores podem registrar visitas usando o método `visit()` em uma instância do modelo, com métodos de encadeamento opcionais para anexar endereço IP, ID de sessão, arrays de dados personalizados e associações de usuários autenticados. A agregação de visitas suporta múltiplos intervalos baseados em tempo, incluindo horários, diários, semanais, mensais, anuais e intervalos personalizados baseados em Carbon. O comportamento padrão remove a duplicidade de visitas por dia por usuário. Para recuperar análises, o pacote fornece query scopes como `withTotalVisitCount()`, `popularAllTime()`, `popularToday()`, `popularLastDays($days)`, `popularThisWeek()`, `popularLastWeek()`, `popularThisMonth()`, `popularLastMonth()`, `popularThisYear()`, `popularLastYear()` e `popularBetween($from, $to)` para buscar resultados ranqueados em diferentes intervalos de datas. Uma camada de presenter de visitas, alimentada pelo pacote laravel-presenter, expõe atributos decorados, como endereço IP e detalhes do usuário associado, nos registros de visita. O pacote inclui testes PHPUnit executáveis com `composer test` e é lançado sob a licença MIT.