أحداث الخطأ

أحداث الـ Error تطرح الأعطال الموجَّهة للمستخدم حتى يصلحها الفريق قبل أن تُهدر الثقة. التصنيف مينيمالي عمداً — 5 أسماء أحداث تغطي كل نوع خطأ يستطيع المستخدم إدراكه. أخطاء الـ Backend فقط متعقَّبة منفصلةً في سجلّات الخادم.

أحداث الـ Error الخمسة

app_route_not_found

المستخدم وصل إلى 404. الخصائص: `attempted_path`، `referrer_class`، `locale`. يقود اكتشاف الروابط المكسورة + أولوية المحتوى المفقود.

app_route_error

خطأ server-side render (فشل Angular SSR). الخصائص: `error_message`، `route`، `locale`. يجب أن يكون 0 في deployments سليمة.

form_validation_error

فشل التحقّق من جهة العميل عند إرسال النموذج. الخصائص: `form_id`، `field_name`، `error_code` (required / format / range / consent_missing).

api_error

استدعاء API في الخلفية فشل (جلب بيانات، بحث، autosuggest). الخصائص: `endpoint`، `status_code`، `error_class`.

image_load_error

عنصر `<img>` فشل في التحميل. الخصائص: `image_url`، `surface`، `entity_id?`. يطلق SVG التحريري الاحتياطي (مثل أغلفة Founder File).

قواعد العيّنة

• كل 404 متعقَّبة (الحجم منخفض بما يكفي ليكون مفيداً في صيغته الخام).
• أحداث api_error متعقَّبة 100% خلال الـ 60 يوم الأولى من أي تكامل API جديد، ثم تنزل إلى عيّنة 10% بعد معرفة الـ Baseline.
• أحداث image_load_error بعيّنة 10% — عادة قضايا CDN تفشل في موجات، فالعيّنة تحفظ الإشارة دون فيضان.
• أحداث form_validation_error متعقَّبة 100% دائماً — إنها أكثر إشارة خطأ قابلة للفعل.