L'analisi del dominio applicativo
Prima di decidere quali entità esistono bisogna decidere di quale parte del mondo la base di dati si occupa. Questa lezione traccia il confine, mappa i concetti che stanno dentro e mostra perché ogni decisione di confine diventa una decisione sullo schema.
Base
Obiettivi di apprendimento
- Definire l'universo del discorso di una base di dati e giustificarne il confine
- Distinguere quattro tipi di concetto di dominio: cose, eventi, ruoli e classificazioni
- Riconoscere sinonimi, omonimi e termini vaghi nel vocabolario del dominio
- Registrare le decisioni di perimetro e indicarne la conseguenza sullo schema
- Descrivere come il dominio cambia nel tempo e quali cambiamenti la base di dati deve ricordare
Prerequisiti
- La raccolta dei requisiti
- Requisiti funzionali e non funzionali
Introduzione
Fra il documento dei requisiti e il primo diagramma E-R c'è un passaggio che nessuna notazione può compiere al posto tuo: decidere di che cosa si occupa la base di dati. Non "quali tabelle", non "quali entità" — quelle sono domande successive. Prima: quale porzione del mondo questo sistema deve ricordare?
Quella porzione ha un nome nella letteratura. È l'universo del discorso, e tracciarne il confine è l'atto più carico di conseguenze dell'intero progetto.
Universo del discorso
L'universo del discorso (o dominio applicativo) è la parte del mondo reale che la base di dati deve rappresentare: gli oggetti, gli eventi, le persone, le regole e le relazioni sui quali l'organizzazione ha bisogno di memorizzare fatti. Tutto ciò che sta fuori dal confine, per decisione, non è affare della base di dati.
La definizione suona accademica; la pratica è brutale, perché il confine non è dato: è scelto, e ogni scelta ha un costo.
Una base di dati bibliotecaria che include i fornitori deve modellare ordini di acquisto, prezzi e consegne. Una che li esclude deve comunque rispondere a "da dove viene questo libro?", e allora l'informazione migra in un campo di testo libero — più economico ora, inutilizzabile dopo. Nessuna delle due decisioni è sbagliata. Sbagliato è non prenderle e scoprire il confine per caso, una colonna mancante alla volta.
I quattro tipi di concetto
L'analisi del dominio diventa molto più semplice quando si nota che i concetti di dominio non sono tutti dello stesso tipo. In quasi ogni applicazione ne compaiono quattro, e si comportano in modo diverso nel modello concettuale.
| Tipo | Che cos'è | Esempi in biblioteca | Dove finisce di solito |
|---|---|---|---|
| Cosa | Qualcosa con un'identità che persiste | Libro, copia, socio, sede, scaffale | Un'entità |
| Evento | Qualcosa che accade in un momento e viene ricordato | Prestito, restituzione, prenotazione, pagamento, mora | Un'entità (un evento è una cosa con una data) |
| Ruolo | Il modo in cui una cosa partecipa a un evento | Prestatario, prestante, autore, supervisore | Un'associazione, o una partecipazione con un nome di ruolo |
| Classificazione | Una categoria usata per raggruppare cose | Genere, tipo di tessera, stato del prestito | Un'entità, un attributo o una generalizzazione |
La distinzione conta perché i principianti tendono a modellare tutto come cosa, producendo entità come PRESTATARIO che duplicano SOCIO, e perché tendono a modellare gli eventi come attributi, producendo una colonna data_prestito sul socio e impedendo così un secondo prestito.
Cose che sembrano attributi e non lo sono
Tre casi ricorrenti meritano un nome, perché sono la fonte della maggior parte degli errori concettuali nei progetti degli studenti.
1. L'attributo multivalore travestito. "I numeri di telefono del socio" — un socio può averne diversi. Come colonna unica diventa una stringa separata da virgole; come concetto è una relazione separata. Chiediti: possono essere più di uno, e il loro numero conta?
2. L'attributo che è in realtà un'entità. "L'autore del libro" — un autore ha un nome, una nazionalità, una data di nascita, e scrive diversi libri. Modellarlo come colonna di testo rende "trova tutti i libri di questo autore" una ricerca su stringa, che fallisce appena il nome è scritto in modo diverso.
3. La classificazione che cambia nel tempo. "La categoria del socio" — uno studente diventa personale. Se la categoria è una colonna, la storia è persa; se è un'associazione con un periodo di validità, la storia sopravvive. Chiediti: qualcuno ha bisogno di sapere qual era la categoria l'anno scorso?
Mappare il dominio
L'analisi del dominio produce una mappa dei concetti: un inventario informale dei concetti del dominio, raggruppati per tipo, con il vocabolario che l'organizzazione usa davvero. Non è un diagramma con le cardinalità; è la materia prima per costruirne uno.
Ecco la mappa della biblioteca, costruita dall'estratto dell'intervista della prima lezione più i documenti raccolti.
| Gruppo | Concetti | Note dal dominio |
|---|---|---|
| Cose fisiche | Libro (titolo), Copia (esemplare fisico), Scaffale, Sede | La bibliotecaria dice "libro" per entrambi; la distinzione è essenziale |
| Persone | Socio, Bibliotecario, Direttore, Fornitore | Un socio e un fornitore possono essere la stessa persona |
| Eventi | Prestito, Restituzione, Prenotazione, Mora, Acquisto | Ognuno ha una data e dei partecipanti |
| Ruoli | Prestatario, Prestante, Autore, Curatore | Gli autori non sono utenti del sistema |
| Classificazioni | Genere, Tipo di tessera, Stato del prestito, Lingua | Il genere è una gerarchia: narrativa → romanzo, giallo |
| Documenti | Scheda di catalogo, Tessera, Scontrino del prestito | Alcuni sono output, altri input |
| Luoghi e tempi | Orario di apertura, Durata del prestito, Scadenza della prenotazione | Regole espresse con il tempo |
Due cose sono immediatamente visibili in questa tabella, ed entrambe sono il senso di farla prima di disegnare qualsiasi cosa:
- "Libro" sono due concetti. Il titolo (una scheda di catalogo, molte copie fisiche) e la copia (un codice a barre, uno scaffale, una condizione). Uno schema con una sola entità
LIBROnon può rispondere a "abbiamo questo libro disponibile?", solo a "lo possediamo?". - "Socio" e "fornitore" possono essere la stessa persona. Se siano un'entità sola con due ruoli o due entità è una decisione di perimetro con conseguenze reali, e va presa deliberatamente.
Il problema del vocabolario
La stessa parola significa cose diverse per persone diverse, e parole diverse significano la stessa cosa. Entrambe le situazioni distruggono uno schema se non vengono risolte prima di modellare.
Sinonimi: parole diverse, un concetto
| Parola usata | Da chi | Stesso concetto? |
|---|---|---|
| "socio", "utente", "lettore", "iscritto" | Bibliotecario, direttore, sito, regolamento | Quasi certamente sì — ma "utente" può anche significare utente del sistema |
| "prestito", "noleggio" | Personale al bancone, marketing | Stesso evento, tono diverso |
| "volume", "copia", "esemplare" | Catalogo, bancone, magazzino | "Copia" ed "esemplare" sì; "volume" a volte significa il titolo |
La soluzione è un termine canonico per concetto, registrato nel glossario, con l'elenco dei sinonimi scartati. Ogni artefatto successivo usa solo il termine canonico.
Omonimi: una parola, più concetti
Questo è il caso più pericoloso, perché produce un'entità sola dove ne servono due.
| Parola | Significato 1 | Significato 2 | Conseguenza se confusi |
|---|---|---|---|
| "cliente" | Una persona che compra | Un'azienda che compra | Una tabella con colonne semivuote, o la perdita della relazione con la persona di contatto |
| "ordine" | Un ordine di un cliente | Un ordine a un fornitore | Due cicli di vita diversi in una tabella sola |
| "conto" | Un conto bancario | Il conto al ristorante | Nonsenso |
| "corso" | Un corso come programma | Un'edizione del corso in un anno | Le iscrizioni agganciate alla cosa sbagliata |
Decisioni di perimetro e loro conseguenze
Ogni decisione di perimetro è un piccolo contratto, e va scritta con la sua conseguenza. La tabella del perimetro è la pagina più utile del documento di analisi del dominio.
| # | Concetto | Nel perimetro? | Perché | Conseguenza sullo schema |
|---|---|---|---|---|
| S1 | Copie fisiche | Sì | Le domande sulla disponibilità sono il cuore del servizio | COPIA come entità; i prestiti si riferiscono a una copia, non a un titolo |
| S2 | Fornitori e acquisti | No, in questa release | L'ufficio acquisizioni ha un proprio sistema | Nessun FORNITORE; il riferimento all'acquisto diventa un campo di testo — registrato come limite noto |
| S3 | Pagamento delle more | Sì | Le more si incassano al bancone | PAGAMENTO come evento collegato a MORA |
| S4 | Prenotazione di sale | No | Servizio diverso, utenti diversi | Nulla; esplicitamente fuori perimetro nel documento |
| S5 | Storia delle letture per i consigli | Sì, anonimizzata | Richiesta dal direttore | I prestiti si conservano oltre la restituzione, con dati personali anonimizzati dopo 5 anni |
| S6 | Prestito interbibliotecario | Sì | Il regolamento lo richiede | Un PRESTITO può riferirsi a una biblioteca partner; nuova entità BIBLIOTECA_PARTNER |
Da questa tabella emergono due lezioni.
Primo, anche il "no" ha una conseguenza. Escludere i fornitori non elimina il bisogno informativo: lo sposta in un campo non strutturato. Registrare quello spostamento è ciò che rende il limite onesto, ed è anche ciò che lo rende rivisitabile: quando fra due anni l'ufficio acquisizioni verrà integrato, il documento di progetto dice già dove è finita l'informazione.
Secondo, una decisione di perimetro può riguardare la granularità, non la presenza. S5 non dice "tenere la storia o no"; dice "tenere la storia, ma anonimizzata dopo cinque anni". È la decisione che, come ha mostrato la lezione precedente, cambia la forma dello schema invece di aggiungere una funzionalità.
La dimensione temporale
Quasi ogni concetto di dominio cambia nel tempo, e la base di dati deve essere esplicita su quali cambiamenti ricorda. Non è un dettaglio del Modulo 5: è una proprietà del dominio che va descritta qui.
| Tipo di cambiamento | Esempio | Domanda di progetto |
|---|---|---|
| Il valore cambia, la storia è irrilevante | Il telefono di un socio | Solo il valore corrente — una colonna basta |
| Il valore cambia, la storia è richiesta | La condizione di una copia, il prezzo di un libro | Una relazione di storia, o un periodo di validità |
| Lo stato cambia con un ciclo di vita | Un prestito: attivo → restituito → scaduto | Un attributo di stato più le date di ogni transizione |
| La cosa finisce | La tessera scade; un socio se ne va | Politica di conservazione: tenere la riga, marcarla inattiva, o archiviarla |
| Le relazioni cambiano | Un socio cambia sede | La vecchia relazione conta? Se sì, servono le date |
Che cosa produce l'analisi
L'analisi del dominio produce quattro artefatti, tutti in prosa e tabelle — nessun diagramma con cardinalità, per ora.
- La descrizione del dominio — da due a cinque pagine di prosa su come funziona l'organizzazione: che cosa fa, chi lo fa, quali documenti esistono, quali regole valgono. Scritta per un lettore che non conosce l'organizzazione.
- La mappa dei concetti — l'inventario dei concetti per tipo, con il vocabolario dell'organizzazione.
- Il glossario — un termine canonico per concetto, con sinonimi e significati scartati. (Approfondito in una lezione dedicata.)
- La tabella del perimetro — che cosa è dentro, che cosa è fuori, perché e la conseguenza di ogni decisione.
Insieme, questi quattro artefatti rendono la fase successiva meccanica invece che creativa. Scegliere le entità resta un giudizio, ma è un giudizio su un inventario noto invece che su una pagina bianca.
Esempio svolto: dalla descrizione alla mappa dei concetti
Ecco una breve descrizione del dominio, del tipo che si scrive dopo due interviste.
La biblioteca ha tre sedi. Ogni sede ha degli scaffali, e ogni copia di un libro è collocata su un solo scaffale. Il catalogo è condiviso: un titolo è registrato una volta, con i suoi autori, l'editore, l'anno, la lingua e il genere, e la biblioteca ne possiede una o più copie. Le copie si acquistano dai fornitori, ma gli acquisti sono gestiti da un ufficio separato e non fanno parte di questo sistema. I soci sono registrati presso una sede; gli studenti pagano una quota ridotta e possono prendere in prestito per 30 giorni, il personale per 60. Un socio può prenotare un titolo quando nessuna copia è disponibile; la prenotazione viene servita dalla prima copia restituita in qualsiasi sede. Le more sono di 0,20 € per giorno di ritardo, con un tetto pari al prezzo della copia, e si pagano al bancone.
Leggila ed estrai:
| Tipo | Concetti trovati | Evidenza nel testo |
|---|---|---|
| Cosa | Sede, Scaffale, Copia, Titolo, Socio | "tre sedi", "ogni copia … su un solo scaffale" |
| Evento | Prestito, Prenotazione, Mora, Pagamento | "prestare per 30 giorni", "prenotare un titolo", "le more sono", "si pagano al bancone" |
| Ruolo | Prestatario, Autore, Editore, Fornitore | "con i suoi autori", "si acquistano dai fornitori" |
| Classificazione | Genere, Tipo di tessera, Lingua | "genere", "studenti … personale" |
| Fuori perimetro | Fornitore, Acquisto | "gli acquisti … non fanno parte di questo sistema" |
| Regola con un numero | Durata del prestito, tasso della mora, tetto | "30 giorni", "60 giorni", "0,20 €", "tetto pari al prezzo" |
Ora guarda che cosa la descrizione ha già stabilito e che cosa lascia aperto.
Stabilito dal testo: una copia sta su un solo scaffale (relazione funzionale); un titolo è condiviso fra le sedi (il catalogo è globale); una prenotazione riguarda un titolo, non una copia ("prenotare un titolo … servita dalla prima copia restituita in qualsiasi sede"); le more hanno un tasso e un tetto.
Lasciato aperto — e sono le domande da porre adesso:
- Un socio può essere registrato presso più di una sede? Il testo dice "presso una sede" — ma è una regola o un caso del sistema attuale? Se può cambiare, la registrazione diventa un'associazione con una data di inizio.
- Il tasso della mora è lo stesso per tutti i tipi di tessera? Non è detto. Se differisce, il tasso diventa un attributo della classificazione.
- Quando una copia viene trasferita fra sedi, lo scaffale viene aggiornato o il trasferimento viene ricordato? Non è detto, e decide se la collocazione è un attributo semplice o un evento.
- Che cosa succede a una prenotazione quando la tessera del socio scade? Non è detto. È una regola di business che altrimenti verrà scoperta in produzione.
Errori comuni
| Errore | Perché fa male | Che cosa fare invece |
|---|---|---|
| Partire dallo schema del database attuale | Riproduce i suoi incidenti come se fossero requisiti | Descrivere prima il dominio; confrontarsi con il vecchio schema dopo |
| Trattare "libro" come un solo concetto | Non si possono rispondere le domande sulla disponibilità | Distinguere titolo e copia fisica |
| Modellare gli eventi come attributi | Impedisce una seconda occorrenza | Chiedere se l'evento si ripete e va ricordato |
| Ignorare sinonimi e omonimi | Due entità dove ne serve una, o una dove ne servono due | Glossario con termini canonici |
| Lasciare il perimetro implicito | Il confine si sposta in silenzio durante l'implementazione | Tabella del perimetro con le conseguenze |
| Dimenticare la dimensione temporale | La storia viene sovrascritta e non ricostruibile | Chiedere, per ogni attributo: dobbiamo sapere il valore precedente? |
| Disegnare prima di inventariare | Cardinalità impegnate troppo presto | Prima la mappa dei concetti |
| Descrivere il software invece del dominio | Il modello rispecchia le schermate | Descrivere il lavoro, non l'interfaccia |
Riepilogo
- L'universo del discorso è la parte del mondo che la base di dati deve ricordare; il suo confine è scelto, e ogni scelta ha un costo.
- La prova del confine: qualcuno porrà una domanda la cui risposta richiede questo concetto?
- I concetti di dominio sono di quattro tipi — cose, eventi, ruoli e classificazioni — e confonderli produce entità duplicate o occorrenze perdute.
- Sinonimi e omonimi vanno risolti prima di modellare; un omonimo non risolto diventa una tabella che non si può correggere senza migrare ogni riga.
- Le decisioni di perimetro si registrano con le loro conseguenze, comprese quelle dell'esclusione.
- Il dominio ha una dimensione temporale: per ogni attributo che cambia, qualcuno deve decidere se i valori precedenti contano.
- L'output di questa fase è prosa, un inventario, un glossario e una tabella del perimetro — nessuna cardinalità, per ora.
Domande di verifica
Verifica la comprensione
- Che cos'è l'universo del discorso, e chi ne decide il confine?
- Perché un prestito è un'entità e non un attributo del socio?
- Fai un esempio di omonimo in un dominio che conosci e indica la conseguenza sullo schema del confondere i due significati.
- Perché escludere un concetto dal perimetro lascia comunque una traccia nello schema?
- Quale domanda va posta su ogni attributo che può cambiare nel tempo?
Mostra le risposte
- È la porzione del mondo reale che la base di dati deve rappresentare. Il confine è deciso congiuntamente dal progettista e dall'organizzazione — il progettista propone, il committente decide — e la decisione è registrata nella tabella del perimetro con le sue conseguenze.
- Perché un socio può prendere in prestito molte volte, e ogni occorrenza ha una propria data, scadenza, copia e restituzione. Come attributo potrebbe contenere solo l'ultimo prestito, perdendo la storia e impedendo prestiti contemporanei. La prova: può accadere più di una volta, e ogni occorrenza va ricordata?
- Esempi: "cliente" (persona contro azienda), "ordine" (ordine cliente contro ordine fornitore), "corso" (programma contro edizione). Conseguenza della confusione: una relazione unica che contiene due cicli di vita diversi, con metà delle colonne vuote per ciascun tipo, e interrogazioni che devono indovinare che tipo di riga stanno leggendo.
- Perché il bisogno informativo non scompare: si sposta. Escludere i fornitori lascia "da dove viene questa copia?" affidato a un campo di testo libero, che è una decisione di progetto con un limite noto, non l'assenza di una decisione.
- Dobbiamo sapere qual era il valore prima? Se sì, l'attributo non può essere una semplice colonna: serve una relazione di storia o un intervallo di validità, e questa è una differenza strutturale decisa qui, non nel Modulo 5.
Esercizio
Mappa un dominio che conosci
Considera una palestra. I soci si abbonano a dei piani, prenotano corsi e sono seguiti da istruttori. I corsi si tengono in sale a orari fissi. I soci possono sospendere l'abbonamento.
Produci:
- Una mappa dei concetti con almeno dodici concetti, raggruppati per tipo.
- Tre omonimi o sinonimi probabili nel vocabolario dell'organizzazione, con l'ambiguità spiegata.
- Una tabella del perimetro con quattro decisioni, due inclusioni e due esclusioni, ciascuna con la sua conseguenza sullo schema.
- Due domande aperte che la descrizione lascia senza risposta, e perché ciascuna cambia lo schema.
Mostra la soluzione commentata
1. Mappa dei concetti
| Tipo | Concetti |
|---|---|
| Cosa | Socio, Piano, Corso (tipo), Sessione (un corso a un orario), Sala, Istruttore, Abbonamento, Pagamento |
| Evento | Prenotazione, Presenza, Sospensione, Pagamento |
| Ruolo | Frequentante, Istruttore-della-sessione, Abbonato |
| Classificazione | Tipo di piano, Categoria del corso, Stato della prenotazione |
La distinzione critica è Corso contro Sessione: "yoga" è un tipo di corso; "yoga, martedì 18:00, sala 2, con Anna" è una sessione. Uno schema che modella solo il corso non può registrare le prenotazioni, perché le prenotazioni riguardano un orario specifico. È la stessa distinzione titolo/copia della biblioteca, con altri vestiti — ed è esattamente il motivo per cui vale la pena imparare i quattro tipi: gli schemi si ripetono.
2. Ambiguità
- "Iscritto" — una persona con abbonamento attivo, o una persona registrata nel sistema che ha smesso di pagare? Se entrambe, lo schema ha bisogno di uno stato dell'abbonamento, non di un booleano.
- "Corso" — il tipo di corso (yoga) o la sessione programmata? Se confusi, le prenotazioni si agganciano a un tipo e la sala e l'orario vanno persi.
- "Abbonamento" — il piano (mensile, annuale) o l'abbonamento specifico di un socio specifico con le sue date di inizio e fine? Se confusi, i prezzi cambiano retroattivamente per tutti.
3. Tabella del perimetro
| # | Concetto | Dentro? | Perché | Conseguenza |
|---|---|---|---|---|
| S1 | Capienza della sala | Sì | Le prenotazioni vanno rifiutate a sala piena | capienza su SALA; un controllo al momento della prenotazione |
| S2 | Stipendi degli istruttori | No | Gestiti dal commercialista | Nessun dato retributivo; limite noto registrato |
| S3 | Sospensioni dell'abbonamento | Sì | Richieste dal titolare; incidono sulle scadenze | SOSPENSIONE come evento con inizio e fine; la scadenza è calcolata, non memorizzata |
| S4 | Certificati medici | No, in questa release | Dati sensibili, processo separato | Nessuna memorizzazione; la regola "senza certificato, niente accesso" è imposta fuori dal sistema — registrata |
4. Domande aperte
- Un socio può prenotare due sessioni dello stesso corso nello stesso giorno? Se no, la relazione di prenotazione ha bisogno di un vincolo di unicità su (socio, data, corso) — un vincolo strutturale, non un messaggio di validazione.
- Che cosa accade alle prenotazioni future quando un abbonamento viene sospeso? Se vengono annullate, l'annullamento è un evento da registrare; se restano valide, la sospensione non deve incidere. Entrambe le risposte cambiano lo schema, e nessuna si può indovinare.
Perché questo esercizio conta. Nota che sia nella biblioteca sia nella palestra le distinzioni decisive sono state tipo contro occorrenza (titolo/copia, corso/sessione, piano/abbonamento) e stato nel tempo (sospensione, scadenza, ritardo). Riconoscere questi due schemi è la maggior parte dell'analisi del dominio.
Dove andare adesso
- Come i concetti di questa lezione diventano entità candidate: L'individuazione delle entità candidate.
- La disciplina del vocabolario che questa lezione richiede, per intero: Analisi dei requisiti.
- L'architettura che separa che cosa significa il dominio da come viene memorizzato: L'architettura a tre livelli ANSI/SPARC.
- Un esempio svolto completo con entità, attributi e cardinalità: Studenti e corsi.