الفرق والمنتج الأدلة التقنية

هندسة المتطلبات Requirements Engineering من الطلب إلى ما يبنى

ما هو المتطلب Requirement، وكيف تجمعه وتكتبه وتراجعه وتدير تغييره، ولماذا تفشل مشاريع كبيرة عندما تهمل هذه الخطوة.

هندسة المتطلبات Requirements Engineering من الطلب إلى ما يبنى

إذا كنت تدير مشروعاً تقنياً، أو تطلب نظاماً من شركة برمجة، أو تعمل محللاً بين العميل والفريق، فهذا المقال لك. ستعرف فيه ما هي المتطلبات Requirements، وكيف تجمعها وتكتبها وتراجعها، وكيف تمنع الطلبات الصغيرة من إغراق المشروع.

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

العمل المنظم الذي يمنع هذه النهاية اسمه هندسة المتطلبات Requirements Engineering. وهو أول ما يحدث في أي مشروع، حتى لو لم يسمه الفريق بهذا الاسم. وسنستخدم مثال العيادة نفسه في المقال كله لتوضيح كل فكرة.

وهذا المقال بداية مرحلة «معمارية البرمجيات وتصميمها» في خارطة الطريق، لأن كل قرارات التصميم تبنى على المتطلبات. ويتبعه مقال عملي يحول طلب العيادة إلى متطلبات مكتوبة بقوالب جاهزة.

باختصار In Short

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

لماذا يفشل المشروع قبل أن يبدأ البناء؟

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

ويصف دليل SWEBOK هذه الحالة بأن كثيراً من المتطلبات «ضمنية» Tacit، أي موجودة في رؤوس الناس دون أن يقولوها. والمستخدمون يجدون صعوبة في وصف عمل يفعلونه كل يوم دون تفكير. لذلك جمع المتطلبات بحث تقوم به أنت، وليس انتظاراً لما يمليه العميل.

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

جبل جليد فوق الماء فيه جملة العميل نبغى نظام حجز مواعيد، وتحت الماء ثمانية بنود: قواعد العمل والاستثناءات وخصائص الجودة وأصحاب المصلحة المخفيون والامتثال والتكامل وترحيل البيانات والافتراضات، مع ثلاث علامات: ما يقال وما يفترض وما لم يفكر فيه أحد
ما يقوله العميل في الاجتماع الأول هو القمة فقط، وأغلب المتطلبات تحت الماء

والطريقة التي تبدأ بها فرق كثيرة: يكتب الفريق ما فهمه ويبدأ البناء، ويسأل عن التفاصيل عندما تظهر. هذا يعمل في ميزة صغيرة، ويفشل في نظام حقيقي لسببين:

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

ما هو المتطلب Requirement؟

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

والتعريف الرسمي في دليل SWEBOK أطول قليلاً: شرط أو قدرة يحتاجها المستخدم ليحل مشكلة، أو يجب أن يملكها النظام ليفي بعقد أو معيار. ويضيف الدليل إليها احتياجات المشروع وقيوده، مثل الميزانية والموعد.

المصدر: دليل SWEBOK v4، الفصل الأول.

الحاجة Need أم الحل Solution؟

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

ويقترح SWEBOK طريقة بسيطة اسمها «لماذا الخمسة» 5 Whys. تسأل «لماذا تحتاج هذا؟»، ثم تسأل عن الإجابة «لماذا؟» مرة أخرى. وغالباً تظهر المشكلة الحقيقية بعد سؤالين أو ثلاثة.

في مثال العيادة طلب العميل زر تصدير إلى Excel. وبعد سؤالين ظهرت الحاجة الحقيقية: أن يعرف كل طبيب مواعيد يومه وتغييراتها فوراً. وعندها ظهرت حلول أخرى غير الزر:

أربعة مربعات من اليمين إلى اليسار: الطلب زر يصدر المواعيد إلى Excel، ثم لماذا الأولى عشان نطبع جدول اليوم لكل طبيب، ثم لماذا الثانية الطبيب ما يعرف مواعيده إلا من الاستقبال، ثم الحاجة الحقيقية أن يعرف كل طبيب مواعيد يومه فوراً، وتحتها أربعة حلول: تصدير Excel وشاشة يومية للطبيب ورسالة صباحية وتقويم مشترك
السؤال «لماذا؟» يحول الحل المقترح Solution إلى حاجة Need، والحاجة تفتح حلولاً أخرى

والهدف ليس أن ترفض طلب العميل. قد يكون التصدير إلى Excel هو الحل الأنسب لأنه الأرخص. المهم أن يكون الاختيار قراراً واعياً بعد أن تعرف الحاجة.

مستويات المتطلبات وأنواعها Levels and Types

المتطلبات تكتب على ثلاثة مستويات. كل مستوى يجيب عن سؤال مختلف، ويقرؤه شخص مختلف:

