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:
- Ha attributi propri che non sono attributi della cosa che lo menziona.
- È condiviso: la stessa istanza è riferita da molte altre istanze.
- Ha un ciclo di vita proprio: viene creato, modificato e dismesso in modo indipendente.
- 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 |
| 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 |
| 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:
- Singolare, perché l'entità è una classe.
- Linguaggio del dominio, perché lo schema è un contratto con l'organizzazione, non con il programmatore.
- Un sostantivo che non è un ruolo e non è un processo, perché ruoli e processi si modellano altrove.
- 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 |
Riepilogo
- 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
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
- La lezione che ha prodotto la mappa dei concetti su cui si costruisce questo elenco: L'analisi del dominio applicativo.
- I requisiti a cui questo elenco deve risalire: La raccolta dei requisiti.
- Un diagramma completo con entità, attributi e cardinalità: Studenti e corsi.
- L'architettura che separa il significato del dominio dalla memorizzazione fisica: L'architettura a tre livelli ANSI/SPARC.