इस प्रोजेक्ट के बारे में

## अवलोकन डेटा रेलिश PHP में लिखा गया एक ओपन-सोर्स, स्व-होस्टेड वेब एनालिटिक्स सिस्टम है जिसका MySQL बैकएंड है। यह सरलता पर ध्यान केंद्रित करता है: कोई भी इवेंट लॉग करने के लिए एक फ़ंक्शन कॉल पर्याप्त है, और एक डैशबोर्ड Chart.js का उपयोग करके दैनिक अद्वितीय आगंतुकों, इवेंट वितरण और शीर्ष देशों का चित्रण करता है। यह प्रोजेक्ट उन छोटे-से मध्यम वेबसाइटों के लिए उपयुक्त है जिनको तृतीय-पक्ष सेवाओं पर निर्भर किए बिना बुनियादी ट्रैफ़िक अंतर्दृष्टि चाहिए होती है। ## मुख्य विशेषताएँ - **इवेंट लॉगिंग** – एक-लाइन PHP कॉल `log_event("type", "target")` विज़िट्स और कस्टम इवेंट्स को रिकॉर्ड करती है。 - **IP समृद्धि** – पैरेलल रूटीन IP पते को देश कोड में बदलती है, जिससे भौगोलिक रिपोर्टिंग संभव होती है。 - **डैशबोर्ड** – प्रत्येक दिन के अद्वितीय आगंतुक, इवेंट वितरण और इंटरैक्टिव चार्ट में शीर्ष देश प्रदर्शित करता है。 - **स्व-होस्टेड** – किसी भी PHP-संगत सर्वर पर MySQL के साथ चलता है; किसी भी बाहरी SaaS निर्भरता की आवश्यकता नहीं。 - **पासवर्ड-सुरक्षित UI** – सरल पासवर्ड चेक (`?pass=...`) डैशबोर्ड को सुरक्षित रखता है。 ## स्थापना और सेटअप 1. **डेटाबेस** – `data-relish.sql` को MySQL में आयात करें ताकि आवश्यक तालिका बन जाए。 2. **विन्यास** – `log_event.php` और `dashboard.php` के शीर्ष पर डेटाबेस क्रेडेंशियल को संपादित करें。 3. **इंस्ट्रুমेंटेशन** – उन सभी पेजों में `log_event.php` को शामिल करें जिन्हें आप ट्रैक करना चाहते हैं, और `log_event("इवेंट प्रकार", "इवेंट टार्गेट");` कॉल करें。 4. **डैशबोर्ड एक्सेस** – ब्राउज़र में `dashboard.php?pass=changeme` खोलें और फ़ाइल में डिफ़ॉल्ट पासवर्ड बदल दें。 5. **देश डेटा** – डैशबोर्ड पर *Enrich Country Data* बटन पर क्लिक करें या भौगोलिक जानकारी भरे जाने के लिए `update_countries.php` को मैन्युअल रूप से चलाएं。 ## प्रोजेक्ट संरचना - `data-relish.sql` – `events` तालिका के लिए MySQL स्कीमा。 - `log_event.php` – DB कनेक्शन और `log_event` फ़ंक्शन होता है。 - `dashboard.php` – एनालिटिक्स UI उत्पन्न करता है और Chart.js के माध्यम से चार्ट प्रदर्शित करता है。 - `update_countries.php` – उस स्क्रिप्ट को देश कोड में बदलती है。 ## उपयोग उदाहरण ```php include('log_event.php'); log_event('page_view', '/home'); ``` ऊपर दिए गए स्निपेट को किसी भी पेज पर तैनात करने के बाद, विज़िट डैशबोर्ड के *Unique Visitors* और *Top Countries* के तहत दिखाई देंगी。 ## लाइव डेमो लेखक अपनी व्यक्तिगत साइट पर डेटा रेलिश चलाते हैं; डैशबोर्ड सार्वजनिक रूप से उपलब्ध है: https://zerovst.com/admin/data/stats.php?pass=jabberwocky!20o2 ## विकास स्थिति प्रोजेक्ट अभी भी सक्रिय विकास में है। उपयोगकर्ताओं को गैर-निर्णायक वातावरण में परीक्षण करने और सुधार के लिए पूल रिक्वेस्ट के माध्यम से योगदान देने के लिए प्रोत्साहित किया जाता है。 ## लाइसेंस डेटा रेलिश MIT लाइसेंस के तहत प्रकाशित है, जिसके तहत मुफ़्त उपयोग, संशोधन और वितरण की अनुमति है。 --- *डेटा रेलिश क्लाउड एनालिटिक्स सेवाओं के सापेक्ष एक सीधा, प्राइवेसी-सुरक्षित विकल्प प्रदान करता है, जिससे डेवलपर को अपने ट्रैफ़िक डेटा पर पूर्ण नियंत्रण मिलता है।*