data-relish

## Aperçu Data Relish est un système d'analyse web open source et auto-hébergé, écrit en PHP avec un backend MySQL. Il mise sur la simplicité : un seul appel de fonction enregistre n'importe quel événement, tandis qu'un tableau de bord visualise les visiteurs uniques quotidiens, le détail des événements et les principaux pays grâce à Chart.js. Le projet convient aux sites de petite à moyenne ampleur souhaitant obtenir des informations basiques sur leur trafic sans dépendre de services tiers. ## Fonctionnalités clés - **Journalisation des événements** – Un appel PHP en une ligne `log_event("type", "cible")` enregistre les visites et événements personnalisés. - **Enrichissement IP** – Un traitement parallèle traduit les adresses IP en codes pays, permettant un reporting géographique. - **Tableau de bord** – Affiche les visiteurs uniques par jour, la répartition des événements et les pays dominants dans des graphiques interactifs. - **Auto-hébergement** – Fonctionne sur n'importe quel serveur compatible PHP avec MySQL ; aucune dépendance SaaS externe requise. - **Interface protégée par mot de passe** – Un simple contrôle (`?pass=...`) sécurise le tableau de bord. ## Installation et configuration 1. **Base de données** – Importez `data-relish.sql` dans MySQL pour créer la table requise. 2. **Configuration** – Modifiez les identifiants de la base de données en haut de `log_event.php` et `dashboard.php`. 3. **Instrumentation** – Incluez `log_event.php` dans toute page à suivre et appelez `log_event("type d'événement", "cible de l'événement");`. 4. **Accès au tableau de bord** – Ouvrez `dashboard.php?pass=changeme` dans un navigateur et changez le mot de passe par défaut dans le fichier. 5. **Données pays** – Cliquez sur le bouton *Enrich Country Data* dans le tableau de bord ou exécutez `update_countries.php` manuellement pour remplir les informations géographiques. ## Structure du projet - `data-relish.sql` – Schéma MySQL pour la table `events`. - `log_event.php` – Contient la connexion à la base de données et la fonction `log_event`. - `dashboard.php` – Génère l'interface d'analyse et rend les graphiques via Chart.js. - `update_countries.php` – Script qui résout les adresses IP stockées en codes pays. ## Exemple d'utilisation ```php include('log_event.php'); log_event('page_view', '/home'); ``` Après avoir déployé cet extrait sur n'importe quelle page, les visites apparaîtront dans le tableau de bord sous *Unique Visitors* et *Top Countries*. ## Démo en direct L'auteur fait fonctionner Data Relish sur un site personnel ; le tableau de bord est accessible publiquement à : https://zerovst.com/admin/data/stats.php?pass=jabberwocky!20o2 ## Statut de développement Le projet est encore en développement actif. Les utilisateurs sont encouragés à tester dans des environnements non critiques et à contribuer aux améliorations via des pull requests. ## Licence Data Relish est publié sous la licence MIT, autorisant l'utilisation gratuite, la modification et la redistribution. --- *Data Relish propose une alternative simple et respectueuse de la vie privée aux services d'analytics cloud, offrant aux développeurs un contrôle total sur leurs données de trafic.*