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

Aurora ایک اوپن سورس، سیلف ہوسٹڈ ویب اینالیٹکس ایپلی کیشن ہے جسے وزیٹرز کے آلات پر کچھ بھی اسٹور کیے بغیر ویب سائٹ ٹریفک کی پیمائش کے لیے ڈیزائن کیا گیا ہے۔ یہ کوئی کوکیز، localStorage یا fingerprinting استعمال نہیں کرتا، اور ایونٹ ڈیٹا کو آپریٹر کے کنٹرول میں PostgreSQL ڈیٹا بیس میں رکھتا ہے۔ براؤزر ٹریکنگ اسکرپٹ کا سائز 2.4 KB بتایا گیا ہے۔ وزیٹرز کی شناخت IP ایڈریس، یوزر ایجنٹ اور سرور سائیڈ سالٹ سے اخذ کردہ ایک روٹیٹنگ HMAC کے ذریعے کی جاتی ہے۔ ہیش ان پٹ روزانہ تبدیل ہوتا ہے، اس لیے وزیٹر IDs کو دنوں کے درمیان لنک نہیں کیا جا سکتا، اور براؤزر سے باہر جانے والی کسی بھی چیز کا مقصد کسی شخص تک قابلِ رساؤ ہونا نہیں ہے۔ یہ طریقہ ePrivacy Art. 5(3) کے حوالے سے متعلقہ پیش کیا گیا ہے، کیونکہ localStorage جیسے ٹرمینل آلات میں معلومات اسٹور کرنے کو کوکیز کے مماثل سمجھا جاتا ہے۔ ڈیش بورڈ منتخب کردہ رینج اور ٹائم زون کے لیے وزٹس، منفرد وزیٹرز، سیشنز، باؤنس ریٹ اور اوسط سیشن دورانیہ دکھاتا ہے۔ اس میں Recharts ٹائم سیریز اور صفحات، ریفررز، ایکوزیشن چینلز، ممالک، براؤزرز، آپریٹنگ سسٹمز، آلات، زبانوں اور UTM پیرامیٹرز کی تفصیلات شامل ہیں۔ کسٹم ایونٹس scalar props اور ریونیو ویلیوز لے سکتے ہیں، جس میں ISO-4217 کرنسیز شامل ہیں۔ ایک سائٹ کو پبلک مارک کیا جا سکتا ہے تاکہ لاگ ان کے بغیر ریڈ-اونلی اینالیٹکس ڈیش بورڈ دکھایا جا سکے۔ ڈپلائمنٹ linux/amd64 اور linux/arm64 کے لیے شائع شدہ Docker امیجز کے ذریعے دستیاب ہے۔ مطلوبہ کنفیگریشن میں DATABASE_URL اور SESSION_SECRET شامل ہیں، جبکہ پروڈکشن میں AURORA_SALT ضروری ہے۔ AURORA_IP_HEADER کی شدید سفارش کی جاتی ہے تاکہ قابلِ اعتماد پراکسی ہاپ کلائنٹ IP ڈیٹا کا تعین کرے؛ اگر یہ سیٹ نہ ہو، تو ایپلی کیشن وارننگ دیتی ہے اور ان ہیڈرز پر واپس جاتی ہے جنہیں کلائنٹس سیٹ کر سکتے ہیں۔ AURORA_COUNTRY_HEADER ایج سے کنٹری کوڈ کے لیے اختیاری ہے۔ سائٹ کو ٹریک کرنے کے لیے، ڈیش بورڈ سائٹ ID کے ساتھ ایک اسکرپٹ ٹیگ فراہم کرتا ہے۔ پیج ویوز اور کلائنٹ سائیڈ روٹ تبدیلیاں خود بخود ٹریک کی جاتی ہیں۔ کسٹم ایونٹس ایک گلوبل aurora فنکشن کو کال کرتے ہیں، جو اسکرپٹ لوڈ ہونے سے پہلے کی کالز کو کیو (queue) کرتا ہے۔ Props صرف scalars قبول کرتے ہیں، زیادہ سے زیادہ 24 کیز تک۔ ڈیولپمنٹ کے لیے Node 20+ اور pnpm 10 درکار ہے۔ یہ پروجیکٹ ایک pnpm ورک اسپیس ہے جس میں React Router ویب ایپلی کیشن اور ایک ٹریکر پیکیج ہے جو سرور شدہ اسکرپٹ میں بنڈل ہے۔ یہ PostgreSQL پر Drizzle، shadcn/ui کے ساتھ Tailwind CSS، Recharts، Vitest، اور oxlint/oxfmt استعمال کرتا ہے۔ کمٹس Conventional Commits پر عمل کرتے ہیں، ریلیزز release-please کے ساتھ خودکار ہیں، اور ورژننگ SemVer کے مطابق ہے۔ Aurora 4 کو مکمل طور پر نئے سرے سے لکھا گیا ہے جس میں 1.x یا 2.x سے مائیگریشن کا کوئی راستہ نہیں ہے۔ یہ پروجیکٹ MIT لائسنس کے تحت ہے۔