Una matrice di tracciabilità dei requisiti è una tabella che collega ogni requisito ai test che lo verificano e ai difetti che lo fanno fallire. La maggior parte dei team ne costruisce una per un audit, la compila una volta e non la riapre mai più, perché il modo in cui di solito viene costruita risponde a una domanda che nessuno si pone due volte: “ogni requisito è coperto da un test?”

Quella domanda ha una risposta utile esattamente una volta, prima del rilascio. La domanda che si presenta ogni settimana va nel senso opposto, e comincia con un bug.

Due direzioni, e ne viene usata solo una

Una matrice di tracciabilità si può leggere in avanti o all’indietro.

In avanti, dal requisito al test: ogni requisito ha qualcosa che lo verifica? È la direzione per cui i modelli sono pensati, ed è davvero utile farla prima di un rilascio. Un requisito con la colonna dei test vuota è una promessa che nessuno sta verificando.

All’indietro, dal difetto al requisito che viola: quando arriva una segnalazione, quale comportamento concordato contraddice, e quale test avrebbe dovuto intercettarla? È la direzione usata ogni giorno, e la maggior parte delle matrici la rende difficile, perché la colonna dei difetti è stata aggiunta a posteriori.

Debole
Un foglio di requisiti con una colonna "ID dei casi di test", compilata per l'audit e congelata il giorno in cui l'audit è stato superato.
Meglio
Le stesse righe, tenute vive dai difetti: ogni nuovo bug è collegato al requisito che viola, oppure fa emergere un requisito che nessuno aveva scritto.

La lettura all’indietro è dove la matrice si ripaga, perché chiude una discussione che altrimenti non ha un arbitro. Un difetto è un comportamento che contraddice qualcosa di concordato. Se una segnalazione non può essere ricondotta a nessuna riga, non è un bug nel senso concordato: è una nuova richiesta o una lacuna nei requisiti, e l’una e l’altra meritano una conversazione diversa da “sistemalo”.

Il modello

Cinque colonne. Mantieni il testo dei requisiti abbastanza breve da leggerlo nella tabella: il testo completo sta dove stanno i tuoi requisiti.

# Matrice di tracciabilità: [prodotto o release]

**Ultima revisione:** [data]
**Responsabile:** [chi mantiene aggiornata questa matrice]

| Requisito | Cosa deve essere vero | Casi di test | Ultimo risultato | Difetti aperti |
| --- | --- | --- | --- | --- |
| [ID-REQ] | [il criterio di accettazione, su una riga] | [ID dei TC, oppure NESSUNO] | [superato / fallito / bloccato, e la build] | [ID dei bug, oppure nessuno] |
| [ID-REQ] | [il criterio di accettazione, su una riga] | [ID dei TC, oppure NESSUNO] | [superato / fallito / bloccato, e la build] | [ID dei bug, oppure nessuno] |

## Difetti senza requisito

Segnalazioni che non corrispondono a nessuna riga sopra. Ognuna è o una
nuova richiesta o un requisito che nessuno ha scritto. Decidi quale, poi spostala.

| Difetto | Cosa è successo | Decisione |
| --- | --- | --- |
| [ID del bug] | [una riga] | [nuova richiesta / requisito mancante, e chi ne è responsabile] |
Modello di matrice di tracciabilitàtraceability-matrix.it.txt937 ByteScarica

Le righe che dicono qualcosa

Una matrice è per lo più fatta di righe che non dicono niente: un requisito, due test, entrambi superati, nessun difetto. Il valore sta in quattro schemi, ed è meglio leggere la matrice per quelli invece che dall’alto in basso.

Un requisito senza test. Scritto NESSUNO, di proposito, invece di lasciare la cella vuota. Una cella vuota sembra dire “qualcuno si è dimenticato di compilarla”; NESSUNO sembra una decisione, che è ciò che dovrebbe essere.

Un requisito i cui test risultano superati e che ha ancora difetti aperti. È la riga più istruttiva della tabella. I test verificano qualcosa di diverso da ciò che gli utenti stanno incontrando, il che di solito significa che il criterio di accettazione era troppo stretto, oppure che il test controlla solo il percorso felice e i difetti vivono in uno stato iniziale che nessuno ha nominato.

Un test che non risale a nessun requisito. O verifica qualcosa che conta e il requisito non è mai stato scritto, oppure verifica qualcosa che nessuno ha concordato e costa tempo a ogni esecuzione.

La sezione in fondo. È dai difetti senza requisito che nascono le discussioni sull’ambito. Un team che tiene visibile quella lista ha la discussione una volta sola, presto, con una decisione registrata accanto. Un team che non lo fa ce l’ha in ogni riunione di triage.

Una matrice di test è una griglia diversa

I due nomi vengono usati come se fossero intercambiabili, ma descrivono cose diverse.

Una matrice di tracciabilità incrocia requisiti e test. Una matrice di test incrocia test e configurazioni: lo stesso caso di test eseguito sui browser, sui dispositivi e negli ambienti che contano, così che una cella dica “test 14 su Safari su un iPhone: fallito”. Risponde a una domanda diversa, che non è “è coperto?” ma “dove si rompe?”.

Le due si incontrano nella colonna dei difetti. Un bug che fallisce in una cella della matrice di test e risulta superato nelle altre non è un requisito fallito, è una configurazione fallita, e registrarlo sul requisito come se fosse rotto ovunque manda la correzione nel posto sbagliato. La guida al cross-browser testing mostra quante poche configurazioni servano davvero a questa griglia.

Tenerla viva

Una matrice costruita una volta sola è accurata per una settimana. Quelle che restano utili vengono alimentate da qualcosa che succede comunque.

Collegala al triage invece che al calendario delle release: quando un difetto viene sottoposto a triage, chi lo fa compila il requisito che viola, oppure lo aggiunge alla sezione in fondo. È un passaggio di trenta secondi su una decisione che si prende comunque, ed è il passaggio che mantiene in funzione la direzione all’indietro. Il resto della tabella cambia di rado: i requisiti quando cambia l’ambito, i casi di test quando il modello di caso di test riceve un nuovo caso, i risultati a ogni esecuzione.

La colonna dei requisiti vale quanto i requisiti stessi. Se sono aggettivi, la matrice collega i difetti a frasi che nessuno può verificare. La guida ai criteri di accettazione spiega come scriverli in modo che un difetto possa davvero contraddirli.

Dove incontra un rapporto di bug

La direzione all’indietro funziona solo se una segnalazione contiene abbastanza elementi per risalire. “Il checkout è rotto” non si collega a nulla. “Pagare con una carta salvata fallisce con un errore dopo il passaggio dell’indirizzo, in Safari, su un account con due carte salvate” si collega a un requisito, a un caso di test e probabilmente a una cella di configurazione che la matrice di test non ha mai eseguito.

Session Replay

Estensione Chrome gratuita. Un clic sulla pagina che non funziona cattura lo screenshot, la console e il log di rete, e ti dà un link da incollare nel ticket.

Ottieni l'estensione

Il browser, la pagina, i passaggi e ciò che il server ha restituito sono ciò che trasforma una lamentela in una riga della matrice. La guida ai rapporti di bug copre il resto di ciò che una segnalazione deve contenere.

La versione breve

Collega i requisiti ai test e ai difetti, e leggila all’indietro: da un nuovo bug al requisito che viola. Scrivi NESSUNO dove non c’è un test, di proposito. Tieni una sezione per i difetti che non risalgono a nulla, perché è lì che iniziano le discussioni sull’ambito. E tieni a parte una matrice di test, per la domanda su dove fallisce un test che di solito risulta superato.