Holarch

دليل · المتطلبات

كيف تكتب متطلبات نظام جيدة: أمثلة وقائمة تحقق

استمع إلى هذا الدليل 26 دقيقة

المتطلب الجيد يقول شيئًا واحدًا يجب أن يفعله النظام أو يكونه، بكلمات يقرؤها مهندسان بالطريقة نفسها، مع قيمة يستطيع اختبار أو تحليل فحصها. يتناول هذا الدليل الاحتياجات مقابل المتطلبات، وأجزاء عبارة المتطلب، وخصائص الجودة في ISO/IEC/IEEE 29148 وINCOSE Guide to Writing Requirements، وقائمة تحقق مع أمثلة قبل وبعد، والتحقق ومعايير القبول، وقيم TBD وTBR، وأنواع المتطلبات، وكلها مطبّقة على مواصفة واحدة لقمر CubeSat.

في هذه الصفحة
  1. لماذا تهم صياغة المتطلب
  2. احتياجات أصحاب المصلحة مقابل المتطلبات
  3. تشريح المتطلب
    1. العبارة
    2. السمات
  4. خصائص جودة المتطلب الجيد
  5. قائمة التحقق: قواعد مع أمثلة قبل وبعد
  6. اكتب طريقة التحقق ومعايير القبول مع المتطلب
  7. التعامل مع قيم TBD وTBR
  8. أنواع المتطلبات
  9. مثال تطبيقي: مراجعة مواصفة EO-1
    1. نتائج صغيرة
    2. ثلاث إعادات صياغة
  10. أخطاء شائعة
  11. جرّبه في Holarch
  12. نزّل قائمة التحقق
  13. أسئلة حول كتابة المتطلبات
    1. Shall أم must أم will؟
    2. كم متطلبًا ينبغي أن يكون للنظام؟
    3. هل قصص المستخدمين متطلبات؟
    4. هل تستطيع أداة فحص جودة المتطلبات؟
  14. إلى أين بعد ذلك

لماذا تهم صياغة المتطلب

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

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

يستخدم الدليل مثالًا واحدًا متصلًا، EO-1، قمر CubeSat خيالي بحجم 6U يصوّر الأراضي الزراعية في أربعة نطاقات طيفية. تحتوي مواصفته، SRS-001 EO-1 System Requirements Specification، على 32 متطلبًا، معظمها سليم وثلاثة منها ضعيفة عمدًا. وهو النموذج نفسه في مشروع مثال MBSE الشامل. واحتياجات أصحاب المصلحة من N1 إلى N3 المقتبسة هنا هي التي يضيفها دليل التتبع إلى النموذج.

احتياجات أصحاب المصلحة مقابل المتطلبات

تبدأ كتابة المتطلبات قبل ذلك بخطوة، بالاحتياجات. احتياج صاحب المصلحة هو ما يتوقعه المستخدم أو المشغّل أو العميل أو الجهة التنظيمية، بمصطلحاته. والمتطلب هو العبارة الهندسية التي يُصمَّم النظام ويُتحقق منه مقابلها. ويفصل ISO/IEC/IEEE 15288 بينهما في عمليتين تقنيتين منفصلتين: تعريف احتياجات أصحاب المصلحة ومتطلباتهم (6.4.2) وتعريف متطلبات النظام (6.4.3). ويقوم INCOSE Needs and Requirements Manual بالفصل نفسه ويعامل الاحتياجات عناصرَ قائمة بذاتها، لا مسودات أولية للمتطلبات.

مثال EO-1يُفحص عبر
احتياج (N2 Twice-Weekly Revisit)يحتاج عملاء المزارع إلى صور حديثة لحقولهم مرتين في الأسبوع على الأقل في موسم النمو.المصادقة: هل يحصل العملاء على ما يحتاجونه من النظام المسلَّم؟
متطلب (1.6 Revisit Time)يجب أن تعيد المهمة زيارة كل منطقة مستهدفة خلال 72 ساعة.التحقق: هل يستوفي النظام العبارة، بالاختبار أو التحليل أو الفحص أو العرض العملي؟

يظهر الفرق في طريقة فحص كل منهما. فالمتطلب يُتحقق منه: يُقاس النظام مقابل العبارة. والاحتياج يُصادَق عليه: يؤكد أحدهم أن النظام، في استخدامه المقصود، يفعل ما أراده صاحب المصلحة. وقد ينجح النظام في كل تحقق ويفشل مع ذلك في المصادقة إذا أخطأت المتطلبات الهدف؛ ويتناول دليل التحقق مقابل المصادقة هذه الفجوة. أما للكتابة فالنتيجة العملية بسيطة: اكتب الاحتياج أولًا، ثم اكتب متطلبات تلبّيه إن استُوفيت، واربط كل متطلب بالاحتياج الذي يجيب عنه.

