Holarch

Guida · Pratica MBSE

Ingegneria delle linee di prodotti e gestione delle varianti nell’MBSE

La maggior parte dei sistemi viene costruita in più di una versione. L’ingegneria delle linee di prodotti modella una sola volta il progetto comune e gestisce le differenze in modo deliberato: un modello delle funzionalità dice che cosa può variare, le configurazioni dicono che cosa ha scelto ciascun prodotto, e ogni requisito, componente e test dice a quali prodotti appartiene. Questa guida spiega il metodo (il modello al 150%, i modelli delle funzionalità, le configurazioni valide, l’applicabilità, e documenti, verifica e baseline per prodotto), poi lo applica a un CubeSat costruito in due versioni.

In questa pagina
  1. Che cos’è l’ingegneria delle linee di prodotti
    1. Quando una linea di prodotti conviene
  2. Il modello al 150%
  3. Modelli delle funzionalità
  4. Le configurazioni e la loro validità
  5. Collegare la variabilità al modello
  6. Parametri per configurazione
  7. Applicabilità per numero di serie e data
  8. Documenti, verifica e baseline per configurazione
  9. Errori comuni
  10. Esempio svolto: EO-1 Flight ed EO-1 Lite
    1. Il modello delle funzionalità
    2. Le due configurazioni e i loro verdetti
    3. Che cosa appartiene a quale prodotto
    4. Un valore che cambia: 5.4 Daily Data Volume
    5. Una modifica di parte per numero di serie
    6. Verifica per prodotto
    7. Una specifica per prodotto
    8. La baseline PDR di EO-1 Flight
    9. Che cosa trovano i controlli
  11. Linee di prodotti in Holarch
    1. Variabilità in SysML v2
  12. Domande frequenti
    1. Che cos’è un modello al 150%?
    2. Qual è la differenza tra una variante e una versione?
    3. Quando conviene usare l’applicabilità invece di una funzionalità?
  13. Provarlo in Holarch
  14. Esercizio: trovare e correggere quattro errori della linea di prodotti
    1. Introdurre gli errori
    2. Trovarli come revisore
    3. Che cosa i controlli non rilevano
  15. Dove andare dopo

Che cos’è l’ingegneria delle linee di prodotti

Una linea di prodotti è una famiglia di prodotti che condividono la maggior parte di un unico progetto e differiscono in pochi punti noti. Il veicolo spaziale di un cliente di lancio e una versione commerciale più economica, un veicolo venduto con tre taglie di batteria, un radar con una variante nazionale e una per l’esportazione, gli aggiornamenti a blocchi di una stazione di terra: ciascuno è un unico progetto con varianti. L’ingegneria delle linee di prodotti (PLE) è la disciplina che costruisce e mantiene quella famiglia come un unico bene ingegnerizzato anziché come un insieme di progetti separati.

L’alternativa è il clone and own: copiare il modello, i documenti e i piani di test del primo prodotto, poi modificare la copia per il secondo prodotto. All’inizio è rapido, in seguito costoso. Ogni correzione va fatta in ogni copia, nessuno sa dire quali differenze siano volute, e le copie si allontanano l’una dall’altra.

La PLE sostituisce le copie con tre elementi:

  • Un unico modello condiviso che contiene ogni requisito, funzione, componente, interfaccia e test di ogni prodotto.
  • Una descrizione esplicita della variabilità: le scelte che differiscono tra i prodotti e le regole che le legano.
  • Un collegamento da ogni elemento variabile alle scelte da cui dipende, così che qualsiasi prodotto possa essere derivato dal modello condiviso su richiesta.

La ISO/IEC 26550 descrive un modello di riferimento per l’ingegneria delle linee di prodotti software e di sistema. Separa l’ingegneria di dominio, il lavoro sugli asset condivisi e sulla loro variabilità, dall’ingegneria applicativa, il lavoro di derivazione e consegna di un prodotto a partire da essi. La ISO/IEC 26580 aggiunge metodi e capacità degli strumenti per la forma di PLE basata sulle funzionalità seguita da questa guida. Le varianti di prodotto rientrano anche nella gestione della configurazione: la ISO/IEC/IEEE 15288 include l’identificazione della configurazione e le baseline nel suo processo di gestione della configurazione, e la SAE EIA-649 tratta l’applicabilità, cioè le unità a cui si applica una configurazione, come parte dell’identificazione della configurazione.

Quando una linea di prodotti conviene

La PLE ha un costo di avvio: un modello delle funzionalità da concordare e un collegamento da mantenere. Conviene quando:

  • due o più prodotti condividono la maggior parte di requisiti, funzioni e architettura;
  • una modifica alla parte comune deve raggiungere ogni prodotto;
  • ogni prodotto ha comunque bisogno della propria specifica, della propria registrazione di verifica e delle proprie baseline;
  • sono previste nuove varianti, quindi le differenze vanno descritte una volta e riutilizzate.

Non conviene per un singolo prodotto che cambia nel tempo: le unità costruite in sequenza con modifiche di parti richiedono solo l’applicabilità.

Il modello al 150%

