اختبارات حالات الخطأ

الـ QC لحالات الخطأ يُتحقَّق أن كل وضع فشل — خطأ شبكة، 404، 500، رفض تحقّق، رفض إذن — يَرسم حالة خطأ موثَّقة صحيحة-المحلّية، قابلة للاسترداد (تُقَدِّم خطوة تالية)، ولا تُسَرِّب stack traces خام أبداً. المنصّة لها خمسة تخطيطات خطأ قياسية؛ كل سطح خطأ يجب أن يَستخدم واحداً منها.

تخطيطات الخطأ القياسية الخمسة

404 not-found

يُستخدم حين slug/id لا يُحَلَّ. التخطيط: رسم توضيحي 404 كبير + "Page not found" + اقتراحات ("Back to home"، "Search the calendar"). يُرجع HTTP 404 — ليس 200 مع UI 404.

500 server-error

يُستخدم حين SSR أو استدعاء API يَفشل غير-متوقّع. التخطيط: اعتذار + CTA إعادة المحاولة + رابط لصفحة الحالة لو ينطبق. لا stack trace مرئي للمستخدم. يُرجع HTTP 500.

خطأ نموذج inline

يُستخدم لرفض التحقّق. يَرسم مباشرة أسفل الإدخال المُخالف، بنصّ أحمر، مع تعليمات واضحة ("Email must contain @"). الصفحة لا تَتحمَّل ثانيةً.

خطأ toast / banner

يُستخدم للفشل العابر (submit فشل، شبكة blip). يَرسم في الزاوية العلوية اليمنى (العلوية اليسرى تحت RTL)، يَنصرف تلقائياً بعد 5s، يَشمل إغلاق يدوي + فعل إعادة محاولة لو ينطبق.

صفحة رفض-الإذن

يُستخدم حين مستخدم مُسَجَّل دخوله يُحاول الوصول لمسار لا يَملك إذن دور له. يُرجع HTTP 404 لتجنّب تَسريب أن الـ URL موجود (ليس 403 — انظر أمن مسار admin).