Sezione Campus: layout dedicato, route protette e documentazione

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

README.md

@@ -26,7 +26,8 @@ Il sito è costruito su **Astro 7** in modalità server (SSR) con adapter **Node
 - **Contenuti taggati**: ogni testo/immagine ha un tag (es. `home.hero.title-line-1`) modificabile dal pannello o in pagina.
 - **Modifica inline**: chi ha i permessi può attivare l'overlay dei tag e modificare i contenuti direttamente mentre naviga il sito.
 - **Blog** con editor TipTap, immagini caricate, firma autore e proprietà degli articoli per ruolo.
-- **Gestione utenti** con tre ruoli (`admin`, `superuser`, `user`).
+- **Gestione utenti** con quattro ruoli (`admin`, `superuser`, `user`, `campus`).
+- **Campus**: sezione riservata con le guide di studio del corso Biohacking Campus, accessibile solo dopo il login e con navigazione autonoma.
 - **Form contatti** con validazione, honeypot anti‑spam, rate‑limit e invio email via SMTP.
 
 ## Installazione (sviluppo)
@@ -53,7 +54,8 @@ Il database `data/insanitylab.db` viene creato al primo avvio ed è popolato aut
 | `npm run preview` | Anteprima locale della build |
 | `npm run start` | Server di produzione (`node --env-file=.env`) |
 | `npm run test` | Test con Vitest |
-| `npm run create-user` | Crea/aggiorna utente: `-- <nome> <password> [admin\|superuser\|user]` |
+| `npm run create-user` | Crea/aggiorna utente: `-- <nome> <password> [admin\|superuser\|user\|campus]` |
+| `npm run sync-campus` | Rigenera i contenuti del Campus: `-- <path-progetto-biohacking-campus>` |
 
 ## Gestione contenuti
 
@@ -69,31 +71,41 @@ Il seed dei contenuti è in `src/data/content-seed.ts`; le variazioni sui conten
 
 ## Ruoli e accessi
 
-Tre ruoli, con autorizzazione a matrice di prefissi in `src/lib/auth.ts`:
+Quattro ruoli, con autorizzazione a matrice di prefissi in `src/lib/auth.ts`:
 
 | Ruolo | Può fare |
 |-------|----------|
-| `admin` | Tutto: contenuti, blog, upload, **gestione utenti** (`/admin/users`) |
+| `admin` | Tutto: contenuti, blog, upload, **gestione utenti** (`/admin/users`), Campus |
 | `superuser` | Pannello contenuti + blog |
 | `user` | Solo i **propri** articoli del blog |
+| `campus` | Solo la sezione riservata `/campus`; nessun accesso al pannello |
 
-Login pubblico su `/login` (`?next` sanitizzato contro open redirect). La gestione utenti (`/admin/users`, solo admin) consente creazione, reset password una‑tantum, cambio ruolo ed eliminazione, con guardie contro l'auto‑eliminazione e la rimozione dell'ultimo admin.
+Login pubblico su `/login` (`?next` sanitizzato contro open redirect). Dopo l'autenticazione ogni ruolo viene indirizzato alla propria pagina iniziale: il pannello per admin e user, i contenuti per superuser, il Campus per il ruolo omonimo. La gestione utenti (`/admin/users`, solo admin) consente creazione, reset password una‑tantum, cambio ruolo ed eliminazione, con guardie contro l'auto‑eliminazione e la rimozione dell'ultimo admin.
+
+## Campus (sezione riservata)
+
+La sezione `/campus` raccoglie le guide di studio del corso Biohacking Campus. È protetta dal middleware come il pannello: un visitatore anonimo viene mandato al login, un utente con ruolo non abilitato torna alla propria pagina iniziale. Le pagine non montano l'header e il footer del sito — la navigazione avviene attraverso la barra laterale delle aree, con un unico richiamo per tornare alla home — ma usano i font, i colori e il CSS globale di InsanityLab.
+
+I contenuti non vengono scritti a mano: lo script `npm run sync-campus` legge le guide sorgente (`*.studio.md`) dal progetto Biohacking Campus, le converte in frammenti HTML e produce la cartella `campus-content/` (indice `nav.json`, pagine e immagini delle slide), che va committata perché il deploy la copia nell'immagine Docker. Lo script è idempotente: rigenerarlo dopo l'aggiunta di nuove lezioni aggiorna indice e pagine e rimuove quelle non più presenti. Le nuove guide vanno prima dichiarate nella struttura dei capitoli in `scripts/campus/structure.mjs`.
+
+Le immagini delle slide sono servite dalla route `/campus/assets/...`, anch'essa protetta: non sono raggiungibili senza una sessione valida.
 
 ## Struttura del progetto
 
 ```
 insanitylab-website/
 ├── src/
-│   ├── pages/            # Route Astro (vetrina, /admin, /api)
+│   ├── pages/            # Route Astro (vetrina, /admin, /api, /campus)
 │   ├── components/       # Componenti (home/, content/, Header, Footer, …)
-│   ├── layouts/          # Layout Base
+│   ├── layouts/          # Layout Base, Admin, Campus
 │   ├── data/             # Dati statici + seed contenuti (services, trainings, site, content-seed)
 │   ├── lib/              # db, auth, content, mailer, rate-limit, safe-next, env
 │   ├── assets/img/       # Immagini ottimizzate da Astro
 │   └── styles/           # global.css
 ├── data/                 # SQLite (volume in produzione)
 ├── uploads/              # Upload immagini (volume in produzione)
-├── scripts/              # create-user, smoke test
+├── campus-content/       # Contenuti del Campus generati da sync-campus
+├── scripts/              # create-user, sync-campus, smoke test
 ├── astro.config.mjs      # Config Astro (site, allowedDomains, redirects)
 ├── compose.yaml          # Stack Docker + label Traefik
 ├── Dockerfile            # Build multi-stage
@@ -115,6 +127,7 @@ Il file `.env` (non versionato) richiede:
 | `CONTACT_TO` | Destinatario dei messaggi del form |
 | `DB_PATH` | Percorso del database SQLite |
 | `UPLOADS_DIR` | Cartella degli upload |
+| `CAMPUS_DIR` | Cartella dei contenuti del Campus (default `./campus-content`) |
 
 La posta del dominio `@insanitylab.it` è ospitata su **Aruba**; l'invio del form usa l'SMTP autenticato Aruba (`smtps.aruba.it:465`). Aruba impone che il mittente sia la casella autenticata, quindi `CONTACT_FROM` deve essere uguale a `SMTP_USER`.