Il modello condiviso di una linea di prodotti è spesso chiamato modello al 150%. Contiene l’unione di tutti i prodotti: entrambe le radio quando un prodotto ha una radio in banda S e un altro una radio in banda X, il modulo di propulsione che alcuni prodotti possono montare, il requisito di cifratura chiesto da un solo cliente.

Ogni prodotto ne è una vista al 100%: gli elementi che appartengono a quel prodotto, con i suoi valori, derivati anziché copiati. Ciò conferisce al metodo la sua proprietà principale: una modifica a un elemento condiviso si fa una sola volta ed è subito presente in ogni prodotto, mentre una modifica a un elemento variabile raggiunge solo i prodotti a cui appartiene.

Nel modello al 150% vanno rappresentati due tipi di differenza:

  • Presenza: un elemento è presente in alcuni prodotti e non in altri (la radio in banda X, il requisito di cifratura, il test del collegamento in banda X).
  • Valore: un elemento è presente in ogni prodotto ma con un valore diverso in alcuni (un volume di dati giornaliero di 3 GB in un prodotto e di 1 GB in un altro, una massa, un risultato di test).

Un terzo tipo di differenza, il tempo (quali unità o quali date di costruzione), si gestisce con l’applicabilità.

Modelli delle funzionalità

Una funzionalità è una caratteristica del prodotto che un cliente, un mercato o una decisione ingegneristica può scegliere: «X-band Downlink», «Encrypted Downlink», «Propulsion». Un modello delle funzionalità dispone le funzionalità in un albero e aggiunge le regole che stabiliscono quali combinazioni sono ammesse. La notazione risale alla feature-oriented domain analysis (FODA) dei primi anni ’90 ed è oggi il modo più diffuso per descrivere la variabilità nelle linee di prodotti.

Ogni funzionalità, e ogni gruppo di funzionalità figlie, porta una regola tra un piccolo insieme:

RegolaSignificatoEsempio
ObbligatoriaOgni prodotto che ha la funzionalità padre ha anche questa.Ogni veicolo spaziale ha un downlink.
FacoltativaScelta per ciascun prodotto.Cifratura, propulsione.
Alternativa (sceglierne una)Esattamente un figlio del gruppo per prodotto.Il downlink è in banda S o in banda X, mai entrambe e mai nessuna delle due.
Oppure (sceglierne almeno una)Uno o più figli per prodotto.Una suite di sensori nel visibile, nell’infrarosso o in entrambi.
RichiedeScegliere questa funzionalità ne impone un’altra.La cifratura richiede la radio in banda X, il cui modem la supporta.
EscludeLe due funzionalità non compaiono mai insieme.Un’antenna dispiegabile esclude l’opzione di volume compatto.
VincoloQualsiasi altra condizione, scritta come espressione logica sulle funzionalità.Propulsione e non la batteria piccola.

Dare alle funzionalità il nome del prodotto, non dei documenti o delle parti: «X-band Downlink», non «Sezione 5 opzione B» o «Radio P/N 4471». Una funzionalità corrisponde di solito a più componenti, requisiti e test; tenere separati l’albero delle funzionalità e l’albero dei componenti e lasciare che il collegamento li unisca. Scrivere ogni regola nel modello non appena è nota.

Le configurazioni e la loro validità

Una configurazione è un prodotto: una selezione di funzionalità con un nome, come «EO-1 Lite: downlink in banda S, nessuna cifratura, nessuna propulsione». La configurazione è ciò che un cliente acquista, ciò per cui si scrive una specifica, ciò che una campagna di test verifica e ciò che una baseline congela.

La selezione effettiva di una configurazione è più ampia delle funzionalità spuntate da qualcuno. Include anche i padri di ogni funzionalità scelta, i figli obbligatori di ogni funzionalità scelta e le funzionalità obbligatorie alla radice. Un elemento collegato a una funzionalità padre è quindi presente in ogni prodotto che ha scelto uno qualsiasi dei suoi figli.

Una configurazione è valida quando la sua selezione effettiva rispetta ogni regola del modello delle funzionalità. Il controllo di ogni configurazione dà una di tre risposte:

  • Valida: ogni regola è rispettata.
  • Viola una regola: per esempio, un prodotto ha scelto la cifratura senza la radio in banda X che essa richiede.
  • Incompleta: manca una scelta, per esempio nessuna banda di downlink in un gruppo a scelta singola.

La validità è il controllo più economico della PLE: una configurazione non valida è un prodotto che non può essere costruito come specificato, scoperto nel momento in cui viene definito anziché all’integrazione. Controllare anche il modello delle funzionalità: una funzionalità che nessuna configurazione seleziona è un’opzione futura o un peso morto.

Il numero di configurazioni possibili cresce rapidamente: dieci funzionalità facoltative indipendenti consentono 1.024 combinazioni. Le linee di prodotti reali definiscono deliberatamente una manciata di configurazioni e trattano il resto dello spazio come non offerto.

Collegare la variabilità al modello

