Multi File Transfer على BPMN: منطق مزامنة مخصص عبر السحابات وأنظمة التخزين، مع فحص المحتوى

الموقع في البنية

يجري النقل بوصفه عمليات BPMN ذات إصدارات في MEF.DEV BPMN Low-code على Enablement & Monetization Platform، لا بوصفه تطبيقًا منفصلًا. وترث العمليات توافق المنصة مع ODA: تقابل وظائف الـ API دور مكوّنات ODA، و Kubernetes مع التسليم عبر GitOps هو بيئة التشغيل. وعقد كل عملية هو حدودها المحدّدة الأنواع.

المكوّنات

• قائمة المسارات قائمة SharePoint تتضمن مسار المصدر ومسار الوجهة ووضع التعبئة الأولية وعلامة التفعيل. يحرّرها مسؤول SharePoint؛ وتقرؤها المنصة في بداية كل دورة، وتقارنها باللقطة المخزّنة، وتكتب الحالة.
• عملية الدورة تخدم transfer_files محركَ أقراص (drive) واحدًا في دورة واحدة.
• عملية الملف تنقل transfer_file ملفًا واحدًا عبر أربع عمليات محدّدة الأنواع.
• Backend plugin يحمل العمليات على Microsoft Graph و SFTPGo.
• منفّذ المهام (worker) يستأنف العمل غير المكتمل بعد العطل.

العقود

• DriveWorkModel مُدخل الدورة: مفتاح الـ drive، والموضع المخزّن (DeltaLink)، والمسارات المطلوب خدمتها، وذاكرة المسارات.
• FileTransferModel مُدخل النقل: operationId، ووسيلة النقل ومسار المصدر، ووسيلة النقل ومسار الوجهة، والاسم النهائي.
• OperationResult الحالة مع رمز الخطأ ومعرّف الارتباط و retryAfterSeconds. ويعود الرفض، مثل FinalNameConflict، بوصفه نتيجة، ويقرر المستدعي بحسب الحالة.
• نتائج الدورة COMMITTED و NOT_COMMITTED و NO_DELTA_LINK، وفي وضع التصحيح PLANNED_ONLY.
• بيانات الاعتماد لا تعبر قيمة الـ access token حدود BPMN: تُطبَّق بيانات الاعتماد على سياق الاتصال. ويستخدم التطبيق Sites.Selected بموافقة المسؤول (admin consent).

التدفق في دورة واحدة

1. الإشعار يشير إلى التغيير فقط. وتقرأ الدورة التغييرات عبر Microsoft Graph صفحةً تلو صفحة بدءًا من الموضع المخزّن.
2. يحلّ التغيير اللاحق في ملف محلّ التغيير السابق، لذا يُنقل الملف مرة واحدة على الأكثر لكل مسار في الدورة.
3. تخطط الدورة نقلًا واحدًا لكل ملف ومسار، وتستدعي transfer_file لكل منها، واحدًا تلو الآخر.
4. يحدد كل نقل الوجهة، ويقرأ المصدر، ويرفع إلى موقع مؤقت، ثم يُنهي العملية تحت الاسم النهائي. ولا يصبح الملف مرئيًا في الوجهة إلا في هذه الخطوة الأخيرة.
5. لا يُثبَّت الموضع الجديد، مع ذاكرة المسارات، إلا عند اكتمال كل عمليات النقل؛ وإلا تبدأ الدورة التالية مجددًا من الموضع القديم.

الاستعادة

• تُحفظ حالة كل استدعاء: بعد إعادة التشغيل لا تُنقل الملفات المكتملة مرة أخرى، وتُنفَّذ الخطوة المتقطعة مجددًا من بدايتها.
• يلتقط منفّذ (worker) المهمة غير المكتملة ويتابع النسخة الرئيسية نفسها؛ ويتولى مضيف ثانٍ العمل بعد توقف الأول.
• لا تستأنف إعادة التشغيل نقل البايتات من موضع إزاحة، ويمكن أن تتكرر عملية جرت بعد آخر حالة محفوظة.

نقاط التكامل

• Microsoft 365 اتصال HTTPS صادر إلى Microsoft Graph عبر forward proxy مع allowlist؛ ونقطة نهاية HTTPS واردة على الـ reverse proxy في الـ DMZ (Demilitarized Zone) للإشعارات.
• SFTPGo لكل مسار يضبط مسؤول SFTPGo مناطق staging و published و quarantine، وحسابًا تقنيًا، وقاعدة حدث رفع باتجاه وسيط الرسائل، وفحص ICAP شرطًا للنشر. ولا يرى الشركاء إلا published.
• المنصة وسيط رسائل، وقاعدة بيانات لسجل النقل والمؤشرات والاشتراكات، ومجدول لتجديد الاشتراكات ولدورة تحكم يومية.

الأشخاص في موقع التحكم

يملك مسؤول SharePoint المسارات ويوقفها مؤقتًا أو يستأنفها. وتعيد العملية محاولة عمليات النقل الفاشلة تلقائيًا، وتتحكم خدمة خارجية في الحجر عبر ICAP.

الحدود

• المسار أحادي الاتجاه؛ والاتجاه المعاكس مسار منفصل بمجلدات منفصلة.
• لا تُنقل عمليات الحذف، ويُعدّ الملف المُعاد تسميته ملفًا جديدًا.
• لا تُنقل الأذونات ولا سجل الإصدارات ولا البيانات الوصفية في SharePoint.
• لا يُحفظ الترتيب بين الملفات؛ ويُثبَّت وضع التعبئة الأولية عند إنشاء المسار.

نطاق الحل

يُتفق في المشروع على نطاق الحجر ودورات التحكم المذكورة أعلاه.

العمق التقني على platform.mef.dev ←