Analisi dei requisiti

L'individuazione delle entità candidate

Ogni sostantivo di un documento dei requisiti sembra una tabella. Quasi mai lo è. Questa lezione fornisce una procedura ripetibile per decidere quali concetti meritano di diventare entità e quali sono invece attributi, eventi o semplici valori travestiti.

Base

Obiettivi di apprendimento

  • Applicare la procedura di estrazione dei sintagmi nominali a un testo dei requisiti
  • Verificare ogni candidato rispetto a identità, esistenza autonoma, molteplicità e rilevanza
  • Distinguere un'entità da un attributo usando il test decisivo
  • Separare un tipo dalle sue occorrenze (titolo e copia, corso ed edizione)
  • Decidere se un concetto è un'entità, un evento o un attributo di un'associazione
  • Produrre un elenco di entità candidate con definizioni, identificatori provvisori e domande aperte

Prerequisiti

  • L'analisi del dominio applicativo
  • Requisiti funzionali e non funzionali

Introduzione

L'analisi del dominio della lezione precedente ha prodotto una mappa dei concetti: cose, eventi, ruoli, classificazioni. Quella mappa è una fotografia del vocabolario. Non è ancora uno schema, e la distanza tra le due cose è esattamente il punto in cui falliscono i progetti dei principianti.

Ecco la trappola. Chiedete a un gruppo di studenti di elencare le entità di un sistema bibliotecario e otterrete:

Libro, Socio, Prestito, Autore, Editore, Categoria, Copia, Multa, Prenotazione, Bibliotecario, Scaffale, Indirizzo, Numero di telefono, Email, Età, Prestiti totali.

Sedici voci. Tre non sono entità. Due sono la stessa cosa scritta due volte. Quattro sono attributi. Una è un evento promosso a cosa senza motivo. E mancano del tutto due entità che devono esistere, semplicemente perché nessuno ha pronunciato il loro nome ad alta voce.

Il problema non è che l'elenco sia sbagliato. Il problema è che nulla nell'elenco dice perché ogni voce è lì, quindi nulla può essere verificato, discusso o corretto. Un elenco di entità candidate senza motivazioni è un'ipotesi con la formattazione.

Questa lezione sostituisce l'intuito con una procedura. La procedura è abbastanza meccanica da poter essere applicata a qualunque testo, ed è la stessa che usano i progettisti professionisti: semplicemente la eseguono più in fretta.

Che cosa è davvero un'entità

Prima di verificare i candidati, l'obiettivo deve essere preciso.

Entità

Un'entità è una classe di oggetti del dominio applicativo che condividono lo stesso significato e sono descritti dalle stesse proprietà. Ogni singolo oggetto appartenente alla classe è un'istanza (o occorrenza) dell'entità.

Socio è l'entità; la persona con tessera numero 4471 è un'istanza. Libro è l'entità; Il nome della rosa, copia 2, è un'istanza.

Ne derivano subito due conseguenze, ed entrambe vengono regolarmente ignorate.

Primo: un'entità è una classe, non un singolo oggetto. Uno schema per una biblioteca con un solo socio ha comunque l'entità Socio. Il modello descrive il tipo di cosa di cui la base di dati deve conservare molti esemplari, o deve poter conservare molti esemplari in futuro.

Secondo: le istanze devono essere distinguibili. Se due istanze non possono essere distinte — se non esiste un fatto vero per una e falso per l'altra — allora il concetto non è modellato alla granularità giusta, oppure non è affatto un'entità. Per questo l'identità è il primo test, non l'ultimo.

Entità e istanza, in una riga

L'entità è lo stampo; l'istanza è ciò che ne esce. Libro non ha un titolo; un libro ha un titolo. Confondere le due cose produce frasi come «la tabella Libro contiene 12.000 righe», che mescolano un oggetto dello schema con i dati.

I quattro test

Ogni candidato estratto da un testo dei requisiti deve superare quattro test. Un candidato che ne fallisce uno non è un'entità, anche se può comunque essere qualcos'altro che vale la pena conservare.

