وثّق نقطة البداية

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

اجعل التخصيص مفهومًا

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

جرّب التحديث ببيانات ممثلة

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

اربط الإصدارات بمسؤوليات الدعم

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