Holarch
Главы курса

Обучение · Курс 2. Требования и верификация · Глава 2.1 из 6

2.1 Написание требований и проверка качества 3:37

Пишите требования с их атрибутами и позвольте проверке качества найти слабые формулировки.

Показан Holarch 1.27.

Все главы · 2.2 Прослеживание потребностей к требованиям →

Чему вы научитесь

  • Записывать требование как одно проверяемое утверждение со shall и измеримым значением
  • Добавлять требование в раздел спецификации
  • Задавать приоритет требования, метод верификации, обоснование и метку типа
  • Запускать проверку качества документа и исправлять отмеченное ею требование
  • Отмечать Correct и Feasible после собственной проверки требования

Напишите требования в спецификации станции 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. Выберите раздел 5 Communications, нажмите + Дочерний, назовите требование Command Link Margin и напишите формулировку с shall и значением (например, запас не менее 6 dB при угле места 5 градусов).
  3. В инспекторе задайте Приоритет значение High, Verification Method — Analysis и укажите Обоснование, затем нажмите + Метка и выберите Performance Requirement.
  4. Откройте Потребности и требования → Качество, выберите Документ: EO-1 System Requirements Specification на панели области и нажмите Проверить качество. Прочитайте Предложения для 2.5 Safe Mode Recovery.
  5. Перепишите 2.5 как одну измеримую формулировку (что запускает восстановление, как быстро и в какой режим) и снова нажмите Проверить качество.
  6. Проверьте свою новую формулировку, затем щёлкните ✘ под Correct и Feasible в её строке, чтобы отметить «Да».

Готово, когда оценка 2.5 Safe Mode Recovery выше прежней, её предложения больше не называют расплывчатых слов, а Correct и Feasible показывают ✔.

Проверьте себя

  1. Почему требование, соединённое союзом and, получает более низкую оценку, даже если обе половины хороши?
  2. Почему автоматическая проверка никогда не может отметить Correct и Feasible?
  3. Чем слово вроде quickly проблематично в требовании?
Показать ответы
  1. Почему требование, соединённое союзом and, получает более низкую оценку, даже если обе половины хороши?

    Оно содержит два требования в одном. Их нельзя верифицировать, прослеживать или изменять по отдельности, поэтому проверка отмечает его как не единичное.

  2. Почему автоматическая проверка никогда не может отметить Correct и Feasible?

    Отражает ли требование правильную потребность и можно ли его реализовать — это вопрос инженерного суждения. Человек рецензирует требование и отмечает эти два критерия.

  3. Чем слово вроде 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.