عن المشروع

## نظرة عامة أداة Web Visitor Analytics for Telegram هي وحدة مراقبة من جانب الخادم مصممة بلغة Python للعمل مع تطبيقات الويب القائمة على بايثون (Flask، Django، أو أي خادم خلفي Python). توفر تنبيهات فورية للزوار عبر واجهة Telegram Bot API، مع إثراء كل إشعار ببيانات الموقع الجغرافي ومقدم الخدمة المستمدة من خدمة IP-API العامة. ليست تطبيقاً مستقلاً — يجب لصق الكود المقدم داخل ملف التطبيق الرئيسي (مثل `app.py`) ليعمل جنباً إلى جنب مع معالجات المسارات الحالية. ## الميزات - **إشعارات تيليجرام فورية:** يتم إرسال تنبيهات فورية في كل مرة يتم فيها الوصول إلى صفحة، حيث تصل ملخصات الزيارات المنظمة مباشرة إلى مستخدم أو محادثة محددة على تيليجرام. - **بيانات الموقع الجغرافي:** تحلّل تلقائياً مدينة الزائر وبلده ومقدم خدمته عن طريق الاستعلام عن IP-API باستخدام عنوان IP المصدر من الطلب. - **تكامل غير متداخل:** تتضمن الوحدة معالجة أخطاء بحيث لا تعطل الأعطال في API التتبع أو توصيل تيليجرام سير عمل التطبيق الأساسي. - **عرض يحترم الخصوصية:** يتم إخفاء جزء من عناوين IP الكاملة في الإشعارات لتقليل التعرض مع الحفاظ على معلومات تعريفية مفيدة. ## المتطلبات - Python - مكتبة `requests` (`pip install requests`) - رمز بوت تيليجرام تم الحصول عليه من @BotFather - معرف الدردشة الشخصي الخاص بك، يمكن استرداده من @userinfobot ## التثبيت والإعداد 1. أنشئ بوتاً عبر @BotFather على تيليجرام واحتفظ برمز API. 2. احصل على معرف الدردشة من @userinfobot. 3. الصق كود التكامل في نقطة الإدخال الرئيسية لمشروعك (مثل `app.py`). 4. استبدل رموز ومعرفات الدردشة النائبة بقيمك الخاصة — يُفضل استخدام متغيرات البيئة بدلاً من كتابتها يدوياً. ``` pip install requests ``` ## ملاحظات التوافق الوحدة مكتوبة بـ Python النقي. تعمل مع Flask وDjango مباشرة ويمكن تكييفها مع أي خادم خلفي Python. لن تعمل على مواقع HTML الثابتة أو البيئات غير البايثونية دون نقل المنطق إلى تلك اللغات. ## إخلاء مسؤولية مهم - **دقة الموقع الجغرافي:** تُحدد المواقع بناءً على توجيه شبكة مقدم خدمة الزائر، وليس إحداثيات GPS. قد يظهر المستخدم في مدينة مختلفة عن موقعه الفعلي اعتماداً على كيفية توجيه مزوده لحركة المرور. - **الخصوصية والامتثال القانوني:** الأداة تجمع وتنقل بيانات مشتقة من IP. يتحمل المستخدم مسؤولية الامتثال للتنظيمات السارية مثل GDPR أو CCPA. استخدمها بأمانة ومسؤولية. - **الأمان:** لا تقم أبداً بكتابة رموز البوت أو معرفات الدردشة في مستودعات عامة. استخدم متغيرات البيئة أو مدير أسرار. ## حالة الاستخدام يستخدم المؤلف هذه الوحدة في موقع بورتفوليو خاص للإنتاج لمراقبة حركة الزوار الحية واستلام رؤى أمنية فورية على جهازه الشخصي عبر تيليجرام. يُظهر إشعار عيّني الـIP المُخفي واسم مقدم الخدمة والمدينة والبلد في رسالة منظمة بموجز.