المستوىالسؤال الذي يجيب عنهمثال من العيادة
متطلبات العمل Business Requirementsلماذا يدفع العميل في هذا المشروع أصلاً؟تقليل المكالمات على الاستقبال، وتقليل المواعيد التي لا يحضر أصحابها
متطلبات أصحاب المصلحة Stakeholder Requirementsماذا يحتاج كل طرف من النظام؟المريض يريد أن يحجز دون اتصال، والطبيب يريد أن يعرف جدوله
متطلبات النظام System Requirementsماذا يفعل البرنامج بالتحديد؟يعرض النظام أوقات الطبيب المتاحة خلال الثلاثين يوماً القادمة فقط

ويسمي المعيار ISO/IEC/IEEE 29148 لكل مستوى وثيقة خاصة. لكن في مشروع صغير لا تحتاج ثلاث وثائق. تحتاج فقط أن تعرف المستويات حتى لا تخلط بينها.

وداخل هذه المستويات خمسة أنواع، وكل نوع يعامل بطريقة مختلفة:

النوعمعناهمثالكيف تتعامل معه
وظيفي Functionalماذا يفعل النظامالحجز والإلغاء والتذكيرتكتبه قصة مستخدم وتختبره بسيناريو
غير وظيفي Non-functionalكيف يجب أن يعمل: السرعة والتوافر والأمان وسهولة الاستخدامتظهر نتائج البحث عن موعد في أقل من ثانيةتكتبه برقم يقاس، وهو يحدد طريقة بناء النظام
قاعدة عمل Business Ruleقاعدة من طبيعة العمل نفسهلا يحجز المريض أكثر من موعد مفتوح مع نفس الطبيبتكتبها بمثال، وتبقى أطول من أي نظام
قيد Constraintقرار محسوم قبل أن تبدأيعمل النظام على خوادم داخل المملكةلا يناقش، وإنما يحترم
افتراض Assumptionشيء نعتبره صحيحاً دون أن نتأكدكل مريض لديه جوال يستقبل الرسائلتكتب بجانبه من سيتأكد منه ومتى

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

المصدر: المعيار ISO/IEC/IEEE 29148:2018، ودليل SWEBOK v4.

أصحاب المصلحة Stakeholders: من تسأل ومن يقرر؟

صاحب المصلحة هو كل شخص أو جهة تتأثر بالنظام أو تؤثر فيه. ويعدد SWEBOK أصنافاً منهم يسهل نسيانها:

  • العميل الذي يدفع، ومن يقرر قبول النظام.
  • المستخدمون الذين يتعاملون معه كل يوم.
  • خبراء المجال Subject Matter Experts، مثل الطبيب في مثالنا.
  • فريق التشغيل والدعم الفني.
  • الجهات التنظيمية Regulators التي تضع القوانين.
  • الفريق الذي يبني النظام نفسه.

وأهم قاعدة هنا: من يوقع العقد ليس بالضرورة من يستخدم النظام. مالك العيادة يعرف أهداف العمل. لكن موظفة الاستقبال هي التي تعرف أن ثلث مكالمات الصباح لتغيير موعد وليس لحجز جديد. وهذه معلومة لن تسمعها من المالك.

لذلك اكتب قائمة أصحاب المصلحة في بداية المشروع، قبل أي مقابلة. وينصح الدليل بهذا حتى لا تميل المتطلبات نحو الطرف الأعلى صوتاً على حساب الطرف الغائب.

أنشطة هندسة المتطلبات Requirements Engineering Activities

المرجعان الأساسيان في هذا الموضوع:

  • المعيار الدولي ISO/IEC/IEEE 29148:2018: يحدد خطوات هندسة المتطلبات والوثائق التي تنتج عنها. صدر إصداره الثاني في نوفمبر 2018، وتعمل ISO الآن على مراجعته.
  • دليل SWEBOK v4: تنشره جمعية IEEE Computer Society، وفصله الأول عن متطلبات البرمجيات. ويمكنك تنزيله من ملف PDF الرسمي.

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

دورة من أربعة مربعات مرقمة: جمع المتطلبات Elicitation ثم التحليل Analysis ثم التوثيق Specification ثم التحقق Validation، وسهم متقطع يعود من التحقق إلى الجمع، وفي الوسط دائرة إدارة المتطلبات Requirements Management للإصدارات والتتبع وإدارة التغيير
الأنشطة الأربعة تتكرر مع كل مجموعة جديدة من المتطلبات، والإدارة Management تحيط بها طوال حياة المشروع
النشاطماذا تفعل فيهسؤاله الأساسي
الجمع Elicitationتستخرج المتطلبات من الناس والوثائق والأنظمة الحالية والقوانينماذا يحتاجون فعلاً؟
التحليل Analysisتفهم كل متطلب وأثره، وتحل التعارض بين الأطرافهل المتطلب واضح وممكن ولا يتعارض مع غيره؟
التوثيق Specificationتكتب المتطلبات بصيغة يفهمها العميل والفريق ومن يختبرهل يقرؤه الجميع بنفس المعنى؟
التحقق Validationتعرض المتطلبات على أصحابها قبل البناءهل هذا ما نحتاجه فعلاً؟
الإدارة Managementتعطي كل متطلب رقماً وحالة، وتتبعه، وتدير تغييرهما الذي تغير، ومن قرر، وماذا يتأثر؟

