المنهجية كاملة، من البداية إلى النهاية
التصغير: نسخة عطلة نهاية الأسبوع
قدّمت لك هذه الدورة منهجية على أجزاء. ولنختم، لنأخذ فكرة واحدة عبر المنهجية كلها، من البداية إلى النهاية. الفكرة متواضعة عن قصد: صفحة حجز لصالون حلاقة في عمّان. ولنكن واضحين بشأن طبيعتها — إنها مثال تطبيقي وأداة تعليمية. لم يبنها أحد، ولا يظهر فيها زبائن حقيقيون، ولا تُدّعى لها أي نتائج. مشروعك سيبدو مختلفًا في كل خطوة؛ المنهجية هي ما ينتقل. تصل الفكرة الكاملة كما تصل الأفكار الكاملة دائمًا: حسابات للزبائن، ودفع إلكتروني، وتذكيرات برسائل نصية، وبرنامج ولاء، وتطبيق جوال. هذا عمل سنة. وخطوة الوحدة الأولى هي إيجاد الجملة الواحدة ذات الفعل الواحد: «يختار الزبون موعدًا متاحًا، ويصل الحلّاق بريد إلكتروني.» ثم اختبار عطلة نهاية الأسبوع مكتوبًا: «صفحة يختار فيها الزبون موعدًا متاحًا فيصلني بريد إلكتروني. أول المستخدمين هم زبائن الخميس الدائمون. وستعلّمني هل سيحجز الناس عبر الإنترنت أصلًا.» ثلاث جمل، ومستخدم أول واحد، وشيء واحد نتعلّمه. كل ما عدا ذلك يُحذف، أو يُنجز يدويًا.
- مثال تطبيقي، لا قصة إطلاق حقيقي — لا تُدّعى أي آراء أو أرقام
- الفكرة الكاملة: حسابات، ودفع، وتذكيرات، وبرنامج ولاء، وتطبيق — عمل سنة
- الجملة الواحدة: «يختار الزبون موعدًا متاحًا، ويصل الحلّاق بريد إلكتروني»
- الدفع يصبح فاتورة تُرسل يدويًا؛ والتذكيرات تصبح ملاحظة في التقويم
وصف المتطلبات وأول دورة بناء
تقول الوحدة الثانية: أجب عن ثلاثة أسئلة بجمل بسيطة، فلنُجب عنها لهذه الفكرة. لمن هو؟ لزبون على هاتفه، مستعجل، غير تقني. ماذا يجب أن يفعل؟ أن يعرض المواعيد المتاحة في الأسبوعين القادمين، ويتيح اختيار واحد منها، ويأخذ الاسم والبريد الإلكتروني، ويعرض تأكيدًا، ويرسل بريدًا إلى الحلّاق. ما الذي يجب ألّا يفعله أبدًا؟ أن يُظهر لزبون حجز زبون آخر، أو يسمح بحجز الموعد نفسه مرتين، أو يطلب أي شيء غير الاسم والبريد الإلكتروني. الصق هذا الوصف (Spec)، ثم اطلب قطعة صغيرة واحدة: صفحة تظهر فيها المواعيد على الشاشة، دون أن يعمل أي شيء بعد. ثم إجراء الحجز من أوله إلى آخره. ثم الحالات الخاطئة. ثم الشكل — في النهاية. نتيجة أولى واقعية: تقويم للسنة كلها، وحقل لرقم الهاتف لم يطلبه أحد. والرد المفيد يصف الفجوة لا يُصدر حكمًا: «الصفحة تعرض كل أسابيع السنة، لكن يجب أن تعرض الأسبوعين القادمين فقط. احذف حقل رقم الهاتف. وأبقِ كل شيء آخر كما هو.» ثم احفظ نسخة من الإصدار الذي يعمل، وبعدها فقط اطلب الشيء التالي.
- لمن هو، وماذا يجب أن يفعل، وما الذي يجب ألّا يفعله أبدًا — مكتوبة قبل فتح أي أداة
- ترتيب البناء: شيء على الشاشة، ثم الإجراء الأساسي كاملًا، ثم الحالات الخاطئة، ثم الشكل
- تفاعل بوصف الفجوة لا بحكم: ما أراه، وما توقعته، والفرق بينهما
- احفظ نسخة عاملة بعد كل خطوة تنجح — وهذا مهم في الشريحة التالية
حين تعطّل: العصر السيئ
لنمنح المثال الآن عصره السيئ، لأن أي بناء حقيقي سيمرّ بواحد. لنفترض أنك طلبت تعديلًا صغيرًا — رسالة شكر بعد الحجز — فأصبح تقويم المواعيد فارغًا. وفي وحدة تحكم المتصفح (Console) يظهر سطر أحمر: «TypeError: Cannot read properties of undefined (reading 'date')»، مع اسم ملف ورقم سطر. لا تحتاج إلى فهمه. يكفي البلاغ ذو الأجزاء الثلاثة من الوحدة الثالثة: «ضغطت تأكيد على موعد يوم الثلاثاء. توقعت رسالة شكر وبريدًا إلكترونيًا. بدلًا من ذلك صارت الصفحة فارغة، وظهر هذا في وحدة التحكم: [الرسالة كاملة، ملصوقة]. كان يعمل قبل تعديل رسالة الشكر.» يصل إصلاح أول — تختفي رسالة الخطأ، لكن صارت كل المواعيد تظهر محجوزة. ثم إصلاح ثانٍ — تعود المواعيد، لكن زر تأكيد لم يعد يفعل شيئًا. هنا تقترب من حلقة الإصلاح المفرغة (Doom loop): الخطوة المغرية هي إصلاح سريع آخر، فوق إصلاحين لم يُتحقق منهما. والقاعدة التي قرّرتها مسبقًا تقول: توقّف. ارجع إلى النسخة المحفوظة من قبل رسالة الشكر، واطلب التعديل نفسه في محادثة جديدة، مع لصق وصف المتطلبات، من نقطة نظيفة. تعديل واحد، ثم افحص القائمة كلها، ثم احفظ.
- التقط رسالة الخطأ كما هي — الصقها كاملة، مع اسم الملف ورقم السطر
- ماذا فعلت، وماذا توقعت، وماذا حدث فعلًا، وما آخر تعديل قبل أن يتعطّل
- إصلاحان يكسر كل منهما شيئًا جديدًا هما بداية الحلقة المفرغة — لا تضف ثالثًا فوقهما
- الخروج يكون إلى الخلف: النسخة العاملة المحفوظة، ثم محادثة جديدة مع وصف المتطلبات
هل هو جيد بما يكفي للمشاركة؟
تقول الوحدة الرابعة: اكتب قائمة الفحص قبل أن تثق بأي شيء، فلنكتبها لهذا المثال. خمسة أسطر: يستطيع الزبون حجز موعد ويصل البريد إلى الحلّاق خلال دقيقة؛ الموعد المحجوز لا يظهر متاحًا أبدًا؛ لا أحد يستطيع رؤية حجز غيره؛ النموذج الفارغ أو البريد غير المنطقي يُرفض برسالة واضحة؛ وكل شيء يعمل على الهاتف، دون تسجيل دخول، في نافذة خاصة. مرّ على القائمة كاملة بعد كل تعديل — القائمة كلها في كل مرة، لا الجزء الذي لمسته فقط — ثم مرتين متتاليتين، ثم مرة أخرى في الغد. سلّمه لصديق واحد مع مهمة: «احجز لنفسك موعدًا يوم الثلاثاء القادم»، والزم الصمت وهو يحاول. ثم فحوص واجب العناية في هذه الوحدة، قبل خروج الرابط. بيانات من؟ اسم وبريد إلكتروني، لا شيء غيرهما — بقي حقل رقم الهاتف محذوفًا. أي أسرار؟ مفتاح واحد لخدمة إرسال البريد، محفوظ في إعدادات المنصة، لا في الكود. أي تكاليف؟ سقف على خدمة البريد وتنبيه أدنى منه. وعندها فقط شاركه، مع عدد قليل من الأشخاص المتسامحين أولًا. مشروعك سيختلف عن هذا المثال في كل خطوة — وهذا طبيعي. المثال لا ينتقل. المنهجية هي التي تنتقل.
- قائمة فحص مكتوبة لهذا التطبيق، تشمل الأشياء التي يجب ألّا تحدث ولن يبلّغ عنها أحد
- صديق واحد، ومهمة واحدة، وصمت — لحظات تردّده هي النتائج
- بيانات من، وأي أسرار، وأي تكاليف — أجب عنها بصوت عالٍ قبل خروج الرابط
- كل مشروع يختلف عن المثال في كل خطوة؛ المنهجية هي ما ينتقل
مرّر فكرتك أنت عبر المحطات الأربع نفسها في جلسة واحدة: صغّرها، واكتب وصف المتطلبات، وابنِ شيئًا واحدًا في كل مرة، وتوقّف عند البوابة قبل أن يراه أي شخص آخر. املأ القالب أدناه على الورق قبل أن تفتح أي أداة.
المحطة 1 — نسخة عطلة نهاية الأسبوع: [فكرتي في جملة واحدة، بفعل واحد فقط] المحطة 2 — وصف المتطلبات في ثلاث جمل: لمن هو: [ ] ماذا يجب أن يفعل: [ ] ما الذي يجب ألّا يفعله أبدًا: [ ] المحطة 3 — قالب بلاغ الخطأ البرمجي: ماذا فعلت: [ ] ماذا توقعت: [ ] ماذا حدث فعلًا: [الصق رسالة الخطأ كاملة] آخر تعديل قبل أن يتعطّل: [ ] المحطة 4 — قائمة الفحص من خمسة أسطر: [الإجراء الأساسي يعمل من أوله إلى آخره] [شيء واحد يجب ألّا يحدث أبدًا] [بيانات من يحتفظ بها، والحقول التي حذفتها] [المفاتيح خارج الكود، وحدود الإنفاق مضبوطة] [مُختبر دون تسجيل دخول، على هاتف]
- لديك نسخة عاملة محفوظة من نقطتين على الأقل أثناء البناء
- شخص واحد غيرك أكمل الإجراء الأساسي دون مساعدتك
- تستطيع أن تقول بصوت عالٍ ماذا يخزّن، وأين تُحفظ المفاتيح، وكم قد يكلّفك