Vai al contenuto
code-to-code

Apro l'indice…

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

Il database nell'API5. La sessionep. 122

L'archivio del commissario

I casi della Linea Menta, salvati davvero

  • 90–120 minuti di lavoro

Milano, un lunedì mattina di ottobre. Ufficio del commissario, Piazza Query.

Il commissario Mapelli tiene i casi della Linea Menta in una scatola da scarpe. Cartoncini, uno per caso: un numero di fascicolo, il titolo, la stazione, l'anno. Sotto i casi aperti, gli indizi, ricopiati a mano.

Un caso è ancora aperto, e fa rabbia: Le monete di Largo Lista. La cassetta della biglietteria automatica, ogni lunedì mattina, è più leggera. Qualcuno, di notte, arriva alla macchinetta. Gli indizi sono badge visti lì vicino, nelle notti tra la domenica e il lunedì.

Nadia Russo, la guardia giurata di Ponte Ciclo, una sera ha ricopiato tutto in un database: due tabelle, casi e indizi. Ha cominciato anche un'API per leggerle, con il SQL a mano, come negli altri capitoli. Poi si è fermata.

«Finiscila tu», dice Mapelli, e spinge la scatola verso di voi. «Ma con la sessione. E con calma: i cartoncini li ha ricopiati Nadia, e Nadia non è infallibile.»

Gli esercizi da scaricare

Una cartella con i file da completare e i test già pronti. Come si usa: la guida in cinque passi.

db-sessione.zip35 KB

Lo zip è lo stesso della palestra: la storia è nella cartella storia/, e ha il suo README.md.

La domanda

Mapelli vuole sapere una cosa sola: chi c'era vicino alla macchinetta tutte e quattro le notti? Quattro lunedì, quattro notti, un badge che compare in tutte.

Di quel badge, poi, ti dirà chi è la tabella personale della Linea Menta (la stessa della palestra).

I file

FileCosa c'èSi tocca?
archivio.pyL'API dell'archivio, sei rotte, una per livelloSì, solo questo
modelli_archivio.pyLe due tabelle viste da Python: CasoDB e IndizioDBNo, si legge
database.pyLo stesso di palestra/No
archivio.sqlI fascicoli veri: vanno nel TUO databaseNo
archivio_prova.sqlFascicoli di prova: li usano i test, con altri casi e altri badgeNo
test_archivio.pyI testNo
verifica.pyIl commissario controlla la tua rispostaNo

Una volta sola

Dalla cartella dello zip, con il venv acceso, dopo i comandi del README.md principale:

Terminale
psql -d db_sessione -f storia/archivio.sql

Per vedere le due tabelle:

Terminale
psql -d db_sessione -c "SELECT * FROM casi"

Se vuoi ricominciare da capo, quel comando rimette gli indizi com'erano all'inizio. Tocca solo casi e indizi: le tabelle della Linea Menta restano come sono.

Come si gioca

  1. In archivio.py, al posto della riga del 501, scrivi la rotta del livello.
  2. pytest storia -v -k livello_1 finché è verde. Poi livello_2, e così via.
  3. fastapi dev storia/archivio.py, poi su http://127.0.0.1:8000/docs prova la rotta sul TUO database, con i fascicoli veri.

I test usano i fascicoli di prova: non ti dicono niente del caso. Per conoscere il caso, guarda i dati veri.

I sei livelli

Una cosa nuova per livello.

LivelloCosa faiCosa c'è di nuovo
1GET /casi: tutti i fascicoli, in ordine di fascicolo. Sopra la rotta c'è la versione con psycopg di Nadiaselect, order_by, scalars
2GET /casi/{fascicolo}: un fascicolo, dal suo numero (F-25-04). Il numero non è l'idwhere e db.scalar
3GET /casi/{fascicolo}/indizi: gli indizi di un caso, dal più vecchioun where sul caso, due order_by
4POST /casi/{fascicolo}/indizi: Mapelli ti detta un indizio appena arrivatoadd, commit, refresh
5PUT /indizi/{indizio_id}: un indizio ricopiato male, da correggerecambiare un attributo, commit
6DELETE /indizi/{indizio_id}: un indizio ricopiato due volte, da toglieredb.delete, commit

Il caso su cui lavori è F-25-04. I livelli 1, 2 e 3 servono a leggere: con il 3 vedi gli indizi del caso aperto. I livelli 4, 5 e 6 sono i ritocchi: l'archivio si corregge con la tua API, non a mano da psql.

Cosa detta il commissario

  • Livello 4. Un indizio nuovo, arrivato questa mattina: nella notte del 27 ottobre 2025, qualcuno con il badge B-12. Nota: «Visto alle 2, usciva dal locale tecnico».
  • Livello 5. «Il cartoncino del 13 ottobre l'avevo scritto io: il badge era B-12, non B-11. Nadia l'ha ricopiato male.» Trova quell'indizio e correggilo: data e nota restano, cambia il badge.
  • Livello 6. «Un cartoncino del 20 ottobre è stato ricopiato due volte, identico. Ne basta uno.» Togli quello di troppo.

Il finale

Quando hai fatto i livelli che servono, guarda gli indizi del caso F-25-04: un badge compare in tutte e quattro le notti. Di chi è?

Terminale
python storia/verifica.py "Nome Cognome"

Se è sbagliata, il commissario ti dà un consiglio. Se è giusta, ti dice «Pista trovata».