Руководство · Практика MBSE
Инженерия линеек продуктов и управление вариантами в MBSE
Большинство систем выпускается более чем в одной версии. Инженерия линеек продуктов моделирует общий проект один раз и сознательно управляет различиями: модель характеристик говорит, что может меняться, конфигурации — что выбрал каждый продукт, а каждое требование, компонент и тест — к каким продуктам оно относится. В этом руководстве объясняется метод (модель 150 %, модели характеристик, допустимые конфигурации, применимость, а также документы, верификация и базовые линии для каждого продукта), а затем он разбирается на CubeSat, выпускаемом в двух версиях.
На этой странице
- Что такое инженерия линеек продуктов
- Модель 150 %
- Модели характеристик
- Конфигурации и их допустимость
- Привязка вариативности к модели
- Параметры для каждой конфигурации
- Применимость по серийному номеру и дате
- Документы, верификация и базовые линии для каждой конфигурации
- Типичные ошибки
- Разобранный пример: EO-1 Flight и EO-1 Lite
- Линейки продуктов в Holarch
- Часто задаваемые вопросы
- Попробуйте в Holarch
- Упражнение: найдите и исправьте четыре ошибки линейки продуктов
- Что дальше
Что такое инженерия линеек продуктов
Линейка продуктов — это семейство продуктов, у которых большая часть проекта общая и которые различаются в нескольких известных точках. Аппарат для стартового заказчика и более дешёвая коммерческая версия, автомобиль с тремя вариантами ёмкости батареи, радар во внутреннем и экспортном исполнении, блочные модернизации наземной станции: каждый случай — один проект с вариантами. Инженерия линеек продуктов (PLE) — это дисциплина построения и сопровождения такого семейства как единого инженерного актива, а не набора отдельных проектов.
Альтернатива — клонирование с доработкой (clone and own): скопировать модель, документы и планы испытаний первого продукта, а затем править копию для второго. Сначала это быстро, потом дорого. Каждое исправление приходится вносить в каждую копию, никто не может сказать, какие различия задуманы, и копии расходятся.
PLE заменяет копии тремя вещами:
- Одна общая модель, содержащая все требования, функции, компоненты, интерфейсы и тесты всех продуктов.
- Явное описание вариативности: выборы, которыми различаются продукты, и правила между ними.
- Привязка каждого вариативного элемента к выборам, от которых он зависит, так что любой продукт можно получить из общей модели по запросу.
ISO/IEC 26550 описывает эталонную модель инженерии линеек программных продуктов и систем. Она отделяет инженерию предметной области — работу с общими активами и их вариативностью — от инженерии приложений — работы по получению и поставке одного продукта из них. ISO/IEC 26580 добавляет методы и возможности инструментов для основанной на характеристиках формы PLE, которой следует это руководство. Варианты продукта также относятся к управлению конфигурацией: ISO/IEC/IEEE 15288 включает идентификацию конфигурации и базовые линии в свой процесс управления конфигурацией, а SAE EIA-649 рассматривает применимость — экземпляры, к которым относится конфигурация, — как часть идентификации конфигурации.
Когда линейка продуктов окупается
У PLE есть затраты на внедрение: модель характеристик, которую нужно согласовать, и привязка, которую нужно поддерживать. Она окупается, когда:
- два или более продукта имеют большую часть общих требований, функций и архитектуры;
- изменение общей части должно доходить до каждого продукта;
- каждому продукту всё равно нужны своя спецификация, запись о верификации и базовые линии;
- ожидаются новые варианты, поэтому различия нужно описать один раз и использовать повторно.
Она не окупается для одного продукта, меняющегося со временем: экземплярам, выпускаемым последовательно с заменой деталей, нужна только применимость.
Модель 150 %
Общую модель линейки продуктов часто называют моделью 150 %. Она содержит объединение всех продуктов: оба радиомодуля, если у одного продукта радио S-диапазона, а у другого X-диапазона, двигательный модуль, который могут нести некоторые продукты, требование шифрования, которое запросил лишь один заказчик.
Каждый продукт — это его представление 100 %: элементы, относящиеся к этому продукту, с его значениями, полученные из модели, а не скопированные. Это даёт методу главное свойство: изменение общего элемента вносится один раз и сразу оказывается в каждом продукте, а изменение вариативного элемента доходит только до тех продуктов, к которым он относится.
В модели 150 % нужно представить два вида различий:
- Присутствие: элемент есть в одних продуктах и отсутствует в других (радио X-диапазона, требование шифрования, тест канала X-диапазона).
- Значение: элемент есть в каждом продукте, но в некоторых с другим значением (суточный объём данных 3 ГБ в одном продукте и 1 ГБ в другом, масса, результат теста).
Третье различие, время (какие экземпляры или даты сборки), учитывается через применимость.
Модели характеристик
Характеристика (feature) — это свойство продукта, которое может выбрать заказчик, рынок или инженерное решение: «X-band Downlink», «Encrypted Downlink», «Propulsion». Модель характеристик располагает характеристики в дереве и добавляет правила о допустимых сочетаниях. Нотация восходит к анализу предметной области на основе характеристик (FODA) начала 1990-х и сегодня является самым распространённым способом описания вариативности в линейках продуктов.
Каждая характеристика и каждая группа дочерних характеристик подчиняется одному из небольшого набора правил:
| Правило | Значение | Пример |
|---|---|---|
| Обязательная | Есть в каждом продукте, где есть родитель. | У каждого аппарата есть канал передачи на Землю. |
| Необязательная | Выбирается для каждого продукта. | Шифрование, двигательная установка. |
| Альтернатива (выбрать одну) | Ровно одна дочерняя характеристика группы на продукт. | Канал передачи — S-диапазон или X-диапазон, но никогда оба и никогда ни одного. |
| Или (выбрать хотя бы одну) | Одна или несколько дочерних характеристик на продукт. | Комплект датчиков видимого, инфракрасного диапазона или обоих. |
| Требует | Выбор этой характеристики влечёт выбор другой. | Шифрование требует радио X-диапазона, модем которого его поддерживает. |
| Исключает | Две характеристики никогда не встречаются вместе. | Раскрываемая антенна исключает вариант с уменьшенным объёмом в сложенном виде. |
| Ограничение | Любое другое условие, записанное как логическое выражение над характеристиками. | Двигательная установка и не малая батарея. |
Называйте характеристики по продукту, а не по документам или деталям: «X-band Downlink», а не «Section 5 option B» или «Radio P/N 4471». Одна характеристика обычно соответствует нескольким компонентам, требованиям и тестам; держите дерево характеристик и дерево компонентов раздельно, а связывает их привязка. Записывайте каждое правило в модель, как только оно становится известно.
Конфигурации и их допустимость
Конфигурация — это один продукт: именованный выбор характеристик, например «EO-1 Lite: S-band downlink, no encryption, no propulsion». Конфигурацию покупает заказчик, для неё пишется спецификация, её верифицирует кампания испытаний и её фиксирует базовая линия.
Действующий выбор конфигурации шире, чем отмеченные кем-то характеристики. Он включает также родителей каждой выбранной характеристики, обязательные дочерние характеристики каждой выбранной и обязательные характеристики корня. Поэтому элемент, привязанный к родительской характеристике, есть в каждом продукте, выбравшем любую из её дочерних.
Конфигурация допустима, когда её действующий выбор соответствует каждому правилу модели характеристик. Проверка каждой конфигурации даёт один из трёх ответов:
- Допустимо: выполняются все правила.
- Нарушает правило: например, продукт выбрал шифрование без требуемого им радио X-диапазона.
- Неполно: выбор отсутствует, например нет диапазона канала передачи в группе «выбрать одну».
Допустимость — самая дешёвая проверка в PLE: недопустимая конфигурация — это продукт, который нельзя построить по спецификации, и обнаруживается он при определении, а не при интеграции. Проверяйте и саму модель характеристик: характеристика, которую не выбирает ни одна конфигурация, — это либо будущая опция, либо мёртвый груз.
Число возможных конфигураций быстро растёт: десять независимых необязательных характеристик дают 1024 сочетания. Реальные линейки продуктов сознательно определяют несколько конфигураций, а остальное пространство считают непредлагаемым.
Привязка вариативности к модели
Модель характеристик говорит, что может меняться. Привязка говорит, какие элементы модели от каких выборов зависят. У каждого вариативного элемента есть условие присутствия: логическое выражение над характеристиками (и изредка конфигурациями), истинное для продуктов, включающих элемент. Элементы без условия есть в каждом продукте, и в хорошо построенной линейке продуктов это большая часть модели.
Привязка должна охватывать все виды элементов, иначе представления 100 % будут несогласованными:
- Требования: требование, которое запросили лишь некоторые заказчики, привязывается к выбранной ими характеристике. Требование, которое есть в каждом продукте, но с разным значением, не привязывается; вместо этого оно получает значение для каждой конфигурации.
- Функции: обычно общие; функция варьируется, только когда продукт делает то, чего не делают другие.
- Компоненты и интерфейсы: радио X-диапазона, его интерфейс данных и его радиоканал привязаны к одной характеристике. Интерфейс, оба конца которого никогда не оказываются в одном продукте, — ошибка привязки.
- Тесты и верификация: тест канала X-диапазона относится только к продуктам с радио X-диапазона. Тест, который проходят оба продукта, остаётся общим и фиксирует по одному результату на продукт.
- Связи: связь satisfies или verifies обычно следует за своими концами. Привязывайте связь отдельно, только когда оба её конца вместе присутствуют в нескольких продуктах, но сама связь действует лишь в некоторых.
Записывайте условия присутствия через характеристики, а не конфигурации. «X-band Downlink» остаётся верным, когда добавляется третий продукт с радио X-диапазона; «EO-1 Flight» молча исключает новый продукт. Указывайте конфигурацию в условии только для действительно единичного элемента, например этикетки конкретного заказчика.
Параметры для каждой конфигурации
Многие различия — это значения, а не присутствие: объём данных, распределение массы, срок службы. Отдельное требование на каждый продукт для каждого значения умножило бы число элементов и разделило бы их связи.
Лучший шаблон — один элемент с базовым значением и собственным значением для каждой конфигурации, где оно отличается. Элемент сохраняет одну идентичность (один номер, один набор связей, одну историю), а представление каждого продукта показывает его собственное значение. Конфигурация без собственного значения использует базовое.
Задавайте собственное значение только там, где значение действительно отличается, чтобы изменение базового значения по-прежнему доходило до всех остальных продуктов. И проверяйте текст вокруг значения: обоснования, пороги тестов и производные требования часто приводят число, и каждое такое упоминание требует той же обработки, иначе представление продукта противоречит само себе. В разобранном примере такое есть.
Применимость по серийному номеру и дате
Применимость говорит, с какого экземпляра или даты сборки действует элемент. Она отвечает на другой вопрос, чем условие присутствия:
| Условие присутствия (Применяется к) | Применимость | |
|---|---|---|
| Вопрос | Какие продукты включают элемент? | К каким экземплярам или датам сборки он относится? |
| Запись | Выражение над характеристиками и конфигурациями | Диапазоны серийных номеров, например 1-20, 25, 40-, и диапазон дат |
| Типичное применение | Опции, варианты, выбор заказчика | Замена деталей в ходе производства, блочные модернизации, доработки |
| Пусто означает | Каждый продукт | Каждый экземпляр, всегда |
Они сочетаются: элемент попадает в представление, когда относится к продукту и действует для рассматриваемого экземпляра или даты. Замена детали начиная с серийного номера 2 моделируется двумя элементами: старая деталь с применимостью «SN 1» и новая с «SN 2 и далее», оба с одинаковым условием присутствия. Так в модели остаются оба проекта, и запись о фактической комплектации экземпляра 1 остаётся точной после изменения экземпляра 2.
У конфигурации есть собственная применимость: серийные номера, построенные по ней. Она фиксирует, какой экземпляр к какому продукту относится; элементы она не фильтрует. Две конфигурации с пересекающимися диапазонами серийных номеров обычно указывают на ошибку нумерации.
Документы, верификация и базовые линии для каждой конфигурации
Смысл модели 150 % в том, что каждый продукт всё равно получает всё, что было бы у проекта с одним продуктом:
- Документы для каждой конфигурации. Спецификация, сформированная для одного продукта, опускает неприменимые разделы, показывает значения этого продукта и указывает на титульном листе, какую конфигурацию (и, если нужно, какой серийный номер или дату) она описывает. Номера разделов в таком документе — это номера представления: они закрывают пропуски от удалённых разделов, а хранимые номера в модели остаются одинаковыми для всех продуктов.
- Верификация для каждой конфигурации. «Верифицировано» означает верифицировано для одного продукта. Требование, общее для двух продуктов, может быть верифицировано для одного и оставаться открытым для другого, поэтому результаты фиксируются для каждой конфигурации, а матрица верификации читается по каждой конфигурации.
- Базовые линии для каждой конфигурации. Проектное рецензирование продукта фиксирует этот продукт. Базовая линия конфигурации записывает всю линейку продуктов с пометкой рассматриваемой конфигурации, поэтому её можно сравнить с более поздним состоянием того же продукта или с другим продуктом на тот же момент.
- Управление изменениями для каждой конфигурации. Запрос на изменение должен указывать, какие продукты он меняет. Изменение общего элемента меняет каждый продукт; изменение собственного значения одной конфигурации меняет только её.
Типичные ошибки
| Ошибка | Что идёт не так | Лучше |
|---|---|---|
| Клонирование с доработкой как временная мера | Копия становится постоянной; исправления доходят до одного продукта, но не до другого. | Начинайте второй продукт как конфигурацию первой модели. |
| Характеристики, названные по документам или деталям | Модель характеристик превращается в перечень деталей, и каждое изменение проекта её переписывает. | Называйте характеристики по видимым заказчику выборам; пусть привязка сопоставляет их деталям. |
| Условия присутствия с названиями конфигураций | Новый продукт молча теряет элементы, привязанные к «CFG-1». | Привязывайте к характеристикам; называйте конфигурацию только для единичных элементов. |
| Копии вместо собственных значений | Два требования «Daily Data Volume», у каждого половина связей. | Одно требование с базовым значением и собственным значением для каждой конфигурации. |
| Устаревшие процитированные значения | Обоснование или порог по-прежнему приводит базовое значение в продукте, у которого есть собственное. | Рецензируйте представление каждого продукта, а не только модель 150 %. |
| Правила вне модели | Конфигурация, которую нельзя построить, проходит рецензирование. | Записывайте requires, excludes и ограничения в модель характеристик; проверяйте каждую конфигурацию. |
| Несогласованно привязанные интерфейсы | Интерфейс, концы которого никогда не оказываются в одном продукте, или компонент без своего интерфейса. | Привязывайте компонент, его интерфейсы и его тесты к одной характеристике; запускайте проверки согласованности. |
| Верификация, засчитанная для всей линейки | Требование показывает «верифицировано», потому что прошёл один продукт. | Читайте матрицу верификации по каждой конфигурации. |
Разобранный пример: EO-1 Flight и EO-1 Lite
Пример — EO-1, вымышленный CubeSat формата 6U, снимающий сельхозугодья, смоделированный в Holarch как LML-проект. Это та же модель, что и в сквозном примере MBSE. Демо строит EO-1 как два продукта:
- EO-1 Flight — аппарат для стартового заказчика, контракт которого требует доставки полных сцен за один сеанс с шифрованием при передаче;
- EO-1 Lite — более дешёвый аппарат для коммерческих покупателей снимков с каналом S-диапазона из исходного проекта.
Руководство по анализу компромиссов сравнивает S- и X-диапазон для канала передачи и выбирает S-диапазон по стоимости и поддержке наземных станций. Это решение верно для коммерческого продукта. Анализ чувствительности показал, что X-диапазон выигрывает при большом весе скорости передачи данных, а это случай стартового заказчика; линейка продуктов сохраняет оба ответа.
Модель характеристик
На странице Управление и рецензирование → Линейка продуктов у EO-1 пять характеристик:
| Характеристика | Вид | Дочерние | Правила | Значение |
|---|---|---|---|---|
| F-1 Downlink | Обязательная | Выбрать одну | У каждого продукта ровно один диапазон канала передачи. | |
| F-2 S-band Downlink | Необязательная (дочерняя для F-1) | 2,2 ГГц при 10 Мбит/с через партнёрскую сеть наземных станций. | ||
| F-3 X-band Downlink | Необязательная (дочерняя для F-1) | 8 ГГц при 100 Мбит/с для доставки полных сцен в том же сеансе. | ||
| F-4 Encrypted Downlink | Необязательная | требует F-3 | Данные полезной нагрузки шифруются при передаче. | |
| F-5 Propulsion | Необязательная | требует F-3 | Двигатель на холодном газе для поддержания орбиты. Помещается только рядом с радио X-диапазона. Изучен; ни у одного продукта его пока нет. |
Группа «выбрать одну» — сердце модели: два радио — альтернативы, поэтому ни у одного продукта не может быть обоих или ни одного. Два правила requires фиксируют инженерные факты: шифрование выполняется в модеме X-диапазона, а двигатель помещается только в компоновке, которую освобождает радио X-диапазона.
Две конфигурации и их вердикты
| Конфигурация | Статус | Серийные номера | Выбирает | Вердикт |
|---|---|---|---|---|
| CFG-1 EO-1 Flight | Выпущено | 1–2 | F-3 X-band Downlink, F-4 Encrypted Downlink | Допустимо |
| CFG-2 EO-1 Lite | Черновик | 3 и далее | F-2 S-band Downlink | Допустимо |
Обе конфигурации также содержат F-1 Downlink — как обязательную корневую характеристику и как родителя выбранного диапазона; сетка помечает её как подразумеваемую. Чтобы увидеть правила в действии, отметьте Encrypted Downlink в столбце CFG-2. Вердикт меняется на «Нарушение: Encrypted Downlink требует X-band Downlink». Шифрование в продукте Lite было бы изменением проекта, а не конфигурации. Снимите отметку с помощью ⌘Z / Ctrl+Z.
Что к какому продукту относится
У большей части EO-1 поле Применяется к пустое: конструкция, система электропитания, камера, командная радиолиния, бортовое ПО и большинство требований есть в обоих продуктах. Различающиеся элементы привязаны к характеристикам, никогда не к конфигурации:
| Применяется к | Элементы | В |
|---|---|---|
| F-2 S-band Downlink | 1.5.2 S-band Transmitter; требование 5.1 S-band Downlink Rate | EO-1 Lite |
| F-3 X-band Downlink | 1.5.3 X-band Payload Radio; интерфейсы IF-08.1 X-band Data Interface и IF-12.1 X-band Downlink; требование 5.5 X-band Downlink Rate; тестовый случай TC-21 X-band Link Test | EO-1 Flight |
| F-4 Encrypted Downlink | Требование 4.4 Downlink Encryption | EO-1 Flight |
Радио X-диапазона привязано вместе со всем, что от него зависит: двумя интерфейсами, требованием, которое оно выполняет, и тестом, который верифицирует это требование. Оно также выполняет ту же операцию передачи данных, что и передатчик S-диапазона, а в каждом продукте присутствует только одно из двух радио, так что функция общая, а её исполнитель варьируется.
Привязка не полна, и рецензирование представления EO-1 Flight показывает, где именно. Поищите в этом представлении «S-band»: требование 5.3 Downlink Link Margin («The S-band downlink shall close with at least 3 dB link margin…»), тестовый случай TC-10 S-band Link Test и интерфейс IF-12 S-band Downlink не имеют «Применяется к», поэтому они есть и в EO-1 Flight — продукте без радио S-диапазона. Проверки модели этого не видят: как связи элементы согласованы, и только их текст называет вариант. Для каждого нужно решение: привязать к F-2 и добавить аналог для X-диапазона, где его нет (у 5.3 нет; IF-12.1 и TC-21 уже есть), или переформулировать так, чтобы оно было верно для обоих диапазонов. Поиск в представлении каждого продукта названий вариантов, которых у него нет, — дешёвый шаг рецензирования для любой линейки продуктов.
Поскольку привязка использует характеристики, будущий третий продукт с радио X-диапазона и без шифрования автоматически получил бы радио, его интерфейсы и TC-21 и не включил бы 4.4.
Значение, которое различается: 5.4 Daily Data Volume
Требование 5.4 Daily Data Volume есть в обоих продуктах, поэтому оно не привязано. Его базовый текст: «The ground segment shall receive at least 3 GB of payload data each day.» Коммерческим покупателям EO-1 Lite нужно меньше, поэтому у CFG-2 собственное значение: «at least 1 GB». Выберите Просмотреть как ▾ → CFG-2 EO-1 Lite и откройте 5.4: в описании указано 1 GB и есть метка Значение CFG-2. В режиме Все конфигурации поле помечено как Различается. У 5.4 остаётся один номер, один набор связей и одна история.
Числа за этим простые. При 10 Мбит/с 8-минутный сеанс S-диапазона возвращает 4,8 гигабита, или 0,6 ГБ; для 3 ГБ нужно пять сеансов в сутки, для 1 ГБ — два. При 100 Мбит/с один сеанс X-диапазона возвращает 6 ГБ, поэтому EO-1 Flight доставляет полный день сцен за один сеанс.
Теперь посмотрите на 5.1 S-band Downlink Rate, которое относится только к EO-1 Lite. Его обоснование гласит: «Clears one day of collection (3 GB, Req 5.4) in five 8 minute passes.» В EO-1 Lite требование 5.4 задаёт 1 GB, поэтому обоснование ссылается на значение, которое единственный продукт этого требования не использует. С самой скоростью всё в порядке; устарело обоснование. Это вид отказа «устаревшие цитируемые значения», описанный выше, и обнаруживается он только при чтении собственного представления продукта. Исправление: дать обоснованию 5.1 логику Lite (два сеанса на 1 GB с запасом на пропущенные сеансы) или назвать истинную причину выбора скорости.
Замена детали по серийному номеру
Откройте 1.3.2 Battery Pack. У него две характеристики нагревателя: Thermostat Heater Power (2 W, применимость SN 1) и Software-Controlled Heater Power (3 W, SN 2 и далее). Нагреватель изменился начиная со второго аппарата. Обе характеристики есть в каждом продукте: изменение касается экземпляров, а не вариантов.
Диапазоны серийных номеров — место, где встречаются два понятия. EO-1 Flight — это серийные номера 1–2, поэтому изменение происходит внутри одной конфигурации: экземпляр 1 летит с термостатным нагревателем, экземпляр 2 — с программно управляемым. EO-1 Lite начинается с серийного номера 3 и имеет только новый нагреватель. Если в Просмотреть как ▾ → Применимость ▸ → Серийный номер… задать 1, представление показывает экземпляр 1 в том виде, в каком он собран; при значении 2 — второй аппарат. Новый нагреватель потребляет на 1 W больше, а именно такое значение руководство по анализу влияния изменений прослеживает до бюджета мощности.
Верификация для каждого продукта
Тестовый случай TC-11 UHF Command Test выполняется на обоих продуктах и хранит по одному результату на конфигурацию: Пройдено в EO-1 Flight (500 из 500 команд в пределах 0,4 с от своих меток времени, на стенде FS-1) и В работе в EO-1 Lite (отправлено 312 из 500 команд, на стенде FS-3). Поэтому требования, которые он верифицирует, верифицированы для одного продукта и открыты для другого.
Верификация → RVTM показывает оба прочтения. В режиме «Все конфигурации» группа столбцов Конфигурация даёт по одному сводному статусу на конфигурацию, с «—» там, где требование не применяется (у 5.5 X-band Downlink Rate нет статуса для EO-1 Lite). В представлении конфигурации RVTM перечисляет только требования и результаты этого продукта, поэтому «верифицировано» означает «верифицировано для этого продукта». TC-21 X-band Link Test, всё ещё не выполнявшийся, появляется только в матрице EO-1 Flight.
Чтобы записать новые результаты для одного продукта, выберите его в Просмотреть как ▾ и используйте Выполнить набор в Верификация → Центр тестирования: появится сообщение «Результаты записываются для CFG-2.», и результаты сохранятся как значения этой конфигурации.
Одна спецификация на продукт
Требования хранятся в одном документе, SRS-001 EO-1 System Requirements Specification. Чтобы выпустить его для EO-1 Lite, откройте его, выберите Поставка ▾ → Спецификация (Word), задайте Конфигурация = CFG-2 EO-1 Lite и Применимость = Любой экземпляр и экспортируйте. Спецификация Lite не содержит 4.4 Downlink Encryption и 5.5 X-band Downlink Rate, показывает 5.4 с 1 GB и называет конфигурацию на титульной странице, в нижнем колонтитуле и в имени файла.
Спецификация EO-1 Flight, наоборот, не содержит 5.1 S-band Downlink Rate, поэтому следующие за ним требования раздела 5 в этом документе получают номер на единицу меньше, а в файле написано «Нумерация как в CFG-1.» Номера в модели не меняются, поэтому ссылка на требование одного продукта должна называть конфигурацию вместе с номером.
Экспортированный с Все конфигурации и включённым Показать применимость, тот же документ становится спецификацией 150 %: все разделы, с пометкой «Применяется к: CFG-1» под разделами, которые есть только у EO-1 Flight.
Базовая линия PDR для EO-1 Flight
В демо есть базовая линия конфигурации EO-1 Flight PDR, созданная для предварительного рассмотрения проекта (PDR) EO-1 Flight, в разделе Управление и рецензирование → Базовые линии и версии. Она фиксирует всю линейку продуктов с меткой CFG-1 и создана командой Создать базовую линию конфигурации…. Сравнение её с текущей моделью по конфигурации показывает, что изменилось в EO-1 Flight после PDR, и не показывает ничего, что изменилось только в EO-1 Lite.
CFG-1 имеет статус Выпущено, а CFG-2 всё ещё Черновик: продукт Lite ещё определяется. При включённом управлении конфигурацией выпущенная конфигурация, входящая в последнюю базовую линию, находится под контролем, поэтому её собственные значения меняются только через запрос на изменение. Карточка Конфигурации запроса на изменение называет продукты, которые он меняет, а Владелец конфигурации должен утверждать запросы, которые её меняют.
Что находят проверки
Верификация → Проверки модели выполняет набор правил Линейка продуктов в режиме «Все конфигурации». На EO-1 правила не сообщают об ошибках, а ProductLine.4 предупреждает, что Propulsion не выбрана ни одной конфигурацией. Здесь так и задумано: F-5 — изучаемый вариант, который держат в модели характеристик, чтобы правило «requires X-band Downlink» было записано до того, как кто-то его предложит. В реальной программе это предупреждение — повод принять решение и записать его: предлагать вариант, оставить его как исследование или удалить.
Линейки продуктов в Holarch
Holarch реализует метод в одной модели: страница Линейка продуктов содержит дерево характеристик и конфигурации с их вердиктами, группа Линейка продуктов в инспекторе содержит Применяется к и применимость, а Просмотреть как ▾ показывает и позволяет редактировать каждую страницу как одну конфигурацию. Документы, RVTM, Центр тестирования, поиск (appliesto:CFG-2, varies:yes) и проверки модели следуют за представлением.
Линейки продуктов входят в тарифы Individual и Team. Базовые линии по конфигурациям, сравнение по конфигурации, владельцы конфигураций и конфигурации, которые меняет запрос на изменение, входят в тариф Team.
Вариативность в SysML v2
В SysML v2 вариативность встроена в язык: variation отмечает точку, в которой продукты различаются, её члены variant — допустимые варианты выбора, assert constraint исключает сочетания, а конфигурация — это использование, которое привязывает по одному варианту к каждой точке. В проекте SysML v2 Holarch читает их напрямую: страница Линейка продуктов показывает точки вариативности и конфигурации с вердиктом, а Просмотреть как ▾ показывает модель как одну конфигурацию. Пример — CarLine из демо Hybrid Car с точками pack и charger и правилом wallboxNeedsLargePack. См. Варианты и конфигурации SysML v2.
Часто задаваемые вопросы
Что такое модель 150 %?
Общая модель линейки продуктов, содержащая объединение элементов всех продуктов. Каждый продукт — это её представление 100 %, получаемое сохранением элементов, условие присутствия которых истинно для этого продукта, и показом значений этого продукта. Название говорит лишь о том, что модель больше любого отдельного продукта.
Чем вариант отличается от версии?
Варианты существуют одновременно: EO-1 Flight и EO-1 Lite — оба текущие продукты. Версии следуют друг за другом во времени: проект на PDR, затем на CDR. Вариантами управляют с помощью характеристик и конфигураций, версиями — с помощью базовых линий, а экземплярами, собранными в разное время, — с помощью применимости. Базовая линия конфигурации объединяет первые два.
Когда использовать применимость вместо характеристики?
Когда различие касается того, какие экземпляры когда собраны, а не того, что выбрал заказчик. Деталь, изменившаяся начиная с серийного номера 2, — это применимость. Деталь, которую одни заказчики заказывают, а другие нет, — это характеристика, даже если первый заказавший её заказчик случайно получает более поздние серийные номера.
Попробуйте в Holarch
- Создайте демо через Управление проектами → Файлы проекта ▾ → Новый демо-проект → CubeSat (пошаговая системная инженерия).
- Откройте Управление и рецензирование → Линейка продуктов. Прочитайте дерево характеристик и два столбца конфигураций; оба вердикта — Допустимо.
- В столбце CFG-2 EO-1 Lite отметьте Encrypted Downlink. Прочитайте вердикт, затем нажмите ⌘Z / Ctrl+Z.
- Откройте требование 4.4 Downlink Encryption и посмотрите на группу Линейка продуктов в инспекторе: «Применяется к» равно F-4, а строка под ним называет единственную конфигурацию, к которой оно относится.
- Выберите Просмотреть как ▾ → CFG-2 EO-1 Lite. Откройте 5.4 Daily Data Volume и найдите метку Значение CFG-2; затем откройте 5.1 S-band Downlink Rate и сопоставьте с ним его обоснование.
- Откройте Верификация → RVTM в том же представлении, затем нажмите Выйти на баннере и сравните группу столбцов Конфигурация в режиме «Все конфигурации».
- Откройте 1.3.2 Battery Pack и две его характеристики нагревателя. Выберите Просмотреть как ▾ → Применимость ▸ → Серийный номер… и введите 1, затем 2.
- Откройте SRS-001, выберите Поставка ▾ → Спецификация (Word), задайте Конфигурация = CFG-2 EO-1 Lite и экспортируйте.
- Откройте Верификация → Проверки модели в режиме «Все конфигурации» и найдите предупреждение ProductLine.4 для Propulsion.
Для линеек продуктов нужен тариф Individual или Team; для базовой линии конфигурации и владельцев конфигураций — Team. Полный справочник — в разделе Линейки продуктов и конфигурации, включая «Применяется к», редактирование в представлении конфигурации, применимость и документы, RVTM и верификацию.
Упражнение: найдите и исправьте четыре ошибки линейки продуктов
Линейка продуктов редко ломается сразу. Она ломается из-за мелких правок, каждая из которых выглядит разумной: правило, добавленное в спешке, диапазон серийных номеров, введённый на единицу меньше, тест, привязанный не к той характеристике, изменение правила, которое незаметно ломает уже выпущенный продукт. В этом упражнении в линейку продуктов EO-1 закладываются четыре таких дефекта, а вы находите каждый с помощью проверок, которые выполнил бы рецензент, и исправляете его. Упражнение также показывает, где проверки заканчиваются: знание того, чего инструмент не проверяет, — часть умения им пользоваться.
Вам понадобятся: свежая копия демо CubeSat EO-1 и тариф с линейками продуктов (Individual или Team либо академическая или учебная учётная запись; в тарифе Free страница «Линейка продуктов» доступна только для чтения). По возможности работайте в паре: один закладывает дефекты, пока другой не смотрит, затем другой их находит. Если вы одни, заложите все четыре, закройте проект и вернитесь к нему в роли рецензента.
Внесите ошибки
- Противоречивые правила характеристик. Откройте Управление и рецензирование → Линейка продуктов. В меню ⋯ строки F-5 Propulsion выберите Правила…, отметьте F-3 X-band Downlink в разделе Исключает и нажмите Применить. Теперь Propulsion одновременно требует и исключает канал X-диапазона.
- Перекрывающаяся применимость. В меню ⋯ столбца CFG-2 EO-1 Lite выберите Применимость… и измените Серийные номера с
3-на2-, как будто сборку Lite перенесли на один экземпляр раньше. - Отсутствующая верификация для одной конфигурации. Откройте тестовый случай TC-10 S-band Link Test и в группе Линейка продуктов инспектора задайте Применяется к =
F-3, как будто тест канала относится к радио X-диапазона. - Изменение, делающее выпущенную конфигурацию недопустимой. Вернувшись на страницу «Линейка продуктов», откройте Правила… для F-4 Encrypted Downlink, отметьте F-5 Propulsion в разделе Требует и нажмите Применить, как будто аппаратуре шифрования теперь нужен двигательный отсек.
Найдите их как рецензент
Используйте только то, чем воспользовался бы рецензент: строку вердиктов и Проверить конфигурации на странице «Линейка продуктов», Верификация → Проверки модели (нажмите ↻ Выполнить проверки и посмотрите набор правил Линейка продуктов) и RVTM — как в режиме «Все конфигурации», так и с Просмотреть как ▾, заданным на каждый продукт. Прежде чем открыть ответы, запишите каждый найденный дефект, что его показало и какой продукт он затрагивает.
Показать, где проявляется каждый дефект, и исправление
| Дефект | Где Holarch его показывает | Исправление |
|---|---|---|
| Изменение, ломающее выпущенную конфигурацию | Вердикт CFG-1 EO-1 Flight, имеющей статус «Выпущено», гласит: «Нарушено: Encrypted Downlink требует Propulsion.» Проверить конфигурации выводит её в списке, а проверки модели сообщают об этом как о ProductLine.3, ошибке. | Уберите Propulsion из Требует у F-4. Holarch не отклонил правку: правило хранится в характеристике, а не в выпущенной конфигурации, поэтому ловит его вердикт. |
| Перекрывающаяся применимость | ProductLine.7 выдаёт предупреждение для обеих конфигураций («Общие серийные номера с …»), а диалог «Применимость» сообщает, какой диапазон с каким перекрывается. SN 2 теперь заявлен и EO-1 Flight, и EO-1 Lite. | Верните серийные номера CFG-2 на 3-. |
| Отсутствующая верификация для одной конфигурации | ProductLine.6 выдаёт предупреждение для TC-10: он никогда не оказывается в одной конфигурации с 5.1 S-band Downlink Rate, которое применяется только к F-2. При Просмотреть как ▾ → CFG-2 EO-1 Lite RVTM показывает 5.1 без тестового случая; при CFG-1 он вообще не перечисляет 5.1. | Задайте для TC-10 «Применяется к» = F-2: он тестирует радио S-диапазона, поэтому относится к продуктам, в которых оно есть. Очистка поля, как в поставляемом демо, тоже подходит. |
| Противоречивые правила характеристик | Ничего не краснеет: ни одна конфигурация не выбирает Propulsion, поэтому ни один вердикт не меняется, а ProductLine.4 уже предупреждала, что её не выбирает ни одна конфигурация. Чтобы проверить правила, нажмите + Новая конфигурация, выберите Propulsion вместе с X-диапазоном («Нарушено: Propulsion исключает X-band Downlink.»), затем с S-диапазоном («Нарушено: Propulsion требует X-band Downlink.»). Ни один допустимый продукт не может включать Propulsion. | Уберите X-band из Исключает у Propulsion, затем удалите тестовую конфигурацию. |
Чего проверки не обнаруживают
- Правила проверяются через конфигурации. Holarch проверяет каждую конфигурацию на соответствие правилам характеристик; сами по себе правила он не анализирует, поэтому противоречие остаётся незамеченным, пока какая-либо конфигурация не выберет эту характеристику. Чтобы проверить новое правило, создайте временную конфигурацию-черновик.
- Перекрытие применимости определяется по серийным номерам. ProductLine.7 сравнивает серийные номера конфигураций. О двух конфигурациях с перекрывающимися датами сборки не сообщается.
- Выпущенная конфигурация не защищена от изменений правил. При включённом управлении конфигурацией выпущенная конфигурация, входящая в последнюю базовую линию, меняет свой выбор и значения только через запрос на изменение. Правила характеристик, по которым она проверяется, — отдельные элементы, поэтому выполняйте «Проверить конфигурации» всякий раз, когда изменение затрагивает характеристики.
- Пробелы верификации по продуктам видны в RVTM. ProductLine.6 находит тест, привязанный так, что он никогда не встречается со своим требованием. Требование, у которого в одном продукте нет тестового случая по другой причине, проявляется в RVTM представления этого продукта, поэтому перед рецензированием читайте её по каждой конфигурации.
Прежде чем закончить, выполните проверки ещё раз: вердикты снова должны быть «Допустимо», а правила «Линейка продуктов» должны сообщать только о предупреждении ProductLine.4 для Propulsion, которое в демо оставлено намеренно.
Что дальше
- Линейка продуктов EO-1 в Docs: тот же пример в виде пошагового прохода по приложению.
- Пример анализа компромиссов: выбор между S- и X-диапазоном, на который одна линейка продуктов отвечает дважды.
- Матрица верификации требований: методы, результаты и сводка статусов — основа верификации по конфигурациям.
- Анализ влияния изменений: прослеживание изменения через модель, что в линейке продуктов включает вопрос о том, каких продуктов оно касается.
- Варианты и конфигурации SysML v2: точки вариативности, варианты и конфигурации в текстовой нотации.