Esistono pratiche standard quando si scrive una specifica per un progetto di sviluppo software? C'è un formato specifico da seguire? Inoltre, lo sviluppatore o il cliente lo scrivono? Se lo sviluppatore, questo è fatturabile?
Il bello degli standard è che ce ne sono tanti tra cui scegliere.
IEEE 830 per esempio. Link non a pagamento
I requisiti generali
1. Definizione dei modelli
Il formato migliore è UML, che include la rappresentazione di elementi chiave del sistema (come classi o oggetti), la cronologia degli eventi (attraverso diagrammi di sequenza) e diagrammi di flusso di dati, ecc. In alternativa si può avere una rappresentazione ER di entità e dizionari di dati. / p>
2. Definizione dei casi d'uso
I casi d'uso sono abbastanza spesso inclusi nella parte di UML. Tuttavia, questo non è necessariamente vero. Il miglior riferimento che puoi trovare sulla scrittura di casi d'uso è un libro "Scrittura di casi d'uso efficaci" o fare riferimento a qui per un breve documento dell'autore.
3. Requisiti di sistema
Qui, definiamo i sistemi (OS, hardware, ecc.) In cui i sistemi dovrebbero essere eseguiti e definiscono i requisiti di scalabilità e prestazioni in termini di carico del sistema (numero di query / transazioni al secondo) o tempo di risposta (tempo massimo per la risposta dell'utente ).
4. Altri requisiti di conformità
Qui, possiamo specificare la conformità a formati definiti esternamente di dati, protocolli o API esistenti (pubblicati o documentati) per altri servizi o librerie. Il sistema deve essere rispettato a questo.
5. Schermi
Molto spesso, le rappresentazioni visive di varie finestre di dialogo sono predefinite con i client come parte delle specifiche sono congelati. Questo è solitamente possibile solo per progetti di piccole e medie dimensioni.
Anche se non è sempre vero che UML e altri formati simili sono usati. Molte volte le aziende possono avere un proprio tipo specifico di modelli, ad esempio quello mostrato in wikipedia .
Un suggerimento rapido: aggiungi i numeri temporali al documento spec. Inizia da 1 su ogni pagina.
La nostra specifica principale ha recentemente aggiunto numeri di riga, ed è molto più facile indirizzare i colleghi a una frase esatta.
Prima: "... a pagina 25, sezione 2.8, quel bit sotto la tabella, no, il bit successivo, inizia con" Il server deve ... ""
Ora: "Vedi pagina 25, riga 34."
Leggi altre domande sui tag business specifications