البناء والتصحيح

حلقة البناء-الاختبار-التصحيح

أرسلت الـ PRD المصغّر، وولّد الذكاء الاصطناعي أساس تطبيقك. تبدأ الآن المرحلة الأطول — والأكثر تكوينًا — في المشروع: البناء التكراري. الإيقاع هو نفسه دائمًا: تطلب شيئًا واحدًا، ينفّذه الذكاء الاصطناعي، تختبر فورًا، وحسب النتيجة تصادق أو تصحح. ثم تعيد مع الشيء التالي.

قد يبدو هذا الإيقاع بطيئًا مقارنة بإغراء طلب كل شيء دفعة واحدة. لكنه في الواقع أسرع بكثير على المدى الطويل، لسبب بسيط: عند ظهور خطأ، تعرف بالضبط أي طلب أدخله — الأخير. بدون هذا الانضباط، قد يأتي الخطأ من أي من طلباتك الخمسة الأخيرة، وستقضي في البحث عن المذنب وقتًا أطول من تصحيحه.

flowchart LR
  D["اطلب شيئًا واحدًا"] --> G["الذكاء الاصطناعي يولّد"]
  G --> T["اختبر فورًا"]
  T -->|"يعمل"| V["صادِق وانتقل للتالي"]
  T -->|"ينكسر"| E["انسخ الخطأ الحرفي"]
  E --> C["اطلب التصحيح"]
  C --> T
  V --> D

اختبار كل مرحلة: قائمتك المرجعية

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

اعتد أيضًا اختبار الحالات الحدّية — فهناك تختبئ الأخطاء: ماذا يحدث إن أضفت عادة باسم فارغ؟ إن أضفت عشرين؟ إن نقرت مرتين بسرعة كبيرة؟ لست بحاجة إلى الشمولية، لكن محاولتين أو ثلاثًا «خارج المألوف» لكل ميزة تكشف الهشاشة قبل مستخدميك.

• اختبر الحالة العادية: هل يعمل الإجراء الرئيسي؟
• أعد تحميل الصفحة: هل البيانات لا تزال موجودة؟
• اختبر حالة حدّية: حقل فارغ، قيمة غريبة، نقر مزدوج.
• تحقق على الهاتف (أو بتضييق النافذة) إن كان تطبيقك mobile-first.

وحدة تحكم المتصفح: حليفك الأفضل

عندما ينكسر شيء دون تفسير ظاهر، تكون الإجابة دائمًا تقريبًا في وحدة تحكم المتصفح (console). اضغط F12 (أو نقرة يمنى ← «فحص/Inspecter»)، ثم افتح تبويب «Console». هناك يكتب المتصفح الأخطاء: أسطر حمراء، غالبًا بالإنجليزية، تشير إلى ما فشل وأين.

لست بحاجة لفهم هذه الرسائل — تحتاج فقط لنسخها. إليك شكل خطأ نموذجي:

Uncaught TypeError: Cannot read properties of null (reading 'addEventListener')
    at app.js:24:18

ترجمة حرة: «في السطر 24 من الملف app.js، يحاول الكود استخدام شيء غير موجود». هذا بالضبط نوع الدليل الذي يحتاجه الذكاء الاصطناعي للتصحيح برسالة واحدة بدل خمس. أخطاء شائعة ستصادفها: TypeError (الكود يتعامل مع قيمة من النوع الخطأ)، ReferenceError (يستخدم اسمًا غير موجود)، SyntaxError (الكود نفسه مكتوب بشكل خاطئ)، و404 Not Found (ملف لا يمكن العثور عليه).

موجّه التصحيح المثالي

عندما ينكسر شيء، لا تقل «لا يعمل». الذكاء الاصطناعي لا يملك أي وسيلة لتخمين ما تراه على الشاشة. تقرير الخطأ الجيد يحتوي أربعة عناصر: ما كنت تفعله، ما كنت تتوقعه، ما حدث بدلًا من ذلك، ورسالة الخطأ الحرفية من وحدة التحكم. بهذه المعلومات الأربع، يكون التشخيص فوريًا تقريبًا.

