Documento dei requisiti di un’app: cos’è la specifica e perché la approvi

La specifica di una pagina che approvi per prima: copertina dell'articolo del blog di Deployflix

Un documento dei requisiti di un’app, o specifica dell’app, è un breve piano scritto di un’app prima che qualcuno la crei: chi la userà, le schermate che vede ciascuno, le informazioni che conserva, i servizi a cui si collega, cosa è escluso per ora e quanto può costare al massimo la creazione. Tu la leggi, la metti in discussione e la modifichi, e solo quando descrive l’app che vuoi davvero la approvi.

La approvi prima perché la specifica è il posto più economico per trovare un errore. Spostare una riga su una pagina non costa nulla. Scoprire dopo la creazione che i tutor possono vedere il numero di telefono di tutti i genitori, o che le rette non si possono pagare a rate, significa rifare il lavoro.

Cos’è una specifica software, in parole semplici?

Nel software, una specifica (nei progetti più grandi spesso chiamata documento dei requisiti, o SRS, da software requirements specification) è l’accordo tra chi ha bisogno dell’app e chi la crea. Dice cosa deve fare l’app, non come lo fa il codice. Per un negozio, un circolo o una scuola, di solito basta una pagina, purché sia precisa e scritta in parole semplici.

Il test di una specifica è semplice: due creatori diversi potrebbero leggerla e realizzare più o meno la stessa app? Se la pagina dice gli studenti possono vedere i loro risultati, è un desiderio. Se dice uno studente accede con il numero di telefono e vede i voti delle proprie verifiche, per materia, accanto alla media del gruppo, è un requisito che qualcuno può realizzare e tu puoi verificare.

Cosa c’è in un documento dei requisiti di una pagina?

Prendi un centro di ripetizioni che vuole un’app per lezioni, presenze e rette. Una specifica di una pagina utile per questo caso ha queste parti:

Parte della specificaCosa diceEsempio per un centro di ripetizioni
Chi la usaOgni tipo di persona che accede e cosa può fareTitolare, tutor, studenti e genitori; solo il titolare vede i totali delle rette
Schermate per ruoloLe pagine che vede ogni ruolo e cosa vi faTutor: le lezioni di oggi, segnare le presenze, inserire i voti delle verifiche. Genitore: presenze, voti, rette da pagare
Dati conservatiI dati che l’app memorizza e cosa contiene ciascunoStudenti, classi, presenze per lezione, verifiche e voti, rate delle rette e ricevute
IntegrazioniI servizi esterni a cui si collega, e comePagamento online delle rette tramite un gateway di pagamento, con una ricevuta per ogni rata
Escluso per oraCosa non farà questa versioneNessun controllo delle sovrapposizioni d’orario; nessuna importazione dei dati dell’anno scorso
Tetto di spesaIl costo massimo della creazioneUn massimo mostrato prima dell’approvazione, non una stima dopo il lavoro

Le schermate per ruolo sono la parte che si tende a leggere di corsa, ed è quella che conta di più. Un’app in realtà è più app che condividono un unico insieme di dati: la vista del titolare, quella del tutor e quella del genitore. Leggere le schermate ruolo per ruolo è il modo per accorgerti che un tutor può segnare le presenze ma nessuno può correggervi un errore.

La riga escluso per ora è altrettanto importante. Ti dice cosa non stai ottenendo, che è la fonte abituale di delusione dopo una creazione. Un elenco breve e onesto di esclusioni è il segno di una buona specifica, non di una debole.

Quando descrivi un’app ad Deployflix, la specifica che scrive segue questa struttura: chi usa l’app, le sue schermate, i dati che conserva, cosa è escluso per ora e quanto può costare al massimo la creazione, nella lingua in cui hai scritto. Se qualcosa nella tua descrizione non è chiaro, chiede prima di pianificare. Come funziona mostra dove si colloca la specifica tra i vari passi.

Come leggere la specifica di un’app e metterla in discussione?

