من الاختبار إلى الإنتاج: قائمة التبديل

تُفتح بيئة الاختبار (السندبوكس) فورًا: لا يتطلب ابدؤوا في وضع الاختبار أي موافقة مسبقة، ويبقى الولوج مجانيًا وبلا حدّ زمني. ويُفعَّل الإنتاج على حسابكم بعد التحقق من شركتكم. وبينهما مفتاح واحد يُبدَّل — عنوان قاعدة واحد ومفتاحان: أما العناوين والحمولات ورموز الأخطاء فهي نفسها.

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

ما يجب أن يكون صحيحًا قبلها

معالج الويب هوك لديكم يتحقق من التوقيع. على الجسم الخام، قبل أي تحليل. وإن لم تختبروه بحدث اختبار، فأنتم لم تختبروه.

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

عمليات الإنشاء لديكم ترسل مفتاح Idempotency. مشتقًّا من مرجع طلبكم أنتم، لا من سحب عشوائي.

تسجّلون `correlationId`. يُعاد في كل استجابة، بما فيها الناجحة. وهو ما سيطلبه الدعم، وهو ما يحوّل تحقيقًا ليوم كامل إلى بحث في ثلاثين ثانية.

مفاتيحكم في خزنة أسرار. لا في المستودع، ولا في ملف إعدادات مُودَع، ولا في رسالة على قناة الفريق. والقواعد كاملة في حماية مفاتيح الواجهة.

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

تجربة اشتراك في بيئة الاختبار

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

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

يوم التبديل

تغيّرون المفتاح. لا غير.

وإن لم يكن الإنتاج مفعّلًا بعد على حسابكم، فسيتلقى مفتاح الإنتاج رمز 403 صريحًا بالرمز PRODUCTION_ACCESS_NOT_ENABLED — وهذا ليس خللًا في الدمج، بل خطوة إدارية: التحقق من الشركة ورسوم التفعيل التي تُؤدّى مرة واحدة عند الانتقال إلى الإنتاج.

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

الإغفالات الكلاسيكية الثلاثة

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

مبالغ الاختبار في الكود. amount: 100 بقي من تجربة، خصم استعراضي، سقف مصطنع: أعيدوا قراءة كل ما يمسّ المبلغ بسؤال «من أين جاء هذا الرقم؟». في الإنتاج، يجب أن يأتي كل رقم من قاعدتكم، لا من ملف أبدًا.

عناوين البريد وروابط التطوير. عنوان الإشعار الذي ما يزال يشير إلى بريد المطوّر، ورابط العودة إلى localhost: بيئة الاختبار تغفر، والإنتاج يفضح. البحث في الإعدادات عن localhost وtest@ و.dev يستغرق دقيقتين.

فصل البيئتين، على الدوام

الانتقال إلى الإنتاج ليس هجرة بل فصل: تبقى بيئة الاختبار قائمة، وهي أفضل أداة لما بعده.

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

عمليًا: مجموعتا متغيرات بيئة لا تختلطان في ملف واحد؛ ومفاتيح مسماة حسب البيئة في مدير الأسرار؛ ومنع تقني — لا ثقافي فحسب — لنداء واجهة الإنتاج من جهاز تطوير.

الأسبوع التالي

انظروا إلى ثلاثة أمور كل يوم لمدة أسبوع:

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

يُعرَف مسار التحصيل الناجح بهذا: لم يعد أحد يتحدث عنه.

الخطوة التالية

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