خطأ يجب تصحيحه.
ما كنت أفعله: أنقر على «إضافة عادة» بعد كتابة «قراءة» في الحقل.
ما كنت أتوقعه: تظهر العادة في القائمة.
ما يحدث: لا شيء يظهر، والحقل يُفرَغ.
الخطأ في وحدة التحكم: Uncaught TypeError: Cannot read properties of null (reading 'addEventListener') at app.js:24:18
شخّص السبب وصحح، مع شرح بسيط لما كان خاطئًا.

لاحظ الجملة الأخيرة: «مع شرح بسيط لما كان خاطئًا». إنها التي تحوّل كل خطأ إلى درس. بعد عشرة تصحيحات، ستتعرف بنفسك على الأخطاء الشائعة — وستكتب طلبات تتجنبها من البداية.

عندما يدور الذكاء الاصطناعي في حلقة مفرغة

يحدث هذا: تبلّغ عن خطأ، «يصحح» الذكاء الاصطناعي، الخطأ لا يزال هناك، «يصحح» مجددًا، ولا شيء يتغير — أو أسوأ، ينكسر شيء آخر. بعد محاولتين أو ثلاث فاشلة، توقف عن الإصرار على الطريق نفسه. ثلاث استراتيجيات فعالة: اطلب من الذكاء الاصطناعي البدء من الصفر في هذه الميزة («احذف كل كود التقويم وأعد بناءه بشكل أبسط»)، أو اطلب منه إضافة رسائل تشخيص («أضِف console.log لنرى أين يتعطل»)، أو أعد صياغة طلبك الأولي بالكامل، فربما كان غامضًا.

تذكّر أيضًا الخيار النووي: العودة إلى آخر نسخة كانت تعمل والانطلاق من هناك. هذا بالضبط دور Git، الذي نتحدث عنه حالًا — شبكة أمان تجعل التجارب بلا مخاطر.

الحفظ مع Git: شبكة أمانك

Git هو الأداة التي يستخدمها كل المطورين لحفظ تاريخ المشروع. الفكرة تتلخص في صورة: عند كل مرحلة تعمل، تأخذ «صورة» (commit أي حفظة) لمشروعك. إن ساءت تجربة ما، تعود إلى آخر صورة في لحظة. لم تعد بحاجة للخوف من الكسر: كل شيء قابل للتراجع.

إن كنت على أداة في المتصفح (Lovable أو v0 أو Bolt)، خبر سار: معظمها يدير تاريخ النسخ نيابة عنك — ابحث عن قائمة «History» أو «Versions» وحدد كيفية استعادة حالة سابقة. وإن كنت على Cursor أو Claude Code، اطلب ببساطة من الذكاء الاصطناعي القيام بالحفظات (commits) نيابة عنك، أو تعلّم الأوامر الثلاثة الأساسية:

# عند كل مرحلة تعمل، خذ صورة للمشروع:
git add .
git commit -m "Ajout d'habitude fonctionne"

# لرؤية تاريخ صورك:
git log --oneline

الإيقاع الصحيح: حفظة (commit) بعد كل ميزة مختبَرة ومصادَق عليها. رسالة الحفظة تصف ما يعمل («التأشير اليومي OK»، «التقويم معروض»). يكتسب توم هذه العادة منذ المساء الأول — ويوم تكسر تجربة تصميم كل تخطيط صفحته، يعود إلى الوراء في ثلاثين ثانية بدل إعادة بناء كل شيء.

التقدم بخطوات صغيرة آمنة

ميزة مختبَرة وتعمل = نقطة ارتكاز صلبة. أنت تبني على المستقر، لا على الرمال. هذا ما يجنّب أثر «كل شيء معطّل ولا أعرف لماذا» الذي يثبّط كثيرًا من المبتدئين. التسلسل الكامل عند توم لكل ميزة: الطلب ← الاختبار ← التصحيح عند الحاجة ← الحفظ (commit) ← الانتقال للتالية.

لهذه المنهجية أثر جانبي ثمين: الثقة. كل خطوة صغيرة مصادَق عليها انتصار ملموس، والحماس يتغذى على الانتصارات. في نهاية الفصل، يفعل تطبيق توم كل ما خططته نسخته الأولى — الإضافة، الحذف، التأشير اليومي، السلسلة (streak) — وكل لبنة تم التحقق منها. إنه جاهز للنشر.