ما تكلّفه التكاملات فعلًا

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

وتلك الأسئلة ليست غريبة.

• ماذا يحدث حين لا يرد الطرف الآخر.
• ماذا يحدث حين يرد ببطء.
• ماذا يحدث حين يرد مرتين.
• ماذا يحدث حين يقول نعم ثم يفقد السجلّ.
• ومن يعرف بذلك.

ولكل واحد جواب هو قرار منتج لا قرار تقني، والتكامل المُسعَّر بدونها تسعيرٌ للظهيرة.

ماذا يحدث حين يكون معطّلًا

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

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

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

البطيء أصعب من المعطّل

النظام المعطّل يفشل سريعًا وسهل الكشف. أما نظام يستغرق أربعين ثانية للرد فهو أكثر ضررًا بكثير، لأنه يحتجز مواردك وهو لا يفعل شيئًا.

1. فحوض اتصالاتك يمتلئ بطلبات تنتظره.
2. وتبدأ طلبات لا علاقة لها بالتكامل بالاصطفاف خلفها.
3. ويصبح تباطؤ طرف ثالث غير حرج انقطاعًا لمنتجك.

وهذا هو نمط الفشل الذي يُسقط موقعًا كاملًا، والتكامل المسبّب عادةً شيء هامشي كبحث عنوان.

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

اعزل المورد

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

كل شيء سيُسلَّم مرتين

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

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

وهناك دقّة في مصدر المفتاح. فإن أنشأته أنت، لا تستطيع إلا إزالة تكرار إعاداتك؛ وإن وفّر الطرف الآخر معرّف حدث، أمكنك إزالة تكراره أيضًا، وهو ما تحتاجه للخطّافات. ومعظم المزوّدين يوفّرون واحدًا ومعظم التكاملات تتجاهله، ما يعني أن إزالة التكرار تغطّي الأقلّ شيوعًا من مصدري التكرار.

النظامان سيختلفان

على أي مدة زمنية، سيتباعد سجلّك لما حدث عن سجلّهم. فطلب انتهت مهلته بعد أداء العمل، وخطّاف فُوّت خلال نشر، وأحدهم عدّل سجلًّا مباشرةً في لوحتهم الإدارية. وهذا لا يمكن تجنّبه بالحذر؛ بل خاصية لنظامين يحملان حالة مرتبطة وبينهما شبكة، والسؤال الوحيد هل تعرف.

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

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

بيئتهم التجريبية ليست إنتاجهم

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

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

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

العقد يتغيّر بلا إشعار

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

والدفاع التحقّق من الواصل عند الحدّ والفشل بصوت عالٍ ومحدّد حين لا يطابق. فخطأ تحقّق يقول «خانة الحالة استلمت القيمة PENDING_REVIEW وهي ليست في المجموعة المعروفة» يحوّل جلسة تنقيح ثلاث ساعات إلى تشخيص ثلاثين ثانية، ويُسند التغيير للطرف الصحيح، وهو ما يهمّ حين يتطلّب الإصلاح تعاونهم.

وهناك حكمٌ داخل ذلك، وهو مدى صرامة التحقّق. فرفض قيمة تعداد غير معروفة يحمي بياناتك ويوقف التكامل؛ وقبولها وحملها يحمي التوفّر ويخاطر بقرار خطأ صامت في الأسفل. والجواب يختلف لكل خانة ويستحقّ التقرير بتعمّد — صرامة على ما يحرّك المال أو الأذونات، وتسامح على ما هو تزييني.

البيانات السرّية تنتهي بجدولهم

كل تكامل يحمل سرًّا له عمر، والعمر تحدّده الجهة الأخرى. فمفاتيح الواجهة تُدوَّر بسياستهم، ورموز التحديث تنتهي بعد فترة خمول، والشهادات لها تاريخ انتهاء كتبه أحد مرة، ومفاتيح التوقيع تتغيّر حين تقع حادثة عند المزوّد. وكلٌّ ينتج انقطاعًا يشبه تمامًا كون المزوّد معطّلًا، في تاريخ لم يضعه أحد في تقويم.

والتخفيف الرخيص مراقبة الانتهاء لا الطلب. فأي شيء بتاريخ نهاية معروف — شهادة أو مفتاح بفترة تدوير معلنة أو رمز بمطالبة وقت إصدار — يمكن فحصه بجدول والتحذير منه قبل أسبوعين، فيحوّل انقطاع أحدٍ إلى مهمة ثلاثاء. ويأخذ هذا ظهيرة للبناء وهو أعلى قطعة مراقبة تكامل مردودًا.

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

حدود المعدّل قيدٌ تصميمي

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

والحدّ مشترك عادةً

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

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

سجّل بما يكفي لحلّ خلاف

عاجلًا أو آجلًا يأتي نزاع تعتقد فيه أنك أرسلت شيئًا ويعتقد المزوّد أنك لم ترسل، ويُحلّ ذلك النزاع لمن يملك السجلّ. والسجلّ الذي يحلّه يحتوي الطلب كما أُرسل والرد كما استُلم والطابع الزمني الدقيق وأي معرّف ارتباط أصدره المزوّد. فبدون المعرّف تصف حادثة؛ وبه تستشهد بواحدة، ويستطيع فريق دعمهم البحث عنها.

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

• الطلب كما أُرسل، عبر قائمة سماح للخانات.
• حالة الرد ومتنه وتوقيته.
• معرّف الارتباط عندهم، محفوظًا قابلًا للبحث.
• مفتاح عدم التكرار الخاص بك للعملية نفسها.
• مدة حفظ وافق عليها أحد فعلًا.

يجب إخبار أحد

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

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

1. مهلة صريحة مختارة كقرار منتج.
2. طابور دائم بحدّ محاولات ورسائل ميتة.
3. مفتاح إزالة تكرار بمعرّف حدثهم حيث يُعرض.
4. حوض موارد منفصل، فيُحتوى بطؤهم.
5. تسوية يومية على رقم يحمله الجانبان.
6. تنبيه وشخص مسمّى يستلمه.

والنتيجة النافعة لسؤال هذه مبكرًا أن لبعضها جوابًا رخيصًا لميزة معيّنة. فإن كان التكامل إثراءً غير حرج — بحث شعار شركة مثلًا — فالفشل بصمت وإعادة المحاولة غدًا مقبول تمامًا، ومعرفة ذلك تتيح بناء النسخة البسيطة بقصد لا بالحذف. والخطأ المكلف ليس بناء النسخة البسيطة؛ بل بناؤها مع الاعتقاد أنك بنيت المتينة.