عن المشروع

Helm Analytics هو حل تحليل ويب مفتوح المصدر يركز على الخصوصية، مصمم للمطورين والمسوقين والشركات التي تريد التحكم الكامل في بياناتها. بخلاف خدمات التحليل التقليدية التي تُدخل نصوص تعقّب ثقيلة وتستغل معلومات الزوار، يوفر Helm متتبع JavaScript خفيف الوزن (أقل من 2 كيلوبايت) ويخزن كل حدث على خوادم المستخدم الخاصة. **القدرات الرئيسية** - **مراقبة حركة المرور في الوقت الفعلي** – عرض الزوار المتزامنين، ومشاهدات الصفحات وتدفقات الأحداث بزمن استجابة أقل من ثانية. - **التتبع المتمحور حول الخصوصية** – نسبة الزوار الفريدين دون ملفات تعريف الارتباط الدائمة أو تسجيل عناوين IP؛ مع خيار إخفاء المدخلات الحساسة في إعادة تشغيل الجلسات. - **تفاصيل مكانية وجهازية** – تقارير مفصلة حسب البلد والمدينة والمتصفح ونظام التشغيل ونوع الجهاز. - **نسب حملة UTM** – تصنيف تلقائي لحملات التسويق لتحليل العائد على الاستثمار بسهولة. - **ذكاء الجلسات** – إعادة تشغيل عالية الدقة للجلسات، وخريطة حرارية، وتراكب النقرات والتمرير للكشف عن احتكاك تجربة المستخدم. - **قواعد التحويل** – بناء رحلات متعددة الخطوات وتحديد نقاط التسرب. - **إستقبال عالي الإنتاجية** – واجهة برمجة تطبيقات مكتوبة بـ Go تتعامل مع آلاف الأحداث في الثانية، مع حد معدل يعتمد على عنوان IP للحماية من الإساءة. **البنية المعمارية** - **واجهة برمجة التطبيقات للاستقبال (Go)** – خدمة خفيفة وعالية الموازاة تُجري كتابات مجمعّرة إلى ClickHouse. - **ClickHouse** – قاعدة بيانات تحليلية عمودية مُحسّنة لعمليات استعلام OLAP السريعة عبر سجلات الأحداث الضخمة. - **PostgreSQL** – تُخزن البيانات الوصفية مثل حسابات المستخدمين وإعدادات المواقع والتكوينات. - **الواجهة الأمامية (React/Vite)** – لوحة تحكم متجاوبة بتطبيق صفحة واحدة مع رسوم بيانية وبيانات مرئية في الوقت الفعلي. - **Docker وCaddy** – توفر الحاويات العزل؛ ويمكن لـ Caddy إصدار شهادات Let's Encrypt تلقائياً. **خيارات النشر** 1. **سكربت بنقرة واحدة** – شغّل `curl -sSL https://helm-analytics.com/install.sh | bash` على خادم Ubuntu/Debian جديد. يقوم السكربت بتثبيت Docker وسحب الصور وتكوين Caddy (في حال اختيار SSL) وتشغيل المجموعة. 2. **Docker Compose يدوياً** – حمّل ملف `docker-compose.yml` المُرفق وشغّل الأمر `docker compose up -d`. 3. **وكيل عكسي مخصص** – دمجه مع إعدادات Nginx/Traefik الحالية عن طريق تعريض منافذ واجهة برمجة التطبيقات ولوحة التحكم. **مكتبات SDK** يوفر Helm مكتبات جانب الخادم لـ Go وPython وNode.js، قابلة للتكوين عبر متغيرات البيئة (`HELM_SITE_ID`, `HELM_API_URL`). تُظهر أمثلة الكود كيفية تتبع صفحات الويب أو الأحداث المخصصة مباشرة من كود الواجهة الخلفية. **المجتمع والدعم** المشروع نشط على X (Twitter) ويوفر دعماً عبر البريد الإلكتروني. تُرحَّب بالمساهمات عبر طلبات السحب على GitHub، ويُصدر الكود بموجب ترخيص AGPL-3.0، مما يضمن بقاء أي تعديلات مفتوحة المصدر. **لماذا تختار Helm Analytics؟** - ملكية كاملة للبيانات – لا توجد جمع بيانات من طرف ثالث. - أداء عالٍ – يوفر ClickHouse أوقات استعلام أقل من ثانية حتى على المواقع عالية الحجم. - قابل للتوسيع – تتيح مكتبات SDK وواجهة برمجة التطبيقات الدمج مع أي تكنولوجيا. - استضافة ذاتية – تتحكم بالبيئة والأمان والتوسع بنفسك. يُعد Helm Analytics مثالياً لكل من يحتاج إلى رؤى تفصيلية حول حركة مرور الويب دون التضحية بخصوصية المستخدم أو الأداء.