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

## جائزہ ٹالیویا (Talivia) ایک اوپن سورس، سیلف ہوسٹڈ اینالیٹکس پلیٹ فارم ہے جو بانیوں (founders) کے لیے ریونیو ایٹریبیوشن پر مرکوز ہے۔ یہ ویب اینالیٹکس، سیشن ری پلے (Session Replay)، ٹیم کلاؤڈ انٹیگریشن فیچرز، شیئرڈ اینالیٹکس ڈیش بورڈز، اور امپورٹ/ایکسپورٹ صلاحیتوں کے ساتھ ساتھ پیمنٹ پروسیسرز سے کسٹمر ریونیو ڈیٹا کے براہ راست کنیکشنز فراہم کرتا ہے۔ یہ پروجیکٹ تجارتی طور پر ہوسٹ شدہ Talivia Cloud سروس کے سیلف ہوسٹڈ ذیلی سیٹ کی نمائندگی کرتا ہے۔ منیجڈ ہوسٹنگ میں Google Search Console، Bing Webmaster Tools، GitHub سرگرمی، اور X، Reddit، اور TikTok جیسے پلیٹ فارمز سے سوشل مینشنز کی انٹیگریشنز شامل ہیں۔ ## خصوصیات - **ویب اینالیٹکس**: ایمبیڈ کے قابل JavaScript اسنیپٹ کے ذریعے وزٹ ٹریکنگ۔ - **سیشن ری پلے (Session Replay)**: ویب سائٹس پر صارف کے سیشنز کا اختیاری ری پلے۔ - **ریونیو ایٹریبیوشن**: سبسکرپشن لائف سائیکل، ریفنڈز، تنازعات (disputes)، فرسٹ ٹچ اور لاسٹ ٹچ ایٹریبیوشن۔ - **پیمنٹ انٹیگریشنز**: Stripe، LemonSqueezy، Polar، Dodo، Yolfi، اور ایک Manual Payment API۔ - **تعاون (Collaboration)**: ویب سائٹ کے معاونین (collaborators) اور شیئرڈ اینالیٹکس ڈیش بورڈز۔ - **امپورٹ/ایکسپورٹ**: ڈیٹا مائیگریشن اور بیک اپ ورکس فلو۔ - **کرپٹو کنورژنز**: CoinGecko کے ذریعے اختیاری ایکسچینج ریٹ کنورژن۔ - **AI Agent Kit**: Codex، Claude Code، ChatGPT اور دیگر ایجنٹس کے لیے ٹریکنگ اسنیپٹس انسٹال کرنے، سیٹ اپ پلانز تیار کرنے، لائیو ایونٹس کی تصدیق کرنے، اور وزٹس کو پیمنٹ ایٹریبیوشن سے جوڑنے کے لیے ایک اوپن سورس MCP کے ساتھ ہم آہنگ ٹول کٹ۔ ## ٹیکنالوجی اسٹیک - رن ٹائم: Node.js 22 LTS یا 24 LTS - پیکیج مینیجر: pnpm 10+ - ڈیٹا بیس: PostgreSQL - ORM: Prisma - کنٹینرائزیشن: Docker Compose کے ساتھ Docker Engine ## سیٹ اپ ### لوکل ڈیولپمنٹ 1. یقینی بنائیں کہ Node.js 22/24 LTS، pnpm 10+، اور ایک نیا PostgreSQL انسٹنس دستیاب ہیں۔ 2. `.env.example` کو `.env` میں کاپی کریں اور `openssl rand -hex 32` کے ساتھ 32 بائٹ کا سیکرٹ جنریٹ کریں۔ 3. `.env` میں `DATABASE_URL` اور `APP_SECRET` سیٹ کریں۔ 4. ڈیپنڈینسیز انسٹال کریں اور مائیگریشنز چلائیں: ```bash pnpm install --frozen-lockfile pnpm exec prisma migrate deploy pnpm dev ``` 5. `http://localhost:3000` کھولیں اور `admin` / `admin` کے ساتھ سائن ان کریں۔ **Settings → Account** کے تحت بوٹ اسٹریپ پاس ورڈ فوری طور پر تبدیل کریں۔ ### ڈوکر (Docker) ```bash cp .env.example .env openssl rand -hex 32 docker compose up --build -d ``` کنٹینر ایپلیکیشن شروع کرنے سے پہلے OSS ڈیٹا بیس مائیگریشن کو خودکار طور پر لاگو کرتا ہے۔ لانچ کے بعد، ڈیفالٹ ایڈمن پاس ورڈ تبدیل کریں۔ ## کانفیگریشن | متغیر | ضروری | مقصد | |---|---|---| | `DATABASE_URL` | ہاں | PostgreSQL کنکشن اسٹرنگ | | `APP_SECRET` | ہاں | سیشن سائننگ اور کریڈینشل انکرپشن کے لیے 32-بائٹ رینڈم ویلیو | | `COINGECKO_API_KEY` | نہیں | کرپٹو ایکسچینج ریٹ کنورژن کو فعال کرتا ہے؛ ایپلیکیشن اس کے بغیر بھی فعال رہتی ہے | ## پہلا استعمال 1. Talivia میں ایک ویب سائٹ اینٹری بنائیں۔ 2. فراہم کردہ ٹریکنگ اسنیپٹ کو ٹارگٹ سائٹ میں داخل کریں۔ 3. تصدیق کریں کہ ڈیش بورڈ پر ایک وزٹ ظاہر ہو رہا ہے۔ 4. ویب سائٹ سیٹنگز میں اختیاری طور پر سیشن ری پلے (Session Replay) کو فعال کریں۔ 5. **Website settings → Payments** کے تحت کسٹمر ریونیو کو جوڑیں۔ جب ریورس پراکسی کے پیچھے چل رہے ہوں، تو اصل `Host` اور `X-Forwarded-Proto` ہیڈرز کو فارورڈ کریں تاکہ ویب ہک URLs صحیح طریقے سے جنریٹ ہوں۔ ## بیک اپ اور اپ گریڈز اپ گریڈ کرنے سے پہلے PostgreSQL ڈیٹا بیس کا بیک اپ لیں۔ Compose ڈپلائمنٹس کے لیے: ```bash docker compose exec -T postgres pg_dump -U talivia -d talivia_oss > talivia-backup.sql ``` مستقبل کی ریلیزز `prisma/migrations` کے تحت ترتیب وار مائیگریشنز کا اضافہ کرتی ہیں۔ انہیں `pnpm exec prisma migrate deploy` کے ساتھ لاگو کریں؛ آفیشل کنٹینر اسٹارٹ اپ پر اسے خودکار طور پر چلاتا ہے۔ موجودہ مائیگریشنز میں ترمیم نہیں کی جانی چاہیے۔ ## AI Agent Kit اور MCP ٹالیویا ایک اوپن سورس ایجنٹ کٹ ([github.com/talivia-group/agent](https://github.com/talivia-group/agent)) تقسیم کرتا ہے جو MCP سے فعال کلائنٹس کے ساتھ ہم آہنگ ہے۔ ایجنٹس ٹریکنگ انسٹال کر سکتے ہیں، فریم ورک کے لیے مخصوص سیٹ اپ پلانز جنریٹ کر سکتے ہیں، لائیو اینالیٹکس ایونٹس کی تصدیق کر سکتے ہیں، اور وزٹس کو پیمنٹ ایٹریبیوشن تک ٹریس کر سکتے ہیں۔ - ہوسٹ شدہ OAuth اینڈ پوائنٹ (Talivia Cloud): `https://talivia.com/mcp` - لوکل stdio موڈ: `npx -y @talivia/agent mcp` سیلف ہوسٹڈ ایڈیشن Talivia Cloud OAuth اینڈ پوائنٹ کو ظاہر (expose) نہیں کرتا ہے۔ ## سیکیورٹی اور لائسنسنگ سیکیورٹی کی کمزوریوں کی رپورٹنگ اور ڈپلائمنٹ گائیڈنس [SECURITY.md](SECURITY.md) میں ہیں۔ ڈیولپمنٹ ورک فلو کی تفصیلات [CONTRIBUTING.md](CONTRIBUTING.md) میں ہیں۔ Talivia کو MIT لائسنس کے تحت ریلیز کیا گیا ہے۔ ## موازنہ ٹالیویا خود کو Datafast کے متبادل کے طور پر پیش کرتا ہے، جو ایک واحد سیلف ہوسٹڈ ڈپلائمنٹ میں ان بلٹ ریونیو ایٹریبیوشن اور ملٹی پروسیسر پیمنٹ انٹیگریشنز پر زور دیتا ہے۔