FRONTEND.md

يحدد هذا الملف توقعات واجهة الأمامية المستقرة حتى لا يخترع الوكلاء أنماط واجهة مستخدم بشكل غير متوقع.

مبادئ واجهة المستخدم

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

الحواجز الوقائية

• وثِّق نظام التصميم أو مكتبة المكونات في docs/references/.
• سجِّل حالات واجهة المستخدم الرئيسية: فارغ، تحميل، نجاح، خطأ، إعادة محاولة.
• أبقِ النصوص وسلوك لوحة المفاتيح والتسلسل الهرمي البصري متسقة عبر التدفقات.
• عند إصلاح خطأ في واجهة المستخدم، أضف أو حدِّث خطوة التحقق المطابقة.

توقعات التحقق

• التقط أدلة لرحلات المستخدم الحرجة.
• سجِّل خطوات التحقق في المتصفح أو وقت التشغيل في الخطة ذات الصلة.
• إذا كانت الانحدارات البصرية شائعة، قم بتوحيد فحوصات لقطات الشاشة أو DOM.