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

## अवलोकन Talivia एक ओपन-सोर्स, स्व-होस्टेड एनालिटिक्स प्लेटफ़ॉर्म है जो संस्थापकों के लिए रिवेन्यू अट्रिब्यूशन पर केंद्रित है। यह वेब एनालिटिक्स, सेशन रीप्ले, टीम सहयोग, साझा डैशबोर्ड, इम्पोर्ट/एक्सपोर्ट क्षमताएं और पेमेंट प्रोसेसर से सीधे ग्राहक रिवेन्यू डेटा से जुड़ाव प्रदान करता है। यह परियोजना वाणिज्यिक होस्टेड Talivia Cloud सेवा के स्व-होस्टेड उपसमुच्चय का प्रतिनिधित्व करती है। मैनेज्ड होस्टिंग में Google Search Console, Bing Webmaster Tools, GitHub गतिविधि और X, Reddit, TikTok जैसे प्लेटफ़ॉर्म से सोशल मेंशन के साथ इंटीग्रेशन शामिल हैं। ## फ़ीचर्स - **वेब एनालिटिक्स**: एम्बेडेबल JavaScript स्निपेट के माध्यम से विज़िट ट्रैकिंग। - **सेशन रीप्ले**: वेबसाइट पर उपयोगकर्ता सत्र का वैकल्पिक रीप्ले। - **रिवेन्यू अट्रिब्यूशन**: सब्सक्रिप्शन लाइफ़साइकिल, रिफंड, डिस्प्यूट, फर्स्ट-टाच और लैस्ट-टाच अट्रिब्यूशन। - **भुगतान इंटीग्रेशन**: Stripe, LemonSqueezy, Polar, Dodo, Yolfi और मैन्युअल पेमेंट API। - **सहयोग**: वेबसाइट सहयोगी और साझा एनालिटिक्स डैशबोर्ड। - **इम्पोर्ट/एक्सपोर्ट**: डेटा माइग्रेशन और बैकअप वर्कफ़्लो। - **क्रिप्टो कन्वर्ज़न**: CoinGecko के माध्यम से वैकल्पिक एक्सचेंज़-रेट कन्वर्ज़न। - **AI Agent Kit**: MCP-कम्पैटिबल ओपन-सोर्स टूलकिट जिसका उपयोग Codex, Claude Code, ChatGPT और अन्य एजेंट्स ट्रैकिंग स्निपेट इंस्टॉल करने, सेटअप प्लान जनरेट करने, लाइव इवेंट्स की पुष्टि करने और विज़िट को पेमेंट अट्रिब्यूशन से कनेक्ट करने के लिए कर सकते हैं। ## तकनीकी स्टैक - रनटाइम: Node.js 22 LTS या 24 LTS - पैकेज प्रबंधक: pnpm 10+ - डेटाबेस: PostgreSQL - ORM: Prisma - कंटेनराइज़ेशन: Docker Engine with Docker Compose ## सेटअप ### स्थानीय विकास 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` से साइन इन करें। **सेटिंग्स → खाता** के तहत तुरंत बूटस्ट्रैप पासवर्ड बदल दें। ### 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. वेबसाइट सेटिंग्स में वैकल्पिक रूप से सेशन रीप्ले सक्षम करें। 5. **वेबसाइट सेटिंग्स → भुगतान** के तहत ग्राहक रिवेन्यू जोड़ें। जब किसी रिवर्स प्रॉक्सी के पीछे चलाया जाए, तो वेबहुक URL सही ढंग से जनरेट होने दें, मूल `Host` और `X-Forwarded-Proto` हेडर आगे बढ़ाएँ। ## बैकअप और अपग्रेड अपग्रेड करने से पहले 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 Talivia एक ओपन-सोर्स एजेंट किट ([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 एंडपॉइंट प्रकट नहीं करता है। ## सुरक्षा और लाइसेंसिंग वल्नरेबिलिटी रिपोर्टर और डिप्लॉयमेंट मार्गदर्शन [SECURITY.md](SECURITY.md) में हैं। विकास कार्यप्रवाह विवरण [CONTRIBUTING.md](CONTRIBUTING.md) में हैं। Talivia MIT लाइसेंस के तहत जारी किया गया है। ## तुलना Talivia खुद को Datafast का विकल्प के रूप में बाज़ार में लाता है, जिसमें सिंगल स्व-होस्टेड डिप्लॉयमेंट के भीतर बिल्ट-इन रिवेन्यू अट्रिब्यूशन और मल्टी-प्रोसेसर भुगतान इंटीग्रेशन पर जोर दिया गया है।