فتح واجهة API للصيانة التنبؤية PHM للرافعة العلوية

لا يمكن لبيانات التشغيل المتراكمة في نظام إدارة الصحة التنبؤية (PHM) للرافعات العلوية أن تتحول من أداة تنبيه معزولة إلى محور بيانات يندمج في قرارات جدولة الإنتاج إلا من خلال ربطها بنظام تنفيذ التصنيع (MES) في الورشة وبمنصة الإدارة العليا. وفي هذا الإطار، أعلنت شركة كيلود للصناعات الثقيلة رسميًا عن فتح واجهة برمجة التطبيقات RESTful API لنظام الصيانة التنبؤية PHM الخاص بالرافعات العلوية، وتم حتى لحظة إعداد هذا التقرير استكمال ربط البيانات والاختبارات المشتركة مع 30 مزودًا لأنظمة MES، لتغطي ثلاثة أنواع رئيسية من الأنظمة: MES المعدني، وMES للتصنيع التجميعي، وWMS للتخزين. وبعد فتح الواجهة، يمكن دفع بيانات الحالة اللحظية للرافعة العلوية وأحداث التنبيه وتوصيات الصيانة مباشرة إلى منصة إدارة الإنتاج الحالية لدى العميل، دون حاجة المشغل إلى التنقل بين أنظمة متعددة للاستعلام. تستعرض هذه المقالة أربعة أبعاد: المواصفة الفنية للواجهة، وعملية الربط، وسيناريوهات التطبيق النموذجية، ونتائج الاختبارات المشتركة.

أولًا: بنية واجهات PHM ونموذج البيانات

تلتزم واجهات PHM المفتوحة حاليًا بمواصفة OpenAPI 3.0، وتعتمد أسلوب البنية RESTful، وتدعم تنسيقَي تسلسل البيانات JSON وProtocol Buffers. وتنقسم الواجهات إلى خمس فئات رئيسية حسب نوع المورد، لتغطي جميع قدرات البيانات الأساسية لنظام PHM للرافعات العلوية.

واجهة الحالة اللحظية للمعدات (Realtime Status API): توفر استعلامًا فوريًا عن حالة التشغيل الحالية للرافعة العلوية. تشمل النقاط الرئيسية: GET /api/v1/crane/{craneId}/status (تُرجع معاملات التشغيل الحالية — إحداثيات X/Y لموضع الجسر، وارتفاع الرفع، وسرعة الحركة، وتيار المحرك، وحالة المكبح، وقراءات محدد الحمل الزائد، وغيرها، بإجمالي 36 حقلًا، بتردد تحديث يبلغ ثانية واحدة)، وGET /api/v1/crane/{craneId}/health (تُرجع تقييم صحة المعدات، وهو مؤشر صحة المعدات بدرجة من 0 إلى 100 محسوب بدمج معاملات متعددة الأبعاد، ويُحدَّث كل 5 دقائق)، وGET /api/v1/crane/{craneId}/alerts (تُرجع قائمة التنبيهات غير المعالجة حاليًا، مع دعم التصفية حسب درجة الخطورة ونوع التنبيه).

واجهة البيانات التاريخية (History API): توفر استعلامًا مجمعًا لبيانات تشغيل المعدات وسجل التنبيهات. تشمل النقاط: GET /api/v1/crane/{craneId}/timeseries (الاستعلام عن بيانات السلاسل الزمنية التاريخية لمعامل محدد ضمن نطاق زمني، مع دعم تصدير بيانات متواصلة حتى 30 يومًا، وفترة أخذ العينات قابلة للتكوين بثلاث درجات: ثانية واحدة/10 ثوانٍ/دقيقة واحدة)، وGET /api/v1/crane/{craneId}/alerts/history (الاستعلام عن قائمة أحداث التنبيه التاريخية، متضمنةً وقت حدوث التنبيه ووقت زواله ونوع التنبيه ودرجة الخطورة وحالة المعالجة)، وGET /api/v1/crane/{craneId}/maintenance (الاستعلام عن سجلات صيانة المعدات، متضمنةً نوع الصيانة ووقتها ومحتواها والمنفذ). تُستخدم واجهة البيانات التاريخية بشكل أساسي لتوليد تقارير تحليل OEE للمعدات وجدولة خطط الصيانة في نظام MES.