Il modello delle funzionalità dice che cosa può variare. Il collegamento dice quali elementi del modello dipendono da quali scelte. Ogni elemento variabile porta una condizione di presenza: un’espressione logica sulle funzionalità (e, raramente, sulle configurazioni) che è vera per i prodotti che includono l’elemento. Gli elementi che non ne hanno una sono presenti in ogni prodotto, e in una linea di prodotti ben costruita costituiscono la maggior parte del modello.

Il collegamento deve coprire ogni tipo di elemento, altrimenti le viste al 100% risulteranno incoerenti:

  • Requisiti: un requisito chiesto solo da alcuni clienti è collegato alla funzionalità che hanno scelto. Un requisito presente in ogni prodotto, ma con un valore diverso, non è collegato; riceve invece un valore per configurazione.
  • Funzioni: di solito condivise; una varia solo quando un prodotto fa qualcosa che gli altri non fanno.
  • Componenti e interfacce: la radio in banda X, la sua interfaccia dati e il suo collegamento RF sono tutti collegati alla stessa funzionalità. Un’interfaccia le cui due estremità non si trovano mai nello stesso prodotto è un errore di collegamento.
  • Test e verifica: un test del collegamento in banda X appartiene solo ai prodotti con la radio in banda X. Un test eseguito da entrambi i prodotti resta condiviso e registra un risultato per prodotto.
  • Relazioni: un collegamento satisfies o verifies segue di solito le sue estremità. Collegare separatamente una relazione solo quando le sue due estremità si trovano insieme in più prodotti ma il collegamento vale solo in alcuni.

Scrivere le condizioni di presenza in termini di funzionalità, non di configurazioni. «X-band Downlink» resta corretta quando si aggiunge un terzo prodotto con radio in banda X; «EO-1 Flight» esclude silenziosamente il nuovo prodotto. Nominare una configurazione in una condizione solo per un elemento davvero isolato, come un’etichetta specifica di un cliente.

Parametri per configurazione

Molte differenze sono valori, non presenze: un volume di dati, un’allocazione di massa, una vita di progetto. Un requisito separato per prodotto per ogni valore moltiplicherebbe gli elementi e ne dividerebbe i collegamenti.

Lo schema migliore è un solo elemento con un valore base e un valore proprio per configurazione dove differisce. L’elemento mantiene un’unica identità (un numero, un insieme di collegamenti, una cronologia), e la vista di ogni prodotto mostra il proprio valore. Una configurazione senza valore proprio usa il valore base.

Assegnare un valore proprio solo dove il valore differisce davvero, così che una modifica al valore base raggiunga ancora ogni altro prodotto. E controllare il testo attorno al valore: motivazioni, soglie di test e requisiti derivati citano spesso il numero, e ogni citazione richiede lo stesso trattamento, altrimenti la vista del prodotto si contraddice. L’esempio svolto ne contiene uno.

Applicabilità per numero di serie e data

L’applicabilità dice da quale unità o da quale data di costruzione si applica un elemento. Risponde a una domanda diversa dalla condizione di presenza:

Condizione di presenza (Si applica a)Applicabilità
DomandaQuali prodotti includono l’elemento?A quali unità, o a quali date di costruzione, si applica?
Si scrive comeUn’espressione su funzionalità e configurazioniIntervalli di numeri di serie come 1-20, 25, 40-, e un intervallo di date
Uso tipicoOpzioni, varianti, scelte del clienteModifiche di parti durante la produzione, aggiornamenti a blocchi, retrofit
Vuota significaOgni prodottoOgni unità, sempre

Le due si combinano: un elemento è in una vista quando appartiene al prodotto ed è in vigore per l’unità o la data considerata. Una modifica di parte a partire dal numero di serie 2 si modella come due elementi, la vecchia parte con applicabilità «SN 1» e la nuova con «SN 2 e successivi», entrambi con la stessa condizione di presenza. Così entrambi i progetti restano nel modello, e la registrazione as-built dell’unità 1 resta accurata dopo la modifica dell’unità 2.

Una configurazione ha una propria applicabilità: i numeri di serie costruiti secondo essa. Registra quali unità corrispondono a quale prodotto; non filtra gli elementi. Due configurazioni i cui intervalli di numeri di serie si sovrappongono indicano di solito un errore di numerazione.

Documenti, verifica e baseline per configurazione

Il senso del modello al 150% è che ogni prodotto ottiene comunque tutto ciò che avrebbe un progetto a prodotto singolo:

  • Documenti per configurazione. Una specifica generata per un prodotto omette le sezioni che non si applicano, mostra i valori di quel prodotto e indica sul frontespizio quale configurazione (e, se pertinente, quale numero di serie o data) descrive. In un documento del genere i numeri di sezione sono numeri di vista: chiudono i vuoti lasciati dalle sezioni rimosse, mentre i numeri memorizzati nel modello restano gli stessi per ogni prodotto.
  • Verifica per configurazione. «Verificato» significa verificato per un prodotto. Un requisito condiviso da due prodotti può essere verificato per uno e ancora aperto per l’altro, quindi i risultati si registrano per configurazione e la matrice di verifica si legge per configurazione.
  • Baseline per configurazione. La revisione di progetto di un prodotto congela quel prodotto. Una baseline di configurazione registra l’intera linea di prodotti etichettata con la configurazione in revisione, così da poterla confrontare con uno stato successivo dello stesso prodotto o con un altro prodotto nello stesso momento.
  • Controllo delle modifiche per configurazione. Una richiesta di modifica dovrebbe indicare quali prodotti modifica. Una modifica a un elemento condiviso modifica ogni prodotto; una modifica al valore proprio di una configurazione modifica solo quella.

