Holarch

Руководство · Практика MBSE

Инженерия линеек продуктов и управление вариантами в MBSE

Большинство систем выпускается более чем в одной версии. Инженерия линеек продуктов моделирует общий проект один раз и сознательно управляет различиями: модель характеристик говорит, что может меняться, конфигурации — что выбрал каждый продукт, а каждое требование, компонент и тест — к каким продуктам оно относится. В этом руководстве объясняется метод (модель 150 %, модели характеристик, допустимые конфигурации, применимость, а также документы, верификация и базовые линии для каждого продукта), а затем он разбирается на CubeSat, выпускаемом в двух версиях.

На этой странице
  1. Что такое инженерия линеек продуктов
    1. Когда линейка продуктов окупается
  2. Модель 150 %
  3. Модели характеристик
  4. Конфигурации и их допустимость
  5. Привязка вариативности к модели
  6. Параметры для каждой конфигурации
  7. Применимость по серийному номеру и дате
  8. Документы, верификация и базовые линии для каждой конфигурации
  9. Типичные ошибки
  10. Разобранный пример: EO-1 Flight и EO-1 Lite
    1. Модель характеристик
    2. Две конфигурации и их вердикты
    3. Что к какому продукту относится
    4. Значение, которое различается: 5.4 Daily Data Volume
    5. Замена детали по серийному номеру
    6. Верификация для каждого продукта
    7. Одна спецификация на продукт
    8. Базовая линия PDR для EO-1 Flight
    9. Что находят проверки
  11. Линейки продуктов в Holarch
    1. Вариативность в SysML v2
  12. Часто задаваемые вопросы
    1. Что такое модель 150 %?
    2. Чем вариант отличается от версии?
    3. Когда использовать применимость вместо характеристики?
  13. Попробуйте в Holarch
  14. Упражнение: найдите и исправьте четыре ошибки линейки продуктов
    1. Внесите ошибки
    2. Найдите их как рецензент
    3. Чего проверки не обнаруживают
  15. Что дальше

Что такое инженерия линеек продуктов

Линейка продуктов — это семейство продуктов, у которых большая часть проекта общая и которые различаются в нескольких известных точках. Аппарат для стартового заказчика и более дешёвая коммерческая версия, автомобиль с тремя вариантами ёмкости батареи, радар во внутреннем и экспортном исполнении, блочные модернизации наземной станции: каждый случай — один проект с вариантами. Инженерия линеек продуктов (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–2F-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 Downlink1.5.2 S-band Transmitter; требование 5.1 S-band Downlink RateEO-1 Lite
F-3 X-band Downlink1.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 TestEO-1 Flight
F-4 Encrypted DownlinkТребование 4.4 Downlink EncryptionEO-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

  1. Создайте демо через Управление проектами → Файлы проекта ▾ → Новый демо-проект → CubeSat (пошаговая системная инженерия).
  2. Откройте Управление и рецензирование → Линейка продуктов. Прочитайте дерево характеристик и два столбца конфигураций; оба вердикта — Допустимо.
  3. В столбце CFG-2 EO-1 Lite отметьте Encrypted Downlink. Прочитайте вердикт, затем нажмите ⌘Z / Ctrl+Z.
  4. Откройте требование 4.4 Downlink Encryption и посмотрите на группу Линейка продуктов в инспекторе: «Применяется к» равно F-4, а строка под ним называет единственную конфигурацию, к которой оно относится.
  5. Выберите Просмотреть как ▾ → CFG-2 EO-1 Lite. Откройте 5.4 Daily Data Volume и найдите метку Значение CFG-2; затем откройте 5.1 S-band Downlink Rate и сопоставьте с ним его обоснование.
  6. Откройте Верификация → RVTM в том же представлении, затем нажмите Выйти на баннере и сравните группу столбцов Конфигурация в режиме «Все конфигурации».
  7. Откройте 1.3.2 Battery Pack и две его характеристики нагревателя. Выберите Просмотреть как ▾ → Применимость ▸ → Серийный номер… и введите 1, затем 2.
  8. Откройте SRS-001, выберите Поставка ▾ → Спецификация (Word), задайте Конфигурация = CFG-2 EO-1 Lite и экспортируйте.
  9. Откройте Верификация → Проверки модели в режиме «Все конфигурации» и найдите предупреждение ProductLine.4 для Propulsion.

Для линеек продуктов нужен тариф Individual или Team; для базовой линии конфигурации и владельцев конфигураций — Team. Полный справочник — в разделе Линейки продуктов и конфигурации, включая «Применяется к», редактирование в представлении конфигурации, применимость и документы, RVTM и верификацию.

Упражнение: найдите и исправьте четыре ошибки линейки продуктов

Линейка продуктов редко ломается сразу. Она ломается из-за мелких правок, каждая из которых выглядит разумной: правило, добавленное в спешке, диапазон серийных номеров, введённый на единицу меньше, тест, привязанный не к той характеристике, изменение правила, которое незаметно ломает уже выпущенный продукт. В этом упражнении в линейку продуктов EO-1 закладываются четыре таких дефекта, а вы находите каждый с помощью проверок, которые выполнил бы рецензент, и исправляете его. Упражнение также показывает, где проверки заканчиваются: знание того, чего инструмент не проверяет, — часть умения им пользоваться.

Вам понадобятся: свежая копия демо CubeSat EO-1 и тариф с линейками продуктов (Individual или Team либо академическая или учебная учётная запись; в тарифе Free страница «Линейка продуктов» доступна только для чтения). По возможности работайте в паре: один закладывает дефекты, пока другой не смотрит, затем другой их находит. Если вы одни, заложите все четыре, закройте проект и вернитесь к нему в роли рецензента.

Внесите ошибки

  1. Противоречивые правила характеристик. Откройте Управление и рецензирование → Линейка продуктов. В меню ⋯ строки F-5 Propulsion выберите Правила…, отметьте F-3 X-band Downlink в разделе Исключает и нажмите Применить. Теперь Propulsion одновременно требует и исключает канал X-диапазона.
  2. Перекрывающаяся применимость. В меню ⋯ столбца CFG-2 EO-1 Lite выберите Применимость… и измените Серийные номера с 3- на 2-, как будто сборку Lite перенесли на один экземпляр раньше.
  3. Отсутствующая верификация для одной конфигурации. Откройте тестовый случай TC-10 S-band Link Test и в группе Линейка продуктов инспектора задайте Применяется к = F-3, как будто тест канала относится к радио X-диапазона.
  4. Изменение, делающее выпущенную конфигурацию недопустимой. Вернувшись на страницу «Линейка продуктов», откройте Правила… для 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, которое в демо оставлено намеренно.

Что дальше