Розділи курсів
Навчання · Курс 2. Вимоги та верифікація · Розділ 2.1 з 6
2.1 Написання вимог і перевірка якості 3:37
Пишіть вимоги з їхніми атрибутами, і нехай перевірка якості знаходить слабкі формулювання.
Показано Holarch 1.27.
Що ви дізнаєтеся
- Написати вимогу як одне перевірюване формулювання з shall і вимірюваним значенням
- Додати вимогу під розділом специфікації
- Встановити пріоритет, метод верифікації, обґрунтування й мітку типу вимоги
- Запустити перевірку якості документа й виправити позначену нею вимогу
- Позначити Correct і Feasible після власного рецензування вимоги
Пишіть вимоги в специфікації Bike-Share Dock: що робить вимогу доброю, додавання вимог під розділами, заповнення пріоритету, методу верифікації й обґрунтування, призначення міток, запуск перевірки якості вимог, виправлення слабкої вимоги й запис судження рецензента.
Файли проєкту
- Початковий проєкт (.holarch.json; Керування проєктами → Файли проєкту ▾ → Імпортувати проєкт (.json)…)
- Готовий проєкт (.holarch.json; Керування проєктами → Файли проєкту ▾ → Імпортувати проєкт (.json)…)
Відео відтворюється з holarch.app; див. Політику конфіденційності.
Практика
Виконайте це самостійно в Holarch на демопроєкті CubeSat EO-1.
- Відкрийте свій демопроєкт EO-1 (або створіть його: Керування проєктами → Файли проєкту ▾ → Новий демопроєкт → CubeSat (системна інженерія з посібником)).
- Відкрийте Потреби та вимоги → Документи → EO-1 System Requirements Specification. Виберіть розділ 5 Communications, натисніть + Дочірній, назвіть вимогу
Command Link Marginі напишіть формулювання з shall і значенням (наприклад, запас щонайменше 6 dB при куті місця 5 градусів). - В інспекторі встановіть Пріоритет High, Метод верифікації Analysis і Обґрунтування, потім натисніть + Мітка й оберіть Performance Requirement.
- Відкрийте Потреби та вимоги → Якість, оберіть Документ: EO-1 System Requirements Specification на панелі області й натисніть Перевірити якість. Прочитайте Пропозиції для 2.5 Safe Mode Recovery.
- Перепишіть 2.5 як одне вимірюване формулювання (що запускає відновлення, як швидко і в який режим) і знову натисніть Перевірити якість.
- Перегляньте переписаний текст, потім натисніть ✘ під Correct і Feasible у його рядку, щоб позначити їх Yes.
Завдання виконано, коли 2.5 Safe Mode Recovery отримує вищу оцінку, ніж раніше, її пропозиції більше не називають нечітких слів, а Correct і Feasible показують ✔.
Перевірте себе
- Чому вимога, з’єднана через and, отримує нижчу оцінку, навіть коли обидві половини добрі?
- Чому автоматична перевірка ніколи не може позначити Correct і Feasible?
- Чим слово на кшталт quickly погане у вимозі?
Показати відповіді
Чому вимога, з’єднана через and, отримує нижчу оцінку, навіть коли обидві половини добрі?
Вона містить дві вимоги в одній. Їх не можна верифікувати, простежувати чи змінювати окремо, тому перевірка позначає її як не одиничну.
Чому автоматична перевірка ніколи не може позначити Correct і Feasible?
Чи формулює вимога правильну потребу і чи її можна реалізувати — це питання інженерного судження. Людина рецензує вимогу й позначає ці два критерії.
Чим слово на кшталт quickly погане у вимозі?
Його не можна виміряти, тож жоден тест не покаже, що вимогу виконано. Замініть його значенням з одиницею.
Докладніше
Стенограма
Показати стенограму (озвучення і те, що на екрані)
Introduction
Welcome to Requirements and Verification. This track follows requirements from the first draft to the proof that the system meets them, on the Bike-Share Dock from Getting Started.
This first chapter is about writing requirements well, and letting Holarch check them.
A good requirement
A good requirement states one thing the system shall do, in words that can only mean one thing, with a value someone can test. Vague words such as fast or user friendly cannot be tested, and two requirements joined by and cannot be checked separately.
On screen: Card: a good requirement.
Write requirements
Open the specification. Select section 5.1, Timing and Throughput, open the menu next to After, and choose Add Child. Name the requirement Pay at the Kiosk, and write its statement in the inspector.
On screen: SRS → 5.1 → Add Child → Pay at the Kiosk.
Add two more the same way: an environmental requirement under 7.1, and a usability requirement under 8.3. The usability one is written the way requirements often are on a first try.
On screen: 7.1 → Operate in Cold and Heat; 8.3 → Friendly Kiosk.
Attributes and labels
Each requirement also has attributes for planning. Select Pay at the Kiosk, and set its priority to High, its verification method to Test, and its rationale: why the value was chosen.
On screen: 5.1.1 → Priority, Verification Method, Rationale.
Give it a label too: click Label in the inspector, and choose Performance Requirement. Labels let you filter and report by kind.
On screen: + Label → Performance Requirement.
Quality check
Now check the wording. Open Needs and Requirements, then Quality, choose the specification, and click Check Quality. Each requirement is scored against nine qualities of a good requirement, with a tick or a cross for each.
On screen: Quality → Document: the SRS → Check Quality.
Friendly Kiosk scores low. The findings name the problems: user friendly and quick cannot be measured, and the and joins two requirements in one.
On screen: Findings for Friendly Kiosk.
Fix it. Go back to the document, select the requirement, and rewrite it as one measurable statement.
On screen: Back to the SRS → 8.3.1 → new description.
Check the quality again. The score rises. Two qualities, correct and feasible, always need a person: when you have reviewed a requirement, click their crosses to mark them yes.
On screen: Quality → Check Quality again → mark Correct and Feasible.
Recap
Let's recap. You learned what makes a requirement good, added requirements under sections, filled in their attributes and labels, ran the quality check, fixed a weak requirement, and recorded your own judgment.
Next, you trace the stakeholder needs to these requirements.