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

OpenPanel ایک اوپن سورس ویب اور پروڈکٹ اینالٹکس پلیٹ فارم ہے جسے پروجیکٹ Mixpanel کے متبادل کے طور پر بیان کرتا ہے، جو پروڈکٹ اینالٹکس کی گہرائی کو ہلکے پھلکے ویب اینالٹکس ٹولز کی سادگی کے ساتھ جوڑتا ہے۔ اسے ہوسٹڈ سروس کے طور پر یا سیلف ہوسٹڈ استعمال کیا جا سکتا ہے، جس سے آپریٹرز کو اپنے ڈیٹا اور انفراسٹرکچر پر کنٹرول ملتا ہے۔ **دستاویزی فیچرز** - ایڈوانسڈ اینالٹکس: فنلز، کوہورٹس، یوزر پروفائلز اور سیشن ہسٹری - سیشن ری پلے: صارف کے سیشنز کو ریکارڈ اور ری پلے کرنا، جس میں پرائیویسی کنٹرولز شامل ہیں - لائیو ڈیٹا اپ ڈیٹس اور انٹرایکٹو چارٹس کے ساتھ ریئل ٹائم ڈیش بورڈز - ویرینٹ بریک ڈاؤنز کے ساتھ A/B ٹیسٹنگ - ایونٹ اور فنل پر مبنی نوٹیفیکیشنز - پرائیویسی پر مبنی ٹریکنگ: ڈیفالٹ طور پر کوکی لیس اور GDPR کے مطابق بیان کیا گیا ہے - ڈیٹا ویژولائزیشن کے لیے کسٹم ڈیش بورڈز اور چارٹ تخلیق - ملٹی پلیٹ فارم کلیکشن: ویب، موبائل (Swift/Kotlin/React Native) اور سرور سائیڈ SDKs، ساتھ ہی API رسائی - ایک MCP سرور جو 38 ٹولز فراہم کرتا ہے تاکہ Claude یا Cursor جیسے MCP کلائنٹس مقامی انسٹالیشن کے بغیر یوزر ڈیٹا کی انکوائری کر سکیں - پروڈکٹ ایونٹس کے ساتھ خریداریوں، سبسکرپشنز اور LTV کے لیے ریونیو ٹریکنگ - انٹیگریشنز، بشمول Google Search Console، تاکہ جمع شدہ ڈیٹا کو بہتر بنایا جا سکے README میں ایک موازنہ ٹیبل بھی شامل ہے جس میں OpenPanel کا مقابلہ Mixpanel، GA4 اور Plausible سے اوپن سورس لائسنسنگ، سیلف ہوسٹنگ، کوکی لیس ٹریکنگ، ریئل ٹائم ڈیش بورڈز، فنلز، یوزر پروفائلز، سیشن ری پلے، نوٹیفیکیشنز، SDK کوریج اور قیمتوں کی شفافیت جیسے معیار پر کیا گیا ہے۔ یہ بیانات پروجیکٹ کی اپنی پیشکش ہیں نہ کہ آزادانہ پیمائش۔ **ٹیکنالوجی اسٹیک** ڈیش بورڈ Next.js کے ساتھ بنایا گیا ہے، اور ایونٹ انجسٹن API Fastify کے ساتھ۔ Postgres بنیادی معلومات اسٹور کرتا ہے، جبکہ ClickHouse ایونٹس کو اسٹور کرتا ہے۔ Redis کیشنگ، pub/sub اور کیوز (queues) کو سنبھالتا ہے، جس میں کیو پروسیسنگ کے لیے BullMQ اور GroupMQ استعمال ہوتے ہیں۔ دیگر نامزد اجزاء میں Resend (ای میل)، Arctic (OAuth)، Oslo (auth)، tRPC (API لیئر)، Tailwind (اسٹائلنگ) اور shadcn (UI components) شامل ہیں۔ **سیلف ہوسٹنگ اور ڈویلپمنٹ** سیلف ہوسٹنگ کی حمایت کی گئی ہے اور README ڈاکومنٹیشن سائٹ میں ایک مخصوص سیلف ہوسٹنگ گائیڈ کی طرف اشارہ کرتا ہے۔ مقامی ڈویلپمنٹ کے لیے، Docker، Docker Compose، Node اور pnpm ضروری ہیں۔ دستاویزی اسٹارٹ سیکوئنس یہ ہے: `pnpm install` کے ساتھ ڈیپینڈنسز انسٹال کریں، `.env.example` کو `.env` میں کاپی کریں، `apps/start/.env` میں `API_URL=http://localhost:3333` سیٹ کریں، `pnpm dock:up` کے ساتھ کنٹینرز چلائیں، `pnpm codegen` چلائیں، ڈیٹا بیس سیٹ اپ کرنے کے لیے ایک بار `pnpm migrate:deploy` چلائیں، اور پھر `pnpm dev` کریں۔ شروع کرنے کے بعد، ڈیش بورڈ `https://localhost:3000` پر، API `https://api.localhost:3333` پر، اور Bullboard کیو انٹرفیس `http://localhost:9999` پر دستیاب ہوتا ہے۔ ہیلپر کمانڈز `pnpm dock:ch` اور `pnpm dock:redis` بالترتیب ClickHouse اور Redis ٹرمینلز کھولتے ہیں۔ پروجیکٹ ایک ویب سائٹ، ڈاکومنٹیشن، ہوسٹڈ ڈیش بورڈ سائن ان، ایک Discord کمیونٹی اور سوشل اکاؤنٹس کے لنکس فراہم کرتا ہے، اور صارفین کو ریپوزٹری کو اسٹار کرنے کی ترغیب دیتا ہے۔