Holarch
فصول الدورة

التدريب · المسار 2. المتطلبات والتحقق · الفصل 2.1 من 6

2.1 كتابة المتطلبات وفحص الجودة 3:37

اكتب المتطلبات مع سماتها، ودع فحص الجودة يكتشف الصياغة الضعيفة.

يعرض Holarch 1.27.

كل الفصول · 2.2 تتبع الاحتياجات إلى المتطلبات ←

ما ستتعلمه

  • اكتب متطلبًا كعبارة shall واحدة قابلة للاختبار بقيمة قابلة للقياس
  • أضف متطلبًا تحت قسم من مواصفة
  • اضبط أولوية متطلب وطريقة التحقق منه ومبرره وتسمية نوعه
  • شغّل فحص الجودة على مستند وأصلح متطلبًا يعلّمه
  • علّم «صحيح» و«قابل للتنفيذ» بعد مراجعة متطلب بنفسك

اكتب المتطلبات في مواصفة Bike-Share Dock: ما الذي يجعل المتطلب جيدًا، وإضافة المتطلبات تحت الأقسام، وملء الأولوية وطريقة التحقق والمبرر، وإعطاؤها تسميات، وتشغيل فحص جودة المتطلبات، وإصلاح متطلب ضعيف، وتسجيل حكم المراجع.

ملفات المشاريع

  • مشروع البداية (.holarch.json؛ إدارة المشاريع ← ملفات المشروع ▾ ← استيراد مشروع (.json)…)
  • المشروع المكتمل (.holarch.json؛ إدارة المشاريع ← ملفات المشروع ▾ ← استيراد مشروع (.json)…)

يُشغَّل الفيديو من holarch.app؛ راجع سياسة الخصوصية.

التطبيق العملي

نفّذ هذا بنفسك في Holarch، على المشروع التوضيحي CubeSat EO-1.

  1. افتح مشروع EO-1 التوضيحي الخاص بك (أو أنشئه: إدارة المشاريع ← ملفات المشروع ▾ ← مشروع توضيحي جديد ← CubeSat (هندسة أنظمة موجّهة)).
  2. افتح الاحتياجات والمتطلبات ← المستندات ← EO-1 System Requirements Specification. حدد القسم 5 Communications، وانقر + تابع، وسمّ المتطلب Command Link Margin، واكتب عبارة shall بقيمة (مثلًا، هامش لا يقل عن 6 dB عند زاوية ارتفاع 5 درجات).
  3. في لوحة الخصائص، اضبط الأولوية على High، وطريقة التحقق على Analysis، وأضف المبرر، ثم انقر + تسمية واختر Performance Requirement.
  4. افتح الاحتياجات والمتطلبات ← الجودة، واختر Document: EO-1 System Requirements Specification في شريط النطاق ثم انقر فحص الجودة. اقرأ الاقتراحات الخاصة بـ 2.5 Safe Mode Recovery.
  5. أعد كتابة 2.5 كعبارة واحدة قابلة للقياس (ما الذي يطلق الاسترداد، وبأي سرعة، وإلى أي وضع)، ثم انقر فحص الجودة مرة أخرى.
  6. راجع ما أعدت كتابته، ثم انقر ✘ تحت صحيح وقابل للتنفيذ في صفه لتعليمهما بـ «نعم».

تكون قد انتهيت عندما تحصل 2.5 Safe Mode Recovery على درجة أعلى من قبل، ولا تعود اقتراحاتها تذكر كلمات مبهمة، ويظهر ✔ تحت «صحيح» و«قابل للتنفيذ».

اختبر نفسك

  1. لماذا يحصل متطلب مربوط بـ and على درجة أقل حتى لو كان النصفان جيدين؟
  2. لماذا لا يستطيع الفحص التلقائي أبدًا تعليم «صحيح» و«قابل للتنفيذ»؟
  3. ما الذي يجعل كلمة مثل quickly مشكلة في متطلب؟
إظهار الإجابات
  1. لماذا يحصل متطلب مربوط بـ and على درجة أقل حتى لو كان النصفان جيدين؟

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

  2. لماذا لا يستطيع الفحص التلقائي أبدًا تعليم «صحيح» و«قابل للتنفيذ»؟

    تحديد ما إذا كان المتطلب يعبّر عن الاحتياج الصحيح وما إذا كان قابلًا للبناء يتطلب حكمًا هندسيًا. يراجعه شخص ويعلّم هذين المعيارين.

  3. ما الذي يجعل كلمة مثل quickly مشكلة في متطلب؟

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

قراءة المزيد

النص المكتوب

إظهار النص المكتوب (التعليق الصوتي وما يظهر على الشاشة)

Introduction

Welcome to Requirements and Verification. This track follows requirements from the first draft to the proof that the system meets them, on the Bike-Share Dock from Getting Started.

This first chapter is about writing requirements well, and letting Holarch check them.

A good requirement

A good requirement states one thing the system shall do, in words that can only mean one thing, with a value someone can test. Vague words such as fast or user friendly cannot be tested, and two requirements joined by and cannot be checked separately.

On screen: Card: a good requirement.

Write requirements

Open the specification. Select section 5.1, Timing and Throughput, open the menu next to After, and choose Add Child. Name the requirement Pay at the Kiosk, and write its statement in the inspector.

On screen: SRS → 5.1 → Add Child → Pay at the Kiosk.

Add two more the same way: an environmental requirement under 7.1, and a usability requirement under 8.3. The usability one is written the way requirements often are on a first try.

On screen: 7.1 → Operate in Cold and Heat; 8.3 → Friendly Kiosk.

Attributes and labels

Each requirement also has attributes for planning. Select Pay at the Kiosk, and set its priority to High, its verification method to Test, and its rationale: why the value was chosen.

On screen: 5.1.1 → Priority, Verification Method, Rationale.

Give it a label too: click Label in the inspector, and choose Performance Requirement. Labels let you filter and report by kind.

On screen: + Label → Performance Requirement.

Quality check

Now check the wording. Open Needs and Requirements, then Quality, choose the specification, and click Check Quality. Each requirement is scored against nine qualities of a good requirement, with a tick or a cross for each.

On screen: Quality → Document: the SRS → Check Quality.

Friendly Kiosk scores low. The findings name the problems: user friendly and quick cannot be measured, and the and joins two requirements in one.

On screen: Findings for Friendly Kiosk.

Fix it. Go back to the document, select the requirement, and rewrite it as one measurable statement.

On screen: Back to the SRS → 8.3.1 → new description.

Check the quality again. The score rises. Two qualities, correct and feasible, always need a person: when you have reviewed a requirement, click their crosses to mark them yes.

On screen: Quality → Check Quality again → mark Correct and Feasible.

Recap

Let's recap. You learned what makes a requirement good, added requirements under sections, filled in their attributes and labels, ran the quality check, fixed a weak requirement, and recorded your own judgment.

Next, you trace the stakeholder needs to these requirements.