Об этом проекте

## Обзор Data Relish — это открытая аналитическая веб-система для самостоятельного хостинга, написанная на PHP с бэкендом MySQL. В ее основе лежит простота: один вызов функции регистрирует любое событие, а дашборд визуализирует ежедневных уникальных посетителей, детализацию событий и топ стран с помощью Chart.js. Проект подходит для небольших и средних сайтов, которым нужна базовая аналитика трафика без использования сторонних сервисов. ## Основные возможности - **Логирование событий** — Вызов одной строки PHP `log_event("type", "target")` регистрирует посещения и пользовательские события. - **Обогащение IP-данных** — Фоновое сопоставление преобразует IP-адреса в коды стран для формирования географической отчетности. - **Дашборд** — Отображает уникальных посетителей в день, распределение событий и топ стран на интерактивных диаграммах. - **Self‑hosted** — Работает на любом сервере с поддержкой PHP и MySQL; никаких внешних SaaS-зависимостей. - **Защищенный паролем интерфейс** — Простая проверка пароля (`?pass=...`) защищает дашборд. ## Установка и настройка 1. **База данных** — Импортируйте `data-relish.sql` в MySQL для создания необходимой таблицы. 2. **Конфигурация** — Отредактируйте учетные данные базы данных в верхней части файлов `log_event.php` и `dashboard.php`. 3. **Интеграция** — Подключите `log_event.php` на любой странице, которую хотите отслеживать, и вызовите `log_event("event type", "event target");`. 4. **Доступ к дашборду** — Откройте `dashboard.php?pass=changeme` в браузере и измените пароль по умолчанию в файле. 5. **Данные по странам** — Нажмите кнопку *Enrich Country Data* на дашборде или запустите `update_countries.php` вручную, чтобы заполнить географическую информацию. ## Структура проекта - `data-relish.sql` — Схема MySQL для таблицы `events`. - `log_event.php` — Содержит подключение к БД и функцию `log_event`. - `dashboard.php` — Генерирует интерфейс аналитики и отображает графики с помощью Chart.js. - `update_countries.php` — Скрипт, преобразующий сохраненные IP-адреса в коды стран. ## Пример использования ```php include('log_event.php'); log_event('page_view', '/home'); ``` После размещения этого фрагмента кода на любой странице посещения будут отображаться на дашборде в разделах *Unique Visitors* и *Top Countries*. ## Демо-версия Автор использует Data Relish на личном сайте; дашборд доступен публично по адресу: https://zerovst.com/admin/data/stats.php?pass=jabberwocky!20o2 ## Статус разработки Проект находится в стадии активной разработки. Пользователям рекомендуется тестировать его в некритичных окружениях и предлагать улучшения через pull request. ## Лицензия Data Relish распространяется под лицензией MIT, что разрешает бесплатное использование, изменение и распространение. --- *Data Relish предоставляет простую альтернативу облачным аналитическим сервисам, ориентированную на конфиденциальность, и дает разработчикам полный контроль над данными о трафике.*