عن المشروع

Retentioneering هي أداة مفتوحة المصدر تعتمد على Python مصممة لتحليلات قابلة للتكرار والتدقيق على بيانات تدفق النقرات وسجلات الأحداث. تستبدل البرامج النصية المؤقتة بعناصر تحليلية مختبرة وسير عمل قابلة لإعادة الاستخدام، مما يساعد المحللين وعلماء البيانات ووكلاء الذكاء الاصطناعي على استكشاف رحلات المستخدمين، واكتشاف الشرائح السلوكية، وتقييم التجارب، والتحقق المتبادل من النتائج. المكونات الرئيسية: - **Eventstream**: كائن مدعوم بـ DuckDB يستوعب بيانات الأحداث الخام من إطارات بيانات pandas، أو ملفات CSV/TSV/Parquet، أو صادرات قواعد البيانات. يدعم التصفية، وتجزئة الجلسات، ودمج الأحداث، وإنشاء أحداث اصطناعية، ومعالجات متسلسلة أخرى، مع إرجاع تدفق جديد غير قابل للتغيير دائماً. - **الأدوات التفاعلية**: مبنية باستخدام anywidget، يتم عرضها مباشرة في Jupyter، وColab، وVS Code، إلخ. تتضمن الأدوات: رسم بياني للانتقالات، مصفوفة الخطوات، سانكي الخطوات، القمع، نظرة عامة على الشرائح، وتحليل التجميع، جميعها مع وضع المقارنة لمقارنة المجموعات. - **معالجات البيانات**: طرق لتصفية الأحداث، وتقسيم الجلسات، وإضافة علامات 이탈، وتحليل عناوين URL، واستخراج حالات دورة الحياة، وأخذ العينات، والمزيد، مما يتيح تحليلاً متعدد الدقة من تفاعلات تستغرق ثوانٍ إلى رحلات تستغرق أشهر. - **خادم MCP**: يعرض Eventstream لـ Claude أو أي عميل LLM متوافق مع MCP. يمكن للوكلاء تشغيل التحليلات، وإنشاء علامات تبويب للتقارير، وتصدير تقارير HTML تفاعلية تم التحقق منها حيث يرتبط كل مقياس ببياناته المصدرية. - **واجهات برمجة التطبيقات بدون واجهة**: لكل أداة نظير يحتوي على البيانات فقط (مثل `transition_graph_data`، `funnel_data`) للاستهلاك البرمجي. التثبيت بسيط مع Python 3.10+: pip install retentioneering يبدأ التشغيل السريع بتحميل ملف CSV بثلاثة أعمدة (user_id، event، timestamp)، وإنشاء `Eventstream`، واستدعاء `stream.transition_graph()` لعرض رسم بياني تفاعلي. تتضمن الأداة مجموعة بيانات تجارة إلكترونية اصطناعية للتجربة، ويمكن تصدير جميع التصورات كتقارير HTML قابلة للمشاركة. لا تغادر البيانات الخام البيئة المحلية أبداً؛ يمكن تعطيل القياس عن بعد الاختياري. Retentioneering 5.0 هي إعادة كتابة من الصفر تستبدل محرك pandas السابق بخلفية DuckDB أسرع وأدوات anywidget حديثة. تتوفر الوثائق والأمثلة ومجتمع Discord/Telegram على https://retentioneering.com/docs. المشروع مرخص تحت رخصة Apache-2.0، مما يشجع الاستخدام المجاني والتعديل والتوزيع التجاري للمكتبة الأساسية. المساهمات مرحب بها عبر قضايا GitHub وطلبات السحب.