# Test Domanda Se fallisce
T1 Identità Riesco a distinguere due istanze, e l'organizzazione ha bisogno di farlo? È un valore, una misura o un attributo
T2 Esistenza autonoma Esiste, e può essere indicato, da solo? È un attributo di qualcos'altro, o parte di un valore composto
T3 Molteplicità Possono essercene molti, ora o in futuro? È un valore di configurazione, non un'entità
T4 Rilevanza Almeno un requisito obbliga la base di dati a ricordarlo? È fuori perimetro (registrare la decisione, poi scartarlo)

Il test T1 — Identità

L'organizzazione deve poter dire «questo, non quello».

  • Libro passa: un lettore chiede un titolo preciso, e la biblioteca ne possiede diversi.
  • Colore della copertina fallisce: due libri dello stesso colore non sono distinti da quel colore. È un attributo.
  • Multa passa, ma solo perché ogni multa ha una data, un importo e un motivo. Se il requisito fosse soltanto «questo socio ha debiti?», la risposta è un flag sul socio, non un'entità.

Identità non significa avere un nome. Un prestito non ha un nome; è identificato da quale copia è stata prestata a quale socio quando. Quella è un'identità, espressa da una combinazione — esattamente il tipo di cosa che il modello concettuale deve registrare e che il modello relazionale trasformerà poi in una chiave.

Il test T2 — Esistenza autonoma

Chiedete: questa cosa può essere indicata senza nominare la cosa a cui appartiene?

  • Copia passa: «la copia 3 de Il nome della rosa» è una cosa a sé, con la propria data di acquisizione e il proprio stato di conservazione.
  • Via dell'indirizzo di un socio fallisce: esiste solo come parte dell'indirizzo del socio. È un attributo composto, non un'entità.
  • Riga d'ordine è il caso intermedio interessante: non esiste senza un ordine, eppure ha attributi propri (quantità, prezzo unitario al momento della vendita) e deve essere distinguibile dalle altre righe dello stesso ordine. In termini E-R è un'entità debole — un'entità la cui identità dipende da un'altra. Supera T2 in senso debole e sarà modellata nel Modulo 3.

Il test T3 — Molteplicità

Se la risposta a «possono essercene molti?» è definitivamente no, il concetto è configurazione, non dato.

  • Una biblioteca ha un nome e un orario di apertura. Sono impostazioni, non entità.
  • Una biblioteca ha molte sedi. Sede è un'entità.
  • Un'azienda ha una partita IVA. Un gruppo di aziende ne ha molte. Il test riguarda il dominio come evolverà plausibilmente, non le carte di oggi.

Il test T4 — Rilevanza

È il test che si salta, ed è quello che tiene onesto lo schema.

Un concetto supera T1–T3 ma nessun requisito lo riguarda mai. Le coordinate bancarie del fornitore superano i primi tre test e falliscono il quarto se nessuno pagherà mai un fornitore da questo sistema.

Fallire T4 non è un fallimento del candidato: è una decisione di perimetro, e va scritta con la sua conseguenza, esattamente come prescriveva la tabella di perimetro della lezione precedente. «I fornitori sono fuori perimetro in questa release; i prezzi di acquisto saranno registrati come testo libero sulla copia» è una frase professionale. Omettere silenziosamente i fornitori non lo è.

Il test decisivo: entità o attributo?

È la domanda che decide la maggior parte degli schemi, e ha una risposta netta.

Il test entità-contro-attributo

Un concetto va modellato come entità quando è vera almeno una di queste condizioni:

  1. Ha attributi propri che non sono attributi della cosa che lo menziona.
  2. È condiviso: la stessa istanza è riferita da molte altre istanze.
  3. Ha un ciclo di vita proprio: viene creato, modificato e dismesso in modo indipendente.
  4. Deve essere contato, elencato o rendicontato da solo.

Se nessuna delle quattro è vera, è un attributo del concetto che lo menziona.

Applichiamolo all'elenco della biblioteca.

Candidato Attributi propri? Condiviso? Ciclo di vita proprio? Rendicontato da solo? Verdetto
Autore Sì: nome, anno di nascita, nazionalità Sì: molti libri per autore Sì Sì Entità
Editore Sì: nome, città, contatti Sì Sì Sì Entità
Categoria Pochi: un nome e una descrizione Sì Raramente Sì Entità, ma piccola
Scaffale Sì: codice, sala, capienza Sì Sì Sì Entità
Indirizzo No, è un insieme di parti No No No Attributo composto
Numero di telefono No No No No Attributo multivalore
Email No No No No Attributo
Età No — ed è derivabile dalla data di nascita No No No Attributo derivato, e da non memorizzare
Prestiti totali di un socio No — è un conteggio di prestiti No No A volte Attributo derivato, o nulla

