Ambiguità e requisiti incompleti
Ogni documento dei requisiti è incompleto, e quelli che sembrano completi sono di solito i più pericolosi. Questa lezione insegna a individuare l'ambiguità, a classificarla, a decidere se risolverla subito o progettare attorno ad essa, e a scrivere il registro delle ipotesi che mantiene onesto il progetto.
Intermedio
Obiettivi di apprendimento
- Distinguere ambiguità, incompletezza, incoerenza e scorrettezza
- Riconoscere l'ambiguità lessicale, sintattica e referenziale in una frase dei requisiti
- Scegliere fra risolvere subito una lacuna, registrare un'ipotesi o progettare per tolleranza
- Scrivere un'ipotesi che dichiari le alternative considerate e il costo di sbagliare
- Individuare le tre ambiguità più costose e risolverle deliberatamente
- Riconoscere un requisito che è semplicemente sbagliato rispetto al business
Prerequisiti
- Regole aziendali e vincoli
- La raccolta dei requisiti
Introduzione
Chiedete a qualunque progettista esperto qual è la parte più difficile del mestiere e la risposta raramente è il diagramma. È che i requisiti non dicono mai ciò che devono dire, e tutti i coinvolti sono convinti di averlo già detto.
Il documento dice "un socio può prenotare un libro". Bene. La prenotazione blocca la copia fisica o solo il titolo? Scade? Due soci possono prenotare lo stesso titolo? Un socio può prenotare un titolo che ha già in prestito? Una prenotazione è la stessa cosa di un prestito non ancora iniziato? Ognuna di queste domande cambia lo schema, e il documento non risponde a nessuna.
La risposta del principiante è scegliere una risposta e andare avanti. Non è sbagliato — è inevitabile, perché un progettista non può attendere informazioni perfette che non arriveranno mai. La risposta del professionista è scegliere una risposta e scrivere che è stata fatta una scelta, insieme alle alternative, alla ragione e a quanto costerà se la scelta era sbagliata.
La differenza fra le due risposte è l'intero contenuto di questa lezione. Una produce uno schema. L'altra produce uno schema che un team può mantenere, perché quando arriva l'inevitabile sorpresa esiste una traccia di ciò che era stato ipotizzato e perché.
I quattro tipi di lacuna
"I requisiti fatti male" non è un solo problema. Sono quattro, e ciascuno ha un rimedio diverso.
I quattro difetti
Ambiguità — l'affermazione è chiara ma ammette più di una lettura. "Un socio può prenotare un libro."
Incompletezza — nel dominio esiste un caso che l'affermazione non considera. Il documento dice come si creano i prestiti e non dice che cosa accade quando una copia va perduta.
Incoerenza — due affermazioni non possono essere entrambe vere. "Una copia appartiene a una filiale" e "una copia può essere trasferita fra filiali mentre è in prestito".
Scorrettezza — l'affermazione è non ambigua, completa e coerente, e descrive qualcosa che il business non fa. "I soci sono identificati dal loro indirizzo email", quando la biblioteca emette numeri di tessera da trent'anni e metà dei soci non ha un'email.
I rimedi differiscono nettamente:
| Difetto | Individuabile con | Rimedio | Costo se trascurato |
|---|---|---|---|
| Ambiguità | Leggere la stessa frase due volte, in due modi | Chiedere; oppure ipotizzare e registrare | Cardinalità sbagliata; lo schema non può contenere i dati reali |
| Incompletezza | Enumerare i casi sistematicamente | Chiedere; oppure progettare una tolleranza | Un'intera classe di eventi non ha rappresentazione |
| Incoerenza | Confrontare le affermazioni fra loro | Escalare a chi decide | Lo schema soddisfa un'affermazione violandone un'altra |
| Scorrettezza | Confrontare il documento con la realtà osservata | Mostrare il documento a chi fa il lavoro | Uno schema giusto rispetto al documento e sbagliato rispetto al business |
La scorrettezza è la più pericolosa, perché nessuna delle tecniche abituali la trova. Non la si individua leggendo con attenzione — il testo è perfettamente chiaro. La si trova solo guardando come il lavoro viene davvero svolto: i fogli di calcolo esistenti, i moduli cartacei, le schermate del vecchio sistema, la persona che dice "no, non l'abbiamo mai fatto così".
Tre livelli di ambiguità
Nemmeno l'ambiguità è un fenomeno unico. Si presenta a livello della parola, della frase e del riferimento.
Ambiguità lessicale — la parola significa due cose
La stessa parola nomina due concetti diversi. È il difetto che il glossario esiste per prevenire, ed è la ragione per cui quella lezione precede questa.
| Parola | Lettura A | Lettura B | Conseguenza per lo schema |
|---|---|---|---|
| libro | Il titolo, l'opera astratta | La copia fisica sullo scaffale | Una entità o due — la decisione più rilevante di un modello di biblioteca |
| socio | Chiunque sia registrato | Chiunque abbia una tessera valida | Se Socio ha bisogno di uno stato e se i soci scaduti si conservano |
| prestito | La transazione | Il periodo in cui la copia è fuori | Se un rinnovo è un nuovo prestito o una modifica |
| disponibile | Presente in filiale | Non attualmente in prestito | Se la disponibilità si memorizza o si deriva |
| multa | L'importo dovuto | L'addebito che l'ha generato | Una entità o due |
| ordine | La richiesta del cliente | L'acquisto dal fornitore | Due entità completamente diverse |
L'ambiguità lessicale si risolve con il glossario, e la soluzione è una decisione di denominazione: scegliere un significato, dargli il termine canonico e rinominare l'altro. Ciò che non bisogna fare è tenere la parola e sperare.
Ambiguità sintattica — la frase si analizza in due modi
Le parole non sono ambigue; la struttura sì.
"Ogni ordine è assegnato a un magazzino e un corriere viene avvisato."
Due letture: (a) ogni ordine è assegnato a un magazzino, e in più un corriere viene avvisato di qualcosa; (b) ogni ordine è assegnato a un magazzino e a un corriere. La seconda lettura rende corriere un'associazione di Ordine. La prima lo lascia come processo di notifica fuori dallo schema.
"I soci possono prendere in prestito fino a cinque libri, o di più con l'approvazione del personale."
L'ambito di fino a cinque non è chiaro: cinque per visita, cinque contemporaneamente, cinque al mese? Ciascuna dà una regola diversa e un'imposizione diversa.
"I libri pubblicati prima del 1900 e donati sono catalogati separatamente."
La e unisce due condizioni (entrambe devono valere) o elenca due categorie (l'una o l'altra)? La risposta cambia se l'entità ha un flag o un sottotipo.
L'ambiguità sintattica si risolve riscrivendo la frase nella forma del registro delle regole — una regola per frase, con quantificatori espliciti. Se la riscrittura richiede due frasi, l'originale conteneva due requisiti.
Ambiguità referenziale — il riferimento non è chiaro
La frase contiene un riferimento il cui bersaglio non è determinato.
"Quando una copia viene restituita in ritardo, al socio viene addebitata una multa e il bibliotecario viene informato."
Il bibliotecario — quale? Quello al banco, quello che ha fatto il prestito, il responsabile di filiale? Se la risposta è "quello al banco", non c'è nulla da modellare, perché è chiunque sia presente. Se è "quello che ha fatto il prestito", Prestito ha bisogno di un'associazione con il personale, e lo schema cambia.
"Il suo stato viene aggiornato automaticamente."
Il suo — del prestito o della copia? Lo stato della copia è derivabile dai suoi prestiti, quindi memorizzarlo è una ridondanza; lo stato del prestito non è derivabile. Il pronome nasconde una decisione di progetto.
L'ambiguità referenziale si risolve sostituendo ogni pronome con il suo sostantivo nella versione riscritta. Sembra meccanico e trova difetti reali: in un documento di quaranta pagine, l'esercizio produce tipicamente una dozzina di domande.
Perché i requisiti sono incompleti
L'incompletezza non è un difetto di impegno. Ha cause strutturali, e conoscerle dice dove guardare.
La conoscenza tacita. Le persone non sanno descrivere ciò che fanno automaticamente. Chiedete a un bibliotecario come si registra un prestito e vi descriverà il caso normale; il caso in cui la tessera del socio è rovinata e il numero va letto dal registro non è "come si registrano i prestiti", è semplicemente una cosa che fanno.
Lo scarto di vocabolario. L'esperto di dominio non ha una parola per la distinzione che serve al progettista. Dice "il libro" perché nel suo mondo il titolo e la copia sono la stessa cosa, fino al momento in cui arriva la seconda copia.
Il bersaglio mobile. Il business cambia mentre il sistema si costruisce. I requisiti erano accurati a marzo; ora è novembre.
I casi limite non enumerati. Nessuno elenca i casi in cui il processo fallisce, perché il processo è definito dai casi in cui funziona. È per questo che le otto domande tipo della lezione precedente, e soprattutto "che cosa non può mai accadere", trovano tanto.
Lo stakeholder assente. Le persone che conoscono i casi limite non sono state invitate, oppure sono state invitate e non hanno parlato.
Enumerare i casi sistematicamente
La tecnica più efficace contro l'incompletezza è percorrere il ciclo di vita di ogni entità e chiedere che cosa accade a ogni passo. Per Prestito:
| Passo | Domanda | Lacuna tipica trovata |
|---|---|---|
| Creazione | Chi può crearlo, e che cosa deve essere vero prima? | Tessera scaduta; copia già in prestito; socio al limite |
| Svolgimento normale | Che cosa cambia durante? | Rinnovi — quanti, da chi, con quale effetto sulla scadenza |
| Chiusura anticipata | Può terminare prima della scadenza? | Restituzione, e se viene registrata la condizione della copia |
| Chiusura tardiva | Che cosa accade dopo la scadenza? | Multe: come calcolate, con quale tetto, condonate, pagate |
| Chiusura anomala | Che cosa accade se la copia va perduta o danneggiata? | Uno stato che il documento non menziona mai |
| Annullamento | Si può annullare? | Un prestito creato per errore |
| Storico | Che cosa va conservato, e per quanto? | Obblighi di conservazione; se i prestiti vecchi vengono mai eliminati |
Sette passi, sette occasioni di lacuna, e in pratica almeno due mancheranno dal documento. Fatelo per ogni entità e l'incompletezza diventa visibile invece che latente.
Tre risposte a una lacuna
Quando si trova una lacuna esistono esattamente tre risposte oneste e una disonesta.
Risposta 1 — Risolverla subito
Chiedete a chi lo sa. È sempre la prima cosa da provare, ed è sorprendente quanto spesso venga saltata perché il progettista non vuole sembrare impreparato.
La scala di disambiguazione, in ordine:
- Chiedere a chi fa il lavoro. Non al dirigente — alla persona che timbra i moduli. Conosce le eccezioni.
- Guardare i dati esistenti. Il foglio di calcolo attuale, il registro cartaceo, l'esportazione del vecchio database. I dati reali rispondono a domande che le interviste non possono: se il campo è mai vuoto, se il codice viene mai riusato, se la stessa persona compare due volte.
- Cercare un precedente. Se l'organizzazione gestisce già altrove un processo simile, le sue regole sono probabilmente quelle volute.
- Scegliere la lettura più generale, se non funziona nient'altro. Un modello che ammette entrambe le letture sopravvive; uno che ne ammette una sola dovrà essere cambiato.
Risposta 2 — Decidere per ipotesi, e registrarla
Quando la risposta non è disponibile in tempo — lo stakeholder è in ferie, la decisione richiede un comitato, la scadenza è venerdì — ipotizzate, e scrivete l'ipotesi in una forma su cui un lettore futuro possa agire.
Un'ipotesi che vale la pena scrivere ha sei parti:
| Parte | Esempio |
|---|---|
| La domanda | Una prenotazione blocca una copia specifica o solo un titolo? |
| Le alternative | (a) prenota una copia — serve Prenotazione → Copia; (b) prenota un titolo — serve Prenotazione → Titolo |
| Che cosa abbiamo scelto | (b), prenota un titolo |
| Perché | Il documento dice "prenotare un libro", e ai soci non importa quale copia ricevono |
| Costo se sbagliato | Moderato: aggiungere copia_id a Prenotazione è una colonna opzionale in più e un cambio di regola; le righe esistenti richiederebbero un backfill |
| Chi può confermare, e quando | Direttrice, alla prossima revisione, 12 marzo |
Il campo costo se sbagliato è quello che rende il registro utile per la pianificazione, perché dice al lettore successivo se l'ipotesi va rivista con urgenza o può aspettare.
Risposta 3 — Progettare per tolleranza
A volte la risposta è davvero inconoscibile in fase di progetto, e la mossa giusta è costruire uno schema che accolga entrambe le letture a basso costo.
Il caso classico è uno-a-molti contro molti-a-molti. Un reparto ha dipendenti; un dipendente può appartenere a più di un reparto? Nessuno lo sa, e la risposta non arriverà prima della scadenza. Due progetti:
- Uno-a-molti:
dipendente.reparto_id. Semplice, veloce, ma aggiungere un secondo reparto in seguito richiede una nuova tabella, una migrazione dati e modifiche a ogni interrogazione. - Molti-a-molti: una tabella
appartiene_a. Leggermente più complesso, costa una join a ogni lettura, ma accoglie perfettamente il caso uno-a-molti — semplicemente non si inserisce mai una seconda riga.
L'asimmetria è decisiva. Il modello molti-a-molti gestisce entrambe le risposte; il modello uno-a-molti ne gestisce una e richiede un intervento chirurgico per l'altra. Quando l'ambiguità è "uno o molti?" e il costo del modello generale è una join, costruite il modello generale. Non è over-engineering; è comprare un'opzione a poco prezzo.
Lo stesso ragionamento vale per:
| Ambiguità | Modello ristretto | Modello tollerante | Verdetto |
|---|---|---|---|
| Uno o molti reparti? | FK su dipendente |
Tabella di collegamento | Tollerante — la join costa poco |
| Il secondo nome è opzionale? | NOT NULL |
Ammette nulli | Tollerante — un nullo non costa nulla |
| Il telefono è multivalore? | Una colonna | Tabella separata | Dipende — di solito tollerante |
| Uno o due indirizzi? | Due colonne (casa, ufficio) |
Entità Indirizzo con un tipo |
Dipende — due colonne collassano male a tre |
| Lo stato è un elenco fisso? | ENUM |
Tabella di decodifica | Tollerante se l'elenco crescerà |
Ma la tolleranza non è gratuita e non è sempre giusta. Un modello tollerante che accoglie casi che il business non avrà mai è generalità speculativa, e costa chiarezza, join e indici per sempre. La regola pratica: tollerate quando il modello generale costa una join o una colonna opzionale; non tollerate quando costa una nuova entità, un livello di indirezione in più o una struttura polimorfica.
Le tre ambiguità che costano di più
Di tutte le lacune che un progettista incontrerà, tre spiegano la maggior parte del lavoro rifatto. Imparate a riconoscerle e a risolverle deliberatamente.
Ambiguità 1 — uno-a-molti o molti-a-molti
La più comune, la più rilevante e quella a cui gli stakeholder rispondono in modo incoerente in giorni diversi.
"Uno studente si iscrive ai corsi." Un corso può avere molti studenti? Ovviamente. Uno studente può avere molti corsi? Ovviamente. Dunque è molti-a-molti — ma la parola si iscrive in un'altra frase potrebbe significare "è assegnato a un gruppo classe", che è uno-a-molti.
La diagnostica è sempre la stessa, e va posta in entrambe le direzioni:
Un A può avere molti B? e Un B può avere molti A?
Chiedete una sola direzione e otterrete la risposta sbagliata metà delle volte, perché la lettura naturale di una frase è asimmetrica anche quando il dominio non lo è.
Ambiguità 2 — opzionale o obbligatorio
"Ogni ordine ha un cliente." Certamente. "Ogni cliente ha un ordine." Quasi certamente no — un cliente può registrarsi e non comprare mai.
Le due direzioni sono regole diverse e vengono continuamente confuse. Nel modello E-R sono due cardinalità minime diverse; nel modello relazionale una è NOT NULL e l'altra è un vincolo differito o nulla.
Anche il costo di sbagliare è asimmetrico. Dichiarare obbligatorio ciò che è opzionale significa che il sistema non può registrare uno stato legittimo — un bibliotecario appena assunto che non ha ancora fatto un prestito, un prodotto non ancora ordinato. È un difetto che perde dati, e si manifesta come segnalazione al supporto nella prima settimana. Dichiarare opzionale ciò che è obbligatorio significa che il sistema accetta dati sbagliati, il che si manifesta mesi dopo come un report che non quadra.
In caso di dubbio preferite l'opzionale. I dati sbagliati si possono ripulire; i dati che non si sono potuti inserire non si possono recuperare.
Ambiguità 3 — una entità o due
"Un libro ha copie." Una entità o due? "Un dipendente è anche un dirigente." Una entità con un'associazione ricorsiva, o due entità?
Si applicano i test delle lezioni precedenti: il candidato ha identità propria, attributi propri, associazioni proprie, ed è riferito in modo indipendente? Ma la domanda decisiva è spesso più semplice:
L'organizzazione avrà mai bisogno di parlare di uno dei due senza l'altro?
La biblioteca parla dei titoli nel catalogo e delle copie al banco, e le due conversazioni hanno attributi e regole diverse. Due entità. Una riga d'ordine appartiene sempre a un ordine e non viene mai discussa da sola. Una entità (o un insieme di attributi sull'ordine).
Una quarta, più insidiosa — è una entità o uno stato?
"Una prenotazione diventa un prestito quando il libro arriva." Se la frase si prende alla lettera, Prenotazione e Prestito sono la stessa entità con uno stato. Altrimenti sono due entità con una transizione fra loro.
La diagnostica: hanno attributi diversi? Un prestito ha una data di scadenza e una di restituzione; una prenotazione ha una scadenza e una posizione in coda. Attributi diversi, regole diverse, associazioni diverse → due entità. Fonderle produce una tabella in cui metà delle colonne sono nulle per metà delle righe, che è il sintomo classico di un'ambiguità entità-contro-stato non risolta.
Esempio svolto: sei ambiguità in un paragrafo
Ecco un paragrafo dei requisiti del Library Management System, così come fu effettivamente scritto nella prima intervista.
"I soci possono prenotare libri attualmente in prestito. Quando il libro torna, il socio viene avvisato e ha tre giorni per ritirarlo. Se non lo fa, la prenotazione viene annullata e il socio successivo in coda viene avvisato. Il personale può derogare al limite dei tre giorni."
Cinque frasi di inglese chiaro. Sei ambiguità.
1. "prenotare libri" — lessicale. Titolo o copia? Il paragrafo dice "libri attualmente in prestito", il che implica che una copia specifica sia in prestito — ma un titolo con tre copie può averne due in prestito e una sullo scaffale. Domanda: un socio può prenotare un titolo disponibile in questo momento? Risoluzione: ipotizzare che una prenotazione riguardi un titolo, e che diventi ritirabile quando una qualsiasi copia è disponibile. La coda è per titolo.
2. "il socio viene avvisato" — incompletezza. Con quale canale, e la notifica fa parte dello schema? Risoluzione: lo schema registra l'evento — prenotazione.disponibile_dal — e il canale è fuori ambito per questo sistema. Registrare la data è essenziale; registrare il canale no.
3. "ha tre giorni per ritirarlo" — sintattica. Tre giorni di calendario o 72 ore? Da quando — dal momento in cui la copia torna, o dalla successiva apertura? Risoluzione: il registro delle regole annota "una prenotazione ritirabile scade 72 ore dopo essere diventata disponibile", e l'ambiguità sugli orari di apertura viene escalata perché cambia il comportamento il venerdì.
4. "la prenotazione viene annullata" — incompletezza. Annullata da chi, ed è lo stesso stato di un annullamento da parte del socio? Risoluzione: un valore di stato scaduta distinto da annullata, perché i report li distinguono e lo storico del socio appare diverso.
5. "il socio successivo in coda" — referenziale e strutturale. La coda è una posizione, il che significa che il modello ha bisogno di un attributo di ordinamento su Prenotazione — un fatto che nessuno avrebbe indovinato dall'elenco delle entità. Risoluzione: Prenotazione.posizione_coda, o meglio derivare la posizione da prenotato_il e registrare che il business accetta l'ordine di arrivo. La scelta conta: una posizione memorizzata va rinumerata a ogni annullamento, una derivata non sa esprimere una deroga manuale.
6. "Il personale può derogare al limite dei tre giorni" — famiglia 6 della lezione precedente. Non esprimibile nel modello. Risoluzione: il registro delle regole la annota come imposta dall'applicazione, e lo schema guadagna un attributo prorogato_fino_al su Prenotazione perché la deroga abbia dove stare. Senza quell'attributo la deroga non è registrabile, e il personale continuerà a tenerla su carta — ed è così che nascono i sistemi ombra.
Sei ambiguità da cinque frasi, e ognuna ha cambiato lo schema o il registro delle regole. Quel rapporto è normale per un paragrafo di requisiti di prima passata.
Quando il requisito è semplicemente sbagliato
La scorrettezza merita una sezione propria perché il rimedio è scomodo: bisogna dire a qualcuno che il documento che ha firmato è sbagliato.
Tre segnali che un requisito è sbagliato e non solo poco chiaro:
I dati esistenti lo contraddicono. Il documento dice che ogni socio ha un'email; il foglio di calcolo attuale ne ha una per il 40% dei soci. O la regola è nuova — e allora c'è un progetto di migrazione dati che nessuno ha menzionato — oppure la regola è sbagliata.
Le persone che fanno il lavoro non lo riconoscono. Leggete il requisito ad alta voce alla persona al banco e guardate la sua faccia. "No, non facciamo così" è la frase più preziosa dell'analisi dei requisiti.
Descrive un processo che nessuno progetterebbe. Una regola che richiede di inserire due volte la stessa informazione, o che vieta un caso che ovviamente si verifica, è di solito la trascrizione di un vecchio aggiramento più che di una regola.
La risposta professionale non è progettare attorno ad esso in silenzio. È scriverlo, mostrarlo e chiedere. "Il requisito dice che i soci sono identificati dall'email. I nostri dati mostrano che il 60% dei soci non ne ha una. Qual è la versione corretta?" — quella domanda costa cinque minuti e può risparmiare un progetto rifatto.
Errori comuni
| Errore | Sintomo | Conseguenza | Rimedio |
|---|---|---|---|
| Ipotizzare in silenzio | Nessuna traccia di alcuna decisione | Nessuno distingue una scelta meditata da un incidente | Registrare ogni ipotesi, anche minima |
| Intervistare solo i dirigenti | Il documento descrive il processo come progettato, non come eseguito | Mancano casi limite, aggiramenti e regole informali | Intervistare il personale operativo; guardare gli artefatti |
| Chiedere la cardinalità in una sola direzione | "Un corso ha molti studenti" | Grado sbagliato; tabella di collegamento mancante | Chiedere sempre esplicitamente entrambe le direzioni |
| Risolvere l'ambiguità scegliendo il modello più ristretto | Uno-a-molti perché è più semplice | Ogni futuro caso molti-a-molti richiede un intervento | Tollerare quando il modello generale costa solo una join |
| Assumere obbligatorio in caso di dubbio | NOT NULL su un campo che può legittimamente essere vuoto |
Stati legittimi non registrabili; dati irrecuperabili | Preferire l'opzionale; ripulire i dati sbagliati dopo |
| Scrivere "da chiarire" | Un elenco di domande aperte che non si chiude mai | Le domande vengono dimenticate; lo schema non codifica nulla | Scrivere una decisione più il costo di sbagliare |
| Trattare i pronomi come innocui | "il suo stato viene aggiornato" | Una decisione di progetto nascosta in un pronome | Sostituire ogni pronome con il suo sostantivo |
| Non leggere i dati esistenti | Requisiti basati solo sulle interviste | Regole che i dati contraddicono passano inosservate | Ispezionare sempre il foglio di calcolo o l'esportazione attuale |
| Confondere incompletezza e ambiguità | Lungo elenco di voci "poco chiare" | Sforzo speso a rileggere invece che a enumerare i casi | Percorrere il ciclo di vita dell'entità passo per passo |
| Escalare tutto | Ogni domanda diventa una riunione | Il progetto si blocca; gli stakeholder si disinnamorano | Risolvere ciò che si può; escalare solo ciò che è rilevante |
Riepilogo
- I requisiti hanno quattro tipi di difetto: ambiguità (più di una lettura), incompletezza (manca un caso), incoerenza (due affermazioni in conflitto), scorrettezza (l'affermazione è falsa rispetto al business). I rimedi differiscono.
- La scorrettezza è la più pericolosa perché la lettura attenta non la trova. Confrontate il documento con i dati esistenti e con chi fa il lavoro.
- L'ambiguità si presenta a tre livelli: lessicale (la parola significa due cose), sintattica (la frase si analizza in due modi), referenziale (il pronome non ha un bersaglio chiaro). La riscrittura — una regola per frase, ogni pronome sostituito — ne trova la maggior parte.
- L'incompletezza è strutturale, non un difetto di impegno. Enumerate i casi percorrendo il ciclo di vita di ogni entità: creazione, svolgimento, chiusura anticipata e tardiva, chiusura anomala, annullamento, storico.
- Esistono tre risposte oneste a una lacuna: risolverla subito (chiedere, guardare i dati, cercare un precedente, scegliere la lettura generale), ipotizzare e registrare, oppure progettare per tolleranza. Quella disonesta è ipotizzare in silenzio.
- Un'ipotesi che vale la pena scrivere ha sei parti: domanda, alternative, scelta, ragione, costo se sbagliato, chi può confermare.
- Progettate per tolleranza quando il modello generale costa una join o una colonna opzionale — il caso più famoso è uno-a-molti contro molti-a-molti, dove il modello molti-a-molti accoglie entrambe le risposte.
- Le tre ambiguità più costose sono uno-a-molti contro molti-a-molti, opzionale contro obbligatorio e una entità contro due. Una quarta, più sottile, è entità contro stato.
- In caso di dubbio fra opzionale e obbligatorio, preferite opzionale: i dati sbagliati si ripuliscono, i dati che non si sono potuti inserire non si recuperano.
Domande di verifica
1. Un documento dei requisiti afferma: "Un medico lavora in un reparto." Quale ambiguità è, e come la risolvete?
Show the solution
È sintattica, e più precisamente manca una cardinalità — la frase non dice se l'associazione è uno-a-molti o molti-a-molti.
Risolvetela chiedendo esplicitamente entrambe le direzioni, non inferendo dalla frase:
- Un medico può lavorare in più di un reparto? (Molto spesso sì: consulenti, personale part-time, coperture incrociate.)
- Un reparto può avere più di un medico? (Quasi sempre sì.)
Se entrambe le risposte sono sì, l'associazione è molti-a-molti e serve una tabella di collegamento. Se la prima è no e la seconda è sì, è uno-a-molti e l'identificatore del reparto va sul medico.
C'è una terza possibilità che la frase nasconde: "lavora in" potrebbe significare "è attualmente assegnato a", che potrebbe essere molti-a-molti nel tempo — un medico si sposta fra reparti e lo storico conta. Questo renderebbe l'associazione un'entità con data di inizio e fine. È lo stesso test entità-contro-associazione di prima, applicato a una frase che sembrava risolta.
Se la risposta non è ottenibile in tempo, progettate per tolleranza: costruite il molti-a-molti. Gestisce il caso uno-a-molti non inserendo mai una seconda riga, e il costo è una join.
2. Perché "preferire l'opzionale in caso di dubbio" è il valore predefinito giusto, quando le colonne opzionali sono di solito criticate come segno di uno schema debole?
Show the solution
Perché i due errori non sono simmetrici nel costo.
Dichiarare obbligatorio un campo che in realtà è opzionale significa che il sistema non può registrare uno stato legittimo. Un bibliotecario non può essere registrato prima di aver fatto un prestito; un prodotto non può essere creato prima di essere ordinato; un socio senza email non può iscriversi. I dati semplicemente non possono essere inseriti, quindi sono perduti — e a differenza dei dati sbagliati non si possono ripulire dopo, perché non sono mai esistiti.
Dichiarare opzionale un campo che in realtà è obbligatorio significa che il sistema accetta record incompleti. È un problema di qualità del dato, è reale ed è risolvibile: trovare i nulli, inseguirli, aggiungere il vincolo, migrare.
Dunque l'asimmetria è recuperabile contro irrecuperabile. Preferite l'errore recuperabile.
La critica alle colonne opzionali è valida in un altro contesto: uno schema pieno di colonne opzionali spesso significa che il progettista non ha mai posto la domanda e ha reso tutto opzionale per non decidere. Quello è il fallimento dell'ipotesi silenziosa, non la strategia della tolleranza. La differenza è che la tolleranza è una decisione registrata, con una ragione dichiarata e un piano per stringere il vincolo quando arriverà la risposta — e il registro delle ipotesi dovrebbe dire esattamente questo.
3. Scoprite che il foglio di calcolo attuale ha una colonna "email" compilata solo per il 40% dei soci, mentre i requisiti dicono che l'email è obbligatoria e unica. Che cosa fate?
Show the solution
Questo è un segnale di scorrettezza, non di ambiguità, e il primo passo è stabilire quale affermazione è falsa.
Tre possibilità, e sono progetti molto diversi:
- La regola è nuova. L'email viene introdotta come obbligatoria e il 60% che non ce l'ha va raccolto. È un progetto di migrazione dati con una scadenza, un responsabile e un piano di comunicazione — non una decisione di schema. Lo schema può avere
NOT NULLsolo dopo il backfill. - La regola è sbagliata. L'email è opzionale e il requisito è stato scritto da qualcuno che descriveva ciò che sperava fosse vero. Lo schema deve avere una colonna opzionale con un vincolo di unicità che tollera i nulli.
- I dati sono sbagliati. I soci hanno l'email; il foglio di calcolo non è mai stato mantenuto. Allora la domanda è dove siano gli indirizzi veri e se si possano recuperare.
Non scegliete fra le tre. Presentate il dato con il numero — "il requisito dice obbligatoria; il 60% dei record attuali non ha un valore" — e chiedete quale sia corretto. Quella singola domanda, posta prima che lo schema sia costruito, evita o un lancio fallito (se costruite NOT NULL e la migrazione non avviene) o una regola che nessuno impone (se lo costruite opzionale e il business si aspettava l'obbligo).
E registrate la risposta come ipotesi con una data, perché qualunque sia, fra un anno qualcuno chiederà perché la colonna si comporta così.
Esercizio
Interrogare un paragrafo dei requisiti
Quello che segue è un paragrafo dei requisiti di un sistema di noleggio auto, scritto dal responsabile operativo in una sola seduta. È tipico: chiaro, sicuro di sé e contenente almeno otto difetti.
"I clienti noleggiano veicoli da una filiale. Un noleggio ha una data di inizio e una di fine, e il prezzo è calcolato dalla categoria del veicolo e dal numero di giorni. I clienti possono noleggiare più veicoli contemporaneamente con un unico contratto. I veicoli appartengono a una categoria, e ogni categoria ha una tariffa giornaliera. Alla riconsegna il personale controlla il livello del carburante e registra eventuali danni. I veicoli danneggiati vengono inviati all'officina e non sono disponibili fino alla riparazione. I clienti con la carta fedeltà hanno uno sconto del 10%. I noleggi possono essere prorogati se il veicolo non è prenotato da un altro cliente."
Producete:
- Una tabella di ogni difetto individuato, classificato come ambiguità (e a quale livello), incompletezza, incoerenza o scorrettezza.
- Per ogni difetto, la domanda specifica che porreste, e a chi.
- Per ogni difetto che non si può risolvere prima della scadenza, l'ipotesi che registrereste (con il costo di sbagliare) oppure il progetto tollerante che adottereste.
- Individuate quali difetti cambiano lo schema e quali solo il registro delle regole.
Soluzione commentata
La tabella dei difetti
| # | Frammento | Difetto | Livello / tipo | Domanda | A chi | Schema o registro? |
|---|---|---|---|---|---|---|
| 1 | "noleggiano veicoli da una filiale" | Uno-a-molti o molti-a-molti? Un cliente può noleggiare da più filiali, e una filiale può servire molti clienti? | Sintattica | Un noleggio può iniziare in una filiale e terminare in un'altra? | Responsabile operativo | Schema — filiale di ritiro e di riconsegna sono due associazioni, non una |
| 2 | "una data di inizio e una di fine" | Data o timestamp? La data di fine include il giorno di riconsegna? | Sintattica | Un noleggio dal 1 al 3 marzo vale due giorni o tre? | Responsabile operativo | Registro (regola di fatturazione) + schema (scelta del tipo) |
| 3 | "il prezzo è calcolato dalla categoria e dal numero di giorni" | Il prezzo si memorizza o si deriva? Se la tariffa cambia, un noleggio passato cambia? | Referenziale / derivazione | Una fattura storica deve riflettere la tariffa del momento? | Amministrazione | Schema — memorizzare come istantanea la tariffa e l'importo calcolato |
| 4 | "con un unico contratto" | Contratto compare per la prima volta e non è mai definito. È un'entità? Un noleggio è la stessa cosa di una riga di contratto? | Lessicale | Un contratto è un documento che raggruppa noleggi? Può essere modificato? | Responsabile operativo | Schema — una nuova entità, Contratto, che l'elenco delle entità non aveva |
| 5 | "I veicoli appartengono a una categoria" | Un veicolo può cambiare categoria? La categoria è fissata all'acquisto? | Incompletezza | Una ricategorizzazione a metà vita accade mai? | Responsabile flotta | Schema (se l'associazione va datata) |
| 6 | "ogni categoria ha una tariffa giornaliera" | Una sola tariffa, o una tariffa che varia per stagione, filiale o durata? | Incompletezza | Le tariffe cambiano stagionalmente, e per filiale? | Amministrazione | Schema — un'entità tariffa con periodo di validità invece di una colonna |
| 7 | "controlla il livello del carburante e registra eventuali danni" | Il carburante è una misura con unità e una politica (pieno-pieno?); il danno ha un tipo, una gravità, un costo, una foto | Incompletezza | Qual è la politica del carburante, e un verbale di danno è un documento separato? | Responsabile operativo | Schema — VerbaleDanno come entità; carburante come numero più un attributo di politica |
| 8 | "I veicoli danneggiati vengono inviati all'officina e non sono disponibili fino alla riparazione" | Regola di stato. In officina è uno stato del veicolo? Chi lo cambia? Un veicolo può essere in officina e prenotato? | Incompletezza (stato) | Quali stati ha un veicolo, e quali transizioni sono legali? | Responsabile operativo | Schema (attributo di stato) + registro (transizioni) |
| 9 | "I clienti con la carta fedeltà hanno uno sconto del 10%" | La carta è un attributo, un'entità o uno stato? Lo sconto si applica a ogni noleggio o una volta? Si combina con altri sconti? | Lessicale / incompletezza | La carta è un oggetto fisico con un numero e una data di emissione? Esistono altri tipi di sconto? | Marketing | Schema — CartaFedelta come entità se ha numero e date; uno Sconto generale se ce ne saranno altri |
| 10 | "I noleggi possono essere prorogati se il veicolo non è prenotato da un altro cliente" | La proroga è una modifica o un nuovo noleggio? Il controllo è sulle prenotazioni, e che cos'è una prenotazione — è diversa da un noleggio? | Lessicale + famiglia 6 | Una prenotazione è la stessa cosa di un noleggio non ancora iniziato? | Responsabile operativo | Schema (un concetto di prenotazione che il documento non nomina mai) + registro (la regola di controllo) |
| 11 | — | Non si dice nulla su annullamenti, mancate presentazioni, riconsegne in ritardo, veicoli perduti, né su che cosa identifica un cliente. | Incompletezza | Percorrere il ciclo di vita di Noleggio e Veicolo |
Responsabile operativo | Schema e registro entrambi |
I quattro difetti che cambiano lo schema
Contrattonon esiste nei requisiti. Il difetto 4 è il più grave: "più veicoli contemporaneamente con un unico contratto" introduce un'entità che il resto del documento non menziona. Uno schema costruito dall'elenco delle entità senza leggere questa frase avrebbeNoleggioappeso aClientee nessun modo di raggruppare i noleggi che condividono un contratto — e la fattura, che è per contratto, sarebbe impossibile.- Le tariffe dipendono dal tempo. Difetto 6. Una colonna
tariffa_giornalierasuCategoriaè il modello ovvio e quello sbagliato se le tariffe cambiano stagionalmente: la colonna contiene la tariffa di oggi, e ogni fattura storica diventa silenziosamente sbagliata. Il modello corretto è un'entità tariffa con un periodo di validità. - Il prezzo deve essere un'istantanea. Difetto 3. L'importo calcolato e la tariffa usata vanno memorizzati sul noleggio, per la stessa ragione della multa nella lezione precedente.
- Ritiro e riconsegna sono due associazioni. Difetto 1. "noleggiano veicoli da una filiale" ne suggerisce una. I noleggi a senso unico sono standard nel settore, e la frase non li esclude. Due associazioni, una delle quali può essere opzionale.
I progetti tolleranti adottati senza attendere
- Difetto 5 (cambio di categoria): datate l'associazione — o, più economicamente, memorizzate la categoria sul noleggio come istantanea e trattate la categoria corrente del veicolo come modificabile. La seconda costa una colonna e sopravvive a entrambe le risposte.
- Difetto 9 (sconti): modellate un'entità
Scontocon un tipo e un valore invece di un booleanoha_carta_fedelta. Costa una tabella, e accoglie il futuro quasi certo di "gli studenti hanno il 15%" e "i noleggi lunghi hanno il 5%". - Difetto 2 (date): usate
DATEper il periodo di noleggio e registrate la regola di fatturazione nel registro. Cambiare un tipo in seguito è una migrazione; cambiare una regola in seguito è una conversazione.
L'ipotesi registrata
Per il difetto 10 la risposta non era disponibile prima della scadenza:
Ipotesi A-3. Proroga di un noleggio. Domanda: una proroga è una modifica del noleggio esistente, o un nuovo noleggio per i giorni aggiuntivi? Alternative: (a) modificare
data_finesul noleggio esistente; (b) chiudere il noleggio e crearne uno nuovo. Scelta: (a), modificaredata_fine. Perché: il responsabile operativo l'ha descritta come "prorogare il noleggio", e la fattura è per contratto, quindi un secondo noleggio non cambierebbe la fatturazione. Costo se sbagliato: basso-moderato. Lo schema non è coinvolto; il cambiamento è nella logica di fatturazione e nella vista dello storico, che mostrerebbe un noleggio invece di due. I dati esistenti richiederebbero una fusione. Confermare con: responsabile operativo, alla revisione dei requisiti. Data: registrata con la versione di schema 0.3.
Che cosa insegna davvero l'esercizio
Undici difetti in cinque frasi — e quattro di essi cambiano lo schema, compreso uno che introduce un'entità che nessuno aveva elencato. Il paragrafo non è insolitamente scadente. È un paragrafo ordinario scritto da un dirigente competente che conosce il business e non sa di che cosa ha bisogno uno schema.
Questa è la condizione normale dell'analisi dei requisiti. Il lavoro non è ricevere requisiti completi; è rendere visibile l'incompletezza, decidere deliberatamente dove non si può rimuovere, e lasciare una traccia su cui la persona successiva possa agire.
Dove andare adesso
- Lezione successiva: tutti gli artefatti di questo modulo montati su un solo dominio: Caso di studio: il pacchetto dei requisiti della biblioteca.
- Le regole in cui queste ambiguità si trasformano: Regole aziendali e vincoli.
- Il vocabolario che risolve l'ambiguità lessicale: Glossario dei termini.
- Le tecniche di intervista che fanno emergere i casi nascosti: La raccolta dei requisiti.
- Che cosa fare dell'elenco delle entità una volta risolte le ambiguità: L'individuazione delle entità candidate.
- Le cardinalità che la domanda uno-a-molti / molti-a-molti decide: Studente e Corso.
- Dove i vincoli concettuali diventano finalmente SQL: Introduzione alle basi di dati.