Guida · Requisiti
Tracciabilità dei requisiti e impatto delle modifiche: collegare esigenze, requisiti, progetto e test
Ascolta questa guida 27 min
La tracciabilità dei requisiti è la registrazione della provenienza di ogni requisito, di ciò che nel progetto lo soddisfa e di ciò che dimostra che è rispettato. Il suo vantaggio principale è l’analisi d’impatto delle modifiche: quando un requisito cambia, i collegamenti dicono che cosa va ricontrollato. Questa guida tratta i tipi e la direzione dei collegamenti di tracciabilità, il tracciamento in avanti e all’indietro, le lacune di copertura e gli orfani, i collegamenti sospetti e la matrice di tracciabilità, con un esempio svolto su un modello di CubeSat.
In questa pagina
- Che cos’è la tracciabilità dei requisiti
- Perché tracciare i requisiti: prima di tutto l’impatto delle modifiche
- Esigenze e requisiti
- I tipi di collegamenti di tracciabilità
- Tracciabilità in avanti e all’indietro
- Lacune di copertura e orfani
- Collegamenti sospetti dopo una modifica
- La matrice di tracciabilità
- Esempio svolto: il CubeSat EO-1
- Checklist della qualità dei requisiti
- Errori comuni
- Una parola sulla verifica
- Provarlo in Holarch
- Dove andare dopo
Che cos’è la tracciabilità dei requisiti
Un requisito raramente è isolato. Risponde a un’esigenza degli stakeholder, può essere sviluppato in requisiti di livello inferiore, una funzione o un componente lo realizza, e un test o un’analisi lo controlla. La tracciabilità è l’insieme dei collegamenti espliciti e registrati tra questi elementi. Ogni collegamento nomina le sue due estremità e dice qual è la relazione: «3.1 Orbit Average Power is satisfied by 1.3.1 Solar Arrays» è una traccia; una frase in un rapporto di progetto che menziona i pannelli non lo è.
I collegamenti formano una rete che va dalle esigenze degli stakeholder, attraverso i requisiti di sistema e di sottosistema, fino all’architettura e alla verifica. La ISO/IEC/IEEE 15288 richiede questa rete in diversi processi tecnici: le esigenze degli stakeholder sono tracciate ai requisiti che le formalizzano, i requisiti di sistema sono tracciati agli elementi dell’architettura a cui sono allocati e ogni requisito è tracciato all’attività che lo verifica. L’INCOSE Systems Engineering Handbook considera la tracciabilità una proprietà che un buon insieme di requisiti possiede nel suo complesso, non un documento separato prodotto alla fine.
Perché tracciare i requisiti: prima di tutto l’impatto delle modifiche
Creare i collegamenti richiede impegno, e mantenerli corretti ne richiede ancora di più, quindi conviene sapere che cosa ripagano. Quattro usi danno la maggior parte del valore, e il primo è il motivo per cui la maggior parte dei team inizia.
- Impatto delle modifiche. Prima di una modifica, i collegamenti mostrano fin dove arriva: quali requisiti di livello inferiore, funzioni, componenti, analisi e test dipendono dall’elemento modificato. Dopo la modifica, gli stessi collegamenti dicono al team che cosa ricontrollare. Senza di essi, la risposta dipende da chi ricorda il progetto (si veda la guida all’analisi d’impatto delle modifiche).
- Copertura. Ogni requisito dovrebbe essere soddisfatto da qualcosa nel progetto e controllato da qualcosa nella verifica. I collegamenti rendono visibili quelli mancanti, molto prima che li trovi un test di integrazione o un cliente.
- Conformità e giustificazione. Contratti, norme di sicurezza e revisioni chiedono la prova che ogni requisito sia soddisfatto e che nulla nel progetto esista senza un motivo. Una traccia dall’esigenza al requisito, al progetto e al test costituisce quella prova.
- Controllo delle modifiche. Quando un requisito cambia dopo essere stato concordato, gli elementi collegati devono essere rivisti e la revisione deve essere registrata. I collegamenti indicano al comitato delle modifiche che cosa rivedere e permettono al team di dimostrare che la revisione è avvenuta.
Un team che traccia solo per un audit alla fine di una fase ne sostiene il costo senza ottenerne la maggior parte dei benefici. I collegamenti creati mentre si scrivono i requisiti e il progetto costano meno e sono già presenti quando arriva una modifica. Una risposta sull’impatto di una modifica, inoltre, è completa solo quanto i collegamenti: un elemento che dovrebbe essere collegato e non lo è le resta invisibile, come mostra l’esempio svolto.
Esigenze e requisiti
La tracciabilità inizia sopra i requisiti. Un’esigenza è ciò che uno stakeholder si aspetta dal sistema, nei termini dello stakeholder: «I clienti agricoli hanno bisogno di immagini aggiornate dei loro campi almeno due volte alla settimana durante la stagione di crescita.» Un requisito è l’enunciato tecnico rispetto al quale il sistema sarà costruito e verificato: «La missione deve rivisitare ogni regione obiettivo entro 72 ore.»
I due differiscono per scopo e per forma:
| Esigenza | Requisito | |
|---|---|---|
| Responsabile | Uno stakeholder: utente, operatore, cliente, autorità di regolamentazione | Il team di ingegneria, d’accordo con gli stakeholder |
| Lingua | I termini propri dello stakeholder, spesso qualitativi | Precisa, misurabile, un solo «shall» per enunciato |
| Validato o verificato | Validata: il sistema consegnato fa ciò di cui lo stakeholder ha bisogno | Verificato: il sistema soddisfa l’enunciato, tramite test, analisi, ispezione o dimostrazione |
| Numero tipico | Decine | Da centinaia a migliaia, su più livelli |
La prima traccia collega ogni esigenza ai requisiti che la formalizzano. Un’esigenza senza requisiti è un’aspettativa dello stakeholder di cui il progetto non si occuperà. Un requisito senza esigenza, al livello più alto, è o un’ipotesi nascosta che andrebbe scritta come esigenza, o un requisito che nessuno ha chiesto. Come trasformare un’esigenza in un requisito ben formulato è l’argomento della guida alla scrittura di buoni requisiti. La guida a verifica e validazione mostra come ogni esigenza ottenga il proprio evento di validazione.
I tipi di collegamenti di tracciabilità
La maggior parte dei metodi e degli strumenti usa un piccolo insieme di tipi di collegamento. I nomi variano, ma i significati sono stabili. Ogni tipo risponde a una domanda diversa, e usare il tipo più specifico che sia vero rende i collegamenti utili per report e controlli. Gli esempi provengono dal CubeSat usato più avanti in questa guida.
| Collegamento (letto dall’estremo a monte) | Da → a | Domanda a cui risponde | Esempio |
|---|---|---|---|
| derived by (derives from) | Requisito → requisito sviluppato da esso | Quali requisiti sono stati sviluppati da questo, aggiungendo dettagli di progetto? | 1.5 Daily Collection Volume → 3.1 Orbit Average Power: il carico di acquisizione delle immagini determina il fabbisogno di potenza |
| decomposed by (padre e figlio) | Requisito → le sue parti | Quali enunciati di livello inferiore compongono insieme questo? | 1.6 Revisit Time → 1.6.1 Ground Track Repeat e 1.6.2 Off-Nadir Imaging |
| refined by | Requisito → requisito più preciso | Quale enunciato esprime lo stesso intento con un valore, una tolleranza o una condizione? | «Uscire rapidamente dalla modalità sicura» → «riprendere l’acquisizione delle immagini entro 6 ore dall’ingresso in modalità sicura» |
| satisfied by / allocated to | Requisito → funzione, componente, interfaccia, analisi | Che cosa nel progetto soddisfa questo requisito? | 3.1 → F3.1 Convert Sunlight to Power, 1.3.1 Solar Arrays |
| verified by | Requisito → caso di test, analisi, ispezione, dimostrazione | Che cosa mostra se questo requisito è soddisfatto? | 3.1 → TC-06 Solar Array Power Test |
| traced to | Esigenza o requisito → qualsiasi elemento correlato | Che cosa risponde a questo enunciato, quando nessuno dei tipi precedenti è adatto o la relazione non è ancora definita? | N2 Twice-Weekly Revisit → 1.6 Revisit Time |
Tre note sulla tabella. Un requisito derivato è un nuovo enunciato reso necessario dal padre; uno scomposto è una parte del padre, e il padre è soddisfatto quando lo sono le sue parti. Allocazione e soddisfacimento sono spesso usati come sinonimi; alcuni metodi allocano un requisito a un componente e poi dicono che il progetto del componente lo soddisfa, una distinzione che vale la pena mantenere solo se il team rivede davvero le due cose separatamente. Infine, una semplice traccia è il collegamento più debole: dice che i due elementi sono correlati, non come. È adatta ai collegamenti tra esigenze e requisiti e alle allocazioni iniziali non ancora definite; va sostituita con un tipo specifico una volta decisa la relazione.
Direzione
Ogni collegamento ha una direzione, e la convenzione usata dalla maggior parte dei team va dall’elemento che determina all’elemento che risponde: dall’esigenza al requisito, dal requisito padre al requisito derivato, dal requisito all’elemento di progetto e al test. Un collegamento si può leggere da entrambi gli estremi («3.1 è soddisfatto dai pannelli solari», «i pannelli solari soddisfano 3.1»), ma è un solo collegamento, registrato una sola volta.
È la direzione a far funzionare l’analisi d’impatto. Una modifica all’estremo a monte mette in discussione ogni elemento a valle; una modifica all’estremo a valle di solito non invalida il requisito sovrastante, anche se può significare che il progetto non lo soddisfa più. Gli strumenti che segnalano i collegamenti dopo una modifica si basano su questa direzione per decidere quale estremo segnalare.
Chi usa SysML conosce questi collegamenti come dipendenze stereotipate: «deriveReqt», «refine», «satisfy», «verify» e «trace». In SysML la freccia va dall’elemento dipendente al requisito (il caso di test punta al requisito che verifica), cioè al contrario della lettura descritta sopra. Il significato è lo stesso; cambia solo la convenzione grafica. Il tutorial di SysML v2 mostra come si scrivono satisfy e verify nella notazione testuale.
Tracciabilità in avanti e all’indietro
La tracciabilità si controlla in due direzioni.
- In avanti (verso il basso): da ogni esigenza ai requisiti che la coprono, da ogni requisito agli elementi di progetto che lo soddisfano e ai test che lo verificano. La tracciabilità in avanti risponde alla domanda «tutto ciò che ci è stato chiesto è stato costruito e controllato?»
- All’indietro (verso l’alto): da ogni test, funzione o componente al requisito che serve, e da ogni requisito a un’esigenza o a un requisito padre. La tracciabilità all’indietro risponde alla domanda «tutto ciò che abbiamo costruito ha un motivo?»
Un insieme di requisiti è tracciabile in modo bidirezionale quando valgono entrambe. In pratica, le lacune in avanti mostrano lavoro mancante e quelle all’indietro lavoro in più: gold plating, elementi di progetto rimasti da un prodotto precedente, test che controllano qualcosa che nessuno ha chiesto, o un requisito aggiunto da qualcuno senza una fonte.
Lacune di copertura e orfani
I due difetti di una rete di tracciabilità hanno un nome.
- Una lacuna di copertura è un requisito privo di un collegamento che dovrebbe avere: un requisito foglia non soddisfatto da nulla, o non verificato da nulla. Vanno controllati i requisiti foglia, quelli senza requisiti figli. Un padre è coperto tramite i suoi figli, e pretendere un collegamento diretto anche sul padre produce collegamenti duplicati.
- Un orfano è un elemento senza collegamento a monte: una funzione, un componente o un’analisi che non soddisfa alcun requisito, un caso di test che non ne verifica nessuno, o un requisito derivato senza padre. Un orfano non è sempre un errore. Un ricambio di volo esiste per la campagna di integrazione, e la correzione può allora essere un requisito mancante, non un elemento da eliminare. In ogni caso, un orfano è una domanda a cui il team deve rispondere.
Le percentuali di copertura («94 per cento dei requisiti foglia allocati») sono utili per seguire l’avanzamento, ma il team lavora sull’elenco degli elementi non coperti. Una lacuna si chiude aggiungendo il collegamento mancante, decidendo che il requisito non è una foglia o eliminando un requisito non necessario.
Gli orfani contano anche per l’analisi d’impatto. Un elemento che dovrebbe rispondere a un requisito ma non ha alcun collegamento non verrà segnalato quando quel requisito cambia. L’esempio seguente ne contiene uno.
Collegamenti sospetti dopo una modifica
Un collegamento registra un giudizio dato in un certo momento: «questo componente, così come è progettato, soddisfa questo requisito, così come è scritto.» Quando il testo o i valori del requisito cambiano, quel giudizio può non essere più valido. Un collegamento sospetto è un collegamento il cui estremo a monte è cambiato dopo l’ultima revisione del collegamento. Il collegamento non viene eliminato né considerato rotto; resta segnalato finché qualcuno esamina l’elemento all’altro estremo e decide. Holarch li elenca in Collegamenti da rivedere.
Risolvere un collegamento sospetto è una piccola revisione:
- Leggere che cosa è cambiato: il testo vecchio e quello nuovo, o l’attributo modificato.
- Controllare l’elemento all’estremo a valle. Il requisito derivato ne discende ancora? Il componente soddisfa ancora il requisito? Il test controlla ancora il nuovo valore?
- Se è ancora valido, rimuovere la segnalazione e registrarne il motivo, per esempio «Il testo della funzione non contiene valori di potenza; nessuna modifica necessaria.»
- Se non è più valido, modificare l’elemento a valle (o aprire una modifica su di esso), poi rimuovere la segnalazione. Se il collegamento stesso non è più vero, eliminarlo.
La registrazione conta quanto la decisione. Un collegamento sospetto risolto con un commento e un nome è la prova, per la revisione successiva, che la modifica è stata seguita fino in fondo; una segnalazione rimossa in blocco senza un controllo è peggio di nessuna segnalazione, perché attesta una revisione mai avvenuta.
Non ogni modifica deve generare segnalazioni. Correggere un refuso nel nome di un requisito non dovrebbe mandare in revisione venti elementi, mentre cambiare un livello di potenza da 28 W a 30 W deve farlo. Gli strumenti tracciano questo confine in modi diversi; la domanda utile è se una modifica possa rendere errato un giudizio a valle.
La matrice di tracciabilità
Una matrice di tracciabilità mostra i collegamenti tra due insiemi di elementi come una griglia: per esempio i requisiti nelle righe e le funzioni, i componenti o i casi di test nelle colonne. Un segno in una cella significa che riga e colonna sono collegate. Anche una tabella con una riga per requisito e una colonna che ne elenca gli elementi collegati viene spesso chiamata matrice di tracciabilità (il file scaricabile qui sotto ha questa forma); la forma a griglia è più facile da scorrere alla ricerca di lacune, perché una riga o una colonna vuota salta all’occhio.
Come leggere una matrice:
- Una riga vuota è una lacuna di copertura: un requisito non collegato a nulla nelle colonne.
- Una colonna vuota è un orfano: una funzione, un componente o un test a cui nessuna riga è collegata.
- Una riga con molti segni può indicare un requisito troppo ampio, da suddividere.
- Una colonna con molti segni è un elemento di progetto da cui dipendono molti requisiti; una sua modifica ha un impatto ampio.
Una matrice è una vista dei collegamenti, non il luogo in cui risiedono. I team che tengono i collegamenti in un foglio di calcolo aggiornato a mano scoprono che il foglio e il progetto si allontanano; una matrice generata da un modello è sempre aggiornata quanto il modello.
Una matrice di verifica dei requisiti è una vista correlata che elenca ogni requisito con il metodo di verifica, l’attività di verifica e il relativo risultato. È il lato della verifica degli stessi collegamenti; la guida alla matrice di verifica dei requisiti (RVTM) la tratta sullo stesso CubeSat.
Esempio svolto: il CubeSat EO-1
L’esempio è EO-1, un CubeSat 6U fittizio che riprende terreni agricoli in quattro bande spettrali. È lo stesso modello del progetto di esempio MBSE completo, costruito in Holarch come progetto LML: i requisiti sono Requirement nella specifica SRS-001 EO-1 System Requirements Specification (32 in tutto), le funzioni sono Action numerate da F1 a F11 con sottofunzioni, i componenti sono Asset e i test sono Test Case da TC-01 a TC-20. Le funzioni provengono dall’analisi funzionale della stessa missione.
Esigenze e requisiti
La demo registra la provenienza di ogni requisito in un attributo Origine: Customer Needs Statement CNS-1, Mission Concept Review o Derived (systems analysis). Un attributo nomina un documento; non lo si può seguire, contare o segnalare. Per questo il modello registra anche tre esigenze degli stakeholder emerse dal workshop con il cliente come Statement, ciascuna tracciata ai requisiti che la formalizzano. N1–N3 fanno parte del modello di riferimento EO-1 (v1.0) e dei progetti demo creati in Holarch 2.2.1 o versioni successive.
| Esigenza | Enunciato | Tracciato a |
|---|---|---|
| N1 Same-Day Crop Stress Alerts | I clienti agricoli hanno bisogno di sapere dello stress delle colture il giorno stesso del passaggio. | 6.2 Image Delivery (entro 6 ore dal downlink), 6.5 Planning Cycle Time (entro 100 minuti) |
| N2 Twice-Weekly Revisit | Farm customers need fresh imagery of their fields at least twice a week in the growing season. | 1.6 Revisit Time (entro 72 ore) |
| N3 Field-Level Vegetation Maps | I clienti agricoli hanno bisogno di mappe della vegetazione abbastanza dettagliate da distinguere un campo dall’altro. | 1.2 Ground Sample Distance (4,5 m), 1.4 Spectral Bands (quattro bande, da 450 nm a 900 nm) |
Sotto le esigenze, la specifica usa tutti e tre i collegamenti tra requisiti. 1.6 Revisit Time è scomposto in 1.6.1 Ground Track Repeat (3 giorni) e 1.6.2 Off-Nadir Imaging (25 gradi): insieme garantiscono la rivisitazione entro 72 ore. 3.1 Orbit Average Power è derivato da 1.5 Daily Collection Volume, e 3.3 Depth of Discharge da 1.7 Mission Lifetime: nessun cliente ha chiesto un livello di potenza o un limite per la batteria, ma il volume di acquisizione e la vita di 730 giorni non si possono raggiungere senza di essi. Un requisito come 3.1 non ha quindi alcuna esigenza sopra di sé, ed è corretto così: il suo padre è un altro requisito.
I collegamenti dei requisiti di potenza
La sezione 3, Electrical Power, è una buona porzione da leggere con attenzione. La tabella elenca, dal modello, che cosa soddisfa e verifica ogni requisito:
| Requisito | Soddisfatto da (funzioni) | Soddisfatto da (componenti) | Soddisfatto da (altro) | Verificato da |
|---|---|---|---|---|
| 3.1 Orbit Average Power | F3, F3.1 | 1.3.1 Solar Arrays | EQ-1.1 Solar Power Generation, EQ-1.4 Power Margin Check | TC-06 Solar Array Power Test (Superato) |
| 3.2 Battery Capacity | F3, F3.2 | 1.3.2 Battery Pack | TC-07 Battery Capacity Test (Superato) | |
| 3.3 Depth of Discharge | F3, F3.3 | EQ-1.2 Battery Depth of Discharge, OPS.10, IF-21 | TC-07 Battery Capacity Test (Superato) | |
| 3.4 Bus Regulation | F3, F3.3 | 1.3.3 Power Distribution Unit | Da IF-01 a IF-04, IF-20, IF-22 (linee di alimentazione) | TC-18 Bus Regulation Inspection (Superato) |
| 3.5 Battery Thermal Control | (nessuno) | (nessuno) | (nessuno) | (nessuno) |
| 3.6 Array Deployment | F2 Deploy Solar Arrays | 1.6 Structure and Thermal | IF-19 Deployment Switch Harness | TC-19 Array Deployment Test (Non eseguito) |
F3 Generate and Store Power soddisfa quattro requisiti, e le sue sottofunzioni da F3.1 a F3.3 li ripartiscono tra i pannelli solari, la batteria e l’unità di distribuzione dell’alimentazione. Le linee di alimentazione che soddisfano 3.4 sono interfacce; la guida al documento di controllo delle interfacce le segue fino all’ICD.
Leggere la matrice: una lacuna e un orfano
Con i sei requisiti di potenza nelle righe e gli elementi di progetto e di test nelle colonne, la matrice (6 righe, 17 colonne, 21 collegamenti) mostra a colpo d’occhio:
- 3.5 Battery Thermal Control è una lacuna di copertura: la sua riga è vuota. Nulla nel progetto mantiene calda la batteria e nessun test lo controlla. Il requisito è anche debole («keep the battery warm enough (TBD)»), e i due problemi sono legati: un requisito senza valore è difficile da allocare e impossibile da testare. La guida alla scrittura dei requisiti lo riscrive.
- EQ-1.3 Orbit-Average Array Power è un orfano: la sua colonna è vuota. Calcola la potenza media orbitale dei pannelli a partire dalla potenza di picco, dalla frazione illuminata e dal rendimento del percorso di alimentazione, cioè proprio la grandezza vincolata da 3.1, eppure non soddisfa alcun requisito. L’equazione sorella EQ-1.4 Power Margin Check è collegata a 3.1; EQ-1.3 è stata dimenticata.
- F3 Generate and Store Power porta quattro requisiti, quindi una sua modifica li raggiunge tutti e quattro. TC-07 ne verifica due (3.2 e 3.3).
- Le celle di verifica mostrano lo stato dei test: TC-06, TC-07 e TC-18 superati, TC-19 non ancora eseguito. Copertura e stato di verifica sono domande diverse: 3.6 è coperto da un test non ancora eseguito.
Sull’intera specifica, lo stesso controllo trova sei requisiti foglia con lacune: 2.5 Safe Mode Recovery, 3.5 e 6.4 Operator Interface non sono né soddisfatti né verificati, mentre 1.5 Daily Collection Volume, 4.4 Downlink Encryption e 6.5 Planning Cycle Time sono soddisfatti ma non verificati. 1.6 Revisit Time non ha un test proprio e non è una lacuna: è un padre, coperto tramite 1.6.1 e 1.6.2. Fuori dalla porzione della potenza, S-1 Spare Reaction Wheel non ha alcun collegamento, un tipico orfano con una buona ragione (un ricambio di volo per l’integrazione) che merita comunque una decisione registrata. Le parti 1.2.1 Reaction Wheel Assembly e 1.2.2 Star Tracker non soddisfano direttamente alcun requisito, ma svolgono funzioni che lo fanno, quindi sono tracciate indirettamente; un controllo che guardasse solo i collegamenti diretti le considererebbe orfane per errore.
Impatto della modifica: 3.1 passa da 28 W a 30 W
Dopo la Preliminary Design Review il carico medio orbitale è salito a 26 W, quindi 3.1 passa da 28 W a 30 W per mantenere il margine del 15 per cento. I collegamenti rendono sospetti sei elementi: 1.3.1 Solar Arrays, F3 Generate and Store Power, F3.1 Convert Sunlight to Power, EQ-1.1 Solar Power Generation, EQ-1.4 Power Margin Check e TC-06 Solar Array Power Test. L’esito positivo di TC-06 non resta valido: 75,1 W di picco danno, secondo EQ-1.3, solo 27,9 W di media orbitale, sotto i 30 W. EQ-1.3, l’orfano trovato sopra, non viene segnalato affatto. La guida all’analisi d’impatto delle modifiche segue questa modifica passo per passo, dalla richiesta di modifica fino alla chiusura della registrazione.
Scaricare la tabella di tracciabilità e la checklist
- Matrice di tracciabilità dei requisiti di EO-1 (CSV): tutti i 32 requisiti di SRS-001 dopo la modifica, una riga ciascuno, con stato, origine, padre e figli, derives from e derived by, refined by (non usato in questo modello), satisfied by (funzioni, componenti, altro), verified by con lo stato del test, un giudizio di copertura e i sei collegamenti sospetti su 3.1. È stata generata dal modello demo, quindi corrisponde alla matrice qui sopra. Le esigenze da N1 a N3 sono Statement, non requisiti, quindi non vi compaiono.
- Checklist di qualità dei requisiti con esempi EO-1 prima e dopo (CSV): la checklist completa della guida alla scrittura di buoni requisiti, da usare in una revisione.
Checklist della qualità dei requisiti
La tracciabilità dipende dalla qualità degli enunciati a ciascun estremo. Un requisito vago non può essere allocato né verificato, quindi compare come lacuna di copertura, e un requisito senza motivazione non può essere valutato quando una segnalazione di sospetto chiede se l’elemento a valle è ancora valido. La specifica di EO-1 contiene di proposito tre requisiti deboli: 2.5 Safe Mode Recovery («should recover … quickly … as appropriate»), 3.5 Battery Thermal Control («warm enough (TBD)») e 6.4 Operator Interface («user friendly and/or easy to use»); 3.5 è anche la lacuna di copertura nella matrice qui sopra. I controlli più importanti per la tracciabilità sono un solo obbligo per enunciato, un valore misurabile con le sue condizioni, una motivazione registrata, un collegamento verso l’alto e un metodo di verifica con criteri derivati dall’enunciato. La guida alla scrittura di buoni requisiti contiene la checklist completa, con le riscritture prima e dopo di tutti e tre.
Errori comuni
| Errore | Cosa va storto | Meglio |
|---|---|---|
| Proliferazione dei collegamenti: collegare tutto ciò che sembra correlato | Ogni modifica segnala decine di elementi, i revisori smettono di leggere le segnalazioni e l’analisi d’impatto mostra l’intero modello. | Collegare solo le relazioni vere, che qualcuno rivedrebbe dopo una modifica. Usare il tipo di collegamento più specifico. |
| Collegamenti mancanti sulle analisi | Le equazioni e i budget che calcolano il valore di un requisito non vengono segnalati quando questo cambia (EQ-1.3 sopra). | Collegare ogni analisi ai requisiti di cui calcola o controlla i valori. |
| Testo «shall» non tracciabile: requisiti sepolti nei paragrafi di una specifica | Una frase non può essere collegata, contata o segnalata da sola. Due «shall» nello stesso paragrafo condividono la stessa sorte. | Un requisito per elemento, con un proprio identificativo, un solo «shall» per enunciato. |
| Tracciare verso documenti anziché verso elementi | «3.4 is satisfied by the EPS Design Description» non dice nulla su quale parte del progetto, e il collegamento sopravvive a qualsiasi modifica del documento. | Tracciare verso la funzione, il componente, l’interfaccia o il caso di test. Collegare il documento a quegli elementi se li descrive. |
| Usare una traccia generica per tutto | I controlli di copertura cercano i collegamenti di soddisfacimento e di verifica, e segnalano lacune inesistenti o non vedono quelle reali. | Riservare la traccia generica alle esigenze e ai collegamenti non ancora definiti; usare derive, satisfy e verify dove si applicano. |
| Tracciare i padri anziché le foglie | Collegamenti duplicati sul padre e sui figli, e una copertura che sembra completa mentre manca un figlio. | Allocare e verificare i requisiti foglia; il padre è coperto tramite essi, come 1.6 tramite 1.6.1 e 1.6.2. |
| Rimuovere le segnalazioni di sospetto in blocco senza revisione | La registrazione attesta una revisione mai avvenuta. | Rimuoverle con un breve motivo per ogni elemento, o per ogni gruppo di elementi rivisti insieme. |
| Tracciare una sola volta, alla fine | I collegamenti vengono ricostruiti a memoria per un audit e perdono ciò che è cambiato nel frattempo. | Creare i collegamenti mentre si scrivono i requisiti e il progetto, e rivedere le lacune a ogni milestone. |
Una parola sulla verifica
Un collegamento di verifica dice se un requisito è coperto da un’attività di verifica; non dice se il requisito è soddisfatto. Questo dipende dal risultato dell’attività: TC-04 Pointing Accuracy Test verifica 2.1 ed è fallito. Pianificare il metodo per ogni requisito (test, analisi, ispezione o dimostrazione), eseguire le attività e aggregare i risultati lungo la gerarchia dei requisiti è compito di una matrice di verifica dei requisiti. Un’attività di verifica può anche essere un’analisi o una simulazione; l’esempio MBSE stima 6.5 Planning Cycle Time con una simulazione del passaggio di acquisizione, e la guida Monte Carlo spiega come si legge un risultato del genere. I collegamenti di tracciabilità qui descritti ne sono l’input.
Provarlo in Holarch
In un progetto LML ogni traccia è una relazione tra due entità, e un collegamento creato in un punto compare nell’ispettore, nella matrice, nei diagrammi Spider e di Requirement e nella RVTM.
- Creare la demo con Gestisci progetti → File di progetto ▾ → Nuovo progetto demo → CubeSat (ingegneria dei sistemi guidata). La sua specifica contiene già la modifica a 3.1 e i sei collegamenti sospetti.
- Aprire Verifica → Matrice di tracciabilità. Fare clic sul chip Righe e impostare la query
class:Requirement AND number:3.*; fare clic sul chip Colonne e impostare una query comeclass:Action OR class:TestCase. - Selezionare Solo lacune per vedere le righe senza collegamenti. Scegliere una relazione come satisfied by e fare clic su una cella vuota per creare un collegamento, per esempio da EQ-1.3 a 3.1.
- Aprire Esigenze e requisiti → Collegamenti da rivedere, fare clic su Differenze in una riga, poi su Segna come rivisto… con un commento.
- Fare clic su Esporta… nella matrice per ottenere la griglia in Excel o CSV.
Verifica → Controlli del modello elenca i requisiti foglia non allocati o non verificati, e Apri in ▾ → Spider di un’entità esegue un’analisi d’impatto prima di una modifica. Il riferimento completo è in Tracciabilità, e le regole sui collegamenti sospetti in Collegamenti da rivedere.
Dove andare dopo
- Esigenze e requisiti in Holarch: documenti, controlli di qualità, baseline e tracciabilità in un unico modello.
- Documentazione sulla tracciabilità: tipi di relazione, la Matrice di tracciabilità, il diagramma Spider e i controlli di copertura.
- Documentazione sui requisiti: scrivere, approvare e mettere in baseline i requisiti, e la pagina Collegamenti da rivedere.