عن المشروع

## نظرة عامة تاليVia هي منصة تحليلية مفتوحة المصدر وذاتية الاستضافة تركز على تحديد الإيرادات للمؤسسين. توفر تحليلات الويب وإعادة تشغيل الجلسات وميزات التعاون بين الفرق واللوحات المشتركة للتحليلات، بالإضافة إلى قدرات الاستيراد والتصدير، وربط مباشر ببيانات إيرادات العملاء من معالجات الدفع. يمثل المشروع الجزء الذاتي من خدمة Talivia Cloud المُستضافة بشكل تجاري. وتضيف الاستضافة المُدارة تكاملات مع Google Search Console وBing Webmaster Tools ونشاط GitHub، والإشارات الاجتماعية من منصات مثل X وReddit وTikTok. ## الميزات - **تحليلات الويب**: تتبع الزيارات عبر مقتطف جافا سكريبت قابل للتضمين. - **إعادة تشغيل الجلسات**: إعادة تشغيل اختيارية لجلسات المستخدمين على المواقع. - **تحديد الإيرادات**: دورة حياة الاشتراك، والمرتجعات، والنزاعات، وتحديد الاتصال الأول والأخير. - **تكاملات الدفع**: Stripe وLemonSqueezy وPolar وDodo وYolfi وواجهة برمجة تطبيقات الدفع اليدوي. - **التعاون**: متعاونون في الموقع واللوحات المشتركة للتحليلات. - **الاستيراد/التصدير**: عمليات نقل البيانات ونسخ الاحتياطي. - **تحويل العملات الرقمية**: تحويل معدلات الصرف اختياريًا من خلال CoinGecko. - **مجموعة أدوات وكيل الذكاء الاصطناعي**: مجموعة أدوات مفتوحة المصدر متوافقة مع MCP لـ Codex وClaude Code وChatGPT وغيرها من الوكلاء لتثبيت مقتطفات التتبع وإنشاء خطط الإعداد، والتحقق من الأحداث المباشرة، وربط الزيارات بتحديد الإيرادات. ## مجموعة التقنيات - البيئة التنفيذية: Node.js 22 LTS أو 24 LTS - مدير الحزم: pnpm 10+ - قاعدة البيانات: PostgreSQL - ORM: Prisma - التحويل إلى حاويات: محرك Docker مع Docker Compose ## الإعداد ### التطوير المحلي 1. تأكد من توفر Node.js 22/24 LTS وpnpm 10+ ونسخة جديدة من PostgreSQL. 2. انسخ `.env.example` إلى `.env` وأنشئ قيمة عشوائية بطول 32 بايت باستخدام `openssl rand -hex 32`. 3. ضع `DATABASE_URL` و`APP_SECRET` في `.env`. 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 ``` يقوم الحاوية بتطبيق ترحيل قاعدة البيانات مفتوحة المصدر تلقائيًا قبل بدء تشغيل التطبيق. وبعد الإطلاق، غيّر كلمة مرور المسؤول الافتراضية. ## التكوين | المتغير | مطلوب | الغرض | |---|---|---| | `DATABASE_URL` | نعم | سلسلة اتصال PostgreSQL | | `APP_SECRET` | نعم | قيمة عشوائية بطول 32 بايت لتوقيع الجلسات و暗호ة بيانات الاعتماد | | `COINGECKO_API_KEY` | لا | تمكين تحويل معدلات صرف العملات الرقمية؛ تبقى التطبيق قابلة للتشغيل بدونها | ## الاستخدام الأول 1. أنشئ إدخال موقع في Talivia. 2. أدخل المقتطف المقدم في الموقع المستهدف. 3. تأكد من ظهور زيارة على اللوحة. 4. فعّل إعادة تشغيل الجلسات اختياريًا في إعدادات الموقع. 5. ربط إيرادات العملاء تحت **إعدادات الموقع → الدفع**. عند التشغيل خلف وكيل عكسي، قم بتمرير رؤوس `Host` الأصلية و`X-Forwarded-Proto` حتى يتم إنشاء عناوين URL للـ webhook بشكل صحيح. ## النسخ الاحتياطية والتحديثات قم بنسخ قاعدة بيانات 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`؛ ينفذ الحاوية الرسمية هذا تلقائيًا عند التشغيل. يجب عدم تعديل الترحيلات الموجودة. ## مجموعة أدوات وكيل الذكاء الاصطناعي وMCP تُصدر تاليVia مجموعة أدوات وكيل مفتوحة المصدر ([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` لا تعرض النسخة ذاتية الاستضافة نقطة نهاية OAuth الخاصة بـ Talivia Cloud. ## الأمان والتراخيص توجد تقارير الثغرات والإرشادات حول النشر في [SECURITY.md](SECURITY.md). تفاصيل سير العمل في التطوير موجودة في [CONTRIBUTING.md](CONTRIBUTING.md). يتم إصدار Talivia بموجب ترخيص MIT. ## المقارنة تُروج تاليVia نفسها كخيار بديل لـ Datafast، مع التركيز على تحديد الإيرادات المدمج وتكاملات الدفع متعددة المعالجات ضمن نشرة واحدة ذاتية الاستضافة.