Due righe meritano un commento.

Categoria è il caso limite che ogni progettista incontra. Non ha quasi attributi propri, eppure è condivisa, ha un ciclo di vita proprio («abbiamo dismesso la categoria Poesia nel 2023») ed è rendicontata. I quattro test rispondono con chiarezza: condivisa + ciclo di vita proprio → entità. Un progettista che argomenta «è solo un campo» sta argomentando dal criterio sbagliato.

Età fallisce tutto, e fallisce due volte: non è una proprietà del socio come lo è il nome, perché cambia ogni anno senza che nessuno modifichi il record. Memorizzarla garantisce che prima o poi il valore memorizzato sarà in disaccordo con la data di nascita. È un attributo derivato, e in uno schema corretto gli attributi derivati o si calcolano al momento o non si modellano affatto.

La distinzione tipo/occorrenza

Se questa lezione insegna una cosa sola che valga la pena ricordare, è questa. La maggior parte degli errori di modellazione nei progetti degli studenti non riguarda entità sbagliate. Riguarda un concetto a cui vengono chiesti due ruoli: il tipo di cosa e la cosa specifica.

Tipo e occorrenza

Un tipo è una categoria o una specifica: Il nome della rosa, lo yoga, il piano mensile, il modello Toyota Corolla.

Un'occorrenza è un individuo specifico e identificabile di quel tipo: la copia 2 de Il nome della rosa, la lezione di yoga di martedì alle 18:00, l'abbonamento di Anna da marzo a giugno, l'auto con targa AB123CD.

Sono entità diverse con attributi diversi, e fonderle distrugge informazione che non sarà più recuperabile.

Lo schema si ripete tra domini diversi con regolarità quasi meccanica.

Dominio Tipo Occorrenza Cosa si perde fondendole
Biblioteca Libro (titolo) Copia Quale copia fisica è in prestito, danneggiata, smarrita
Biblioteca Piano di abbonamento L'abbonamento del socio Date di inizio e fine, prezzo pagato
Palestra Corso (yoga) Lezione (martedì 18:00) Prenotazioni, sala, istruttore
Vendita Prodotto Unità di magazzino / lotto Giacenze, scadenza, ubicazione
Autonoleggio Modello di veicolo Veicolo (targa) Disponibilità, chilometraggio, danni
Compagnia aerea Numero di volo Volo di una data Posti, ritardi, equipaggio
Ospedale Medico Slot di appuntamento Disponibilità, ambulatorio, durata
Università Corso di studio Edizione dell'anno Iscrizioni, docente, orario

Il test che li separa è sempre la stessa domanda: la cosa ha fatti che il tipo non può avere?

Il nome della rosa ha un ISBN e un autore. Non ha una data di acquisizione, uno stato di conservazione o uno scaffale. La copia 2 ha tutti e tre, e il suo titolo è uno dei suoi attributi. Viceversa una copia non ha un autore: l'autore appartiene al titolo.

Quando un documento dei requisiti dice «la biblioteca possiede 12.000 libri», sta contando copie. Quando dice «abbiamo 8.000 titoli», sta contando tipi. Uno schema con uno solo dei due non può rispondere all'altra domanda, e la differenza tra quelle due frasi è l'intero senso di questa sezione.

Gli eventi: la terza specie di candidato

Un prestito, una prenotazione, un pagamento, una visita, una consegna, un'iscrizione, un'ispezione. Sono eventi: qualcosa che accade in un istante o in un intervallo, coinvolgendo altre cose.

Gli eventi superano facilmente i quattro test — hanno identità (per partecipanti e tempo), attributi propri (data, importo, stato), un ciclo di vita proprio e sono continuamente rendicontati. La difficoltà non è se siano entità; è se i requisiti abbiano bisogno dell'evento o solo della sua conseguenza attuale.

