Il glossario dei termini
Un glossario non è documentazione scritta dopo lo schema. È lo strumento che rende possibile lo schema, perché una base di dati non può essere più precisa delle parole usate per descriverla. Questa lezione mostra come costruirne uno che venga davvero usato.
Base
Obiettivi di apprendimento
- Scrivere una voce di glossario con termine, definizione, esclusioni, esempi e fonte
- Riconoscere sinonimi, omonimi e termini vaghi in un testo dei requisiti
- Scegliere il termine canonico usando criteri espliciti
- Mantenere allineati glossario e schema concettuale nelle due direzioni
- Usare il glossario come ancora per la denominazione multilingue
Prerequisiti
- L'individuazione di attributi e associazioni
- L'individuazione delle entità candidate
Introduzione
Ogni progetto di base di dati contiene un momento come questo.
Il bibliotecario dice «il prestito». Il direttore dice «il noleggio». Il vecchio sistema lo chiama «la transazione». Il modulo cartaceo dice «la consegna». Tutti e quattro parlano della stessa cosa, e nessuno di loro sa che gli altri stanno usando una parola diversa.
Poi qualcuno chiede che cosa succede quando un socio restituisce un libro in ritardo, e la risposta arriva in due versioni: «applichiamo una multa» dal bibliotecario e «non applichiamo mai multe, sospendiamo l'iscrizione» dal direttore. Le due affermazioni non sono contraddittorie — descrivono due rami della stessa regola — ma il gruppo di progetto sente una contraddizione e passa una settimana a risolverla.
Entrambi i problemi hanno la stessa radice: il progetto non ha un vocabolario concordato. Non un vocabolario sbagliato — nessuno.
Glossario
Un glossario è l'elenco controllato dei termini usati in un progetto di base di dati, ciascuno con un'unica definizione concordata, i sinonimi accettati, le esclusioni esplicite e un rimando a dove compare nei requisiti e nello schema.
È controllato nel senso che i termini vengono ammessi deliberatamente, non accumulati. Una parola che non è nel glossario non dovrebbe comparire in un requisito, in un diagramma, in un nome di colonna o in una conversazione senza che qualcuno chieda perché.
Il glossario viene di solito trattato come documentazione: qualcosa prodotto alla fine, da chi ha tempo, per soddisfare una lista di controllo. È esattamente il contrario. Il glossario è uno strumento di progetto, e prima esiste più ripaga.
Ecco perché, detto nel modo più semplice possibile: una base di dati non può essere più precisa delle parole usate per descriverla. Se «prestito» significa due cose diverse in due frasi dei requisiti, lo schema o sceglierà un significato perdendo silenziosamente l'altro, oppure li fonderà producendo un'entità che non significa nulla. Nessuna abilità nel disegnare diagrammi ripara un difetto di vocabolario, perché il diagramma riproduce fedelmente la confusione.
Che cosa contiene una voce di glossario
Un termine e una definizione non bastano. La voce deve rendere visibile il disaccordo.
| Campo | Scopo | Esempio |
|---|---|---|
| Termine | Il nome canonico | Prestito |
| Definizione | Una frase, verificabile, nelle parole del dominio | Il trasferimento temporaneo di una copia a un socio, con una data di scadenza |
| Non | Che cosa il termine esplicitamente non significa | Non una prenotazione; non un rinnovo; non un trasferimento tra sedi |
| Sinonimi | Parole che significano la stessa cosa e vanno evitate | Noleggio, transazione, consegna (sistema legacy) |
| Esempi | Un caso positivo e uno negativo | Positivo: copia 2 prestata al socio 4471 il 3 marzo. Negativo: un socio che prenota una copia in prestito |
| Responsabile | Chi ha l'autorità per risolvere le dispute sul termine | Bibliotecario capo |
| Fonte | Da dove viene la definizione | Intervista del 12 febbraio, confermata per iscritto il 20 febbraio |
| Requisiti | Quali identificativi di requisito usano il termine | F7, F9, F12, N4 |
| Schema | Quale entità o attributo lo implementa | Prestito |
Due campi fanno la maggior parte del lavoro, ed entrambi vengono di solito omessi.
«Non» è il campo che previene gli errori più costosi. Una definizione dice che cosa un termine è; l'esclusione dice che cosa non è, e la maggior parte delle confusioni di vocabolario riguarda i confini. Prestito definito come «il trasferimento di una copia a un socio» è compatibile con un rinnovo; Prestito con l'esclusione «non un rinnovo — un rinnovo prolunga un prestito esistente ed è registrato come attributo di esso» non lo è. La seconda versione impedisce uno schema in cui i rinnovi sono prestiti separati che contano la copia due volte.
«Fonte» è il campo che rende il glossario autorevole. Una definizione che viene da un'intervista in una data precisa può essere verificata, contestata e corretta. Una definizione che viene da nessun luogo è un'opinione che sarà sovrascritta da chi parla per ultimo.
I termini non sono solo entità
Un malinteso comune: il glossario è l'elenco delle entità con un altro nome. Non lo è. Il glossario copre tutto ciò che il progetto deve dire in modo preciso.
| Tipo di termine | Esempio | Dove finisce nello schema |
|---|---|---|
| Entità | Copia, Socio | Entità |
| Attributo | Stato di conservazione, Data di scadenza | Attributo |
| Valore di stato | In ritardo, Ritirata | Valore in un dominio enumerato |
| Ruolo | Prenditore, Supervisore | Nome di ruolo in un'associazione |
| Evento | Restituzione, Prenotazione | Entità (di solito) |
| Misura | Durata del prestito, Tariffa di multa | Attributo o parametro |
| Regola | Limite di prestiti | Vincolo, non una colonna |
| Documento | Tessera | Forse nulla — può essere fuori perimetro |
Le ultime due righe sono quelle che colgono in fallo. Limite di prestiti è una regola, e le regole non diventano colonne; uno schema che aggiunge max_prestiti a ogni riga socio ha frainteso il termine. Tessera può essere un artefatto fisico che il sistema non modella mai, e dirlo nel glossario impedisce a qualcuno di costruire un'entità Tessera per un pezzo di plastica.
I tre difetti di vocabolario
Quasi ogni problema di glossario è di tre tipi. Imparare a nominarli li rende trovabili.
Sinonimia
Due o più parole usate per lo stesso concetto: prestito, noleggio, transazione, consegna.
Costo: lo schema acquisisce due entità o due attributi per un solo fatto, e i dati si dividono tra loro. Un report sui «prestiti» omette silenziosamente le righe registrate come «noleggi».
Omonimia (polisemia)
Una parola usata per due o più concetti: «libro» che significa il titolo e la copia fisica; «socio» che significa una persona registrata e una persona con un abbonamento attivo.
Costo: a un'unica entità viene chiesto di contenere due tipi di fatto, e ogni attributo diventa condizionalmente significativo. Il sintomo classico è una colonna che è NULL per metà delle righe perché si applica solo a uno dei due significati.
Termine vago
Una parola senza confine verificabile: «recente», «grande», «adeguato», «valido», «attivo», «presto».
Costo: il requisito non è implementabile né verificabile, quindi l'implementatore inventa una soglia e l'utente rifiuta il risultato. Ogni termine vago è o un requisito mancante o una regola aziendale nascosta.
I tre difetti richiedono tre risposte diverse, e confonderli fa perdere tempo.
| Difetto | Risposta | Cosa producete |
|---|---|---|
| Sinonimia | Scegliere un termine canonico; elencare gli altri come da evitare | Una voce di glossario con i sinonimi |
| Omonimia | Dividere in due termini con nomi distinti | Due voci di glossario, e di solito due entità |
| Termine vago | Quantificare o escalare come domanda aperta | Un numero, una data o una decisione registrata |
Notate che un'omonimia non si risolve scegliendo: si risolve dividendo. «Useremo libro per indicare solo il titolo» è una decisione, ma lascia la copia fisica senza nome, e la copia è ciò che viene prestato. La risposta giusta è introdurre un secondo termine (Copia) e tenere entrambi.
Trovare i termini
I termini si nascondono in quattro posti, e una passata accurata li visita tutti.
1. Il testo dei requisiti. Ogni sostantivo e sintagma nominale, più ogni aggettivo che descrive uno stato. Le due lezioni precedenti hanno già estratto i sostantivi; il glossario aggiunge gli stati e le misure.
2. Le interviste. Ascoltate le parole che le persone ripetono e, soprattutto, le parole su cui le persone si correggono a vicenda. «No, quello non è un prestito, è una prenotazione» è una voce di glossario che nasce.
3. I documenti e i sistemi esistenti. Moduli vecchi, report vecchi, i nomi delle colonne della base di dati precedente. Da qui vengono i sinonimi: l'organizzazione usa tre parole per la stessa cosa da quindici anni, e il nuovo schema erediterà la confusione a meno che il glossario non la nomini.
4. Lo schema mentre cresce. Ogni entità e ogni attributo che aggiungete deve avere una voce di glossario. Se non ce l'ha, o il termine manca dal glossario o l'elemento è ingiustificato — entrambe sono scoperte utili.
Scegliere il termine canonico
Quando si trova un insieme di sinonimi, un termine deve vincere. Quattro criteri, applicati in ordine:
| Criterio | Domanda | Esempio biblioteca |
|---|---|---|
| Precisione | Quale termine ha il significato corretto più stretto? | Prestito batte transazione: una transazione potrebbe essere qualsiasi cosa |
| Uso del dominio | Quale termine usano davvero gli esperti del dominio? | I bibliotecari dicono prestito; il sistema contabile dice transazione |
| Assenza di collisione | Quale termine non è già usato per altro? | Consegna collide con le consegne dei fornitori |
| Brevità | Tra pari, il più corto | Prestito invece di transazione di prestito librario |
La precisione viene per prima perché un termine troppo ampio verrà riusato per qualcos'altro entro un anno. L'uso del dominio viene secondo perché il glossario è un contratto con l'organizzazione, e un termine che non riconoscono non verrà usato, per elegante che sia.
Esempio svolto: il glossario della biblioteca
Sei voci dal caso di studio in corso, scelte perché ciascuna risolve un'ambiguità reale.
| Termine | Definizione | Non | Sinonimi evitati | Schema |
|---|---|---|---|---|
| Titolo | Un'opera bibliografica che la biblioteca può possedere in una o più copie fisiche | Non una copia; non un'edizione | Libro (ambiguo), opera | Libro |
| Copia | Un esemplare fisico di un titolo, custodito in una sede | Non un titolo; non un prestito | Unità, volume, esemplare | Copia |
| Prestito | Il trasferimento temporaneo di una copia a un socio, con una data di scadenza | Non una prenotazione; non un rinnovo; non un trasferimento tra sedi | Noleggio, transazione, consegna | Prestito |
| Rinnovo | La proroga di un prestito esistente, registrata su quel prestito | Non un nuovo prestito | Proroga, prolungamento | Prestito.rinnovi |
| Prenotazione | La richiesta di un socio su un titolo che al momento non ha copie disponibili | Non un prestito; non una riserva su una copia specifica | Booking, richiesta, hold | Prenotazione |
| Multa | Un importo dovuto da un socio per uno specifico prestito in ritardo | Non un corrispettivo per un servizio; non il costo di sostituzione di una copia smarrita | Penalità, sanzione | Multa |
Cinque osservazioni, ciascuna delle quali è una lezione.
«Titolo» invece di «Libro». Il dominio dice libro, ma libro è usato sia per l'opera sia per l'oggetto fisico, e l'oggetto fisico è ciò che viene prestato. Introdurre titolo e copia risolve l'omonimia. Notate il costo: i bibliotecari continueranno a dire «libro» per un po', quindi entrambe le parole devono comparire nel glossario, con libro marcato come ambiguo.
«Rinnovo» è un attributo, non un'entità. La voce di glossario lo dice esplicitamente — «registrata su quel prestito» — il che impedisce allo schema di creare un'entità Rinnovo che duplicherebbe l'identità del prestito e renderebbe ambiguo il conteggio dei prestiti. È il campo «Non» a portare questa decisione.
«Prenotazione» non è una riserva su una copia specifica. È una vera decisione di modellazione travestita da definizione. Se le prenotazioni fossero su copie, un socio potrebbe prenotare solo copie esistenti; prenotare un titolo che la biblioteca non possiede ancora sarebbe impossibile. La definizione sceglie l'interpretazione a livello di titolo, e va confermata con la biblioteca.
«Multa» non è un corrispettivo. La biblioteca ha entrambe le cose: multe per il ritardo e corrispettivi per servizi come le fotocopie. Due parole, due concetti, due entità — e senza l'esclusione qualcuno le fonderebbe in una tabella Addebito perdendo la distinzione che conta per la rendicontazione.
Ogni voce punta allo schema. La colonna Schema è ciò che tiene vivo il glossario. Quando il modello cambia, la colonna si rompe, e la rottura è visibile.
Il glossario e la denominazione multilingue
ERMap Academy stessa è una piccola illustrazione dello stesso problema in un'altra dimensione: lo stesso concetto deve avere un'identità e diversi nomi.
La regola che lo rende possibile è: il glossario contiene il concetto, i file di lingua contengono le etichette.
| Livello | Contiene | Cambia quando |
|---|---|---|
| Concetto | Un identificativo stabile e una definizione autorevole | Il dominio cambia |
| Etichette | Il termine in ciascuna lingua | Una traduzione migliora |
| Schema | Il nome fisico, derivato dal termine canonico | Lo schema viene rifattorizzato |
Se il nome dello schema deriva dall'etichetta italiana, il giorno in cui il progetto aggiunge l'inglese il nome dello schema diventa un incidente storico che nessuno sa spiegare. Se deriva dal concetto, l'etichetta può cambiare liberamente.
Per il caso di studio della biblioteca questo conta meno — una lingua, uno schema. Per qualunque sistema con più di una comunità linguistica, il glossario è l'unica cosa che tiene stabili i nomi dello schema mentre i nomi visualizzati cambiano.
Mantenere il glossario
Un glossario non mantenuto è peggio di nessun glossario, perché le persone se ne fidano.
Tre pratiche lo tengono vivo:
Assegnate un responsabile per ogni termine. Non un responsabile per l'intero glossario — un responsabile per termine, la persona con l'autorità di risolvere le dispute. Le dispute vengono risolte dalla persona giusta invece che da quella più rumorosa.
Versionatelo insieme ai requisiti. Il glossario fa parte del documento dei requisiti, non è un'appendice del codice. Un cambiamento a una definizione è un cambiamento ai requisiti, e dovrebbe innescare una revisione dei requisiti e degli elementi di schema coinvolti.
Rompete deliberatamente. Quando un termine deve cambiare, registrate la vecchia definizione e la data del cambiamento. Sei mesi dopo, la domanda «perché questa colonna si chiama prestito quando l'interfaccia dice noleggio?» ha una risposta.
Errori comuni
| Errore | Come si presenta | Perché fa male | Rimedio |
|---|---|---|---|
| Definizioni che ripetono il termine | «Un prestito è un prestito»; «il socio è la persona che è socia» | Nessuna informazione; nulla di verificabile | Definire che cos'è una singola istanza, e aggiungere le esclusioni |
| Nessun campo «Non» | Una definizione compatibile con tre interpretazioni | I confini restano indecisi finché non li decide il codice | Aggiungere esclusioni esplicite |
| Sinonimi lasciati irrisolti | Prestito e noleggio usati entrambi nei requisiti | I dati si dividono; i report sottostimano | Un termine canonico, gli altri marcati come da evitare |
| Omonimie non divise | Libro che significa titolo e copia | Colonne NULL per metà delle righe |
Due termini, due voci, di solito due entità |
| Termini vaghi accettati | «recente», «valido», «attivo» | Non implementabile e non verificabile | Quantificare, o registrare come domanda aperta |
| Glossario come appendice postuma | Scritto dopo lo schema, da una persona, in una settimana | Descrive un modello che non esiste più | Scrivere prima le voci contestate, mantenerlo in continuo |
| Un solo responsabile per tutto | «Il glossario è dell'analista» | Le dispute escalano invece di risolversi | Un responsabile per termine |
| Nessuna tracciabilità verso lo schema | Glossario e modello evolvono separatamente | Deriva, e nessuno se ne accorge | Controllo bidirezionale a ogni revisione |
Riepilogo
- Un glossario è l'elenco controllato dei termini del progetto, ciascuno con un'unica definizione concordata, i sinonimi, le esclusioni, la fonte e il posto che occupa nei requisiti e nello schema.
- Una base di dati non può essere più precisa delle parole usate per descriverla. Un difetto di vocabolario non si risolve disegnando meglio.
- Una voce ha nove campi utili; i due che prevengono più errori sono «Non» (che cosa il termine esclude) e «Fonte» (da dove viene la definizione).
- Il glossario copre più delle entità: attributi, valori di stato, ruoli, eventi, misure, regole e documenti.
- Tre difetti, tre risposte: i sinonimi si risolvono scegliendo; le omonimie dividendo; i termini vaghi quantificando o escalando.
- I termini si trovano nei requisiti, nelle interviste, nei documenti legacy e nello schema stesso.
- Il controllo bidirezionale tiene allineati glossario e schema: ogni termine che descrive dati compare nel modello, ogni elemento del modello ha una voce.
- Il termine canonico si sceglie per precisione, poi uso del dominio, poi assenza di collisione, poi brevità.
- Scrivete prima le voci contestate; un glossario che inizia dalle parole facili non verrà mai consultato.
- Con più lingue, il glossario contiene il concetto e i file di lingua contengono le etichette.
Domande di verifica
1. I requisiti usano «socio attivo» undici volte. Cosa fate?
Show the solution
Primo, riconoscete il difetto: attivo è un termine vago, e sta facendo un lavoro strutturale — undici usi significano che è portante. Secondo, scoprite che cosa esclude: un socio attivo non è un socio che non ha mai preso in prestito, non è un socio il cui abbonamento è scaduto, non è un socio sospeso per libri in ritardo. Ogni esclusione candidata è una regola diversa.
Terzo, quantificate. Risposte tipiche: «ha un abbonamento la cui data di fine è nel futuro e non ha multe non pagate sopra i 20 euro» — che è una regola aziendale, non una definizione, e va registrata come tale, con i suoi numeri confermati dal responsabile del termine.
Quarto, decidete dove vive lo stato. Se attivo è calcolato dalle date di abbonamento e dalle multe, è un attributo derivato e non va memorizzato. Se può essere impostato manualmente da un bibliotecario (una sospensione decisa da una persona), è memorizzato ed è un attributo con una storia propria — il che di solito significa un'entità che registra le sospensioni, non un booleano.
L'errore da evitare è accettare «attivo» e scrivere is_attivo BOOLEAN. Quella colonna sarà sbagliata entro un mese, perché nessuno ha concordato che cosa significa e ogni percorso di aggiornamento la interpreterà diversamente.
2. Perché una voce di glossario senza campo «Non» è pericolosa, anche quando la definizione sembra chiara?
Show the solution
Perché le definizioni descrivono il centro di un concetto, mentre i disaccordi avvengono ai bordi.
«Il prestito è il trasferimento di una copia a un socio» è chiaro sul centro: un socio esce con un libro. Non dice nulla sui rinnovi, su una copia trasferita tra sedi mentre è in prestito, su un prestito annullato lo stesso giorno, o su un socio che porta via una copia senza registrarla. Ognuno di questi è un bordo, e ognuno ha almeno due interpretazioni difendibili.
La conseguenza non è un documento scadente: è uno schema scadente. Senza un'esclusione, l'implementatore decide i casi di bordo, e le decisioni dell'implementatore sono invisibili: compaiono come un NULL qui, una riga in più là, un valore di stato che nessuno ha documentato. Quando il bibliotecario se ne accorge, i dati esistono già e il rimedio è una migrazione.
Il campo «Non» costa poco — una frase — e converte una decisione invisibile in una decisione revisionabile.
3. Un glossario ha una voce per Fattura ma lo schema non ha un'entità Fattura. Quali sono le due possibili spiegazioni, e come decidete?
Show the solution
O il modello è incompleto, oppure il termine è fuori perimetro. Entrambe sono legittime; a distinguerle sono i requisiti, non lo schema.
Modello incompleto: un requisito dice che le fatture vanno emesse, e il modello non ha un'entità per esse. Il glossario ha colto una lacuna — è il glossario che fa esattamente il suo lavoro, ed è il più prezioso dei due esiti.
Fuori perimetro: l'organizzazione emette fatture, ma da un altro sistema, e questa base di dati deve solo riferire il numero di fattura come attributo di un pagamento. Allora la voce di glossario deve dirlo esplicitamente: «Fattura — emessa dal sistema contabile; questa base di dati ne conserva solo il numero di riferimento». Quella frase previene due errori futuri: qualcuno che costruisce un'entità Fattura che duplica il sistema contabile, e qualcuno che si chiede perché un'entità nominata nel glossario non esista.
Il modo per decidere è risalire dal termine a un identificativo di requisito. Se un requisito ne ha bisogno e il modello manca, il modello è sbagliato. Se nessun requisito ne ha bisogno, la voce di glossario ha bisogno della frase di perimetro — e la tabella di perimetro dell'analisi del dominio ha bisogno di una riga.
Esercizio
Il vocabolario contestato di un ateneo
Le frasi seguenti provengono da cinque interviste diverse sullo stesso sistema informativo studenti. Individuate i difetti di vocabolario, poi scrivete cinque voci di glossario che li risolvano.
Segreteria: «Ogni studente si iscrive a un corso e riceve un voto alla fine.» Docente: «Quest'anno tengo due corsi, ciascuno con circa ottanta studenti.» Amministrativa: «Un corso si tiene ogni anno, ma il percorso di studi cambia ogni tre anni.» Studente: «L'anno scorso ho bocciato il corso e adesso lo sto ripetendo.» Responsabile IT: «Il vecchio sistema ha un
codice_corsoriusato ogni anno, ed è per questo che i report storici sono sbagliati.»
Soluzione commentata
I difetti
| Frase | Difetto | Dettaglio |
|---|---|---|
| Segreteria: «si iscrive a un corso» | Omonimia | Corso significa la voce di catalogo (l'insegnamento, con codice e programma) |
| Docente: «tengo due corsi» | Omonimia | Corso significa l'edizione di questo semestre, con un docente e un orario |
| Amministrativa: «un corso si tiene ogni anno» | Omonimia confermata | La voce di catalogo ricorre come edizione ogni anno |
| Studente: «ho bocciato il corso» | Omonimia confermata | La bocciatura si aggancia all'edizione, non alla voce di catalogo |
Responsabile IT: «codice_corso riusato ogni anno» |
Sintomo dell'omonimia | La chiave identifica la voce di catalogo, quindi due anni di edizioni collidono — i report storici sono sbagliati perché l'identificativo non è univoco per edizione |
Quindi non c'è un concetto ma due dietro corso, e la chiave legacy dimostra che il modello è sbagliato da anni.
Altri due difetti:
- Studente è una lieve omonimia: una persona registrata nel sistema, oppure una persona con un'iscrizione attiva in un dato anno. «Ottanta studenti» conta iscrizioni, non persone.
- Voto è un termine vago: un trentesimo? un superato/non superato? l'esito dell'anno intero? Nel sistema italiano sono tre cose diverse.
Cinque voci di glossario
| Termine | Definizione | Non | Sinonimi evitati | Schema |
|---|---|---|---|---|
| Corso | La voce di catalogo di un insegnamento: un codice, un titolo, un programma e un valore in crediti, stabile nel tempo | Non un'edizione; non un gruppo classe | Insegnamento, modulo, materia | Corso |
| Edizione del corso | L'erogazione di un corso in un anno accademico, con un proprio docente, orario e studenti iscritti | Non la voce di catalogo; non una singola lezione | Corso (ambiguo), erogazione, annualità | EdizioneCorso |
| Iscrizione | Il legame tra uno studente e un'edizione del corso, con uno stato e un esito | Non una registrazione al sistema; non un pagamento | Registrazione, immatricolazione | Iscrizione |
| Voto | Il punteggio numerico assegnato per una singola iscrizione, su scala 0–30, registrato con data e commissione | Non un esito superato/non superato; non il voto di laurea | Punteggio, valutazione | Iscrizione.voto |
| Studente | Una persona registrata nel sistema che può essere iscritta a zero o più edizioni di corso | Non un'iscrizione; non una persona già laureata | Alunno, iscritto | Studente |
Perché queste cinque e non altre
Corso ed edizione del corso sono la separazione tipo/occorrenza della lezione sulle entità, raggiunta attraverso l'analisi del vocabolario invece che con la diagnostica a due domande. Entrambe le strade portano nello stesso posto, il che è rassicurante: vocabolario e modello sono due viste di una sola realtà.
Iscrizione è un'entità invece di un semplice legame perché porta uno stato, un esito e un voto, e perché la frase dello studente — «ho bocciato e sto ripetendo» — è un fatto su un'iscrizione, non su una persona.
Voto resta un attributo di Iscrizione a questo stadio. Diventa un'entità nel momento in cui l'ateneo ha bisogno degli appelli d'esame («bocciato due volte, superato alla terza»), che è un requisito molto comune e che il glossario rivelerebbe come termine mancante: appello d'esame non compare in nessuna delle cinque interviste.
Studente è definito in modo da escludere l'iscrizione di proposito. Senza quell'esclusione, «ottanta studenti» e «ottanta iscrizioni» sono la stessa frase, e un report sulle dimensioni delle classi sarà sbagliato ogni volta che uno studente ripete un corso.
La lezione che il responsabile IT ha regalato
Il codice_corso riusato non è un problema di denominazione: è la prova che lo schema ha modellato un concetto dove il dominio ne ha due. Un glossario costruito all'inizio del progetto legacy l'avrebbe colto, perché la voce corso avrebbe dovuto dichiarare quale dei due significati portava — e la risposta sarebbe stata «entrambi», cioè il difetto di omonimia detto ad alta voce.
Dove andare adesso
- Come i termini diventano entità: L'individuazione delle entità candidate.
- Come i termini diventano attributi e associazioni: L'individuazione di attributi e associazioni.
- Da dove vengono i termini: L'analisi del dominio applicativo.
- Un diagramma svolto il cui vocabolario è definito per intero: Studenti e corsi.