Посібник · Практика MBSE
Інженерія лінійок продуктів і керування варіантами в MBSE
Більшість систем створюють у кількох версіях. Інженерія лінійок продуктів моделює спільний проєкт один раз і свідомо керує відмінностями: модель характеристик визначає, що може змінюватися, конфігурації — що вибрав кожен продукт, а кожна вимога, компонент і тест — до яких продуктів вони належать. Цей посібник пояснює метод (модель 150%, моделі характеристик, допустимі конфігурації, застосовність, а також документи, верифікацію й базові лінії для кожного продукту), а потім розбирає його на прикладі CubeSat, створеного у двох версіях.
На цій сторінці
- Що таке інженерія лінійок продуктів
- Модель 150%
- Моделі характеристик
- Конфігурації та їхня допустимість
- Прив’язка варіативності до моделі
- Параметри для кожної конфігурації
- Застосовність за серійним номером і датою
- Документи, верифікація та базові лінії для кожної конфігурації
- Типові помилки
- Практичний приклад: EO-1 Flight і EO-1 Lite
- Лінійки продуктів у Holarch
- Поширені запитання
- Спробуйте в Holarch
- Вправа: знайдіть і виправте чотири помилки лінійки продуктів
- Куди далі
Що таке інженерія лінійок продуктів
Лінійка продуктів — це сімейство продуктів, які мають здебільшого спільний проєкт і відрізняються в кількох відомих точках. Космічний апарат стартового замовника та дешевша комерційна версія, транспортний засіб із трьома розмірами акумулятора, радар із внутрішнім і експортним варіантами, блокові оновлення наземної станції: кожне з них — один проєкт із варіантами. Інженерія лінійок продуктів (PLE) — це дисципліна створення та підтримки такого сімейства як одного інженерного активу, а не набору окремих проєктів.
Альтернатива — клонувати й володіти: скопіювати модель, документи та плани випробувань першого продукту, а потім редагувати копію для другого. Спочатку це швидко, а згодом дорого. Кожне виправлення доводиться вносити в кожну копію, ніхто не може сказати, які відмінності навмисні, і копії розходяться.
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 GB в одному продукті й 1 GB в іншому, маса, результат тесту).
Третю відмінність, час (які одиниці або дати виготовлення), обробляють за допомогою застосовності.
Моделі характеристик
Характеристика — це властивість продукту, яку може вибрати замовник, ринок або інженерне рішення: «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-діапазону, без шифрування, без рушійної установки». Конфігурація — це те, що купує замовник, для чого пишуть специфікацію, що верифікує кампанія випробувань і що фіксує базова лінія.
Ефективний вибір конфігурації ширший за характеристики, які хтось позначив. Він також охоплює батьківські характеристики кожної вибраної, обов’язкові дочірні характеристики кожної вибраної та обов’язкові характеристики кореня. Тому елемент, прив’язаний до батьківської характеристики, є в кожному продукті, що вибрав будь-яку з її дочірніх.
Конфігурація коректна, коли її ефективний вибір дотримується кожного правила моделі характеристик. Перевірка кожної конфігурації дає одну з трьох відповідей:
- Коректна: кожне правило виконується.
- Порушує правило: наприклад, продукт вибрав шифрування без радіостанції X-діапазону, якої воно потребує.
- Неповна: бракує вибору, наприклад немає діапазону низхідної лінії в групі «вибрати одну».
Коректність — найдешевша перевірка в PLE: некоректна конфігурація — це продукт, який неможливо побудувати за специфікацією, і його виявляють під час визначення, а не під час інтеграції. Перевіряйте й модель характеристик: характеристика, яку не вибирає жодна конфігурація, — це або майбутній варіант, або баласт.
Кількість можливих конфігурацій швидко зростає: десять незалежних необов’язкових характеристик дають 1,024 комбінації. Реальні лінійки продуктів свідомо визначають кілька конфігурацій, а решту простору вважають такою, що не пропонується.
Прив’язка варіативності до моделі
Модель характеристик визначає, що може змінюватися. Прив’язка визначає, які елементи моделі від яких виборів залежать. Кожен змінний елемент має умову наявності: логічний вираз над характеристиками (і, рідко, конфігураціями), істинний для продуктів, що містять елемент. Елементи без неї є в кожному продукті, і в добре побудованій лінійці продуктів це більша частина моделі.
Прив’язка має охоплювати кожен вид елементів, інакше подання 100% будуть несумісними:
- Вимоги: вимогу, яку запросили лише деякі замовники, прив’язують до вибраної ними характеристики. Вимогу, яку має кожен продукт, але з іншим значенням, не прив’язують; натомість вона отримує значення для кожної конфігурації.
- Функції: зазвичай спільні; функція змінюється, лише коли продукт робить те, чого не роблять інші.
- Компоненти та інтерфейси: радіостанцію X-діапазону, її інтерфейс даних і радіолінію прив’язують до тієї самої характеристики. Інтерфейс, два кінці якого ніколи не опиняються в одному продукті, — це помилка прив’язки.
- Тести та верифікація: тест лінії X-діапазону належить лише до продуктів із радіостанцією X-діапазону. Тест, який виконують обидва продукти, лишається спільним і записує окремий результат для кожного продукту.
- Зв’язки: зв’язок satisfies або verifies зазвичай слідує за своїми кінцями. Прив’язуйте зв’язок окремо, лише коли обидва його кінці разом є в кількох продуктах, але зв’язок діє лише в деяких.
Записуйте умови наявності через характеристики, а не конфігурації. «X-band Downlink» лишається правильною, коли додається третій продукт із радіостанцією X-діапазону; «EO-1 Flight» мовчки залишає новий продукт поза увагою. Називайте конфігурацію в умові лише для справді одноразового елемента, як-от етикетки конкретного замовника.
Параметри для кожної конфігурації
Багато відмінностей — це значення, а не наявність: обсяг даних, виділена маса, розрахунковий строк служби. Окрема вимога на продукт для кожного значення розмножила б елементи й розділила б їхні зв’язки.
Кращий шаблон — один елемент із базовим значенням і власним значенням для кожної конфігурації, де воно відрізняється. Елемент зберігає одну ідентичність (один номер, один набір зв’язків, одну історію), а подання кожного продукту показує його власне значення. Конфігурація без власного значення використовує базове.
Задавайте власне значення лише там, де значення справді відрізняється, щоб зміна базового й далі доходила до кожного іншого продукту. І перевіряйте текст навколо значення: обґрунтування, порогові значення тестів і похідні вимоги часто цитують число, і кожна така цитата потребує того самого підходу, інакше подання продукту суперечить саме собі. У практичному прикладі є один такий випадок.
Застосовність за серійним номером і датою
Застосовність визначає, з якої одиниці або дати виготовлення застосовується елемент. Вона відповідає на інше запитання, ніж умова наявності:
| Умова наявності («Застосовується до») | Застосовність | |
|---|---|---|
| Запитання | Які продукти містять елемент? | До яких одиниць або дат виготовлення він застосовується? |
| Записується як | Вираз над характеристиками та конфігураціями | Діапазони серійних номерів, як-от 1-20, 25, 40-, і діапазон дат |
| Типове використання | Опції, варіанти, вибір замовника | Заміни складників під час виробництва, блокові оновлення, модернізації |
| Порожнє означає | Кожен продукт | Кожна одиниця, завжди |
Обидва поєднуються: елемент потрапляє в подання, коли він належить до продукту і діє для одиниці чи дати, яку розглядають. Заміну складника починаючи із серійного номера 2 моделюють як два елементи: старий складник із застосовністю «SN 1» і новий — із «SN 2 and later», обидва з тією самою умовою наявності. Так обидва варіанти конструкції лишаються в моделі, і запис фактичної конфігурації одиниці 1 лишається точним після зміни одиниці 2.
Конфігурація має власну застосовність: серійні номери, виготовлені за нею. Вона фіксує, яка одиниця є яким продуктом; вона не фільтрує елементи. Дві конфігурації, діапазони серійних номерів яких перетинаються, зазвичай свідчать про помилку нумерації.
Документи, верифікація та базові лінії для кожної конфігурації
Сенс моделі 150% у тому, що кожен продукт однаково отримує все, що мав би проєкт одного продукту:
- Документи для кожної конфігурації. Специфікація, згенерована для одного продукту, пропускає розділи, що до нього не стосуються, показує значення цього продукту й зазначає на титульній сторінці, яку конфігурацію (і, якщо доречно, який серійний номер чи дату) вона описує. Номери розділів у такому документі — це номери подання: вони закривають прогалини від вилучених розділів, а збережені номери в моделі лишаються однаковими для кожного продукту.
- Верифікація для кожної конфігурації. «Верифіковано» означає верифіковано для одного продукту. Вимогу, спільну для двох продуктів, може бути верифіковано для одного й ще не закрито для іншого, тож результати записують для кожної конфігурації, а матрицю верифікації читають для кожної конфігурації.
- Базові лінії для кожної конфігурації. Рецензування проєкту продукту фіксує цей продукт. Базова лінія конфігурації записує всю лінійку продуктів із позначкою конфігурації, що рецензується, тож її можна порівняти з пізнішим станом того самого продукту або з іншим продуктом у той самий момент.
- Керування змінами для кожної конфігурації. Запит на зміну має вказувати, які продукти він змінює. Зміна спільного елемента змінює кожен продукт; зміна власного значення однієї конфігурації змінює лише її.
Типові помилки
| Помилка | Що йде не так | Краще |
|---|---|---|
| «Клонувати й володіти» як тимчасове рішення | Копія стає постійною; виправлення доходять до одного продукту, але не до іншого. | Почніть другий продукт як конфігурацію першої моделі. |
| Характеристики, названі за документами чи складниками | Модель характеристик перетворюється на перелік складників, і кожна зміна проєкту її переписує. | Називайте характеристики за видимими замовникові виборами; нехай прив’язка зіставляє їх зі складниками. |
| Умови наявності, що називають конфігурації | Новий продукт мовчки втрачає елементи, прив’язані до «CFG-1». | Прив’язуйте до характеристик; називайте конфігурацію лише для одноразових елементів. |
| Копії замість власних значень | Дві вимоги «Daily Data Volume», кожна з половиною зв’язків. | Одна вимога з базовим значенням і власним значенням для кожної конфігурації. |
| Застарілі процитовані значення | Обґрунтування чи поріг досі цитує базове значення в продукті, що має власне. | Рецензуйте подання кожного продукту, а не лише модель 150%. |
| Правила поза моделлю | Конфігурація, яку неможливо побудувати, проходить рецензування. | Записуйте «потребує», «виключає» та обмеження в модель характеристик; перевіряйте кожну конфігурацію. |
| Непослідовно прив’язані інтерфейси | Інтерфейс, кінці якого ніколи не опиняються в одному продукті, або компонент без свого інтерфейсу. | Прив’язуйте компонент, його інтерфейси й тести до тієї самої характеристики; запускайте перевірки узгодженості. |
| Верифікація, зарахована для всієї лінійки | Вимога показує «верифіковано», бо один продукт пройшов. | Читайте матрицю верифікації для кожної конфігурації. |
Практичний приклад: EO-1 Flight і EO-1 Lite
Приклад — EO-1, вигаданий 6U CubeSat, що знімає сільськогосподарські угіддя, змодельований у 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 GHz при 10 Mbps через партнерську наземну мережу. | ||
| F-3 X-band Downlink | Необов’язкова (дочірня до F-1) | 8 GHz при 100 Mbps, для доставки повних сцен за той самий проліт. | ||
| F-4 Encrypted Downlink | Необов’язкова | потребує F-3 | Дані корисного навантаження шифруються під час передавання. | |
| F-5 Propulsion | Необов’язкова | потребує F-3 | Газовий двигун на холодному газі для підтримання орбіти. Він уміщується лише поруч із радіостанцією X-діапазону. Досліджено; жоден продукт поки його не має. |
Група «вибрати одну» — серце моделі: дві радіостанції є альтернативами, тож жоден продукт не може мати обидві або жодної. Два правила «потребує» фіксують інженерні факти: шифрування виконується в модемі 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 Mbps 8-хвилинний проліт у S-діапазоні повертає 4.8 гігабіта, тобто 0.6 GB; для 3 GB потрібно п’ять прольотів на добу, а для 1 GB — два. При 100 Mbps один проліт у X-діапазоні повертає 6 GB, тому 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 s від їхніх міток, на flatsat FS-1) і Виконується в EO-1 Lite (надіслано 312 з 500 команд, на flatsat 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, зроблену для попереднього рецензування проєкту EO-1 Flight, у Контроль і рецензування → Базові лінії та версії. Вона записує всю лінійку продуктів із позначкою CFG-1 і створена командою Створити базову лінію конфігурації…. Порівняння з поточною моделлю за конфігурацією показує, що змінилося в EO-1 Flight після PDR, і нічого з того, що змінилося лише в EO-1 Lite.
CFG-1 має статус Випущено, а CFG-2 — досі Чернетка: продукт Lite ще визначається. Коли керування конфігурацією ввімкнено, конфігурація зі статусом «Випущено», що входить до останньої базової лінії, є контрольованою, тож її власні значення змінюються лише через запит на зміну. Картка Конфігурації запиту на зміну називає продукти, які він змінює, а Власник конфігурації має затверджувати запити, що її змінюють.
Що знаходять перевірки
Верифікація → Перевірки моделі виконує набір правил Лінійка продуктів у режимі «Усі конфігурації». Для EO-1 правила не повідомляють про помилки, а ProductLine.4 попереджає, що Propulsion не вибрано в жодній конфігурації. Тут це навмисно: F-5 — досліджений варіант, який зберігається в моделі характеристик, щоб правило «потребує 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-діапазон з Виключає для Propulsion, потім видаліть тестову конфігурацію. |
Чого перевірки не виявляють
- Правила перевіряються через конфігурації. Holarch перевіряє кожну конфігурацію щодо правил характеристик; він не аналізує правила самі по собі, тож суперечність лишається непоміченою, доки якась конфігурація не вибере характеристику. Тимчасова конфігурація в статусі «Чернетка» — спосіб перевірити нове правило.
- Перекриття застосовності визначається за серійним номером. ProductLine.7 порівнює серійні номери конфігурацій. Про дві конфігурації, дати виготовлення яких перекриваються, не повідомляється.
- Випущена конфігурація не захищена від змін правил. Коли керування конфігурацією ввімкнено, конфігурація зі статусом «Випущено», що входить до останньої базової лінії, змінює свій вибір і значення лише через запит на зміну. Правила характеристик, за якими її перевіряють, — окремі елементи, тож запускайте «Перевірити конфігурації» щоразу, коли зміна зачіпає характеристики.
- Прогалини верифікації для кожного продукту видно в RVTM. ProductLine.6 знаходить тест, прив’язаний так, що він ніколи не зустрічається зі своєю вимогою. Вимога, яка не має тестового випадку в одному продукті з іншої причини, проявляється в RVTM подання цього продукту, тож перед рецензуванням читайте її для кожної конфігурації.
Перш ніж завершити, запустіть перевірки ще раз: висновки мають знову бути «Коректна», а правила лінійки продуктів мають повідомляти лише попередження ProductLine.4 для Propulsion, яке демо має навмисно.
Куди далі
- Лінійка продуктів EO-1 у Docs: той самий приклад як покроковий огляд застосунку.
- Приклад аналізу компромісів: рішення «S-діапазон чи X-діапазон», на яке одна лінійка продуктів відповідає двічі.
- Матриця верифікації вимог: методи, результати та підсумовування статусів — основа верифікації для кожної конфігурації.
- Аналіз впливу змін: простеження зміни крізь модель, що в лінійці продуктів включає запитання, до яких продуктів вона доходить.
- Варіанти та конфігурації SysML v2: точки варіації, варіанти та конфігурації в текстовій нотації.