كيف تتحقق من المتطلبات قبل البناء؟ يذكر SWEBOK ثلاث طرق: مراجعة يقرأ فيها أصحاب المصلحة المتطلبات ويعلقون عليها، وتشغيل المتطلبات إذا كتبت بصيغة يمكن تشغيلها، والنموذج الأولي Prototype. وأصحاب المصلحة غير التقنيين نادراً ما يقرؤون وثيقة من ثلاثين صفحة بتركيز، لكنهم يلاحظون الخطأ فوراً عندما يرون شاشة مرسومة أو مثالاً حقيقياً.

ما صفات المتطلب الجيد؟

في مرحلة التحليل تراجع كل متطلب بهذه الأسئلة، وهي من قائمة SWEBOK:

  • واضح Unambiguous: هل له معنى واحد فقط؟
  • قابل للاختبار Testable: هل نستطيع أن نثبت أن النظام يحققه أو لا يحققه؟
  • ملزم Binding: هل العميل مستعد أن يدفع مقابله، ولا يقبل الاستغناء عنه؟
  • مفرد Atomic: هل هو قرار واحد، وليس ثلاثة قرارات في جملة؟
  • بلغة أصحابه: هل كتب بكلمات أصحاب المصلحة أنفسهم؟

وتنظر أيضاً إلى المتطلبات كلها معاً: هل هي كاملة Complete تغطي الحالات الحدية والاستثناءات والأمان؟ ومختصرة Concise بلا زيادة؟ ومتسقة Consistent لا يناقض بعضها بعضاً؟ وممكنة Feasible ضمن الكلفة والوقت والفريق المتاح؟

وعند التعارض، مثل طبيب يريد راحة بين كل موعدين ومالك يريد أكبر عدد من المواعيد، القرار لصاحب الصلاحية وليس للفريق التقني.

تنقية المتطلبات Requirements Scrubbing

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

المصدر: صفحة المعيار ISO/IEC/IEEE 29148:2018، ودليل SWEBOK v4.

طرق جمع المتطلبات Elicitation Techniques

لا توجد طريقة واحدة تكفي. كل طريقة تكشف نوعاً من المتطلبات وتخفي نوعاً آخر. والجدول التالي يلخص أشهر الطرق التي يذكرها SWEBOK، ومتى تنجح كل واحدة ومتى تضللك:

الطريقةتنجح عندماتضللك عندما
المقابلة Interviewتريد أن تفهم أهداف شخص ومشكلاته. وتعمل أفضل بأسئلة مفتوحة مثل «احك لي عن آخر مرة…»تسأل أسئلة توحي بالإجابة، أو تقابل المدير فقط وتعتبر كلامه كلام المستخدمين
ورشة العمل Workshopتريد اتفاقاً بين أطراف مختلفة في وقت قصير، مع ميسر Facilitator محايديسيطر عليها أعلى صوت أو أعلى منصب، فيسكت الباقون
الملاحظة Observationالناس يؤدون عملاً متكرراً لا يستطيعون وصفه، فتذهب وتراه بنفسكتلاحظ يوماً غير عادي، أو يغير الناس طريقتهم لأنهم يعرفون أنك تراقبهم
تحليل الوثائق Document Analysisتوجد نماذج ورقية وملفات Excel وأنظمة قديمة ولوائح، وهي أسرع طريق لمعرفة الحقول والقواعدالوثائق قديمة، أو تصف الطريقة الرسمية وليس ما يحدث فعلاً
النموذج الأولي Prototypeالمستخدم لا يعرف ما يريد حتى يراه، ويكفي رسم بالقلميبدو النموذج جاهزاً فيظن العميل أن النظام انتهى
الاستبيان Questionnaireتريد أرقاماً من عدد كبير من الناس، بعد أن عرفت الأسئلة الصحيحةتستخدمه لاكتشاف المتطلبات من الصفر، فهو لا يخبرك بما لم تسأل عنه

والترتيب العملي: ابدأ بالوثائق لتعرف لغة المجال. ثم المقابلات لتعرف الأهداف. ثم الملاحظة لترى ما يحدث فعلاً. ثم النموذج الأولي لتتأكد أنك فهمت. والاستبيان في النهاية إن احتجت أن تقيس.

