1. Cos'è l'UAT e perché non è un test tecnico
Lo user acceptance test, abbreviato in UAT, è la verifica che il software funzioni per chi lo userà davvero. Non cerca errori di programmazione, che dovrebbero essere già stati trovati dai test tecnici. Chiede invece se il sistema supporta il lavoro reale, se le schermate hanno senso, se i calcoli corrispondono a quelli che gli utenti si aspettano e se un'operazione tipica si completa senza passaggi inutili. Verifica il lavoro, non il codice.
Per questo l'UAT va condotto da utenti reali, non dallo sviluppatore o dal solo responsabile di progetto. Chi approva il collaudo deve conoscere il processo e avere l'autorità di dire che il software è accettabile. Un collaudo fatto da persone che conoscono il sistema a memoria non rivela ciò che serve davvero a chi lavora ogni giorno. Il collaudo a campione non basta.
2. Definire i criteri di accettazione
I criteri di accettazione sono le condizioni che il software deve soddisfare per essere accettato. Vanno scritti prima del collaudo, collegati alle specifiche e misurabili. Un criterio come 'il sistema deve essere veloce' non serve a nulla. Un criterio come 'un ordine standard si inserisce e si conferma senza uscire dalla schermata' è verificabile, e chi collauda sa esattamente cosa controllare. Un criterio scritto male finisce per essere interpretato da chi collauda, e le interpretazioni divergono.
Ordina i criteri per priorità. Le funzioni che bloccano il lavoro, come la fatturazione o la gestione delle pratiche obbligatorie, devono superare il collaudo senza eccezioni. Le funzioni di comodità possono essere accettate con difetti noti, purché documentati e con una data di correzione concordata. Scrivi per ciascun criterio chi lo verifica e con quale esito atteso. Così il collaudo resta oggettivo.
3. Scrivere gli scenari di prova
Uno scenario di prova racconta un lavoro completo dall'inizio alla fine, con dati realistici e un esito atteso. Esempi generici: un cliente nuovo viene inserito, riceve un'offerta, accetta e genera un documento; una pratica viene aperta, assegnata, chiusa e archiviata. Lo scenario copre i passaggi principali e le eccezioni più frequenti, come un dato mancante o un'approvazione negata. Non include la soluzione attesa.
Scrivi gli scenari insieme a chi li esegue, usando il linguaggio del lavoro quotidiano. Evita istruzioni tecniche del tipo 'clicca sul pulsante verde'. Scrivi invece 'conferma la spedizione e controlla che la giacenza diminuisca', così il collaudo verifica il risultato e non l'interfaccia. Scrivere con il linguaggio dell'utente rende lo scenario comprensibile anche a chi non ha partecipato alla progettazione.
4. Eseguire il collaudo
L'esecuzione richiede un ambiente di prova che assomigli alla produzione, con dati realistici ma anonimizzati o fittizi, e un registro dove annotare ogni esito. Ogni scenario va eseguito come è scritto, senza suggerimenti da parte del fornitore, e ogni deviazione va annotata con il passo esatto in cui si è verificata. Il tempo di ogni prova va annotato, perché mostra dove si concentra la fatica.
Mantieni distinti i difetti dalle richieste nuove. Una richiesta di funzione emersa durante il collaudo va valutata come modifica, con la procedura prevista dal contratto, e non dovrebbe bloccare l'accettazione del perimetro concordato. Ogni richiesta nuova va registrata a parte, con il suo impatto su tempi e costi, e discussa solo dopo il verbale di accettazione. Non blocca il rilascio del perimetro già concordato.
- Prepara l'ambiente con dati di prova e verifica che gli utenti abbiano accesso.
- Esegui gli scenari nell'ordine previsto, senza interventi dello sviluppatore.
- Registra per ogni scenario esito, data, utente e note.
- Apri una segnalazione per ogni difetto, con i passi per riprodurlo e la gravità.
- Rivedi le segnalazioni ogni giorno con il fornitore e assegna le correzioni.
- Riesegui gli scenari corretti prima di chiudere la segnalazione.
5. Gravità dei difetti
La gravità dei difetti determina cosa blocca il rilascio. Un errore che impedisce un'operazione obbligatoria o che produce dati sbagliati è bloccante. Un errore estetico o un'etichetta poco chiara può restare aperto. Definisci le categorie prima di iniziare, così che la discussione non si riapra ogni volta che compare un problema. Lo stesso vale per i difetti che nessuno riesce a riprodurre: vanno registrati comunque.
Stabilisci anche chi può dichiarare un difetto risolto e chi lo accetta come noto. Il rischio tipico è che il fornitore chiuda le segnalazioni senza una nuova prova degli utenti. La regola più semplice è che solo chi ha segnalato il difetto, o un suo delegato, conferma la correzione. Chi chiude una segnalazione indica la versione verificata e la data.
| Gravità | Esempio generico | Effetto sul rilascio |
|---|---|---|
| Bloccante | Un'operazione obbligatoria non si completa | Il rilascio non avviene |
| Grave | Un calcolo produce un risultato errato in un caso raro | Rilascio solo con correzione concordata e data certa |
| Lieve | Un messaggio poco chiaro in una schermata secondaria | Accettabile con correzione programmata |
| Cosmetico | Un allineamento non ideale | Non blocca il rilascio |
6. Verbale di accettazione e decisione
Il collaudo si chiude con un verbale che riporta gli scenari eseguiti, l'esito di ciascuno, i difetti aperti con la loro gravità e la decisione finale. La decisione è di go, di no-go o di go condizionato a correzioni con date precise. Il verbale va firmato da chi ha il potere di accettare il software, non solo da chi lo ha testato.
Il verbale è anche un documento contrattuale: a seconda di come è scritto il contratto, può far decorrere garanzie, fasi di pagamento o la manutenzione. Verificalo con il legale prima di firmarlo, perché la data di accettazione spesso ha effetti precisi. Il verbale deve riportare anche il nome di chi firma e il ruolo che ha nel progetto. Senza firma, il verbale vale poco.
7. Errori comuni nel collaudo
Gli errori più frequenti nel collaudo sono di organizzazione più che di tecnica. Riconoscerli ti permette di correggere il percorso prima che il collaudo diventi una formalità. Scegli il tipo di errore più probabile nel tuo progetto e costruisci il controllo intorno a quello, invece di seguire una lista generica di rischi che non ti riguardano. Confronta la lista con gli scenari già scritti.
Un altro errore è non dedicare tempo reale al collaudo. Chi usa il sistema ogni giorno deve poter sospendere parte del suo lavoro per provarlo. Se il tempo non è previsto nel piano, il collaudo viene fatto di fretta e le correzioni arrivano dopo il rilascio, quando costano di più. Chiedi conto di ogni chiusura, con la data e il nome di chi l'ha verificata.
- Collaudare solo le funzioni nuove e non i processi che attraversano più reparti.
- Iniziare il collaudo quando il software non è ancora stabile.
- Usare solo lo sviluppatore come tester.
- Accettare per stanchezza, dopo lunghe settimane di difetti aperti.
- Chiudere le segnalazioni senza riesecuzione degli scenari.
8. Come iniziare questa settimana
Individua due processi che il nuovo software deve coprire e scrivi per ciascuno uno scenario completo con la persona che lo svolge. Non serve aspettare il software per farlo: gli scenari sono anche la base per le specifiche e per il prototipo. Chiedi a chi usa il processo quali passaggi non possono fallire. Scrivili come scenari, con l'esito atteso. Sono la base dei criteri.
Poi definisci i criteri di gravità e la data prevista per il verbale. Se il fornitore non accetta di lavorare con questi strumenti, è un'informazione importante per la scelta. La guida sulla scrittura delle specifiche spiega come collegare gli scenari ai requisiti. Il tempo per definire questi criteri è ben speso, perché evita discussioni a collaudo avviato. Anche una sola riunione breve basta per iniziare.
Domande frequenti
Chi deve fare lo UAT?
Le persone che svolgono il lavoro ogni giorno, con l'affiancamento del responsabile di processo. Il fornitore supporta, registra e corregge, ma non dovrebbe essere l'unico ad approvare. Chi ha scritto il codice non è il giudice più adatto del proprio lavoro.
Quanto deve durare il collaudo?
Dipende dalla complessità dei processi e dalla disponibilità degli utenti. Un collaudo serio richiede tempo reale, non un ritaglio tra un impegno e l'altro. Pianificalo come fase con date e risultati attesi, e lascia spazio per una nuova esecuzione degli scenari dopo le correzioni.
Posso fare il collaudo sui dati reali?
Preferibilmente no, o solo con cautela. I dati reali contengono informazioni personali e commerciali che non dovrebbero circolare in un ambiente di prova meno protetto. Usa dati fittizi o anonimizzati che abbiano la stessa struttura e le stesse eccezioni dei dati reali.
Cosa succede se il collaudo non viene superato?
Si decide tra correzione, rinvio o modifica del perimetro. Il no-go non è un fallimento se è motivato e documentato. È invece un problema grave accettare il software per evitare il ritardo. Le condizioni per tornare a collaudare devono essere scritte nel verbale.
Il verbale vale come prova?
Può esserlo, purché sia completo e firmato da chi ha la titolarità della decisione. Conserva gli scenari eseguiti, le segnalazioni e le versioni del software testate. In caso di contestazione sul risultato di un progetto, sono questi elementi a ricostruire cosa è stato accettato e quando.