Requisito Cosa impone
«Mostrare quale copia ha attualmente ciascun socio» Un'entità Prestito con uno stato, oppure un flag in_prestito sulla copia
«Mostrare lo storico dei prestiti di un socio negli ultimi tre anni» Un'entità Prestito, senza alternative
«Sapere se una copia è disponibile» Derivabile dall'entità prestito; non è un fatto separato
«Applicare 0,50 al giorno di ritardo» Un Prestito con data di scadenza e data di restituzione, più la regola
«Contare quanti prestiti ha fatto ciascun socio quest'anno» Un'entità Prestito, e il conteggio è derivato

La regola che risolve la questione: modellate l'evento quando lo storico conta; modellate lo stato quando conta solo il presente. E nel dubbio modellate l'evento — un flag di stato è sempre calcolabile dagli eventi, mentre gli eventi non sono ricostruibili da un flag. L'informazione scorre in una sola direzione.

La procedura sui sintagmi nominali

Ecco la parte meccanica. È deliberatamente noiosa, perché le procedure noiose sono ripetibili, e le procedure ripetibili possono essere riesaminate da qualcun altro.

Passo 1 — Segnate ogni sostantivo e ogni sintagma nominale. Stampate il testo dei requisiti e sottolineateli. Non filtrate ancora. Includete quelli che sembrano ridicoli: sede, stato di conservazione, nota, motivo, lingua preferita.

Passo 2 — Costruite la tabella grezza. Una riga per candidato, con la frase che lo ha prodotto. La frase non è decorazione: è la prova di cui avrete bisogno quando qualcuno contesterà il verdetto.

Passo 3 — Applicate T1–T4. Registrate quale test fallisce ciascun candidato. Un verdetto senza il test fallito è un'opinione.

Passo 4 — Applicate il test entità-contro-attributo a tutto ciò che è sopravvissuto. Registrate le quattro sotto-risposte, non solo la conclusione.

Passo 5 — Cercate le coppie tipo/occorrenza. Rileggete l'elenco dei sopravvissuti cercando concetti che esistono in una versione «genere» e in una versione specifica. Questo passo non è automatico: richiede le due domande diagnostiche.

Passo 6 — Nominate, definite e registrate ciò che resta aperto. Ogni candidato sopravvissuto riceve un nome al singolare, una definizione di una frase nelle parole dell'organizzazione, un identificatore provvisorio e ogni domanda a cui i requisiti non rispondono.

I passi 1 e 2 richiedono dieci minuti. I passi da 3 a 6 richiedono un'ora, ed è l'ora che ne fa risparmiare una settimana.

Esempio svolto: il testo della biblioteca

I requisiti delle lezioni precedenti, in forma condensata:

La biblioteca ha diverse sedi. Ogni sede possiede una collezione di libri e impiega bibliotecari. Un libro ha un titolo, uno o più autori, un editore, un ISBN, una categoria e un anno di pubblicazione. La biblioteca possiede diverse copie fisiche dello stesso libro; ogni copia ha una data di acquisizione, uno stato di conservazione e una collocazione su uno scaffale. I soci si registrano presso una sede, hanno un numero di tessera, un nome, un indirizzo con via, città e CAP, uno o più numeri di telefono e un'email. Un socio può prendere in prestito al massimo cinque copie alla volta, per 30 giorni. Quando una copia viene restituita in ritardo, viene applicata una multa di 0,50 al giorno. I soci possono prenotare un libro attualmente in prestito. I bibliotecari registrano prestiti e restituzioni. La biblioteca vuole conservare lo storico dei prestiti degli ultimi tre anni.

Applicando la procedura:

