מדריך · פרקטיקת MBSE
הנדסת קווי מוצרים וניהול גרסאות מוצר ב-MBSE
רוב המערכות נבנות ביותר מגרסה אחת. הנדסת קו מוצרים ממדלת את התכן המשותף פעם אחת ומנהלת את ההבדלים במכוון: מודל תכונות אומר מה יכול להשתנות, תצורות אומרות מה כל מוצר בחר, וכל דרישה, רכיב ובדיקה אומרים לאילו מוצרים הם שייכים. המדריך הזה מסביר את השיטה (מודל ה-150%, מודלי תכונות, תצורות תקפות, תחולה, ומסמכים, אימות וקווי בסיס לכל מוצר), ואז מיישם אותה על CubeSat שנבנה בשתי גרסאות.
בדף זה
- מהי הנדסת קו מוצרים
- מודל ה-150%
- מודלי תכונות
- תצורות ותקפותן
- קשירת השונות למודל
- פרמטרים לכל תצורה
- תחולה לפי מספר סידורי ותאריך
- מסמכים, אימות וקווי בסיס לכל תצורה
- כשלים נפוצים
- דוגמה מלאה: EO-1 Flight ו-EO-1 Lite
- קווי מוצרים ב-Holarch
- שאלות נפוצות
- לנסות ב-Holarch
- תרגיל: מציאה ותיקון של ארבע תקלות בקו מוצרים
- לאן ממשיכים
מהי הנדסת קו מוצרים
קו מוצרים הוא משפחה של מוצרים שחולקים את רוב התכן ונבדלים בכמה נקודות ידועות. החללית של לקוח השקה וגרסה מסחרית זולה יותר, רכב שנמכר עם שלושה גדלי סוללה, מכ״ם עם גרסה מקומית וגרסת ייצוא, שדרוגי בלוק של תחנת קרקע: כל אחד מהם הוא תכן אחד עם גרסאות. הנדסת קו מוצרים (PLE) היא הדיסציפלינה של בנייה ותחזוקה של המשפחה הזאת כנכס הנדסי אחד ולא כאוסף של פרויקטים נפרדים.
החלופה היא שכפול ובעלות (clone and own): מעתיקים את המודל, המסמכים ותוכניות הבדיקה של המוצר הראשון, ואז עורכים את העותק עבור המוצר השני. זה מהיר בהתחלה ויקר בהמשך. כל תיקון צריך להיעשות בכל עותק, איש אינו יכול לומר אילו הבדלים מכוונים, והעותקים מתרחקים זה מזה.
PLE מחליפה את העותקים בשלושה דברים:
- מודל משותף אחד שמכיל כל דרישה, פונקציה, רכיב, ממשק ובדיקה של כל מוצר.
- תיאור מפורש של השונות: הבחירות שנבדלות בין המוצרים והכללים ביניהן.
- קשירה מכל פריט משתנה אל הבחירות שהוא תלוי בהן, כך שכל מוצר אפשר לגזור מהמודל המשותף לפי דרישה.
ISO/IEC 26550 מתאר מודל ייחוס להנדסת קווי מוצרים של תוכנה ומערכות. הוא מפריד בין הנדסת התחום, העבודה על הנכסים המשותפים והשונות שלהם, לבין הנדסת היישום, העבודה של גזירת מוצר אחד מהם ומסירתו. ISO/IEC 26580 מוסיף שיטות ויכולות כלים לצורה מבוססת התכונות של PLE שהמדריך הזה עוקב אחריה. גרסאות מוצר נמצאות גם בתוך ניהול התצורה: ISO/IEC/IEEE 15288 הופך את זיהוי התצורה ואת קווי הבסיס לחלק מתהליך ניהול התצורה שלו, ו-SAE EIA-649 מתייחס לתחולה, היחידות שתצורה חלה עליהן, כחלק מזיהוי התצורה.
מתי קו מוצרים משתלם
ל-PLE יש עלות הקמה: מודל תכונות שצריך להסכים עליו וקשירה שצריך לתחזק. היא משתלמת כאשר:
- שני מוצרים או יותר חולקים את רוב הדרישות, הפונקציות והארכיטקטורה שלהם;
- שינוי בחלק המשותף צריך להגיע לכל מוצר;
- כל מוצר עדיין צריך מפרט, רשומת אימות וקווי בסיס משלו;
- צפויות גרסאות חדשות, ולכן צריך לתאר את ההבדלים פעם אחת ולהשתמש בהם שוב.
היא אינה משתלמת למוצר אחד שמשתנה לאורך זמן: יחידות שנבנות ברצף עם החלפות חלקים צריכות רק תחולה.
מודל ה-150%
המודל המשותף של קו מוצרים נקרא לעיתים קרובות מודל ה-150%. הוא מכיל את האיחוד של כל המוצרים: את שני מכשירי הרדיו כשלמוצר אחד יש רדיו S-band ולאחר רדיו X-band, את מודול ההנעה שחלק מהמוצרים עשויים לשאת, את דרישת ההצפנה שרק לקוח אחד ביקש.
כל מוצר הוא תצוגת 100% שלו: הפריטים ששייכים לאותו מוצר, עם הערכים שלו, נגזרים ולא מועתקים. זה מה שנותן לשיטה את התכונה העיקרית שלה: שינוי בפריט משותף נעשה פעם אחת ונמצא מיד בכל מוצר, ואילו שינוי בפריט משתנה מגיע רק למוצרים שהוא שייך להם.
שני סוגי הבדלים צריכים להיות מיוצגים במודל ה-150%:
- נוכחות: פריט נמצא בחלק מהמוצרים ולא באחרים (רדיו ה-X-band, דרישת ההצפנה, בדיקת קישור ה-X-band).
- ערך: פריט נמצא בכל מוצר אבל עם ערך שונה בחלקם (נפח נתונים יומי של 3 GB במוצר אחד ו-1 GB באחר, מסה, תוצאת בדיקה).
הבדל שלישי, זמן (אילו יחידות או תאריכי בנייה), מטופל באמצעות תחולה.
מודלי תכונות
תכונה (feature) היא מאפיין של המוצר שלקוח, שוק או החלטה הנדסית יכולים לבחור: “X-band Downlink”, “Encrypted Downlink”, “Propulsion”. מודל תכונות מסדר את התכונות בעץ ומוסיף את הכללים שקובעים אילו צירופים מותרים. הסימון נובע מניתוח התחום מוכוון התכונות (FODA) של תחילת שנות ה-90, וכיום זו הדרך הנפוצה ביותר לתאר שונות בקווי מוצרים.
כל תכונה, וכל קבוצה של תכונות צאצא, נושאת כלל אחד מתוך קבוצה קטנה של כללים:
| כלל | משמעות | דוגמה |
|---|---|---|
| חובה | לכל מוצר שיש לו את ההורה יש את התכונה הזאת. | לכל חללית יש קישור למטה. |
| רשות | נבחרת לכל מוצר בנפרד. | הצפנה, הנעה. |
| חלופה (בחירה של אחת) | בדיוק צאצא אחד מהקבוצה לכל מוצר. | הקישור למטה הוא S-band או X-band, לעולם לא שניהם ולעולם לא אף אחד. |
| או (בחירה של אחת לפחות) | צאצא אחד או יותר לכל מוצר. | חבילת חיישנים של אור נראה, אינפרה-אדום או שניהם. |
| דורשת | בחירת התכונה הזאת מחייבת תכונה אחרת. | הצפנה דורשת את רדיו ה-X-band, שהמודם שלו תומך בה. |
| לא כולל | שתי התכונות לעולם אינן מופיעות יחד. | אנטנה נפרסת שוללת את אפשרות הנפח המקופל. |
| אילוץ | כל תנאי אחר, שנכתב כביטוי לוגי על תכונות. | הנעה ולא הסוללה הקטנה. |
יש לתת לתכונות שמות לפי המוצר, לא לפי המסמכים או החלקים: “X-band Downlink”, לא “אפשרות B בסעיף 5” או “Radio P/N 4471”. תכונה אחת ממופה בדרך כלל לכמה רכיבים, דרישות ובדיקות; יש להפריד בין עץ התכונות לעץ הרכיבים ולתת לקשירה לחבר ביניהם. כל כלל נכתב לתוך המודל ברגע שהוא ידוע.
תצורות ותקפותן
תצורה היא מוצר אחד: בחירה עם שם של תכונות, כמו “EO-1 Lite: קישור למטה S-band, ללא הצפנה, ללא הנעה”. התצורה היא מה שלקוח קונה, מה שמפרט נכתב עבורו, מה שמערך בדיקות מאמת ומה שקו בסיס מקפיא.
הבחירה האפקטיבית של תצורה גדולה מהתכונות שמישהו סימן. היא כוללת גם את ההורים של כל תכונה שנבחרה, את צאצאי החובה של כל תכונה שנבחרה ואת תכונות החובה שבשורש. פריט שקשור לתכונת הורה נמצא לכן בכל מוצר שבחר באחד מצאצאיה.
תצורה היא תקינה כשהבחירה האפקטיבית שלה מקיימת כל כלל של מודל התכונות. בדיקה של כל תצורה נותנת אחת משלוש תשובות:
- תקינה: כל הכללים מתקיימים.
- מפרה כלל: למשל, מוצר בחר בהצפנה בלי רדיו ה-X-band שהיא דורשת.
- לא שלמה: חסרה בחירה, למשל אין רצועת קישור למטה בקבוצת בחירה של אחת.
תקינות היא הבדיקה הזולה ביותר ב-PLE: תצורה לא תקינה היא מוצר שאי אפשר לבנות כפי שהוא מפורט, והיא מתגלה כשהוא מוגדר ולא באינטגרציה. יש לבדוק גם את מודל התכונות: תכונה שאף תצורה אינה בוחרת היא אפשרות עתידית או משקל מת.
מספר התצורות האפשריות גדל מהר: עשר תכונות רשות בלתי תלויות מאפשרות 1,024 צירופים. קווי מוצרים אמיתיים מגדירים במכוון קומץ תצורות ומתייחסים לשאר המרחב כלא מוצע.
קשירת השונות למודל
מודל התכונות אומר מה יכול להשתנות. הקשירה אומרת אילו פריטי מודל תלויים באילו בחירות. כל פריט משתנה נושא תנאי נוכחות: ביטוי לוגי על תכונות (ולעיתים רחוקות על תצורות) שמתקיים עבור המוצרים שכוללים את הפריט. פריטים בלי תנאי כזה נמצאים בכל מוצר, ובקו מוצרים בנוי היטב אלה רוב המודל.
הקשירה צריכה לכסות כל סוג של פריט, אחרת תצוגות ה-100% לא יהיו עקביות:
- דרישות: דרישה שרק חלק מהלקוחות ביקשו קשורה לתכונה שהם בחרו. דרישה שיש לכל מוצר, אבל עם ערך שונה, אינה קשורה; במקום זאת היא מקבלת ערך לכל תצורה.
- פונקציות: בדרך כלל משותפות; פונקציה משתנה רק כשמוצר עושה משהו שהאחרים אינם עושים.
- רכיבים וממשקים: רדיו ה-X-band, ממשק הנתונים שלו וקישור ה-RF שלו קשורים כולם לאותה תכונה. ממשק ששני קצותיו לעולם אינם באותו מוצר הוא שגיאת קשירה.
- בדיקות ואימות: בדיקה של קישור ה-X-band שייכת רק למוצרים עם רדיו ה-X-band. בדיקה ששני המוצרים מריצים נשארת משותפת ומתעדת תוצאה אחת לכל מוצר.
- קשרים: קישור satisfies או verifies בדרך כלל עוקב אחרי הקצוות שלו. יש לקשור קשר בנפרד רק כששני הקצוות שלו נמצאים יחד בכמה מוצרים אבל הקישור מתקיים רק בחלקם.
יש לכתוב תנאי נוכחות במונחים של תכונות, לא תצורות. “X-band Downlink” נשאר נכון כשמתווסף מוצר שלישי עם רדיו X-band; “EO-1 Flight” משמיט בשקט את המוצר החדש. יש לציין תצורה בתנאי רק עבור פריט חד-פעמי באמת, כמו תווית ייעודית ללקוח.
פרמטרים לכל תצורה
הבדלים רבים הם ערכים, לא נוכחות: נפח נתונים, הקצאת מסה, אורך חיים תכנוני. דרישה נפרדת לכל מוצר עבור כל ערך הייתה מכפילה פריטים ומפצלת את הקישורים שלהם.
הדפוס הטוב יותר הוא פריט אחד עם ערך בסיס וערך משלו לכל תצורה במקום שבו הוא שונה. הפריט שומר על זהות אחת (מספר אחד, קבוצת קישורים אחת, היסטוריה אחת), והתצוגה של כל מוצר מציגה את הערך שלו. תצורה בלי ערך משלה משתמשת בבסיס.
יש לתת ערך משלו רק במקום שבו הערך באמת שונה, כך ששינוי בבסיס עדיין מגיע לכל מוצר אחר. ויש לבדוק את הטקסט שסביב הערך: נימוקים, ספי בדיקה ודרישות נגזרות מצטטים לעיתים קרובות את המספר, וכל ציטוט צריך את אותו טיפול, אחרת התצוגה של המוצר סותרת את עצמה. בדוגמה המלאה יש מקרה כזה.
תחולה לפי מספר סידורי ותאריך
תחולה אומרת מאיזו יחידה או מאיזה תאריך בנייה פריט חל. היא עונה על שאלה שונה מתנאי הנוכחות:
| תנאי נוכחות (Applies To) | תחולה | |
|---|---|---|
| שאלה | אילו מוצרים כוללים את הפריט? | על אילו יחידות, או על אילו תאריכי בנייה, הוא חל? |
| נכתב כ | ביטוי על תכונות ותצורות | טווחי מספרים סידוריים כמו 1-20, 25, 40-, וטווח תאריכים |
| שימוש אופייני | אפשרויות, גרסאות מוצר, בחירות לקוח | החלפות חלקים במהלך הייצור, שדרוגי בלוק, התקנות בדיעבד |
| ריק פירושו | כל מוצר | כל יחידה, תמיד |
השניים משתלבים: פריט נמצא בתצוגה כשהוא שייך למוצר וגם בתוקף עבור היחידה או התאריך שבודקים. החלפת חלק ממספר סידורי 2 ואילך ממודלת כשני פריטים, החלק הישן עם תחולה “SN 1” והחלק החדש עם “SN 2 ואילך”, שניהם עם אותו תנאי נוכחות. כך שני התכנים נשמרים במודל, ורשומת ה-as-built של יחידה 1 נשארת מדויקת אחרי שיחידה 2 משתנה.
לתצורה יש תחולה משלה: המספרים הסידוריים שנבנו לפיה. היא מתעדת אילו יחידות הן איזה מוצר; היא אינה מסננת את הפריטים. שתי תצורות שטווחי המספרים הסידוריים שלהן חופפים מצביעות בדרך כלל על טעות במספור.
מסמכים, אימות וקווי בסיס לכל תצורה
העיקר במודל ה-150% הוא שכל מוצר עדיין מקבל את כל מה שהיה לפרויקט של מוצר יחיד:
- מסמכים לכל תצורה. מפרט שנוצר למוצר אחד משמיט את הסעיפים שאינם חלים, מציג את הערכים של אותו מוצר, ואומר בעמוד השער שלו איזו תצורה (ואם רלוונטי, איזה מספר סידורי או תאריך) הוא מתאר. מספרי הסעיפים במסמך כזה הם מספרי תצוגה: הם סוגרים את הפערים שהשאירו סעיפים שהוסרו, בעוד המספרים השמורים במודל נשארים זהים לכל מוצר.
- אימות לכל תצורה. “מאומת” פירושו מאומת למוצר אחד. דרישה ששני מוצרים חולקים יכולה להיות מאומתת לאחד ועדיין פתוחה לשני, ולכן התוצאות מתועדות לכל תצורה ומטריצת האימות נקראת לכל תצורה.
- קווי בסיס לכל תצורה. סקירת התכן של מוצר מקפיאה את אותו מוצר. קו בסיס של תצורה מתעד את כל קו המוצרים עם תווית התצורה שבסקירה, כך שאפשר להשוות אותו למצב מאוחר יותר של אותו מוצר או למוצר אחר באותו רגע.
- בקרת שינויים לכל תצורה. בקשת שינוי צריכה לומר אילו מוצרים היא משנה. שינוי בפריט משותף משנה כל מוצר; שינוי בערך המשלו של תצורה אחת משנה רק אותה.
כשלים נפוצים
| כשל | מה משתבש | עדיף |
|---|---|---|
| שכפול ובעלות כפתרון זמני | העותק הופך לקבוע; תיקונים מגיעים למוצר אחד ולא לשני. | להתחיל את המוצר השני כתצורה של המודל הראשון. |
| תכונות שנקראות על שם מסמכים או חלקים | מודל התכונות הופך לרשימת חלקים, וכל שינוי תכן כותב אותו מחדש. | לתת לתכונות שמות של בחירות שהלקוח רואה; לתת לקשירה למפות אותן לחלקים. |
| תנאי נוכחות שמציינים תצורות | מוצר חדש מחמיץ בשקט פריטים שקשורים ל-“CFG-1”. | לקשור לתכונות; לציין תצורה רק לפריטים חד-פעמיים. |
| עותקים במקום ערכים משלהם | שתי דרישות “Daily Data Volume”, לכל אחת חצי מהקישורים. | דרישה אחת עם ערך בסיס וערך משלה לכל תצורה. |
| ערכים מצוטטים שהתיישנו | נימוק או סף עדיין מצטטים את ערך הבסיס במוצר שיש לו ערך משלו. | לסקור את התצוגה של כל מוצר, לא רק את מודל ה-150%. |
| כללים שנשמרים מחוץ למודל | תצורה שאי אפשר לבנות עוברת סקירה. | לכתוב requires, excludes ואילוצים במודל התכונות; לבדוק כל תצורה. |
| ממשקים שקשורים באופן לא עקבי | ממשק שקצותיו לעולם אינם באותו מוצר, או רכיב בלי הממשק שלו. | לקשור רכיב, את הממשקים שלו ואת הבדיקות שלו לאותה תכונה; להריץ את בדיקות העקביות. |
| אימות שנספר לכל הקו | דרישה מוצגת “מאומתת” כי מוצר אחד עבר. | לקרוא את מטריצת האימות לכל תצורה. |
דוגמה מלאה: EO-1 Flight ו-EO-1 Lite
הדוגמה היא EO-1, CubeSat בדיוני בגודל 6U שמצלם שטחים חקלאיים, ממודל ב-Holarch כפרויקט LML. זה אותו מודל כמו בדוגמת ה-MBSE מקצה לקצה. ההדגמה בונה את EO-1 כשני מוצרים:
- EO-1 Flight, החללית ללקוח ההשקה, שהחוזה שלו מבקש סצנות מלאות שנמסרות במעבר אחד ומוצפנות בתעבורה;
- EO-1 Lite, חללית בעלות נמוכה יותר לקוני צילומים מסחריים, עם קישור ה-S-band למטה של התכן המקורי.
המדריך לניתוח חלופות משווה בין S-band ל-X-band לקישור למטה ובוחר ב-S-band בגלל העלות והתמיכה של תחנות הקרקע. ההחלטה הזאת תקפה למוצר המסחרי. ניתוח הרגישות שלה הראה ש-X-band מנצח כשקצב הנתונים מקבל משקל גבוה, וזה המקרה של לקוח ההשקה; קו מוצרים שומר את שתי התשובות.
מודל התכונות
בדף בקרה וסקירות ← קו מוצרים, ל-EO-1 יש חמש תכונות:
| תכונה | סוג | צאצאים | כללים | משמעות |
|---|---|---|---|---|
| F-1 Downlink | חובה | בחירה של אחת | לכל מוצר יש בדיוק רצועת קישור למטה אחת. | |
| F-2 S-band Downlink | רשות (צאצא של F-1) | 2.2 GHz ב-10 Mbps דרך רשת הקרקע של השותף. | ||
| F-3 X-band Downlink | רשות (צאצא של F-1) | 8 GHz ב-100 Mbps, למסירה של סצנות מלאות באותו מעבר. | ||
| F-4 Encrypted Downlink | רשות | requires F-3 | נתוני המטען מוצפנים בתעבורה. | |
| F-5 Propulsion | רשות | requires F-3 | מדחף גז קר לשמירת מסלול. הוא נכנס רק לצד רדיו ה-X-band. נבחן; לאף מוצר עדיין אין אותו. |
קבוצת הבחירה של אחת היא לב המודל: שני מכשירי הרדיו הם חלופות, כך שלאף מוצר לא יכולים להיות שניהם או אף אחד. שני כללי ה-requires מתעדים עובדות הנדסיות: ההצפנה רצה במודם ה-X-band, והמדחף נכנס רק בפריסה שרדיו ה-X-band מפנה.
שתי התצורות וההכרעות שלהן
| תצורה | מצב | מספרים סידוריים | בוחרת | הכרעה |
|---|---|---|---|---|
| CFG-1 EO-1 Flight | שוחרר | 1–2 | F-3 X-band Downlink, F-4 Encrypted Downlink | תקינה |
| CFG-2 EO-1 Lite | טיוטה (Draft) | 3 ואילך | F-2 S-band Downlink | תקינה |
שתי התצורות מכילות גם את F-1 Downlink, כתכונת חובה בשורש וכהורה של הרצועה שנבחרה; הרשת מסמנת אותה כמשתמעת. כדי לראות את הכללים בפעולה, יש לסמן את Encrypted Downlink בעמודה CFG-2. ההכרעה משתנה ל-“מפרה: Encrypted Downlink דורשת X-band Downlink.” הצפנה במוצר Lite הייתה שינוי תכן, לא שינוי תצורה. אפשר לבטל את הסימון עם ⌘Z / Ctrl+Z.
מה שייך לאיזה מוצר
לרוב EO-1 יש Applies To ריק: המבנה, מערכת ההספק, המצלם, קישור הפקודות, תוכנת הטיסה ורוב הדרישות נמצאים בשני המוצרים. הפריטים שנבדלים קשורים לתכונות, לעולם לא לתצורה:
| Applies To | פריטים | נמצא ב |
|---|---|---|
| F-2 S-band Downlink | 1.5.2 S-band Transmitter; דרישה 5.1 S-band Downlink Rate | EO-1 Lite |
| F-3 X-band Downlink | 1.5.3 X-band Payload Radio; ממשקים IF-08.1 X-band Data Interface ו-IF-12.1 X-band Downlink; דרישה 5.5 X-band Downlink Rate; מקרה בדיקה TC-21 X-band Link Test | EO-1 Flight |
| F-4 Encrypted Downlink | דרישה 4.4 Downlink Encryption | EO-1 Flight |
רדיו ה-X-band קשור יחד עם כל מה שתלוי בו: שני הממשקים שלו, הדרישה שהוא ממלא והבדיקה שמאמתת את הדרישה הזאת. הוא גם מבצע את אותה פעולת קישור למטה כמו משדר ה-S-band, ובכל מוצר נמצא רק אחד משני מכשירי הרדיו, כך שהפונקציה משותפת והמבצע שלה משתנה.
הקשירה אינה שלמה, וסקירה של התצוגה של EO-1 Flight מראה היכן. חיפוש “S-band” בתצוגה הזאת: לדרישה 5.3 Downlink Link Margin (“The S-band downlink shall close with at least 3 dB link margin…”), למקרה הבדיקה TC-10 S-band Link Test ולממשק IF-12 S-band Downlink אין Applies To, ולכן הם נמצאים גם ב-EO-1 Flight, מוצר בלי רדיו S-band. בדיקות המודל אינן יכולות לראות זאת: הפריטים עקביים כקישורים, ורק הטקסט שלהם נוקב בשם הגרסה. כל אחד מהם צריך החלטה: לקשור אותו ל-F-2 ולהוסיף את המקבילה ב-X-band היכן שהיא חסרה (ל-5.3 אין; IF-12.1 ו-TC-21 כבר קיימים), או לנסח אותו מחדש כך שיתקיים לשתי הרצועות. חיפוש בתצוגה של כל מוצר אחר שמות הגרסאות שאין לו הוא צעד סקירה זול לכל קו מוצרים.
כיוון שהקשירה משתמשת בתכונות, מוצר שלישי עתידי עם רדיו X-band וללא הצפנה היה מקבל אוטומטית את הרדיו, את הממשקים שלו ואת TC-21, ומשמיט את 4.4.
ערך ששונה: 5.4 Daily Data Volume
דרישה 5.4 Daily Data Volume נמצאת בשני המוצרים, ולכן היא אינה קשורה. טקסט הבסיס שלה הוא “The ground segment shall receive at least 3 GB of payload data each day.” הקונים המסחריים של EO-1 Lite צריכים פחות, ולכן ל-CFG-2 יש ערך משלה: “at least 1 GB”. יש לבחור הצגה כ ▾ ← CFG-2 EO-1 Lite ולפתוח את 5.4: התיאור מציג 1 GB ונושא תג ערך CFG-2. ב-כל התצורות השדה מסומן משתנה. 5.4 שומרת על מספר אחד, קבוצת קישורים אחת והיסטוריה אחת.
המספרים שמאחורי זה פשוטים. ב-10 Mbps מעבר S-band של 8 דקות מחזיר 4.8 ג׳יגה-ביט, או 0.6 GB; 3 GB דורשים חמישה מעברים ביום ו-1 GB דורש שניים. ב-100 Mbps מעבר X-band אחד מחזיר 6 GB, ולכן EO-1 Flight מוסרת יום שלם של סצנות במעבר יחיד.
עכשיו נבחן את 5.1 S-band Downlink Rate, שחלה רק על EO-1 Lite. הנימוק שלה הוא “Clears one day of collection (3 GB, Req 5.4) in five 8 minute passes.” ב-EO-1 Lite, 5.4 מבקשת 1 GB, כך שהנימוק מצטט ערך שהמוצר היחיד שהיא שייכת לו אינו משתמש בו. הקצב עצמו תקין; ההצדקה התיישנה. זה מצב הכשל “ערכים מצוטטים שהתיישנו” שלמעלה, והוא מתגלה רק בקריאת התצוגה של המוצר עצמו. התיקון הוא לתת לנימוק של 5.1 את ההיגיון של Lite (שני מעברים ל-1 GB, עם מרווח למעברים שהוחמצו), או לציין את הגורם האמיתי שקובע את הקצב.
החלפת חלק לפי מספר סידורי
יש לפתוח את 1.3.2 Battery Pack. יש לו שני מאפייני מחמם: Thermostat Heater Power (2 W, תחולה SN 1) ו-Software-Controlled Heater Power (3 W, SN 2 ואילך). המחמם הוחלף מהחללית השנייה ואילך. שניהם נמצאים בכל מוצר: השינוי נוגע ליחידות, לא לאפשרויות.
טווחי המספרים הסידוריים הם המקום שבו שני המושגים נפגשים. EO-1 Flight היא מספרים סידוריים 1–2, כך שהשינוי מתרחש בתוך תצורה אחת: יחידה 1 טסה עם מחמם התרמוסטט, יחידה 2 עם המחמם שבשליטת התוכנה. EO-1 Lite מתחילה במספר סידורי 3 ויש לה רק המחמם החדש. כש-הצגה כ ▾ ← תחולה ▸ ← מספר סידורי… מוגדר ל-1, התצוגה מציגה את יחידה 1 כפי שנבנתה; כשהוא מוגדר ל-2, היא מציגה את החללית השנייה. המחמם החדש צורך 1 W יותר, וזה סוג הערך שהמדריך להשפעת שינויים עוקב אחריו עד לתקציב ההספק.
אימות לכל מוצר
מקרה הבדיקה TC-11 UHF Command Test רץ על שני המוצרים, ומחזיק תוצאה אחת לכל תצורה: עבר ב-EO-1 Flight (500 מתוך 500 פקודות בתוך 0.4 s מהתגיות שלהן, על ה-flatsat FS-1) ו-בתהליך ב-EO-1 Lite (312 מתוך 500 פקודות נשלחו, על ה-flatsat FS-3). הדרישות שהוא מאמת מאומתות לכן למוצר אחד ופתוחות לשני.
אימות ← RVTM מציג את שתי הקריאות. ב-כל התצורות, קבוצת העמודות תצורה נותנת מצב מסוכם אחד לכל תצורה, עם “—” במקום שבו דרישה אינה חלה (ל-5.5 X-band Downlink Rate אין מצב עבור EO-1 Lite). בתצוגת תצורה ה-RVTM מפרט רק את הדרישות והתוצאות של אותו מוצר, כך ש-“מאומת” פירושו מאומת לאותו מוצר. TC-21 X-band Link Test, שעדיין לא הורץ, מופיע רק במטריצה של EO-1 Flight.
כדי לתעד תוצאות חדשות למוצר אחד, יש לבחור אותו ב-הצגה כ ▾ ולהשתמש ב-הרצת החבילה ב-אימות ← מרכז הבדיקות: מוצג “מתעד תוצאות עבור CFG-2.” והתוצאות נשמרות כערכים של אותה תצורה.
מפרט אחד לכל מוצר
הדרישות נמצאות במסמך אחד, SRS-001 EO-1 System Requirements Specification. כדי למסור אותו עבור EO-1 Lite, יש לפתוח אותו, לבחור מסירה ▾ ← מפרט (Word), להגדיר את תצורה ל-CFG-2 EO-1 Lite ואת תחולה ל-כל יחידה, ולייצא. מפרט ה-Lite משמיט את 4.4 Downlink Encryption ואת 5.5 X-band Downlink Rate, מציג את 5.4 עם 1 GB, ומציין את התצורה בעמוד השער, בכותרת התחתונה ובשם הקובץ.
מפרט EO-1 Flight משמיט במקום זאת את 5.1 S-band Downlink Rate, ולכן הדרישות שאחריה בסעיף 5 ממוספרות באחד פחות במסמך הזה, והקובץ אומר “המספור כפי שמוצג ב-CFG-1.” המספרים של המודל אינם משתנים, ולכן ציטוט של דרישה של מוצר אחד צריך לציין את התצורה יחד עם המספר.
כשמייצאים עם כל התצורות ו-הצגת תחולה פעילים, אותו מסמך הוא מפרט ה-150%: כל הסעיפים, עם “חל על: CFG-1” מתחת לסעיפים שיש רק ל-EO-1 Flight.
קו הבסיס EO-1 Flight PDR
ההדגמה מחזיקה את קו הבסיס של התצורה EO-1 Flight PDR, שנלקח ל-Preliminary Design Review של EO-1 Flight, ב-בקרה וסקירות ← קווי בסיס וגרסאות. הוא מתעד את כל קו המוצרים עם התווית CFG-1, ונוצר עם יצירת קו בסיס לתצורה…. השוואה שלו למודל הנוכחי לפי תצורה מראה מה השתנה ב-EO-1 Flight מאז ה-PDR, ושום דבר שהשתנה רק ב-EO-1 Lite.
CFG-1 במצב שוחרר ו-CFG-2 עדיין טיוטה: מוצר ה-Lite עדיין בהגדרה. כשבקרת התצורה פעילה, תצורה שמצבה שוחרר והיא בקו הבסיס האחרון נמצאת תחת בקרה, כך שהערכים שלה משתנים רק דרך בקשת שינוי. הכרטיס תצורות של בקשת שינוי מציין את המוצרים שהיא משנה, וה-בעלים של תצורה צריך לאשר בקשות שמשנות אותה.
מה הבדיקות מוצאות
אימות ← בדיקות המודל מריץ את קבוצת הכללים קו מוצרים ב-כל התצורות. ב-EO-1 הכללים אינם מדווחים על שגיאות, ו-ProductLine.4 מזהיר ש-Propulsion אינה נבחרת באף תצורה. כאן זה מכוון: F-5 היא אפשרות שנבחנה, שנשמרת במודל התכונות כדי שהכלל “requires X-band Downlink” יתועד לפני שמישהו מציע אותה. בתוכנית אמיתית האזהרה היא קריאה להחליט, ולתעד את ההחלטה: להציע אותה, להשאיר אותה כמחקר או למחוק אותה.
קווי מוצרים ב-Holarch
Holarch מיישם את השיטה במודל אחד: הדף קו מוצרים מחזיק את עץ התכונות ואת התצורות עם ההכרעות שלהן, הקבוצה קו מוצרים בחלונית המאפיינים מחזיקה את Applies To ואת התחולה, ו-הצגה כ ▾ מציג ועורך כל דף כתצורה אחת. מסמכים, ה-RVTM, מרכז הבדיקות, החיפוש (appliesto:CFG-2, varies:yes) ובדיקות המודל עוקבים אחרי התצוגה.
קווי מוצרים הם חלק מהתוכניות Individual ו-Team. קווי בסיס לכל תצורה, השוואה לפי תצורה, בעלי תצורות והתצורות שבקשת שינוי משנה הם חלק מהתוכנית Team.
שונות ב-SysML v2
ב-SysML v2 יש שונות בתוך השפה: variation מסמן נקודה שבה מוצרים נבדלים, איברי ה-variant שלה הם הבחירות המותרות, assert constraint פוסל צירופים, ותצורה היא usage שקושר variant אחד לכל נקודה. בפרויקט SysML v2 Holarch קורא אותם ישירות: הדף קו מוצרים מציג את נקודות השונות ואת התצורות עם הכרעה, ו-הצגה כ ▾ מציג את המודל כתצורה אחת. ה-CarLine של הדגמת Hybrid Car, עם הנקודות pack ו-charger והכלל wallboxNeedsLargePack, הוא הדוגמה. ראו SysML v2 Variants and Configurations.
שאלות נפוצות
מהו מודל 150%?
המודל המשותף של קו מוצרים, שמחזיק את האיחוד של הפריטים של כל המוצרים. כל מוצר הוא תצוגת 100% שלו, שנגזרת על ידי שמירת הפריטים שתנאי הנוכחות שלהם מתקיים עבור אותו מוצר והצגת הערכים של אותו מוצר. השם אומר רק שהמודל גדול מכל מוצר בודד.
מה ההבדל בין גרסת מוצר (variant) לגרסה (version)?
גרסאות מוצר (variants) קיימות זו לצד זו: EO-1 Flight ו-EO-1 Lite הן שתיהן מוצרים נוכחיים. גרסאות (versions) באות זו אחר זו בזמן: התכן ב-PDR, ואז ב-CDR. גרסאות מוצר מנוהלות בתכונות ובתצורות, גרסאות בקווי בסיס, ויחידות שנבנות לאורך זמן בתחולה. קו בסיס של תצורה משלב את שני הראשונים.
מתי כדאי להשתמש בתחולה במקום בתכונה?
כשההבדל נוגע לאילו יחידות נבנו מתי, ולא למה שלקוח בחר. חלק שהשתנה ממספר סידורי 2 ואילך הוא תחולה. חלק שחלק מהלקוחות מזמינים ואחרים לא הוא תכונה, גם אם הלקוח הראשון שמזמין אותו מקבל במקרה את המספרים הסידוריים המאוחרים.
לנסות ב-Holarch
- יוצרים את ההדגמה דרך ניהול פרויקטים ← קובצי הפרויקט ▾ ← פרויקט הדגמה חדש ← CubeSat (הנדסת מערכות מודרכת).
- יש לפתוח את בקרה וסקירות ← קו מוצרים. יש לקרוא את עץ התכונות ואת שתי עמודות התצורה; בשתי ההכרעות כתוב תקינה.
- בעמודה CFG-2 EO-1 Lite, יש לסמן את Encrypted Downlink. יש לקרוא את ההכרעה, ואז ללחוץ ⌘Z / Ctrl+Z.
- יש לפתוח את הדרישה 4.4 Downlink Encryption ולהסתכל על הקבוצה קו מוצרים בחלונית המאפיינים: Applies To הוא F-4, והשורה שמתחתיו מציינת את התצורה האחת שהוא חל עליה.
- יש לבחור הצגה כ ▾ ← CFG-2 EO-1 Lite. יש לפתוח את 5.4 Daily Data Volume ולמצוא את התג ערך CFG-2; אחר כך לפתוח את 5.1 S-band Downlink Rate ולקרוא את הנימוק שלה מולו.
- יש לפתוח את אימות ← RVTM באותה תצוגה, ואז ללחוץ על יציאה בפס ולהשוות את קבוצת העמודות תצורה ב-כל התצורות.
- יש לפתוח את 1.3.2 Battery Pack ואת שני מאפייני המחמם שלו. יש לבחור הצגה כ ▾ ← תחולה ▸ ← מספר סידורי… ולהזין 1, ואז 2.
- יש לפתוח את SRS-001, לבחור מסירה ▾ ← מפרט (Word), להגדיר את תצורה ל-CFG-2 EO-1 Lite ולייצא.
- יש לפתוח את אימות ← בדיקות המודל ב-כל התצורות ולמצוא את אזהרת ProductLine.4 עבור Propulsion.
קווי מוצרים דורשים את התוכנית Individual או Team; קו הבסיס של תצורה ובעלי תצורות דורשים Team. ההפניה המלאה נמצאת בקווי מוצרים ותצורות, כולל Applies To, עריכה בתצוגת תצורה, תחולה ומסמכים, RVTM ואימות.
תרגיל: מציאה ותיקון של ארבע תקלות בקו מוצרים
קו מוצרים כמעט אף פעם אינו נכשל בבת אחת. הוא נכשל דרך עריכות קטנות שכל אחת מהן נראית סבירה: כלל שנוסף בחופזה, טווח מספרים סידוריים שהוקלד יחידה אחת נמוך מדי, בדיקה שנקשרה לתכונה הלא נכונה, שינוי כלל ששובר בשקט מוצר שכבר שוחרר. התרגיל הזה שותל ארבע תקלות כאלה בקו המוצרים של EO-1, ובו מוצאים כל אחת מהן בבדיקות שסוקר היה מריץ, ואז מתקנים אותה. הוא מראה גם היכן הבדיקות נעצרות, כי הידיעה מה כלי אינו בודק היא חלק משימוש טוב בו.
מה צריך: עותק טרי של הדגמת CubeSat EO-1 ותוכנית עם קווי מוצרים (Individual או Team, או חשבון אקדמי או כיתתי; בתוכנית Free הדף קו מוצרים הוא לקריאה בלבד). כדאי לעבוד בזוגות אם אפשר: אדם אחד שותל את התקלות בזמן שהשני מסתכל הצידה, ואז השני מוצא אותן. לבד, אפשר לשתול את כל הארבע, לסגור את הפרויקט ולחזור אליו בתור סוקר.
שתילת התקלות
- כללי תכונות סותרים. יש לפתוח את בקרה וסקירות ← קו מוצרים. בתפריט ⋯ של השורה F-5 Propulsion יש לבחור כללים…, לסמן את F-3 X-band Downlink תחת לא כולל וללחוץ על החלה. עכשיו Propulsion גם דורשת וגם שוללת את הקישור למטה ב-X-band.
- תחולה חופפת. בתפריט ⋯ של העמודה CFG-2 EO-1 Lite יש לבחור תחולה… ולשנות את מספרים סידוריים מ-
3-ל-2-, כאילו בניית ה-Lite הוקדמה ביחידה אחת. - אימות חסר לתצורה אחת. יש לפתוח את מקרה הבדיקה TC-10 S-band Link Test ובקבוצה קו מוצרים בחלונית המאפיינים להגדיר את Applies To ל-
F-3, כאילו בדיקת הקישור שייכת לרדיו ה-X-band. - שינוי שפוסל תצורה משוחררת. בחזרה בדף קו מוצרים, יש לפתוח את כללים… ב-F-4 Encrypted Downlink, לסמן את F-5 Propulsion תחת דורשת וללחוץ על החלה, כאילו חומרת ההצפנה צריכה עכשיו את תא ההנעה.
מציאתן בתור סוקר
יש להשתמש רק במה שסוקר היה משתמש בו: שורת ההכרעה ו-בדיקת תצורות בדף קו מוצרים, אימות ← בדיקות המודל (ללחוץ על ↻ הרצת בדיקות ולהסתכל על קבוצת הכללים קו מוצרים), וה-RVTM, גם ב-כל התצורות וגם כש-הצגה כ ▾ מוגדר לכל מוצר. יש לרשום כל תקלה שנמצאה, מה הראה אותה ועל איזה מוצר היא משפיעה, לפני שפותחים את התשובות.
הצגת המקום שבו כל תקלה מופיעה, ואת התיקון
| תקלה | היכן Holarch מציג אותה | תיקון |
|---|---|---|
| שינוי ששובר תצורה משוחררת | בהכרעה של CFG-1 EO-1 Flight, שמצבה שוחרר, כתוב “מפרה: Encrypted Downlink דורשת Propulsion.” בדיקת תצורות מפרטת אותה, ובדיקות המודל מדווחות עליה כ-ProductLine.3, שגיאה. | יש להסיר את Propulsion מ-דורשת של F-4. Holarch לא סירב לעריכה: הכלל נמצא בתכונה, לא בתצורה המשוחררת, ולכן ההכרעה היא שתופסת אותו. |
| תחולה חופפת | ProductLine.7 מזהיר על שתי התצורות (“חולקת מספרים סידוריים עם …”), וחלון התחולה אומר איזה טווח חופף לאיזה. SN 2 נתבע עכשיו גם על ידי EO-1 Flight וגם על ידי EO-1 Lite. | יש להחזיר את המספרים הסידוריים של CFG-2 ל-3-. |
| אימות חסר לתצורה אחת | ProductLine.6 מזהיר על TC-10: הוא לעולם אינו באותה תצורה עם 5.1 S-band Downlink Rate, שחלה רק על F-2. עם הצגה כ ▾ ← CFG-2 EO-1 Lite, ה-RVTM מציג את 5.1 בלי מקרה בדיקה; עם CFG-1 הוא אינו מפרט את 5.1 בכלל. | יש להגדיר את Applies To של TC-10 ל-F-2: הוא בודק את רדיו ה-S-band, ולכן הוא שייך למוצרים שיש להם כזה. גם ניקוי הערך, כפי שההדגמה מגיעה, עובד. |
| כללי תכונות סותרים | שום דבר אינו הופך לאדום: אף תצורה אינה בוחרת ב-Propulsion, ולכן אף הכרעה אינה משתנה, ו-ProductLine.4 כבר הזהיר שאף תצורה אינה בוחרת בה. כדי לבדוק את הכללים, יש ללחוץ על + תצורה חדשה, לבחור Propulsion עם X-band (“מפרה: Propulsion שוללת X-band Downlink.”), ואז עם S-band (“מפרה: Propulsion דורשת X-band Downlink.”). אף מוצר תקין אינו יכול לכלול Propulsion. | יש להסיר את X-band מ-לא כולל של Propulsion, ואז למחוק את תצורת הבדיקה. |
מה הבדיקות אינן תופסות
- הכללים נבדקים דרך תצורות. Holarch בודק כל תצורה מול כללי התכונות; הוא אינו מנתח את הכללים בפני עצמם, כך שסתירה נשארת שקטה עד שתצורה בוחרת בתכונה. תצורת טיוטה קצרת חיים היא הדרך לבדוק כלל חדש.
- חפיפת תחולה נבדקת לפי מספר סידורי. ProductLine.7 משווה את המספרים הסידוריים של תצורות. שתי תצורות שתאריכי הבנייה שלהן חופפים אינן מדווחות.
- תצורה משוחררת אינה מוקפאת מפני שינויי כללים. כשבקרת התצורה פעילה, תצורה שמצבה שוחרר והיא בקו הבסיס האחרון משנה את הבחירה והערכים שלה רק דרך בקשת שינוי. כללי התכונות שמולם היא נבדקת הם פריטים נפרדים, ולכן יש להריץ בדיקת תצורות בכל פעם ששינוי נוגע בתכונות.
- פערי אימות לכל מוצר מופיעים ב-RVTM. ProductLine.6 מוצא בדיקה שנקשרה כך שהיא לעולם אינה פוגשת את הדרישה שלה. דרישה שאין לה מקרה בדיקה במוצר אחד מסיבה אחרת מופיעה ב-RVTM של התצוגה של אותו מוצר, ולכן יש לקרוא אותו לכל תצורה לפני סקירה.
לפני הסיום, יש להריץ את הבדיקות פעם נוספת: ההכרעות צריכות להראות שוב תקינה, וכללי קו המוצרים צריכים לדווח רק על אזהרת ProductLine.4 עבור Propulsion שיש בהדגמה במכוון.
לאן ממשיכים
- קו המוצרים של EO-1 בתיעוד: אותה דוגמה כסיור צעד אחר צעד באפליקציה.
- דוגמה לניתוח חלופות: ההחלטה בין S-band ל-X-band שקו מוצרים אחד עונה עליה פעמיים.
- מטריצת אימות דרישות: שיטות, תוצאות וסיכום מצבים, הבסיס לאימות לכל תצורה.
- ניתוח השפעת שינוי: מעקב אחרי שינוי לאורך המודל, שבקו מוצרים כולל גם את השאלה לאילו מוצרים הוא מגיע.
- SysML v2 Variants and Configurations: נקודות שונות, variants ותצורות בסימון הטקסטואלי.