Node-RED Contrib VirtualFactory Reporter

نظرة عامة

node-red-contrib-virtualfactory-reporter هو Node-RED plugin مصمم لمحاكاة بيانات خطوط الإنتاج في مصنع افتراضي، ومعالجة هذه البيانات لحساب مؤشرات الأداء الرئيسية (KPIs)، وعرضها في لوحة تحكم تفاعلية (Dashboard)، وتوليد تقارير PDF أنيقة.

يهدف هذا الـ plugin إلى توفير حل شامل لمراقبة وتحليل عمليات التصنيع الافتراضية، مما يجعله أداة مثالية لأغراض العرض التوضيحي، التعليم، أو تطوير الأنظمة الأولية.

الميزات

• توليد بيانات المصنع الوهمية: يولد بيانات في الوقت الفعلي لآلات متعددة عبر خطوط إنتاج مختلفة داخل مصنع افتراضي.
• معالجة البيانات والتحقق منها: يقوم بتطبيع البيانات الواردة والتحقق من صحتها لضمان الدقة.
• حساب مؤشرات الأداء الرئيسية (KPIs): يحسب مؤشرات مثل OEE (Overall Equipment Effectiveness)، التوفر (Availability)، الأداء (Performance)، والجودة (Quality) على أساس ساعي ويومي.
• تخزين البيانات: يخزن البيانات الخام ومؤشرات الأداء الرئيسية المحسوبة في قاعدة بيانات SQLite محلية للتحليل التاريخي والتقارير.
• لوحة تحكم تفاعلية: يعرض البيانات ومؤشرات الأداء الرئيسية في لوحة تحكم Node-RED Dashboard، بما في ذلك بطاقات KPI، الرسوم البيانية للاتجاهات، وجداول الحوادث.
• توليد تقارير PDF: ينشئ تقارير PDF مفصلة وأنيقة تتضمن ملخصات، جداول، ورسوم بيانية للإنتاج واستهلاك الطاقة.
• نقاط نهاية HTTP: يوفر واجهة برمجة تطبيقات (API) للتحكم في محاكاة البيانات وتنزيل التقارير.

التثبيت

لتثبيت هذا الـ plugin في Node-RED الخاص بك، اتبع الخطوات التالية:

1. تثبيت Node.js و Node-RED: إذا لم تكن قد قمت بذلك بالفعل، قم بتثبيت Node.js (يوصى بالإصدار 16 أو أحدث) و Node-RED.

   # تثبيت Node.js (إذا لم يكن مثبتًا)
   curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

sudo apt-get install -y nodejs

# تثبيت Node-RED (إذا لم يكن مثبتًا)
sudo npm install -g --unsafe-perm node-red
```

2. تثبيت تبعيات النظام لـ node-canvas: يتطلب توليد الرسوم البيانية في PDF بعض مكتبات النظام. قم بتثبيتها باستخدام:

   sudo apt-get update
   sudo apt-get install -y build-essential libcairo2-dev libpango1.0-dev libjpeg-dev libgif-dev librsvg2-dev

3. تثبيت الـ plugin: انتقل إلى دليل مستخدم Node-RED الخاص بك (عادةً ~/.node-red) وقم بتثبيت الـ plugin:

   cd ~/.node-red
   npm install node-red-contrib-virtualfactory-reporter

   أو، إذا كنت تقوم بالتطوير، يمكنك نسخ المجلد إلى ~/.node-red/nodes أو استخدام npm link.

   ملاحظة: هذا الـ plugin غير منشور بعد على npm. للتثبيت، ستحتاج إلى نسخ الملفات يدويًا إلى دليل ~/.node-red/nodes أو استخدام npm install <path_to_your_plugin_folder>. لغرض هذا المشروع، افترض أن مجلد الـ plugin هو /home/ubuntu/node-red-virtualfactory.

   cd ~/.node-red
   npm install /home/ubuntu/node-red-virtualfactory

4. تثبيت Node-RED Dashboard: يتطلب هذا الـ plugin Node-RED Dashboard. قم بتثبيته إذا لم يكن مثبتًا:

   cd ~/.node-red
   npm install node-red-dashboard

5. بدء Node-RED: ابدأ Node-RED باستخدام الأمر node-red.

الاستخدام

بعد التثبيت، ستجد العقد الجديدة (nodes) ضمن فئة Virtual Factory في لوحة Node-RED. يمكنك استيراد التدفق (flow) المرفق virtualfactory_flow.json إلى Node-RED الخاص بك لبدء الاستخدام.

التدفق المقترح

يتضمن الـ plugin تدفقًا مقترحًا يربط جميع المكونات معًا:

1. Simulate Factory Data: يولد بيانات المصنع الوهمية.
2. Normalize & Validate: يقوم بتطبيع البيانات.
3. Calculate Metrics: يحسب مؤشرات الأداء الرئيسية.
4. Store Data (SQLite): يخزن البيانات والمقاييس في قاعدة بيانات SQLite.
5. Prepare Dashboard Data: يجهز البيانات لعرضها في لوحة التحكم.
6. Generate PDF Report: ينشئ تقارير PDF.

نقاط نهاية HTTP

يمكنك التفاعل مع الـ plugin عبر نقاط نهاية HTTP التالية:

• POST /simulate/start: لبدء محاكاة البيانات.
• POST /simulate/stop: لإيقاف محاكاة البيانات.
• GET /reports/latest: لتنزيل أحدث تقرير PDF تم إنشاؤه.

لوحة التحكم (Dashboard)

يمكن الوصول إلى لوحة التحكم عبر http://<your-node-red-ip>:1880/ui (أو المنفذ الذي تم تكوينه). ستعرض لوحة التحكم نظرة عامة على المصنع، بما في ذلك بطاقات KPI، رسوم بيانية للإنتاج واستهلاك الطاقة، وجدول بأحدث الحوادث.

التكوين

يمكن تكوين العقد المختلفة (nodes) في Node-RED لتناسب احتياجاتك:

• Simulate Factory Data: يمكنك ضبط فترة التوليد (interval)، معرف المصنع (factoryId)، معرفات الخطوط (lineIds)، وعدد الآلات لكل خط (machineIdsPerLine).

استكشاف الأخطاء وإصلاحها

• مشاكل في تثبيت node-canvas: تأكد من تثبيت جميع تبعيات النظام المذكورة في الخطوة 2 من قسم التثبيت.
• لا تظهر العقد في Node-RED: تأكد من تثبيت الـ plugin بشكل صحيح في دليل ~/.node-red وإعادة تشغيل Node-RED.
• لا يتم إنشاء تقارير PDF: تحقق من سجلات Node-RED بحثًا عن أي أخطاء متعلقة بقاعدة البيانات أو توليد PDF. تأكد من وجود بيانات كافية في قاعدة البيانات.

الترخيص

هذا المشروع مرخص بموجب ترخيص MIT.