Candidato T1 identità T2 autonomo T3 molteplice T4 rilevante Verdetto Motivo
Sede Sì Sì Sì Sì Entità «Diverse sedi»; prestiti e soci appartengono a una sede
Libro (titolo) Sì (ISBN) Sì Sì Sì Entità Condiviso da molte copie; ha autore, editore, anno
Copia Sì Sì Sì Sì Entità Data di acquisizione, stato, scaffale propri; prestata singolarmente
Autore Sì Sì Sì Sì Entità Condiviso; «uno o più autori»
Editore Sì Sì Sì Sì Entità Condiviso tra titoli
Categoria Sì Sì Sì Sì Entità Condivisa, rendicontata, ciclo di vita proprio
Scaffale Sì Sì Sì Sì Entità Collocazione delle copie; capienza
Socio Sì Sì Sì Sì Entità Il numero di tessera è l'identificatore
Prestito Sì Debole Sì Sì Entità Evento con date e stato; storico richiesto
Prenotazione Sì Debole Sì Sì Entità Evento con posizione in coda e stato
Multa Sì Debole Sì Sì Entità Importo, motivo, pagata/non pagata
Bibliotecario Sì Sì Sì Sì Entità Registra i prestiti; serve identità per l'audit
Indirizzo No No No Sì Attributo composto di Socio Via, città e CAP sono parti, non entità
Numero di telefono No No No Sì Attributo multivalore di Socio Più d'uno per socio, senza attributi propri
Email No No No Sì Attributo di Socio A valore singolo
Anno di pubblicazione No No No Sì Attributo di Libro Un numero
Data di acquisizione No No No Sì Attributo di Copia Una data
Stato di conservazione No No No Sì Attributo di Copia Un valore enumerato
Numero di tessera No No No Sì Identificatore di Socio Non è un'entità separata
Tariffa di multa (0,50/giorno) No No No Sì Regola aziendale / parametro Non è un dato sui soci
Storico prestiti (3 anni) — — — Sì Requisito su Prestito Obbliga Prestito a essere un evento, e la conservazione
«Al massimo cinque copie» — — — Sì Regola aziendale Un vincolo di cardinalità, più avanti
«30 giorni» — — — Sì Regola aziendale La regola sulla data di scadenza

Tredici entità, otto attributi, quattro regole. Notate cosa ha ottenuto la tabella: ogni voce ha un motivo, e i motivi si possono contestare. Qualcuno può dire «non sono d'accordo, Scaffale dovrebbe essere un campo di testo libero su Copia», e la discussione diventa concreta e decidibile: gli scaffali sono condivisi e rendicontati, sì o no? A questo serve un documento di progetto.

Notate anche i tre eventi marcati Debole sotto T2. Un prestito non esiste senza una copia e un socio, eppure ha attributi propri e un'identità propria nel tempo. Sono le entità deboli e le entità-evento che il Modulo 3 modellerà come si deve; a questo stadio basta sapere che sono entità e non attributi.

I nomi: l'indicatore di qualità più economico

I nomi non sono estetica. Uno schema con nomi sbagliati è uno schema che verrà frainteso, e il fraintendimento è la madre dei difetti.

Nome sbagliato Problema Nome migliore Perché
tbl_socio Dettaglio realizzativo penetrato nel modello concettuale Socio I nomi concettuali descrivono il dominio, non la memorizzazione
Soci Plurale Socio L'entità nomina la classe; le istanze sono molte
SOCIO Convenzione SQL Socio Il maiuscolo è una decisione fisica
PrenditoreInPrestito Un ruolo, non la cosa Socio Il socio è un prenditore solo mentre prende in prestito; il ruolo appartiene all'associazione
CopiaDiLibro Due concetti incollati Copia Se il dominio dice «copia», usate «copia»
Dati, Info, Record Privati di significato — Un nome che va bene per tutto non identifica nulla
CalcoloMulta Un processo Multa I processi non sono entità; lo sono i loro risultati
inRitardo Un predicato Prestito con data di scadenza e di restituzione Il predicato è derivabile

Quattro regole coprono quasi tutto:

  1. Singolare, perché l'entità è una classe.
  2. Linguaggio del dominio, perché lo schema è un contratto con l'organizzazione, non con il programmatore.
  3. Un sostantivo che non è un ruolo e non è un processo, perché ruoli e processi si modellano altrove.
  4. Stabile, perché rinominare un'entità dopo che esistono le associazioni costa caro.

L'elenco delle entità candidate come deliverable

Il risultato di questa lezione non è un diagramma. È una tabella da cui il diagramma sarà poi derivato, e che un revisore può controllare riga per riga.

Colonna Contenuto
Nome Al singolare, nel linguaggio del dominio
Definizione Una frase, nelle parole dell'organizzazione, che dice cosa è una singola istanza
Perché è un'entità Il test o i test superati, o il requisito che la impone
Identificatore provvisorio Il fatto che distinguerà le istanze (può essere composto)
Tipo o occorrenza Quale delle due, e la sua controparte
Riferimento al perimetro L'identificativo del requisito che la giustifica
Domande aperte Ciò a cui i requisiti non rispondono

