الربط بواجهات الإبلاغ التنظيمي: ربط الحقول، والتوقيع، والإيصالات، وإعادة الإبلاغ
باختصار: الصعوبة في الإبلاغ التنظيمي ليست في إرسال الطلب، بل في ثلاثة أمور أخرى: صيغة الرسائل تختلف من جهة إلى أخرى وتتغير، والإيصالات غالبًا غير متزامنة، ولكلٍّ من الإغفال والإبلاغ الخاطئ عواقب. نقسم العمل إلى ثلاث طبقات. تُحوَّل بيانات المصدر أولًا إلى كائنات قياسية داخلية، ثم تُصاغ في رسالة كل جهة وفق إصدار محدد من المواصفة. وتتولى طبقة إرسال مشتركة التوقيع والتشفير وإعادة المحاولة والإيصالات. ويُحفظ كل إبلاغ وإيصال سجلَّ تدقيق، مع إجراءات محددة لإعادة الإبلاغ والمطابقة.
1.0 افصلوا الصيغة عن الإرسال
النمط القديم المعتاد خدمة لكل منطقة، مع ربط الحقول والتوقيع والإرسال مكتوبة كلها داخل الشيفرة. كل تغيير في المواصفة يعني إصدارًا جديدًا، وتتباعد الخدمات الإقليمية، ويُصلح خلل التوقيع نفسه عدة مرات.
البنية الأمتن تقسّم العمل بحسب تواتر التغيير:
| الطبقة | المسؤولية | تتغير مع |
|---|---|---|
| الجمع | سحب البيانات من أنظمة الشركة وتحويلها إلى كائنات قياسية داخلية | أنظمة الشركة |
| الربط | من الكائنات القياسية إلى رسالة جهة واحدة وإصدار مواصفة واحد | إصدارات المواصفة |
| الإرسال | المصادقة والتوقيع والتشفير والنقل والإيصالات وإعادة المحاولة | نادرًا |
تُدار عمليات الربط لكل جهة رقابية وإصدار مواصفة. حين يبدأ إصدار جديد يبقى القديم، ويجري التبديل في تاريخ السريان، والتراجع يعني تغيير التاريخ.
2.0 الربط إعدادات، مع اختبارات
قواعد الربط إعدادات: تطابق الحقول، وتحويل جداول الرموز، وتحويل الوحدات، والتحقق من الحقول الإلزامية. يصونها فريق التنفيذ من واجهة لا من الشيفرة. لكن الإعدادات قد تخطئ أيضًا، لذلك:
- لكل ربط مجموعة بيانات عيّنة ورسائل متوقعة، تُقارن تلقائيًا بعد كل تعديل.
- جداول الرموز، مثل رموز القطاعات والمناطق الإدارية، لها إصدارات مستقلة ويُشار إليها بالإصدار.
- تعديلات الإعدادات تمر بالموافقة وتُسجَّل، فيُعرف من غيّر ماذا ومتى.
بعض الحالات لن تناسب الإعدادات أبدًا. أعطوا هذه الاستثناءات واجهة إضافات مستقرة، بدل أن تتضخم لغة الإعدادات حتى تصير لغة برمجة لا يستطيع فريق التنفيذ صيانتها ويفضّل المطورون عدم لمسها.
3.0 طبقة الإرسال
- تُركَّب الشهادات والمفاتيح للقراءة فقط، ولا تُخزَّن أبدًا في قاعدة البيانات ولا تظهر في واجهة الإعدادات، ويتبع تدويرها إجراءً مكتوبًا.
- بيئة تشغيل واحدة تدعم وسائل النقل التي تطلبها الجهات، سواء HTTP أو اتصالات TCP طويلة أو طابور رسائل، بدل منظومة مستقلة لإعادة المحاولة والتسجيل لكل منها.
- يحمل كل إبلاغ رقمًا تسلسليًا فريدًا للعمل، وإعادة الإرسال تستخدم الرقم نفسه لتتمكن الجهة من إزالة التكرار. وإن لم تكن الجهة تزيل التكرار، يُتحقق من حالة «مؤكَّد» محليًا قبل أي إعادة إرسال.
- الإيصال المتزامن يعني عادةً «تم الاستلام» فقط. نتيجة المعالجة تصل في إيصال غير متزامن أو يجب الاستعلام عنها، والمساران كلاهما مطلوبان.
4.0 إعادة المحاولة وإعادة الإبلاغ والمطابقة
| الحالة | المعالجة |
|---|---|
| فشل الشبكة أو انتهاء المهلة | تراجع أُسّي بحد أقصى؛ وبعد الحد طابور يدوي |
| رفض من تحقق الجهة الرقابية | لا إعادة تلقائية؛ يذهب السبب إلى صاحب البيانات ويُعاد إبلاغ التقرير المصحح |
| إبلاغات فاتت أثناء التوقف | إعادة الإبلاغ حسب نافذة زمنية، مع تسجيل السبب |
| دوريًا | مطابقة مع تأكيدات الجهة الرقابية وإدراج البنود غير المؤكدة أو غير المتطابقة |
إعادة محاولة فشل التحقق لا تحقق شيئًا سوى سيل من الأخطاء المتطابقة، وقد تتجاوز حدود المعدل لدى الجهة الرقابية.
5.0 التدقيق
لكل إبلاغ، احتفظوا بلقطة بيانات المصدر، والرسالة المولّدة، وملخص التوقيع، ووقت الإرسال، والإيصال. عند النزاع تحتاجون إلى إثبات ما أُبلغ في لحظة معينة وما عاد في المقابل. مدة الاحتفاظ تتبع متطلبات الجهة الرقابية وقواعد الامتثال لدى الشركة.
إذا كنتم تستبدلون خدمة إبلاغ قديمة مكتوبة داخل الشيفرة أو تتصلون بجهة رقابية جديدة، فراجعوا الويب والسحابة وإدارة الأجهزة، أو حدثونا عن مشروعكم.
المراجع
- Enterprise Integration Patterns، التسليم المضمون: https://www.enterpriseintegrationpatterns.com/patterns/messaging/GuaranteedMessaging.html
الأسئلة الشائعة
المواصفات الإقليمية تتغير كثيرًا. هل تستطيع الإعدادات مواكبتها فعلًا؟
معظم التغييرات تضيف حقولًا أو تحدّث جداول الرموز أو تعدّل قواعد التحقق، وهذه تغطيها الإعدادات. أما إذا تغيرت بنية الرسالة أو وسيلة النقل، فلا بد من تعديل قالب الربط أو حتى طبقة الإرسال. لهذا تُدار عمليات الربط بإصدار لكل مواصفة، ويعمل القديم والجديد جنبًا إلى جنب، ويجري التبديل حسب تاريخ السريان.
بيئة الاختبار لدى الجهة الرقابية لا تتصرف مثل الإنتاج. ما العمل؟
هذا شائع. نحفظ كل إيصال حقيقي من اختبارات الربط، بعد إخفاء البيانات، عيّنةً تغطي النجاح وإخفاقات التحقق وكل رمز خطأ، ونطابق بتواتر أعلى بعد الإطلاق لالتقاط ما لم تُظهره بيئة الاختبار.
هل يمكن البدء بمنطقة واحدة؟
البدء بمنطقة واحدة معقول، بشرط أن تُصمَّم البنية لعدة جهات رقابية: الكائنات القياسية وطبقة الربط وطبقة الإرسال منفصلة. عندها تضيف المنطقة الثانية ربطًا جديدًا فقط بدل نسخ خدمة كاملة.
فريق التنفيذ لدينا لا يكتب الشيفرة. هل يستطيع صيانة عمليات الربط؟
ربط الحقول وجداول الرموز اليومية يمكن صيانتها من الواجهة، وتُقارن كل تعديل تلقائيًا ببيانات العيّنة، فيظهر الخطأ فورًا في صورة فرق. أما الاستثناءات التي لا تعبّر عنها الإعدادات فينفذها المطورون عبر واجهة إضافات.