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

فرلیٹکس ایک اوپن سورس ویب تجزیاتی پلیٹ فارم ہے جو وزیٹرز کی فردی صفحات پر گزارنے والی وقت کی پیروی کرتا ہے۔ اسے موجودہ تجزیاتی خدمات میں پرائیویسی کی چिंताؤں اور "صفحے پر وقت" کے میٹرکس کی کمی کو دور کرنے کے لیے بنایا گیا تھا۔ **اہم خصوصیات** - براؤزر سائیڈ جاوا اسکرپٹ سنٹی جو ہر وزیٹر کے لیے منفرد UUID پیدا کرتا ہے اور بیک اینڈ کو *کھولیں* اور *بند کریں* کے واقعات بھیجتا ہے۔ - ٹائپ اسکرپٹ میں لکھا گیا بیک اینڈ، جو Cloudflare Workers پر چلتا ہے، واقعات کی وصولی اور ڈیش بورڈ استفسارات کے لیے کم از کم HTTP API فراہم کرتا ہے۔ - واقعات کو ڈیٹابیس میں محفوظ کرتا ہے؛ منصوبے نے اصل میں MongoDB استعمال کیا اور بہتر پیمانے کی رفتار کے لیے PlanetScale/MySQL میں منتقل ہو رہا ہے۔ - ہر ڈپلائمنٹ کے لیے ایک سنگل ڈومین کی حمایت کرتا ہے (مستقبل میں ملٹی ڈومین کی حمایت منصوبہ بند ہے)۔ - پرائیویسی-فرسٹ نقطہ نظر: کوئی تھرڈ پارٹی ٹریکنگ نہیں، مکمل طور پر خود میزبان، اور EU ضوابط کے مطابق۔ **تعمیراتی ڈھانچہ** 1. **براؤزر اسکرپٹ** (`/analytics`): ہدف ویب سائٹ میں شامل، یہ صفحہ لوڈ/آئون واقعے ریکارڈ کرتا ہے اور انہیں ورکر کو بھیجتا ہے۔ 2. **Cloudflare ورکر** (`/src`): واقعات وصول کرتا ہے، انہیں ڈیٹابیس میں لکھتا ہے، اور ڈیش بورڈ کے لیے ڈیٹا جمع کرتا ہے۔ 3. **ڈیٹابیس**: فی الحال MongoDB، تعلق کی بنیاد پر استفسارات اور اعتماد کے لیے PlanetScale (MySQL compatible) میں منتقل ہو رہا ہے۔ **ترقی کی حیثیت** - بوداپسٹ یونیورسٹی آف ٹیکنالوجی اینڈ اكونامکس میں Google ڈویلپر اسٹوڈنٹ کلب کے تحت فعال ترقی۔ - ابھی تک پروڈکشن کے لیے تیار نہیں؛ ریپوزٹری میں حصہ لینے کے رہنما اصول اور ترقیاتی سیٹ اپ شامل ہیں۔ **شروعات کیسے کریں** - مفت Cloudflare اور PlanetScale اکاؤنٹس بنائیں۔ - Node.js انسٹال کریں (nvm کے ذریعے تجویز کردہ) اور `npm install` چلائیں۔ - مقامی ٹیسٹنگ کے لیے `.dev.vars` میں راز کنفیگر کریں یا پروڈکشن کے لیے Cloudflare UI کے ذریعے۔ - `npm run dev` کے ساتھ مقامی Workers سرور شروع کریں۔ **حصہ داری** - GitHub ریپوزٹری یا پروجیکٹ بورڈ سے کھلا مسئلہ منتخب کریں۔ - ریپوزٹری کو فالک کریں، ترقیاتی سیٹ اپ کی پیروی کریں، اور GitHub بہاؤ کا استعمال کرتے ہوئے پول ریکویسٹ جمع کرائیں۔ **لائسنس** - GPLv3。 فرلیٹکس مقصد سائٹ مالکان کو ایک سادہ، پرائیویسی کا احترام کرنے والا طریقہ فراہم کرنا ہے تاکہ وہ بیرونی تجزیاتی فراہم کنندگان پر انحصار کے بغیر قارئین کی دلچسپی کو سمجھ سکیں۔