نادرًا ما تكون الترجمة واحدًا لواحد. يصبح N2 المتطلبَ 1.6 Revisit Time، الذي يُفكَّك بعد ذلك إلى 1.6.1 Ground Track Repeat (3 أيام) و1.6.2 Off-Nadir Imaging (25 درجة). وبعض المتطلبات لا يجيب عن أي احتياج مباشرة: فالمتطلب 3.1 Orbit Average Power مشتق من 1.5 Daily Collection Volume، لأن حمل التصوير يحدد القدرة التي يجب أن تمدّها الألواح. لم يطلب أي عميل 30 W، لكن التصوير الذي طلبوه لا يمكن أن يحدث دونها.

تشريح المتطلب

المتطلب أكثر من جملته. فالجملة تحمل الالتزام؛ ومجموعة السمات حولها تحمل الأسباب، وخطة إثباته، وحفظ السجلات. والنصفان كلاهما جزء من كتابته.

العبارة

تتبع معظم عبارات المتطلبات الجيدة نمطًا واحدًا. يصفه ISO/IEC/IEEE 29148 (5.2.4) بأنه فاعل وفعل ومفعول وقيود على الفعل، مع شرط اختياري في المقدمة؛ ويوصي INCOSE Guide to Writing Requirements بالترتيب نفسه وبقوالب متفق عليها لكل نوع من المتطلبات.

الجزءما يقولهEO-1 4.3 Fault Detection
الشرط (اختياري)متى، وفي أي وضع أو حالة، ينطبق المتطلب«…of undervoltage detection» (الحدث المُطلِق)
الفاعلالنظام أو العنصر الذي يجب أن يمتثل، مسمًّى بدقة«The C&DH»
الفعل الناقصقوة الالتزام«shall»
الفعلما يفعله الفاعل أو يكونه، بفعل معلوم«enter»
المفعولما ينطبق عليه الفعل«safe mode»
الأداء أو القيدالقيمة القابلة للقياس، مع الوحدة واتجاه الحد«within 10 seconds»

معًا: «The C&DH shall enter safe mode within 10 seconds of undervoltage detection.» (يجب أن يدخل C&DH الوضع الآمن خلال 10 ثوانٍ من اكتشاف انخفاض الجهد.) ويمكن أن يتغير الترتيب («When undervoltage is detected, the C&DH shall…» يضع الشرط أولًا، كما في قوالب EARS التي تستخدمها فرق كثيرة)، لكن كل جزء يجب أن يكون موجودًا أو غائبًا عن قصد.

ثلاث كلمات تحمل معظم الثقل. Shall تميّز متطلبًا ملزمًا؛ وwill تذكر حقيقة أو نية بشأن شيء خارج النظام؛ وshould تذكر هدفًا لا يُتحقق منه. وأيًا كان العرف الذي يستخدمه المشروع، عرّفه مرة واحدة في المواصفة والتزم به. والمتطلب EO-1 1.1 Reference Orbit («The mission assumes a 500 km sun-synchronous orbit…») مكتوب بشكل صحيح افتراضًا لا متطلبًا: فهو سياق للمتطلبات التي تعتمد عليه، ويخزّنه النموذج عبارةً لا تُقيَّم ولا يُتحقق منها.

السمات

هذا هو 3.1 Orbit Average Power كما يسجّله نموذج EO-1، بعد تغيير ما بعد PDR من 28 W إلى 30 W:

السمة3.1 Orbit Average Powerلماذا هي موجودة
المعرّف والاسم3.1 Orbit Average Powerمقبض ثابت للروابط والمراجعات وطلبات التغيير
العبارةيجب أن تولّد الألواح الشمسية قدرة متوسطة مدارية لا تقل عن 30 W في نهاية العمر.الالتزام نفسه
المبرّرنما الحمل المتوسط المداري إلى 26 W بعد PDR؛ و30 W تحافظ على هامش 15%.يتيح لقارئ لاحق الحكم على تغيير دون المؤلف
المصدر والأصلمشتق (تحليل الأنظمة)؛ مشتق من 1.5 Daily Collection Volumeالتتبع إلى الخلف: لماذا يوجد المتطلب
طريقة التحقق ومستواهاختبار، على مستوى النظام الفرعيخطة إثباته، تُقرَّر أثناء الكتابة
معايير النجاحالقدرة المتوسطة المدارية في نهاية العمر متنبَّأ بها من القدرة القصوى المقيسة.أي نتيجة تُعدّ استيفاءً
المالك، والأولوية، والأهمية الحرجةPower Engineer؛ عالية؛ عاليةمن يُسأل عنه ومدى أهميته
الحالةقيد المراجعة (كان معتمدًا؛ وتغيّر نصه بعد الاعتماد)موقعه في عملية الاتفاق
TBD/TBRلا شيءهل ما زالت قيمة مفتوحة

يسرد ISO/IEC/IEEE 29148 (5.2.8) سمات من هذا النوع، ويضيف دليل INCOSE المزيد؛ ويختار المشروع ما سيحافظ عليه فعلًا. والمبرّر أكثرها إغفالًا وأكثرها افتقادًا لاحقًا. فدون «حمل 26 W، وهامش 15%» لا يستطيع الشخص التالي الذي يرى 3.1 معرفة هل 30 W حد فيزيائي صارم أم رقم من العميل أم اختيار هامش، فلا يستطيع معرفة ما يعنيه تغيير الحمل له.

