Come scrivere un documento di analisi e design per un software
L'obiettivo finale di un programma software è risolvere un problema. Il problema può essere semplice, come un programma che controlla errori ortografici in un documento di testo, o complesso, come un programma usato per creare un database. Indipendentemente dal problema, se il programma software non affronta efficacemente la questione e non fornisce un mezzo per l'utente per creare una soluzione, non è efficace e non raggiunge il suo scopo. Scrivere buon software inizia con un documento di analisi e design che affronta i requisiti utente e crea un piano per fornire soluzioni.
Definisci il problema
Passaggio 1
Valuta la richiesta guardando prima il quadro generale. Assicurati di capire cosa sta chiedendo l'utente. Fai domande approfondite del tipo "chi, cosa, dove, quando, perché e come" per arrivare alla radice del problema.
Passaggio 2
Definisci l'ambito e i vincoli del progetto. Ad esempio, se la richiesta è per un programma che informatizzi un sistema di ordinazione libri, valuta l'attuale sistema di ordinazione dall'inizio alla fine. Definisci e stabilisci i confini del progetto e identifica i vincoli entro cui devi lavorare, come hardware esistente o una tempistica limitata per il completamento.
Passaggio 3
Guarda l'utente finale. Intervista e osserva le persone che useranno il software quotidianamente per determinare come il software deve funzionare per soddisfare la richiesta, e come puoi progettare il nuovo sistema per adattarlo meglio alle esigenze degli utenti. Identifica i fattori legati agli utenti che possono influenzare il progetto, come il livello di competenza degli utenti finali che può influire sui requisiti di formazione.
Passaggio 4
Determina la fattibilità e presenta raccomandazioni. Fornisci una valutazione scritta della richiesta che includa una stima dei costi, benefici, tempistica di completamento, e la tua raccomandazione su se il software affronterà efficacemente il problema dichiarato.
Prepara il documento di analisi e design
Passaggio 1
Sviluppa un diagramma di flusso dati e una descrizione dei processi. Un diagramma di flusso dati spiega cosa farà il programma e un diagramma di processo mostra come il programma software lo farà. Ad esempio, un diagramma di flusso dati e una descrizione di processo per un sistema di ordinazione libri documenterebbero e descriverebbero il processo, passo dopo passo, dalla selezione del libro appropriato all'inserimento del libro in inventario.
Passaggio 2
Crea un dizionario dei dati che definisca e descriva gli elementi di dati necessari e li combini in record di dati. Ad esempio, nel sistema di ordinazione libri, esempi di elementi di dati includono nome del libro, ISBN, autore e prezzo. Questi elementi si combinano per formare un record libro; altri elementi, come nome del fornitore, numero di conto e rappresentante vendite, possono combinarsi per formare un record fornitore.
Passaggio 3
Combina il diagramma di flusso dati, le descrizioni di flusso di processo e il dizionario dei dati in un pacchetto documentale che descrive il programma software in un formato logico e scritto che puoi usare per creare un prototipo del programma, o modello funzionante del software.
Suggerimento
Un vantaggio nel definire chiaramente l'ambito del progetto è che aiuta a evitare lo "scope creep" che può verificarsi quando un progetto cresce oltre la richiesta iniziale.
Un'altra idea per identificare i requisiti degli utenti finali è sviluppare un sondaggio usando una combinazione di domande aperte, chiuse e a scala di risposta. Includi domande come "Quali funzionalità vorresti vedere nel sistema di ordinazione libri?", "Quanti ordini di libri fai ogni mese?" e "Su una scala da 1 a 10, come valuteresti l'inefficienza dell'attuale sistema di ordinazione libri?".
Oltre a presentare un documento scritto di analisi e design per un programma software, a volte è utile usare software di presentazione per aggiungere una rappresentazione grafica del nuovo sistema software.