Le entità, esercizi spiegati
Cinque esempi, dal canvas alle cose
- 25 minuti di lettura
Cinque esempi, uno per ogni idea della teoria. Ognuno parte da un pezzo di canvas, come quello che scriverai per il tuo progetto. Lo stesso ritmo di sempre:
- Prevedi: leggi il canvas e, prima di aprire la risposta, prova tu: scrivi su un foglio quali sono le entità.
- In italiano: cosa si decide, a parole.
- Passo per passo: la prova delle quattro domande, nome per nome.
- Cosa portiamo a casa: la cosa da ricordare.
Le quattro domande, per comodità: 1 serve all'app? 2 ce ne sono tante? 3 si distinguono una dall'altra? 4 hanno cose loro da sapere? Ti fermi al primo «no».
A · Trovare le entità: la palestra di arrampicata
Una palestra di arrampicata ha un'app, Presa, per iscriversi ai corsi. Ecco tre riquadri del suo canvas:
4 · Le funzioni
1. vedo i corsi della settimana, per livello (il socio)
2. mi iscrivo a un corso (il socio)
3. segno chi si è presentato alla lezione (l'istruttore)
5 · Le schermate
i corsi della settimana (con il filtro per livello) · la scheda del corso ·
le mie iscrizioni · l'elenco dei presenti (istruttore) · login
7 · Le azioni
vedo i corsi: leggo i corsi in programma, con i posti liberi
mi iscrivo: scrivo un'iscrizione, se il corso ha ancora posti
segno le presenze: leggo gli iscritti, scrivo chi c'era
login: leggo un socio o un istruttore, controllo la passwordPrevedi Scrivi su un foglio cosa ti aspetti, poi apri.
Prima di aprire, prova tu: sottolinea i nomi nei tre riquadri e fai la prova a ognuno. Quante entità trovi? Quali nomi restano fuori?
Quattro entità: soci, istruttori, corsi, iscrizioni. Restano fuori il livello (un valore), i posti, il giorno e l'ora, la presenza e la password (attributi).
Sono quattro: da 3 a 6, giusto.
In italiano. Sottolineo i nomi: socio, istruttore, corso, livello, posti, iscrizione, presenza, password, giorno e ora del corso. Per ognuno chiedo: serve? tante? distinte? cose sue?
Passo per passo.
| Il nome | 1 · Serve? | 2 · Tante? | 3 · Distinte? | 4 · Cose sue? | Il verdetto |
|---|---|---|---|---|---|
| socio | sì | sì | sì (ha un account) | sì (nome, email…) | entità |
| istruttore | sì | sì | sì (ha un account) | sì | entità |
| corso | sì | sì | sì | sì (livello, giorno, posti) | entità |
| iscrizione | sì | sì | sì | sì (chi, quale corso, quando, se c'era) | entità |
| livello | sì | no (principiante, intermedio, avanzato) | valore: un CHECK | ||
| posti | sì | sì | no (non c'è «il posto 3» da ritrovare) | attributo del corso | |
| presenza | sì | sì | no | attributo dell'iscrizione: c'era o no | |
| giorno e ora | sì | sì | sì | no | attributo del corso |
| password | sì | sì | no | attributo del socio e dell'istruttore |
L'iscrizione è la più facile da perdere: nel riquadro 4 c'è solo il verbo «mi iscrivo», ma la schermata 5 dice «le mie iscrizioni», e l'azione 7 dice «scrivo un'iscrizione». Sono tre indizi per la stessa cosa. È un evento: ha un quando e un chi.
Cosa portiamo a casa. Sottolinea i nomi in tutti e tre i riquadri: una cosa che nel riquadro 4 è nascosta in un verbo, nel 5 o nel 7 spesso compare per nome.
B · Un nome che sembra un'entità: il noleggio dei monopattini
Un noleggio di monopattini elettrici ha un'app per vedere quali sono liberi. Dal canvas:
4 · Le funzioni
1. vedo i monopattini liberi vicino a me, con la batteria che hanno (il cliente)
2. prendo un monopattino e lo riporto (il cliente)
3. segno che un monopattino è guasto (il tecnico)
6 · I dati (bozza)
i monopattini · la batteria · il tipo (standard o cargo) · i clienti · i noleggiLa bozza ha cinque nomi, e la batteria sembra proprio una cosa: la puoi toccare, la puoi cambiare.
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
Prima di aprire, prova tu: fai la prova a «la batteria» e a «il tipo». Sono entità?
Nessuno dei due. La batteria è un attributo del monopattino (la carica che ha), il tipo è un valore di una lista fissa. Le entità sono tre: monopattini, clienti, noleggi.
In italiano. Faccio la prova ai due nomi che mi lasciano il dubbio. Per la batteria, la domanda importante è la 3: l'app dice mai «la batteria numero 12»? No: dice «questo monopattino ha il 60%». Il tipo, invece, sono due parole.
Passo per passo.
| Il nome | 1 · Serve? | 2 · Tante? | 3 · Distinte? | 4 · Cose sue? | Il verdetto |
|---|---|---|---|---|---|
| monopattino | sì | sì | sì (ognuno ha il suo codice sul manubrio) | sì | entità |
| cliente | sì | sì | sì (ha un account) | sì | entità |
| noleggio | sì | sì | sì | sì (chi, quale monopattino, quando parte, quando torna) | entità (un evento) |
| batteria | sì | sì | no: l'app non ne ritrova una, guarda la carica del monopattino | attributo del monopattino | |
| tipo | sì | no: standard o cargo, due parole decise dal noleggio | valore: un CHECK |
Il guasto del riquadro 4 non compare nella bozza: è un attributo (il monopattino è guasto o no), non una cosa.
Cosa portiamo a casa. Una cosa che esiste nel mondo non è per forza un'entità. Conta cosa ne fa l'app: finché nessuno dice «la batteria numero 12», la batteria è un numero dentro il monopattino.
C · L'evento nascosto: le lezioni di nuoto
Una piscina ha un'app per prenotare un posto alle lezioni. La bozza del riquadro 6 e l'azione principale:
6 · I dati (bozza)
i soci · le lezioni · gli istruttori
7 · Le azioni
prenoto: leggo la lezione, scrivo che il socio viene
annullo: scrivo che il socio non viene piùPrevedi Scrivi su un foglio cosa ti aspetti, poi apri.
Prima di aprire, prova tu: l'azione «prenoto» scrive che Giulia viene alla lezione del martedì. In quale delle tre tabelle della bozza finisce questa informazione? Se non ce n'è una giusta, cosa manca?
In nessuna. Manca una quarta entità: le prenotazioni.
In italiano. Provo a mettere la prenotazione dove c'è già posto.
- Dentro
soci, in una colonna «lezioni a cui viene»? Una casella dovrebbe contenere una lista, e abbiamo detto che una casella contiene un valore solo. - Dentro
lezioni, in una colonna «chi viene»? Lo stesso problema, a rovescio.
Allora chiedo le due domande delle relazioni: un socio, a quante lezioni viene? Molte. Una lezione, quanti soci? Molti. È un molti a molti: serve una terza tabella con una riga per ogni coppia socio-lezione.
Passo per passo.
| Domanda | Risposta | Cosa vuol dire |
|---|---|---|
| Un socio, quante lezioni? | molte | la chiave non può stare in soci |
| Una lezione, quanti soci? | molti | la chiave non può stare in lezioni |
| Allora? | molti a molti | una tabella in mezzo: la prenotazione |
| La prenotazione ha cose sue? | sì: quando l'ha fatta il socio, se l'ha annullata | è un'entità, non solo un ponte |
Due strade, la stessa tabella. Puoi dire «molti a molti, quindi un ponte», oppure «la prenotazione è un evento, quindi un'entità, e ha due relazioni uno a molti». Nel progetto scegli la seconda: darle un nome vero la costringe ad avere dati veri. Ecco le quattro entità, con le frecce:
┌──────┐ socio_id ┌──────────────┐ lezione_id ┌─────────┐ istruttore_id ┌────────────┐
│ soci │◀─────────────│ prenotazioni │───────────────▶│ lezioni │──────────────────▶│ istruttori │
└──────┘ └──────────────┘ └─────────┘ └────────────┘Ogni freccia parte dalla tabella del molti (una prenotazione ha un socio e una lezione; una lezione ha un istruttore) e arriva a quella dell'uno.
Cosa portiamo a casa. Rileggi le azioni: se «scrivo» qualcosa e non sai in quale tabella metterlo, ti manca un'entità, e quasi sempre è un evento.
D · Il molti a molti con i suoi dati: il teatro amatoriale
Una compagnia teatrale amatoriale ha un'app per sapere chi recita in quale spettacolo. Le entità sono attori e spettacoli, e il canvas dice: «scrivo la parte di un attore in uno spettacolo, con il nome del personaggio».
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
Prima di aprire, prova tu: che relazione c'è tra attori e spettacoli? Dove va la chiave esterna? E dove finisce il nome del personaggio?
Molti a molti: un attore recita in molti spettacoli, uno spettacolo ha molti attori. La chiave non sta in nessuna delle due: serve una tabella ponte, parti. Il personaggio sta nel ponte, perché dipende dalla coppia: «La capostazione» è il personaggio di Irene in quello spettacolo.
In italiano. Faccio le due domande: un attore, quanti spettacoli? Molti. Uno spettacolo, quanti attori? Molti. Allora la parte (la riga del ponte) contiene i due numeri, uno per tabella, più il personaggio. E un attore ha una parte sola in ogni spettacolo: la coppia non si ripete, quindi la chiave primaria può essere la coppia stessa (il capitolo Disegnare un database spiega quando sì e quando no).
Passo per passo.
| Passo | Decisione |
|---|---|
| Le entità | attori, spettacoli |
| La relazione | molti a molti |
| La tabella ponte | parti, con attore_id e spettacolo_id |
| I dati del ponte | personaggio: sta nella parte, non nell'attore né nello spettacolo |
| La chiave primaria | la coppia (attore_id, spettacolo_id): una parte per attore e spettacolo |
E in SQL, tre tabelle:
CREATE TABLE attori (
id SERIAL PRIMARY KEY,
nome TEXT NOT NULL
);
CREATE TABLE spettacoli (
id SERIAL PRIMARY KEY,
titolo TEXT NOT NULL,
debutto DATE NOT NULL
);
CREATE TABLE parti (
attore_id INTEGER NOT NULL REFERENCES attori(id),
spettacolo_id INTEGER NOT NULL REFERENCES spettacoli(id),
personaggio TEXT NOT NULL,
PRIMARY KEY (attore_id, spettacolo_id)
);Con Irene (attore 1) già in una parte nello spettacolo 1, provare a darle una seconda parte nello stesso spettacolo:
INSERT INTO parti VALUES (1, 1, 'La bigliettaia');ERROR: duplicate key value violates unique constraint "parti_pkey"
DETAIL: Key (attore_id, spettacolo_id)=(1, 1) already exists.Il database rifiuta il doppione da solo. Se una compagnia volesse il doppio ruolo, la coppia si potrebbe ripetere e il ponte avrebbe un id suo.
Cosa portiamo a casa. Il ponte non è solo due chiavi: i dati che appartengono alla coppia (il personaggio) vivono lì. Un dato che dipende da una coppia non sta in nessuna delle due tabelle.
E · La persona senza account: il gattile
Un gattile di quartiere ha un'app per far vedere i gatti da adottare. Ecco il canvas, nella prima versione:
4 · Le funzioni
1. i volontari registrano un gatto appena arrivato
2. i visitatori vedono i gatti da adottare
3. il volontario registra un'adozione: chi adotta (nome e telefono) e quando
8 · Chi può fare cosa
vedere i gatti: tutti, senza login
registrare gatti e adozioni: solo i volontariPrevedi Scrivi su un foglio cosa ti aspetti, poi apri.
Prima di aprire, prova tu: «chi adotta» è un'entità? E se nel riquadro 8 si aggiungesse la riga «chi ha riportato indietro un gatto non ne può adottare un altro»? La risposta cambia?
Nella prima versione no: sono il nome e il telefono dentro l'adozione. Con la riga in più sì: diventa un'entità, adottanti.
In italiano. Nella prima versione le entità sono volontari (hanno un account), gatti e adozioni (un evento). Chi adotta lo incontro una volta sola: non ha un account, nessuna schermata gli dà un posto, e l'app non ha motivo di ritrovarlo.
Passo per passo. Faccio la prova a «chi adotta» nelle due versioni:
| Le domande | Prima versione | Con la regola «chi ha riportato un gatto non ne adotta un altro» |
|---|---|---|
| 1 · Serve? | sì: serve nome e telefono | sì |
| 2 · Tante? | sì | sì |
| 3 · Distinte? | no: chi adotta non torna, l'app non lo riconosce | sì: l'app deve ritrovarlo, e dire «è già venuto, ha riportato Briciola» |
| 4 · Cose sue? | sì (nome, telefono, i gatti riportati) | |
| Il verdetto | attributo: due colonne di adozioni | entità: una tabella adottanti, e adozioni.adottante_id |
Nel secondo caso la regola cambia anche chi è: serve riconoscere una persona che non ha un account. Si fa con quello che l'app ha, per esempio il telefono, e va deciso con i dati (nel capitolo Gli attributi).
Cosa portiamo a casa. La stessa persona è un'entità o un attributo a seconda di cosa l'app deve fare: per saperlo, rileggi il riquadro 8 e chiediti «l'app deve riconoscerla quando torna?».
Cinque esempi, un metodo solo: sottolinea i nomi, fai la prova, rileggi le azioni, fai le due domande per le relazioni. Nella palestra lo fai tu, con piccole funzioni Python che applicano le stesse regole.