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

یہ ایک CDK serverless website analytics construct ہے جو AWS پر full-stack solution ڈپلائے کرتا ہے۔ یہ frontend dashboard، backend APIs، اور ingestion pipelines بناتا ہے تاکہ website traffic اور user interactions کو ٹریک کیا جا سکے۔ کم سے درمیانہ traffic والے sites (10M page views تک) کے لیے ڈیزائن کیا گیا ہے، جس میں کم سے کم لاگت، privacy (بغیر PII ذخیرہ کیے)، اور آسان ڈپلائےمنٹ پر زور دیا گیا ہے۔ Features میں time on page کے ساتھ page view tracking، event tracking، alerts کے ساتھ anomaly detection، custom domain support، اور تین authentication options (کوئی نہیں، basic auth، AWS Cognito) شامل ہیں۔ ریفررز، geolocation (country/city)، device type، UTM parameters، اور query parameters کا ٹریکنگ کرتا ہے۔ Bot detection Built-in موجود ہے۔ Integration ایک standalone JavaScript snippet یا کسی بھی frontend framework میں استعمال کرنے کے لیے SDK کے ذریعے دستیاب ہے۔ Architecture میں S3/CloudFront پر host کردہ Vue 3 frontend، Lambda Function URLs اور tRPC استعمال کرنے والا TypeScript backend، اور Kinesis Firehose کے ذریعے events کو buffer کر کے partitioned Parquet files کو S3 میں store کرنے والا ingestion API شامل ہے۔ Data کو Athena کے ذریعے query کیا جاتا ہے۔ Location data MaxMind GeoLite2 سے حاصل کی جاتی ہے بغیر IPs ذخیرہ کیے۔ Deployment کے لیے `aws-cdk` اور `aws-cdk-lib` > 2.79.1 کی ضرورت ہے۔ npm package انسٹال کرنے کے بعد، users اپنی CDK stack میں construct کو configuration کے ساتھ تعریف کرتے ہیں، جس میں sites, origins, authentication, domain, observability, اور anomaly detection شامل ہیں۔ Client-side setup کے لیے script tag شامل کرنا یا application میں SDK initialize کرنا شامل ہے۔ مختلف traffic levels کے لیے cost estimates فراہم کیے گئے ہیں، جن میں worst-case projections daily data vacuum processes کی وجہ سے actual costs سے نمایاں طور پر زیادہ ہوتی ہیں۔ v0 سے v1 کی اپگریڈز میں partitioning اور DNS record IDs کے حوالے سے breaking changes شامل ہیں۔ Documentation میں design decisions، contributing guidelines، اور تفصیلی cost breakdowns شامل ہیں۔ ایک live demo بھی دستیاب ہے۔