خصائص جودة المتطلب الجيد

تسهل قواعد الأسلوب حين تعرف ما تحميه. يسمّي ISO/IEC/IEEE 29148 (5.2.5) تسع خصائص للمتطلب المنفرد، ويستخدم INCOSE Guide to Writing Requirements الخصائص التسع نفسها بوصفها C1 إلى C9، لكل منها تعريف قصير والقواعد التي تدعمها. ويضع الجدول كلًا منها سؤالًا يستطيع المراجع طرحه.

الخاصيةالسؤال الواجب طرحهمثال EO-1
ضروريلو حُذف، هل يضيع شيء يحتاجه أصحاب المصلحة؟ وهل هو غير مكرر؟3.1 ضروري: فدونه لا شيء يحجّم الألواح لحمل التصوير.
ملائمهل هو مكتوب في المستوى الصحيح، دون تثبيت خيار تصميم يجب أن يتخذه المستوى الأدنى؟يحدد 3.1 مستوى قدرة للألواح، لا نوع خلايا أو عدد ألواح.
غير ملتبسهل يمكن قراءته بطريقة واحدة فقط؟يفشل 6.4 «user friendly»: سيختلف مراجعان على استيفائه.
مكتملهل يقول كل ما يلزم، دون شرط أو قيمة مفقودة؟يفشل 3.5 «warm enough (TBD)»: القيمة مفقودة.
مفردهل يذكر التزامًا واحدًا؟يفشل 2.5: يطلب التعافي واستئناف التصوير، مربوطين بـ «and».
قابل للتحقيقهل يمكن استيفاؤه ضمن القيود المعروفة للتقنية والكلفة والجدول الزمني؟3.1 عند 30 W موضع تساؤل: فالألواح كما صُممت تعطي نحو 28 W متوسطًا مداريًا.
قابل للتحققهل يستطيع اختبار أو تحليل أو فحص أو عرض عملي إثبات استيفائه؟يفشل 2.5 «quickly»؛ وتنجح «within 6 hours».
صحيحهل يذكر الاحتياج الحقيقي لمصدره، بالقيمة الصحيحة؟يعبّر 1.2 بمسافة عينة أرضية 4.5 m تعبيرًا صحيحًا عن N3 (خرائط على مستوى الحقل)، مع هامش.
مطابقهل يتبع القوالب والمفردات المتفق عليها في المشروع؟يستخدم كل متطلب في EO-1 «shall» وفاعلًا مسمًّى ووحدات SI.

لمجموعة المتطلبات خصائص خاصة بها لا تستطيع أي عبارة منفردة إظهارها. يسرد ISO/IEC/IEEE 29148 (5.2.6) المجموعة بأنها مكتملة، ومتسقة، وقابلة للتحقيق ككل، ومفهومة، وقابلة للمصادقة؛ ويضيف دليل INCOSE صحيحة بوصفها C15 ويرقّم خصائص المجموعة من C10 إلى C15.

  • مكتملة: تغطي المجموعة الاحتياجات. يذكر EO-1 ما يحدث عند انخفاض الجهد (4.3) لكن متطلب التعافي من الوضع الآمن الوحيد فيه هو 2.5، غير القابل للتحقق كما كُتب، فالتعافي غير محدد فعليًا.
  • متسقة: لا يتعارض متطلبان، وتُستخدم المصطلحات والوحدات بالطريقة نفسها. يطلب 1.5 مقدار 3.2 GB من بيانات الصور يوميًا ويطلب 5.4 مقدار 3 GB مستقبَلة على الأرض؛ ولا يتفقان إلا لأن مبرّر 5.4 يقول «after compression». ودون المبرّر يبدوان متعارضين.
  • قابلة للتحقيق: يمكن استيفاء المتطلبات معًا. قد يكون كل متطلب قدرة قابلًا للتحقيق وحده، بينما قد لا تكون 30 W متوسطًا مداريًا ومساحة الألواح وميزانية الكتلة كذلك مجتمعة.
  • مفهومة: يستطيع القارئ معرفة ما يُتوقع من النظام وكيف ترتبط المتطلبات، وهذا يعتمد على البنية والترقيم والتتبع بقدر ما يعتمد على الصياغة.
  • قابلة للمصادقة: يمكن إثبات أن المجموعة تؤدي إلى نظام يلبّي الاحتياجات، ولهذا يرتبط كل متطلب في المستوى الأعلى باحتياج.

قائمة التحقق: قواعد مع أمثلة قبل وبعد