Errori comuni

ErroreCosa va stortoMeglio
Clone and own come soluzione temporaneaLa copia diventa permanente; le correzioni raggiungono un prodotto e non l’altro.Avviare il secondo prodotto come configurazione del primo modello.
Funzionalità con il nome di documenti o partiIl modello delle funzionalità diventa una distinta di parti, e ogni modifica di progetto lo riscrive.Dare alle funzionalità il nome di scelte visibili al cliente; lasciare che il collegamento le associ alle parti.
Condizioni di presenza che nominano configurazioniUn nuovo prodotto perde silenziosamente gli elementi collegati a «CFG-1».Collegare alle funzionalità; nominare una configurazione solo per elementi isolati.
Copie invece di valori propriDue requisiti «Daily Data Volume», ciascuno con metà dei collegamenti.Un solo requisito con un valore base e un valore proprio per configurazione.
Valori citati non aggiornatiUna motivazione o una soglia cita ancora il valore base in un prodotto che ne ha uno proprio.Rivedere la vista di ogni prodotto, non solo il modello al 150%.
Regole tenute fuori dal modelloUna configurazione che non può essere costruita supera la revisione.Scrivere richiede, esclude e i vincoli nel modello delle funzionalità; controllare ogni configurazione.
Interfacce collegate in modo incoerenteUn’interfaccia le cui estremità non sono mai nello stesso prodotto, o un componente senza la sua interfaccia.Collegare un componente, le sue interfacce e i suoi test alla stessa funzionalità; eseguire i controlli di coerenza.
Verifica conteggiata per la lineaUn requisito risulta «verificato» perché un prodotto ha superato il test.Leggere la matrice di verifica per configurazione.

Esempio svolto: EO-1 Flight ed EO-1 Lite

L’esempio è EO-1, un CubeSat 6U fittizio che riprende terreni agricoli, modellato in Holarch come progetto LML. È lo stesso modello dell’esempio MBSE completo. La demo costruisce EO-1 come due prodotti:

  • EO-1 Flight, il veicolo spaziale per il cliente di lancio, il cui contratto chiede scene complete consegnate in un solo passaggio e cifrate durante la trasmissione;
  • EO-1 Lite, un veicolo spaziale a costo inferiore per gli acquirenti commerciali di immagini, con il downlink in banda S del progetto originale.

La guida allo studio di trade-off confronta la banda S e la banda X per il downlink e sceglie la banda S per costo e supporto delle stazioni di terra. Quella decisione vale per il prodotto commerciale. La sua analisi di sensibilità ha mostrato che la banda X prevale quando la velocità dei dati pesa molto, che è il caso del cliente di lancio; una linea di prodotti conserva entrambe le risposte.

Il modello delle funzionalità

Nella pagina Controllo e revisioni → Linea di prodotti, EO-1 ha cinque funzionalità:

FunzionalitàTipoFigliRegoleSignificato
F-1 DownlinkObbligatoriaSceglierne unaOgni prodotto ha esattamente una banda di downlink.
F-2 S-band DownlinkFacoltativa (figlia di F-1)2,2 GHz a 10 Mbps tramite la rete di stazioni di terra del partner.
F-3 X-band DownlinkFacoltativa (figlia di F-1)8 GHz a 100 Mbps, per la consegna di scene complete nello stesso passaggio.
F-4 Encrypted DownlinkFacoltativarichiede F-3Dati del payload cifrati durante la trasmissione.
F-5 PropulsionFacoltativarichiede F-3Un propulsore a gas freddo per il mantenimento dell’orbita. Trova posto solo accanto alla radio in banda X. Studiato; nessun prodotto lo ha ancora.

Il gruppo a scelta singola è il cuore del modello: le due radio sono alternative, quindi nessun prodotto può averle entrambe o nessuna. Le due regole richiede registrano fatti ingegneristici: la cifratura avviene nel modem in banda X, e il propulsore trova posto solo nella disposizione che la radio in banda X lascia libera.

Le due configurazioni e i loro verdetti

ConfigurazioneStatoNumeri di serieSelezionaEsito
CFG-1 EO-1 FlightRilasciato1–2F-3 X-band Downlink, F-4 Encrypted DownlinkValida
CFG-2 EO-1 LiteBozza3 e successiviF-2 S-band DownlinkValida

Entrambe le configurazioni contengono anche F-1 Downlink, come funzionalità radice obbligatoria e come padre della banda scelta; la griglia la contrassegna come implicita. Per vedere le regole all’opera, spuntare Encrypted Downlink nella colonna CFG-2. L’esito diventa «Viola: Encrypted Downlink richiede X-band Downlink.» La cifratura sul prodotto Lite sarebbe una modifica di progetto, non una modifica di configurazione. Annullare la spunta con ⌘Z / Ctrl+Z.