كيف تكتب المتطلبات؟ الصيغ المشهورة Requirements Formats

لا توجد صيغة واحدة صحيحة. المهم في كل الصيغ شيئان: أن يحمل كل متطلب رقماً، وأن يكون له معيار قبول يمكن اختباره.

وثيقة مواصفة المتطلبات SRS

اسمها الكامل Software Requirements Specification. هي وثيقة تجمع المتطلبات في مكان واحد: الهدف، والنطاق Scope، والتعريفات، وأصحاب المصلحة، وأنواع المتطلبات كلها.

وتكتب المتطلبات فيها عادة بجمل منظمة: الحدث، ثم الفاعل، ثم الفعل، ثم الشرط. ومثال SWEBOK: «عند شحن الطلب، يجب أن ينشئ النظام فاتورة، إلا إذا كانت شروط الطلب مدفوعة مسبقاً».

وهي ضرورية في العقود الحكومية والمناقصات والأنظمة التي تحتاج اعتماداً رسمياً. لكن لا تكتب وثيقة من مئة صفحة لفريق من ثلاثة أشخاص، لأن أحداً لن يقرأها بعد أسبوعها الأول. وفي المقال العملي قالب SRS من صفحة واحدة يكفي أغلب المشاريع.

قصص المستخدم User Stories وقاعدة INVEST

قصة المستخدم وصف قصير لحاجة من وجهة نظر صاحبها. ظهرت مع منهج البرمجة القصوى Extreme Programming في 1998، وقالبها المشهور ظهر في 2001. وهو ثلاثة أجزاء:

الجزءمعناهمثال من العيادة
بصفتي As aمن يحتاج الميزةبصفتي مريضاً
أريد I wantماذا يريد أن يفعلأريد أن أحجز موعداً متاحاً مع الطبيب عبر الإنترنت
حتى So thatلماذا، وهذه هي الحاجةحتى لا أضطر للاتصال بالعيادة أثناء الدوام

أهم جزء في القصة هو «حتى»، لأنه يحمل الحاجة. والقصة التي ليس فيها سبب هي غالباً حل مقترح في شكل قصة.

والقصة ليست وثيقة كاملة. ففكرة Ron Jeffries من 2001 أنها بطاقة Card تذكر بحوار Conversation يجب أن يحدث مع صاحب الحاجة، ثم تأكيد Confirmation هو معايير القبول.

ولتعرف أن القصة جيدة، استخدم قاعدة INVEST التي وضعها Bill Wake في 2003. كل حرف صفة:

الحرفالصفةمعناها
Iمستقلة Independentيمكن تسليمها دون انتظار قصة أخرى قدر الإمكان
Nقابلة للتفاوض Negotiableتصف الحاجة، وتترك التفاصيل للنقاش
Vذات قيمة Valuableلها فائدة يراها المستخدم أو العميل
Eقابلة للتقدير Estimableيفهمها الفريق بما يكفي ليقدر حجمها
Sصغيرة Smallتنتهي داخل دورة عمل واحدة Sprint، وإلا فقسمها
Tقابلة للاختبار Testableلها معايير قبول واضحة

المصدر: Agile Alliance عن قصص المستخدم، ومقال Bill Wake عن INVEST.

معايير القبول Acceptance Criteria بصيغة Given/When/Then

معايير القبول هي الشروط التي يجب أن تتحقق حتى يقبل صاحب العمل القصة. وهي التي تحول القصة من نية إلى اتفاق صغير يمكن اختباره.

وأشهر صيغة لها ثلاث كلمات: «بفرض» Given حالة البداية، و«عندما» When يحدث فعل، و«إذاً» Then نتوقع نتيجة. طورها Daniel Terhorst-North وChris Matts ضمن منهج اسمه التطوير الموجه بالسلوك BDD. وهذا مثال لقاعدة «لا يحجز مريضان نفس الموعد»:

الجزءالمثال
بفرض Givenالمريض الأول حجز مع د. هدى يوم 14 أكتوبر الساعة 10:00
عندما Whenيحاول مريض ثان حجز نفس الطبيبة في نفس اليوم والساعة
إذاً Thenيرفض النظام الحجز، ويخبره أن الموعد محجوز

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

وميزة هذه الصيغة أن صاحب العمل يقرؤها ويوافق عليها، وأن فريق البرمجة يستطيع تحويلها إلى اختبار آلي باستخدام صيغة اسمها Gherkin. وهي تدعم العربية، كما في قائمة اللغات الرسمية. ونفس الأسلوب يستخدم لكتابة المتطلبات الأمنية واختبارات القبول التي شرحناها في أنواع الاختبارات.

المصدر: Martin Fowler عن Given/When/Then.

حالات الاستخدام Use Cases

