[ OMNI CODE ]
عالق أمام خطأ
لا تفهمه؟
الصق الخطأ، فيشرحه لك فريق متكامل من الوكلاء بكلمات بسيطة، ثم يصلحه ويختبره وينشره.
- يُشرح بكلمات بسيطة
- يُصلَح في كل الطبقات
- يُختبر قبل النشر
-
لوحة التحكم لديّ تتعطّل:
TypeError: Cannot read properties of undefined (reading 'map') - المخطِّط أعدتُ صياغة طلبك في خطة واضحة
- تكرار التعطّل في صفحة لوحة التحكم
- العثور على السبب الجذري
- إصلاحه وشرحه بكلمات بسيطة
- اختباره، ثم نشر معاينة
-
مصحّح الأخطاء تم العثور على السبب الجذري
src/Dashboard.jsx:14 -
لا تزال
ordersغير معرّفة عند العرض الأول: البيانات لم تصل بعد. -
بكلمات بسيطة
حاولت صفحتك عرض طلبياتك قبل أن تُحمَّل. الآن تنتظرها، وتعرض قائمة فارغة ريثما تصل.
-
الواجهة الأمامية تم تطبيق الإصلاح
src/Dashboard.jsx -
13
const { data } = useOrders();14−const rows = data.orders.map(toRow);14+const rows = (data.orders ?? []).map(toRow); - الواجهة الخلفية أصبحت واجهة API للطلبيات تُرجع قائمة فارغة بدلًا من لا شيء.
-
api/orders.js22−return rows.length ? rows : null;22+return rows; -
ضمان الجودة جارٍ تشغيل الاختبارات
omni test dashboard - لوحة التحكم تُعرض دون طلبيات
- لوحة التحكم تعرض قائمة طلبيات
- واجهة API للطلبيات تُرجع قائمة دائمًا
- نجحت كل الاختبارات
- تم نشر المعاينةأُصلح وشُرح واختُبر — من طلب واحد.
[ الجدار ]
كل من يبرمج بالوصف يصطدم بهذا الجدار.
بنيت شيئًا يكاد يعمل. ثم تظهر رسالة حمراء كأنها مكتوبة بلغة أخرى. إليك ما تعنيه فعلًا — وما يفعله Omni Studio حيالها.
-
TypeError ما تقوله
Cannot read properties of undefined (reading 'map')ما تعنيه
استخدمت صفحتك البيانات قبل وصولها.
ما يفعله Omni Studioينتظر البيانات، ويُظهر حالة تحميل، ثم يعرض الصفحة.
-
CORS ما تقوله
Access to fetch has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is presentما تعنيه
لم يأذن خادمك بعد لموقعك بالتواصل معه.
ما يفعله Omni Studioيأذن لعنوان موقعك على الخادم — ولا شيء غيره.
-
HTTP 500 ما تقوله
500 Internal Server Errorما تعنيه
تعطّل شيء ما على الخادم، والصفحة لا تستطيع أن تخبرك بما هو.
ما يفعله Omni Studioيقرأ سجلات الخادم، ويحدّد السطر المعطوب، ويصلحه.
-
Module ما تقوله
Error: Cannot find module './utils/format'ما تعنيه
الشيفرة تبحث عن ملف ليس في المكان الذي تتوقعه.
ما يفعله Omni Studioيصحّح المسار، أو يثبّت الحزمة الناقصة.
-
Hydration ما تقوله
Hydration failed because the server rendered HTML didn't match the clientما تعنيه
رسم الخادم والمتصفح نسختين مختلفتين من صفحتك.
ما يفعله Omni Studioيجعل الطرفين يعرضان الشيء نفسه، كالتواريخ والقيم العشوائية.
-
Build ما تقوله
Build failed with 1 error: Unexpected tokenما تعنيه
سطر واحد يمنع تجهيز تطبيقك للإصدار.
ما يفعله Omni Studioيحدّد السطر بدقة، ويصلحه، ثم يعيد تشغيل البناء.
[ ما يحدث بعد ذلك ]
ما يحدث حين تلصق خطأً.
رسالة واحدة تدخل، ثم يتولّاها فريق من الوكلاء، لكلٍّ منهم خطوة، حتى يعود تطبيقك إلى العمل.
ما تلصقه
TypeError: Cannot read properties of undefined (reading 'map')
-
يتولّاها المخطِّط
الفهم
يعيد صياغة رسالتك في موجز دقيق: ما توقّعته، وما حدث، وأين.
-
يتولّاها ضمان الجودة
تكرار الخطأ
يشغّل مشروعك ويستدعي الخطأ عمدًا، ليقوم الإصلاح على دليل لا على تخمين.
-
يتولّاها مصحّح الأخطاء
إيجاد السبب الجذري
يتتبّع الخطأ حتى السطر الذي تسبّب فيه، ويشرحه بكلمات بسيطة.
-
يتولّاها الواجهة الأمامية · الخلفية
إصلاح كل الطبقات
يغيّر ما يلزم تغييره — الواجهة أو الخادم أو قاعدة البيانات — ليصمد الإصلاح في كل مكان.
-
يتولّاها ضمان الجودة
الاختبار والنشر
يشغّل الاختبارات، ويتأكد من زوال الخطأ، وينشر معاينة لتوافق عليها.
ما تحصل عليه
تطبيق يعمل، واختبارات تثبت ذلك، وملخّص بلغة بسيطة لما تغيّر.
[ تعلّم وهو يُصلح ]
تعلّم وهو يُصلح.
كل إصلاح درسٌ لم تضطر إلى التسجيل فيه. يشرح لك Omni Studio السبب، بالمستوى الذي تختاره.
-
شروح على قدر مستواك
مبتدئ أو متوسط أو خبير: اختر العمق الذي تريده، وغيّره متى شئت.
-
القرار بيدك
يُعرض عليك كل تغيير قبل نشره. اسأل عن السبب، وعدّله، ثم وافق على ما يُنشر.
-
كل تغيير مشروح
يأتي كل تعديل مع ما كان خاطئًا، وما تغيّر، ولماذا — بكلمات بسيطة.
لماذا هذا التغيير
حاولت صفحتك عدّ ما في السلة قبل أن تُحمَّل السلة. الآن تنتظر، وتعرض صفرًا حتى تصل البيانات.
عند العرض الأول تكون cart.items غير معرَّفة بعد، لأن طلب الشبكة لم يكتمل. وتمنع قيمة احتياطية آمنة تعطّل الصفحة أثناء التحميل.
يُعرَض المكوّن قبل أن تُحسَم الحالة غير المتزامنة. ويزيل التسلسل الاختياري مع قيمة احتياطية من مصفوفة فارغة حالةَ التسابق، دون إضافة فرع تحميل منفصل.
[ كل الطبقات ]
الواجهة والخادم. من الألف إلى الياء.
نادرًا ما تبقى الأخطاء في مكان واحد. يعمل وكلاء Omni Studio عبر كل طبقات تطبيقك، كي لا يُفسد إصلاحٌ في موضع شيئًا في موضع آخر.
-
الواجهة الأمامية
ما يراه الناس وينقرون عليه.
- التخطيط
- الاستمارات
- الحالة
- سهولة الوصول
-
الواجهة الخلفية
المنطق وراء كل إجراء.
- المسارات
- منطق العمل
- مهام الخلفية
-
قواعد البيانات
حيث تُحفظ بياناتك.
- المخططات
- الاستعلامات
- الترحيلات
-
واجهات API
كيف يتواصل تطبيقك مع الخدمات الأخرى.
- الطلبات
- Webhooks
- التكاملات
-
المصادقة
من يدخل، وماذا يمكنه أن يفعل.
- التسجيل
- الجلسات
- الأدوار
-
النشر
الإطلاق للعلن، بأمان.
- عمليات البناء
- البيئات
- المعاينات
[ الأسئلة الشائعة ]
أسئلتك، وإجاباتها.
أول ما يسأل عنه من يبرمجون بالوصف.
هل أحتاج إلى معرفة البرمجة؟
لا. صِف ما تريده، أو الصق الخطأ كما تراه تمامًا. يشرح لك الوكلاء ما الذي حدث بما يناسب مستواك، وأنت تقرّر ما تطبّقه. معرفة شيء من البرمجة تساعدك على الذهاب أبعد، لكنها ليست شرطًا.
هل يعمل على مشروعي الحالي؟
نعم. أحضر مشروعك كما هو والخطأ الذي يظهر لك. يقرأ الوكلاء شيفرتك، ويعيدون إظهار المشكلة، ويقترحون تغييرات تنسجم مع طريقة بناء مشروعك.
هل سيشرح ما غيّره؟
دائمًا. يأتي كل تغيير مع شرح بلغة بسيطة: ما كان خاطئًا، وما تغيّر، ولماذا. ويمكنك طرح أسئلة إضافية حتى يتضح لك الأمر.
بأي اللغات يمكنني التحدث إليه؟
يتواصل Omni Studio بلغات كثيرة. اكتب باللغة التي ترتاح إليها أكثر، وستصلك الشروح بها.
هل لديك سؤال آخر؟ تحدّث إلينا
[ خطؤك التالي ]
الصق الخطأ.
ونحن نتولّى الباقي.
يُشرح بكلمات بسيطة، ويُصلَح في كل الطبقات، ويُختبر ويُنشر — باللغة التي تتحدث بها.
ابدأ بالخطة المجانية، وارتقِ بخطتك متى احتجت إلى المزيد.