Una riga compilata:

Copia — Un esemplare fisico di un titolo posseduto da una sede. Perché: attributi propri (data di acquisizione, stato di conservazione, scaffale), prestito individuale. Identificatore: il numero di copia all'interno del titolo, oppure un codice a barre. Occorrenza di Libro. Requisiti: F3, F7. Aperto: le copie smarrite restano in catalogo, e in quale stato?

Quella riga sarà revisionata, contestata e corretta. È proprio questo il punto. Confrontatela con un semplice punto elenco «Copia» in una lista di tredici sostantivi, che può solo essere accettata o rifiutata in blocco.

Errori comuni

Errore Come si presenta Perché fa male Rimedio
Trattare ogni sostantivo come entità Uno schema con 25 entità per una biblioteca piccola Associazioni senza fine, nessun modello chiaro Applicare il test entità-contro-attributo
Trattare ogni attributo come entità Tabelle Città, CAP, Colore Associazioni inutili; uno schema che modella il dizionario Condivisione + ciclo di vita + rendicontazione, altrimenti è un attributo
Fondere tipo e occorrenza Libro con una colonna numero_copia Impossibile rappresentare due copie prestate a due soci Separare Libro e Copia
Modellare il processo invece del risultato Prestito come verbo, Calcolo, Registrazione Non c'è nulla da memorizzare; il modello descrive verbi Modellare l'evento o lo stato che ne risulta
Usare un ruolo come nome di entità PrenditoreInPrestito, LibroPrestato I ruoli appartengono alle associazioni Nominare la cosa; esprimere il ruolo nell'associazione
Memorizzare fatti derivati età, prestiti_totali, disponibile Sicuramente andranno fuori sincrono Calcolare, oppure modellare gli eventi
Omettere un'entità che nessuno ha nominato Manca Sede, anche se i prestiti avvengono nelle sedi Il requisito non può essere soddisfatto affatto Rileggere i requisiti frase per frase
Verdetti senza motivazioni Un elenco puntato di sostantivi Non revisionabile; gli errori sopravvivono fino al diagramma La tabella a sette colonne
  • Un'entità è una classe di oggetti del dominio descritti dalle stesse proprietà; un'istanza è uno di essi. Il modello descrive classi, non righe.
  • Quattro test classificano ogni candidato: identità, esistenza autonoma, molteplicità, rilevanza. Un candidato che fallisce un test non diventa per questo inutile: è qualcos'altro.
  • Il test entità-contro-attributo ha quattro clausole: attributi propri, condivisione, ciclo di vita proprio, rendicontazione autonoma. Una sola è sufficiente per farne un'entità; nessuna significa che è un attributo.
  • La distinzione tipo/occorrenza è l'errore più frequente e più costoso. Chiedete «quanti ne abbiamo?» e «che cos'è?»: se le risposte differiscono, ci sono due entità.
  • Gli eventi sono entità. Modellate l'evento quando lo storico conta, lo stato quando conta solo il presente, e ricordate che un flag è una decisione di dimenticare.
  • La procedura sui sintagmi nominali consta di sei passi meccanici che terminano in una tabella dove ogni verdetto porta con sé la propria motivazione.
  • I nomi sono un indicatore di qualità: singolare, linguaggio del dominio, non un ruolo, non un processo, stabile.

Domande di verifica

1. Il sistema di prenotazioni di un parrucchiere ha i concetti servizio, appuntamento, parrucchiere, poltrona, prezzo e durata. Classificate ciascuno come entità, attributo o regola, e giustificate con i quattro test.

Show the solution
  • Servizio — entità. Condiviso (un taglio viene venduto molte volte), attributi propri (durata, prezzo), ciclo di vita proprio (il listino cambia), rendicontato (ricavi per servizio). Supera tutti e quattro.
  • Appuntamento — entità, e un evento. Identità per parrucchiere, cliente e orario; attributi propri (stato, note); rendicontato (occupazione, assenze). Fallisce T2 solo in senso debole.
  • Parrucchiere — entità. Identità (una persona), condiviso (molti appuntamenti), ciclo di vita proprio, rendicontato (carico di lavoro).
  • Poltrona — entità, ma solo se le poltrone sono una risorsa limitata da assegnare. Se il requisito è soltanto «il salone ha tre poltrone», fallisce T1 (due poltrone non sono distinte da nulla) e diventa un dato di capienza. È il caso limite guidato da T4: chiedetevi se l'organizzazione avrà mai bisogno di sapere quale poltrona.
  • Prezzo — attributo di Servizio. È un valore unico per servizio, senza identità, senza condivisione e senza ciclo di vita proprio. Se il requisito include lo storico dei prezzi, allora il prezzo diventa un'entità di tipo evento (un prezzo valido da una data), il che è un requisito genuinamente diverso.
  • Durata — attributo di Servizio, per lo stesso ragionamento.