حالة الاستخدام تصف خطوات مستخدم مع النظام لتحقيق هدف واحد. تكتب أولاً المسار العادي خطوة بخطوة. ثم تكتب ما يحدث عند كل استثناء.

وقوتها أنها تجبرك على التفكير في الاستثناءات: ماذا لو حجز شخص آخر الموعد أثناء تعبئة المريض للبيانات؟ ماذا لو لم تصل رسالة التحقق؟ لذلك تناسب الإجراءات الطويلة المعقدة.

أي صيغة تختار؟

الصيغةمناسبة لـنقطة الضعف
وثيقة SRSالعقود والمناقصات والجهات الحكوميةتتقادم بسرعة إذا لم يكن لها مالك
قصص المستخدمالفرق التي تسلم على دفعات، والمنتجات التي تتطور باستمرارتضيع فيها الصورة الكاملة والمتطلبات غير الوظيفية
معايير القبول Given/When/Thenقواعد العمل التي لها أمثلة واضحةتصبح عبئاً إذا كتبت لكل تفصيل صغير
حالات الاستخدامالإجراءات الطويلة ذات الاستثناءات الكثيرةأطول في الكتابة

وفي أغلب المشاريع الصغيرة والمتوسطة تعمل هذه التركيبة جيداً: صفحة SRS واحدة للصورة الكاملة، وقصص مستخدم بمعايير قبول للتفاصيل، وحالة استخدام كاملة للإجراء الأخطر فقط.

ترتيب الأولويات Prioritization بطريقة MoSCoW

كل المتطلبات مهمة في نظر صاحبها. وإذا لم ترتبها أنت، سيرتبها الموعد النهائي بأسوأ طريقة. وأبسط طريقة مشهورة اسمها MoSCoW، وهي أربع فئات:

الفئةمعناهامثال من العيادة
Must Have (لا بد منه)بدونه لا معنى للإصدارالحجز، ومنع الحجز المزدوج
Should Have (مهم)مهم، لكن النظام يعمل بدونه مع حل مؤقترسالة تذكير قبل الموعد
Could Have (مرغوب)غيابه أثره صغير، وأول ما يحذف إذا ضاق الوقتتقييم الطبيب بعد الزيارة
Won't Have (ليس هذه المرة)خارج هذا الإصدار صراحة، ويكتب حتى لا يعود من الباب الخلفيالدفع الإلكتروني

وتوصي الطريقة ألا يزيد جهد فئة Must على 60% من جهد الإصدار، وأن تكون فئة Could في حدود 20%. والمساحة الباقية هامش أمان يحمي الموعد عندما يتأخر شيء. وإذا كان كل شيء Must، فلا يوجد هامش.

المصدر: Agile Business Consortium عن MoSCoW.

نموذج كانو Kano Model

نموذج Kano من بحث نشره Noriaki Kano وزملاؤه عام 1984. فكرته أن الميزات لا تؤثر في رضا المستخدم بنفس الطريقة:

  • أساسية Must-be: لا يشكرك أحد عليها، لكن غيابها يغضب الجميع. مثل أن يظهر الحجز بعد تأكيده.
  • أداء One-dimensional: كلما تحسنت زاد الرضا. مثل سرعة البحث عن موعد.
  • جذابة Attractive: لا يتوقعها أحد، وتسعد من يراها. مثل إضافة الموعد إلى تقويم الجوال بنقرة.

والفائدة العملية: تأكد أن الأساسيات كلها في فئة Must قبل أن تنفق الوقت على الميزات الجذابة.

المصدر: بحث Kano وزملائه، 1984.

تتبع المتطلبات Traceability

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

خمسة مربعات من اليمين إلى اليسار: حاجة العمل BN-01 ثم المتطلب BR-01 ثم القصة ومعايير القبول US-01 ثم الكود ثم الاختبار، وأسهم خضراء للتتبع الأمامي وأسهم زرقاء متقطعة للتتبع الخلفي، وتحتها ثلاثة أسئلة: هل اختبرنا كل متطلب، ولماذا بني هذا الجزء، وماذا يتأثر إذا تغير المتطلب
الرقم نفسه يظهر في كل محطة، فيصبح التتبع Traceability بحثاً عن رقم وليس مشروعاً مستقلاً

التتبع يجيب عن ثلاثة أسئلة يسألها كل مدير مشروع:

  • هل بنينا واختبرنا كل ما طلب؟
  • لماذا بني هذا الجزء، ومن طلبه؟
  • إذا تغير هذا المتطلب، ماذا يتأثر؟

والطريقة الثقيلة جدول كبير اسمه مصفوفة التتبع Traceability Matrix، يحدثه شخص يدوياً، ويتقادم من أول أسبوع. والطريقة الخفيفة أن يظهر رقم المتطلب في كل مكان: في عنوان المهمة، وفي سجل التغييرات، وفي اسم الاختبار. وعندها يصبح التتبع بحثاً عن رقم.

