عن المشروع

مشروع ERP-CRM هو نظام يجمع بين الإدارة المؤسسية الكلاسيكية ومكون ذكاء اصطناعي للرندر ثلاثي الأبعاد للمنتجات. وفقاً لوثائقه، تنقسم المنصة إلى وحدات: CRM (العملاء، جهات الاتصال، وفرص البيع)، المخزون (المخزون، المنتجات، والمستودعات)، الفواتير (الفواتير، الفواتير الأولية، وإدارة الضرائب)، المشاريع مع المهام المرتبطة بها، الرندر ثلاثي الأبعاد، ووحدة "الرقمنة" الموجهة للكتالوج. البنية التحتية: يتبع مخطط خادم-عميل مع فصل المسؤوليات. الواجهة الأمامية هي تطبيق JavaScript (HTML و CSS) يتيح الوصول إلى الوحدات المختلفة؛ أما الواجهة الخلفية فهي API بلغة Python، مع ملفات مخصصة لمحرك الذكاء الاصطناعي (ai_engine.py) ومنطق الرندر ثلاثي الأبعاد (render_3d.py). يعتمد النشر على Docker و Docker Compose، ويتضمن المستودع تدفقات عمل GitHub Actions مع إعدادات Dependabot. التثبيت: يطرح ملف README مسارين. يتطلب التثبيت المحلي Node.js 18+ مع npm، و Python 3.10+ مع pip؛ حيث يتم تثبيت تبعيات الواجهة الأمامية والخلفية، ونسخ .env.example إلى .env، ثم تشغيل الواجهة الأمامية (npm start) والخلفية (python app.py) بشكل منفصل. أما البديل باستخدام الحاويات فيتلخص في الأمر docker-compose up --build. متغيرات البيئة: يتضمن القالب معلمات قاعدة البيانات (DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PASSWORD)، وبيانات اعتماد مزود الذكاء الاصطناعي للرندر (AI_API_KEY, AI_PROVIDER)، وإعدادات الخادم (PORT, FLASK_ENV, SECRET_KEY). ويحذر ملف README من عدم رفع ملف .env إلى المستودع. الاستخدام: يتم الوصول إلى الواجهة الأمامية عبر http://localhost:3000 وتكون الـ API متاحة عبر http://localhost:5000، مع إمكانية تكوين المنافذ. يتم إنشاء الرندرات ثلاثية الأبعاد من وحدة الرقمنة عبر تكوين معلمات المنتج. الاختبارات: يتم توثيق npm test للواجهة الأمامية و pytest للواجهة الخلفية، مع تنفيذ تلقائي عند كل push و pull request عبر GitHub Actions. الرخصة المحددة هي MIT. نطاق التوثيق: يصف ملف README البنية والوحدات وعملية التشغيل، لكنه لا يفصل نموذج البيانات، أو نقاط النهاية (endpoints) المحددة للـ API، أو آلية العمل الداخلية لمحرك الذكاء الاصطناعي، حيث يكتفي بالإشارة إلى اعتماده على مزود خارجي عبر مفتاح API. ولتقييم الحالة الفعلية لكل وحدة، يفضل مراجعة الكود المصدري قبل التفكير في استخدامه في بيئة إنتاج.