تصبح الخصائص قابلة للاستخدام عبر قواعد كتابة ملموسة. يرقّمها INCOSE Guide to Writing Requirements (R1، R2، وهكذا)؛ ولدى NASA Systems Engineering Handbook (الملحق C) قائمة تحقق أقصر على المنوال نفسه. ويجمع الجدول القواعد التي تكتشف معظم المشكلات في الممارسة، مع مثال من مواصفة EO-1 لكل منها. «قبل» هو النص كما هو في المشروع التوضيحي؛ و«بعد» إعادة صياغة. والقيم الموسومة بأنها توضيحية تُظهر الشكل، لا نتائج تحليلات EO-1.

القاعدةالسؤال الواجب طرحهقبل (EO-1)بعد
التزام واحد لكل عبارة«shall» واحدة بالضبط، دون «and» أو «or» أو «and/or» تربط بين مطلبين؟2.5: «The spacecraft should recover from safe mode quickly and resume imaging as appropriate» (ينبغي أن تتعافى المركبة من الوضع الآمن بسرعة وتستأنف التصوير حسب الاقتضاء)«The spacecraft shall resume imaging within 6 hours of a safe mode entry.» (يجب أن تستأنف المركبة التصوير خلال 6 ساعات من دخول الوضع الآمن.) وخطوات التعافي الأخرى المهمة تحصل على متطلبات خاصة بها.
صياغة إلزامية«Shall» لمتطلب ملزم، لا «should» أو «will» أو «may»؟2.5: «should recover»«shall resume»
قيمة قابلة للقياس مع وحدةهل لكل كلمة أداء رقم ووحدة؟2.5: «quickly»«within 6 hours of a safe mode entry» (خلال 6 ساعات من دخول الوضع الآمن)
اتجاه الحد مذكورهل من الواضح أن القيمة حد أدنى أم حد أقصى؟1.6.2: «image targets up to 25 degrees off nadir»«image targets at off-nadir angles from 0 to 25 degrees» (مدى قدرة، لا سقف للتوجيه)
لا عبارات تملّصهل يُترك شيء لتقدير المورّد («as appropriate»، «if possible»، «where practical»)؟2.5: «as appropriate»حُذفت؛ ويُذكر الشرط المهم
لا مصطلحات مبهمة أو ذاتيةهل يمكن أن يختلف مراجعان على استيفائه («user friendly»، «easy»، «adequate»، «enough»)؟6.4: «The operator interface shall be user friendly and/or easy to use.»«The operator interface shall let a trained operator book a ground station contact in no more than 5 minutes.» (يجب أن تتيح واجهة المشغّل لمشغّل مدرَّب حجز اتصال بمحطة أرضية في 5 دقائق على الأكثر.) (توضيحي؛ متطلب واحد لكل مهمة مهمة)
أسماء صريحة، لا ضمائرهل لكل «it» أو «its» أو «this» مرجع واحد ممكن بالضبط؟1.6.1: «The reference orbit shall repeat its ground track every 3 days.»«The reference orbit shall repeat the ground track every 3 days.» الضمير غير ضار هنا، لكنه في جملة أطول أول ما ينحرف.
الشروط مذكورةهل يقول متى تنطبق القيمة: مرحلة العمر، أو الوضع، أو البيئة؟«The solar arrays shall generate 30 W.»«…at least 30 W orbit-average power at end of life.» (…قدرة متوسطة مدارية لا تقل عن 30 W في نهاية العمر.)
قيم محسومة، أو TBD متابَعةهل كل قيمة مفتوحة متابَعة مع مالك وموعد استحقاق، لا مكتوبة في النص فقط؟3.5: «The thermal design shall keep the battery warm enough (TBD).»«The thermal design shall keep the battery cell temperature at or above 0 °C while charging.» (يجب أن يُبقي التصميم الحراري درجة حرارة خلايا البطارية عند 0 °C أو أعلى أثناء الشحن.) (توضيحي؛ وحتى يحددها التحليل الحراري، تسمّي سمة TBD الـ Thermal Engineer وموعد استحقاق)
لا أسباب أو ملاحظات في العبارةهل نُقلت عبارات الغرض («so that»، «in order to») والملاحظات بين الأقواس إلى المبرّر؟3.5: «(TBD)»العبارة دون أقواس؛ والسبب في «المبرر»
ماذا، لا كيفهل يذكر الاحتياج بدل فرض حل يجب أن يختاره المستوى الأدنى؟«The thermal design shall keep the battery warm by means of a 2 W film heater.» (توضيحي)إعادة صياغة 3.5 أعلاه: حد لدرجة الحرارة، مع ترك السخان للتصميم الحراري
إيجابي وقابل للتحقيقهل يتجنب «not» و«never» و«always» و«100%» حيث يُقصد حد قابل للقياس؟«The C&DH shall never lose a stored command.» (توضيحي)«The C&DH shall execute each stored command within 1 second of the scheduled time.» (4.2 كما كُتب)
المبرّر مسجَّلهل يقول لماذا اختيرت القيمة؟3.1 دون مبرّرالمبرر: «نما الحمل المتوسط المداري إلى 26 W بعد PDR؛ و30 W تحافظ على هامش 15%.»
طريقة التحقق ومعاييرههل اختيرت الطريقة واشتُق معيار النجاح من العبارة؟3.1: الطريقة Test؛ ويتوقع TC-06 قدرة قصوى ≥ 72 Wمعيار النجاح مشتق عبر ميزانية القدرة: نحو 80.6 W قدرةً قصوى مقابل 30 W متوسطًا مداريًا (انظر القسم التالي)
قابل للتتبع إلى الأعلىمرتبط باحتياج أو أصل أو متطلب مصدر؟3.1 دون رابط سابق3.1 مشتق من 1.5 Daily Collection Volume
فريدهل يقول متطلب آخر الشيء نفسه بكلمات أخرى؟عبارة ثانية «The battery shall store 77 Wh» تحت القسم الحراري (توضيحي)متطلب واحد، 3.2 Battery Capacity، يُشار إليه حيث يلزم

