Progetto finale

Ora hai tutti gli strumenti per realizzare un'applicazione completa da solo (o in coppia, se il docente lo prevede). Il progetto si svolge in due modi a scelta.

• Percorso A – La biblioteca. Completi l'applicazione del corso, partendo dal kit, e aggiungi almeno due estensioni (vedi più sotto).
• Percorso B – Un tema tuo. Progetti e realizzi un'applicazione nuova, su uno dei temi proposti o su un'idea tua, approvata dal docente. È il percorso più vicino all'Esame di Stato, dove il tema è sempre nuovo.

• biblioteca-kit.zipIl punto di partenza: configurazione, connessione, funzioni, intestazione, piè di pagina, stile e database
• biblioteca.sqlIl database della biblioteca con i dati di prova

Il kit va bene anche per il percorso B: basta cambiare il nome del database in config.php, le voci del menu in header.php e i colori in stile.css.

Temi per il percorso B

Ogni tema deve avere almeno 4 tabelle, almeno un'associazione 1:N e almeno una N:M con un attributo proprio.

I passi del lavoro

Il lavoro segue l'ordine del corso. Non saltare la progettazione: un database sbagliato si paga in ogni pagina.

1. Analisi. Scrivi a parole, in mezza pagina, cosa fa l'applicazione, chi la usa (visitatore, utente registrato, amministratore) e quali operazioni può fare ciascuno. Elenca le ipotesi aggiuntive (lezione 2).
2. Modello E/R con entità, attributi, identificatori e cardinalità. Disegnalo con draw.io ed esportalo come immagine.
3. Schema logico, verificando la terza forma normale (lezione 3).
4. Database. Scrivi il file database.sql a mano, come biblioteca.sql: DROP DATABASE IF EXISTS, CREATE DATABASE, le tabelle con tutti i vincoli e dati di prova realistici (almeno 8–10 righe per tabella principale). Deve importarsi senza errori su un XAMPP pulito.
5. Query. Prima di scrivere il PHP, prova in phpMyAdmin tutte le query che ti serviranno e salvale in query.sql, ciascuna con un commento che dice a cosa serve.
6. Pagine pubbliche: elenco con ricerca, filtri e paginazione; scheda di dettaglio; una pagina di statistiche.
7. Area riservata: login e logout, inserimento, modifica e cancellazione (CRUD) di almeno due tabelle, gestione dell'associazione N:M.
8. Verifica con la lista di controllo qui sotto.
9. Documentazione: un file LEGGIMI.md o un PDF (vedi "Cosa consegnare").

Requisiti minimi

• ☐ Il database si importa senza errori e ha chiavi primarie, chiavi esterne con regole ON DELETE motivate, NOT NULL e UNIQUE dove servono.
• ☐ Almeno una query con JOIN su tre tabelle, una con GROUP BY e una con LEFT JOIN o sottoquery.
• ☐ Tutte le query con dati dell'utente sono preparate.
• ☐ Tutti i dati stampati nell'HTML passano da h().
• ☐ I dati dei form sono validati sul server, con messaggi d'errore chiari e il form ricompilato.
• ☐ Le azioni che modificano i dati usano POST, con token CSRF e Post/Redirect/Get.
• ☐ Le pagine riservate chiamano richiedi_login(); le password sono salvate con password_hash.
• ☐ Gli errori dei vincoli (duplicati, chiavi esterne) diventano messaggi comprensibili, non pagine d'errore di PHP.
• ☐ La pagina di dettaglio risponde 404 se l'id non esiste.
• ☐ Le pagine si usano bene anche sul telefono.

La prova dell'attaccante

Prima di consegnare, prova ad attaccare la tua applicazione come hai imparato nel corso:

Estensioni (percorso A: almeno due)

1. Gestione degli autori e degli studenti (CRUD completo, con la cancellazione bloccata se ci sono libri o prestiti).
2. Scheda dello studente con prestiti in corso e storico (esercizio 2 della lezione 14).
3. Prenotazioni: uno studente prenota un libro non disponibile; quando viene restituito, la prenotazione compare nella pagina dei prestiti. Serve una nuova tabella.
4. Più autori per libro: l'associazione autore–libro diventa N:M. Va modificato il database, con una tabella libri_autori, e tutte le query che usano autore_id.
5. Esportazione CSV dei prestiti, da aprire con il foglio di calcolo (header('Content-Type: text/csv') e fputcsv).
6. Copertine: caricamento di un'immagine per libro (<input type="file">, $_FILES, controllo di tipo e dimensione, move_uploaded_file).
7. Solleciti: la pagina con i prestiti in ritardo e, per ciascuno, un link mailto: con il testo del sollecito già scritto.
8. API JSON: api/libri.php restituisce il catalogo in JSON (json_encode), con la ricerca come parametro GET.

Cosa consegnare

Una cartella compressa con:

• tutti i file PHP, CSS e le immagini;
• database.sql (struttura e dati di prova);
• query.sql con le query commentate;
• la documentazione (LEGGIMI.md o PDF), con:
  1. analisi e ipotesi aggiuntive;
  2. modello E/R (immagine) e schema logico;
  3. elenco delle pagine, con una riga su cosa fa ciascuna e chi può usarla;
  4. le scelte di sicurezza (quali difese, dove, perché);
  5. le credenziali di prova (es. admin / password) e le istruzioni per installare il progetto su XAMPP.

⚠️ Nella consegna, config.php contiene le credenziali di XAMPP (root senza password), quindi va bene includerlo. In un progetto reale, invece, il file con le password vere non si consegna né si pubblica: si consegna una copia di esempio (config.esempio.php), come fa il sito di questo corso con i suoi quiz.

Griglia di valutazione

L'orale conta. Durante la presentazione il docente sceglie una pagina e ti chiede di spiegarla riga per riga, o di fare una piccola modifica sul momento ("aggiungi una colonna all'elenco", "ordina per data"). Un progetto che non sai spiegare non è il tuo progetto.

Esercizio

istruttori (id, nome, cognome, specialita)
corsi      (id, nome, giorno, ora, posti, istruttore_id*)
studenti   (id, nome, cognome, classe, email, password_hash)
iscrizioni (studente_id*, corso_id*, data_iscrizione)