Come scrivere i requisiti di un software: modello da compilare

Guida pratica per chi commissiona un software: un modello in 8 sezioni per descrivere obiettivi, utenti, processi, dati, integrazioni, vincoli e criteri di accettazione, con un esempio compilato e il ruolo dell'IA.

Pubblicato il 20 novembre 20264 min di lettura
Un foglio diviso in otto sezioni numerate, da obiettivo a criteri di accettazione

I requisiti sono la descrizione, scritta, di cosa deve fare un software e per chi. Non serve il linguaggio dei tecnici: serve chiarezza. Un buon documento di requisiti riduce i malintesi, rende confrontabili i preventivi e permette di verificare, alla consegna, se il lavoro è stato fatto.

Questa guida ti dà un modello da copiare. Compilarlo richiede da due a quattro ore, e ne fa risparmiare molte di più.

Come si usa

  1. Copia le otto sezioni qui sotto in un documento.
  2. Rispondi con frasi brevi, scrivendo cosa serve e perché, non come realizzarlo.
  3. Fallo leggere a chi userà il software ogni giorno: scoprirà cose che tu non hai considerato.
  4. Dove non sai rispondere, scrivi "da definire": è un'informazione utile anche quella.

Il modello in otto sezioni

1. Obiettivo

Che problema risolve il software? Una frase, con un risultato misurabile.

Esempio: "Oggi gli ordini arrivano per telefono e mail e si perdono tra ufficio e magazzino. Vogliamo che ogni ordine abbia un unico stato visibile a tutti e che gli errori di consegna scendano da circa 8 al mese a meno di 2."

2. Utenti

Chi lo userà? Per ciascun tipo di utente: quante persone, quanto è esperto, da dove lavora (ufficio, cantiere, telefono).

Esempio: "3 persone in ufficio ordini; 4 magazzinieri con telefono; il titolare, solo per i report. I clienti non accedono."

3. Processi

Descrivi, passo per passo, come funziona oggi il lavoro che il software deve coprire, e come dovrebbe funzionare domani. Elenca anche le eccezioni: "se il cliente è X, lo sconto cambia", "se l'ordine supera Y, serve approvazione".

Le eccezioni sono la parte che più spesso manca e che più costa scoprire a progetto avviato.

4. Dati

Quali informazioni devono essere registrate (clienti, prodotti, ordini, ore…), da dove arrivano oggi (Excel, gestionale, carta) e quante sono approssimativamente (100 clienti o 100.000?). Indica se ci sono dati personali o sensibili: cambiano gli obblighi e le misure di sicurezza.

5. Collegamenti con altri sistemi

Con quali altri programmi deve scambiare dati: fatturazione elettronica, e-commerce, contabilità, posta, strumenti dei clienti. Per ciascuno: che dati, in che direzione, quanto spesso.

6. Vincoli

Tutto ciò che limita le scelte: budget massimo, data entro cui serve, sistema su cui deve girare, obblighi di legge, regole di sicurezza aziendali, tecnologie già in uso.

7. Priorità

Dividi le funzioni in tre gruppi: indispensabili (senza non si parte), importanti (servono presto), desiderabili (si vedrà). Questa lista ti permette di decidere cosa fare per primo e dove tagliare se il budget è insufficiente (vedi "Quanto costa un MVP").

8. Criteri di accettazione

Come capirai che il lavoro è finito? Scrivi 5–10 prove concrete.

Esempio: "Un ordine inserito dall'ufficio compare sul telefono del magazziniere entro 10 secondi. Un utente senza permessi non può vedere i prezzi. Il report mensile coincide con il foglio Excel di prova."

Errori da evitare

E l'intelligenza artificiale?

Puoi usare uno strumento di IA per mettere in ordine le tue note e verificare che nel documento non manchino sezioni. Ma non fargli inventare i requisiti: non conosce la tua azienda e produrrà frasi plausibili ma generiche, che sembrano complete e non lo sono. I requisiti nascono dal confronto con le persone, e la loro validazione la fa un analista o un project manager, non un testo generato (vedi "I ruoli di un progetto software").

Cosa fare dopo

Consegna il documento a due o tre professionisti e chiedi un preventivo sullo stesso testo: avrai offerte confrontabili. Su LancerJob, quando il portale sarà online, potrai usare lo stesso testo come base per pubblicare una richiesta di progetto. Iscriviti alla waitlist per essere avvisato.