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

Smart-analytics ایک جدید، ذاتی حریم پر زور دینے والا، خود مہمان نوازی شدہ ویب سائٹ تجزیاتی سسٹم ہے جو tiny-analytics 0.1.3 سے مشتق ہے۔ اس کا مرکزی اپ گریڈ کثیر ویب سائٹ/کثیر صارفین کی support ہے: ایک اکاؤنٹ سے متعدد ویب سائٹس کی نگرانی کی جا سکتی ہے، ہر ویب سائٹ کے لیے الگ ٹریکنگ اسکرپٹ اور ڈیٹا انسولیشن موجود ہوتی ہے۔ ٹیکنالوجی اسٹیک: Python FastAPI + SQLite (single DB multi-tenant)، single process، کسی بیرونی سروس یا ڈیٹا بیس کی ضرورت نہیں۔ بنیادی کام کا طریقہ کار: جب ویب سائٹ لوڈ ہوتی ہے تو ٹریکنگ اسکرپٹ POST request بھیجتا ہے، سرور "siteID:IP:UA" کو hash کرکے anonymous visitor ID بنا تا ہے، اصل IP محفوظ نہیں ہوتی۔ صفحہ چھوڑنے پر beacon کے ذریعے رہائشی وقت بھیج دیا جاتا ہے۔ ڈیش بورڈ sites کی بنیاد پر aggregate اور visualize کرتا ہے۔ خصوصیات: - ذاتی حریم پر زور: کوئی Cookie نہیں، کوئی localStorage نہیں، کوئی fingerprinting نہیں، cross-site tracking نہیں - کثیر ویب سائٹ/کثیر صارفین: ہر site کے لیے独立 token، مکمل ڈیٹا انسولیشن؛ متعدد users اور site members کی حمایت - اکاؤنٹ سسٹم: email+password رجسٹریشن، ویب interface سے sites اور members کا انتظام - آف لائن GeoIP: DB-IP لائبریری پر مبنی، ملک/صوبہ/شہر سطح کی جغرافیائی معلومات، کوئی تھرڈ پارٹی API نہیں - روبوٹ فلٹرنگ: خودکار طور پر robot traffic کو پہچانتا اور isolate کرتا ہے - high-frequency IP module: بار بار آنے والے IPs کو identify کرتا ہے اور geography دکھاتا ہے - page dwell time: واقعی interaction time record کرتا ہے - geography اور device distribution: visitors کی آمد کے مقامات اور استعمال کردہ devices کے اعداد و شمار - top pages اور traffic sources: مقبول صفحات، referer domains اور search keywords - visit time distribution: 24 hours / weekly bases پر traffic patterns - period comparison: independent visitors، page views، dwell time کا موازنہ - ریئل ٹائم آن لائن: آخری 5 منٹ کے آن لائن users، dashboard auto polling - نئے/پرانی visitors: anonymous ID کی بنیاد پر فرق - UTM channel tracking: source/media/campaign dimensions کے مطابق - session analysis: bounce rate، average session duration، entry/exit pages (estimate) - browser/OS distribution: pure User-Agent coarse-grained stats - flexible time range: 1h/2h/24h/7d/30d، granularity 1/5/15 min یا 1 hour - dark mode UI environment variables: SMART_ANALYTICS_PASSWORD (admin password)، SMART_ANALYTICS_SECRET_KEY (session signing key)، SMART_ANALYTICS_ALLOWED_ORIGINS (CORS domain limits)، SMART_ANALYTICS_DB_PATH (database path) وغیرہ۔ deploy: deploy/linux/setup.sh一键 script supports systemd service، nginx reverse proxy، Cloudflare origin (reads cf-connecting-ip headers automatically)۔ uvx سے بھی چلا سکتے ہیں یا source سے build کر سکتے ہیں۔ license: MIT۔