data-relish

## Descripción general Data Relish es un sistema de análisis web de código abierto y autohospedado, escrito en PHP con un backend de MySQL. Se centra en la simplicidad: una única llamada de función registra cualquier evento, y un panel de control visualiza los visitantes únicos diarios, el desglose de eventos y los principales países utilizando Chart.js. El proyecto es adecuado para sitios web pequeños y medianos que necesitan información básica sobre el tráfico sin depender de servicios de terceros. ## Características principales - **Registro de eventos** – Una llamada PHP de una línea `log_event("tipo", "objetivo")` registra visitas y eventos personalizados. - **Enriquecimiento de IP** – Una rutina paralela traduce las direcciones IP a códigos de país, lo que permite generar informes geográficos. - **Panel de control** – Muestra visitantes únicos por día, distribución de eventos y principales países en gráficos interactivos. - **Autohospedado** – Se ejecuta en cualquier servidor compatible con PHP y MySQL; sin dependencias externas de SaaS. - **Interfaz protegida por contraseña** – Una simple verificación de contraseña (`?pass=...`) protege el panel de control. ## Instalación y configuración 1. **Base de datos** – Importe `data-relish.sql` en MySQL para crear la tabla necesaria. 2. **Configuración** – Edite las credenciales de la base de datos en la parte superior de `log_event.php` y `dashboard.php`. 3. **Instrumentación** – Incluya `log_event.php` en cualquier página que desee rastrear y llame a `log_event("tipo de evento", "objetivo del evento");`. 4. **Acceso al panel** – Abra `dashboard.php?pass=changeme` en un navegador y cambie la contraseña predeterminada en el archivo. 5. **Datos de país** – Haga clic en el botón *Enrich Country Data* en el panel o ejecute `update_countries.php` manualmente para completar la información geográfica. ## Estructura del proyecto - `data-relish.sql` – Esquema de MySQL para la tabla `events`. - `log_event.php` – Contiene la conexión a la base de datos y la función `log_event`. - `dashboard.php` – Genera la interfaz de usuario de análisis y renderiza gráficos mediante Chart.js. - `update_countries.php` – Script que resuelve las IP almacenadas a códigos de país. ## Ejemplo de uso ```php include('log_event.php'); log_event('page_view', '/home'); ``` Después de implementar el fragmento anterior en cualquier página, las visitas aparecerán en el panel de control bajo *Unique Visitors* y *Top Countries*. ## Demostración en vivo El autor ejecuta Data Relish en un sitio personal; el panel de control es accesible públicamente en: https://zerovst.com/admin/data/stats.php?pass=jabberwocky!20o2 ## Estado de desarrollo El proyecto sigue en desarrollo activo. Se anima a los usuarios a probarlo en entornos no críticos y a contribuir con mejoras a través de solicitudes de extracción (pull requests). ## Licencia Data Relish se publica bajo la Licencia MIT, lo que permite su uso, modificación y distribución gratuita. --- *Data Relish ofrece una alternativa sencilla y respetuosa con la privacidad a los servicios de análisis en la nube, brindando a los desarrolladores un control total sobre sus datos de tráfico.*