حافظ على قابلية تتبّع المتطلبات مع تغيّر البرمجيات

صف سلوكاً يستطيع شخص التحقق منه

تترك عبارة «أنشئ تصديراً حديثاً لبيانات العملاء» قرارات مهمة مفتوحة. فهي لا تحدّد المستخدمين أو السجلات أو الحقول أو السلوك عند الإخفاق. يجب أن يسأل الوكيل أو يضع افتراضات. ويصعب مراجعة الافتراضات غير المسجّلة لاحقاً.

استخدم متطلباً خيالياً بحد واضح: يستطيع مدير جرت مصادقته تصدير بيانات العملاء النشطين من مؤسسته. يتضمن التصدير معرّف العميل واسم العرض. ويستبعد تفاصيل الاتصال والسجلات المؤرشفة. ولا يحصل مستخدم دون دور المدير على أي تصدير.

ما زال هذا يحتاج إلى قرارات عن التنسيق والحجم وزمن الاستجابة ومعالجة الإخفاق. علّم الأمور المجهولة بوضوح. تكشف المواصفات المفيدة الغموض بدلاً من إخفائه في نص واثق.

افصل المتطلبات عن اختيارات التنفيذ

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

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

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

أنشئ سلسلة أدلة قصيرة

استخدم معرّفات تبقى مفهومة في المراجعات. في هذا المثال، يمكن أن يعرّف EXPORT-01 حد المؤسسة. الاسم توضيحي، وليس نظام ترقيم مطلوباً.

يجب أن تشير السلسلة إلى أدلة فعلية. لا يثبت احتواء اسم اختبار على معرّف المتطلب أن شرط التحقق يفحصه. افحص الاختبار ومسار شيفرة الإنتاج الذي يختبره.

يوفّر SSDF من NIST سياقاً للمتطلبات والتحقق ضمن التطوير الآمن. استخدم قابلية التتبّع لجعل هذه الأنشطة قابلة للفحص، لا لإنتاج توثيق لذاته. اقرأ الإطار.

راجع أثر افتراض تغيّر

افترض أن العمل يحتاج الآن إلى بيانات العملاء المؤرشفين. يؤثر هذا التغيير في أكثر من خيار في الاستعلام. افحص قواعد الاحتفاظ والتخويل والحجم المتوقع والشروح المقدّمة للمستخدم ومعنى التقارير الموجودة.

علّم الوثائق والفحوص المتأثرة للمراجعة. احتفظ بالقرار السابق حتى يستطيع المشغّل شرح إصدار أقدم. ولا تعِد كتابة التاريخ بصمت لتجعل التصميم الأحدث يبدو حتمياً.

يمكن للوكيل المساعدة في العثور على المراجع واقتراح تحديثات. ويجب أن يحسم المسؤولون المعنيون المتطلبات المتعارضة ويقبلوا السلوك المتغيّر. قائمة الملفات المطابقة نقطة بداية، وليست تقييماً كاملاً للأثر.

أبقِ السجل صغيراً بما يكفي لاستخدامه

سجّل القرارات التي تؤثر في التنفيذ والتحقق والتشغيل. تجنّب تكرار المتطلب نفسه في وثائق كثيرة غير مترابطة. فضّل روابط إلى مصدر واحد تجري صيانته.

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