في هذه الصفحة
لدى عميلين حقل يحمل اسم «نشط». يعني عند الأول أن العميل اشترى شيئًا خلال السنة الماضية، وعند الثاني أن اتفاق الخدمة ما زال ساريًا. يستطيع موصل مشترك نقل الحقلين نقلًا صحيحًا. لكن قاعدة مشتركة تعاملهما كحالة تجارية واحدة قد تخطئ مع أحدهما. هذا مثال توضيحي، لا تقرير عن نشر فعلي.
يصف نقاش حول المنصات المشتركة والنشر المحلي شركة تعيد استخدام جزء كبير من بنيتها مع استمرار العمل داخل بيئة كل عميل. النسب المذكورة خاصة بتلك الشركة. السؤال المعماري العام هو أين تنتهي الآليات المشتركة ويبدأ المعنى المحلي.
افصل عقد النقل عن عقد العمل
يمكن لعقد النقل أن ينص على المصادقة لدى المصدر، وقراءة السجلات المتغيرة، وحفظ المعرّفات، وإعادة المحاولة بأمان، وإظهار الفشل. يمكن بناء هذه السلوكيات مرة واختبارها مرارًا. وهي مهمة لأن كل تكامل يحتاج إلى مسار موثوق للبيانات.
أما عقد العمل فيحدد السجل المرجعي، ومعنى الحالة، ومتى يجوز اتخاذ فعل، ومن يحق له تصحيح خطأ.
- نقل مشترك هوية · إعادة · معرّف حدث
يسلم حدثًا صالحًا
- سياسة محلية معنى · موافقة · توقيت
تحدد هل الفعل مسموح
- فعل مصرح به كتابة · تدقيق
يسجل النتيجة
يعتمد عقد العمل على سير العمل. وقد يستخدم المصدر والوجهة نفسيهما لدى عميل آخر، ثم يتطلب إجابة مختلفة.
تأمل ربط متجر بنظام بريد. تستطيع المنصة توفير استقبال الأحداث ومنع التكرار وسجل تدقيق. لكن مالك سير العمل يجب أن يحدد هل تعني «مشترك» الإذن لغرض تسويقي محدد، وهل يوقف الشراء تذكير السلة، وكيف يغيّر سحب الموافقة الرسائل المجدولة. لا يمكن تخمين هذه الخصائص التجارية من أسماء الحقول.
ينسخ ربط Tajo التوضيحي أدناه ثلاثة حقول مباشرة. لكن لا يحدد أي صف إذن التسويق. إعادة استخدام النقل توفر الجهد، ويبقى على مالك سير العمل تحديد الحالة التي تسمح بكل فعل. قد يكشف ربط مرتب هذه الفجوة من دون سدها.
راجع المزامنة قبل تشغيلها
زامن تحديثات العملاء مع منصة البريد الإلكتروني.
مزامنة العملاء
| حقل المصدر | حقل الوجهة | القاعدة |
|---|---|---|
email | EMAIL | مباشر |
first_name | FIRSTNAME | مباشر |
last_name | LASTNAME | مباشر |
نجحت المعاينة ببيانات اصطناعية
3 حقول مربوطة · لا كتابة إلى الوجهة
تصميم توضيحي يستند إلى أدوات ربط الحقول في Tajo. المعاينة الاصطناعية والمسودة المحفوظة لا تفعلان المزامنة.
| الطبقة المشتركة | الطبقة المحلية |
|---|---|
| المصادقة وتجديد الرمز | الجهة المسموح لها بالوصول إلى هذا العمل |
| نقل الأحداث وإعادة المحاولة | الحدث الذي يعد انتقالًا تجاريًا |
| المعرّفات الثابتة ومنع التكرار | السجلات التي تعود إلى العميل الحقيقي نفسه |
| التسجيل ومسارات التعافي | من يحل نزاع الحالة وكيف |
| التحقق من العقد | معنى القيم ومتى يجوز أن تطلق فعلًا |
هذا الجدول حد تصميمي، ولا يدعي إمكان فصل كل تنفيذ بهذا الوضوح.
تفشل إعادة الاستخدام حين تخفي الاختلاف
كثيرًا ما تضيف المنصة العامة حقل إعداد جديدًا لكل استثناء. يبدو ذلك أولًا حفاظًا على إعادة الاستخدام. ثم لا يعود أحد يعرف هل الإعداد خيار تقني أم قيد قانوني أم قرار تجاري. تصبح النواة المشتركة أداة للتحكم عن بُعد في خيارات لا تملكها.
ابحث عن قاعدة ثابتة. يمكن لمحرك مشترك فرض «لا تطبق حدث المصدر نفسه مرتين على سجل الوجهة نفسه». أما «أرسل خصمًا حين يصبح العميل نشطًا» فلا يمكن تعميمها قبل تحديد معنى «نشط» والجمهور المسموح وسياسة العرض ومالك كل منها. يستطيع المحرك تنفيذ سياسة معتمدة، لا اختراعها.
يساعد هذا الفصل في الصيانة. إذا تغيرت API، يستطيع فريق المنصة تحديث المهايئ واختباراته. وإذا تغير تعريف العميل المؤهل، يستطيع مالك العمل تحديث السياسة وأمثلتها دون انتظار إعادة كتابة النقل. يوصل الحد الواضح كل تغيير إلى صاحب الصلاحية المعنية.
أعد استخدام الآليات دون تسوية المعاني
تزيد بعض القواعد المحلية التكلفة فعلًا. والمنصة التي لا تملك عقدًا قابلًا لإعادة الاستخدام تصبح مجموعة شيفرات خاصة بكل عميل. الحل هو تحديد الآليات المتكررة قبل تجريد المعاني المتكررة. قد تقبل أداة مشتركة جيدة شرطًا محدد النوع ووقت حدث وحدًا للفعل، وتترك تعريف الشرط التجاري محليًا.
اختبر الحد بحالات حقيقية: حدث عادي، وتكرار، وتصحيح متأخر، وصلاحية مسحوبة. اسأل أي طبقة مسؤولة عن كل استجابة. إذا تعذر إسناد إخفاق، فالطبقة المجردة تخفي الملكية. وإذا أجبر عميل جديد حالة «نشط» العامة على حمل تفسيرات متباعدة، فالنوع المشترك واسع أكثر من اللازم.
تفحص مقالة النشر المكملة هل تعمل القدرة داخل سير عمل حي. أما هذه المقالة فتسأل ما الذي يمكن بناؤه مرة واحدة دون محو معنى ذلك العمل.
ينبغي أن ترفض الواجهة بين الطبقات افتراضًا سيئًا بوضوح. يمكن لمحرك مشترك أن يشترط معرّف حدث ووقت مصدر وجهة فاعلة وغرضًا معلنًا قبل قبول طلب فعل. ويقدم سير العمل المحلي السياسة التي تقرر هل يجوز الفعل. إذا غاب الغرض، يرفض المحرك الطلب؛ وإذا التبست السياسة، يحسمها المالك المحلي. هكذا نحافظ على إعادة الاستخدام دون تسليم السلطة التجارية إلى شيفرة عامة. وثّق العقد بمثال مقبول وآخر مرفوض، واختبرهما عند تغير أي من الطبقتين.
ينبغي أن يسهل الموصل القابل لإعادة الاستخدام التعبير عن المعنى المحلي وتنفيذه بأمان، لا أن يجعل وعدَين مختلفين يبدوان متطابقين لأن الحقلين يحملان الاسم نفسه.
الأسئلة المتكررة
ما الذي يمكن عادة إعادة استخدامه في منصة تكامل؟
يمكن غالبًا مشاركة الآليات المستقرة، مثل أنماط المصادقة والنقل ومنع تكرار الأثر وإعادة المحاولة والتسجيل وفحص العقود، حين تتطابق المتطلبات الأساسية.
ما الذي يجب أن يبقى خاصًا بالمؤسسة؟
يجب تحديد معنى الحقول ومرجعية المصدر وقواعد الموافقة ومتطلبات التوقيت ومن يحق له التصرف بناء على حالة، بحسب المؤسسة وسير العمل.
كيف يختبر الفريق هذا الحد؟
حاول التعبير عن سير عمل جديد بالأدوات المشتركة القائمة. إذا غيّر ذلك معناه التجاري أو أخفى الاستثناءات في إعدادات عامة، فأبقِ المنطق محليًا واجعل الواجهة بين الطبقات صريحة.