كيف تكتب تقرير خلل يفهمه المطوّر من أول مرة؟

لماذا يكلّفك البلاغ الغامض أياماً؟

أشهر بلاغ في العالم جملة واحدة: «الموقع ما يشتغل». صاحبها يرى المشكلة أمامه بوضوح، فيظن أن الجملة تكفي. لكن من يقرؤها لا يرى شاشتك، ولا يعرف أي صفحة تقصد، ولا ماذا ضغطت قبلها، ولا على أي جهاز كنت.

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

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

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

الأجزاء السبعة لتقرير الخلل الجيد

1. 1
   اكتب عنواناً يقول ماذا وأين

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

2. 2
   اذكر الأثر على العمل في جملة

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

3. 3
   حدّد الظرف: الصفحة والجهاز والحساب والوقت

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

4. 4
   رقّم خطوات إعادة الخلل من بداية نظيفة

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

5. 5
   اكتب المتوقّع، ثم الفعلي

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

6. 6
   أرفق الدليل

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

7. 7
   قل كم مرة يتكرّر

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

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

قالب تقرير خلل جاهز للنسخ

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

مثال: تقرير ضعيف نعيد كتابته

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

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

هذا السيناريو بالذات مشروح بالتفصيل في صفحة مهندس الجودة للمطاعم وأنظمة الحجز: كيف يُكتشف قبل أن يكتشفه الضيوف.

الخطورة أم الأولوية؟ وكيف تحدّدهما دون مبالغة

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

متى تختلف الأولوية عن الخطورة؟ خطأ إملائي في اسم علامتك التجارية على الصفحة الرئيسية خطورته منخفضة، لكنك قد تريده مُصلَحاً قبل حملة الغد، فأولويته عالية. وخلل حرج في تقرير سنوي لا يفتحه أحد قبل نهاية السنة قد ينتظر أسبوعاً.

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

خلل واحد في كل تقرير، وبلا تكرار

قائمة من خمس مشكلات في رسالة واحدة تبدو أسرع، لكنها أبطأ. تُصلَح ثلاث وتُنسى اثنتان، ولا يعرف أحد هل «تم» تعني الخمس كلها. تقرير لكل خلل يعني أن لكل خلل حالة تتابعها وحده: مفتوح، قيد الإصلاح، مُصلَح.

كيف تتأكد أنه لم يُبلَّغ عنه من قبل؟

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

«يعمل على جوالي» لا تعني أنه ليس خللاً

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

ما الذي لا تضعه في تقرير الخلل؟

التقرير يُنسخ ويُحوَّل ويبقى في المحادثات سنوات. عامله كأنه سيُقرأ ممّن لا تعرفه:

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

ماذا يحدث بعد أن ترسل التقرير؟

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

1. جديد: وصل البلاغ ولم يراجعه أحد بعد.
2. مؤكَّد: أعاد أحدهم الخطوات ورأى الخلل بعينه. من هنا يبدأ العمل الحقيقي.
3. قيد الإصلاح: يعمل أحدهم على السبب.
4. جاهز لإعادة الاختبار: يقول المطوّر إنه أصلحه. هذا ادّعاء، وليس نتيجة بعد.
5. تم التحقق من الإصلاح: أُعيدت الخطوات نفسها ونجحت. الآن فقط يُغلق.

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

«مُصلَح» تعني أن أحداً أعاد الخطوات نفسها ونجح، لا أن أحداً ضغط «تم».

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

أخطاء شائعة في تقارير الأخطاء

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

كيف يكتب مهندس الجودة في فنّان هذه التقارير؟

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

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

وبصراحة عن الحدود: مهندس الجودة يختبر المواقع وتطبيقات الويب في متصفح حقيقي، ويفحص الـ API. في التطبيقات المبنية بفنّان يستطيع أن يسلّم الخلل إلى بنّاء فنّان ليصلحه ثم يعيد الاختبار. أما في المواقع المبنية خارج فنّان فيعطيك الخطوات والسبب المرجَّح، ولا يغيّر كودها، وتقريره جاهز لترسله إلى مطوّرك كما هو. وهو يختبر ما اتفقتما على اختباره، فجولة ناجحة لا تعني أن التطبيق خالٍ من الأخطاء. والميزة ضمن الخطط المدفوعة.

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

أسئلة شائعة