প্রকল্প সম্পর্কে

## ওভারভিউ Data Relish হলো একটি ওপেন-সোর্স, সেল্ফ-হোস্টেড ওয়েব অ্যানালিটিক্স সিস্টেম যা PHP দিয়ে লেখা এবং এর ব্যাকএন্ড হিসেবে MySQL ব্যবহার করে। এটি সহজতায় ধ্যানধারণা: একটি মাত্র ফাংশন কলে যেকোনো ইভেন্ট লগ করা যায় এবং ড্যাশবোর্ড দৈনিক অনন্য ভিজিটর, ইভেন্ট বিভাজন এবং শীর্ষ দেশগুলো Chart.js দিয়ে ভিজ্যুয়ালাইজ করে। এই প্রজেক্ট ছোট-থেকে-মাঝারি ওয়েবসাইটের জন্য উপযোগী যেগুলো মূলধারার থার্ড-পার্টি সার্ভিসের ওপর নির্ভর না করে মৌলিক ট্র্যাফিক ইনসাইট চায়। ## প্রধান বৈশিষ্ট্য - **ইভেন্ট লগিং** – এক-লাইনের PHP কল `log_event("type", "target")` ভিজিট এবং কাস্টম ইভেন্ট রেকর্ড করে। - **IP সমৃদ্ধকরণ** – সমান্তরাল প্রক্রিয়া IP ঠিকানাগুলোকে দেশ কোডে রূপান্তর করে, যা ভৌগোলিক রিপোর্টিং সুবিধা দেয়। - **ড্যাশবোর্ড** – প্রতিদিনের অনন্য ভিজিটর, ইভেন্ট বন্টন এবং শীর্ষ দেশগুলো ইন্টারেক্টিভ চার্টে দেখায়। - **সেল্ফ-হোস্টেড** – যেকোনো PHP-সামঞ্জস্যপূর্ণ সার্ভারে MySQL সহ চলে; বাইরের SaaS নির্ভরতা নেই। - **পাসওয়ার্ড-সুরক্ষিত UI** – সাধারণ পাসওয়ার্ড চেক (`?pass=...`) ড্যাশবোর্ড সুরক্ষিত রাখে। ## ইনস্টলেশন ও সেটআপ 1. **ডেটাবেস** – প্রয়োজনীয় টেবিল তৈরি করতে `data-relish.sql` মাইগ্রেশন করুন। 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` – Chart.js-এর মাধ্যমে অ্যানালিটিক্স UI তৈরি করে এবং চার্ট রেন্ডার করে। - `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 ## উন্নয়ন অবস্থা প্রজেক্টটি এখনো সক্রিয় উন্নয়নাধীন। ব্যবহারকারীদেরকে অ-নিರ್ণায়ক পরিবেশে টেস্ট করতে এবং পুল রিকোয়েস্টের মাধ্যমে উন্নতি অবদান রাখতে উৎসাহিত করা হচ্ছে। ## লাইসেন্স Data Relish MIT License-অধীনে প্রকাশিত, যা বিনামূল্যে ব্যবহার, পরিবর্তন এবং বিতরণ অনুমতি দেয়। --- *Data Relish মেঘভিত্তিক অ্যানালিটিক্স সার্ভিসগুলোর তুলনায় একটি সরল, গোপনীয়তা-বান্ধব বিকল্প প্রদান করে, ডেভেলপারদেরকে তাদের ট্র্যাফিক ডেটার ওপর পূর্ণ নিয়ন্ত্রণ দেয়।*