প্রকল্প সম্পর্কে

## ওভারভিউ Talivia হলো ওপেন-সোর্স, সেলফ-হোস্টেড অ্যানালিটিক্স প্ল্যাটফর্ম যা ফাউন্ডারদের জন্য রিভিনিউ অ্যাট্রিবিউশনে ফোকাস করে। এটি ওয়েব অ্যানালিটিক্স, সেশন রিপ্লে, টিম সহযোগিতা বৈশিষ্ট্য, শেয়ার্ড অ্যানালিটিক্স ড্যাশবোর্ড, এবং ইম্পোর্ট/এক্সপোর্ট ক্ষমতা পাশাপাশি পেমেন্ট প্রসেসর থেকে সরাসরি গ্রাহকের রিভিনিউ ডেটার সাথে সংযোগ প্রদান করে। প্রকল্পটি বাণিজ্যিকভাবে হোস্ট করা Talivia Cloud সার্ভিসের সেলফ-হোস্টেড সাবসেটকে নির্দেশ করে। ম্যানেজড হোস্টিং Google Search Console, Bing Webmaster Tools, GitHub activity, এবং X, Reddit, TikTok-এর মতো প্ল্যাটফর্ম থেকে সামাজিক উল্লেখের সাথে ইন্টিগ্রেশন যোগ করে। ## বৈশিষ্ট্য - **ওয়েব অ্যানালিটিক্স**: এম্বিডিডেবল জাভাস্ক্রিপ্ট স্নিপেটের মাধ্যমে ভিজিট ট্র্যাকিং। - **সেশন রিপ্লে**: ওয়েবসাইটে ব্যবহারকারীর সেশনের ঐচ্ছিক রিপ্লে। - **রিভিনিউ অ্যাট্রিবিউশন**: সাবস্ক্রিপশন লাইফসাইকেল, রিফান্ড, বিরোধ, ফার্স্ট-টাচ এবং লাস্ট-টাচ অ্যাট্রিবিউশন। - **পেমেন্ট ইন্টিগ্রেশন**: Stripe, LemonSqueezy, Polar, Dodo, Yolfi, এবং একটি ম্যানুয়াল পেমেণ্ট API। - **সহযোগিতা**: ওয়েবসাইট কলাবরেটর এবং শেয়ার্ড অ্যানালিটিক্স ড্যাশবোর্ড। - **ইম্পোর্ট/এক্সপোর্ট**: ডেটা মাইগ্রেশন এবং ব্যাকআপ ওয়ার্কফ্লো। - **ক্রিপ্টো রূপান্তর**: CoinGecko-এর মাধ্যমে ঐচ্ছিক এক্সচেঞ্জ রেট কনভার্শন। - **AI Agent Kit**: Codex, Claude Code, ChatGPT এবং অন্যান্য এজেন্টদের জন্য ওপেন-সোর্স MCP-সামঞ্জস্যপূর্ণ টুলকিট যা ট্র্যাকিং স্নিপেট ইনস্টল, সেটআপ প্ল্যান তৈরি, লাইভ ইভেন্ট যাচাই, এবং ভিজিটকে পেমেন্ট অ্যাট্রিবিউশনের সাথে সংযুক্ত করতে পারে। ## প্রযুক্তিগত স্ট্যাক - রাইটআইম: 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` দিয়ে সাইন ইন করুন। **Settings → Account**-এ বুটস্ট্র্যাপ পাসওয়ার্ড তৎক্ষণাৎ পরিবর্তন করুন। ### Docker ```bash cp .env.example .env openssl rand -hex 32 docker compose up --build -d ``` কন্টেইনার অ্যাপ্লিকেশন শুরু করার আগে OSS ডেটাবেস মাইগ্রেশন স্বয়ংক্রিয়ভাবে প্রয়োগ করে। লঞ্চের পর ডিফল্ট অ্যাডমিন পাসওয়ার্ড পরিবর্তন করুন। ## কনফিগারেশন | ভেরিয়েবল | আবশ্যক | উদ্দেশ্য | |---|---|---| | `DATABASE_URL` | হ্যাঁ | PostgreSQL কানেকশন স্ট্রিং | | `APP_SECRET` | হ্যাঁ | সেশন সিgniং এবং ক্রেডেনশিয়াল এনক্রিপশনের জন্য 32-বাইট র‍্যান্ডম ভ্যালু | | `COINGECKO_API_KEY` | না | ক্রিপ্টো এক্সচেঞ্জ রেট কনভার্শন সক্রিয় করে; এটি ছাড়াও অ্যাপ্লিকেশন কাজ করে | ## প্রথম ব্যবহার 1. Talivia-তে একটি ওয়েবসাইট এন্ট্রি তৈরি করুন। 2. প্রদত্ত ট্র্যাকিং স্নিপেট লক্ষ্য সাইটে সন্নিবেশ করান। 3. ড্যাশবোর্ডে একটি ভিজিট দেখা যাচ্ছে কিনা নিশ্চিত করুন। 4. ওয়েবসাইট সেটিংস-এ ঐচ্ছিকভাবে Session Replay সক্রিয় করুন। 5. **Website settings → Payments** এর মাধ্যমে গ্রাহকের রিভিনিউ সংযুক্ত করুন। রিভার্স প্রক্সির পেছনে চলার সময় ওয়েবহুক 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 MCP-সক্ষম ক্লায়েন্টের সাথে সামঞ্জস্যপূর্ণ একটি ওপেন-সোর্স Agent Kit বিতরণ করে ([github.com/talivia-group/agent](https://github.com/talivia-group/agent))। এজেন্ট ট্র্যাকিং ইনস্টল, ফ্রেমওয়ার্ক-নির্দিষ্ট সেটআপ প্ল্যান তৈরি, লাইভ অ্যানালিটিক্স ইভেন্ট যাচাই, এবং ভিজিটকে পেমেন্ট অ্যাট্রিবিউশনের সাথে ট্রেস করতে পারে। - হোস্টেড 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 License-এ প্রকাশিত হয়। ## তুলনা Talivia নিজেদেরকে Datafast-এর একটি বিকল্প হিসেবে মার্কেটিং করে, যার মধ্যে বিল্ট-ইন রিভিনিউ অ্যাট্রিবিউশন এবং একক সেলফ-হোস্টেড ডিপ্লয়মেন্টের মধ্যে মাল্টি-প্রসেসর পেমেন্ট ইন্টিগ্রেশন রয়েছে।