
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 specifica | Cosa dice | Esempio per un centro di ripetizioni |
|---|---|---|
| Chi la usa | Ogni tipo di persona che accede e cosa può fare | Titolare, tutor, studenti e genitori; solo il titolare vede i totali delle rette |
| Schermate per ruolo | Le pagine che vede ogni ruolo e cosa vi fa | Tutor: le lezioni di oggi, segnare le presenze, inserire i voti delle verifiche. Genitore: presenze, voti, rette da pagare |
| Dati conservati | I dati che l’app memorizza e cosa contiene ciascuno | Studenti, classi, presenze per lezione, verifiche e voti, rate delle rette e ricevute |
| Integrazioni | I servizi esterni a cui si collega, e come | Pagamento online delle rette tramite un gateway di pagamento, con una ricevuta per ogni rata |
| Escluso per ora | Cosa non farà questa versione | Nessun controllo delle sovrapposizioni d’orario; nessuna importazione dei dati dell’anno scorso |
| Tetto di spesa | Il costo massimo della creazione | Un 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à.
- Percorri una giornata reale nei panni di ogni ruolo. Cosa tocca, cosa vede, cosa inserisce? Poi fai lo stesso per ogni altro ruolo.
- 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?
- 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ì.
- 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.
- 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.
Copiato. Incollalo in Deployflix dopo aver effettuato l'accesso.