Vai al contenuto
code-to-code

Apro l'indice…

↑ ↓ per scegliere, Invio per aprire, Esc per chiudere

Il progetto2. Le entitàp. 40

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:

  1. Prevedi: leggi il canvas e, prima di aprire la risposta, prova tu: scrivi su un foglio quali sono le entità.
  2. In italiano: cosa si decide, a parole.
  3. Passo per passo: la prova delle quattro domande, nome per nome.
  4. 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 password
Prevedi 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 nome1 · Serve?2 · Tante?3 · Distinte?4 · Cose sue?Il verdetto
sociosìsìsì (ha un account)sì (nome, email…)entità
istruttoresìsìsì (ha un account)sìentità
corsosìsìsìsì (livello, giorno, posti)entità
iscrizionesìsìsìsì (chi, quale corso, quando, se c'era)entità
livellosìno (principiante, intermedio, avanzato)valore: un CHECK
postisìsìno (non c'è «il posto 3» da ritrovare)attributo del corso
presenzasìsìnoattributo dell'iscrizione: c'era o no
giorno e orasìsìsìnoattributo del corso
passwordsìsìnoattributo 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 noleggi

La 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 nome1 · Serve?2 · Tante?3 · Distinte?4 · Cose sue?Il verdetto
monopattinosìsìsì (ognuno ha il suo codice sul manubrio)sìentità
clientesìsìsì (ha un account)sìentità
noleggiosìsìsìsì (chi, quale monopattino, quando parte, quando torna)entità (un evento)
batteriasìsìno: l'app non ne ritrova una, guarda la carica del monopattinoattributo del monopattino
tiposìno: standard o cargo, due parole decise dal noleggiovalore: 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.

DomandaRispostaCosa vuol dire
Un socio, quante lezioni?moltela chiave non può stare in soci
Una lezione, quanti soci?moltila chiave non può stare in lezioni
Allora?molti a moltiuna 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.

PassoDecisione
Le entitàattori, spettacoli
La relazionemolti a molti
La tabella ponteparti, con attore_id e spettacolo_id
I dati del pontepersonaggio: sta nella parte, non nell'attore né nello spettacolo
La chiave primariala coppia (attore_id, spettacolo_id): una parte per attore e spettacolo

E in SQL, tre tabelle:

SQL
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:

SQL
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 volontari
Prevedi 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 domandePrima versioneCon la regola «chi ha riportato un gatto non ne adotta un altro»
1 · Serve?sì: serve nome e telefonosì
2 · Tante?sìsì
3 · Distinte?no: chi adotta non torna, l'app non lo riconoscesì: l'app deve ritrovarlo, e dire «è già venuto, ha riportato Briciola»
4 · Cose sue?sì (nome, telefono, i gatti riportati)
Il verdettoattributo: due colonne di adozionientità: 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.