Che cosa appartiene a quale prodotto

La maggior parte di EO-1 ha Si applica a vuoto: struttura, sistema di alimentazione, imager, collegamento di comando, software di volo e la maggior parte dei requisiti sono presenti in entrambi i prodotti. Gli elementi che differiscono sono collegati a funzionalità, mai a una configurazione:

Si applica aElementiPresente in
F-2 S-band Downlink1.5.2 S-band Transmitter; requisito 5.1 S-band Downlink RateEO-1 Lite
F-3 X-band Downlink1.5.3 X-band Payload Radio; interfacce IF-08.1 X-band Data Interface e IF-12.1 X-band Downlink; requisito 5.5 X-band Downlink Rate; caso di test TC-21 X-band Link TestEO-1 Flight
F-4 Encrypted DownlinkRequisito 4.4 Downlink EncryptionEO-1 Flight

La radio in banda X è collegata insieme a tutto ciò che ne dipende: le sue due interfacce, il requisito che soddisfa e il test che verifica quel requisito. Esegue inoltre la stessa operazione di downlink del trasmettitore in banda S, e in ogni prodotto è presente solo una delle due radio, quindi la funzione è condivisa mentre il suo esecutore varia.

Il collegamento non è completo, e una revisione della vista di EO-1 Flight mostra dove. Cercare «S-band» in quella vista: il requisito 5.3 Downlink Link Margin («The S-band downlink shall close with at least 3 dB link margin…»), il caso di test TC-10 S-band Link Test e l’interfaccia IF-12 S-band Downlink non hanno Si applica a, quindi sono presenti anche in EO-1 Flight, un prodotto senza radio in banda S. I Controlli del modello non possono vederlo: gli elementi sono coerenti come collegamenti, e solo il loro testo nomina la variante. Ognuno richiede una decisione: collegarlo a F-2 e aggiungere la controparte in banda X dove manca (5.3 non ne ha; IF-12.1 e TC-21 esistono già), oppure riformularlo in modo che valga per entrambe le bande. Cercare nella vista di ogni prodotto i nomi delle varianti che non possiede è un passo di revisione economico per qualsiasi linea di prodotti.

Poiché il collegamento usa le funzionalità, un futuro terzo prodotto con radio in banda X e senza cifratura riceverebbe automaticamente la radio, le sue interfacce e TC-21, e lascerebbe fuori 4.4.

Un valore che cambia: 5.4 Daily Data Volume

Il requisito 5.4 Daily Data Volume è presente in entrambi i prodotti, quindi non è collegato. Il suo testo base recita «The ground segment shall receive at least 3 GB of payload data each day.» Gli acquirenti commerciali di EO-1 Lite ne hanno bisogno di meno, quindi CFG-2 ha un valore proprio: «at least 1 GB». Scegliere Visualizza come ▾ → CFG-2 EO-1 Lite e aprire 5.4: la descrizione indica 1 GB e porta un chip Valore di CFG-2. In Tutte le configurazioni il campo è contrassegnato Varia. 5.4 mantiene un numero, un insieme di collegamenti e una cronologia.

I numeri alla base sono semplici. A 10 Mbps un passaggio in banda S di 8 minuti restituisce 4,8 gigabit, cioè 0,6 GB; 3 GB richiedono cinque passaggi al giorno e 1 GB ne richiede due. A 100 Mbps un passaggio in banda X restituisce 6 GB, ed è per questo che EO-1 Flight consegna un’intera giornata di scene in un solo passaggio.

Ora si osservi 5.1 S-band Downlink Rate, che si applica solo a EO-1 Lite. La sua motivazione recita «Clears one day of collection (3 GB, Req 5.4) in five 8 minute passes.» In EO-1 Lite, 5.4 chiede 1 GB, quindi la motivazione cita un valore che l’unico prodotto a cui appartiene non usa. La velocità in sé non ha nulla di sbagliato; è la giustificazione a non essere aggiornata. È il modo di guasto «valori citati non aggiornati» descritto sopra, e si trova solo leggendo la vista del prodotto stesso. La correzione consiste nel dare alla motivazione di 5.1 il ragionamento di Lite (due passaggi per 1 GB, con margine per i passaggi mancati), oppure nell’indicare il vero fattore che determina la velocità.

Una modifica di parte per numero di serie

Aprire 1.3.2 Battery Pack. Ha due caratteristiche del riscaldatore: Thermostat Heater Power (2 W, applicabilità SN 1) e Software-Controlled Heater Power (3 W, SN 2 e successivi). Il riscaldatore è cambiato a partire dal secondo veicolo spaziale. Entrambe sono presenti in ogni prodotto: la modifica riguarda le unità, non le opzioni.

Gli intervalli di numeri di serie sono il punto d’incontro dei due concetti. EO-1 Flight comprende i numeri di serie 1–2, quindi la modifica avviene all’interno di una sola configurazione: l’unità 1 vola con il riscaldatore a termostato, l’unità 2 con quello controllato dal software. EO-1 Lite parte dal numero di serie 3 e ha solo il nuovo riscaldatore. Con Visualizza come ▾ → Applicabilità ▸ → Numero di serie… impostato su 1, la vista mostra l’unità 1 così come è stata costruita; impostato su 2, mostra il secondo veicolo spaziale. Il nuovo riscaldatore assorbe 1 W in più, il tipo di valore che la guida all’impatto delle modifiche segue fino al budget di potenza.