إدارة التغيير وزحف النطاق Scope Creep

المتطلبات تتغير، وهذا طبيعي. العميل يفهم حاجته أكثر كلما رأى النظام، والسوق والقوانين تتغير.

المشكلة في التغيير الذي يدخل دون قرار، ويسمى زحف النطاق Scope Creep. طلب صغير هنا، و«إضافة بسيطة» هناك. كل طلب وحده معقول، لكن مجموعها يؤخر الإصدار شهرين، ولا يعرف أحد متى تقرر ذلك:

خطان زمنيان لتسعة أسابيع من اليمين إلى اليسار: في الأعلى دون إدارة للتغيير تدخل خمسة طلبات صغيرة مباشرة فيتجاوز العمل الموعد النهائي، وفي الأسفل مع إدارة التغيير يمر كل طلب على قرار: مؤجل أو مقبول مقابل حذف شيء أو خارج هذا الإصدار، فيخرج الإصدار في موعده وتنتظر الطلبات المؤجلة في ال Backlog
كل طلب تغيير Change Request يحتاج قراراً مكتوباً: يدخل مقابل شيء يخرج، أو يؤجل، أو يرفض

وإدارة التغيير Change Control لا تعني لجنة ونماذج طويلة. هي أربع خطوات:

  1. سجل الطلب برقم: من طلبه، ومتى، ولماذا.
  2. حلل أثره: على المتطلبات الأخرى والاختبارات والموعد والكلفة. وهنا يظهر فضل التتبع.
  3. خذ قراراً من صاحب الصلاحية: يقبل، أو يؤجل، أو يرفض. والقبول غالباً يعني أن شيئاً آخر يخرج.
  4. حدث الوثيقة أولاً: ثم يبدأ العمل، وليس العكس.

المتطلبات في Agile وفي المشاريع المخططة مسبقاً

دورة حياة المشروع تحدد متى يحدث عمل المتطلبات، وليس هل يحدث:

النموذجمتى تكتب المتطلبات
الشلال Waterfallكلها تقريباً في مرحلة مستقلة قبل البناء
التكراري Iterativeجزء في البداية، والتفاصيل في مراحل لاحقة
Agileتدريجياً، قبل كل دفعة عمل بقليل

هل يعني Agile أننا لا نكتب متطلبات؟ لا. الفرق في الكمية والتوقيت فقط. تكتب الصورة الكاملة والقيود في البداية باختصار، ثم تفصل القصص قبل العمل عليها بقليل. ومعايير القبول والتتبع وإدارة التغيير تبقى كما هي.

وانتبه: تقرير المفتش العام عن موقع HealthCare.gov، الذي نعرضه بعد قليل، ذكر أن أسلوب Agile سهل على صناع القرار طلب تغييرات كثيرة ومتأخرة. وأن التغيير في Agile يجب أن يدرس ويوثق ويبلغ مثل أي تغيير آخر.

والفريق الذي يستخدم Agile عذراً لعدم الكتابة يكتشف لاحقاً أن المتطلبات في رؤوس ثلاثة أشخاص ورسائل واتساب لا يجدها أحد. وتفصيل نماذج دورة الحياة في دورة حياة تطوير البرمجيات. وإذا أردت أداة تجمع القصص ومعايير القبول في مكان واحد على خادمك، فاقرأ عن أداة Taiga.

أخطاء شائعة وحلولها

الخطأمثالالحل
كلمات غامضة«يجب أن يكون النظام سريعاً وسهل الاستخدام»اسأل «كيف سنعرف أننا حققناه؟» حتى تصل إلى رقم: «95% من عمليات البحث تظهر نتائجها في أقل من ثانية»
المتطلبات غير الوظيفية غائبةلا أحد سأل عن عدد المستخدمين في وقت الذروة، أو أين تحفظ البياناتقائمة ثابتة تمر عليها في كل مشروع، ومعها النسخ الاحتياطي واختبار الاستعادة
سألت الشخص الخطأجمعت المتطلبات من المدير وحده، فرفض المستخدمون النظامقائمة أصحاب المصلحة قبل أي مقابلة، واسأل في نهاية كل مقابلة «من غيرك يجب أن أكلمه؟»
حل مكتوب كأنه متطلب«نبغى زر تصدير»، «نبغى تطبيق جوال»اسأل «لماذا؟». إذا كان للقيد سبب حقيقي فاكتبه مع سببه، وإلا فاكتب الحاجة
التذهيب Gold Platingالفريق يضيف ميزات لم يطلبها أحد «لأنها ستعجبهم»لا يبنى شيء ليس له رقم متطلب، والفكرة الجديدة تمر على ترتيب الأولويات مثل غيرها
افتراضات لم يتأكد منها أحد«كل المرضى عندهم جوال ذكي»اكتب كل افتراض مع اسم من سيتأكد منه وموعده، وعامله كخطر حتى يتأكد
المتطلبات في رسائل الواتساب«الدكتور قال في القروب نخلي الإلغاء قبل يوم»أي قرار في محادثة لا يعتبر متطلباً حتى ينقل إلى الوثيقة برقم، مع رابط المحادثة
لا توجد معايير قبول«يستطيع المريض إلغاء موعده» دون تحديد متىلا تبدأ قصة دون معايير قبول بأمثلة يوافق عليها صاحب العمل
الامتثال Compliance يكتشف في آخر يومقبل الإطلاق يسأل أحدهم: أين تحفظ بيانات المرضى؟اسأل عن الأنظمة في أول مقابلة، كما في الفقرة التالية

