ٍSaas Sales CRM

المشروع عبارة عن نظام CRM متطور يعمل بنموذج البرمجيات كخدمة (SaaS)، ومصمم لدعم المنصات المتعددة، مثل منصات التجارة الإلكترونية متعددة البائعين أو الشركات التي تحتاج إلى بيئات عمل معزولة. يعتمد النظام على معمارية Monorepo لتنظيم الكود وإدارته بكفاءة عالية. البنية التقنية (Tech Stack) واجهة المستخدم (Frontend): مبنية باستخدام React 19، مع الاعتماد على TanStack Router للتوجيه وإدارة المسارات، و TanStack Query لإدارة جلب البيانات وحالتها، بالإضافة إلى Tailwind CSS v4 لتنسيق الواجهات بشكل عصري. الخادم وقواعد البيانات (Backend & DB): الخادم مبني باستخدام Express 5، ويعتمد على Prisma (ORM) للتعامل مع قاعدة بيانات PostgreSQL (مستضافة عبر منصة Neon). تكامل خدمات الاتصالات (Vonage Integration) تم تعزيز النظام بقدرات تواصل شاملة (Omnichannel) لربط الموظفين بالعملاء وتوثيق كافة التفاعلات: المكالمات الصوتية (Voice Calls): إمكانية بدء مكالمات صادرة (Outbound Calls) مباشرة من لوحة التحكم لربط موظف المبيعات بالعميل عبر أرقام Vonage. استقبال وتوجيه تحديثات حالة المكالمة (مدة المكالمة، انتهائها، الخ) عبر نظام Webhooks وتحديثها تلقائياً في قاعدة البيانات (CallLog). استخدام Socket.IO لإرسال تحديثات لحظية (Real-time Updates) إلى واجهة React لعرض حالة المكالمة للموظف أثناء حدوثها. دعم توليد أوامر الاتصال (NCCO) لإدارة تحويل المكالمات والردود الآلية. الرسائل النصية (SMS): إرسال رسائل نصية قصيرة للعملاء مباشرة من النظام عبر واجهة برمجة تطبيقات Vonage، مع حفظ وتوثيق كل رسالة في السجل الخاص بالعميل (MessageLog). البريد الإلكتروني (Email): نظراً لعدم توفير Vonage لخدمة بريد إلكتروني مباشرة، تم دمج خدمة Resend لإرسال رسائل بريد إلكتروني منسقة (HTML) للعملاء، ويتم تسجيل محتوى الرسالة كجزء من سجل تواصل العميل. إشعارات الدفع (Push Notifications): مسار مخصص لإرسال الإشعارات للأجهزة، مع استخدام آلية ذكية تقوم بتحويل الإشعار إلى رسالة نصية (SMS Fallback) عبر Vonage كبديل لضمان وصول التنبيه للعميل في جميع الحالات. إدارة الحزم والمشروع: يتم استخدام pnpm كمدير للحزم، مع إطار Turborepo لإدارة بيئة العمل متعددة الحزم (Monorepo).