منصوبے کے بارے میں

pvuv.ai ایک ہلکا پھلکا، ایج-ڈپلائےڈ اینالیٹکس حل فراہم کرتا ہے جسے آپ Cloudflare Workers پر خود ہوسٹ کر سکتے ہیں، جس میں D1 اسٹوریج بیک اینڈ کے طور پر کام کرتا ہے۔ کلاسک پیج-ویو اور یونیک-وزٹر کاؤنٹس کے علاوہ، یہ مکمل UTM پیرامیٹرز، ریفررز، باؤنس ریٹ، ڈویل ٹائم، ریونیو کے ساتھ کسٹم ایونٹس، اور کراس-ڈیوائس سیشن ایٹریبیوشن کو کیپچر کرتا ہے۔ اس کی بنیادی خصوصیت اس کا تین تہوں والا انویلڈ-ٹریفک ڈیٹیکشن سسٹم ہے۔ یہ کلائنٹ-سائیڈ سگنلز (headless traits, WebGL fingerprints, honeypots)، سیشن رویے (ٹائمنگ، نیویگیشن پیٹرنز)، اور پاپولیشن اعداد و شمار (IP-segment clustering, distribution tests) کا جائزہ لیتا ہے۔ ہر ایونٹ کو 0-100 کے درمیان ایک مستند اسکور، ایک فیصلہ (clean, suspect, bot, crawler)، اور ان سگنلز کے جھنڈے ملتے ہیں جنہوں نے اسے ٹرگر کیا۔ اشتہارات کا تحفظ اختیاری ہے: تیز رفتار فیصلے کی بنیاد پر، پلیٹ فارم یہ فیصلہ کرتا ہے کہ اشتہاری کوڈ شامل کرنا ہے یا نہیں، تاکہ ریونیو کو انویلڈ-ٹریفک کے جرمانوں سے محفوظ رکھا جا سکے۔ تھریشولڈز ہر سائٹ کے لیے قابلِ ترتیب ہیں، اور ایک شیڈو موڈ آپریٹرز کو نفاذ سے پہلے اثرات کا جائزہ لینے کی اجازت دیتا ہے۔ آرکیٹیکچر: - براؤزر ایک چھوٹا اسکرپٹ (f.js) لوڈ کرتا ہے جو ingest Worker (in.pvuv.ai/in) کو ہٹس بھیجتا ہے۔ - Ingest ایونٹس کی تصدیق، اضافہ اور اسکورنگ کرتا ہے، پھر انہیں Cloudflare Queue میں بھیجتا ہے۔ - ایک consumer Worker D1 میں بیچ رائٹس کرتا ہے، سیشنز اور پروفائلز کو اپ ڈیٹ کرتا ہے۔ - گھنٹہ وار اور روزانہ Cron Workers رول-اپس اور پاپولیشن تجزیہ کرتے ہیں، اور KV کے ذریعے بلاک لسٹس فراہم کرتے ہیں۔ - ایک API Worker (api.pvuv.ai/v1) ڈیش بورڈ کی پوچیاں فراہم کرتا ہے، جبکہ کنسول (pvuv.ai) بصری رپورٹس اور AI-جنریٹڈ بصیرتیں فراہم کرتا ہے۔ ڈپلائمنٹ Cloudflare کے سرور لیس اسٹیک کے ذریعے چلتی ہے: Workers, D1 (SQLite), Queues, KV, Cron Triggers، اور اختیاری طور پر آرکائیول اسٹوریج کے لیے R2۔ کسی بیرونی سرور یا ڈیٹا بیس کی ضرورت نہیں ہے۔ کوئیک اسٹارٹ اقدامات میں ریپو کو کلون کرنا، Wrangler کے ساتھ D1, KV، اور Queue ریسورسز بنانا، سیکریٹس (HMAC_KEY, اختیاری AI_API_KEY) کنفیگر کرنا، اسکیما لاگو کرنا، اور Workers کو ڈیپلائے کرنا شامل ہے۔ ڈیپلائمنٹ کے بعد، site_id حاصل کرنے کے لیے کنسول میں سائٹ رجسٹر کریں اور مناسب ڈیٹا ایٹریبیوٹس کے ساتھ https://js.pvuv.ai/f.js کی طرف اشارہ کرنے والا اسکرپٹ ٹیگ شامل کریں۔ پرائیویسی کے تحفظات پہلے سے موجود ہیں: IP ایڈریس صرف ٹرنکیٹڈ ہیشز کے طور پر اسٹور کیے جاتے ہیں، ڈیوائس فنگر پرنٹس ہیش کیے جاتے ہیں، اور سینسر ڈیٹا محدود ہوتا ہے۔ ڈیپلائرز کو GDPR/ePrivacy قواعد و ضوابط کی تعمیل کو یقینی بنانا چاہیے، خاص طور پر فنگر پرنٹنگ کی رضامندی کے حوالے سے۔ پروجیکٹ ابتدائی ترقی کے مرحلے میں ہے، جس کے روڈ میپ میں چار سنگ میل ہیں: M1 (بنیادی SDK, ingest, fast verdict, minimal console)، M2 (سیشن میٹرکس, roll-ups, blocklist loop)، M3 (کسٹم ایونٹس, ریونیو, funnel attribution)، اور M4 (AI رپورٹس, ایڈوانس اینٹی-فراڈ, human review UI)۔ تعاون کو خوش آمدید کہا جاتا ہے، اور سیکیورٹی مسائل کی رپورٹ نجی طور پر کی جانی چاہیے۔ کوڈ GNU AGPL-3.0 کے تحت لائسنس شدہ ہے، جو نیٹ ورک سروسز کے لیے سورس ڈسکلوزر کی شرط کے ساتھ مفت سیلف-ہوسٹنگ اور ترمیم کی اجازت دیتا ہے۔