واجهة دفع التنبيهات (Alert Webhook API): تدعم منصة MES الاشتراك في أحداث التنبيه الصادرة عن نظام PHM عبر آلية Webhook. يقوم العميل بتكوين قواعد دفع التنبيهات في الخلفية الإدارية لنظام PHM (تحديد عنوان URL للدفع، وعتبة درجة خطورة التنبيه، وتردد الدفع)، وعند توليد حدث تنبيه جديد في نظام PHM، يتم تلقائيًا إرسال طلب POST إلى عنوان Webhook المُكوَّن، ويكون جسم الطلب بيانات حدث التنبيه بتنسيق JSON. يدعم Webhook آلية إعادة المحاولة — بعد فشل أول عملية دفع، يُعاد المحاولة بعد 30 ثانية، وبحد أقصى 3 محاولات، وفي حال فشل المحاولات الثلاث، يتحول النظام إلى إشعار المشرف عبر البريد الإلكتروني للمعالجة اليدوية. يبلغ متوسط زمن الاستجابة لدفع Webhook 5 ثوانٍ (من لحظة اكتشاف PHM للخلل حتى استلام MES لدى العميل لرسالة الدفع).

واجهة إدارة المعدات (Device Management API): توفر عمليات CRUD للمعلومات الأساسية لمعدات الرافعات العلوية. تشمل النقاط: إضافة جهاز جديد (POST /api/v1/crane، مع توليد معرّف فريد للجهاز ومعاملات التكوين الأولية تلقائيًا)، وتحديث تكوين الجهاز (PATCH /api/v1/crane/{craneId}، لتعديل عتبات التنبيه وتردد أخذ العينات وغيرها من المعاملات)، والاستعلام عن قائمة الأجهزة (GET /api/v1/cranes، مع دعم التصفية حسب الورشة ونوع المعدات وحالة التشغيل)، وحذف الجهاز (DELETE /api/v1/crane/{craneId}، ويتطلب تأكيدًا ثانيًا). تتيح واجهة إدارة المعدات لنظام MES لدى العميل إتمام تسجيل الجهاز في نظام PHM تلقائيًا عند إضافة رافعة علوية جديدة، دون الحاجة إلى تسجيل الدخول يدويًا إلى الخلفية الإدارية لنظام PHM.

واجهة النماذج والتشخيص (Model API): توفر إدارة نماذج التشخيص بالذكاء الاصطناعي والاستعلام عن نتائج التشخيص. تشمل النقاط: GET /api/v1/model/{modelId}/info (الاستعلام عن معلومات نموذج تشخيص محدد — رقم إصدار النموذج، ووقت النشر، وطرازات الرافعات المدعومة، ومؤشرات الدقة)، وPOST /api/v1/crane/{craneId}/diagnose (تشغيل تشخيص صحي فوري لرافعة علوية محددة، مع إرجاع الحالة الصحية لكل نظام فرعي وتدابير الصيانة الموصى بها)، وGET /api/v1/crane/{craneId}/diagnose/history (الاستعلام عن قائمة تقارير التشخيص التاريخية). تتيح واجهة Model API لنظام الإرسال في MES لدى العميل الاستعلام بشكل استباقي عن الحالة الصحية للرافعة العلوية قبل جدولة الإنتاج، لتجنب توزيع المهام على معدات ذات حالة صحية غير جيدة.

ثانيًا: الحل التقني لربط الواجهة وشهادة السلامة