Non leggere una specifica come un contratto, dall’inizio alla fine. Leggila come una giornata nella tua attività.

  1. Percorri una giornata reale nei panni di ogni ruolo. Cosa tocca, cosa vede, cosa inserisce? Poi fai lo stesso per ogni altro ruolo.
  2. Segui un dato dall’inizio alla fine. Scegli un singolo studente, ordine o prenotazione. Chi lo crea, chi lo modifica, chi può cancellarlo, e dove va a finire?
  3. Cerca i percorsi che vanno storti. Una prenotazione annullata, un rimborso, un inserimento sbagliato, un pagamento che non va a buon fine, un iscritto che se ne va. Se la specifica descrive solo le cose che vanno bene, chiedi cosa succede quando non è così.
  4. Controlla ogni numero e ogni parola che stamperesti. Formati delle fatture, rate, righe delle imposte e numeri delle ricevute devono corrispondere a come lavori oggi. Se le tue fatture devono riportare un’imposta come GST, IVA o imposta sulle vendite, verifica i dettagli con il tuo commercialista.
  5. Chiedi chiarimenti su tutto ciò che è vago. Parole come gestire, monitorare, facile e report nascondono decisioni. Chiedi: quale report, che mostra cosa, per chi?

Quali lacune cercare prima di approvare?

La maggior parte delle specifiche che non funzionano non sono sbagliate; sono incomplete. Queste sono le lacune che emergono più spesso.

Chi può vedere cosa

I ruoli sono facili da nominare e facili da lasciare vaghi. Controlla cosa può vedere ogni ruolo, non solo cosa può fare. Un tutor può vedere le rette? Un genitore può vedere i voti del figlio di un altro? Un dipendente può scaricare l’elenco clienti? Se l’app conserva informazioni personali, decidi ora chi può vederle.

Modificare, annullare e tornare indietro

Prima o poi ogni dato andrà corretto. Controlla che la specifica dica chi può modificare o annullare un inserimento e se il valore precedente viene conservato.

Denaro

Se l’app accetta pagamenti, la specifica deve mostrarne i passaggi: come possono pagare i clienti (carte e metodi di pagamento locali), cosa pagano, se sono ammessi pagamenti parziali, cosa ricevono dopo il pagamento e cosa succede se un pagamento non viene effettuato o non va a buon fine. Le regole sui rimborsi sono una decisione della tua attività, quindi mettile per iscritto. I gateway di solito applicano una percentuale per transazione, più una quota fissa in molti paesi: consulta la pagina dei prezzi del tuo gateway. Le app di Deployflix accettano pagamenti tramite un gateway come Razorpay o Cashfree; i gateway internazionali saranno disponibili prossimamente. La nostra pagina delle integrazioni mostra i collegamenti disponibili oggi.

Messaggi e promemoria

Se ti aspetti dei promemoria, indica come devono raggiungere le persone: via email, all’interno dell’app o in un altro modo. Se la specifica non cita un canale, dai per scontato che non ci sia.

I tuoi dati esistenti

Fogli di calcolo e vecchi registri spesso devono passare nella nuova app. Chiedi se il loro trasferimento fa parte della specifica o sta nell’elenco escluso per ora.

Dispositivi e lingue

Le persone la useranno su uno smartphone, sul computer al bancone di un negozio o su entrambi? Deve essere disponibile anche in spagnolo, arabo, francese o un’altra lingua, oltre che in inglese? Queste scelte determinano le schermate, quindi definiscile prima della creazione. Deployflix scrive i testi della tua app nella lingua che richiedi ed è disponibile in 41 lingue.

Perché approvare la specifica prima che venga creato qualsiasi cosa?

Perché cambiare una frase costa meno che cambiare un’app. Prima della creazione, aggiungere il ruolo del genitore o una rata è una modifica a una pagina. Dopo la creazione, la stessa modifica può toccare schermate, dati e permessi già finiti.

