We are still cooking the magic in the way!
التحقق من المتطلبات والمراجعات
التحقق من المتطلبات والمراجعات
كتابة المتطلبات ليست سوى نصف العمل. قبل كتابة سطر واحد من الكود، يجب على أحدهم التحقق من أن كل متطلب صحيح وكامل ومتسق وقابل للتنفيذ. عملية التحقق هذه — والمراجعات المنظمة التي تدعمها — هي ما يُميّز التحليل الاحترافي عن التفاؤل المجرد. تكلفة إصلاح الخلل المكتشَف خلال مراجعة المتطلبات أقل بنحو 10 إلى 100 مرة من إصلاحه بعد اكتشافه في مرحلة الاختبار أو ما بعد النشر. يستعرض هذا الدرس الأدوات الكاملة: الجولات التفقدية، والفحوصات الرسمية، وعملية الحصول على الموافقة الرسمية.
لماذا نتحقق من المتطلبات أصلاً؟
تخيّل شركة لوجستية تبني بوابة لتتبع الطرود. يوثّق المحلل: "يجب أن يعرض النظام الموقع الحالي للطرد." يبدو هذا معقولاً حتى يسأل مطوّر: "هل 'الموقع الحالي' يعني آخر مسح في المستودع، أم الإحداثيات الجغرافية لسيارة التوصيل، أم مدينة الوجهة؟" إن وصل هذا الغموض إلى مرحلة التطوير، بنى فريق تتبعاً عبر نظام GPS وبنى آخر سجل تاريخ المستودع — ولم يُنتج أيٌّ منهما ما احتاجته فرقة العمليات فعلاً. مراجعة منظمة كانت لتكشف هذا السؤال في 30 دقيقة بتكلفة ضئيلة.
يرصد التحقق من المتطلبات أربع فئات من العيوب:
- أخطاء الإضافة الخاطئة — متطلبات غير صحيحة أو تتناقض مع بعضها أو مع قواعد العمل.
- أخطاء الإغفال — متطلبات مفقودة لم يُصرَّح بها أحد لكن الجميع افترض وجودها.
- أخطاء الغموض — صياغة يمكن أن يفسّرها قارئان بطريقتين مختلفتين.
- أخطاء عدم الجدوى — متطلبات لا يمكن تسليمها ضمن قيود الوقت أو الميزانية أو التكنولوجيا المتفق عليها.
الأسلوب الأول — الجولة التفقدية غير الرسمية
الجولة التفقدية مراجعة بقيادة الأقران، يعرض فيها مؤلف وثيقة المتطلبات مادته على مجموعة صغيرة من الزملاء، ويستعرض القسمَ تلو الآخر. تتسم بأنها غير رسمية وتعاونية، وتركّز على الفهم المشترك لا على تسجيل العيوب بصورة رسمية.
الصيغة النموذجية: 3–6 مشاركين، 60–90 دقيقة، شاشة مشتركة أو مسوّدة مطبوعة. يشرح المؤلف كل متطلب؛ يطرح المشاركون أسئلة، ويلاحظون التباسات، ويقترحون تحسينات في الوقت الفعلي.
مثال من نظام حجز العيادة. يستعرض محلل قسماً من مسودة وثيقة المتطلبات يتعلق بإلغاء المواعيد. يسأل مطوّر فوراً: "المتطلب 3.4 يقول إن المرضى يمكنهم الإلغاء قبل ساعتين من الموعد، لكن المتطلب 3.7 يقول إن رسالة تأكيد تُرسَل عند الإلغاء — ماذا يحدث لو كان الإلغاء قبل 90 دقيقة وفشل إرسال الرسالة؟ هل يبقى الإلغاء سارياً؟" هذا السؤال المتقاطع بين متطلبين — الذي لم يخطر ببال المؤلف الأصلي — هو تحديداً ما تكشفه الجولات التفقدية.
الجولات التفقدية سريعة وذات تكاليف منخفضة. ضعفها أن حضور المؤلف قد يُعيق النقد الصريح — إذ قد يُلطّف المراجعون ملاحظاتهم تجنباً للتوتر.
الأسلوب الثاني — الفحص الرسمي (فحص فاغان)
الفحص عملية كشف عيوب صارمة قائمة على أدوار محددة. صاغها مايكل فاغان في IBM عام 1976، ولا تزال المعيار الذهبي للمتطلبات عالية المخاطر. الفارق الجوهري عن الجولة التفقدية: المؤلف لا يعرض المادة. بدلاً من ذلك، يعيد القارئ المعيّن صياغة كل متطلب بكلماته الخاصة، مما يفرض التفسير النشط عوضاً عن الاستماع السلبي.
الأدوار المحددة:
- المُيسِّر — ميسِّر مدرَّب يُبقي الاجتماع مركّزاً ويُلزم بحدود الوقت وليس له مصلحة شخصية في الوثيقة.
- القارئ — يقرأ كل متطلب ويعيد صياغته بصوت عالٍ؛ لا يكون هو المؤلف.
- المؤلف — حاضر للإجابة عن الأسئلة الواقعية لكنه لا يدافع عن الوثيقة.
- المراجعون (2–4) — خبير المجال، مطوّر، مختبِر، و/أو ممثل المستخدم النهائي. يُعدّ كل منهم بصورة مستقلة قبل الاجتماع.
- الكاتب — يسجّل كل عيب يُثار باستخدام تصنيف مشكلات موحّد.
دورة الحياة ذات الخمس مراحل: التخطيط → الاستعراض → الإعداد الفردي → اجتماع الفحص → إعادة العمل/المتابعة. تكتشف الفحوصات باستمرار 60–80% من عيوب المتطلبات. قد تُجري متجر إلكتروني فحصاً على متطلبات تدفق الدفع، حيث يكشف إعداد مختبِر أن ثلاثة متطلبات تفترض ضمنياً بيئة بعملة واحدة — ثغرة حرجة لمنصة تخطط للتوسع في أوروبا.
الجولة التفقدية مقابل الفحص الرسمي — اختيار الأداة المناسبة
لا يتفوق أسلوب على الآخر في كل الأحوال. يعتمد الاختيار الصحيح على المخاطر والنضج والوقت المتاح.
تصنيف العيوب خلال المراجعات
كل عيب يُثار في مراجعة يجب تصنيفه لا مجرد الإشارة إليه. يبقي التصنيف القياسي عملية المتابعة قابلة للإدارة:
- جوهري — المتطلب خاطئ أو ناقص أو متناقض. يجب حله قبل التثبيت الرسمي.
- ثانوي — مشكلة نحوية أو تنسيقية أو وضوح لا تغير المعنى. يمكن إصلاحها دون إعادة الفحص.
- استفسار — سؤال يحتاج إجابة أصحاب المصلحة قبل تأكيد المتطلب. يُسنَد إلى مسؤول مُعيَّن بموعد نهائي.
النماذج الأولية ومشاهد الاستخدام بوصفهما أداة تحقق
الاجتماعات الرسمية ليست الأسلوب الوحيد للتحقق. إظهار نموذج أولي لواجهة المستخدم لأصحاب المصلحة والمرور بسيناريوهات واقعية هو في الغالب أسرع طريقة لاكتشاف متطلبات مفقودة أو مُفهومة بشكل خاطئ. حين يرى مدير عمليات لوجستي شاشة نموذج أولي لأول مرة ويقول: "أين زر إعادة التوجيه الجماعي؟ نقوم بذلك 40 مرة يومياً" — فهذه ثغرة في المتطلبات اكتُشفت عبر التحقق لا عبر التطوير.
وبالمثل، تمرير أحد أصحاب المصلحة عبر سيناريو حالة استخدام — "تخيّل أنه صباح يوم الاثنين وتغيّب أحد السائقين. أرني خطواتك في النظام" — يكشف متطلبات ضمنية لا تُميّزها أي مراجعة وثائقية.
الحصول على الموافقة: التثبيت الرسمي
التثبيت الرسمي هو الفعل الرسمي لتجميد إصدار من وثيقة المتطلبات بعد اكتمال التحقق. ليس إجراءً بيروقراطياً — بل هو اللحظة التي تتحول فيها المسوّدة إلى عقد. بعد التثبيت:
- تُوضع جميع المتطلبات المعتمدة تحت ضبط التغيير. لا تغييرات بدون طلب تغيير (CR) رسمي.
- يمكن لفريق المشروع البدء في التصميم والتقدير على أساس مستقر.
- يُقرّ أصحاب المصلحة — مثالياً كتابياً — بأن المتطلبات تعكس احتياجاتهم المتفق عليها.
من يجب أن يوقّع؟ يتوقف ذلك على المنظمة، لكن عادةً: صاحب العمل الرئيسي، وممثل المستخدم النهائي، ومدير التطوير (للتأكيد على الجدوى التقنية)، وقائد ضمان الجودة (للتأكيد على قابلية الاختبار). بالنسبة لنظام حجز عيادة، هذا يعني مدير العيادة، وموظف استقبال أو طبيب سيستخدم النظام يومياً، ومدير التطوير، ومدير الاختبار.
ماذا يحدث بعد الموافقة؟
بعد التثبيت الرسمي، تصبح وثيقة المتطلبات المرجع للتصميم والتطوير والاختبار. أي تغيير مقترح يجب أن يمر عبر لجنة ضبط التغيير (CCB) المحددة أو ما يعادلها — لتقييم الأثر على النطاق والتكلفة والجدول الزمني قبل الموافقة. هذا يتغذّى مباشرة في تتبع المتطلبات، الذي يُغطّى في الدرس القادم.
قائمة تحقق عملية للتحقق من المتطلبات
قبل إعلان مجموعة المتطلبات جاهزة للموافقة، مرّ على هذه الأسئلة لكل متطلب:
- صحيح؟ هل يعكس هذا ما يحتاجه صاحب المصلحة فعلاً؟
- لا لبس فيه؟ هل يمكن تفسيره بطريقة واحدة فقط؟
- كامل؟ هل يُحدد جميع الحالات بما فيها مسارات الأخطاء؟
- متسق؟ هل يتناقض مع أي متطلب آخر؟
- قابل للتحقق؟ هل يمكن للمختبِر كتابة حالة اختبار تؤكد ما إذا كان قد تحقق؟
- قابل للتنفيذ؟ هل يستطيع الفريق بناؤه ضمن القيود المتفق عليها؟
- قابل للتتبع؟ هل يمكن ربطه بهدف عمل أو مصدر من أصحاب المصلحة؟
أي إجابة "لا" تُعدّ عيباً. لا يجتاز أي متطلب التحقق مع وجود "لا" معلّقة.