פרקי הקורס
הדרכה · מסלול 2. דרישות ואימות · פרק 2.1 מתוך 6
2.1 כתיבת דרישות ובדיקת האיכות 3:37
כותבים דרישות עם המאפיינים שלהן, ונותנים לבדיקת האיכות למצוא ניסוח חלש.
מציג את Holarch 1.27.
מה תלמדו
- לכתוב דרישה כמשפט shall אחד שניתן לבדוק, עם ערך מדיד
- להוסיף דרישה תחת סעיף של מפרט
- להגדיר לדרישה עדיפות, שיטת אימות, נימוק ותווית סוג
- להריץ את בדיקת האיכות על מסמך ולתקן דרישה שהיא מסמנת
- לסמן Correct ו-Feasible אחרי שסקרתם דרישה בעצמכם
כותבים דרישות במפרט של Bike-Share Dock: מה הופך דרישה לטובה, הוספת דרישות תחת סעיפים, מילוי עדיפות, שיטת אימות ונימוק, מתן תוויות, הרצת בדיקת איכות הדרישות, תיקון דרישה חלשה ותיעוד שיקול הדעת של הסוקר.
קובצי פרויקט
- פרויקט התחלה (.holarch.json; ניהול פרויקטים ← קובצי פרויקט ▾ ← ייבוא פרויקט (.json)…)
- פרויקט גמור (.holarch.json; ניהול פרויקטים ← קובצי פרויקט ▾ ← ייבוא פרויקט (.json)…)
הסרטון מוצג מ-holarch.app; ראו את מדיניות הפרטיות.
תרגול
עשו זאת בעצמכם ב-Holarch, על פרויקט ההדגמה CubeSat EO-1.
- פותחים את פרויקט ההדגמה EO-1 (או יוצרים אותו: ניהול פרויקטים ← קובצי פרויקט ▾ ← פרויקט הדגמה חדש ← CubeSat (הנדסת מערכות מודרכת)).
- פותחים את צרכים ודרישות ← מסמכים ← EO-1 System Requirements Specification. בוחרים את הסעיף 5 Communications, לוחצים על + צאצא, נותנים לדרישה את השם
Command Link Marginוכותבים משפט shall עם ערך (למשל, מרווח של 6 dB לפחות בזווית הגבהה של 5 מעלות). - בחלונית המאפיינים מגדירים את עדיפות ל-High, את Verification Method ל-Analysis ונימוק, ואז לוחצים על + תווית ובוחרים Performance Requirement.
- פותחים את צרכים ודרישות ← איכות, בוחרים Document: EO-1 System Requirements Specification בסרגל ההיקף ולוחצים על בדיקת איכות. קוראים את ההצעות עבור 2.5 Safe Mode Recovery.
- מנסחים מחדש את 2.5 כמשפט מדיד אחד (מה מפעיל את ההתאוששות, כמה מהר, ולאיזה מצב), ולוחצים שוב על בדיקת איכות.
- סוקרים את הניסוח החדש, ואז לוחצים על ה-✘ תחת Correct ו-Feasible בשורה שלה כדי לסמן אותם Yes.
סיימתם כש-2.5 Safe Mode Recovery מקבלת ציון גבוה יותר מקודם, ההצעות שלה כבר לא מציינות מילים מעורפלות, ו-Correct ו-Feasible מציגים ✔.
בדיקה עצמית
- למה דרישה שמחוברת ב-and מקבלת ציון נמוך יותר גם כששני החצאים טובים?
- למה הבדיקה האוטומטית אף פעם לא יכולה לסמן את Correct ו-Feasible?
- מה הופך מילה כמו quickly לבעיה בדרישה?
הצגת התשובות
למה דרישה שמחוברת ב-and מקבלת ציון נמוך יותר גם כששני החצאים טובים?
היא מכילה שתי דרישות באחת. אי אפשר לאמת, לעקוב או לשנות אותן בנפרד, ולכן הבדיקה מסמנת אותה כלא יחידנית.
למה הבדיקה האוטומטית אף פעם לא יכולה לסמן את Correct ו-Feasible?
השאלה אם דרישה מבטאת את הצורך הנכון ואם אפשר לבנות אותה דורשת שיקול דעת הנדסי. אדם סוקר אותה ומסמן את שני הקריטריונים האלה.
מה הופך מילה כמו 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.