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