इस प्रोजेक्ट के बारे में

Azoth एक ओपन-सोर्स, स्व-होस्टेड वेब एनालिटिक्स समाधान है जो प्रायवेसी-चेतन साइटों के लिए डिज़ाइन किया गया है। यह पूरी तरह से Cloudflare Workers के साथ Cloudflare Analytics Engine पर चलता है, जिससे किसी भी बाहरी सेवा या थर्ड-पार्टी स्क्रिप्ट की आवश्यकता समाप्त हो जाती है。 ### प्रमुख विशेषताएँ - **कुकीलेस ट्रैकिंग** – क्लाइंट-साइड ट्रैकर केवल ~1.4 KB (~0.6 KB gzipped) है और `sendBeacon` API के माध्यम से पेजव्यू रिपोर्ट करता है, जिससे कोई कुकी या व्यक्तिगत डेटा संग्रहीत नहीं होता है。 - **प्रायवेसी-फर्स्ट** – कोई PII एकत्र नहीं किया जाता है, और सिस्टम किसी थर्ड-पार्टी इंफ़्रास्ट्रक्चर पर निर्भर नहीं करता है, जो GDPR-अनुपालन डिप्लॉयमेंट के लिए Google Analytics का एक मजबूत विकल्प बनाता है。 - **Cloudflare पर स्व-होस्टेड** – दो Workers के रूप में तैनात: एक ट्रैकर एंडपॉइंट के लिए और एक React डैशबोर्ड के लिए, दोनों Cloudflare Analytics Engine द्वारा तेज़ और स्केलेबल स्टोरेज से संचालित。 - **React डैशबोर्ड** – पेजव्यू आँकड़े, रिफ़ेरर्स, डिवाइस ब्रेकडाउन और अन्य प्रदर्शित करने के लिए एक आधुनिक UI जो Analytics Engine को क्वेरी करता है。 - **CLI ड्रिवन डिप्लॉयमेंट** – `azoth` CLI (Bun के साथ बनाया गया) आपको Cloudflare प्रमाणीकरण, कॉन्फ़िगरेशन पैचिंग, सीक्रेट मैनेजमेंट (`AUTH_SECRET`, `CF_API_TOKEN`), और एक ही कमांड (`bunx azoth install`) में डिप्लॉयमेंट में गाइड करता है。 - **डायग्नोस्टिक टूल्स** – `azoth doctor` रीड-ओनली जाँच चलाता है, `azoth status` वर्तमान डिप्लॉयमेंट स्थिति दिखाता है, और एक `--dry-run` मोड परिवर्तनों को लागू किए बिना पूर्वावलोकन करता है。 - **डेवलपर टूलिंग** – कामस्पेस में लinting (Biome), टाइप-चेकिंग (TypeScript), और टेस्ट स्क्रिप्ट शामिल हैं, जिन्हें Bun के माध्यम से चलाया जा सकता है。 ### क्विक स्टार्ट ```bash bun install bunx azoth install ``` इंस्तरलर निम्नलिखित करेगा: 1. आपकी Cloudflare लॉगिन की पुष्टि करेंगे। 2. आपके अकाउंट आईडी के साथ `wrangler.toml` पैच करेंगे। 3. आवश्यक सीक्रेट सेट करेंगे। 4. दोनों Workers डिप्लॉय करेंगे। 5. हेल्थ-चेक करेंगे और आपके साइट के लिए एंबेड स्निपेट आउटपुट करेंगे。 अतिरिक्त कमांड्स: - `bunx azoth doctor` – डिप्लॉयमेंट से पहले डिग्नोस्टिक्स (`--json` समर्थित)。 - `bunx azoth status` – अकाउंट, वर्कर्स, सीक्रेट, और अंतिम डिप्लॉयमेंट जानकारी देखें。 - `bunx azoth install --yes` – नॉन-इंटरैक्टिव मोड。 - `bunx azoth install --dry-run` – परिवर्तनों का पूर्वावलोकन करें。 ### तकनीकी स्टैक - **रनटाइम**: Bun (v1.3.14) – तेज़ ऑल-इन-वन जावास्क्रिप्ट रनटाइम。 - **प्लेटफ़ॉर्म**: Cloudflare Workers + Analytics Engine。 - **फ्रंटएंड**: डैशबोर्ड के लिए React。 - **CLI**: क्लाउडफ़्लेयर API का उपयोग करके बुना हुआ。 ### लाइसेंस Azoth MIT लाइसेंस के तहत जारी किया गया है (© 2026 Ediz Yurdakul)。 यह प्रोजेक्ट उन डेवलपर्स और साइट मालिकों के लिए उपयुक्त है जिनको एक हल्का, प्रायवेसी-आदर करने वाला एनालिटिक्स समाधान चाहिए जिसे वे पूरी तरह से Cloudflare के एज नेटवर्क पर होस्ट और नियंत्रित कर सकें。