Verifica per prodotto

Il caso di test TC-11 UHF Command Test viene eseguito su entrambi i prodotti e conserva un risultato per configurazione: Superato in EO-1 Flight (500 comandi su 500 entro 0,4 s dai loro tag, sul flatsat FS-1) e In corso in EO-1 Lite (312 comandi su 500 inviati, sul flatsat FS-3). I requisiti che verifica sono quindi verificati per un prodotto e aperti per l’altro.

Verifica → RVTM mostra entrambe le letture. In Tutte le configurazioni, un gruppo di colonne Configurazione riporta uno stato aggregato per configurazione, con «—» dove un requisito non si applica (5.5 X-band Downlink Rate non ha stato per EO-1 Lite). In una vista di configurazione la RVTM elenca solo i requisiti e i risultati di quel prodotto, quindi «verificato» significa verificato per quel prodotto. TC-21 X-band Link Test, ancora Non eseguito, compare solo nella matrice di EO-1 Flight.

Per registrare nuovi risultati per un prodotto, sceglierlo in Visualizza come ▾ e usare Esegui suite in Verifica → Centro test: viene indicato «Registrazione dei risultati per CFG-2.» e i risultati vengono salvati come valori di quella configurazione.

Una specifica per prodotto

I requisiti si trovano in un unico documento, SRS-001 EO-1 System Requirements Specification. Per consegnarlo per EO-1 Lite, aprirlo, scegliere Consegna ▾ → Specifica (Word), impostare Configurazione su CFG-2 EO-1 Lite e Applicabilità su Qualsiasi unità, ed esportare. La specifica di Lite omette 4.4 Downlink Encryption e 5.5 X-band Downlink Rate, mostra 5.4 con 1 GB e nomina la configurazione sul frontespizio, nel piè di pagina e nel nome del file.

La specifica di EO-1 Flight omette invece 5.1 S-band Downlink Rate, quindi i requisiti successivi nella sezione 5 hanno in quel documento un numero inferiore di uno, e il file riporta «Numerazione come mostrata in CFG-1.» I numeri del modello non cambiano, quindi una citazione del requisito di un prodotto dovrebbe indicare la configurazione insieme al numero.

Esportato con Tutte le configurazioni e Mostra applicabilità attivi, lo stesso documento è la specifica al 150%: ogni sezione, con «Si applica a: CFG-1» sotto le sezioni presenti solo in EO-1 Flight.

La baseline PDR di EO-1 Flight

La demo contiene la baseline di configurazione EO-1 Flight PDR, creata per la Preliminary Design Review di EO-1 Flight, in Controllo e revisioni → Baseline e versioni. Registra l’intera linea di prodotti etichettata con CFG-1, creata con Crea baseline di una configurazione…. Confrontarla per configurazione con il modello attuale mostra che cosa è cambiato in EO-1 Flight dalla PDR, e nulla di ciò che è cambiato solo in EO-1 Lite.

CFG-1 è Rilasciato e CFG-2 ancora Bozza: il prodotto Lite è ancora in fase di definizione. Con il controllo della configurazione attivo, una configurazione Rilasciata e presente nell’ultima baseline è controllata, quindi i suoi valori propri cambiano solo tramite una richiesta di modifica. La scheda Configurazioni di una richiesta di modifica nomina i prodotti che modifica, e il Proprietario di una configurazione deve approvare le richieste che la modificano.

Che cosa trovano i controlli

Verifica → Controlli del modello esegue l’insieme di regole Linea di prodotti in Tutte le configurazioni. Su EO-1 le regole non segnalano errori, e ProductLine.4 avverte che Propulsion non è selezionata da nessuna configurazione. Qui è voluto: F-5 è un’opzione studiata, conservata nel modello delle funzionalità perché la regola «richiede X-band Downlink» sia registrata prima che qualcuno la offra. In un programma reale l’avviso è un invito a decidere, registrando la decisione: offrirla, mantenerla come studio o eliminarla.

Linee di prodotti in Holarch

Holarch implementa il metodo in un unico modello: la pagina Linea di prodotti contiene l’albero delle funzionalità e le configurazioni con i loro esiti, il gruppo Linea di prodotti dell’ispettore contiene Si applica a e l’applicabilità, e Visualizza come ▾ mostra e modifica ogni pagina come una configurazione. Documenti, RVTM, Centro test, ricerca (appliesto:CFG-2, varies:yes) e Controlli del modello seguono la vista.

Le linee di prodotti fanno parte dei piani Individual e Team. Le baseline per configurazione, il confronto per configurazione, i proprietari delle configurazioni e le configurazioni modificate da una richiesta di modifica fanno parte del piano Team.

Variabilità in SysML v2

