عن المشروع

توفر pvuv.ai حلاً خفيفاً للتحليلات يتم نشره على الحافة (edge-deployed)، حيث يمكنك استضافته بنفسك على Cloudflare Workers مع استخدام D1 كخلفية للتخزين. بالإضافة إلى تعدادات مشاهدات الصفحة (page-view) والزوار الفريدين (unique-visitor) الكلاسيكية، فإنها تلتقط معاملات UTM الكاملة، والمراجع (referrers)، ومعدل الارتداد، ووقت المكوث، والأحداث المخصصة مع الإيرادات، وإسناد الجلسات عبر الأجهزة. الميزة الأساسية هي نظام الكشف عن الزيارات غير الصالحة المكون من ثلاث طبقات. يقوم النظام بتقييم إشارات جانب العميل (سمات headless، بصمات WebGL، ومصائد honeypots)، وسلوك الجلسة (التوقيت، وأنماط التنقل)، وإحصائيات السكان (تجميع قطاعات IP، واختبارات التوزيع). يتلقى كل حدث درجة موثوقية من 0 إلى 100، وحكماً (نظيف، مشبوه، بوت، زاحف)، وأعلاماً تشير إلى الإشارات التي تسببت في ذلك. حماية الإعلانات اختيارية: بناءً على الحكم السريع، تقرر المنصة ما إذا كانت ستقوم بحقن كود الإعلانات، مما يحافظ على الإيرادات من عقوبات الزيارات غير الصالحة. العتبات قابلة للتكوين لكل موقع، ويسمح "وضع الظل" (shadow mode) للمشغلين بمعاينة التأثير قبل التنفيذ. البنية التحتية: - يقوم المتصفح بتحميل نص برمجى صغير (f.js) يرسل الضربات إلى Worker الاستيعاب (in.pvuv.ai/in). - يقوم Worker الاستيعاب بالتحقق من الأحداث وإثرائها وتسجيل درجاتها، ثم يدفعها إلى Cloudflare Queue. - يقوم Consumer Worker بتجميع عمليات الكتابة إلى D1، وتحديث الجلسات والملفات الشخصية. - تقوم Cron Workers (ساعية ويومية) بإجراء عمليات التجميع (roll-ups) وتحليل السكان، وتغذية قوائم الحظر عبر KV. - يقوم API Worker (api.pvuv.ai/v1) بخدمة استعلامات لوحة التحكم، بينما توفر وحدة التحكم (pvuv.ai) تقارير مرئية ورؤى مولدة بواسطة الذكاء الاصطناعي. يتم النشر من خلال حزمة serverless الخاصة بـ Cloudflare: Workers و D1 (SQLite) و Queues و KV و Cron Triggers، واختيارياً R2 للتخزين الأرشيفي. لا يلزم وجود خوادم أو قواعد بيانات خارجية. تتضمن خطوات البدء السريع استنساخ المستودع (repo)، وإنشاء موارد D1 و KV و Queue باستخدام Wrangler، وتكوين الأسرار (HMAC_KEY، واختيارياً AI_API_KEY)، وتطبيق المخطط (schema)، ونشر الـ Workers. بعد النشر، قم بتسجيل موقع في وحدة التحكم للحصول على site_id وتضمين علامة script تشير إلى https://js.pvuv.ai/f.js مع سمات البيانات المناسبة. اعتبارات الخصوصية مدمجة: يتم تخزين عناوين IP فقط كهاشات مقطوعة، ويتم تشفير بصمات الأجهزة، وتقتصر بيانات المستشعرات على قيم منطقية تقريبية. يجب على الناشرين ضمان الامتثال للوائح GDPR/ePrivacy، خاصة فيما يتعلق بالموافقة على البصمة الرقمية. المشروع في مراحل التطوير المبكرة، مع خارطة طريق تحدد أربع مراحل: M1 (SDK أساسي، استيعاب، حكم سريع، وحدة تحكم دنيا)، M2 (مقاييس الجلسة، تجميعات، حلقة قائمة الحظر)، M3 (أحداث مخصصة، إيرادات، إسناد القمع)، و M4 (تقارير ذكاء اصطناعي، مكافحة احتيال متقدمة، واجهة مراجعة بشرية). المساهمات مرحب بها، ويجب الإبلاغ عن المشكلات الأمنية بشكل خاص. الكود مرخص بموجب GNU AGPL-3.0، مما يسمح بالاستضافة الذاتية والتعديل المجاني مع اشتراط الكشف عن المصدر لخدمات الشبكة.