Quaderno di collaudo: definizione, contenuto e metodo di stesura
Un quaderno di collaudo (« cahier de recette » in francese) è il documento che elenca tutti i casi di test da eseguire prima di accettare un software: per ciascun caso, i passaggi da seguire, i dati da usare e il risultato atteso. Verifica che la consegna sia conforme alla specifica, e i suoi risultati alimentano il verbale di collaudo che registra l'accettazione. È noto anche come piano di test UAT o script di test UAT.
A cosa serve un quaderno di collaudo?
Il quaderno di test trasforma una specifica, per forza scritta in linguaggio comune, in verifiche concrete che qualsiasi tester può ripetere. Svolge quattro funzioni:
- Verificare la conformità: ogni requisito della specifica è coperto da almeno un caso di test.
- Condividere un riferimento: prima dell'inizio dei test, fornitore e cliente concordano su ciò che verrà verificato e su ciò che ci si aspetta da ogni funzione.
- Tracciare i risultati: ogni esecuzione viene registrata (OK, KO, bloccato o non applicabile), con i relativi commenti e difetti.
- Decidere sulla consegna: il riepilogo dei risultati sostiene il giudizio del verbale di collaudo (accettato, accettato con riserve o respinto).
Chi redige e chi esegue il quaderno di collaudo?
La ripartizione dipende dal contratto. Più spesso è il fornitore (l'appaltatore, detto MOE nei progetti francesi) a redigere il quaderno a partire dalla specifica e a sottoporlo alla revisione del cliente (il committente, MOA). Anche il cliente può redigerlo. L'esecuzione spetta agli utenti di business del cliente, talvolta affiancati da un tester del fornitore, sotto la guida di un responsabile di progetto.
Nelle società di servizi informatici e nelle agenzie, il quaderno è in genere redatto dal fornitore e poi eseguito da tester lato cliente: devono poterlo leggere e inserire i risultati senza uno strumento pesante. Vedere Spec2Sign per società IT e agenzie.
Cosa contiene un quaderno di collaudo?
Un quaderno di collaudo è in genere una tabella in cui ogni riga è un caso di test. Le colonne più comuni sono:
| Colonna | Scopo |
|---|---|
| Identificativo | Riferimento univoco del caso (ad esempio CT-012), riutilizzato nei difetti e nel verbale. |
| Requisito di origine | Paragrafo o requisito della specifica che il caso verifica: è ciò che dimostra la copertura. |
| Lotto o modulo | Raggruppamento funzionale, utile per ripartire l'esecuzione tra più tester. |
| Titolo | Ciò che il caso verifica, in una frase. |
| Precondizioni e dati di test | Stato iniziale, account da usare, valori di prova. |
| Passaggi | Azioni da eseguire, una per riga, in ordine. |
| Risultato atteso | Comportamento osservabile che convalida il caso. |
| Priorità | Peso del caso nella decisione di accettazione. |
| Stato | OK, KO, bloccato o non applicabile, da compilare durante l'esecuzione. |
| Commento e difetto | L'osservazione del tester e un link al difetto aperto in caso di scostamento. |
Come redigere un quaderno di collaudo in 6 passaggi
- Estrarre i requisiti verificabili dalla specifica. Un requisito vago (« il sito deve essere veloce ») va chiarito con il cliente prima di scrivere qualsiasi caso.
- Organizzare in lotti e moduli che rispecchino l'applicazione (autenticazione, ordine, fatturazione…), in modo da poter ripartire e seguire l'esecuzione.
- Scrivere i casi: un solo obiettivo di test per caso, passaggi brevi all'imperativo e un risultato atteso osservabile senza interpretazione.
- Prevedere dati di test e prerequisiti: account, diritti, stati iniziali. Un caso che non si può ripetere per mancanza di dati finisce « bloccato ».
- Dare priorità: se il tempo stringe, i casi critici devono essere eseguiti per primi. Indicare anche cosa blocca la consegna e cosa può diventare una riserva.
- Farlo rivedere dal cliente, poi versionare il quaderno insieme alla specifica che verifica. Un quaderno che non segue la versione della specifica non dimostra più nulla.
Esempio di caso di test
| Campo | Contenuto |
|---|---|
| Identificativo | CT-012 |
| Requisito di origine | Autenticazione, § 2.3: una password errata viene rifiutata. |
| Titolo | Accesso con una password errata |
| Precondizioni | Esiste un account attivo con l'indirizzo [email protected]. |
| Passaggi | 1. Aprire la pagina di accesso. 2. Inserire [email protected] e una password errata. 3. Fare clic su « Accedi ». |
| Risultato atteso | Viene visualizzato un messaggio di errore chiaro, l'utente resta sulla pagina di accesso e non ottiene accesso ad alcun dato. |
| Priorità | Alta |
Stati di esecuzione di un caso di test
| Stato | Significato |
|---|---|
| OK | Il risultato osservato corrisponde al risultato atteso. |
| KO | Si osserva uno scostamento: viene aperto un difetto e collegato al caso. |
| Bloccato | Il caso non può essere eseguito (prerequisito mancante, difetto bloccante a monte). |
| N/A | Il caso non si applica a questa versione o a questo perimetro. |
Al termine della campagna, il numero di casi per stato e la gravità dei difetti residui sono la base del giudizio del verbale di collaudo.
Collaudo, VABF, VSR: qual è la differenza?
Il collaudo (« recette » in francese) è l'intera fase di verifica che porta all'accettazione del software. In alcuni contratti, in particolare i contratti informatici pubblici francesi, si divide in due fasi: la VABF (verifica di idoneità al buon funzionamento), che controlla che il sistema consegnato funzioni come previsto, poi la VSR (verifica di servizio regolare), che ne osserva il funzionamento nel tempo in condizioni reali di produzione. Durata e criteri sono fissati dal contratto.
Il quaderno di test descrive ciò che viene verificato; queste sigle indicano il momento e il quadro contrattuale della verifica. Trova queste definizioni nel glossario del collaudo software.
Errori comuni
- Redigere il quaderno alla fine del progetto, quando non resta più tempo per correggere la specifica ambigua che esso rivela.
- Casi senza un risultato atteso misurabile (« la pagina viene visualizzata correttamente »): due tester concluderanno in modo diverso.
- Nessun legame con i requisiti: impossibile dire cosa non è coperto.
- Una specifica che cambia e un quaderno che non la segue: i casi testano una versione che non esiste più.
- Più versioni dello stesso file Excel in circolazione per e-mail, con risultati inseriti in più posti.
Excel o uno strumento dedicato?
Per un piccolo progetto con un solo tester, un foglio di calcolo basta. Non appena il collaudo coinvolge più tester, versioni successive della specifica e il tracciamento dei difetti, uno strumento dedicato evita i duplicati e mantiene la tracciabilità. Il confronto tra Excel, strumenti di gestione dei test e Spec2Sign illustra i criteri di scelta.
Generi il suo quaderno di collaudo con Spec2Sign
Spec2Sign produce il quaderno di collaudo a partire dalle sue specifiche:
- carica la specifica (PDF, Word, Excel o Markdown);
- l'IA estrae i requisiti, citati alla lettera con la loro fonte, e propone un piano in lotti e moduli;
- per ogni requisito scrive casi di test con passaggi, risultato atteso, priorità e dati di test, e segnala i punti da chiarire che la specifica lascia aperti;
- una matrice di copertura mostra i requisiti privi di caso di test;
- quando la specifica cambia, un' analisi d'impatto propone i casi da aggiungere, modificare o rendere obsoleti, che lei accetta riga per riga.
Il quaderno generato è una proposta: lo riveda e lo convalidi prima di qualsiasi uso contrattuale.
Domande frequenti
Qual è la differenza tra un quaderno di collaudo e un piano di test?
Il piano di test descrive la strategia: perimetro, tipi di test, ambienti, risorse e calendario. Il quaderno di collaudo ne è la parte operativa: l'elenco dei casi di test precisi da eseguire, con il relativo risultato atteso. In molti progetti di società IT e agenzie, il quaderno viene prodotto direttamente, preceduto da poche righe di inquadramento.
Quando va redatto il quaderno di collaudo?
Non appena la specifica è stabile, non alla fine dello sviluppo. Scrivere i casi in parallelo fa emergere presto le ambiguità della specifica, quando risolverle costa ancora poco.
Quanti casi di test servono?
Non esiste un numero universale. L'obiettivo minimo è che ogni requisito sia coperto da almeno un caso; poi si aggiungono casi limite e di errore sulle funzioni critiche. Dare priorità ai casi permette di eseguire l'essenziale se il tempo stringe.
Si può generare un quaderno di collaudo con l'IA?
Sì. Spec2Sign estrae i requisiti da una specifica e scrive i casi di test corrispondenti, ciascuno collegato al paragrafo di origine. Il risultato resta una proposta che una persona deve rivedere e convalidare prima di usarla per il collaudo.