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