Files
nabeh/README.md
T

7.6 KiB

تعريف نظام "نبيه" (Nabeh SaaS Platform) 🚀

نظرة عامة (Overview)

نبيه (Nabeh) هو منصة برمجيات كخدمة (SaaS - Software as a Service) متكاملة ومصممة للشركات والمتاجر الإلكترونية وشركات التوصيل الذكي (مثل تطبيق "سيرو" Siro). تهدف المنصة إلى أتمتة خدمة العملاء وإدارة التفاعلات عبر تطبيق WhatsApp باستخدام تقنيات الذكاء الاصطناعي المتقدمة (AI) والربط البرمجي السلس.

يعتمد المشروع على نموذج تجاري قائم على الاشتراكات (Subscription-based)، حيث يوفر للشركات باقات مختلفة بناءً على احتياجاتهم من الرسائل، روبوتات الدردشة، وتقنية التعرف البصري (OCR).


الميزات الأساسية والقدرات (Core Features)

1. نظام متعدد المستأجرين (Multi-Tenant Architecture)

  • إدارة الشركات (Companies): يمكن للمنصة استضافة عدد غير محدود من الشركات والمتاجر بشكل مستقل تماماً.
  • باقات الاشتراك (Subscription Plans): نظام فوترة وباقات (Starter, Growth, Professional) يحدّد لكل شركة:
    • عدد أرقام الواتساب المسموحة (Sessions).
    • الحد الأقصى للرسائل النصية والصوتية (Limits).
    • الحد الأقصى لعمليات الذكاء الاصطناعي وتحليل الصور (OCR Limits).

2. محرك واتساب المركزي (WhatsApp Gateway)

  • الربط المباشر (Baileys Node): ربط أرقام الواتساب عبر مسح رمز الاستجابة السريعة (QR Code) دون الحاجة للمرور بخوادم طرف ثالث، مما يضمن الخصوصية والسرعة.
  • إدارة الجلسات (Sessions Management): يمكن للشركة الواحدة تشغيل عدة أرقام واتساب في نفس الوقت (مثل: رقم للمبيعات، ورقم للدعم الفني).
  • الحملات الإعلانية (Broadcast Campaigns): إمكانية جدولة وإرسال رسائل جماعية للعملاء مع دعم القوالب الديناميكية (Templates).

3. وكيل الذكاء الاصطناعي المتقدم (AI Agent & Chatbot)

  • تكامل Google Gemini: الاعتماد على نماذج لغوية متطورة (LLM) للرد بذكاء على استفسارات العملاء بدلاً من الردود المبرمجة مسبقاً (Keywords).
  • تخصيص الهوية (Custom Prompting): كل شركة قادرة على تزويد الروبوت بتعليمات مخصصة (الاسم، اللهجة، ساعات العمل، سياسات الإرجاع)، ليعمل وكأنه موظف خدمة عملاء بشري حقيقي.
  • نموذج "الخدمة الجاهزة" (Plug & Play): بأسلوب SaaS التجاري، يتم إخفاء تعقيدات المفاتيح البرمجية (API Keys) عن العميل النهائي، حيث تتكفل المنصة باستهلاك الـ API وإدارة الحصة (Quota) بناءً على اشتراك التاجر.
  • دعم الرسائل الصوتية: قدرة الذكاء الاصطناعي على استلام الملاحظات الصوتية وتحليلها، وكذلك الرد برسائل صوتية بفضل تقنيات (Text-to-Speech).

4. تسجيل الكباتن والتعرف البصري (Driver Onboarding & OCR)

  • تم تخصيص جزء من النظام لخدمة تطبيقات التوصيل الذكي (مثل تطبيق "سيرو" في سوريا والأردن ومصر).
  • المعالجة الآلية للوثائق (Automated OCR): يستطيع النظام استلام صور وثائق السائقين (الهوية الوطنية، رخصة القيادة، رخصة المركبة، لا حكم عليه) عبر الواتساب.
  • استخراج البيانات وتدقيقها: يقوم الذكاء الاصطناعي بقراءة وتفريغ محتويات الصور إلى بيانات مهيكلة (JSON) مثل الرقم الوطني، نوع السيارة، ورقم اللوحة.
  • التكامل مع السيرفر الرئيسي (Siro API): بعد نجاح التدقيق، يرسل "نبيه" كافة البيانات والصور إلى السيرفر الرئيسي لتطبيق سيرو لتفعيل السائق تلقائياً.

5. التجارة الإلكترونية (E-Commerce Integrations)

  • ربط المتاجر (WooCommerce & Salla): إمكانية ربط متجر العميل بشكل مباشر مع المنصة عبر الـ Webhooks.
  • تتبع الطلبات الآلي: يستطيع العميل الاستعلام عن حالة طلبه عبر الواتساب، ليقوم الذكاء الاصطناعي بجلب حالة الشحنة من المتجر وإرسالها بطريقة سلسة.
  • إشعارات تلقائية: إرسال تحديثات أوتوماتيكية للعملاء على الواتساب عند تغيير حالة الطلب (تم التنفيذ، جاري التوصيل، الخ...).

6. لوحة تحكم الإدارة (Super Admin Dashboard)

  • واجهة خاصة بمالك المنصة للتحكم بكافة العملاء والمتاجر.
  • مراقبة الإحصائيات الحية (عدد الشركات، الرسائل المرسلة، استهلاك الـ API).
  • إدارة اشتراكات الشركات وتجديد باقاتهم.

البنية التقنية (Tech Stack)

  1. الواجهة الأمامية (Frontend):
    • تم بناء واجهة سهلة وخفيفة الاستخدام بالاعتماد على HTML5/CSS3 المخصصة بالكامل.
    • يعتمد على Alpine.js كإطار تفاعلي لتقليل الحمل وزيادة سرعة الأداء والاستجابة.
  2. الواجهة الخلفية (Backend):
    • تم تطويره باستخدام لغة PHP (هندسة MVC حديثة بدون إطار عمل ثقيل).
    • تصميم موجّه للخدمات الدقيقة (Micro-Services architecture).
  3. بوابة الواتساب (WhatsApp Gateway):
    • مبني بواسطة Node.js مع مكتبة Baileys للتعامل مع بروتوكولات الواتساب مباشرة.
  4. قاعدة البيانات (Database):
    • خادم MySQL بتصميم Multi-tenant يفصل بيانات كل شركة بدقة، مع الاعتماد على تشفير البيانات الحساسة (مثل أرقام الهواتف) باستخدام AES-256-GCM.
  5. الذكاء الاصطناعي (AI & OCR):
    • الاعتماد على Google Gemini API لفهم اللغات وتحليل الصور والملفات الصوتية.

نموذج العمل الموصى به (Business Model Proposal)

يمكن تسويق النظام كنظام SaaS باشتراكات شهرية، بحيث:

  • الباقة التأسيسية: تستهدف أصحاب الأعمال الصغيرة للردود الآلية النصية البسيطة.
  • باقة النمو: تستهدف المتاجر الإلكترونية للرد على استفسارات العملاء الصوتية وربط المتاجر وإدارة الحملات.
  • الباقة الاحترافية: للشركات الكبيرة (كشركات التوصيل) والتي تحتاج لعمليات OCR ضخمة وربط مخصص للموظفين والكباتن.