وأسئلة الامتثال في السعودية تبدأ عادة بثلاثة مراجع:

وكيف تتحول هذه المتطلبات إلى بنود قابلة للاختبار تجده في مرحلة المتطلبات الأمنية في Secure SDLC.

ثلاث قصص موثقة من تقارير رسمية

القصص الثلاث التالية من تقارير جهات الرقابة الحكومية نفسها. ونذكر في كل واحدة مشكلة المتطلبات التي ذكرها التقرير بالتحديد.

موقع HealthCare.gov الأمريكي عام 2013

أطلقت الحكومة الأمريكية الموقع في أكتوبر 2013 ليشتري الناس منه التأمين الصحي، وتعطل بشكل واسع من أول يوم. وماذا قالت التقارير؟

  • متطلبات العمل كتبت ببطء، والجهة المسؤولة كانت ما زالت تتخذ قرارات أساسية بعد أن بدأ البناء.
  • تغيير المتطلبات استمر حتى عام 2013، فلم يعد ممكناً إكمال الموقع واختباره كما خطط له.
  • لجنة ضبط التغيير لم تدر بشكل فعال.
  • المبالغ الملتزم بها لعقد المنصة ارتفعت من 56 مليون دولار في سبتمبر 2011 إلى أكثر من 209 ملايين في فبراير 2014.
  • المتطلبات لم تربط بمصدرها، ووثائق الاختبار كانت تنقصها معايير النجاح.

أي: قرارات متأخرة، وضبط تغيير ضعيف، ولا تتبع ولا معايير قبول. أربع مشكلات من قائمتنا في مشروع واحد.

المصدر: تقرير HHS OIG رقم OEI-06-14-00350 (فبراير 2016)، وGAO-14-694 (يوليو 2014)، وGAO-15-238 (مارس 2015).

نظام Virtual Case File في مكتب التحقيقات الفيدرالي FBI

كان هدف المشروع نظاماً جديداً لإدارة القضايا. وأنفق المكتب عليه أكثر من ثلاث سنوات و170 مليون دولار، ثم اتجه إلى تركه والبدء بحل آخر.

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

وجزء من التغيير كان مبرراً، لأن أولويات المكتب تغيرت بعد أحداث سبتمبر 2001. لكن التغيير المبرر نفسه يحتاج خطاً أساسياً وإدارة، وإلا صار زحف نطاق بلا حدود.

المصدر: تقرير المفتش العام في وزارة العدل الأمريكية رقم 05-07 (فبراير 2005).

برنامج NPfIT في هيئة الصحة البريطانية NHS

أرادت بريطانيا سجلاً صحياً إلكترونياً لكل مريض عبر عقود مركزية كبيرة. وقال مكتب التدقيق الوطني في مايو 2011 إن 2.7 مليار جنيه أنفقت على هذه الأنظمة لا تمثل قيمة مقابل المال، وإن المواعيد انزلقت من 2010 إلى 2015-2016.

وفي جانب المتطلبات:

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

الدرس: المتطلبات التي تكتب دون المستخدمين الحقيقيين لا تصمد، وغياب معيار قبول متفق عليه يحول كل تعديل إلى نزاع على من يدفع.

المصدر: تقرير مكتب التدقيق الوطني NAO (مايو 2011).

وماذا عن أرقام تقرير CHAOS؟

ستقرأ في عروض كثيرة أن «أغلب مشاريع البرمجيات تفشل»، مع أرقام من تقارير CHAOS التي تنشرها مجموعة Standish. وأشهرها من تقرير 1994: 16% نجحت، و53% تعثرت، و31% ألغيت.

لكن باحثين من جامعة VU Amsterdam طبقوا تعريفات Standish على بيانات 1211 مشروعاً حقيقياً، ونشروا النتيجة في مجلة IEEE Software عام 2010. ووجدوا أن هذه التعريفات مضللة، لأنها تقيس فقط الابتعاد عن التقدير الأول، وتتجاهل المشاريع التي انتهت بأقل منه.

