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.