تعتمد واجهات PHM آلية OAuth 2.0 بنمط بيانات اعتماد العميل (Client Credentials Grant) للمصادقة. عند الربط الأول، يتقدم نظام MES لدى العميل بطلب للحصول على معرّف العميل (client_id) ومفتاح العميل (client_secret) عبر منصة مطوري PHM، ثم يحصل على رمز الوصول (access_token) عبر نقطة POST /oauth/token، وتكون فترة صلاحية الرمز 24 ساعة افتراضيًا، وبعد انتهائها يلزم تحديثه باستخدام refresh_token. حدود تردد الاستعلام للواجهات هي: واجهة الحالة اللحظية حتى 6000 استعلام في الساعة (أي بمتوسط 1.67 استعلام في الثانية تقريبًا)، وواجهة البيانات التاريخية حتى 360 استعلامًا في الساعة، بينما لا توجد حدود لتردد واجهات دفع التنبيهات وتشخيص النماذج. زمن استجابة الواجهات عند المئين 99% أقل من 500ms (باستثناء بطء نقل الشبكة).

يتم تشفير نقل البيانات باستخدام TLS 1.3، وتُستضاف بوابة الواجهات على Alibaba Cloud API Gateway، مع دعم جدار حماية تطبيقات الويب (WAF) والحماية من هجمات حجب الخدمة (DDoS). تسجّل سجلات طلبات الواجهات الطابع الزمني لكل استدعاء ومعرّف العميل ومسار الطلب ورمز حالة الاستجابة وزمن الاستجابة، وتُحتفظ السجلات لمدة 180 يومًا، ويمكن للعميل الاستعلام ذاتيًا عن إحصائيات استدعاء الواجهات عبر منصة المطورين (مؤشرات مثل عدد الاستدعاءات اليومي، ومعدل النجاح، ومتوسط زمن الاستجابة). توفر المنصة بيئة اختبار معزولة (sandbox) للواجهات، حيث يمكن للعميل استخدام بيانات محاكاة لإتمام تطوير الواجهات وتشغيلها التجريبي، ثم الانتقال إلى بيئة الإنتاج بعد التأكد من سلامتها. بيئة الاختبار معزولة تمامًا عن بيئة الإنتاج من حيث البيانات، ولا تؤثر على بيانات المعدات الحقيقية.

ثالثًا: تقدم الربط وتغطية مزودي MES

تم حتى لحظة إعداد هذا التقرير استكمال ربط واجهات API والاختبارات المشتركة مع 30 مزودًا لأنظمة MES، لتغطي أربعة قطاعات صناعية: الصناعة المعدنية (12 مزودًا)، وتصنيع المعدات الثقيلة (8 مزودين)، والتصنيع الميكانيكي (6 مزودين)، والتخزين والخدمات اللوجستية (4 مزودين). تشمل أنواع أنظمة MES المرتبطة: أنظمة MES المحلية السائدة (مثل Yonyou U8+MES، وKingdee Cloud Galaxy MES، وDigiwin MES، وغيرها — 14 مزودًا)، وأنظمة MES المتخصصة بالقطاعات (مثل MES المعدني، وMES لمعالجة الألمنيوم، وMES لبناء السفن، وغيرها — 10 مزودين)، وأنظمة MES المطوّرة داخليًا (أنظمة إدارة الورشات المطوّرة ذاتيًا لدى الشركات الكبرى — 6 مزودين).

هناك ثلاثة أنماط شائعة لدمج بيانات PHM من قبل مزودي أنظمة MES أثناء عملية الربط: دمج لوحة التنبيهات (يتم تضمين قائمة تنبيهات PHM في لوحة مراقبة المعدات بنظام MES، بحيث يتمكن المشغل من رؤية تنبيهات صحة الرافعة العلوية دون التبديل إلى نظام PHM — يختار هذا النمط حوالي 70% من العملاء)، والإنشاء التلقائي لأوامر الصيانة (عند استلام نظام MES لتنبيه PHM، يقوم تلقائيًا بتشغيل عملية إنشاء أمر الصيانة، مع تعبئة معلومات المعدات ووصف التنبيه وخطة الصيانة الموصى بها تلقائيًا في الأمر — يختار هذا النمط حوالي 45% من العملاء)، والربط بين صحة المعدات وجدولة الإنتاج (تقوم وحدة الجدولة في نظام MES بالاستعلام تلقائيًا عن تقييم صحة المعدات من PHM عند توزيع مهام الرفع والنقل، وتعطي الأولوية للمهام العاجلة للرافعات العلوية ذات التقييم الصحي الأعلى — يختار هذا النمط حوالي 20% من العملاء). يمكن الجمع بين الأنماط الثلاثة دون أي تعارض.

