chatbot

وصف المشروع

نظام مساعد المشتريات الذكي — MasterCode ERP Chatbot

مساعد ذكي للمشتريات مبني بالعربية يعمل ضمن نظام ERP، يساعد المستخدمين في إدارة أوامر التوريد، الموردين، الفواتير، والاستعلام عن وثائق الشركة.

التقنيات المستخدمة

Backend: FastAPI + LangGraph ReAct Agent (Python)

LLM: Google Gemini 2.5 Flash

Vector DB: ChromaDB مع Hybrid Search (BM25 + Vector + Cross-Encoder Reranking)

Embeddings: HuggingFace multilingual model (محلي)

Frontend: HTML/CSS/JS — واجهة RTL عربية بتصميم حديث

المميزات

وضعان للمحادثة: المساعد الذكي (Agent) للعمليات + سؤال وجواب (Q&A) للبحث في الوثائق

أدوات الـ Agent: عرض الموردين، المنتجات، أوامر التوريد، الفواتير، إنشاء/إلغاء أوامر، تصدير PDF

واجهتان للمحادثة: شات كامل بالصفحة + ويدجت عائم مصغّر

لوحة تحليلات (Dashboard): إحصائيات الطلبات، استخدام الأدوات، الأسئلة الأكثر تكراراً، رسوم بيانية تفاعلية (Chart.js)

تتبع الأداء: قاعدة بيانات SQLite تسجل كل طلب مع وقت الاستجابة ونسبة النجاح

تصدير PDF: طباعة أوامر التوريد بتنسيق عربي

حفظ المحادثات: سجل المحادثات السابقة في localStorage

تصميم متجاوب: ألوان العلامة التجارية (#145055 + #DA5B30)، بدون تدرجات، خط Cairo

البنية التحتية

5 API endpoints أساسية + 5 endpoints للتحليلات

نظام استرجاع هجين (Hybrid Retrieval) مع Parent-Child Chunking

دعم 9 وحدات ERP كوثائق (الإعدادات، المالية، الصلاحيات، دورة المشتريات، الموردين، التسعير، الشحن، الفواتير، الجودة)