Holarch
פרקי הקורס

הדרכה · מסלול 2. דרישות ואימות · פרק 2.4 מתוך 6

2.4 קווי בסיס וקישורים לבדיקה 2:40

מקפיאים את המפרט בקו בסיס, משנים דרישה ובודקים במה השינוי נוגע.

מציג את Holarch 2.13.

מה תלמדו

  • לשמור קו בסיס של מסמך עם רשומת אישור
  • להסביר מה שינוי בדרישה מאושרת עושה לסטטוס שלה ולקישורים שלה
  • לבדוק קישור מסומן עם “השוואה” ולסמן אותו כנבדק עם הערה
  • להשוות קו בסיס לגרסה הנוכחית ולייצא את השינויים

מקפיאים את המפרט של 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, לוחצים על גרסה ▾ בגוש הכותרת ובוחרים שמירת קו בסיס…. נותנים לו את השם PDR Baseline, ממלאים שורת מאשר אחת עם השם והתפקיד שלכם ולוחצים על יצירה.
  3. משנים את 3.3 Depth of Discharge מ-30% ל-25% בתיאור שלה, וקוראים את ההודעה: הדרישה חזרה ל-In Review והקישורים שלה דורשים בדיקה.
  4. פותחים את צרכים ודרישות ← קישורים לבדיקה. בשורה של 3.3 לוחצים על השוואה, ואז על סימון כנבדק…, כותבים מה בדקתם ולוחצים על סימון כנבדק.
  5. במסמך בוחרים גרסה ▾ ← השוואת גרסאות… עם מ- PDR Baseline ו-אל הגרסה הנוכחית, ולוחצים על שינויים (Excel).
  6. פותחים את בקרה וסקירות ← קווי בסיס וגרסאות ומוצאים את PDR Baseline לצד SRR Baseline. כדי להקפיא את המודל כולו ולא מסמך אחד, משתמשים ב-+ שמירת קו בסיס… בכותרת הדף הזה.

סיימתם כשדוח השינויים מ-PDR Baseline מציג את העריכה של 3.3 והקישור שבדקתם כבר לא מופיע ב“קישורים לבדיקה”.

בדיקה עצמית

  1. למה שינוי בדרישה מסמן את הקישורים שתלויים בה, ולא רק את הדרישה עצמה?
  2. מה ההבדל בין קו בסיס של מסמך לקו בסיס של פרויקט?
  3. כשמסמנים קישור כנבדק, למה לכתוב הערה?
הצגת התשובות
  1. למה שינוי בדרישה מסמן את הקישורים שתלויים בה, ולא רק את הדרישה עצמה?

    הפריטים בקצה השני, כמו הפונקציה שמקיימת אותה או הבדיקה שמאמתת אותה, נבדקו מול הטקסט הישן. צריך לבדוק שוב כל קישור כדי לראות אם הוא עדיין תקף.

  2. מה ההבדל בין קו בסיס של מסמך לקו בסיס של פרויקט?

    קו בסיס של מסמך מקפיא מסמך אחד ואת האישורים שלו (גרסה ▾ ← שמירת קו בסיס…). קו בסיס של פרויקט מקפיא כל פריט וכל קשר (קווי בסיס וגרסאות ← + שמירת קו בסיס…).

  3. כשמסמנים קישור כנבדק, למה לכתוב הערה?

    ההערה מתעדת מה נבדק ולמה הקישור עדיין תקף. היא נוספת להערות של הפריט המקושר, כך שסוקר יכול לעקוב אחרי ההחלטה מאוחר יותר.

קריאה נוספת

תמליל

הצגת התמליל (הקריינות ומה שמוצג על המסך)

Introduction

Chapter four: baselines and links to review. Once a specification is agreed, changes need control: everyone should know what changed, and what the change might break.

We baseline the Bike-Share Dock specification, then change one of its requirements.

Change control

A baseline is a read-only snapshot of a document, with its approvals. After it, every change is visible, and a change to a requirement marks the links that depend on it for review, until someone checks them.

On screen: Card: baselines and links to review.

First, give Show Available Bikes a link to depend on. In the Database, select it, and in its Trace section link it with satisfied by to the rental kiosk, which shows the numbers.

On screen: 4.1.1 → Trace → satisfied by + → Link existing… → Rental Kiosk.

Baseline

Open the specification, and the version menu in its title block. Choose Save Baseline, name it SRR Baseline for the requirements review, add your role, and click Create.

On screen: SRS → Current version ▾ → Save Baseline… → SRR Baseline → Create.

A change

Now a change. The team wants the kiosk to show the charge level of each e-bike too. Select Show Available Bikes, and update its statement in the inspector.

On screen: 4.1.1 → Item → new description.

The message says what happened, in the same undo step as the edit: the approved requirement went back to In Review, and its link to the rental kiosk now needs review.

On screen: The toast and the status.

Links to review

Open Needs and Requirements, then Links to Review. Each row is a link to check. Diff shows exactly how the text changed.

On screen: Links to Review → Diff.

The rental kiosk can show charge levels too, so the link still holds. Click Mark Reviewed, write what you checked, and click Mark Reviewed. The link no longer needs review.

On screen: Mark Reviewed… → note → Mark Reviewed.

Changes since the baseline

To see everything that changed since the review, open the specification's version menu again, and choose Compare Versions: from SRR Baseline to the current version.

On screen: SRS → version ▾ → Compare Versions… → SRR Baseline → Current.

The report lists each addition, removal and edit, ready to export to Excel or as a Word redline for a change board.

On screen: The change report.

Recap

Let's recap. You baselined the specification with an approval, changed an approved requirement, saw it return to review with its link flagged, marked the link reviewed with a note, and listed the changes since the baseline.

Next, you plan and run the tests that verify the requirements.