Analisi dei requisiti

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à LIBRO non 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.

  1. 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.
  2. La mappa dei concetti — l'inventario dei concetti per tipo, con il vocabolario dell'organizzazione.
  3. Il glossario — un termine canonico per concetto, con sinonimi e significati scartati. (Approfondito in una lezione dedicata.)
  4. 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:

  1. 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.
  2. Il tasso della mora è lo stesso per tutti i tipi di tessera? Non è detto. Se differisce, il tasso diventa un attributo della classificazione.
  3. 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.
  4. 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
  • 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

Beginner

Verifica la comprensione

  1. Che cos'è l'universo del discorso, e chi ne decide il confine?
  2. Perché un prestito è un'entità e non un attributo del socio?
  3. Fai un esempio di omonimo in un dominio che conosci e indica la conseguenza sullo schema del confondere i due significati.
  4. Perché escludere un concetto dal perimetro lascia comunque una traccia nello schema?
  5. Quale domanda va posta su ogni attributo che può cambiare nel tempo?
Mostra le risposte
  1. È 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.
  2. 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?
  3. 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.
  4. 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.
  5. 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

Intermediate

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:

  1. Una mappa dei concetti con almeno dodici concetti, raggruppati per tipo.
  2. Tre omonimi o sinonimi probabili nel vocabolario dell'organizzazione, con l'ambiguità spiegata.
  3. Una tabella del perimetro con quattro decisioni, due inclusioni e due esclusioni, ciascuna con la sua conseguenza sullo schema.
  4. 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

Lezioni correlate