لذلك لا تبن حجتك على هذه النسب. وإذا أردت أن تقنع إدارتك بأهمية المتطلبات، فالتقارير الرقابية أعلاه أقوى، لأنها تسمي المشروع والسبب والكلفة.

المصدر: The Rise and Fall of the Chaos Report Figures، ونقد Robert Glass في Communications of the ACM.

ابدأ من مشروعك الحالي

  1. خذ آخر ثلاث مهام في مشروعك، واسأل عن كل واحدة: هل فيها «حتى» تشرح الحاجة؟ هل لها معيار قبول بمثال محدد؟ هل تعرف من طلبها ولماذا؟
  2. اكتب كل الافتراضات في مشروعك التي لم يتأكد منها أحد. وبجانب كل افتراض اسم من يستطيع تأكيده، ثم أرسل له السؤال اليوم.

الخلاصة

  • ما يقوله العميل في الاجتماع الأول جزء صغير مما يحتاجه، وهندسة المتطلبات تكشف الباقي قبل البناء.
  • العميل يتكلم بلغة الحل، فاسأل «لماذا؟» حتى تصل إلى الحاجة.
  • فرق بين الوظيفي وغير الوظيفي وقواعد العمل والقيود والافتراضات، لأن كل نوع يعامل بطريقة مختلفة.
  • الأنشطة: جمع، وتحليل، وتوثيق، وتحقق، وإدارة تحفظ الاتفاق مع الوقت.
  • لا تكفي طريقة جمع واحدة: الوثائق، ثم المقابلات، ثم الملاحظة، ثم النموذج الأولي.
  • كل متطلب يحتاج رقماً ومعيار قبول بمثال محدد.
  • رتب الأولويات بطريقة MoSCoW واترك هامشاً، ولا يدخل تغيير دون قرار مكتوب.
  • تقارير HealthCare.gov ونظام FBI ومشروع NHS تذكر نفس المشكلات: متطلبات متأخرة، ونطاق يتغير دون ضبط، ومستخدمون غائبون.

ماذا تقرأ بعد هذا المقال؟

المقال التالي يطبق كل ما سبق على طلب العيادة نفسه بقوالب جاهزة: أسئلة المقابلة، وخريطة أصحاب المصلحة، والقصص ومعايير القبول، ووثيقة SRS من صفحة، وطلب تغيير بعد التوقيع:

دليلمن فكرة غامضة إلى متطلبات Requirements واضحة: خطوات وقوالبثماني خطوات بقوالب جاهزة تحول طلباً من سطر واحد إلى متطلبات Requirements واضحة يوقع عليها العميل ويبني عليها الفريق.

وبعد المتطلبات تأتي المعمارية التي تبنى عليها، والتصميم الموجه بالمجال، وتوثيق القرارات، ونمذجة التهديدات:

دليلالتصميم والمعمارية: أربعة مستويات لنشاط واحدما الفرق بين تصميم البرمجيات ومعماريتها وتصميم الأنظمة ومعمارية المؤسسة، ومن يقرر في كل مستوى وكم يعيش قراره.دليلالتصميم الموجه بالمجال Domain-Driven Design ببساطةلماذا تعني كلمة «الطلب» ثلاثة أشياء في نفس الشركة، وكيف يقسم DDD النظام إلى سياقات لكل منها لغته ونموذجه.دليلتوثيق المعمارية: مخططات C4 وسجلات القرارات المعمارية ADRكيف ترسم نظامك بمخططات C4 يفهمها المطور الجديد، وتحفظ سبب كل قرار مهم في سجل ADR داخل المستودع.دليلنمذجة التهديدات Threat Modeling للمبتدئينكيف تسأل ما الذي قد يسوء في تصميم تطبيقك قبل أن تكتب الكود، وتقرر لكل تهديد هل تصلحه أو تقبله، مع قالب جاهز للنسخ.

سجل التحديثات

  • 2026-11-13: إعادة كتابة المقال بلغة أوضح وخطوات وجداول، دون كود.
  • 2026-11-14: مراجعة المقال وإعادة المعلومات المفيدة ونتائج البيانات الحقيقية التي حذفت في إعادة الكتابة.
  • أكتوبر 2026: كتابة المقال، مع مراجعة التعريفات والأنشطة من صفحة المعيار ISO/IEC/IEEE 29148:2018 والفصل الأول من SWEBOK v4، والقصص الموثقة من تقارير HHS OIG وGAO ووزارة العدل الأمريكية ومكتب التدقيق الوطني البريطاني.
نشرة عرب رووت | ArabRoot

معرفة تستحق مكاناً في بريدك.

مقالات مختارة وأدوات مفيدة وأفكار لمشروعك القادم، في رسالة واحدة كل أسبوع.

يمكنك إلغاء الاشتراك متى شئت. الخصوصية

تم استلام طلبك. افتح بريدك واضغط رابط التأكيد لإتمام الاشتراك.