قائمة التحقق أداة للمراجع، لا قالب للكتابة. اقرأ كل متطلب مرة واحدة مقابل القائمة كلها بدل البحث عن قاعدة واحدة في كل مرة، وسجّل النتيجة مع القاعدة التي يخالفها، ليعرف المؤلف ما يغيّره. وللقواعد أيضًا إيجابيات كاذبة. فالفحص بقائمة الكلمات يميّز «every» في 1.6.1 مُحدِّدًا كليًا، لكن «every 3 days» فترة زمنية، لا ادعاء عن جميع الحالات؛ والمراجع يقرّر.

اكتب طريقة التحقق ومعايير القبول مع المتطلب

أسهل وقت لفحص خاصية قابلية التحقق لحظة كتابة المتطلب: إن لم يستطع المؤلف أن يقول كيف سيُثبَت استيفاؤه، فهو غير منتهٍ. سجّل أمرين مع كل متطلب.

  • طريقة التحقق: الاختبار أو التحليل أو الفحص أو العرض العملي، ومستوى التجميع الذي يُجرى عنده (مكوّن، نظام فرعي، نظام). ولدى EO-1 الأربع كلها: يُتحقق من 3.1 بالاختبار، ومن 1.5 Daily Collection Volume بالتحليل، ومن 3.4 Bus Regulation بالفحص، ومن 6.1 Contact Scheduling بالعرض العملي. ويشرح دليل RVTM كيف تختار بينها.
  • معايير النجاح (معايير القبول): النتيجة القابلة للملاحظة التي تُعدّ استيفاءً، مذكورة بحيث يمكن كتابة الاختبار أو التحليل منها. للمتطلب 3.2 Battery Capacity: «سعة مقيسة لا تقل عن 77 Wh عند C/2 و20 °C.» وللمتطلب 6.2 Image Delivery: «المنتجات على البوابة خلال 6 h في 95% من المرورات في التمرين.»

كتابة المعايير بجوار العبارة تكشف فئة من الأخطاء لا تُكتشف إلا في النهاية. يُتحقق من 3.1 في EO-1 عبر TC-06 Solar Array Power Test، الذي يقيس القدرة القصوى على محاكي شمسي وينجح عند 72 W أو أكثر. لكن المتطلب يتعلق بالقدرة المتوسطة المدارية، ويحوّل النموذج إحداهما إلى الأخرى بنسبة الإضاءة (0.62) وكفاءة مسار القدرة (0.6). فقدرة قصوى 72 W تعطي 72 × 0.62 × 0.6 = 26.8 W متوسطًا مداريًا، وهي أقل من 28 W الأصلية، فضلًا عن 30 W الحالية. لم تُشتق عتبة الاختبار من المتطلب. قاس TC-06 قيمة 75.1 W و«نجح»، لكن 75.1 W تتحول إلى 27.9 W، دون القيمتين كلتيهما. ولو كُتب المعيار من العبارة، لكان نحو 30 / (0.62 × 0.6) = 80.6 W قدرةً قصوى، ولظهر القصور في الاختبار الأول. ويتابع دليل تحليل أثر التغيير النتيجة نفسها عبر التغيير من 28 W إلى 30 W.

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

التعامل مع قيم TBD وTBR

في بداية المشروع تكون بعض القيم غير معروفة بعد. وإغفال المتطلب يُخفي الثغرة؛ واختلاق رقم يُخفي عدم اليقين. والممارسة المعتادة كتابة المتطلب مع عنصر نائب ومتابعة العنصر النائب بندًا مفتوحًا.

  • TBD (يُحدَّد لاحقًا): لا قيمة بعد. «يجب أن يُبقي التصميم الحراري درجة حرارة خلايا البطارية عند TBD °C أو أعلى أثناء الشحن.»
  • TBR (يُراجَع لاحقًا، وأحيانًا «يُحسم لاحقًا»): أفضل قيمة حالية غير مؤكدة. «…خلال 60 ثانية» مع وسم 60 بأنها TBR.

فضّل TBR مع تقدير على TBD مجردة حيثما وُجد أي أساس لرقم: يستطيع المصممون العمل وفق تقدير، والقيمة التي تتحرك لاحقًا تغيير يتبعه التتبع. ويحتاج كل بند مفتوح إلى ثلاثة أمور، وإلا فهو غير مُدار:

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

