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

Azoth ایک اوپن سورس، سیلف ہوسٹڈ ویب اینالیٹکس سلوشن ہے جو پرائیویسی کا خیال رکھنے والی سائٹس کے لیے ڈیزائن کیا گیا ہے۔ یہ مکمل طور پر Cloudflare Workers اور Cloudflare Analytics Engine پر چلتا ہے، جس سے کسی بھی بیرونی سروسز یا تھرڈ پارٹی اسکرپٹس کی ضرورت ختم ہو جاتی ہے۔ ### اہم خصوصیات - **کوکی لیس ٹریکنگ (Cookieless tracking)** – کلائنٹ سائیڈ ٹریکر صرف ~1.4 KB (≈0.6 KB gzipped) کا ہے اور `sendBeacon` API کے ذریعے پیج ویوز رپورٹ کرتا ہے، جس سے یہ یقینی بنتا ہے کہ کوئی کوکیز یا ذاتی ڈیٹا ذخیرہ نہیں ہوتا ہے۔ - **پرائیویسی فرسٹ** – کوئی PII جمع نہیں کی جاتی، اور یہ سسٹم کسی بھی تھرڈ پارٹی انفراسٹرکچر پر انحصار نہیں کرتا، جو اسے GDPR کے مطابق تعیناتیوں (deployments) کے لیے Google Analytics کا ایک بہترین متبادل بناتا ہے۔ - **Cloudflare پر سیلف ہوسٹڈ** – یہ دو Workers کے طور پر ڈیپلائے ہوتا ہے: ایک ٹریکر اینڈ پوائنٹ کے لیے اور ایک React ڈیش بورڈ کے لیے، اور دونوں ہی تیز رفتار اور اسکیلیبل اسٹوریج کے لیے Cloudflare Analytics Engine سے لیس ہیں۔ - **React ڈیش بورڈ** – ایک جدید UI جو پیج ویو کے اعداد و شمار، ریفررز، ڈیوائس بریک ڈاؤن اور مزید بہت کچھ دکھانے کے لیے Analytics Engine سے سوالات (queries) کرتا ہے۔ - **CLI سے چلنے والی ڈیپلائمنٹ** – `azoth` CLI (جو Bun سے بنایا گیا ہے) آپ کو Cloudflare کی توثیق (authentication)، کنفیگ پیچنگ، سیکرٹ مینجمنٹ (`AUTH_SECRET`, `CF_API_TOKEN`)، اور صرف ایک کمانڈ (`bunx azoth install`) کے ذریعے ڈیپلائمنٹ میں رہنمائی کرتا ہے۔ - **تشخیصی ٹولز (Diagnostic tools)** – `azoth doctor` صرف پڑھنے کی حد تک (read-only) چیکنگ کرتا ہے، `azoth status` موجودہ ڈیپلائمنٹ کی حالت دکھاتا ہے، اور `--dry-run` موڈ تبدیلیوں کو لاگو کیے بغیر ان کا پیش نظارہ دکھاتا ہے۔ - **ڈیولپر ٹولنگ** – اس میں لنٹنگ (Biome)، ٹائپ چیکنگ (TypeScript)، اور ورکسپیسز میں ٹیسٹ اسکرپٹس شامل ہیں، جو تمام Bun کے ذریعے چلائے جا سکتے ہیں۔ ### کوئیک اسٹارٹ ```bash bun install bunx azoth install ``` انسٹالر مندرجہ ذیل کام کرے گا: 1. آپ کے Cloudflare لاگ ان کی تصدیق کرے گا۔ 2. آپ کی اکاؤنٹ آئی ڈی کے ساتھ `wrangler.toml` کو پیچ (patch) کرے گا۔ 3. ضروری سیکرٹس سیٹ کرے گا۔ 4. دونوں Workers کو ڈیپلائے کرے گا۔ 5. ہیلتھ چیک کرے گا اور آپ کی سائٹ کے لیے ایمبیڈ اسنیپٹ (embed snippet) آؤٹ پٹ کرے گا۔ اضافی کمانڈز: - `bunx azoth doctor` – ڈیپلائمنٹ سے پہلے کی تشخیص (`--json` کو سپورٹ کرتا ہے)۔ - `bunx azoth status` – اکاؤنٹ، workers، سیکرٹس اور آخری ڈیپلائمنٹ کی معلومات دیکھیں۔ - `bunx azoth install --yes` – نان انٹرایکٹو موڈ۔ - `bunx azoth install --dry-run` – تبدیلیوں کا پیش نظارہ دیکھیں۔ ### ٹیکنیکل اسٹیک - **رن ٹائم**: Bun (v1.3.14) – تیز رفتار آل ان ون JavaScript رن ٹائم۔ - **پلیٹ فارم**: Cloudflare Workers + Analytics Engine۔ - **فرنٹ اینڈ**: ڈیش بورڈ کے لیے React۔ - **CLI**: خودکاریت (automation) کے لیے Cloudflare API کا استعمال کرتے ہوئے Bun سے بنایا گیا۔ ### لائسنس Azoth کو MIT لائسنس (© 2026 Ediz Yurdakul) کے تحت جاری کیا گیا ہے۔ یہ پروجیکٹ ان ڈیولپرز اور سائٹ مالکان کے لیے موزوں ہے جنہیں ایک ہلکے پھلکے، پرائیویسی کا احترام کرنے والے اینالیٹکس سلوشن کی ضرورت ہے جسے وہ Cloudflare کے ایج نیٹ ورک پر مکمل طور پر ہوسٹ اور کنٹرول کر سکتے ہیں۔