2. Perché Libro con una colonna numero_copia è un errore di progetto, e quale informazione viene distrutta?

Show the solution

Perché fonde un tipo e un'occorrenza in un'unica entità. La riga di Libro rappresenta allora un titolo, e numero_copia può contenere un solo valore: un titolo con quattro copie richiede quindi quattro righe, ciascuna che ripete ISBN, titolo, autore ed editore. Questa è ridondanza, ed è il problema minore.

L'informazione distrutta è la capacità di dire quale copia fisica è stata prestata, restituita danneggiata, smarrita o spostata in un'altra sede. Con quattro righe Libro duplicate non esiste un'identità stabile per una copia: se una riga viene cancellata, lo storico a essa agganciato sparisce con lei, e se due righe descrivono lo stesso titolo nessuno può dire se sono due copie o un errore di inserimento. Data di acquisizione, stato di conservazione e collocazione diventano tutti ambigui: si agganciano a una riga che a volte è un titolo e a volte è una copia.

Il modello corretto è Libro (fatti di livello titolo: ISBN, titolo, editore, anno, categoria, autori) e Copia (fatti di livello copia: data di acquisizione, stato, scaffale, disponibilità), con un'associazione uno-a-molti. Allora entrambe le domande «quanti titoli?» e «quante copie?» hanno risposta.

3. Un requisito dice: «il sistema deve mostrare se una copia è attualmente disponibile». Serve un'entità Prestito?

Show the solution

Non di per sé. La disponibilità è la negazione di «esiste un prestito attivo per questa copia», quindi è derivabile dai dati di prestito. Se l'entità prestito esiste per altri requisiti — e in una biblioteca quasi sempre esiste, perché servono storico e multe — la disponibilità è un'interrogazione, non un fatto memorizzato.

Considerate però il caso in cui nessun altro requisito imponga i prestiti: uno strumento minimo che risponde solo a «è sullo scaffale?». Allora il modello onesto è un attributo di stato sulla copia. È più economico e corretto per quell'insieme di requisiti.

La trappola è fare entrambe le cose: memorizzare disponibile e conservare i prestiti. I due andranno in disaccordo non appena un percorso di aggiornamento dimenticherà il flag. O lo derivate, o lo memorizzate come unica fonte di verità — mai entrambi.

Esercizio

Intermediate

Un ambulatorio veterinario

Leggete la descrizione e producete l'elenco delle entità candidate a sette colonne. Decidete il verdetto per ogni candidato e scrivete la motivazione.

Un ambulatorio veterinario cura gli animali. Ogni animale ha un nome, una specie, una razza, una data di nascita e un peso rilevato a ogni visita. Ogni animale ha uno o più proprietari; un proprietario può possedere più animali. I proprietari hanno un nome, un codice fiscale, un indirizzo, un numero di telefono e un'email. L'ambulatorio impiega veterinari, ciascuno con un numero di iscrizione all'albo e una specializzazione. Un proprietario prenota una visita per un animale con un veterinario specifico in una data e a un'ora. Durante la visita il veterinario registra una diagnosi, una terapia e, se necessario, una prescrizione. Una prescrizione contiene uno o più farmaci, ciascuno con un nome, un principio attivo e un dosaggio. L'ambulatorio vuole conoscere la storia clinica completa di ogni animale e sapere quali farmaci sono stati prescritti più spesso l'anno scorso. Le vaccinazioni sono registrate con il nome del vaccino, la data e la data del richiamo successivo.

Prestate particolare attenzione a: peso, prescrizione, farmaco, dosaggio, vaccinazione e alla differenza tra specie e razza.

Soluzione commentata

Entità