متوسط دورة اختبار التكامل هو 3~5 أيام عمل (بدءًا من حصول مزود MES على وثائق API وحتى اكتمال التحقق من البيانات من البداية إلى النهاية)، وقد أكمل أسرع مزود MES التكامل خلال يومي عمل. تشمل المشكلات النموذجية التي تظهر خلال مرحلة الاختبار: تجاوز حد تردد استدعاءات API (يُحل عبر ضبط فترة الاستقصاء لنظام MES، ويُنصح ألا تقل فترة استقصاء واجهات الحالة الفورية عن 5 ثوانٍ)، ومشكلات تزامن البيانات (عدم تطابق المنطقة الزمنية بين وقت تنبيه PHM ووقت أمر MES — يُحل عبر إرجاع كل من وقت UTC والوقت المحلي في بيانات التنبيه)، وانتهاء صلاحية شهادة مستقبل Webhook (يُحل عبر المراقبة التلقائية لصحة الشهادات في API Gateway والتنبيه قبل 30 يومًا من الانتهاء).

سيناريوهات التطبيق ونتائجه

على سبيل المثال، إحدى شركات التعدين التي ربطت نظامها عبر PHM API تمتلك 5 رافعات علوية. قبل الربط، كان على مسؤول المعدات تسجيل الدخول إلى لوحة PHM الإدارية للتحقق من التنبيهات يدويًا، ثم تعبئة أوامر صيانة ورقية وتسليمها لفرق الإصلاح، وكان متوسط الوقت من لحظة ظهور التنبيه حتى إصدار الأمر 45 دقيقة. بعد الربط عبر API، يتم دفع أحداث التنبيه من PHM تلقائيًا عبر Webhook إلى نظام MES الخاص بالشركة، والذي يقوم بدوره بإنشاء أوامر الصيانة تلقائيًا بناءً على درجة التنبيه (تُحال أوامر مستوى التحذير تلقائيًا إلى فريق الصيانة الصباحي، بينما تُرسل أوامر المستوى الحرج فورًا إلى مهندس الطوارئ)، مما قلص وقت إنشاء الأمر إلى أقل من 10 ثوانٍ. أظهرت بيانات 6 أشهر بعد الربط أن متوسط وقت الاستجابة للتوقف غير المبرمج للرافعات العلوية (من لحظة حدوث العطل حتى وصول فريق الصيانة إلى الموقع) انخفض من 85 دقيقة إلى 22 دقيقة، وانخفضت خسائر الطاقة الإنتاجية الناتجة عن التوقف غير المبرمج بنحو 62%.

كما وفّر فتح واجهات API قاعدة بيانات أساسية للتحسين المستمر لنظام PHM — حيث يستفيد نموذج التنبيه بتقييم صحة الرافعة العلوية من بيانات نتائج الصيانة المرتجعة من نظام MES (ما إذا كان العطل مطابقًا لتنبيه PHM، والطرز الفعلية للمكونات المستبدلة، ووقت الصيانة) لتدريبه بشكل متكرر، مما يرفع دقة الإنذار المبكر بنحو 1.5 نقطة مئوية كل ثلاثة أشهر. تشمل واجهات البيانات المقرر فتحها في المرحلة القادمة: بيانات استهلاك الطاقة للرافعة العلوية (الاستهلاك اللحظي والتراكمي لمحركات جسر الرافعة والعربة والرفع، لدعم مقارنة كفاءة الطاقة وتحسينها) وإحصائيات عمليات الرفع والنقل (متوسط عدد عمليات الرفع يوميًا لكل رافعة، وتوزيع أوزان الحمولات، وإحصائيات مدة التشغيل، لدعم تحليل كفاءة جدولة الإنتاج)، مع التخطيط لإتمام الربط مع 50 مزودًا لأنظمة MES بحلول نهاية العام.

الأسئلة الشائعة (FAQ)