SysML v2 ha la variabilità nel linguaggio: una variation segna un punto in cui i prodotti differiscono, i suoi membri variant sono le scelte consentite, un assert constraint esclude combinazioni, e una configurazione è un uso che lega una variante a ogni punto. In un progetto SysML v2 Holarch legge questi elementi direttamente: la pagina Linea di prodotti mostra i punti di variazione e le configurazioni con un esito, e Visualizza come ▾ mostra il modello come una configurazione. L’esempio è CarLine della demo Hybrid Car, con i punti pack e charger e la regola wallboxNeedsLargePack. Vedere Varianti e configurazioni in SysML v2.

Domande frequenti

Che cos’è un modello al 150%?

Il modello condiviso di una linea di prodotti, che contiene l’unione degli elementi di tutti i prodotti. Ogni prodotto ne è una vista al 100%, derivata mantenendo gli elementi la cui condizione di presenza è vera per quel prodotto e mostrando i valori di quel prodotto. Il nome dice solo che il modello è più grande di qualsiasi singolo prodotto.

Qual è la differenza tra una variante e una versione?

Le varianti esistono una accanto all’altra: EO-1 Flight ed EO-1 Lite sono entrambi prodotti attuali. Le versioni si susseguono nel tempo: il progetto alla PDR, poi alla CDR. Le varianti si gestiscono con funzionalità e configurazioni, le versioni con le baseline, e le unità costruite nel tempo con l’applicabilità. Una baseline di configurazione combina le prime due.

Quando conviene usare l’applicabilità invece di una funzionalità?

Quando la differenza riguarda quali unità sono state costruite e quando, non ciò che ha scelto un cliente. Una parte cambiata a partire dal numero di serie 2 è applicabilità. Una parte che alcuni clienti ordinano e altri no è una funzionalità, anche se il primo cliente a ordinarla riceve per caso i numeri di serie successivi.

Provarlo in Holarch

  1. Creare la demo con Gestisci progetti → File di progetto ▾ → Nuovo progetto demo → CubeSat (ingegneria dei sistemi guidata).
  2. Aprire Controllo e revisioni → Linea di prodotti. Leggere l’albero delle funzionalità e le due colonne delle configurazioni; entrambi gli esiti indicano Valida.
  3. Nella colonna CFG-2 EO-1 Lite, spuntare Encrypted Downlink. Leggere l’esito, poi premere ⌘Z / Ctrl+Z.
  4. Aprire il requisito 4.4 Downlink Encryption e osservare il gruppo Linea di prodotti dell’ispettore: Si applica a è F-4, e la riga sottostante nomina l’unica configurazione a cui si applica.
  5. Scegliere Visualizza come ▾ → CFG-2 EO-1 Lite. Aprire 5.4 Daily Data Volume e trovare il chip Valore di CFG-2; poi aprire 5.1 S-band Downlink Rate e confrontarne la motivazione.
  6. Aprire Verifica → RVTM nella stessa vista, poi fare clic su Esci nel banner e confrontare il gruppo di colonne Configurazione in Tutte le configurazioni.
  7. Aprire 1.3.2 Battery Pack e le sue due caratteristiche del riscaldatore. Scegliere Visualizza come ▾ → Applicabilità ▸ → Numero di serie… e inserire 1, poi 2.
  8. Aprire SRS-001, scegliere Consegna ▾ → Specifica (Word), impostare Configurazione su CFG-2 EO-1 Lite ed esportare.
  9. Aprire Verifica → Controlli del modello in Tutte le configurazioni e trovare l’avviso ProductLine.4 per Propulsion.

Le linee di prodotti richiedono il piano Individual o Team; la baseline di configurazione e i proprietari delle configurazioni richiedono Team. Il riferimento completo è in Linee di prodotti e configurazioni, incluse le sezioni Si applica a, modifica in una vista di configurazione, applicabilità e documenti, RVTM e verifica.

Esercizio: trovare e correggere quattro errori della linea di prodotti

Una linea di prodotti raramente fallisce tutta in una volta. Fallisce attraverso piccole modifiche che sembrano ciascuna ragionevole: una regola aggiunta in fretta, un intervallo di numeri di serie digitato con un’unità in meno, un test collegato alla funzionalità sbagliata, una modifica di regola che rompe silenziosamente un prodotto già rilasciato. Questo esercizio introduce quattro errori del genere nella linea di prodotti EO-1 e chiede di trovarli uno per uno con i controlli che eseguirebbe un revisore, poi di correggerli. Mostra anche dove i controlli si fermano, perché sapere che cosa uno strumento non controlla fa parte del saperlo usare bene.

Occorrono: una copia nuova della demo CubeSat EO-1 e un piano con le linee di prodotti (Individual o Team, oppure un account accademico o di classe; nel piano Free la pagina Linea di prodotti è in sola lettura). Se possibile, lavorare in coppia: una persona introduce gli errori mentre l’altra non guarda, poi l’altra li trova. Da soli, introdurre tutti e quattro gli errori, chiudere il progetto e tornarci come revisore.