Nome Definizione Perché è un'entità Identificatore provvisorio Tipo/occorrenza Domande aperte
Animale Un paziente dell'ambulatorio Attributi propri, ciclo di vita proprio, rendicontato Microchip, o numero di cartella — Può un animale cambiare proprietario? Se sì, la proprietà è un evento, non un legame
Proprietario La persona giuridicamente responsabile di uno o più animali Attributi propri, condiviso tra animali Codice fiscale — I proprietari sono anche i contatti di fatturazione?
Veterinario Un clinico che lavora nell'ambulatorio Attributi propri, condiviso tra visite Numero di iscrizione all'albo — Può un veterinario essere esterno (consulente)? Se sì, serve un tipo
Visita Un incontro clinico tra un animale e un veterinario in un dato momento Evento: date, diagnosi, terapia; storico richiesto Animale + data + ora — Possono due veterinari vedere lo stesso animale in una visita?
Prescrizione L'insieme dei farmaci prescritti in una visita Attributi propri (data, stato); rendicontata Visita + numero progressivo — Può una prescrizione essere rinnovata senza una nuova visita?
Farmaco Un prodotto medicinale prescrivibile Condiviso tra prescrizioni, attributi propri, rendicontato Nome + principio attivo, o un codice Tipo I farmaci sono in magazzino? Se sì, serve un'occorrenza UnitàDiMagazzino
Vaccinazione La somministrazione di un vaccino a un animale Evento con data propria e data del richiamo Animale + vaccino + data — Il vaccino è un Farmaco? Se sì, questa è una specializzazione
Specie La specie biologica di un animale Condivisa, rendicontata (statistiche per specie) Nome Tipo —
Razza Una razza all'interno di una specie Condivisa, appartiene a una specie Nome + specie Tipo, dipendente da Specie La razza è mai ignota? Allora deve essere opzionale

Attributi, non entità

Candidato Verdetto Motivo
Peso Attributo di Visita È rilevato a ogni visita, quindi appartiene alla visita, non all'animale. Memorizzare un unico peso sull'animale perderebbe l'andamento — e l'andamento è il segnale clinico. È il caso classico in cui la frase «a ogni visita» sposta un attributo su un'altra entità.
Dosaggio Attributo della riga di prescrizione Dipende sia dalla prescrizione sia dal farmaco; non è una proprietà del solo farmaco
Diagnosi, terapia Attributi di Visita Testo libero a questo stadio; se servono diagnosi codificate, Diagnosi diventa un'entità
Nome dell'animale, data di nascita Attributi di Animale A valore singolo
Codice fiscale, indirizzo, telefono, email Attributi di Proprietario Il telefono può essere multivalore se il requisito dice «numeri»
Specializzazione Attributo di Veterinario A valore singolo; diventa entità solo se le specializzazioni sono condivise, elencate e rendicontate
Principio attivo Attributo di Farmaco A valore singolo; diventa entità se i farmaci si cercano per principio attivo
Data del richiamo Attributo di Vaccinazione Derivata dalla data e dalla validità del vaccino, quindi registrate la regola

Le due domande che decidono l'esercizio

Il peso è la trappola. Sembra un attributo di Animale ed è in realtà un attributo di Visita. La frase «rilevato a ogni visita» è l'intero requisito, e uno schema con un'unica colonna peso non può rispondere a «questo animale sta perdendo peso?».

Specie e razza formano una gerarchia di tipo genuina: una razza appartiene a una sola specie, e la specie è rendicontata autonomamente. Modellare entrambe è corretto. Modellare solo la razza perde le statistiche per specie; modellare solo la specie perde la razza, di cui proprietari e veterinari si preoccupano. Notate che Razza è un'entità dipendente — la sua identità ha senso solo dentro una specie — il che è un'anteprima del concetto di entità debole.

Un'altra cosa che l'elenco rivela

Nulla nell'elenco modella chi paga. La fatturazione non è menzionata nei requisiti, quindi fallisce T4 ed è fuori perimetro — ma la decisione va registrata, perché nel momento in cui l'ambulatorio chiederà «quale proprietario ci deve dei soldi?», comparirà una nuova entità e la relazione proprietario-animale acquisirà una dimensione economica che oggi non ha.

Dove andare adesso

Lezioni correlate