Sobre o projeto

## Visão Geral Data Relish é um sistema de análise web open-source e autogerenciado, escrito em PHP com backend MySQL. Foca na simplicidade: uma única chamada de função registra qualquer evento, e um painel visualiza visitantes únicos diários, detalhamento de eventos e principais países usando Chart.js. O projeto é adequado para sites pequenos e médios que precisam de insights básicos de tráfego sem depender de serviços de terceiros. ## Principais Recursos - **Registro de eventos** – Chamada PHP de uma linha `log_event("type", "target")` registra visitas e eventos personalizados. - **Enriquecimento de IP** – Rotina paralela traduz endereços IP para códigos de país, permitindo relatórios geográficos. - **Painel** – Mostra visitantes únicos por dia, distribuição de eventos e principais países em gráficos interativos. - **Autogerenciado** – Funciona em qualquer servidor compatível com PHP e MySQL; sem dependências de SaaS externas. - **UI protegida por senha** – Verificação simples de senha (`?pass=...`) protege o painel. ## Instalação e Configuração 1. **Banco de dados** – Importe `data-relish.sql` no MySQL para criar a tabela necessária. 2. **Configuração** – Edite as credenciais do banco no topo de `log_event.php` e `dashboard.php`. 3. **Instrumentação** – Inclua `log_event.php` em qualquer página que deseja rastrear e chame `log_event("tipo do evento", "alvo do evento");`. 4. **Acesso ao painel** – Abra `dashboard.php?pass=changeme` no navegador e altere a senha padrão no arquivo. 5. **Dados de país** – Clique no botão *Enrich Country Data* no painel ou execute `update_countries.php` manualmente para popular as informações geográficas. ## Estrutura do Projeto - `data-relish.sql` – Schema MySQL para a tabela `events`. - `log_event.php` – Contém a conexão com o BD e a função `log_event`. - `dashboard.php` – Gera a interface de análises e renderiza gráficos via Chart.js. - `update_countries.php` – Script que resolve IPs armazenados para códigos de país. ## Exemplo de Uso ```php include('log_event.php'); log_event('page_view', '/home'); ``` Após implementar o snippet acima em qualquer página, as visitas aparecerão no painel em *Unique Visitors* e *Top Countries*. ## Demonstração ao Vivo O autor executa o Data Relish em um site pessoal; o painel está publicamente acessível em: https://zerovst.com/admin/data/stats.php?pass=jabberwocky!20o2 ## Status de Desenvolvimento O projeto ainda está em desenvolvimento ativo. Os usuários são encorajados a testar em ambientes não críticos e contribuir com melhorias por meio de pull requests. ## Licença Data Relish é lançado sob a Licença MIT, permitindo uso livre, modificação e distribuição. --- *Data Relish oferece uma alternativa direta e amigável à privacidade aos serviços de análise em nuvem, dando aos desenvolvedores controle total sobre seus dados de tráfego.*