بوابة قابلة للتهيئة لتقارير السلامة التنظيمية

صممنا منصة إبلاغ تربط بيانات المصدر لدى المنشآت بكائنات قياسية، ثم بصيغة الرسائل الخاصة بكل جهة تنظيمية. يتولى معالج من تسع خطوات التهيئة، وتُركّب الأسرار للقراءة فقط، لتحل المنصة محل خدمتي إبلاغ قديمتين كانت قواعدهما مكتوبة في الشيفرة مباشرة.

باختصار: استبدلنا خدمتي إبلاغ مكتوبتي القواعد في الشيفرة ببوابة واحدة تربط بيانات المنشأة بكائنات قياسية، ثم بصيغة رسائل كل جهة تنظيمية، بالتهيئة لا بالشيفرة، مع التوقيع والإرسال وإيصالات الاستلام وإعادة المحاولة والتدقيق مدمجة فيها.

نظرة عامة

يتعين على المنشآت الصناعية في قطاع سلامة خاضع للتنظيم إبلاغ المنصات الحكومية بتصاريح العمل، وبيانات الأفراد، والمواقع في الزمن الحقيقي، وبيانات ضبط المخاطر. لكل منصة قواعدها الخاصة في الحقول والتوقيع والتشفير وإيصالات الاستلام. يهيّئ فريق التنفيذ أي تكامل جديد في معالج من تسع خطوات، وتُركّب الأسرار للقراءة فقط على المضيف.

تدفق البيانات في بوابة الإبلاغ: تُستكشف مصادر بيانات المنشأة وتُربط بكائنات قياسية، ثم برسائل المنصة المستهدفة؛ تُوقّع الرسائل وتُشفّر وتُرسل عبر HTTP أو TCP أو أنظمة المراسلة؛ وتعود إيصالات الاستلام إلى إعادة المحاولة وإعادة الإبلاغ والمطابقة؛ ويتحكم معالج من تسع خطوات في التهيئة والموافقة والإصدار.

المشكلة

كانت كل منشأة جديدة، وكل إصدار جديد من نظام منشأة أو من منصة جهة تنظيمية، يعني تعديلات في شيفرة الخدمات القديمة. وكان المعنى التشغيلي موزعًا بين نصوص برمجية وحالات خاصة. واعتمد عمل التكامل على المطورين وصعب تدقيقه.

القيود

  • يمكن استخدام الشيفرة القديمة لاكتشاف الحالات الخاصة في العمل، لا لتشكيل البنية الجديدة.
  • لا يعدّل فريق التنفيذ SQL أو YAML أو JSON أو أي نصوص برمجية. هدف التصميم: تهيئة 95% على الأقل من التكاملات الجديدة عبر الواجهة، والباقي عبر واجهة إضافات مستقرة. ولا يزال هذا الهدف بحاجة إلى إثبات بعينات حقيقية.
  • النشر في مقر العميل، بما في ذلك مواقع غير متصلة بالشبكة، مع تثبيت معمارية الصور ومعرّفات صور قابلة للتحقق.
  • لا تُخزن بيانات الاعتماد في التهيئة أبدًا. تُخزن المراجع المنطقية فقط.

البنية

الجزءالتنفيذ
الخادمJava 21، وSpring Boot 4.1، وMySQL 8، وترحيلات Flyway من V1 إلى V14
لوحة التحكمواجهة تهيئة بـ Vue 3 + TypeScript
الربطمرحلتان: من حقول المصدر إلى كائن قياسي، ثم من الكائن القياسي إلى الرسالة المستهدفة، معبَّرًا عنهما بشجرة تعابير مغلقة لا بلغة نصوص برمجية
المعالجتسع خطوات: النطاق، ومصدر البيانات، والاستكشاف، والربط القياسي، والرسالة المستهدفة، وقدرات المنصة، والاختبار، والموافقة، والإصدار
محرك الإرسالالمصادقة والتوقيع والتشفير؛ النقل عبر HTTP وTCP وأنظمة المراسلة؛ إيصالات متزامنة وغير متزامنة؛ الجدولة، والإرسال التزايدي، وعدم تكرار الأثر، وإعادة المحاولة، وإعادة الإبلاغ، والمطابقة
الأسرارمخزن أسرار قائم على الملفات، للقراءة فقط، مركّب داخل الحاوية

القرارات الرئيسية

  1. لغة ربط مغلقة. شجرة التعابير المحدودة يمكن التحقق منها وتدقيقها قبل الإصدار، وهو ما لا تسمح به النصوص البرمجية الحرة، فيرى المراجع بالضبط ما الذي سيرسله الربط.
  2. كائنات قياسية في الوسط. لأن المصادر والوجهات لا تلتقي إلا عند الكائن القياسي، فإن إضافة نظام منشأة جديد أو إصدار جديد لجهة تنظيمية يمس جانبًا واحدًا من الربط.
  3. تشغيل آمن افتراضيًا. اختبارات الدخان تفحص السلامة فقط، والإرسال الفعلي يحتاج إلى علامة صريحة. ويرفض التراجع خفض إصدار الصورة متى كانت قاعدة البيانات على ترحيل أحدث، ويوجّه المشغّل بدلًا من ذلك إلى النسخة الاحتياطية السابقة للترقية.

الأدلة

  • 78 صنف اختبار في الخادم. 14 ترحيلًا بإصدارات. أربعة مجالات عمل في النطاق الأول: تصاريح العمل، والأفراد، وتحديد المواقع في الزمن الحقيقي، وضبط المخاطر وفق مبدأ الوقاية المزدوجة.
  • خط أساس المتطلبات، وتقرير التدقيق، وسجل القرارات، وقائمة تحقق القبول المرحلية، ودليل النشر جزء من التسليم.

الحدود

هدف قابلية التهيئة بنسبة 95% هدف تصميمي ولم يُتحقق منه في الميدان. أسماء الجهات التنظيمية ونقاط النهاية وبيانات المنشآت غير منشورة.

الأسئلة الشائعة

هل يستطيع غير المطورين إضافة تكامل لمنشأة جديدة؟

هذا هو هدف التصميم. يعمل فريق التنفيذ عبر المعالج ذي الخطوات التسع. والقدرات الخارجة عن نطاق المنتج تمر عبر واجهة إضافات، لا عبر تعديل النواة.

كيف تُحمى بيانات الاعتماد؟

تخزن التهيئة مرجعًا منطقيًا لبيانات الاعتماد فقط. أما الأسرار الحقيقية فتُقرأ من مجلد مركّب للقراءة فقط على المضيف.

هل تعمل دون اتصال بالشبكة؟

يمكن بناء الصور على جهاز متصل، وتصديرها، ثم تحميلها في الموقع والتحقق منها بمعرّف الصورة.