מדריך · דרישות
עקיבות דרישות והשפעת שינויים: קישור צרכים, דרישות, תכן ובדיקות
האזנה למדריך 27 דק׳
עקיבות דרישות היא התיעוד של המקום שממנו הגיעה כל דרישה, של מה שבתכן ממלא אותה ושל מה שמראה שעומדים בה. התועלת העיקרית שלה היא השפעת שינויים: כשדרישה משתנה, הקישורים אומרים מה צריך לבדוק שוב. המדריך הזה עוסק בסוגי קישורי עקיבה ובכיוון שלהם, בעקיבה קדימה ואחורה, בפערי כיסוי וביתומים, בקישורים חשודים ובמטריצת העקיבות, על מודל של CubeSat.
בדף זה
מהי עקיבות דרישות
דרישה כמעט אף פעם אינה עומדת לבדה. היא עונה על צורך של בעל עניין, היא עשויה להתפתח לדרישות ברמה נמוכה יותר, פונקציה או רכיב מבצעים אותה, ובדיקה או ניתוח בודקים אותה. עקיבות היא קבוצת הקישורים המפורשים והמתועדים בין הפריטים האלה. כל קישור מציין את שני הקצוות שלו ואומר מהו הקשר: “3.1 Orbit Average Power is satisfied by 1.3.1 Solar Arrays” הוא קישור עקיבה; משפט בדוח תכן שמזכיר את המערכים אינו כזה.
הקישורים יוצרים רשת שעוברת מצורכי בעלי העניין, דרך דרישות המערכת ותת-המערכת, אל הארכיטקטורה ואל האימות. ISO/IEC/IEEE 15288 דורש את הרשת הזאת בכמה תהליכים טכניים: צורכי בעלי עניין עוקבים לדרישות שמנסחות אותם באופן פורמלי, דרישות מערכת עוקבות לרכיבי הארכיטקטורה שהן מוקצות להם, וכל דרישה עוקבת לפעילות שמאמתת אותה. ה-INCOSE Systems Engineering Handbook מתייחס לעקיבות כתכונה שיש לקבוצת דרישות טובה כשלם, ולא כמסמך נפרד שמופק בסוף.
למה לעקוב אחרי דרישות: קודם כול השפעת שינויים
יצירת קישורים דורשת מאמץ, ושמירה על נכונותם דורשת מאמץ רב יותר, ולכן כדאי לדעת מה הם מניבים. ארבעה שימושים נושאים את רוב הערך, והראשון הוא הסיבה שרוב הצוותים מתחילים.
- השפעת שינויים. לפני שינוי, הקישורים מראים למה הוא מגיע: אילו דרישות ברמה נמוכה יותר, פונקציות, רכיבים, ניתוחים ובדיקות תלויים בפריט שמשתנה. אחרי השינוי, אותם קישורים אומרים לצוות מה לבדוק שוב. בלעדיהם, התשובה תלויה במי שזוכר את התכן (ראו את המדריך לניתוח השפעת שינויים).
- כיסוי. כל דרישה צריכה להתמלא על ידי משהו בתכן ולהיבדק על ידי משהו באימות. הקישורים חושפים את החסרים, הרבה לפני שבדיקת אינטגרציה או לקוח מוצאים אותם.
- תאימות והצדקה. חוזים, תקני בטיחות וסקירות מבקשים ראיות לכך שעומדים בכל דרישה ושדבר בתכן אינו קיים ללא סיבה. עקיבה מצורך לדרישה לתכן לבדיקה היא הראיה הזאת.
- בקרת שינויים. כשדרישה משתנה אחרי שהוסכם עליה, יש לסקור את הפריטים שמקושרים אליה, ויש לתעד את הסקירה. הקישורים אומרים לוועדת השינויים מה לסקור מחדש ומאפשרים לצוות להראות שהסקירה התקיימה.
צוות שעוקב רק לצורך ביקורת בסוף שלב משלם את העלות בלי רוב התועלת. קישורים שנוצרים בזמן כתיבת הדרישות והתכן זולים יותר ליצירה וזמינים כשמגיע שינוי. תשובה על השפעת שינוי שלמה רק כמו הקישורים: פריט שהיה צריך להיות מקושר ואינו מקושר אינו נראה לה, כפי שהדוגמה המלאה מראה.
צרכים ודרישות
העקיבות מתחילה מעל הדרישות. צורך הוא מה שבעל עניין מצפה מהמערכת, במונחים של בעל העניין: “לקוחות חקלאיים צריכים צילומים עדכניים של השדות שלהם לפחות פעמיים בשבוע בעונת הגידול.” דרישה היא ההצהרה ההנדסית שהמערכת תיבנה ותאומת מולה: “The mission shall revisit each target region within 72 hours.”
השניים נבדלים במטרה ובצורה:
| צורך | דרישה | |
|---|---|---|
| בעלים | בעל עניין: משתמש, מפעיל, לקוח, רגולטור | צוות ההנדסה, בהסכמה עם בעלי העניין |
| שפה | המונחים של בעל העניין עצמו, לעיתים קרובות איכותיים | מדויקת, מדידה, “shall” אחד לכל הצהרה |
| מתוקף או מאומת | מתוקף: המערכת שנמסרה עושה את מה שבעל העניין צריך | מאומתת: המערכת עומדת בהצהרה, בבדיקה, בניתוח, בבחינה או בהדגמה |
| מספר אופייני | עשרות | מאות עד אלפים, בכמה רמות |
העקיבה הראשונה מקשרת כל צורך לדרישות שמנסחות אותו באופן פורמלי. צורך בלי דרישה הוא ציפייה של בעל עניין שהתכן לא יטפל בה. דרישה בלי צורך, ברמה העליונה, היא או הנחה סמויה שצריך לכתוב כצורך או דרישה שאיש לא ביקש. איך הופכים צורך לדרישה מנוסחת היטב הוא הנושא של המדריך לכתיבת דרישות טובות. המדריך לאימות מול תיקוף מראה איך כל צורך מקבל אירוע תיקוף משלו.
סוגי קישורי העקיבה
רוב השיטות והכלים משתמשים בקבוצה קטנה של סוגי קישורים. השמות שונים ביניהם, אבל המשמעויות יציבות. כל סוג עונה על שאלה אחרת, ושימוש בסוג המדויק ביותר שנכון הופך את הקישורים לשימושיים לדוחות ולבדיקות. הדוגמאות לקוחות מה-CubeSat שמשמש בהמשך המדריך.
| קישור (נקרא מהקצה שבמעלה הזרם) | מ ← אל | השאלה שהיא עונה עליה | דוגמה |
|---|---|---|---|
| derived by (derives from) | דרישה ← דרישה שפותחה ממנה | אילו דרישות פותחו מהדרישה הזאת, בתוספת פרטי תכן? | 1.5 Daily Collection Volume ← 3.1 Orbit Average Power: עומס הצילום קובע את צורך ההספק |
| decomposed by (הורה וצאצא) | דרישה ← החלקים שלה | אילו הצהרות ברמה נמוכה יותר מרכיבות יחד את ההצהרה הזאת? | 1.6 Revisit Time ← 1.6.1 Ground Track Repeat ו-1.6.2 Off-Nadir Imaging |
| refined by | דרישה ← דרישה מדויקת יותר | איזו הצהרה אומרת את אותה כוונה עם ערך, סבולת או תנאי? | “להתאושש ממצב בטוח במהירות” ← “לחזור לצילום בתוך 6 שעות מכניסה למצב בטוח” |
| satisfied by / allocated to | דרישה ← פונקציה, רכיב, ממשק, ניתוח | מה בתכן ממלא את הדרישה הזאת? | 3.1 ← F3.1 Convert Sunlight to Power, 1.3.1 Solar Arrays |
| verified by | דרישה ← מקרה בדיקה, ניתוח, בחינה, הדגמה | מה מראה אם עומדים בדרישה הזאת? | 3.1 ← TC-06 Solar Array Power Test |
| traced to | צורך או דרישה ← כל פריט קשור | מה עונה להצהרה הזאת, כששום דבר מהנ״ל אינו מתאים או שהקשר עוד לא הוכרע? | N2 Twice-Weekly Revisit ← 1.6 Revisit Time |
שלוש הערות על הטבלה. דרישה נגזרת היא הצהרה חדשה שההורה הופך להכרחית; דרישה מפורקת היא חלק מההורה, ועומדים בהורה כשעומדים בחלקיו. הקצאה ומילוי משמשים לעיתים קרובות כמילים נרדפות; יש שיטות שמקצות דרישה לרכיב ואז אומרות שהתכן של הרכיב ממלא אותה, הבחנה שכדאי לשמור עליה רק אם הצוות באמת סוקר את השניים בנפרד. ועקיבה פשוטה היא הקישור החלש ביותר: היא אומרת ששני הפריטים קשורים, לא איך. היא מתאימה לקישורים מצורך לדרישה ולהקצאות מוקדמות שלא הוכרעו; יש להחליף אותה בסוג מסוים ברגע שהקשר מוכרע.
כיוון
לכל קישור יש כיוון, והמוסכמה שרוב הצוותים משתמשים בה מצביעה מהפריט שמניע אל הפריט שמגיב: מצורך לדרישה, מדרישת הורה לדרישה נגזרת, מדרישה לרכיב התכן ולבדיקה. אפשר לקרוא קישור מכל אחד מהקצוות (“3.1 is satisfied by the solar arrays”, “the solar arrays satisfy 3.1”), אבל זה קישור אחד שמתועד פעם אחת.
הכיוון הוא מה שגורם להשפעת שינויים לעבוד. שינוי בקצה שבמעלה הזרם מעמיד בספק כל פריט שבהמשך הזרם ממנו; שינוי בקצה שבהמשך הזרם בדרך כלל אינו פוסל את הדרישה שמעליו, אם כי ייתכן שהוא אומר שהתכן כבר אינו ממלא אותה. כלים שמסמנים קישורים אחרי שינוי נשענים על הכיוון הזה כדי להחליט איזה קצה לסמן.
משתמשי SysML מכירים את הקישורים האלה כתלויות עם סטריאוטיפ: «deriveReqt», «refine», «satisfy», «verify» ו-«trace». ב-SysML החץ משורטט מהרכיב התלוי אל הדרישה (מקרה הבדיקה מצביע אל הדרישה שהוא מאמת), כלומר הפוך מהקריאה שלמעלה. המשמעות זהה; רק מוסכמת השרטוט שונה. המדריך ל-SysML v2 מראה איך satisfy ו-verify נכתבים בסימון הטקסטואלי.
עקיבות קדימה ואחורה
העקיבות נבדקת בשני כיוונים.
- קדימה (כלפי מטה): מכל צורך לדרישות שמכסות אותו, מכל דרישה לרכיבי התכן שממלאים אותה ולבדיקות שמאמתות אותה. עקיבה קדימה עונה על השאלה “האם כל מה שהתבקשנו נבנה ונבדק?”
- אחורה (כלפי מעלה): מכל בדיקה, פונקציה או רכיב חזרה לדרישה שהם משרתים, ומכל דרישה חזרה לצורך או לדרישת הורה. עקיבה אחורה עונה על השאלה “האם לכל מה שבנינו יש סיבה?”
קבוצת דרישות היא בעלת עקיבות דו-כיוונית כששני התנאים מתקיימים. בפועל, פערים קדימה מראים עבודה חסרה ופערים אחורה מראים עבודה עודפת: ציפוי זהב, רכיבי תכן שנשארו ממוצר קודם, בדיקות שבודקות דבר שאיש לא ביקש, או דרישה שמישהו הוסיף בלי מקור.
פערי כיסוי ויתומים
לשני הכשלים של רשת עקיבה יש שמות.
- פער כיסוי הוא דרישה בלי קישור שצריך להיות לה: דרישת עלה שאינה ממולאת על ידי דבר, או שאינה מאומתת על ידי דבר. יש לבדוק דרישות עלה, אלה שאין להן דרישות צאצא. הורה מכוסה דרך הצאצאים שלו, ודרישה לקישור ישיר בהורה יוצרת קישורים כפולים.
- יתום הוא פריט בלי קישור במעלה הזרם: פונקציה, רכיב או ניתוח שאינם ממלאים אף דרישה, מקרה בדיקה שאינו מאמת אף דרישה, או דרישה נגזרת בלי הורה. יתום אינו תמיד שגוי. חלק חילוף טיסה קיים למערך האינטגרציה, ואז התיקון עשוי להיות דרישה חסרה, לא מחיקת פריט. כך או כך, יתום הוא שאלה שהצוות צריך לענות עליה.
מספרי כיסוי (“94 אחוז מדרישות העלה הוקצו”) שימושיים למעקב אחרי התקדמות, אבל רשימת הפריטים שאינם מכוסים היא מה שהצוות עובד ממנו. פער נסגר בהוספת הקישור החסר, בהחלטה שהדרישה אינה עלה, או במחיקת דרישה שאינה נחוצה.
יתומים חשובים גם להשפעת שינויים. פריט שצריך לענות לדרישה אבל אין לו קישור לא יסומן כשהדרישה הזאת משתנה. בדוגמה שבהמשך יש מקרה כזה.
קישורים חשודים אחרי שינוי
קישור מתעד שיקול דעת שנעשה בנקודת זמן: “הרכיב הזה, כפי שתוכנן, ממלא את הדרישה הזאת, כפי שנוסחה.” כשהטקסט או הערכים של הדרישה משתנים, ייתכן ששיקול הדעת הזה כבר אינו תקף. קישור חשוד הוא קישור שהקצה שלו במעלה הזרם השתנה אחרי הפעם האחרונה שהקישור נסקר. הקישור אינו נמחק ואינו נחשב שבור; הוא מסומן עד שמישהו בוחן את הפריט שבקצה השני שלו ומחליט. Holarch מפרט אותם כ-קישורים לבדיקה.
ניקוי קישור חשוד הוא סקירה קטנה:
- לקרוא מה השתנה: הטקסט הישן והחדש, או המאפיין שזז.
- לבדוק את הפריט שבקצה שבהמשך הזרם. האם הדרישה הנגזרת עדיין נובעת? האם הרכיב עדיין ממלא את הדרישה? האם הבדיקה עדיין בודקת את הערך החדש?
- אם הוא עדיין תקף, לנקות את הסימון ולתעד למה, למשל “בטקסט הפונקציה אין ערך הספק; אין צורך בשינוי.”
- אם הוא כבר אינו תקף, לשנות את הפריט שבהמשך הזרם (או להגיש שינוי נגדו), ואז לנקות את הסימון. אם הקישור עצמו כבר אינו נכון, להסיר אותו.
התיעוד חשוב כמו ההחלטה. קישור חשוד שנוקה עם הערה ושם הוא ראיה לסקירה הבאה שהשינוי טופל עד הסוף; סימון שנוקה באצווה בלי בדיקה גרוע מהיעדר סימון, כי הוא טוען לסקירה שלא התקיימה.
לא כל עריכה צריכה להעלות סימונים. תיקון שגיאת הקלדה בשם של דרישה לא צריך לשלוח עשרים פריטים לסקירה, ואילו שינוי רמת הספק מ-28 W ל-30 W חייב. כלים מותחים את הקו הזה בצורה שונה; השאלה המועילה היא האם שינוי יכול להפוך שיקול דעת שבהמשך הזרם לשגוי.
מטריצת העקיבות
מטריצת עקיבות מציגה את הקישורים בין שתי קבוצות פריטים כרשת: דרישות בשורות, למשל, ופונקציות, רכיבים או מקרי בדיקה בעמודות. סימון בתא פירושו שהשורה והעמודה מקושרות. גם טבלה עם שורה לכל דרישה ועמודה שמפרטת את הפריטים המקושרים לה נקראת לעיתים קרובות מטריצת עקיבות (לקובץ להורדה שבהמשך יש הצורה הזאת); צורת הרשת קלה יותר לסריקה לאיתור פערים, כי שורה או עמודה ריקה בולטת.
קריאת מטריצה:
- שורה ריקה היא פער כיסוי: דרישה שאינה מקושרת לדבר בעמודות.
- עמודה ריקה היא יתום: פונקציה, רכיב או בדיקה שאף שורה אינה מקושרת אליהם.
- שורה עם סימונים רבים עשויה להיות דרישה רחבה מדי שצריך לפצל.
- עמודה עם סימונים רבים היא רכיב תכן שדרישות רבות תלויות בו; לשינוי בו יש השפעה רחבה.
מטריצה היא תצוגה של הקישורים, לא המקום שבו הם נמצאים. צוותים ששומרים את הקישורים בגיליון אלקטרוני שמתוחזק ידנית מגלים שהגיליון והתכן מתרחקים זה מזה; מטריצה שנוצרת ממודל עדכנית תמיד כמו המודל.
מטריצת אימות דרישות היא תצוגה קשורה שמפרטת כל דרישה עם שיטת האימות שלה, הפעילות המאמתת והתוצאה שלה. זה צד האימות של אותם קישורים; המדריך למטריצת אימות הדרישות (RVTM) עוסק בה על אותו CubeSat.
דוגמה מלאה: ה-CubeSat EO-1
הדוגמה היא EO-1, CubeSat בדיוני בגודל 6U שמצלם שטחים חקלאיים בארבע רצועות ספקטרליות. זה אותו מודל כמו בפרויקט הדוגמה ל-MBSE מקצה לקצה, שנבנה ב-Holarch כפרויקט LML: הדרישות הן Requirements במפרט SRS-001 EO-1 System Requirements Specification (32 מהן), הפונקציות הן Actions שממוספרות F1 עד F11 עם תת-פונקציות, הרכיבים הם Assets, והבדיקות הן Test Cases TC-01 עד TC-20. הפונקציות מגיעות מהניתוח הפונקציונלי של אותה משימה.
צרכים ודרישות
ההדגמה מתעדת מאיפה הגיעה כל דרישה במאפיין מקור: Customer Needs Statement CNS-1, Mission Concept Review או Derived (systems analysis). מאפיין נוקב בשם מסמך; אי אפשר לעקוב אחריו, לספור אותו או לסמן אותו. לכן המודל מתעד גם שלושה צורכי בעלי עניין מסדנת הלקוחות כ-Statements, כל אחד עוקב לדרישות שמנסחות אותו באופן פורמלי. N1 עד N3 הם חלק ממודל הייחוס EO-1 (v1.0) ומפרויקטי הדגמה שנוצרו ב-Holarch 2.2.1 ואילך.
| צורך | ניסוח | עוקב אל |
|---|---|---|
| N1 Same-Day Crop Stress Alerts | לקוחות חקלאיים צריכים לדעת על עקה בגידולים ביום של מעבר מעל השדה. | 6.2 Image Delivery (בתוך 6 שעות מהשידור למטה), 6.5 Planning Cycle Time (בתוך 100 דקות) |
| 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 (בתוך 72 שעות) |
| N3 Field-Level Vegetation Maps | לקוחות חקלאיים צריכים מפות צמחייה מפורטות מספיק כדי להבחין בין שדה לשדה. | 1.2 Ground Sample Distance (4.5 m), 1.4 Spectral Bands (ארבע רצועות, 450 nm עד 900 nm) |
מתחת לצרכים, המפרט משתמש בכל שלושת הקישורים מדרישה לדרישה. 1.6 Revisit Time מפורקת ל-1.6.1 Ground Track Repeat (3 ימים) ול-1.6.2 Off-Nadir Imaging (25 מעלות): יחד הן מספקות ביקור חוזר בתוך 72 שעות. 3.1 Orbit Average Power נגזרת מ-1.5 Daily Collection Volume, ו-3.3 Depth of Discharge מ-1.7 Mission Lifetime: אף לקוח לא ביקש רמת הספק או מגבלת סוללה, אבל אי אפשר לעמוד בנפח הצילום ובאורך החיים של 730 ימים בלעדיהן. לדרישה כמו 3.1 אין לכן צורך מעליה, וזה נכון: ההורה שלה הוא דרישה אחרת.
הקישורים של דרישות ההספק
סעיף 3, Electrical Power, הוא פרוסה טובה לקריאה מקרוב. הטבלה מפרטת מה ממלא ומאמת כל דרישה, מתוך המודל:
| דרישה | Satisfied by (פונקציות) | Satisfied by (רכיבים) | Satisfied by (אחר) | Verified by |
|---|---|---|---|---|
| 3.1 Orbit Average Power | F3, F3.1 | 1.3.1 Solar Arrays | EQ-1.1 Solar Power Generation, EQ-1.4 Power Margin Check | TC-06 Solar Array Power Test (עבר) |
| 3.2 Battery Capacity | F3, F3.2 | 1.3.2 Battery Pack | TC-07 Battery Capacity Test (עבר) | |
| 3.3 Depth of Discharge | F3, F3.3 | EQ-1.2 Battery Depth of Discharge, OPS.10, IF-21 | TC-07 Battery Capacity Test (עבר) | |
| 3.4 Bus Regulation | F3, F3.3 | 1.3.3 Power Distribution Unit | IF-01 עד IF-04, IF-20, IF-22 (קווי הספק) | TC-18 Bus Regulation Inspection (עבר) |
| 3.5 Battery Thermal Control | (אין) | (אין) | (אין) | (אין) |
| 3.6 Array Deployment | F2 Deploy Solar Arrays | 1.6 Structure and Thermal | IF-19 Deployment Switch Harness | TC-19 Array Deployment Test (לא הורץ) |
F3 Generate and Store Power ממלאת ארבע דרישות, ותת-הפונקציות שלה F3.1 עד F3.3 מחלקות אותן בין המערכים, הסוללה ויחידת חלוקת ההספק. קווי ההספק שממלאים את 3.4 הם ממשקים; המדריך למסמך בקרת ממשקים עוקב אחריהם אל ה-ICD.
קריאת המטריצה: פער ויתום
עם שש דרישות ההספק בשורות ופריטי התכן והבדיקה בעמודות, המטריצה (6 שורות, 17 עמודות, 21 קישורים) מראה במבט אחד:
- 3.5 Battery Thermal Control היא פער כיסוי: השורה שלה ריקה. שום דבר בתכן אינו שומר על הסוללה חמה ואף בדיקה אינה בודקת זאת. הדרישה גם חלשה (“keep the battery warm enough (TBD)”), ושתי הבעיות קשורות: דרישה בלי ערך קשה להקצאה ואי אפשר לבדוק אותה. המדריך לכתיבת דרישות מנסח אותה מחדש.
- EQ-1.3 Orbit-Average Array Power היא יתומה: העמודה שלה ריקה. היא מחשבת את תפוקת המערכים הממוצעת למסלול מהספק השיא, מהחלק המואר ומנצילות נתיב ההספק, כלומר בדיוק את הגודל ש-3.1 מגבילה, ובכל זאת היא אינה ממלאת אף דרישה. האחות שלה EQ-1.4 Power Margin Check מקושרת ל-3.1; את EQ-1.3 החמיצו.
- F3 Generate and Store Power נושאת ארבע דרישות, כך ששינוי בה מגיע לכל הארבע. TC-07 מאמת שתיים (3.2 ו-3.3).
- תאי האימות מציגים את מצב הבדיקה: TC-06, TC-07 ו-TC-18 עברו, TC-19 לא הורץ. כיסוי ומצב אימות הם שאלות שונות: 3.6 מכוסה על ידי בדיקה שעוד לא הורצה.
לאורך כל המפרט, אותה בדיקה מוצאת שש דרישות עלה עם פערים: 2.5 Safe Mode Recovery, 3.5 ו-6.4 Operator Interface אינן ממולאות ואינן מאומתות, ו-1.5 Daily Collection Volume, 4.4 Downlink Encryption ו-6.5 Planning Cycle Time ממולאות אבל אינן מאומתות. ל-1.6 Revisit Time אין בדיקה משלה והיא אינה פער: היא הורה, שמכוסה דרך 1.6.1 ו-1.6.2. מחוץ לפרוסת ההספק, ל-S-1 Spare Reaction Wheel אין קישורים כלל, יתום טיפוסי עם סיבה טובה (חלק חילוף טיסה לאינטגרציה) שעדיין ראוי להחלטה מתועדת. החלקים 1.2.1 Reaction Wheel Assembly ו-1.2.2 Star Tracker אינם ממלאים דרישה ישירות אבל מבצעים פונקציות שממלאות, ולכן הם עוקבים בעקיפין; בדיקה שמסתכלת רק על קישורים ישירים הייתה קוראת להם בטעות יתומים.
השפעת שינוי: 3.1 עוברת מ-28 W ל-30 W
אחרי ה-Preliminary Design Review העומס הממוצע למסלול גדל ל-26 W, ולכן 3.1 עולה מ-28 W ל-30 W כדי לשמור על מרווח של 15 אחוז. הקישורים הופכים שישה פריטים לחשודים: 1.3.1 Solar Arrays, F3 Generate and Store Power, F3.1 Convert Sunlight to Power, EQ-1.1 Solar Power Generation, EQ-1.4 Power Margin Check ו-TC-06 Solar Array Power Test. ההצלחה של TC-06 אינה עוברת הלאה: שיא של 75.1 W נותן לפי EQ-1.3 רק 27.9 W בממוצע למסלול, מתחת ל-30 W. EQ-1.3, היתומה שנמצאה למעלה, אינה מסומנת כלל. המדריך לניתוח השפעת שינויים עוקב אחרי השינוי הזה צעד אחר צעד, מבקשת השינוי ועד הרשומה הסגורה.
הורדת טבלת העקיבות ורשימת התיוג
- מטריצת עקיבות הדרישות של EO-1 (CSV): כל 32 הדרישות של SRS-001 אחרי השינוי, שורה לכל אחת, עם מצב, מקור, הורה וצאצאים, derived from ו-derived by, refined by (לא בשימוש במודל הזה), satisfied by (פונקציות, רכיבים, אחר), verified by עם מצב הבדיקה, הכרעת כיסוי, ושישת הקישורים החשודים על 3.1. היא נוצרה ממודל ההדגמה, ולכן היא תואמת את המטריצה שלמעלה. הצרכים N1 עד N3 הם Statements, לא דרישות, ולכן הם אינם בה.
- רשימת תיוג לאיכות דרישות עם דוגמאות לפני ואחרי מ-EO-1 (CSV): רשימת התיוג המלאה מהמדריך לכתיבת דרישות טובות, לשימוש בסקירה.
רשימת תיוג לאיכות דרישות
העקיבות תלויה באיכות ההצהרות בכל קצה. דרישה מעורפלת אי אפשר להקצות או לאמת, ולכן היא מופיעה כפער כיסוי, ודרישה בלי נימוק אי אפשר לשפוט כשסימון חשד שואל אם הפריט שבהמשך הזרם עדיין תקף. במפרט של EO-1 יש במכוון שלוש דרישות חלשות: 2.5 Safe Mode Recovery (“should recover … quickly … as appropriate”), 3.5 Battery Thermal Control (“warm enough (TBD)”) ו-6.4 Operator Interface (“user friendly and/or easy to use”); 3.5 היא גם פער הכיסוי במטריצה שלמעלה. הבדיקות החשובות ביותר לעקיבה הן חובה אחת לכל הצהרה, ערך מדיד עם התנאים שלו, נימוק מתועד, קישור כלפי מעלה ושיטת אימות עם קריטריונים שנגזרים מההצהרה. במדריך לכתיבת דרישות טובות יש את רשימת התיוג המלאה, עם ניסוחים מחדש לפני ואחרי של שלושתן.
טעויות נפוצות
| טעות | מה משתבש | עדיף |
|---|---|---|
| התפשטות קישורים: קישור של כל מה שנראה קשור | כל שינוי מסמן עשרות פריטים, הסוקרים מפסיקים לקרוא את הסימונים, וניתוח ההשפעה מציג את כל המודל. | לקשר רק קשרים שהם נכונים ושמישהו היה סוקר אחרי שינוי. להשתמש בסוג הקישור המדויק ביותר. |
| קישורים חסרים בניתוחים | משוואות ותקציבים שמחשבים את הערך של דרישה אינם מסומנים כשהיא משתנה (EQ-1.3 למעלה). | לקשר כל ניתוח לדרישות שאת הערכים שלהן הוא מחשב או בודק. |
| טקסט “shall” שאי אפשר לעקוב אחריו: דרישות שקבורות בפסקאות של מפרט | משפט אי אפשר לקשר, לספור או לסמן בפני עצמו. שני “shall” באותה פסקה חולקים גורל אחד. | דרישה אחת לכל פריט, עם מזהה משלה, “shall” אחד לכל הצהרה. |
| עקיבה למסמכים במקום לפריטים | “3.4 is satisfied by the EPS Design Description” אינו אומר דבר על איזה חלק של התכן, והקישור שורד כל שינוי במסמך. | לעקוב אל הפונקציה, הרכיב, הממשק או מקרה הבדיקה. לקשר את המסמך לפריטים האלה אם הוא מתאר אותם. |
| שימוש בעקיבה פשוטה לכל דבר | בדיקות כיסוי מחפשות קישורי מילוי ואימות ומדווחות על פערים שאינם קיימים, או מחמיצות פערים אמיתיים. | לשמור את העקיבה הכללית לצרכים ולקישורים שלא הוכרעו; להשתמש ב-derive, satisfy ו-verify במקום שבו הם חלים. |
| עקיבה של הורים במקום עלים | קישורים כפולים בהורה ובצאצאיו, וכיסוי שנראה שלם בזמן שצאצא חסר. | להקצות ולאמת דרישות עלה; ההורה מכוסה דרכן, כמו 1.6 דרך 1.6.1 ו-1.6.2. |
| ניקוי סימוני חשד באצווה בלי סקירה | הרשומה טוענת לסקירה שלא התקיימה. | לנקות עם נימוק קצר לכל פריט, או לכל קבוצת פריטים שנסקרו יחד. |
| עקיבה פעם אחת, בסוף | הקישורים משוחזרים מהזיכרון לצורך ביקורת ומחמיצים את מה שהשתנה בדרך. | ליצור קישורים בזמן כתיבת הדרישות והתכן, ולסקור פערים בכל אבן דרך. |
מילה על אימות
קישור verify עונה על השאלה אם דרישה מכוסה על ידי פעילות אימות; הוא אינו אומר אם עומדים בדרישה. את זה קובעת התוצאה של הפעילות: TC-04 Pointing Accuracy Test מאמת את 2.1 ונכשל. תכנון השיטה לכל דרישה (בדיקה, ניתוח, בחינה או הדגמה), הרצת הפעילויות וסיכום התוצאות לאורך היררכיית הדרישות הם התפקיד של מטריצת אימות דרישות. פעילות מאמתת יכולה להיות גם ניתוח או סימולציה; דוגמת ה-MBSE מעריכה את 6.5 Planning Cycle Time בסימולציה של מעבר הצילום, והמדריך למונטה קרלו מסביר איך קוראים תוצאה כזאת. קישורי העקיבה שמתוארים כאן הם הקלט שלה.
לנסות ב-Holarch
בפרויקט LML, כל עקיבה היא קשר בין שתי ישויות, וקישור שנוצר במקום אחד מופיע בחלונית המאפיינים, במטריצה, בדיאגרמות Spider ו-Requirement וב-RVTM.
- יוצרים את ההדגמה דרך ניהול פרויקטים ← קובצי הפרויקט ▾ ← פרויקט הדגמה חדש ← CubeSat (הנדסת מערכות מודרכת). המפרט שלה כבר מכיל את השינוי ב-3.1 ואת ששת הקישורים החשודים.
- יש לפתוח את אימות ← מטריצת עקיבות. יש ללחוץ על התג שורות ולהגדיר את השאילתה
class:Requirement AND number:3.*; יש ללחוץ על התג עמודות ולהגדיר שאילתה כמוclass:Action OR class:TestCase. - יש לסמן את פערים בלבד כדי לראות את השורות בלי קישורים. יש לבחור קשר כמו satisfied by וללחוץ על תא ריק כדי ליצור קישור, למשל EQ-1.3 אל 3.1.
- יש לפתוח את צרכים ודרישות ← קישורים לבדיקה, ללחוץ על השוואה בשורה, ואז על סימון כנבדק… עם הערה.
- יש ללחוץ על ייצוא… במטריצה כדי לקבל את הרשת כ-Excel או CSV.
אימות ← בדיקות המודל מפרט דרישות עלה שאינן מוקצות או אינן מאומתות, ו-פתיחה ב- ▾ ← Spider של ישות מריץ ניתוח השפעה לפני שינוי. ההפניה המלאה נמצאת בעקיבות, וכללי הקישורים החשודים בקישורים לבדיקה.
לאן ממשיכים
- צרכים ודרישות ב-Holarch: מסמכים, בדיקות איכות, קווי בסיס ועקיבות במודל אחד.
- התיעוד של עקיבות: סוגי קשרים, מטריצת העקיבות, דיאגרמת Spider ובדיקות כיסוי.
- התיעוד של דרישות: כתיבה, אישור ויצירת קווי בסיס לדרישות, והדף קישורים לבדיקה.