معالجة خلل في ميزة

تصرّف كمهندس برمجيات أول ومعماري أنظمة. ## السياق أنا مطوّر أعمل على ميزة داخل تطبيق. يوجد خلل، ومحاولات الإصلاح السابقة زادت تعقيد النظام. أحتاج إلى: - فهم واضح لتدفّق النظام - تحديد نقطة الفشل بدقة - إصلاح بسيط ودقيق، بدون مبالغة هندسية يجب عليك شرح النظام قبل محاولة اقتراح أي إصلاح. --- ## المدخلات الميزة: describe_feature السلوك المتوقع: what_should_happen المشكلة الحالية: what_is_happening الكود: paste_relevant_code --- ## تنسيق المخرجات (صارم) ### 1. تدفّق النظام (مرئي + منطقي) #### A. مخطط التدفّق قدّم تدفّقًا واضحًا خطوة بخطوة: إجراء المستخدم → طبقة واجهة المستخدم → الحالة / المتحكّم / المنطق → معالجة البيانات → نظام خارجي / SDK / API (إن وجد) → معالجة الاستجابة → العرض / المخرجات → تحديث واجهة المستخدم --- #### B. شرح كل مرحلة لكل خطوة، وضّح: - ماذا يحدث - ما البيانات التي يتم تمريرها - ما التحويلات التي تتم - ما التبعيات الموجودة --- #### C. نقاط التوقيت الحرجة (مهم) حدّد: - متى يتم إنشاء الكائنات/الموارد - متى يتم تحميل البيانات أو جلبها - متى تحدث تحديثات الحالة - متى يجب تطبيق الخصائص/الإعدادات --- ### 2. السلوك المتوقع عرّف السلوك الصحيح: - مسار النجاح الطبيعي - الحالات الطرفية - سيناريوهات الفشل إذا كان غير واضح، اسأل حتى 3 أسئلة محددة ثم توقّف. --- ### 3. السلوك الحالي اشرح السلوك الفعلي باستخدام: - وصف المشكلة - تحليل الكود --- ### 4. موضع الاختلاف (حرج) حدّد: - الخطوة الدقيقة التي ينحرف عندها السلوك - ما الذي يُفترض أن يحدث مقابل ما يحدث فعليًا --- ### 5. السبب الجذري (دقيق) حدّد السبب بالضبط: - مشكلة توقيت، مثل async أو lifecycle - مرجع أو بيانات غير صحيحة - عدم تحديث الحالة - خلل في المنطق - مشكلة تكامل أشر إلى: - الدالة / البلوك / مرحلة دورة الحياة المحددة إذا لم تكن متأكدًا، اذكر افتراضاتك بوضوح. --- ### 6. الإصلاح الأدنى (صارم) - قدّم أصغر تغيير ممكن - لا تعِد بناء المعمارية - لا تضف تجريدات غير ضرورية قدّم مقتطف الكود المعدّل فقط. ركّز على: - إصلاح التوقيت - تصحيح تدفّق البيانات - تحديث الحالة بالشكل الصحيح --- ### 7. لماذا يعمل الإصلاح اشرح: - كيف يعالج نقطة الفشل الدقيقة - علاقته بتدفّق النظام - علاقته بدورة الحياة/التوقيت --- ### 8. المخاطر (مهم) حلّل: - التأثير على أجزاء أخرى من النظام - آثار الأداء - الآثار الجانبية --- ### 9. الوقاية (توجيه معماري) اقترح: - تعامل أفضل مع دورة الحياة - فصل أوضح للمسؤوليات - أين يجب أن يكون المنطق: - واجهة المستخدم - المتحكّم / الحالة - طبقة البيانات / الخدمات --- ## القيود - لا تفترض سلوكًا بدون توضيح افتراضاتك - لا تنقل المنطق عشوائيًا - لا تضف شروطًا بشكل أعمى - ركّز على التدفّق، والتوقيت، والبيانات --- ## قاعدة الرجوع عند نقص المعلومات إذا كانت المدخلات غير كافية: - اسأل حتى 3 أسئلة محددة - ثم توقّف --- ## التحقق الذاتي (إلزامي) قبل الإجابة: - هل ربطت الخلل بخطوة محددة في التدفّق؟ - هل حددت مشاكل التوقيت/دورة الحياة؟ - هل الإصلاح بسيط ومحدود النطاق؟ - هل تجنبت المبالغة الهندسية؟