Introdurre gli errori

  1. Regole delle funzionalità in conflitto. Aprire Controllo e revisioni → Linea di prodotti. Nel menu ⋯ della riga F-5 Propulsion scegliere Regole…, spuntare F-3 X-band Downlink sotto Esclude e fare clic su Applica. Propulsion ora richiede ed esclude allo stesso tempo il downlink in banda X.
  2. Applicabilità sovrapposta. Nel menu ⋯ della colonna CFG-2 EO-1 Lite scegliere Applicabilità… e cambiare Numeri di serie da 3- a 2-, come se la costruzione di Lite fosse stata anticipata di un’unità.
  3. Verifica mancante per una configurazione. Aprire il caso di test TC-10 S-band Link Test e, nel gruppo Linea di prodotti dell’ispettore, impostare Si applica a su F-3, come se il test del collegamento appartenesse alla radio in banda X.
  4. Una modifica che invalida una configurazione rilasciata. Tornati alla pagina Linea di prodotti, aprire Regole… su F-4 Encrypted Downlink, spuntare F-5 Propulsion sotto Richiede e fare clic su Applica, come se l’hardware di cifratura richiedesse ora il vano di propulsione.

Trovarli come revisore

Usare solo ciò che userebbe un revisore: la riga degli esiti e Controlla configurazioni nella pagina Linea di prodotti, Verifica → Controlli del modello (fare clic su ↻ Esegui controlli e osservare l’insieme di regole Linea di prodotti), e la RVTM, sia in Tutte le configurazioni sia con Visualizza come ▾ impostato su ciascun prodotto. Annotare ogni errore trovato, che cosa lo ha mostrato e quale prodotto riguarda, prima di aprire le risposte.

Mostrare dove compare ogni errore e la correzione
ErroreDove Holarch lo mostraCorrezione
Modifica che rompe una configurazione rilasciataL’esito di CFG-1 EO-1 Flight, che è Rilasciato, indica «Viola: Encrypted Downlink richiede Propulsion.» Controlla configurazioni lo elenca, e i Controlli del modello lo segnalano come ProductLine.3, un errore.Rimuovere Propulsion da Richiede di F-4. Holarch non ha rifiutato la modifica: la regola si trova sulla funzionalità, non sulla configurazione rilasciata, quindi è l’esito a rilevarla.
Applicabilità sovrappostaProductLine.7 avverte su entrambe le configurazioni («Condivide numeri di serie con …»), e la finestra di dialogo Applicabilità indica quale intervallo si sovrappone a quale. SN 2 è ora rivendicato sia da EO-1 Flight sia da EO-1 Lite.Riportare i numeri di serie di CFG-2 a 3-.
Verifica mancante per una configurazioneProductLine.6 avverte su TC-10: non si trova mai in una stessa configurazione con 5.1 S-band Downlink Rate, che si applica solo a F-2. Con Visualizza come ▾ → CFG-2 EO-1 Lite, la RVTM mostra 5.1 senza caso di test; con CFG-1 non elenca affatto 5.1.Impostare Si applica a di TC-10 su F-2: testa la radio in banda S, quindi appartiene ai prodotti che ne hanno una. Anche svuotarlo, come nella demo originale, funziona.
Regole delle funzionalità in conflittoNulla diventa rosso: nessuna configurazione seleziona Propulsion, quindi nessun esito cambia, e ProductLine.4 aveva già avvertito che nessuna configurazione la seleziona. Per testare le regole, fare clic su + Nuova configurazione, selezionare Propulsion con la banda X («Viola: Propulsion esclude X-band Downlink.»), poi con la banda S («Viola: Propulsion richiede X-band Downlink.»). Nessun prodotto valido può includere Propulsion.Rimuovere la banda X da Esclude di Propulsion, poi eliminare la configurazione di prova.

Che cosa i controlli non rilevano

  • Le regole vengono controllate attraverso le configurazioni. Holarch controlla ogni configurazione rispetto alle regole delle funzionalità; non analizza le regole di per sé, quindi una contraddizione resta silente finché una configurazione non seleziona la funzionalità. Una configurazione Bozza di breve durata è il modo per testare una nuova regola.
  • La sovrapposizione dell’applicabilità si basa sul numero di serie. ProductLine.7 confronta i numeri di serie delle configurazioni. Due configurazioni le cui date di costruzione si sovrappongono non vengono segnalate.
  • Una configurazione rilasciata non è congelata rispetto alle modifiche delle regole. Con il controllo della configurazione attivo, una configurazione Rilasciata e presente nell’ultima baseline cambia la propria selezione e i propri valori solo tramite una richiesta di modifica. Le regole delle funzionalità rispetto a cui viene controllata sono elementi separati, quindi eseguire Controlla configurazioni ogni volta che una modifica tocca le funzionalità.
  • Le lacune di verifica per prodotto compaiono nella RVTM. ProductLine.6 trova un test collegato in modo da non incontrare mai il suo requisito. Un requisito che non ha un caso di test in un prodotto per un altro motivo compare nella RVTM della vista di quel prodotto, quindi leggerla per configurazione prima di una revisione.

Prima di finire, eseguire ancora una volta i controlli: gli esiti dovrebbero indicare di nuovo Valida, e le regole Linea di prodotti dovrebbero segnalare solo l’avviso ProductLine.4 per Propulsion che la demo ha di proposito.

Dove andare dopo