في مواصفة EO-1 ثلاثة بنود مفتوحة. 3.5 Battery Thermal Control قيمة TBD يملكها Thermal Engineer ومتأخرة بالفعل. و2.4 Target Slew («through 30 degrees within 60 seconds») قيمة TBR يملكها ADCS Lead، و5.3 Downlink Link Margin («at least 3 dB link margin at 10 degrees elevation») قيمة TBR يملكها Comms Lead؛ وكلاهما يحمل قيمًا عملية تستخدمها التصاميم ريثما تنتهي التحليلات.

عُدّ البنود المفتوحة عند كل معلم وتوقّع أن ينخفض العدد. فخط أساس المتطلبات الذي فيه قيم TBD مفتوحة كثيرة خط أساس بالاسم فقط. وتطلب معايير المراجعة في NASA Systems Engineering Handbook، بدءًا من مراجعة متطلبات النظام، تحديد بنود TBD وTBR المفتوحة مع خطة وجدول زمني لإغلاقها. ومكان المتابعة سمة أو سجل، لا النص وحده: فـ «TBD» المكتوبة داخل جملة بلا مالك ولا تاريخ، ولا شيء يذكّر أحدًا بإغلاقها.

أنواع المتطلبات

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

النوعما يذكرهمثال EO-1انتبه إلى
وظيفيما يجب أن يفعله النظام4.3 Fault Detection: «يجب أن يدخل C&DH الوضع الآمن خلال 10 ثوانٍ من اكتشاف انخفاض الجهد.»وظيفة دون أداء مرفق؛ فمعظم المتطلبات الوظيفية تحتاج أيضًا إلى «بأي جودة»، وهنا «خلال 10 ثوانٍ»
أداءمدى جودة أداء الوظيفة: الكمية، والمعدل، والدقة، والزمن2.1 Pointing Accuracy: «يجب أن يوجّه ADCS محور تصويب الحمولة ضمن 0.1 درجة من الهدف المأمور.»الشروط المفقودة (أي وضع، وأي مرحلة عمر) واتجاه الحد المفقود
الواجهةما يعبر حدًا مع نظام أو عنصر آخر، وخصائصه5.2 UHF Command Uplink: «يجب أن يستقبل جهاز الإرسال والاستقبال UHF الأوامر الأرضية بمعدل 9.6 kbps.» ويوجد التعريف الكامل في مستند التحكم في الواجهات.متطلبات تعيد ذكر ICD بدل الإشارة إليه، فيتباعد الاثنان
القيدحد على التصميم أو على طريقة بناء النظام، مفروض من الخارج4.4 Downlink Encryption: «يجب أن يشفّر C&DH كل إطار تنزيل بمفاتيح 256-bit.» ومبرّره: يشترط عقد العميل تشفير الصور أثناء النقل، فالمتطلب يأتي من خارج المشروع، لا من مفاضلة داخله.خيارات تصميم مكتوبة قيودًا مع أن أحدًا من الخارج لم يفرضها
البيئية، والموثوقية، والسلامةالظروف التي يجب تحمّلها والاعتمادية التي يجب بلوغها1.7 Mission Lifetime: «يجب أن تعمل المركبة في المدار 730 يومًا على الأقل.»قيم دون الاحتمال أو مستوى الثقة الذي تُدّعى عنده

كثيرًا ما يُرسم الحد بين المتطلبات الوظيفية ومتطلبات الأداء داخل جملة واحدة: فمتطلبات كثيرة تذكر وظيفة مع أدائها، كما يفعل 4.3. وهذا مقبول ما دامت الجملة تحمل التزامًا واحدًا. ويتناول دليل مستند التحكم في الواجهات متطلبات الواجهات بعمق أكبر، ويتناول دليل التحليل الوظيفي الوظائف التي وراء المتطلبات الوظيفية.

مثال تطبيقي: مراجعة مواصفة EO-1

تقسم مراجعة SRS-001 مقابل قائمة التحقق المتطلبات الـ 32 إلى ثلاث مجموعات. معظمها ينجح. وبعضها فيه نتائج صغيرة تستحق جملة لكل منها. وثلاثة تحتاج إلى إعادة صياغة.

يتفق الفحص الآلي للمواصفة نفسها مع المراجعة: 29 من 32 متطلبًا تُقيَّم جيدة، والثلاثة الضعيفة تحتاج إلى إعادة عمل. وتسرد نتائج 2.5 كل قاعدة مخالَفة باسمها ورقمها، وهذا ما يحتاجه المؤلف لإصلاحه. ويميّز الفحص أيضًا ما لا يستطيع البت فيه: ففي 3.1 تنتظر الصحة وقابلية التحقيق مراجعًا لأن النص تغيّر بعد آخر مراجعة.