Approvare ti dà anche qualcosa con cui confrontare l’app finita. Quando la creazione è completata, apri la specifica e spunta ogni voce: ogni ruolo, ogni schermata, ogni dato. Tutto ciò che manca è un punto legittimo da sollevare.

La specifica chiarisce anche il costo prima che tu prenda un impegno. Quando il costo massimo della creazione è scritto nella specifica, puoi decidere con la cifra davanti agli occhi. Su Deployflix questo limite viene mostrato prima della tua approvazione e paghi solo quanto viene effettivamente consumato durante la creazione, come spiega la pagina dei prezzi.

Come si pianificano le modifiche dopo che l’app è stata creata?

Un’app raramente è finita. Un nuovo corso, una seconda sede, un nuovo modo di riscuotere le rette: ognuno merita la stessa cura della prima creazione.

Pianifica una modifica come una piccola specifica a sé: cosa cambia, quali ruoli e schermate tocca, quali dati vengono aggiunti o modificati, cosa resta uguale e quanto può costare. Leggila con le stesse domande e approvala prima che inizi il lavoro. Conserva la versione precedente, così se la modifica va storta puoi tornare a una che funzionava.

È così che Deployflix gestisce le modifiche: dici cosa cambiare, Deployflix pianifica la modifica come versione successiva e non viene creato nulla finché non è approvata. Ogni versione precedente viene conservata. In un’organizzazione, possono approvare solo le persone il cui ruolo lo consente, come descrive la pagina sulla sicurezza.

Un modello di specifica per app che puoi usare

Se scrivi tu la specifica, copia questi titoli e riempi ciascuno con frasi semplici:

  • L’app in una frase: per chi è e quale compito svolge.
  • Ruoli: ogni tipo di utente e cosa può vedere e fare.
  • Schermate per ruolo: per ogni ruolo, le schermate e cosa succede in ciascuna.
  • Dati conservati: ogni tipo di dato e i dettagli che contiene.
  • Integrazioni: pagamenti, il tuo dominio, gli store, dove viene conservato il codice e qualsiasi altra cosa a cui si collega.
  • Regole: rette, limiti, scadenze, cancellazioni e rimborsi.
  • Escluso per ora: cosa non farà questa versione.
  • Tetto di spesa e approvazione: il costo massimo e chi dà il via libera.

Per esempi concreti di ruoli, schermate e dati, guarda un sistema di gestione dei gruppi per centri di ripetizioneEN o un’app di prenotazione appuntamenti per clinicheEN. Un fondatore che sta testando un’idea può tenere la specifica ancora più corta, con un solo ruolo, poche schermate e un elenco fermo di ciò che è escluso, come per una web app MVP per startupEN.

Domande

Che differenza c’è tra la specifica di un’app e un documento dei requisiti?

Soprattutto lunghezza e formalità. Un documento dei requisiti per un grande progetto può occupare molte pagine di requisiti numerati. La specifica di un’app per una piccola attività copre gli stessi punti (chi la usa, cosa fa, cosa conserva) in una pagina, con parole semplici.

Chi dovrebbe scrivere la specifica dell’app?

Chi conosce l’attività fornisce il contenuto: i ruoli, il lavoro quotidiano e le regole. Chi crea l’app può trasformarlo in una specifica strutturata, ma solo tu puoi dire se è giusta.

Posso modificare la specifica dopo averla approvata?

Sì. Trattala come una modifica: descrivi cosa cambia, leggi il piano aggiornato e approvalo di nuovo. Conserva la versione precedente per poter confrontare o tornare indietro.

Quanto deve essere lunga la specifica di un’app?

Abbastanza lunga da non lasciare nulla di importante alle ipotesi, abbastanza corta da leggerla tutta. Per la maggior parte delle app per piccole attività una pagina è giusta; se si allunga molto, valuta di creare l’app per fasi.

Descrivi la tua app

Scrivi ciò che ti serve con parole tue. Deployflix scrive un piano di una pagina con il suo costo e crea solo dopo che lo hai approvato.