Guida · Requisiti
Come scrivere buoni requisiti di sistema: esempi e checklist
Ascolta questa guida 26 min
Un buon requisito dice una sola cosa che il sistema deve fare o essere, con parole che due ingegneri leggono allo stesso modo, e con un valore che un test o un’analisi può verificare. Questa guida tratta esigenze e requisiti, le parti di un enunciato di requisito, le caratteristiche di qualità di ISO/IEC/IEEE 29148 e della INCOSE Guide to Writing Requirements, una checklist con esempi prima e dopo, metodo di verifica e criteri di accettazione, valori TBD e TBR e tipi di requisito, il tutto svolto su una sola specifica di CubeSat.
In questa pagina
- Perché la formulazione di un requisito è importante
- Esigenze degli stakeholder e requisiti
- L’anatomia di un requisito
- Caratteristiche di qualità di un buon requisito
- La checklist: regole con esempi prima e dopo
- Scrivere il metodo di verifica e i criteri di accettazione insieme al requisito
- Gestire i valori TBD e TBR
- Tipi di requisito
- Esempio svolto: revisione della specifica di EO-1
- Errori comuni
- Provarlo in Holarch
- Scaricare la checklist
- Domande sulla scrittura dei requisiti
- Dove andare dopo
Perché la formulazione di un requisito è importante
Un requisito è un contratto tra chi chiede un sistema e chi lo costruisce. Tutto ciò che viene dopo lo legge: il progettista dimensiona un componente in base a esso, l’ingegnere di test ne ricava un criterio di superamento, il comitato di modifica valuta una modifica rispetto a esso, e il cliente accetta il sistema sulla sua base. Ciascuno legge la stessa frase, di solito senza l’autore presente. Se la frase si può leggere in due modi, verrà letta in due modi, e la differenza emerge tardi: a un test «superato» rispetto a un criterio che nessuno ha concordato, o all’accettazione, quando il cliente intendeva altro.
Una formulazione scadente compromette anche il resto del modello. Un requisito senza valore non può essere allocato a un componente, perché nessuno può dire se il componente lo soddisfa. Non può essere verificato, quindi compare come lacuna di copertura nella tracciabilità e nella matrice di verifica. E quando cambia, nessuno sa dire se il progetto collegato regge ancora. Scrivere bene i requisiti è il lavoro di qualità più economico di un progetto: un’ora su una frase all’inizio risparmia una campagna di test alla fine.
La guida usa un unico esempio ricorrente, EO-1, un CubeSat 6U immaginario che riprende terreni agricoli in quattro bande spettrali. La sua specifica, SRS-001 EO-1 System Requirements Specification, contiene 32 requisiti, quasi tutti solidi e tre volutamente deboli. È lo stesso modello dell’esempio di progetto MBSE completo. Le esigenze degli stakeholder da N1 a N3 citate qui sono quelle che la guida alla tracciabilità aggiunge al modello.
Esigenze degli stakeholder e requisiti
La scrittura dei requisiti comincia un passo prima, con le esigenze. Un’esigenza degli stakeholder è ciò che un utente, un operatore, un cliente o un ente regolatore si aspetta, nei propri termini. Un requisito è l’enunciato ingegneristico rispetto al quale il sistema viene progettato e verificato. ISO/IEC/IEEE 15288 tiene separate le due cose in processi tecnici distinti: definizione delle esigenze e dei requisiti degli stakeholder (6.4.2) e definizione dei requisiti di sistema (6.4.3). Il Needs and Requirements Manual di INCOSE fa la stessa distinzione e tratta le esigenze come elementi a sé, non come bozze grezze di requisiti.
| Esempio EO-1 | Verificato con | |
|---|---|---|
| Esigenza (N2 Twice-Weekly Revisit) | Farm customers need fresh imagery of their fields at least twice a week in the growing season. | Validazione: i clienti ottengono ciò di cui hanno bisogno dal sistema consegnato? |
| Requisito (1.6 Revisit Time) | The mission shall revisit each target region within 72 hours. | Verifica: il sistema soddisfa l’enunciato, tramite test, analisi, ispezione o dimostrazione? |
La differenza si vede nel modo in cui ciascuno viene controllato. Un requisito viene verificato: il sistema viene misurato rispetto all’enunciato. Un’esigenza viene validata: qualcuno conferma che il sistema, nell’uso previsto, fa ciò che lo stakeholder voleva. Un sistema può superare ogni verifica e fallire comunque la validazione se i requisiti hanno mancato il punto; la guida a verifica e validazione tratta questo divario. Per la scrittura la conseguenza pratica è semplice: scrivere prima l’esigenza, poi scrivere requisiti che, se soddisfatti, la soddisferebbero, e collegare ogni requisito all’esigenza a cui risponde.
La traduzione è raramente uno a uno. N2 diventa 1.6 Revisit Time, che viene poi scomposto in 1.6.1 Ground Track Repeat (3 giorni) e 1.6.2 Off-Nadir Imaging (25 gradi). Alcuni requisiti non rispondono direttamente ad alcuna esigenza: 3.1 Orbit Average Power deriva da 1.5 Daily Collection Volume, perché il carico di ripresa determina la potenza che i pannelli devono fornire. Nessun cliente ha chiesto 30 W, ma la ripresa che hanno chiesto non può avvenire senza.
L’anatomia di un requisito
Un requisito è più della sua frase. La frase porta l’obbligo; un insieme di attributi intorno porta le motivazioni, il piano per dimostrarlo e la gestione amministrativa. Entrambe le metà fanno parte della scrittura.
L’enunciato
La maggior parte degli enunciati di buoni requisiti segue uno schema. ISO/IEC/IEEE 29148 (5.2.4) lo descrive come un soggetto, un’azione, un oggetto e vincoli sull’azione, con una condizione facoltativa in testa; la INCOSE Guide to Writing Requirements raccomanda lo stesso ordine e modelli concordati per ogni tipo di requisito.
| Parte | Cosa dice | EO-1 4.3 Fault Detection |
|---|---|---|
| Condizione (facoltativa) | Quando, in quale modalità o stato, si applica il requisito | «…of undervoltage detection» (l’evento scatenante) |
| Soggetto | Il sistema o l’elemento che deve conformarsi, nominato con esattezza | «The C&DH» |
| Verbo modale | La forza dell’obbligo | «shall» |
| Azione | Ciò che il soggetto fa o è, come verbo attivo | «enter» |
| Oggetto | Ciò a cui si applica l’azione | «safe mode» |
| Prestazione o vincolo | Il valore misurabile, con unità e direzione del limite | «within 10 seconds» |
Insieme: «The C&DH shall enter safe mode within 10 seconds of undervoltage detection.» L’ordine può cambiare («When undervoltage is detected, the C&DH shall…» mette la condizione all’inizio, come nei modelli EARS usati da molti team), ma ogni parte dovrebbe esserci o mancare deliberatamente.
Tre parole portano gran parte del peso. Shall indica un requisito vincolante; will enuncia un fatto o un’intenzione su qualcosa al di fuori del sistema; should enuncia un obiettivo che non viene verificato. Qualunque convenzione usi un progetto, va definita una volta nella specifica e rispettata. EO-1 1.1 Reference Orbit («The mission assumes a 500 km sun-synchronous orbit…») è scritto correttamente come ipotesi, non come requisito: è il contesto per i requisiti che ne dipendono, e il modello lo memorizza come un enunciato che non viene valutato né verificato.
Gli attributi
Ecco 3.1 Orbit Average Power così come lo registra il modello EO-1, dopo la modifica successiva alla PDR da 28 W a 30 W:
| Attributo | 3.1 Orbit Average Power | Perché c’è |
|---|---|---|
| Identificativo e nome | 3.1 Orbit Average Power | Un riferimento stabile per collegamenti, revisioni e richieste di modifica |
| Enunciato | The solar arrays shall generate at least 30 W orbit-average power at end of life. | L’obbligo stesso |
| Motivazione | Orbit-average load grew to 26 W after PDR; 30 W keeps 15% margin. | Permette a un lettore successivo di valutare una modifica senza l’autore |
| Origine e padre | Derived (systems analysis); derivato da 1.5 Daily Collection Volume | Tracciabilità all’indietro: perché il requisito esiste |
| Metodo e livello di verifica | Test, a livello di sottosistema | Il piano per dimostrarlo, deciso durante la scrittura |
| Criteri di successo | End-of-life orbit-average power predicted from measured peak power. | Quale risultato conta come soddisfatto |
| Responsabile, priorità, criticità | Power Engineer; High; High | Chi ne risponde e quanto conta |
| Stato | In revisione (era Approvato; il suo testo è cambiato dopo l’approvazione) | A che punto è nel processo di accordo |
| TBD/TBR | Nessuno | Se un valore è ancora aperto |
ISO/IEC/IEEE 29148 (5.2.8) elenca attributi di questo tipo, e la guida INCOSE ne aggiunge altri; un progetto sceglie quelli che manterrà davvero. La motivazione è quella più spesso tralasciata e più spesso rimpianta in seguito. Senza «carico di 26 W, margine del 15%», la persona successiva che vede 3.1 non può capire se 30 W sia un limite fisico rigido, un numero del cliente o una scelta di margine, e quindi non può capire cosa significhi per esso una modifica del carico.
Caratteristiche di qualità di un buon requisito
Le regole di stile si applicano più facilmente quando si sa cosa proteggono. ISO/IEC/IEEE 29148 (5.2.5) nomina nove caratteristiche di un singolo requisito, e la INCOSE Guide to Writing Requirements usa le stesse nove come C1–C9, ciascuna con una breve definizione e le regole che la sostengono. La tabella formula ciascuna come una domanda che un revisore può porre.
| Caratteristica | Domanda da porre | Esempio EO-1 |
|---|---|---|
| Necessario | Se venisse eliminato, si perderebbe qualcosa di cui gli stakeholder hanno bisogno? Non è un duplicato? | 3.1 è necessario: senza di esso nulla dimensiona i pannelli per il carico di ripresa. |
| Appropriato | È scritto al livello giusto, senza fissare una scelta di progetto che spetta al livello inferiore? | 3.1 fissa un livello di potenza per i pannelli, non un tipo di cella o un numero di pannelli. |
| Non ambiguo | Si può leggere in un solo modo? | 6.4 «user friendly» non lo è: due revisori non saranno d’accordo sul fatto che sia soddisfatto. |
| Completo | Dice tutto il necessario, senza condizioni o valori mancanti? | 3.5 «warm enough (TBD)» non lo è: manca il valore. |
| Singolare | Enuncia un solo obbligo? | 2.5 non lo è: chiede di ripristinare e di riprendere la ripresa, uniti da «and». |
| Fattibile | Si può soddisfare entro i vincoli noti di tecnologia, costi e tempi? | 3.1 a 30 W è in dubbio: i pannelli così come progettati danno circa 28 W di media orbitale. |
| Verificabile | Un test, un’analisi, un’ispezione o una dimostrazione può mostrare che è soddisfatto? | 2.5 «quickly» non lo è; «within 6 hours» sì. |
| Corretto | Enuncia l’esigenza reale della sua origine, con il valore giusto? | 1.2, distanza di campionamento al suolo di 4,5 m, esprime correttamente N3, le mappe a livello di campo, con margine. |
| Conforme | Segue i modelli e il vocabolario concordati del progetto? | Ogni requisito di EO-1 usa «shall», un soggetto nominato e unità SI. |
Un insieme di requisiti ha caratteristiche proprie che nessun singolo enunciato può mostrare. ISO/IEC/IEEE 29148 (5.2.6) elenca l’insieme come completo, coerente, fattibile nel suo complesso, comprensibile e validabile; la guida INCOSE aggiunge corretto come C15 e numera le caratteristiche dell’insieme da C10 a C15.
- Completo: l’insieme copre le esigenze. EO-1 dice cosa accade in caso di sottotensione (4.3), ma il suo unico requisito di ripristino dalla modalità sicura è 2.5, non verificabile così come è scritto, quindi il ripristino è di fatto non specificato.
- Coerente: nessun requisito è in conflitto con un altro, e termini e unità sono usati allo stesso modo. 1.5 chiede 3,2 GB di dati immagine al giorno e 5.4 chiede 3 GB ricevuti a terra; concordano solo perché la motivazione di 5.4 dice «after compression». Senza la motivazione sembrano in conflitto.
- Fattibile: i requisiti si possono soddisfare insieme. Ogni requisito di potenza può essere fattibile da solo, mentre 30 W di media orbitale, la superficie dei pannelli e il budget di massa insieme possono non esserlo.
- Comprensibile: un lettore può capire cosa ci si aspetta dal sistema e come si relazionano i requisiti, il che dipende da struttura, numerazione e tracciabilità tanto quanto dalla formulazione.
- Validabile: si può dimostrare che l’insieme porta a un sistema che soddisfa le esigenze, ed è per questo che ogni requisito di primo livello è collegato a un’esigenza.
La checklist: regole con esempi prima e dopo
Le caratteristiche diventano utilizzabili attraverso regole di scrittura concrete. La INCOSE Guide to Writing Requirements le numera (R1, R2 e così via); il NASA Systems Engineering Handbook (Appendice C) ha una checklist più breve sulla stessa linea. La tabella raccoglie le regole che nella pratica intercettano la maggior parte dei problemi, con un esempio dalla specifica di EO-1 per ciascuna. «Prima» è il testo così come si trova nella demo; «Dopo» è una riscrittura. I valori indicati come illustrativi mostrano la forma, non risultati di analisi di EO-1.
| Regola | Domanda da porre | Prima (EO-1) | Dopo |
|---|---|---|---|
| Un solo obbligo per enunciato | Esattamente un «shall», nessun «and», «or», «and/or» che unisca due richieste? | 2.5: «The spacecraft should recover from safe mode quickly and resume imaging as appropriate» | «The spacecraft shall resume imaging within 6 hours of a safe mode entry.» Gli altri passi del ripristino che contano ricevono requisiti propri. |
| Formulazione vincolante | «Shall» per un requisito vincolante, non «should», «will» o «may»? | 2.5: «should recover» | «shall resume» |
| Valore misurabile con unità | Ogni termine di prestazione ha un numero e un’unità? | 2.5: «quickly» | «within 6 hours of a safe mode entry» |
| Direzione del limite indicata | È chiaro se il valore è un minimo o un massimo? | 1.6.2: «image targets up to 25 degrees off nadir» | «image targets at off-nadir angles from 0 to 25 degrees» (un intervallo di capacità, non un tetto al puntamento) |
| Nessuna clausola di scappatoia | C’è qualcosa lasciato al giudizio del fornitore («as appropriate», «if possible», «where practical»)? | 2.5: «as appropriate» | Rimosso; viene indicata la condizione che conta |
| Nessun termine vago o soggettivo | Due revisori potrebbero non essere d’accordo sul fatto che sia soddisfatto («user friendly», «easy», «adequate», «enough»)? | 6.4: «The operator interface shall be user friendly and/or easy to use.» | «The operator interface shall let a trained operator book a ground station contact in no more than 5 minutes.» (illustrativo; un requisito per ogni attività che conta) |
| Sostantivi espliciti, niente pronomi | Ogni «it», «its» o «this» ha esattamente un solo referente possibile? | 1.6.1: «The reference orbit shall repeat its ground track every 3 days.» | «The reference orbit shall repeat the ground track every 3 days.» Qui il pronome è innocuo, ma in una frase più lunga è la prima cosa a perdere il riferimento. |
| Condizioni indicate | Dice quando si applica il valore: fase di vita, modalità, ambiente? | «The solar arrays shall generate 30 W.» | «…at least 30 W orbit-average power at end of life.» |
| Valori definiti, o TBD tracciati | Ogni valore aperto è tracciato con un responsabile e una scadenza, e non solo scritto nel testo? | 3.5: «The thermal design shall keep the battery warm enough (TBD).» | «The thermal design shall keep the battery cell temperature at or above 0 °C while charging.» (illustrativo; finché l’analisi termica non lo fissa, l’attributo TBD nomina il Thermal Engineer e una scadenza) |
| Nessun motivo o nota nell’enunciato | Le frasi di scopo («so that», «in order to») e le note tra parentesi sono spostate nella motivazione? | 3.5: «(TBD)» | Enunciato senza parentesi; motivo nella Motivazione |
| Cosa, non come | Enuncia l’esigenza invece di imporre una soluzione che dovrebbe scegliere il livello inferiore? | «The thermal design shall keep the battery warm by means of a 2 W film heater.» (illustrativo) | La riscrittura di 3.5 qui sopra: un limite di temperatura, lasciando il riscaldatore alla progettazione termica |
| Positivo e realizzabile | Evita «not», «never», «always», «100%» dove si intende un limite misurabile? | «The C&DH shall never lose a stored command.» (illustrativo) | «The C&DH shall execute each stored command within 1 second of the scheduled time.» (4.2 così come è scritto) |
| Motivazione registrata | Dice perché è stato scelto il valore? | 3.1 senza motivazione | Motivazione: «Orbit-average load grew to 26 W after PDR; 30 W keeps 15% margin.» |
| Metodo e criteri di verifica | Il metodo è scelto e il criterio di superamento è derivato dall’enunciato? | 3.1: metodo Test; TC-06 prevede una potenza di picco ≥ 72 W | Criterio di superamento derivato attraverso il budget di potenza: circa 80,6 W di picco per 30 W di media orbitale (vedere la sezione successiva) |
| Tracciabile verso l’alto | Collegato a un’esigenza, a un padre o a un requisito di origine? | 3.1 senza alcun collegamento a monte | 3.1 derivato da 1.5 Daily Collection Volume |
| Univoco | Un altro requisito dice la stessa cosa con altre parole? | Un secondo «The battery shall store 77 Wh» nella sezione termica (illustrativo) | Un solo requisito, 3.2 Battery Capacity, richiamato dove serve |
Una checklist è uno strumento del revisore, non un modello di scrittura. Leggere ogni requisito una volta rispetto all’intero elenco anziché cercare una regola alla volta, e registrare il rilievo con la regola violata, così che l’autore sappia cosa cambiare. Le regole hanno anche falsi positivi. Un controllo basato su un elenco di parole segnala «every» in 1.6.1 come quantificatore universale, ma «every 3 days» è un periodo, non un’affermazione su tutti i casi; decide un revisore.
Scrivere il metodo di verifica e i criteri di accettazione insieme al requisito
La verificabilità è più facile da controllare nel momento in cui il requisito viene scritto: se l’autore non sa dire come si dimostrerebbe che è soddisfatto, il requisito non è finito. Registrare due cose con ogni requisito.
- Metodo di verifica: test, analisi, ispezione o dimostrazione, e il livello di assemblaggio a cui viene svolta (componente, sottosistema, sistema). EO-1 li ha tutti e quattro: 3.1 è verificato con test, 1.5 Daily Collection Volume con analisi, 3.4 Bus Regulation con ispezione e 6.1 Contact Scheduling con dimostrazione. La guida alla RVTM spiega come scegliere tra di essi.
- Criteri di successo (criteri di accettazione): il risultato osservabile che conta come soddisfatto, formulato in modo che il test o l’analisi si possa scrivere a partire da esso. Per 3.2 Battery Capacity: «Measured capacity of at least 77 Wh at C/2 and 20 °C.» Per 6.2 Image Delivery: «Products on the portal within 6 h for 95% of passes in rehearsal.»
Scrivere i criteri accanto all’enunciato intercetta una classe di errori che altrimenti emerge solo alla fine. Il 3.1 di EO-1 è verificato da TC-06 Solar Array Power Test, che misura la potenza di picco su un simulatore solare ed è superato a 72 W o più. Il requisito, però, riguarda la potenza media orbitale, e il modello converte l’una nell’altra con la frazione illuminata (0,62) e il rendimento della catena di potenza (0,6). Un picco di 72 W dà 72 × 0,62 × 0,6 = 26,8 W di media orbitale, sotto i 28 W originali, per non parlare degli attuali 30 W. La soglia del test non era stata derivata dal requisito. TC-06 ha misurato 75,1 W ed è stato «superato», eppure 75,1 W corrispondono a 27,9 W, al di sotto di entrambi i valori. Se il criterio fosse stato scritto a partire dall’enunciato, avrebbe indicato circa 30 / (0,62 × 0,6) = 80,6 W di picco, e la carenza sarebbe stata visibile al primo test. La guida all’analisi dell’impatto delle modifiche segue lo stesso rilievo attraverso la modifica da 28 W a 30 W.
La lezione è generale: un criterio di superamento dovrebbe essere riconducibile al valore del requisito tramite un calcolo che qualcuno possa verificare, e il calcolo va nella motivazione o nel piano di verifica, non nella memoria di un ingegnere.
Gestire i valori TBD e TBR
All’inizio di un progetto alcuni valori non sono ancora noti. Omettere il requisito nasconde la lacuna; inventare un numero nasconde l’incertezza. La prassi abituale è scrivere il requisito con un segnaposto e tracciare il segnaposto come punto aperto.
- TBD (to be determined, da determinare): nessun valore ancora. «The thermal design shall keep the battery cell temperature at or above TBD °C while charging.»
- TBR (to be reviewed, a volte «to be resolved», da rivedere): il miglior valore attuale, non confermato. «…within 60 seconds» con 60 contrassegnato TBR.
Preferire un TBR con una stima a un TBD nudo ogni volta che esiste una qualche base per un numero: i progettisti possono lavorare su una stima, e un valore che in seguito cambia è una modifica, che la tracciabilità seguirà. Ogni punto aperto ha bisogno di tre cose, altrimenti non viene gestito:
- Un responsabile, la persona che lo chiuderà.
- Una scadenza o milestone, di norma prima delle decisioni di progetto che ne dipendono.
- Un piano di chiusura: l’analisi, il test o la decisione che fisserà il valore.
La specifica di EO-1 ha tre punti aperti. 3.5 Battery Thermal Control è un TBD affidato al Thermal Engineer e già scaduto. 2.4 Target Slew («through 30 degrees within 60 seconds») è un TBR affidato all’ADCS Lead, e 5.3 Downlink Link Margin («at least 3 dB link margin at 10 degrees elevation») è un TBR affidato al Comms Lead; entrambi hanno valori di lavoro che i progetti usano mentre le analisi si concludono.
Contare i punti aperti a ogni milestone e aspettarsi che il numero diminuisca. Una baseline dei requisiti con molti TBD aperti è una baseline solo di nome. I criteri di revisione del NASA Systems Engineering Handbook chiedono, dalla revisione dei requisiti di sistema in poi, che i punti TBD e TBR aperti siano identificati con un piano e un calendario di chiusura. Il tracciamento va in un attributo o in un registro, non solo nel testo: un «TBD» digitato in una frase non ha responsabile né data, e nulla ricorda a nessuno di chiuderlo.
Tipi di requisito
Classificare i requisiti aiuta i revisori a porre le domande giuste e aiuta l’insieme a restare completo. Le categorie seguenti sono quelle comuni; ISO/IEC/IEEE 29148 e la guida INCOSE descrivono insiemi simili, e molti progetti ne aggiungono di propri.
| Tipo | Cosa enuncia | Esempio EO-1 | Da tenere d’occhio |
|---|---|---|---|
| Funzionale | Ciò che il sistema deve fare | 4.3 Fault Detection: «The C&DH shall enter safe mode within 10 seconds of undervoltage detection.» | Una funzione senza prestazione associata; la maggior parte dei requisiti funzionali ha bisogno anche di un «quanto bene», qui «within 10 seconds» |
| Prestazione | Quanto bene viene svolta una funzione: quantità, frequenza, accuratezza, tempo | 2.1 Pointing Accuracy: «The ADCS shall point the payload boresight within 0.1 degrees of the commanded target.» | Condizioni mancanti (quale modalità, quale fase di vita) e direzione del limite mancante |
| Interfaccia | Ciò che attraversa un confine con un altro sistema o elemento, e le sue caratteristiche | 5.2 UHF Command Uplink: «The UHF transceiver shall receive ground commands at 9.6 kbps.» La definizione completa si trova nel documento di controllo delle interfacce. | Requisiti che ripetono l’ICD invece di rimandarvi, così che i due divergono |
| Vincolo | Un limite al progetto o al modo in cui il sistema viene costruito, imposto dall’esterno | 4.4 Downlink Encryption: «The C&DH shall encrypt each downlink frame with 256-bit keys.» La sua motivazione: il contratto con il cliente richiede immagini cifrate durante la trasmissione, quindi il requisito viene dall’esterno del progetto, non da un trade-off al suo interno. | Scelte di progetto scritte come vincoli quando nessuno all’esterno le ha imposte |
| Ambientali, di affidabilità, di sicurezza | Condizioni a cui sopravvivere e affidabilità da raggiungere | 1.7 Mission Lifetime: «The spacecraft shall operate in orbit for at least 730 days.» | Valori senza la probabilità o la confidenza con cui sono dichiarati |
Il confine tra requisiti funzionali e di prestazione passa spesso all’interno di una stessa frase: molti requisiti enunciano una funzione con la sua prestazione, come fa 4.3. Va bene finché la frase contiene un solo obbligo. I requisiti di interfaccia sono trattati più a fondo nella guida al documento di controllo delle interfacce, e le funzioni dietro i requisiti funzionali nella guida all’analisi funzionale.
Esempio svolto: revisione della specifica di EO-1
Una revisione di SRS-001 con la checklist divide i 32 requisiti in tre gruppi. La maggior parte supera. Alcuni hanno rilievi minori che meritano una frase ciascuno. Tre vanno riscritti.
Un controllo automatico della stessa specifica concorda con la revisione: 29 requisiti su 32 risultano buoni, e i tre deboli vanno rielaborati. I rilievi per 2.5 elencano ogni regola violata per nome e numero, ed è ciò di cui un autore ha bisogno per correggerlo. Il controllo indica anche ciò che non può decidere: su 3.1, correttezza e fattibilità attendono un revisore perché il testo è cambiato dopo l’ultima revisione.
Rilievi minori
- 1.6.2 Off-Nadir Imaging, «up to 25 degrees off nadir»: «up to» si legge come un massimo, ma l’intento è una capacità che il veicolo deve avere a qualsiasi angolo da 0 a 25 gradi. Una lettura sbagliata renderebbe conforme un progetto che riprende solo al nadir.
- 1.6.1 Ground Track Repeat, «its ground track»: un pronome con un solo referente possibile, quindi il rilievo è minore. L’«every» nella stessa frase è un falso positivo di una regola sui quantificatori universali.
- 1.5 Daily Collection Volume ha un metodo (analisi) e criteri di successo («Simulated daily volume of at least 3.2 GB over a 30-day plan»), ma nessuna analisi ancora collegata. La formulazione va bene; la verifica non è fatta.
- 3.1 Orbit Average Power è scritto bene, ma il suo testo è cambiato dopo l’approvazione, quindi correttezza e fattibilità richiedono di nuovo il giudizio di un revisore. La fattibilità è la vera questione: i pannelli così come progettati danno circa 28 W di media orbitale.
Tre riscritture
2.5 Safe Mode Recovery. «The spacecraft should recover from safe mode quickly and resume imaging as appropriate» viola almeno sei regole: «should» invece di «shall», due obblighi uniti da «and», «quickly» senza valore, la clausola di scappatoia «as appropriate», nessun punto finale e nessuna verifica. La riscrittura mantiene l’unico risultato che conta per il cliente e gli dà un valore:
The spacecraft shall resume imaging within 6 hours of a safe mode entry.
La motivazione dovrebbe dire da dove vengono le 6 ore (N1 chiede avvisi sullo stress delle colture in giornata, e 6.2 concede 6 ore dalla trasmissione a terra alla consegna). Se i passi del ripristino contano di per sé, come riacquisire il puntamento verso il Sole o riportare la causa, ciascuno diventa un requisito a sé. Metodo: test, con iniezione di guasti sul flatsat; criterio di successo: la ripresa riprende entro 6 ore a ogni ingresso in modalità sicura iniettato.
3.5 Battery Thermal Control. «The thermal design shall keep the battery warm enough (TBD).» contiene un termine vago, un TBD nel testo e una parentesi. La correzione separa l’obbligo, il valore aperto e il motivo:
The thermal design shall keep the battery cell temperature at or above 0 °C while charging.
Gli 0 °C sono illustrativi: le celle agli ioni di litio di solito non vengono caricate sotto zero, ma il limite reale viene dalla scheda tecnica delle celle e dall’analisi termica. Finché quell’analisi non lo fissa, il valore è un TBR affidato al Thermal Engineer, con una scadenza prima della revisione del progetto termico. La riscrittura fa emergere anche una lacuna che l’originale nascondeva: non esiste un requisito per l’intervallo di temperatura in scarica, che richiede un proprio enunciato.
6.4 Operator Interface. «The operator interface shall be user friendly and/or easy to use.» contiene due termini soggettivi e un «and/or». L’usabilità si può specificare, ma solo attraverso attività osservabili:
The operator interface shall let a trained operator book a ground station contact in no more than 5 minutes.
L’attività e il tempo sono illustrativi. Un insieme reale elencherebbe le poche attività che contano (prenotare un contatto, caricare un elenco di bersagli, leggere l’ultima telemetria di stato), ciascuna con un tempo e un limite di errori, misurate in una dimostrazione con operatori che hanno completato la formazione.
Errori comuni
| Errore | Cosa va storto | Meglio |
|---|---|---|
| Scrivere soluzioni di progetto come requisiti | Il progetto è fissato prima che si faccia il trade-off, e un’opzione migliore viene esclusa senza che nessuno lo decida. | Enunciare l’esigenza («mantenere le celle a 0 °C o più durante la carica») e lasciare che il livello inferiore scelga il riscaldatore. |
| Copiare il linguaggio degli stakeholder direttamente nei requisiti | «Immagini fresche due volte a settimana» è un’esigenza; così come è scritta non è verificabile. | Mantenere l’esigenza, e scrivere un requisito con un valore e una condizione che la soddisfi (1.6 entro 72 ore). |
| Più requisiti in un paragrafo | Un identificativo porta più obblighi, che condividono un solo stato, un solo test e un solo destino. | Un requisito per elemento, un «shall» per enunciato. |
| Valori senza condizioni | «30 W» a inizio vita e a fine vita sono progetti diversi. | Indicare modalità, fase di vita, ambiente e criterio di media. |
| Nessuna motivazione | Nessuno può valutare una modifica successiva, e il requisito sopravvive a lungo dopo che il suo motivo è scomparso. | Scrivere il motivo e i numeri dietro il valore. |
| Soglie di test non derivate dal requisito | Un test viene superato mentre il requisito non è soddisfatto (TC-06 a 72 W di picco rispetto a 28 W di media orbitale). | Derivare il criterio di successo dall’enunciato tramite calcolo, e registrarlo. |
| TBD digitato nel testo e dimenticato | Il valore aperto non ha responsabile né data e arriva nella baseline. | Tracciare ogni TBD e TBR con un responsabile, una scadenza e un piano di chiusura. |
| Gold plating | Requisiti che nessuno ha chiesto consumano lavoro di progetto e di test. | Verificare che ogni requisito di primo livello sia tracciato a un’esigenza o a un’origine. |
| Affidarsi troppo ai controlli automatici | Un controllo delle parole senza rilievi viene scambiato per un requisito corretto. | Usare gli strumenti per le regole meccaniche; correttezza, fattibilità e necessità le giudica una persona. |
Provarlo in Holarch
In un progetto LML, ogni requisito è un’entità di classe Requirement con gli attributi descritti sopra: Rationale, Status, Priority, Criticality, Owner, Source, Verification Method, Verification Level, Success Criteria e i campi TBD/TBR.
- Creare la demo con Gestisci progetti → File di progetto ▾ → Nuovo progetto demo → CubeSat (ingegneria dei sistemi guidata). La sua specifica contiene i tre requisiti deboli e i punti TBD/TBR aperti usati in questa guida.
- Aprire Esigenze e requisiti → Qualità, scegliere il documento nell’elenco dell’ambito e fare clic su Controlla la qualità. Ogni requisito riceve un punteggio sulle nove caratteristiche, e i suggerimenti indicano i numeri delle regole della guida INCOSE che un elenco di parole o uno schema può verificare. Correct e Feasible richiedono un revisore: fare clic sul contrassegno per registrare la decisione.
- Riscrivere 2.5 come sopra ed eseguire di nuovo il controllo. I rilievi su congiunzione, clausola di scappatoia e termine vago scompaiono.
- Aprire Esigenze e requisiti → TBD/TBR per vedere i punti aperti con responsabili e scadenze, e Chiudi uno quando il suo valore è definito.
- Per un secondo parere sulle caratteristiche che una regola non può decidere, usare ✦ IA ▾ → Controllo requisiti con IA; ogni giudizio e ogni riscrittura vengono mostrati per la revisione prima che qualcosa cambi.
Il riferimento completo si trova nella documentazione di Qualità dei requisiti e del Registro TBD/TBR.
Scaricare la checklist
La checklist della qualità dei requisiti con esempi EO-1 prima e dopo (CSV) contiene le regole della checklist con le domande di revisione e gli esempi, da usare in una revisione o come punto di partenza per le regole di scrittura di un progetto. Lo stesso file è offerto dalla guida alla tracciabilità.
Domande sulla scrittura dei requisiti
Shall, must o will?
Qualsiasi convenzione funziona se la specifica la definisce e la rispetta. La più diffusa usa «shall» per i requisiti vincolanti, «will» per fatti e intenzioni riguardanti cose esterne al sistema e «should» per obiettivi che non vengono verificati. Alcune guide di stile governative preferiscono «must» per ragioni di linguaggio semplice. Il vero problema è mescolarle all’interno di una stessa specifica.
Quanti requisiti dovrebbe avere un sistema?
Non esiste un numero giusto. Un piccolo veicolo spaziale può avere qualche decina di requisiti di sistema e qualche centinaio sotto di essi; un grande programma ne ha migliaia. Domande più utili sono se ogni requisito è tracciato a un’esigenza o a un padre, e se ogni esigenza ha requisiti sotto di sé.
Le user story sono requisiti?
Una user story registra un’esigenza e il suo scopo nei termini dell’utente. Svolge il ruolo di un’esigenza degli stakeholder, e i suoi criteri di accettazione sono vicini ai criteri di verifica. Per un sistema che viene costruito, integrato e verificato come hardware e software insieme, le storie vanno comunque trasformate in requisiti che si possano allocare e testare.
Uno strumento può verificare la qualità dei requisiti?
Uno strumento può verificare in modo affidabile le regole meccaniche: verbi modali, congiunzioni, parole vaghe, clausole di scappatoia, pronomi, collegamenti mancanti. Non può sapere se 30 W è il valore giusto o se i pannelli possono fornirlo. Usare il controllo automatico per eliminare i rilievi meccanici prima di una revisione, così che i revisori dedichino il loro tempo a correttezza e fattibilità.
Dove andare dopo
- Tracciabilità dei requisiti e impatto delle modifiche: collegare questi requisiti a esigenze, progetto e test, e seguire una modifica.
- Analisi funzionale: trasformare i requisiti in funzioni e allocarle.
- Matrice di verifica dei requisiti: pianificare il metodo di verifica per ogni requisito e registrare i risultati.
- Esigenze e requisiti in Holarch: documenti, controlli di qualità, baseline e tracciabilità in un unico modello.