Главы курса
Обучение · Курс 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.
- Откройте свой демо-проект EO-1 (или создайте его: Управление проектами → Файлы проекта ▾ → Новый демо-проект → CubeSat (пошаговая системная инженерия)).
- Откройте EO-1 System Requirements Specification, нажмите Версия ▾ в штампе и выберите Сохранить базовую линию…. Назовите её
PDR Baseline, заполните одну строку утверждающего своим именем и ролью и нажмите Создать. - Измените в описании 3.3 Depth of Discharge 30% на 25% и прочитайте всплывающее сообщение: требование снова «На рецензировании», а его связи требуют проверки.
- Откройте Потребности и требования → Ссылки для проверки. В строке для 3.3 нажмите Сравнение, затем Отметить как проверенное…, напишите, что вы проверили, и нажмите Отметить как проверенное.
- В документе выберите Версия ▾ → Сравнить версии… с Откуда PDR Baseline и Куда Текущая версия и нажмите Изменения (Excel).
- Откройте Управление и рецензирование → Базовые линии и версии и найдите PDR Baseline рядом с SRR Baseline. Чтобы зафиксировать всю модель, а не один документ, используйте + Сохранить базовую линию… в заголовке этой страницы.
Готово, когда отчёт об изменениях от PDR Baseline показывает правку 3.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.