מדריך · דרישות
איך לכתוב דרישות מערכת טובות: דוגמאות ורשימת בדיקה
האזנה למדריך 26 דק׳
דרישה טובה אומרת דבר אחד שהמערכת חייבת לעשות או להיות, במילים ששני מהנדסים קוראים באותה דרך, עם ערך שבדיקה או ניתוח יכולים לבדוק. המדריך הזה עוסק בצרכים לעומת דרישות, בחלקים של ניסוח דרישה, במאפייני האיכות שב-ISO/IEC/IEEE 29148 וב-INCOSE Guide to Writing Requirements, ברשימת בדיקה עם דוגמאות לפני ואחרי, בשיטת אימות ובקריטריוני קבלה, בערכי TBD ו-TBR ובסוגי דרישות, והכול על מפרט CubeSat אחד.
בדף זה
- למה הניסוח של דרישה חשוב
- צורכי בעלי עניין לעומת דרישות
- המבנה של דרישה
- מאפייני האיכות של דרישה טובה
- רשימת הבדיקה: כללים עם דוגמאות לפני ואחרי
- כותבים את שיטת האימות ואת קריטריוני הקבלה יחד עם הדרישה
- טיפול בערכי TBD ו-TBR
- סוגי דרישות
- דוגמה מעשית: סקירת המפרט של EO-1
- טעויות נפוצות
- לנסות ב-Holarch
- הורדת רשימת הבדיקה
- שאלות על כתיבת דרישות
- לאן ממשיכים
למה הניסוח של דרישה חשוב
דרישה היא חוזה בין מי שמבקשים מערכת לבין מי שבונים אותה. כל מה שבהמשך השרשרת קורא אותה: המתכנן קובע את גודל הרכיב מולה, מהנדס הבדיקות כותב ממנה קריטריון מעבר, ועדת השינויים שוקלת מולה שינוי, והלקוח מקבל לפיה את המערכת. כל אחד מהם קורא את אותו משפט, בדרך כלל בלי שהכותב נמצא בחדר. אם אפשר לקרוא את המשפט בשתי דרכים, כך זה יקרה, וההבדל יצוף מאוחר: בבדיקה ש“עוברת” מול קריטריון שאיש לא הסכים עליו, או בקבלה, כשהלקוח התכוון למשהו אחר.
ניסוח גרוע שובר גם את שאר המודל. אי אפשר להקצות לרכיב דרישה בלי ערך, כי איש לא יכול לומר אם הרכיב עומד בה. אי אפשר לאמת אותה, ולכן היא מופיעה כפער כיסוי בעקיבות ובמטריצת האימות. וכשהיא משתנה, איש לא יכול לדעת אם התכן המקושר עדיין תקף. כתיבה טובה של דרישות היא עבודת האיכות הזולה ביותר בפרויקט: שעה על משפט בהתחלה חוסכת מערך בדיקות בסוף.
המדריך משתמש בדוגמה רציפה אחת, 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). ה-Needs and Requirements Manual של INCOSE עושה את אותה חלוקה ומתייחס לצרכים כפריטים בפני עצמם, לא כטיוטות גסות של דרישות.
| דוגמה מ-EO-1 | נבדק באמצעות | |
|---|---|---|
| צורך (N2 Twice-Weekly Revisit) | Farm customers need fresh imagery of their fields at least twice a week in the growing season. | תיקוף: האם הלקוחות מקבלים מהמערכת שנמסרה את מה שהם צריכים? |
| דרישה (1.6 Revisit Time) | The mission shall revisit each target region within 72 hours. | אימות: האם המערכת עומדת בניסוח, בבדיקה, בניתוח, בבחינה או בהדגמה? |
ההבדל ניכר באופן שבו כל אחד נבדק. דרישה מאומתת: המערכת נמדדת מול הניסוח. צורך מתוקף: מישהו מאשר שהמערכת, בשימוש המיועד שלה, עושה את מה שבעל העניין רצה. מערכת יכולה לעבור כל אימות ועדיין להיכשל בתיקוף אם הדרישות החטיאו את העיקר; המדריך לאימות לעומת תיקוף עוסק בפער הזה. לגבי הכתיבה, ההשלכה המעשית פשוטה: כותבים קודם את הצורך, אחר כך דרישות שהיו מספקות אותו אילו התקיימו, ומקשרים כל דרישה חזרה לצורך שהיא עונה עליו.
התרגום כמעט אף פעם אינו אחד לאחד. 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) מתאר אותו כנושא, פעולה, מושא ואילוצים על הפעולה, עם תנאי אופציונלי בהתחלה; ה-Guide to Writing Requirements של INCOSE ממליץ על אותו סדר ועל תבניות מוסכמות לכל סוג דרישה.
| חלק | מה הוא אומר | 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.” הסדר יכול להשתנות (“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…”) כתובה נכון כהנחה, לא כדרישה: היא הקשר לדרישות שתלויות בה, והמודל שומר אותה כ-Statement שלא מקבל ציון ולא מאומת.
המאפיינים
כך המודל של EO-1 מתעד את 3.1 Orbit Average Power, אחרי השינוי שאחרי PDR מ-28 W ל-30 W:
| מאפיין | 3.1 Orbit Average Power | למה הוא שם |
|---|---|---|
| מזהה ושם | 3.1 Orbit Average Power | ידית יציבה לקישורים, לסקירות ולבקשות שינוי |
| ניסוח | The solar arrays shall generate at least 30 W orbit-average power at end of life. | החובה עצמה |
| נימוק | Orbit-average load grew to 26 W after PDR; 30 W keeps 15% margin. | מאפשר לקורא מאוחר יותר לשפוט שינוי בלי הכותב |
| מקור והורה | Derived (systems analysis); derived from 1.5 Daily Collection Volume | עקיבות אחורה: למה הדרישה קיימת |
| שיטת אימות ורמה | Test, ברמת תת-מערכת | התוכנית להוכחה, שנקבעת בזמן הכתיבה |
| קריטריוני הצלחה | End-of-life orbit-average power predicted from measured peak power. | איזו תוצאה נחשבת עמידה |
| בעלים, עדיפות, קריטיות | Power Engineer; High; High | מי אחראי לה וכמה היא חשובה |
| מצב | In Review (היא הייתה Approved; הטקסט שלה השתנה אחרי האישור) | היכן היא נמצאת בתהליך ההסכמה |
| TBD/TBR | אין | האם ערך עדיין פתוח |
ISO/IEC/IEEE 29148 (5.2.8) מונה מאפיינים מהסוג הזה, והמדריך של INCOSE מוסיף עוד; פרויקט בוחר את אלה שהוא באמת יתחזק. הנימוק הוא המאפיין שמדלגים עליו הכי הרבה ושהכי חסר אחר כך. בלי “עומס של 26 W, מרווח של 15%”, מי שיראה את 3.1 בפעם הבאה לא יוכל לדעת אם 30 W הם גבול פיזיקלי קשיח, מספר של הלקוח או בחירת מרווח, ולכן לא יוכל לדעת מה שינוי בעומס אומר לגביה.
מאפייני האיכות של דרישה טובה
קל יותר ליישם כללי סגנון כשיודעים על מה הם מגנים. ISO/IEC/IEEE 29148 (5.2.5) מונה תשעה מאפיינים של דרישה בודדת, וה-Guide to Writing Requirements של INCOSE משתמש באותם תשעה כ-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 ground sample distance מבטאת נכון את 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 בממוצע למסלול, שטח המערכים ותקציב המסה יחד אולי לא.
- מובן: קורא יכול להבין מה מצופה מהמערכת ואיך הדרישות קשורות זו לזו, מה שתלוי במבנה, במספור ובעקיבות לא פחות מאשר בניסוח.
- ניתן לתיקוף: אפשר להראות שהאוסף מוביל למערכת שעונה על הצרכים, ולכן כל דרישה ברמה העליונה מקושרת חזרה לצורך.
רשימת הבדיקה: כללים עם דוגמאות לפני ואחרי
המאפיינים הופכים לשימושיים דרך כללי כתיבה מוחשיים. ה-Guide to Writing Requirements של INCOSE ממספר אותם (R1, R2 וכן הלאה); ה-Systems Engineering Handbook של NASA (Appendix 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.” צעדי התאוששות נוספים שחשובים מקבלים דרישות משלהם. |
| ניסוח מחייב | “Shall” לדרישה מחייבת, לא “should”, “will” או “may”? | 2.5: “should recover” | “shall resume” |
| ערך מדיד עם יחידה | האם לכל מילת ביצועים יש מספר ויחידה? | 2.5: “quickly” | “within 6 hours of a safe mode entry” |
| כיוון הגבול מצוין | האם ברור אם הערך הוא מינימום או מקסימום? | 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.” (להמחשה; דרישה אחת לכל משימה שחשובה) |
| שמות עצם מפורשים, בלי כינויי גוף | האם לכל “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.” |
| ערכים סגורים, או 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.” (להמחשה; עד שהניתוח התרמי יקבע אותו, המאפיין TBD מציין את Thermal Engineer ותאריך יעד) |
| בלי סיבות או הערות בניסוח | האם ביטויי מטרה (“so that”, “in order to”) והערות בסוגריים הועברו לנימוק? | 3.5: “(TBD)” | ניסוח בלי סוגריים; הסיבה ב-Rationale |
| מה, לא איך | האם היא מציינת את הצורך במקום לכפות פתרון שהרמה שמתחת צריכה לבחור? | “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 בלי נימוק | נימוק: “Orbit-average load grew to 26 W after PDR; 30 W keeps 15% margin.” |
| שיטת אימות וקריטריונים | האם השיטה נבחרה וקריטריון המעבר נגזר מהניסוח? | 3.1: שיטה Test; TC-06 מצפה להספק שיא ≥ 72 W | קריטריון מעבר שנגזר דרך תקציב ההספק: כ-80.6 W שיא עבור 30 W בממוצע למסלול (ראו הסעיף הבא) |
| עקיבה כלפי מעלה | מקושרת לצורך, להורה או לדרישת מקור? | 3.1 בלי קישור כלפי מעלה | 3.1 derived from 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: “Measured capacity of at least 77 Wh at C/2 and 20 °C.” עבור 6.2 Image Delivery: “Products on the portal within 6 h for 95% of passes in rehearsal.”
כתיבת הקריטריונים ליד הניסוח תופסת סוג של שגיאה שאחרת נמצאת רק בסוף. את 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 (to be determined, ייקבע): עדיין אין ערך. “The thermal design shall keep the battery cell temperature at or above TBD °C while charging.”
- TBR (to be reviewed, ייבדק, ולפעמים “to be resolved”): הערך הטוב ביותר הנוכחי שלא אושר. “…within 60 seconds” כש-60 מסומן TBR.
עדיף TBR עם הערכה על פני TBD חשוף בכל מקום שיש בסיס כלשהו למספר: מתכננים יכולים לעבוד מול הערכה, וערך שזז מאוחר יותר הוא שינוי, שהעקיבות תעקוב אחריו. כל פריט פתוח צריך שלושה דברים, אחרת הוא לא מנוהל:
- בעלים, האדם שיסגור אותו.
- תאריך יעד או אבן דרך, בדרך כלל לפני החלטות התכן שתלויות בו.
- תוכנית סגירה: הניתוח, הבדיקה או ההחלטה שיקבעו את הערך.
במפרט של 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 פתוחים הוא קו בסיס רק בשם. קריטריוני הסקירה ב-Systems Engineering Handbook של NASA דורשים, החל מסקירת דרישות המערכת, שפריטי TBD ו-TBR פתוחים יזוהו עם תוכנית ולוח זמנים לסגירתם. המעקב שייך למאפיין או למרשם, לא רק לטקסט: “TBD” שהוקלד לתוך משפט אין לו בעלים ואין לו תאריך, ושום דבר לא מזכיר לאיש לסגור אותו.
סוגי דרישות
סיווג דרישות עוזר לסוקרים לשאול את השאלות הנכונות ועוזר לאוסף להישאר שלם. הקטגוריות שלהלן הן הנפוצות; ISO/IEC/IEEE 29148 והמדריך של INCOSE מתארים אוספים דומים, ופרויקטים רבים מוסיפים משלהם.
| סוג | מה הוא מציין | דוגמה מ-EO-1 | למה לשים לב |
|---|---|---|---|
| פונקציונלית | מה המערכת חייבת לעשות | 4.3 Fault Detection: “The C&DH shall enter safe mode within 10 seconds of undervoltage detection.” | פונקציה בלי ביצועים מצורפים; רוב הדרישות הפונקציונליות צריכות גם “כמה טוב”, כאן “within 10 seconds” |
| ביצועים | כמה טוב פונקציה מבוצעת: כמות, קצב, דיוק, זמן | 2.1 Pointing Accuracy: “The ADCS shall point the payload boresight within 0.1 degrees of the commanded target.” | תנאים חסרים (איזה מצב, איזה שלב בחיים) וכיוון גבול חסר |
| ממשק | מה חוצה גבול עם מערכת או רכיב אחר, והמאפיינים שלו | 5.2 UHF Command Uplink: “The UHF transceiver shall receive ground commands at 9.6 kbps.” ההגדרה המלאה נמצאת במסמך בקרת הממשקים. | דרישות שחוזרות על ה-ICD במקום להפנות אליו, כך שהשניים מתרחקים זה מזה |
| אילוץ | מגבלה על התכן או על האופן שבו המערכת נבנית, שנכפית מבחוץ | 4.4 Downlink Encryption: “The C&DH shall encrypt each downlink frame with 256-bit keys.” הנימוק שלה: חוזה הלקוח דורש הצפנה של התמונות במעבר, כך שהדרישה מגיעה מחוץ לפרויקט, לא מניתוח חלופות בתוכו. | בחירות תכן שנכתבו כאילוצים כשאיש מבחוץ לא כפה אותן |
| סביבה, אמינות, בטיחות | תנאים לשרוד ואמינות להשיג | 1.7 Mission Lifetime: “The spacecraft shall operate in orbit for at least 730 days.” | ערכים בלי ההסתברות או רמת הביטחון שבהם הם נטענים |
הקו בין דרישות פונקציונליות לדרישות ביצועים נמתח לעיתים קרובות בתוך משפט אחד: דרישות רבות מציינות פונקציה עם הביצועים שלה, כמו 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 יש שיטה (ניתוח) וקריטריוני הצלחה (“Simulated daily volume of at least 3.2 GB over a 30-day plan”) אבל עדיין אין ניתוח מקושר. הניסוח בסדר; האימות לא בוצע.
- 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”, אין נקודה בסוף, ואין אימות. הניסוח מחדש שומר על התוצאה האחת שחשובה ללקוח ונותן לה ערך:
The spacecraft shall resume imaging within 6 hours of a safe mode entry.
הנימוק צריך לומר מאיפה מגיעות 6 השעות (N1 מבקש התראות על עקה בגידולים באותו יום, ו-6.2 מאפשרת 6 שעות מהשידור למטה ועד המסירה). אם לצעדי ההתאוששות יש חשיבות בפני עצמם, כמו רכישה מחדש של הצבעה לשמש או דיווח על הסיבה, כל אחד מהם הופך לדרישה משלו. שיטה: בדיקה, בהזרקת תקלות על ה-flatsat; קריטריון הצלחה: הצילום מתחדש בתוך 6 שעות בכל כניסה מוזרקת למצב בטוח.
3.5 Battery Thermal Control. “The thermal design shall keep the battery warm enough (TBD).” מכילה מונח עמום, TBD בטקסט וסוגריים. התיקון מפריד בין החובה, הערך הפתוח והסיבה:
The thermal design shall keep the battery cell temperature at or above 0 °C while charging.
ה-0 °C הוא להמחשה: תאי ליתיום-יון בדרך כלל לא נטענים מתחת לנקודת הקיפאון, אבל הגבול האמיתי מגיע מגיליון הנתונים של התא ומהניתוח התרמי. עד שהניתוח הזה יקבע אותו, הערך הוא TBR בבעלות Thermal Engineer, עם תאריך יעד לפני סקירת התכן התרמי. הניסוח מחדש חושף גם פער שהמקור הסתיר: אין דרישה לטווח הטמפרטורה בפריקה, שצריך ניסוח משלו.
6.4 Operator Interface. “The operator interface shall be user friendly and/or easy to use.” מכילה שני מונחים סובייקטיביים ו-“and/or”. אפשר להגדיר שמישות, אבל רק דרך משימות נצפות:
The operator interface shall let a trained operator book a ground station contact in no more than 5 minutes.
המשימה והזמן הם להמחשה. אוסף אמיתי יפרט את המשימות המעטות שחשובות (הזמנת קשר, העלאת רשימת מטרות, קריאת טלמטריית התקינות האחרונה), כל אחת עם זמן וגבול שגיאות, שנמדדים בהדגמה עם מפעילים שסיימו את ההדרכה.
טעויות נפוצות
| טעות | מה משתבש | עדיף |
|---|---|---|
| כתיבת פתרונות תכן כדרישות | התכן נקבע לפני שנעשה ניתוח החלופות, ואפשרות טובה יותר נפסלת בלי שמישהו החליט על כך. | מציינים את הצורך (“לשמור על התאים ב-0 °C ומעלה בזמן טעינה”) ומשאירים לרמה שמתחת לבחור את המחמם. |
| העתקת שפת בעלי העניין ישירות לדרישות | “תמונות עדכניות פעמיים בשבוע” הוא צורך; כפי שהוא כתוב אי אפשר לאמת אותו. | שומרים את הצורך, וכותבים דרישה עם ערך ותנאי שמספקת אותו (1.6 בתוך 72 שעות). |
| כמה דרישות בפסקה אחת | מזהה אחד נושא כמה חובות, שחולקות מצב אחד, בדיקה אחת וגורל אחד. | דרישה אחת לכל פריט, “shall” אחד לכל ניסוח. |
| ערכים בלי תנאים | “30 W” בתחילת החיים ובסוף החיים הם תכנים שונים. | מציינים מצב, שלב בחיים, סביבה ואופן מיצוע. |
| אין נימוק | איש לא יכול לשפוט שינוי מאוחר יותר, והדרישה שורדת הרבה אחרי שהסיבה שלה נעלמה. | כותבים את הסיבה ואת המספרים שמאחורי הערך. |
| ספי בדיקה שלא נגזרו מהדרישה | בדיקה עוברת בזמן שהדרישה לא מתקיימת (TC-06 ב-72 W שיא מול 28 W בממוצע למסלול). | גוזרים את קריטריון ההצלחה מהניסוח בחשבון, ומתעדים אותו. |
| TBD שהוקלד לטקסט ונשכח | לערך הפתוח אין בעלים או תאריך, והוא מגיע לקו הבסיס. | עוקבים אחרי כל TBD ו-TBR עם בעלים, תאריך יעד ותוכנית סגירה. |
| הוספת יתר (gold plating) | דרישות שאיש לא ביקש צורכות מאמץ תכן ובדיקות. | בודקים שכל דרישה ברמה העליונה עוקבת לצורך או למקור. |
| הסתמכות יתר על בדיקות אוטומטיות | בדיקת מילים נקייה נחשבת לדרישה נכונה. | משתמשים בכלים לכללים המכניים; אדם שופט נכונות, ישימות ונחיצות. |
לנסות ב-Holarch
בפרויקט LML, כל דרישה היא ישות מהמחלקה Requirement עם המאפיינים שתוארו למעלה: Rationale, Status, Priority, Criticality, Owner, Source, Verification Method, Verification Level, Success Criteria ושדות ה-TBD/TBR.
- יוצרים את ההדגמה דרך ניהול פרויקטים ← קובצי הפרויקט ▾ ← פרויקט הדגמה חדש ← CubeSat (הנדסת מערכות מודרכת). המפרט שלה מכיל את שלוש הדרישות החלשות ואת פריטי ה-TBD/TBR הפתוחים שמשמשים במדריך הזה.
- פותחים את צרכים ודרישות ← איכות, בוחרים את המסמך ברשימת ההיקף ולוחצים על בדיקת איכות. כל דרישה מקבלת ציון על תשעת המאפיינים, וההצעות מציינות את מספרי הכללים מהמדריך של INCOSE שרשימת מילים או דפוס יכולים לבדוק. Correct ו-Feasible דורשים סוקר: לוחצים על הסימון כדי לתעד את ההחלטה.
- מנסחים מחדש את 2.5 כמו למעלה ומריצים שוב את הבדיקה. הממצאים על המחבר, סעיף המילוט והמונח העמום נעלמים.
- פותחים את צרכים ודרישות ← TBD/TBR כדי לראות את הפריטים הפתוחים עם בעלים ותאריכי יעד, ולוחצים על סגירה באחד מהם כשהערך שלו נקבע.
- לדעה שנייה על המאפיינים שכלל לא יכול להכריע, משתמשים ב-✦ AI ▾ ← בדיקת דרישות ב-AI; כל הכרעה וכל ניסוח מחדש מוצגים לסקירה לפני שמשהו משתנה.
ההפניה המלאה נמצאת בתיעוד של איכות הדרישות ושל מרשם TBD/TBR.
הורדת רשימת הבדיקה
רשימת הבדיקה לאיכות דרישות עם דוגמאות לפני ואחרי מ-EO-1 (CSV) מכילה את כללי רשימת הבדיקה עם שאלות הסקירה והדוגמאות שלהם, לשימוש בסקירה או כנקודת התחלה לכללי הכתיבה של פרויקט. את אותו קובץ מציע גם המדריך לעקיבות.
שאלות על כתיבת דרישות
Shall, must או will?
כל נוהג עובד אם המפרט מגדיר אותו ונצמד אליו. הנפוץ ביותר משתמש ב-“shall” לדרישות מחייבות, ב-“will” לעובדות ולכוונות לגבי דברים מחוץ למערכת, וב-“should” ליעדים שלא מאומתים. חלק ממדריכי הסגנון הממשלתיים מעדיפים “must” מטעמי שפה פשוטה. הבעיה האמיתית היא ערבוב שלהם בתוך מפרט אחד.
כמה דרישות צריכות להיות למערכת?
אין מספר נכון. לחללית קטנה יכולות להיות כמה עשרות דרישות מערכת וכמה מאות מתחתיהן; לתוכנית גדולה יש אלפים. שאלות מועילות יותר הן האם כל דרישה עוקבת לצורך או להורה, והאם לכל צורך יש דרישות מתחתיו.
האם סיפורי משתמש הם דרישות?
סיפור משתמש מתעד צורך ואת מטרתו במונחים של המשתמש. הוא ממלא את התפקיד של צורך של בעל עניין, וקריטריוני הקבלה שלו קרובים לקריטריוני אימות. במערכת שנבנית, משולבת ומאומתת כחומרה ותוכנה יחד, עדיין צריך להפוך את הסיפורים לדרישות שאפשר להקצות ולבדוק.
האם כלי יכול לבדוק את איכות הדרישות?
כלי יכול לבדוק באופן אמין את הכללים המכניים: פעלים מודליים, מחברים, מילים עמומות, סעיפי מילוט, כינויי גוף, קישורים חסרים. הוא לא יכול לדעת אם 30 W הם הערך הנכון או אם המערכים יכולים לספק אותם. משתמשים בבדיקה האוטומטית כדי לנקות את הממצאים המכניים לפני סקירה, כך שהסוקרים יקדישו את הזמן שלהם לנכונות ולישימות.
לאן ממשיכים
- עקיבות דרישות והשפעת שינויים: קישור הדרישות האלה לצרכים, לתכן ולבדיקות, ומעקב אחרי שינוי.
- ניתוח פונקציונלי: הפיכת הדרישות לפונקציות והקצאה שלהן.
- מטריצת אימות דרישות: תכנון שיטת האימות לכל דרישה ותיעוד התוצאות.
- צרכים ודרישות ב-Holarch: מסמכים, בדיקות איכות, קווי בסיס ועקיבות במודל אחד.