الخلاصة المباشرة: نموذج بلاغ عطل برمجي: خطوات إعادة المشكلة والدليل
بلاغ العطل القابل للتحقيق يصف مشكلة واحدة بعنوان محدد، والبيئة والإصدار والحساب التجريبي، وخطوات قصيرة لإعادتها، والنتيجة المتوقعة والفعلية، ومعدل التكرار والأثر، مع دليل لا يكشف بيانات حساسة. بعد الإصلاح أعد نفس الخطوات وسجّل النتيجة؛ لا تجعل الاستعجال بديلًا عن المعلومات.
- منظومة الفاتورة والإيصال الإلكتروني: قانون الإجراءات الضريبية الموحد رقم 206 لسنة 2020
- حماية البيانات وحقوق الملكية: قانون حماية البيانات رقم 151 لسنة 2020 وحقوق الملكية رقم 82 لسنة 2002
- معايير إتاحة الويب والأنظمة: W3C Web Content Accessibility Guidelines (WCAG 2.2 AAA)
رسالة «السيستم مش شغال» مهمة لأنها تعلن أثرًا، لكنها لا تكفي لتحديد السبب. النموذج يقلل الأسئلة المتبادلة ويساعد الدعم على إعادة المشكلة وفرزها، من دون وعد بزمن حل قبل معرفة النطاق والأولوية.
مشكلة واحدة وعنوان يصف الأثر
اكتب فعلًا وموضعًا ونتيجة: «زر حفظ الطلب يعيد الشاشة دون إنشاء سجل» أفضل من «Bug مهم». افصل الأعطال غير المترابطة حتى يمكن تعيين مسؤول وحالة واختبار لكل واحد.
قبل البلاغ ابحث عن حالة مفتوحة مشابهة إن كانت لوحة المتابعة متاحة لك، وأضف معلومة جديدة بدل تكرارها. لا تغلق أو تغير بلاغ شخص آخر دون صلاحية.
ثبّت البيئة والإصدار والسياق
سجّل رابط البيئة، الإصدار أو وقت الملاحظة، الجهاز والنظام والمتصفح، ونوع الحساب والدور دون بيانات دخول. اذكر هل المشكلة في الإنتاج أم الاختبار وهل بدأت بعد تغيير معروف.
إذا كانت مرتبطة ببيانات معينة، أنشئ مثالًا مجهّلًا أو معرف اختبار. لا ترفق قاعدة بيانات أو رقم بطاقة أو كلمة مرور أو token داخل البلاغ أو الصورة.
اكتب خطوات قصيرة ونتيجة متوقعة وفعلية
ابدأ من حالة معروفة ثم رقّم الأفعال التي يستطيع شخص آخر تنفيذها. بعد آخر خطوة اكتب ما توقعت حدوثه وما حدث فعلًا بالنص الظاهر أو تغير الحالة.
اذكر هل يتكرر دائمًا أو أحيانًا وعدد المحاولات الناجحة والفاشلة ضمن عينة صغيرة. «أحيانًا» بلا سياق قد يخفي فرق شبكة أو صلاحية أو بيانات.
افصل شدة الأثر عن أولوية التنفيذ
الشدة تصف أثر العطل التقني أو التشغيلي: توقف كامل، فقد بيانات، وظيفة أساسية معطلة، أو مشكلة شكلية. الأولوية قرار يجمع الشدة وعدد المتأثرين ووجود بديل والتزامات العمل.
لا تصف كل مشكلة بالحرجة لتصل أسرع؛ هذا يضعف الفرز عند الطوارئ. اذكر البديل المؤقت ومخاطره إن وجد، وصاحب قرار استمرار استخدامه.
أرفق دليلًا آمنًا وقابلًا للقراءة
الصورة أو الفيديو يوضحان اللحظة لكن لا يستبدلان الخطوات. قص ما لا يلزم واطمس البيانات، وأرفق سجلًا أو رسالة خطأ فقط عبر قناة يحددها المختص وبأقل معلومات لازمة.
اذكر وقت الحدث والمنطقة الزمنية ومعرف طلب غير حساس ليسهل البحث في السجلات. لا تنشر تفاصيل أمنية أو مفاتيح في لوحة عامة؛ استخدم مسار الإفصاح أو الدعم المتفق عليه.
أعد الاختبار وأغلق بالدليل
بعد إعلان الإصلاح استخدم نفس البيئة والخطوات والبيانات التجريبية، ثم اختبر حالة مجاورة قد تتأثر. سجل الإصدار والنتيجة، وافتح متابعة منفصلة إذا ظهرت مشكلة مختلفة.
حمّل النموذج أدناه. إرشادات GitHub لكتابة البلاغات توصي بمعلومات واضحة تساعد إعادة المشكلة؛ سياسات الأولوية وزمن الاستجابة يحددها عقد الدعم ونطاقه.
أسئلة شائعة
هل تكفي لقطة شاشة؟+
ما الفرق بين الشدة والأولوية؟+
ماذا أرسل إذا كان العطل يحتوي بيانات حساسة؟+
روابط ومصادر ذات صلة
دراسات معمارية ومقارنات تفصيلية مرتبطة
اربط قرارك البرمجي بالدراسات المعمارية المعتمدة ومصفوفات مقارنة تكلفة الملكية (TCO) لـ 3 سنوات.
تحليل تكلفة الملكية لـ 36 شهراً ونقاط التعادل المالي.
دراسة معماريةمعمارية العمل دون اتصال SQLite WASMتوثيق برمجي لحالات القبول ومزامنة البيانات اللحظية.
أداة قياس تفاعليةحاسبة تكلفة الملكية الإجمالية TCOاحسب تكلفة البرمجة المخصصة مقابل اشتراكات الـ SaaS.
محتاج مساعدة في مشروعك؟
ناقش متطلبات المشروع، ثم اتفق على نطاق مكتوب وتكلفة وموعد إرسال العرض بعد اكتمال المعلومات.
جهّز طلب المشروع