Руководство · Требования
Как писать хорошие системные требования: примеры и контрольный список
Прослушать это руководство 26 мин
Хорошее требование говорит об одном, что система должна делать или чем быть, словами, которые два инженера прочитают одинаково, со значением, которое можно проверить тестом или анализом. Это руководство описывает различие потребностей и требований, части формулировки требования, характеристики качества из ISO/IEC/IEEE 29148 и INCOSE Guide to Writing Requirements, контрольный список с примерами «до и после», методы верификации и критерии приёмки, значения TBD и TBR и типы требований — всё на одной спецификации CubeSat.
На этой странице
- Почему формулировка требования важна
- Потребности заинтересованных сторон и требования
- Анатомия требования
- Характеристики качества хорошего требования
- Контрольный список: правила с примерами «до и после»
- Записывайте метод верификации и критерии приёмки вместе с требованием
- Работа со значениями TBD и TBR
- Типы требований
- Разобранный пример: рецензирование спецификации EO-1
- Типичные ошибки
- Попробуйте в Holarch
- Скачать контрольный список
- Вопросы о написании требований
- Что дальше
Почему формулировка требования важна
Требование — это договор между теми, кто заказывает систему, и теми, кто её строит. Его читают все последующие участники: проектировщик рассчитывает по нему компонент, инженер по испытаниям пишет по нему критерий прохождения, совет по изменениям оценивает по нему изменение, а заказчик по нему принимает систему. Каждый читает одно и то же предложение, обычно без автора рядом. Если предложение можно прочитать двояко, его так и прочитают, и разница всплывёт поздно: на тесте, который «пройден» по критерию, о котором никто не договаривался, или при приёмке, когда заказчик имел в виду другое.
Плохая формулировка ломает и остальную модель. Требование без значения нельзя распределить на компонент, потому что никто не может сказать, выполняет ли его компонент. Его нельзя верифицировать, поэтому оно появляется как пробел покрытия в прослеживаемости и матрице верификации. А когда оно меняется, никто не может сказать, остаётся ли в силе связанная конструкция. Хорошее написание требований — самая дешёвая работа по качеству в проекте: час над предложением в начале экономит испытательную кампанию в конце.
В руководстве используется один сквозной пример — EO-1, вымышленный CubeSat 6U, снимающий сельхозугодья в четырёх спектральных каналах. Его спецификация, SRS-001 EO-1 System Requirements Specification, содержит 32 требования, большинство из них корректны, а три намеренно слабые. Это та же модель, что и в сквозном примере проекта MBSE. Приведённые здесь потребности заинтересованных сторон N1–N3 — те, которые добавляет в модель руководство по прослеживаемости.
Потребности заинтересованных сторон и требования
Написание требований начинается на шаг раньше — с потребностей. Потребность заинтересованной стороны — это то, чего пользователь, оператор, заказчик или регулятор ожидает, в его собственных терминах. Требование — инженерная формулировка, по которой система проектируется и верифицируется. ISO/IEC/IEEE 15288 разделяет их в отдельные технические процессы: определение потребностей и требований заинтересованных сторон (6.4.2) и определение системных требований (6.4.3). INCOSE Needs and Requirements Manual проводит то же разделение и рассматривает потребности как самостоятельные элементы, а не как черновики требований.
| Пример EO-1 | Чем проверяется | |
|---|---|---|
| Потребность (N2 Twice-Weekly Revisit) | Farm customers need fresh imagery of their fields at least twice a week in the growing season. | Валидация: получают ли заказчики от поставленной системы то, что им нужно? |
| Требование (1.6 Revisit Time) | The mission shall revisit each target region within 72 hours. | Верификация: отвечает ли система формулировке по результатам теста, анализа, осмотра или демонстрации? |
Разница видна в том, как проверяется каждое. Требование верифицируется: система измеряется по формулировке. Потребность валидируется: кто-то подтверждает, что система при предполагаемом использовании делает то, чего хотела заинтересованная сторона. Система может пройти всю верификацию и всё равно не пройти валидацию, если требования упустили суть; этот разрыв описывает руководство по верификации и валидации. Для написания практическое следствие простое: сначала запишите потребность, затем напишите требования, выполнение которых её удовлетворит, и свяжите каждое требование с потребностью, на которую оно отвечает.
Перевод редко бывает один к одному. N2 становится 1.6 Revisit Time, которое затем декомпозируется на 1.6.1 Ground Track Repeat (3 дня) и 1.6.2 Off-Nadir Imaging (25 градусов). Некоторые требования не отвечают ни на одну потребность напрямую: 3.1 Orbit Average Power выведено из 1.5 Daily Collection Volume, потому что нагрузка съёмки задаёт мощность, которую должны давать панели. Ни один заказчик не просил 30 Вт, но съёмка, которую они просили, без этого невозможна.
Анатомия требования
Требование — больше, чем его предложение. Предложение несёт обязательство; набор атрибутов вокруг него несёт причины, план доказательства и учёт. Обе половины — часть его написания.
Формулировка
Большинство хороших формулировок требований укладываются в один шаблон. ISO/IEC/IEEE 29148 (5.2.4) описывает его как субъект, действие, объект и ограничения на действие с необязательным условием впереди; INCOSE Guide to Writing Requirements рекомендует тот же порядок и согласованные шаблоны для каждого вида требований.
| Часть | Что она говорит | EO-1 4.3 Fault Detection |
|---|---|---|
| Условие (необязательно) | Когда, в каком режиме или состоянии действует требование | «…of undervoltage detection» (инициирующее событие) |
| Субъект | Система или элемент, который должен соответствовать, названный точно | «The C&DH» |
| Модальный глагол | Сила обязательства | «shall» |
| Действие | Что субъект делает или чем является, активным глаголом | «enter» |
| Объект | К чему применяется действие | «safe mode» |
| Характеристика или ограничение | Измеримое значение с единицей и направлением предела | «within 10 seconds» |
Вместе: «The C&DH shall enter safe mode within 10 seconds of undervoltage detection». Порядок может меняться («When undervoltage is detected, the C&DH shall…» ставит условие первым, как в шаблонах EARS, которыми пользуются многие команды), но каждая часть должна присутствовать или отсутствовать намеренно.
Основной вес несут три слова. Shall обозначает обязательное требование; will констатирует факт или намерение относительно чего-то вне системы; should формулирует цель, которая не верифицируется. Какое бы соглашение ни принял проект, определите его один раз в спецификации и придерживайтесь его. EO-1 1.1 Reference Orbit («The mission assumes a 500 km sun-synchronous orbit…») правильно записано как допущение, а не требование: это контекст для зависящих от него требований, и модель хранит его как утверждение, которое не оценивается и не верифицируется.
Атрибуты
Вот 3.1 Orbit Average Power в том виде, как его записывает модель EO-1, после изменения с 28 Вт на 30 Вт после PDR:
| Атрибут | 3.1 Orbit Average Power | Зачем он нужен |
|---|---|---|
| Идентификатор и название | 3.1 Orbit Average Power | Устойчивая ссылка для связей, рецензирования и запросов на изменение |
| Формулировка | The solar arrays shall generate at least 30 W orbit-average power at end of life. | Само обязательство |
| Обоснование | Orbit-average load grew to 26 W after PDR; 30 W keeps 15% margin. | Позволяет последующему читателю оценить изменение без автора |
| Источник и родитель | Derived (systems analysis); выведено из 1.5 Daily Collection Volume | Обратная прослеживаемость: зачем существует требование |
| Метод и уровень верификации | Test, на уровне подсистемы | План доказательства, определённый при написании |
| Критерии успеха | End-of-life orbit-average power predicted from measured peak power. | Какой результат считается выполнением |
| Владелец, приоритет, критичность | Power Engineer; High; High | Кто за него отвечает и насколько оно важно |
| Статус | На рецензировании (было утверждено; текст изменился после утверждения) | На каком этапе процесса согласования оно находится |
| TBD/TBR | Нет | Открыто ли ещё значение |
ISO/IEC/IEEE 29148 (5.2.8) перечисляет атрибуты такого рода, а руководство INCOSE добавляет ещё; проект выбирает те, которые действительно будет поддерживать. Обоснование пропускают чаще всего, и чаще всего его потом не хватает. Без «нагрузка 26 Вт, запас 15%» следующий, кто увидит 3.1, не сможет сказать, является ли 30 Вт жёстким физическим пределом, числом заказчика или выбором запаса, и поэтому не поймёт, что для него значит изменение нагрузки.
Характеристики качества хорошего требования
Правила стиля проще применять, когда понимаешь, что они защищают. ISO/IEC/IEEE 29148 (5.2.5) называет девять характеристик отдельного требования, а INCOSE Guide to Writing Requirements использует те же девять как C1–C9, каждую с кратким определением и поддерживающими её правилами. Таблица формулирует каждую как вопрос, который может задать рецензент.
| Характеристика | Вопрос | Пример EO-1 |
|---|---|---|
| Necessary | Если его удалить, потеряется ли что-то нужное заинтересованным сторонам? Не дублирует ли оно другое? | 3.1 необходимо: без него ничто не задаёт размер панелей под нагрузку съёмки. |
| Appropriate | Написано ли оно на нужном уровне, не фиксируя проектное решение, которое должен принять уровень ниже? | 3.1 задаёт уровень мощности панелей, а не тип элементов или число панелей. |
| Unambiguous | Можно ли прочитать его только одним способом? | 6.4 «user friendly» не проходит: два рецензента не согласятся, выполнено ли оно. |
| Complete | Говорит ли оно всё необходимое, без пропущенного условия или значения? | 3.5 «warm enough (TBD)» не проходит: значение отсутствует. |
| Singular | Формулирует ли оно одно обязательство? | 2.5 не проходит: оно требует восстановиться и возобновить съёмку, соединяя это через «and». |
| Feasible | Можно ли его выполнить в известных ограничениях технологий, стоимости и графика? | 3.1 при 30 Вт под вопросом: спроектированные панели дают около 28 Вт в среднем по орбите. |
| Verifiable | Может ли тест, анализ, осмотр или демонстрация показать, что оно выполнено? | 2.5 «quickly» не проходит; «within 6 hours» проходит. |
| Correct | Выражает ли оно реальную потребность своего источника с правильным значением? | 1.2 — разрешение на местности 4,5 м — правильно выражает N3 (карты на уровне полей) с запасом. |
| Conforming | Следует ли оно согласованным шаблонам и словарю проекта? | Каждое требование EO-1 использует «shall», названный субъект и единицы СИ. |
У набора требований есть собственные характеристики, которые не может показать ни одна отдельная формулировка. ISO/IEC/IEEE 29148 (5.2.6) называет набор полным, непротиворечивым, выполнимым в целом, понятным и пригодным для валидации; руководство INCOSE добавляет корректный как C15 и нумерует характеристики набора как C10–C15.
- Полный: набор покрывает потребности. EO-1 указывает, что происходит при пониженном напряжении (4.3), но его единственное требование к выходу из безопасного режима — 2.5, которое в нынешней формулировке нельзя верифицировать, так что восстановление фактически не специфицировано.
- Непротиворечивый: никакие два требования не конфликтуют, а термины и единицы используются одинаково. 1.5 требует 3,2 ГБ данных снимков в день, а 5.4 — 3 ГБ, принятых на Земле; они согласуются только потому, что обоснование 5.4 говорит «after compression». Без обоснования они выглядят как конфликт.
- Выполнимый: требования можно выполнить вместе. Каждое требование к энергетике может быть выполнимым по отдельности, а 30 Вт в среднем по орбите, площадь панелей и бюджет массы вместе — нет.
- Понятный: читатель может понять, чего ожидают от системы и как связаны требования, а это зависит от структуры, нумерации и прослеживаемости не меньше, чем от формулировок.
- Пригодный для валидации: можно показать, что набор ведёт к системе, удовлетворяющей потребностям, поэтому каждое требование верхнего уровня связано с потребностью.
Контрольный список: правила с примерами «до и после»
Характеристики становятся применимыми через конкретные правила написания. INCOSE Guide to Writing Requirements нумерует их (R1, R2 и так далее); NASA Systems Engineering Handbook (приложение C) содержит более короткий контрольный список в том же духе. Таблица собирает правила, которые на практике ловят большинство проблем, с примером из спецификации EO-1 для каждого. «До» — текст в том виде, как он есть в демо; «После» — переформулировка. Значения, помеченные как условные, показывают форму, а не результаты анализов EO-1.
| Правило | Вопрос | До (EO-1) | После |
|---|---|---|---|
| Одно обязательство на формулировку | Ровно одно «shall», нет «and», «or», «and/or», соединяющих два требования? | 2.5: «The spacecraft should recover from safe mode quickly and resume imaging as appropriate» | «The spacecraft shall resume imaging within 6 hours of a safe mode entry». Другие важные шаги восстановления получают собственные требования. |
| Обязательная формулировка | «Shall» для обязательного требования, а не «should», «will» или «may»? | 2.5: «should recover» | «shall resume» |
| Измеримое значение с единицей | Есть ли у каждого слова о характеристике число и единица? | 2.5: «quickly» | «within 6 hours of a safe mode entry» |
| Указано направление предела | Ясно ли, является ли значение минимумом или максимумом? | 1.6.2: «image targets up to 25 degrees off nadir» | «image targets at off-nadir angles from 0 to 25 degrees» (диапазон возможностей, а не ограничение наведения) |
| Без лазеек | Оставлено ли что-то на усмотрение поставщика («as appropriate», «if possible», «where practical»)? | 2.5: «as appropriate» | Удалено; указано важное условие |
| Без расплывчатых или субъективных терминов | Могут ли два рецензента разойтись во мнении, выполнено ли оно («user friendly», «easy», «adequate», «enough»)? | 6.4: «The operator interface shall be user friendly and/or easy to use». | «The operator interface shall let a trained operator book a ground station contact in no more than 5 minutes». (условно; по одному требованию на каждую важную задачу) |
| Явные существительные, без местоимений | Есть ли у каждого «it», «its» или «this» ровно один возможный референт? | 1.6.1: «The reference orbit shall repeat its ground track every 3 days». | «The reference orbit shall repeat the ground track every 3 days». Здесь местоимение безвредно, но в более длинном предложении именно оно первым начинает двоиться. |
| Указаны условия | Сказано ли, когда действует значение: этап жизненного цикла, режим, среда? | «The solar arrays shall generate 30 W». | «…at least 30 W orbit-average power at end of life». |
| Установленные значения или отслеживаемые TBD | Отслеживается ли каждое открытое значение с ответственным и сроком, а не просто вписано в текст? | 3.5: «The thermal design shall keep the battery warm enough (TBD)». | «The thermal design shall keep the battery cell temperature at or above 0 °C while charging». (условно; пока тепловой анализ не установит значение, атрибут TBD называет Thermal Engineer и срок) |
| Без причин и примечаний в формулировке | Перенесены ли фразы о цели («so that», «in order to») и примечания в скобках в обоснование? | 3.5: «(TBD)» | Формулировка без скобок; причина — в поле «Обоснование» |
| Что, а не как | Формулирует ли оно потребность, а не навязывает решение, которое должен выбрать уровень ниже? | «The thermal design shall keep the battery warm by means of a 2 W film heater». (условно) | Переформулировка 3.5 выше: предел температуры, а нагреватель оставлен на усмотрение теплового проектирования |
| Позитивно и достижимо | Избегает ли оно «not», «never», «always», «100%» там, где подразумевается измеримый предел? | «The C&DH shall never lose a stored command». (условно) | «The C&DH shall execute each stored command within 1 second of the scheduled time». (4.2 в нынешней формулировке) |
| Записано обоснование | Сказано ли, почему выбрано это значение? | 3.1 без обоснования | Обоснование: «Orbit-average load grew to 26 W after PDR; 30 W keeps 15% margin». |
| Метод верификации и критерии | Выбран ли метод и выведен ли критерий прохождения из формулировки? | 3.1: метод Test; TC-06 ожидает пиковую мощность ≥ 72 Вт | Критерий прохождения выведен через бюджет мощности: около 80,6 Вт пиковой для 30 Вт в среднем по орбите (см. следующий раздел) |
| Прослеживается вверх | Связано ли с потребностью, родителем или исходным требованием? | 3.1 без восходящей связи | 3.1 выведено из 1.5 Daily Collection Volume |
| Уникальность | Не говорит ли другое требование то же самое другими словами? | Второе «The battery shall store 77 Wh» в тепловом разделе (условно) | Одно требование, 3.2 Battery Capacity, со ссылками на него там, где нужно |
Контрольный список — инструмент рецензента, а не шаблон для написания. Прочитайте каждое требование один раз по всему списку, а не выискивайте по одному правилу за раз, и записывайте замечание вместе с нарушенным правилом, чтобы автор знал, что менять. У правил бывают и ложные срабатывания. Проверка по списку слов помечает «every» в 1.6.1 как квантор всеобщности, но «every 3 days» — это период, а не утверждение обо всех случаях; решает рецензент.
Записывайте метод верификации и критерии приёмки вместе с требованием
Проверяемость легче всего проверить в момент написания требования: если автор не может сказать, как будет показано его выполнение, требование не закончено. Записывайте с каждым требованием две вещи.
- Метод верификации: тест, анализ, осмотр или демонстрация, а также уровень сборки, на котором он выполняется (компонент, подсистема, система). В EO-1 есть все четыре: 3.1 верифицируется тестом, 1.5 Daily Collection Volume — анализом, 3.4 Bus Regulation — осмотром, а 6.1 Contact Scheduling — демонстрацией. Руководство по RVTM объясняет, как выбирать между ними.
- Критерии успеха (критерии приёмки): наблюдаемый результат, который считается выполнением, сформулированный так, чтобы по нему можно было написать тест или анализ. Для 3.2 Battery Capacity: «Measured capacity of at least 77 Wh at C/2 and 20 °C». Для 6.2 Image Delivery: «Products on the portal within 6 h for 95% of passes in rehearsal».
Запись критериев рядом с формулировкой выявляет класс ошибок, которые иначе находят только в конце. 3.1 в EO-1 верифицируется тестом TC-06 Solar Array Power Test, который измеряет пиковую мощность на имитаторе Солнца и проходит при 72 Вт и более. Однако требование касается среднеорбитальной мощности, и модель переводит одну в другую через долю освещённой части орбиты (0,62) и КПД тракта мощности (0,6). Пиковые 72 Вт дают 72 × 0,62 × 0,6 = 26,8 Вт в среднем по орбите, что ниже исходных 28 Вт, не говоря уже о нынешних 30 Вт. Порог теста не был выведен из требования. TC-06 намерил 75,1 Вт и «прошёл», но 75,1 Вт соответствуют 27,9 Вт — меньше обоих значений. Если бы критерий был написан по формулировке, он гласил бы около 30 / (0,62 × 0,6) = 80,6 Вт пиковой мощности, и нехватка была бы видна на первом же тесте. Руководство по анализу влияния изменений прослеживает то же замечание через изменение с 28 Вт на 30 Вт.
Урок обобщается: критерий прохождения должен прослеживаться к значению требования через арифметику, которую кто-то может проверить, и эта арифметика должна быть в обосновании или плане верификации, а не в памяти инженера.
Работа со значениями TBD и TBR
В начале проекта некоторые значения ещё неизвестны. Если не записать требование, пробел скрыт; если выдумать число, скрыта неопределённость. Обычная практика — записать требование с заполнителем и отслеживать заполнитель как открытый вопрос.
- TBD (to be determined, подлежит определению): значения пока нет. «The thermal design shall keep the battery cell temperature at or above TBD °C while charging».
- TBR (to be reviewed, иногда «to be resolved», подлежит уточнению): лучшее текущее значение, которое не подтверждено. «…within 60 seconds», где 60 помечено как TBR.
Предпочитайте TBR с оценкой голому TBD везде, где есть хоть какая-то основа для числа: проектировщики могут работать по оценке, а значение, которое позже изменится, — это изменение, за которым последует прослеживаемость. Каждому открытому вопросу нужны три вещи, иначе им никто не управляет:
- Ответственный — человек, который его закроет.
- Срок или веха, обычно до проектных решений, которые от него зависят.
- План закрытия: анализ, тест или решение, которые установят значение.
В спецификации EO-1 три открытых вопроса. 3.5 Battery Thermal Control — TBD, за который отвечает Thermal Engineer, и срок уже прошёл. 2.4 Target Slew («through 30 degrees within 60 seconds») — TBR, за который отвечает ADCS Lead, а 5.3 Downlink Link Margin («at least 3 dB link margin at 10 degrees elevation») — TBR, за который отвечает Comms Lead; оба несут рабочие значения, которые используют конструкции, пока анализы не завершены.
Считайте открытые вопросы на каждой вехе и ожидайте, что их число будет уменьшаться. Базовая линия требований с множеством открытых TBD — базовая линия лишь по названию. Критерии рецензирования в NASA Systems Engineering Handbook начиная с рассмотрения системных требований требуют, чтобы открытые TBD и TBR были определены с планом и графиком их закрытия. Отслеживание должно вестись в атрибуте или реестре, а не только в тексте: у «TBD», вписанного в предложение, нет ни ответственного, ни срока, и ничто не напоминает его закрыть.
Типы требований
Классификация требований помогает рецензентам задавать правильные вопросы и сохранять полноту набора. Ниже приведены распространённые категории; ISO/IEC/IEEE 29148 и руководство INCOSE описывают похожие наборы, и многие проекты добавляют свои.
| Тип | Что формулирует | Пример EO-1 | На что обратить внимание |
|---|---|---|---|
| Функциональное | Что система должна делать | 4.3 Fault Detection: «The C&DH shall enter safe mode within 10 seconds of undervoltage detection». | Функция без указанной характеристики; большинству функциональных требований нужно и «насколько хорошо», здесь «within 10 seconds» |
| Характеристика | Насколько хорошо выполняется функция: количество, частота, точность, время | 2.1 Pointing Accuracy: «The ADCS shall point the payload boresight within 0.1 degrees of the commanded target». | Отсутствующие условия (какой режим, какой этап жизненного цикла) и отсутствующее направление предела |
| Интерфейс | Что пересекает границу с другой системой или элементом и его характеристики | 5.2 UHF Command Uplink: «The UHF transceiver shall receive ground commands at 9.6 kbps». Полное определение находится в документе управления интерфейсами. | Требования, которые пересказывают ICD вместо ссылки на него, так что они расходятся |
| Ограничение | Предел для конструкции или способа изготовления системы, наложенный извне | 4.4 Downlink Encryption: «The C&DH shall encrypt each downlink frame with 256-bit keys». Его обоснование: контракт с заказчиком требует шифрования снимков при передаче, поэтому требование приходит извне проекта, а не из анализа компромиссов внутри него. | Проектные решения, записанные как ограничения, хотя никто извне их не накладывал |
| Условия среды, надёжность, безопасность | Условия, которые нужно выдержать, и надёжность, которой нужно достичь | 1.7 Mission Lifetime: «The spacecraft shall operate in orbit for at least 730 days». | Значения без вероятности или доверительного уровня, при которых они заявлены |
Граница между функциональными требованиями и требованиями к характеристикам часто проходит внутри одного предложения: многие требования формулируют функцию вместе с её характеристикой, как 4.3. Это нормально, пока предложение содержит одно обязательство. Требования к интерфейсам подробнее описаны в руководстве по документу управления интерфейсами, а функции, стоящие за функциональными требованиями, — в руководстве по функциональному анализу.
Разобранный пример: рецензирование спецификации EO-1
Рецензирование SRS-001 по контрольному списку делит 32 требования на три группы. Большинство проходят. У нескольких есть мелкие замечания, достойные одной фразы каждое. Три нужно переписать.
Автоматическая проверка той же спецификации согласуется с рецензированием: 29 из 32 требований оцениваются как хорошие, а три слабых требуют доработки. Замечания для 2.5 перечисляют каждое нарушенное правило по названию и номеру — именно это нужно автору для исправления. Проверка также отмечает то, что не может решить сама: для 3.1 корректность и выполнимость ждут рецензента, потому что текст изменился после последнего рецензирования.
Мелкие замечания
- 1.6.2 Off-Nadir Imaging, «up to 25 degrees off nadir»: «up to» читается как максимум, но имеется в виду возможность, которой аппарат должен обладать под любым углом от 0 до 25 градусов. Неверное прочтение позволило бы признать соответствующей конструкцию, которая снимает только в надир.
- 1.6.1 Ground Track Repeat, «its ground track»: местоимение с единственным возможным референтом, так что замечание мелкое. «Every» в том же предложении — ложное срабатывание правила о кванторах всеобщности.
- 1.5 Daily Collection Volume имеет метод (анализ) и критерии успеха («Simulated daily volume of at least 3.2 GB over a 30-day plan»), но пока без связанного анализа. Формулировка в порядке; верификация не выполнена.
- 3.1 Orbit Average Power написано хорошо, но его текст изменился после утверждения, поэтому его корректность и выполнимость снова требуют суждения рецензента. Настоящий вопрос — выполнимость: спроектированные панели дают около 28 Вт в среднем по орбите.
Три переформулировки
2.5 Safe Mode Recovery. «The spacecraft should recover from safe mode quickly and resume imaging as appropriate» нарушает минимум шесть правил: «should» вместо «shall», два обязательства, соединённые «and», «quickly» без значения, лазейка «as appropriate», нет завершающей точки и нет верификации. Переформулировка сохраняет единственный важный для заказчика результат и даёт ему значение:
The spacecraft shall resume imaging within 6 hours of a safe mode entry.
Обоснование должно говорить, откуда взялись 6 часов (N1 требует оповещений о стрессе посевов в тот же день, а 6.2 допускает 6 часов от сброса данных до доставки). Если шаги восстановления важны сами по себе, например повторный захват Солнца или сообщение о причине, каждый становится отдельным требованием. Метод: тест, внесением отказов на flatsat; критерий успеха: съёмка возобновляется в течение 6 часов при каждом внесённом переходе в безопасный режим.
3.5 Battery Thermal Control. «The thermal design shall keep the battery warm enough (TBD)». содержит расплывчатый термин, TBD в тексте и скобки. Исправление разделяет обязательство, открытое значение и причину:
The thermal design shall keep the battery cell temperature at or above 0 °C while charging.
0 °C — условное значение: литий-ионные элементы обычно не заряжают при отрицательной температуре, но реальный предел берётся из паспорта элемента и теплового анализа. Пока анализ его не установит, значение — TBR, за который отвечает Thermal Engineer, со сроком до рецензирования теплового проекта. Переформулировка также вскрывает пробел, который скрывал оригинал: нет требования к диапазону температур разряда, а для него нужна отдельная формулировка.
6.4 Operator Interface. «The operator interface shall be user friendly and/or easy to use». содержит два субъективных термина и «and/or». Удобство использования можно специфицировать, но только через наблюдаемые задачи:
The operator interface shall let a trained operator book a ground station contact in no more than 5 minutes.
Задача и время условны. Реальный набор перечислял бы немногие важные задачи (забронировать сеанс связи, загрузить список целей, прочитать последнюю телеметрию состояния), каждую со временем и пределом ошибок, измеренными на демонстрации с операторами, прошедшими обучение.
Типичные ошибки
| Ошибка | Что идёт не так | Лучше |
|---|---|---|
| Записывать конструкторские решения как требования | Конструкция фиксируется до анализа компромиссов, и лучший вариант исключается без чьего-либо решения. | Сформулируйте потребность («keep the cells at or above 0 °C while charging») и дайте уровню ниже выбрать нагреватель. |
| Переносить формулировки заинтересованных сторон прямо в требования | «Свежие снимки дважды в неделю» — это потребность; в таком виде её нельзя верифицировать. | Сохраните потребность и напишите требование со значением и условием, которое её удовлетворяет (1.6 within 72 hours). |
| Несколько требований в одном абзаце | Один идентификатор несёт несколько обязательств, у которых один статус, один тест и одна судьба. | Одно требование на элемент, одно «shall» на формулировку. |
| Значения без условий | «30 Вт» в начале и в конце срока службы — это разные конструкции. | Укажите режим, этап жизненного цикла, среду и усреднение. |
| Нет обоснования | Никто не может оценить последующее изменение, и требование живёт ещё долго после того, как исчезла его причина. | Запишите причину и числа, стоящие за значением. |
| Пороги тестов не выведены из требования | Тест проходит, хотя требование не выполнено (TC-06 при пиковых 72 Вт против 28 Вт в среднем по орбите). | Выведите критерий успеха из формулировки арифметически и запишите его. |
| TBD вписан в текст и забыт | У открытого значения нет ответственного и срока, и оно попадает в базовую линию. | Отслеживайте каждый TBD и TBR с ответственным, сроком и планом закрытия. |
| «Золочение» | Требования, которых никто не просил, отнимают усилия на проектирование и испытания. | Проверьте, что каждое требование верхнего уровня прослеживается к потребности или источнику. |
| Чрезмерная опора на автоматические проверки | Чистая проверка слов принимается за корректное требование. | Используйте инструменты для механических правил; корректность, выполнимость и необходимость оценивает человек. |
Попробуйте в Holarch
В LML-проекте каждое требование — сущность класса Requirement с описанными выше атрибутами: Rationale, Status, Priority, Criticality, Owner, Source, Verification Method, Verification Level, Success Criteria и поля TBD/TBR.
- Создайте демо через Управление проектами → Файлы проекта ▾ → Новый демо-проект → CubeSat (пошаговая системная инженерия). Его спецификация содержит три слабых требования и открытые вопросы TBD/TBR, используемые в этом руководстве.
- Откройте Потребности и требования → Качество, выберите документ в списке области и нажмите Проверить качество. Каждое требование оценивается по девяти характеристикам, а предложения называют номера правил из руководства INCOSE, которые можно проверить по списку слов или шаблону. Correct и Feasible требуют рецензента: нажмите на отметку, чтобы записать решение.
- Перепишите 2.5, как показано выше, и запустите проверку снова. Замечания о союзе, лазейке и расплывчатом термине исчезнут.
- Откройте Потребности и требования → TBD/TBR, чтобы увидеть открытые вопросы с ответственными и сроками, и нажмите Закрыть, когда значение установлено.
- Для второго мнения по характеристикам, которые правило решить не может, используйте ✦ ИИ ▾ → Проверка требований ИИ; каждый вердикт и каждая переформулировка показываются для просмотра, прежде чем что-либо изменится.
Полный справочник — в документации по качеству требований и реестру TBD/TBR.
Скачать контрольный список
Контрольный список качества требований с примерами EO-1 «до и после» (CSV) содержит правила с вопросами для рецензирования и примерами — для использования на рецензировании или как отправная точка для собственных правил написания в проекте. Тот же файл предлагает руководство по прослеживаемости.
Вопросы о написании требований
Shall, must или will?
Подойдёт любое соглашение, если спецификация его определяет и придерживается его. Самое распространённое использует «shall» для обязательных требований, «will» для фактов и намерений относительно того, что вне системы, и «should» для целей, которые не верифицируются. Некоторые государственные руководства по стилю предпочитают «must» ради простоты языка. Настоящая проблема — смешивать их в одной спецификации.
Сколько требований должно быть у системы?
Правильного числа нет. У небольшого космического аппарата может быть несколько десятков системных требований и несколько сотен под ними; у крупной программы — тысячи. Полезнее спросить, прослеживается ли каждое требование к потребности или родителю и есть ли под каждой потребностью требования.
Являются ли пользовательские истории требованиями?
Пользовательская история фиксирует потребность и её цель в терминах пользователя. Она играет роль потребности заинтересованной стороны, а её критерии приёмки близки к критериям верификации. Для системы, которая строится, интегрируется и верифицируется как аппаратура и ПО вместе, истории всё равно нужно превратить в требования, которые можно распределить и протестировать.
Может ли инструмент проверить качество требований?
Инструмент может надёжно проверять механические правила: модальные глаголы, союзы, расплывчатые слова, лазейки, местоимения, отсутствующие связи. Он не может знать, правильное ли значение 30 Вт и способны ли панели его обеспечить. Используйте автоматическую проверку, чтобы устранить механические замечания до рецензирования, и тогда рецензенты потратят время на корректность и выполнимость.
Что дальше
- Прослеживаемость требований и влияние изменений: свяжите эти требования с потребностями, конструкцией и тестами и проследите изменение.
- Функциональный анализ: превратите требования в функции и распределите их.
- Матрица верификации требований: спланируйте метод верификации для каждого требования и запишите результаты.
- Потребности и требования в Holarch: документы, проверки качества, базовые линии и прослеживаемость в одной модели.