نتائج صغيرة

  • 1.6.2 Off-Nadir Imaging، «up to 25 degrees off nadir»: تُقرأ «up to» حدًا أقصى، لكن المقصود قدرة يجب أن تملكها المركبة عند أي زاوية من 0 إلى 25 درجة. والقراءة الخاطئة ستسمح لتصميم لا يصوّر إلا عند النظير بالامتثال.
  • 1.6.1 Ground Track Repeat، «its ground track»: ضمير له مرجع ممكن واحد فقط، فالنتيجة ثانوية. و«every» في الجملة نفسها إيجابية كاذبة لقاعدة المُحدِّد الكلي.
  • لدى 1.5 Daily Collection Volume طريقة (التحليل) ومعايير نجاح («حجم يومي محاكى لا يقل عن 3.2 GB على خطة مدتها 30 يومًا») لكن لا تحليل مرتبطًا بعد. الصياغة جيدة؛ والتحقق لم يُنجَز.
  • 3.1 Orbit Average Power مكتوب جيدًا، لكن نصه تغيّر بعد الاعتماد، فتحتاج صحته وقابلية تحقيقه إلى حكم مراجع مجددًا. وقابلية التحقيق هي السؤال الحقيقي: فالألواح كما صُممت تعطي نحو 28 W متوسطًا مداريًا.

ثلاث إعادات صياغة

2.5 Safe Mode Recovery. تخالف العبارة «The spacecraft should recover from safe mode quickly and resume imaging as appropriate» ست قواعد على الأقل: «should» بدل «shall»، والتزامان مربوطان بـ «and»، و«quickly» دون قيمة، وعبارة التملّص «as appropriate»، وغياب النقطة الختامية، وغياب التحقق. وتحتفظ إعادة الصياغة بالنتيجة الوحيدة المهمة للعميل وتمنحها قيمة:

يجب أن تستأنف المركبة التصوير خلال 6 ساعات من دخول الوضع الآمن.

يجب أن يقول المبرّر من أين تأتي الساعات الست (يطلب N1 تنبيهات إجهاد المحاصيل في اليوم نفسه، ويسمح 6.2 بست ساعات من التنزيل حتى التسليم). وإن كانت خطوات التعافي مهمة بحد ذاتها، مثل استعادة التوجيه نحو الشمس أو الإبلاغ عن السبب، صار كل منها متطلبًا خاصًا. الطريقة: الاختبار، بحقن الأعطال على flatsat؛ ومعيار النجاح: يُستأنف التصوير خلال 6 ساعات في كل دخول محقون إلى الوضع الآمن.

3.5 Battery Thermal Control. في «The thermal design shall keep the battery warm enough (TBD).» مصطلح مبهم، وTBD في النص، وقوسان. ويفصل الإصلاح بين الالتزام والقيمة المفتوحة والسبب:

يجب أن يُبقي التصميم الحراري درجة حرارة خلايا البطارية عند 0 °C أو أعلى أثناء الشحن.

قيمة 0 °C توضيحية: فخلايا الليثيوم أيون لا تُشحن عادةً تحت درجة التجمد، لكن الحد الحقيقي يأتي من ورقة بيانات الخلية والتحليل الحراري. وحتى يحدده ذلك التحليل، تكون القيمة TBR يملكها Thermal Engineer، مع موعد استحقاق قبل مراجعة التصميم الحراري. وتكشف إعادة الصياغة أيضًا ثغرة أخفاها الأصل: لا متطلب لمدى درجة حرارة التفريغ، وهو يحتاج إلى عبارة خاصة به.

6.4 Operator Interface. في «The operator interface shall be user friendly and/or easy to use.» مصطلحان ذاتيان و«and/or». ويمكن تحديد قابلية الاستخدام، لكن فقط عبر مهام قابلة للملاحظة:

يجب أن تتيح واجهة المشغّل لمشغّل مدرَّب حجز اتصال بمحطة أرضية في 5 دقائق على الأكثر.

المهمة والزمن توضيحيان. والمجموعة الحقيقية تسرد المهام القليلة المهمة (حجز اتصال، ورفع قائمة أهداف، وقراءة أحدث قياسات الحالة عن بُعد)، لكل منها زمن وحد للأخطاء، تُقاس في عرض عملي مع مشغّلين أتمّوا التدريب.

أخطاء شائعة

