عن المشروع

## نظرة عامة Data Relish نظام تحليلات ويب مفتوح المصدر وقابل للاستضافة الذاتية، مكتوب بلغة PHP مع قاعدة بيانات MySQL كواجهة خلفية. يركّز على البساطة: استدعاء دالة واحد يسجّل أي فعالية، ولوحة تحكم تصوّر الزوار الفريدين يوميًا وتوزيع الفعاليّات وأعلى البلدان باستخدام Chart.js. المشروع مناسب للمواقع الصغيرة والمتوسطة التي تحتاج إلى رؤى حركة مرور أساسية دون الاعتماد على خدمات جهات خارجية. ## الميزات الرئيسية - **تسجيل الفعاليّات** – استدعاء PHP في سطر واحد `log_event("type", "target")` لتسجيل الزيارات والفعاليّات المخصّصة. - **إثراء عناوين IP** – إجراء متوازي يحوّل عناوين IP إلى رموز بلدان، ما يتيح التقارير الجغرافية. - **لوحة تحكم** – تعرض الزوار الفريدين يوميًا وتوزيع الفعاليّات وأفضل البلدان في رسوم بيانية تفاعلية. - **استضافة ذاتية** – يعمل على أي خادم متوافق مع 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 requests). ## الرخصة صدر Data Relish بموجب رخصة MIT، مما يسمح بالاستخدام المجاني والتعديل والتوزيع. --- *يقدّم Data Relish بديلاً مباشرًا وصديقًا للخصوصية لخدمات التحليل السحابية، مما يمنح المطوّرين تحكمًا كاملًا في بيانات حركة المرور.*