الخطأما الذي يسوءالأفضل
كتابة حلول التصميم متطلباتيُثبَّت التصميم قبل إجراء المفاضلة، ويُستبعد خيار أفضل دون أن يقرّر أحد ذلك.اذكر الاحتياج («أبقِ الخلايا عند 0 °C أو أعلى أثناء الشحن») ودع المستوى الأدنى يختار السخان.
نسخ لغة أصحاب المصلحة مباشرة إلى المتطلبات«صور حديثة مرتين في الأسبوع» احتياج؛ ولا يمكن التحقق منه كما كُتب.احتفظ بالاحتياج، واكتب متطلبًا بقيمة وشرط يلبّيه (1.6 خلال 72 ساعة).
عدة متطلبات في فقرة واحدةيحمل معرّف واحد عدة التزامات تتقاسم حالة واحدة واختبارًا واحدًا ومصيرًا واحدًا.متطلب واحد لكل عنصر، و«shall» واحدة لكل عبارة.
قيم دون شروط«30 W» في بداية العمر وفي نهايته تصميمان مختلفان.اذكر الوضع ومرحلة العمر والبيئة وطريقة حساب المتوسط.
لا مبرّرلا يستطيع أحد الحكم على تغيير لاحق، ويبقى المتطلب طويلًا بعد زوال سببه.اكتب السبب والأرقام التي وراء القيمة.
عتبات اختبار غير مشتقة من المتطلبينجح اختبار بينما المتطلب غير مستوفى (TC-06 عند 72 W قدرةً قصوى مقابل 28 W متوسطًا مداريًا).اشتق معيار النجاح من العبارة بالحساب، وسجّله.
TBD مكتوبة في النص ومنسيةالقيمة المفتوحة بلا مالك ولا تاريخ وتصل إلى خط الأساس.تابع كل TBD وTBR مع مالك وموعد استحقاق وخطة إغلاق.
الإفراط في التحسينمتطلبات لم يطلبها أحد تستهلك جهد التصميم والاختبار.تحقّق من أن كل متطلب في المستوى الأعلى يُتتبَّع إلى احتياج أو مصدر.
الإفراط في الاعتماد على الفحوص الآليةيُعدّ فحص الكلمات النظيف متطلبًا صحيحًا.استخدم الأدوات للقواعد الآلية؛ ويحكم شخص على الصحة وقابلية التحقيق والضرورة.

جرّبه في Holarch

في مشروع LML، كل متطلب كيان من الفئة Requirement بالسمات الموصوفة أعلاه: المبرر، والحالة، والأولوية، والأهمية الحرجة، والمالك، والمصدر، وطريقة التحقق، ومستوى التحقق، ومعايير النجاح، وحقول TBD/TBR.

  1. أنشئ المشروع التوضيحي من إدارة المشاريع ← ملفات المشروع ▾ ← مشروع توضيحي جديد ← CubeSat (هندسة أنظمة موجّهة). تحتوي مواصفته المتطلبات الثلاثة الضعيفة وبنود TBD/TBR المفتوحة المستخدمة في هذا الدليل.
  2. افتح الاحتياجات والمتطلبات ← الجودة، واختر المستند في قائمة النطاق وانقر فحص الجودة. يُقيَّم كل متطلب على الخصائص التسع، وتسمّي الاقتراحات أرقام القواعد من دليل INCOSE التي تستطيع قائمة كلمات أو نمط فحصها. ويحتاج Correct وFeasible إلى مراجع: انقر العلامة لتسجيل القرار.
  3. أعد صياغة 2.5 كما سبق وشغّل الفحص مجددًا. تختفي نتائج أداة الربط وعبارة التملّص والمصطلح المبهم.
  4. افتح الاحتياجات والمتطلبات ← TBD/TBR لترى البنود المفتوحة مع المالكين ومواعيد الاستحقاق، وإغلاق أحدها حين تُحسم قيمته.
  5. للحصول على رأي ثانٍ في الخصائص التي لا تستطيع القاعدة البت فيها، استخدم ✦ الذكاء الاصطناعي ▾ ← فحص المتطلبات بالذكاء الاصطناعي؛ ويُعرض كل حكم وكل إعادة صياغة للمراجعة قبل أن يتغير أي شيء.

المرجع الكامل في وثائق جودة المتطلبات وسجل TBD/TBR.

نزّل قائمة التحقق

تحتوي قائمة تحقق جودة المتطلبات مع أمثلة قبل وبعد من EO-1 (CSV) قواعد قائمة التحقق مع أسئلة المراجعة والأمثلة، للاستخدام في مراجعة أو نقطةَ انطلاق لقواعد الكتابة الخاصة بالمشروع. ويقدّم دليل التتبع الملف نفسه.

أسئلة حول كتابة المتطلبات

Shall أم must أم will؟

أي عرف يصلح إن عرّفته المواصفة والتزمت به. والأكثر انتشارًا يستخدم «shall» للمتطلبات الملزمة، و«will» للحقائق والنيات بشأن أشياء خارج النظام، و«should» للأهداف التي لا يُتحقق منها. وتفضّل بعض أدلة الأسلوب الحكومية «must» لأسباب تتعلق باللغة الواضحة. والمشكلة الحقيقية هي الخلط بينها داخل مواصفة واحدة.

كم متطلبًا ينبغي أن يكون للنظام؟

لا يوجد عدد صحيح. فقد يكون للمركبة الصغيرة بضع عشرات من متطلبات النظام وبضع مئات تحتها؛ وللبرنامج الكبير آلاف. والأسئلة الأكثر فائدة: هل يُتتبَّع كل متطلب إلى احتياج أو أصل، وهل لكل احتياج متطلبات تحته؟

هل قصص المستخدمين متطلبات؟

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

هل تستطيع أداة فحص جودة المتطلبات؟

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

إلى أين بعد ذلك