Blog: numeri delle tematiche fra parentesi

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

.env.example

@@ -1,8 +1,17 @@
-SMTP_HOST=smtp.example.com
+# SMTP Aruba — il dominio insanitylab.it invia la posta via Aruba (SPF: include:aruba.it)
-SMTP_PORT=587
+# Server posta in uscita autenticato: smtps.aruba.it:465 (SSL). Verificato funzionante.
-SMTP_USER=user
+SMTP_HOST=smtps.aruba.it
-SMTP_PASS=pass
+SMTP_PORT=465
+# Casella reale del dominio usata per l'invio autenticato (con la sua password Aruba)
+SMTP_USER=postmaster@insanitylab.it
+SMTP_PASS=la-password-della-casella
+# Aruba impone che il mittente sia la casella autenticata: uguale a SMTP_USER
+CONTACT_FROM=postmaster@insanitylab.it
+# Dove arrivano i messaggi del form
 CONTACT_TO=info@insanitylab.it
-CONTACT_FROM=sito@insanitylab.it
 DB_PATH=data/insanitylab.db
 UPLOADS_DIR=uploads
+
+# Google Tag Manager: ID container preso da tagmanager.google.com (accanto al nome container).
+# Formato GTM-XXXXXXX. Lascia vuoto per non caricare GTM (es. in locale/staging).
+GTM_ID=GTM-XXXXXXX

Dockerfile

@@ -14,6 +14,8 @@ COPY package.json package-lock.json ./
 RUN npm ci --omit=dev && npm cache clean --force
 COPY --from=build /app/dist ./dist
 COPY scripts ./scripts
+# Contenuti della sezione Campus (generati con `npm run sync-campus` e committati)
+COPY campus-content ./campus-content
 
 ENV HOST=0.0.0.0 \
     PORT=4321 \

README.md

@@ -1,145 +1,167 @@
 # InsanityLab Website
 
-Sito vetrina per InsanityLab con blog integrato e form di contatti.
+Sito ufficiale di InsanityLab: vetrina aziendale, blog integrato, form di contatti e sistema di contenuti modificabili senza toccare il codice. In produzione su **https://insanitylab.it**.
 
 ## Descrizione
 
-Il progetto realizza un sito web per InsanityLab, combinando una vetrina aziendale con un sistema di blog gestito tramite SQLite e un form di contatti funzionante. L'architettura è costruita su **Astro 7** con adapter **Node.js** per deployment su server, garantendo performance ottimali e SEO-friendly pages.
+Il sito è costruito su **Astro 7** in modalità server (SSR) con adapter **Node.js standalone**, servito in un container Docker dietro **Traefik** (TLS Let's Encrypt automatico). I contenuti testuali e le immagini della parte vetrina sono "taggati" e salvati su **SQLite**: si modificano da un pannello di amministrazione o direttamente in pagina, senza deploy. Il blog è gestito internamente con editor rich‑text, e il form di contatti invia email tramite SMTP.
 
-## Stack Tecnologico
+## Stack tecnologico
 
-- **Framework**: Astro 7
+- **Framework**: Astro 7 (output `server`, `prerender = false` sulle pagine dinamiche)
-- **Runtime**: Node.js (adapter standalone)
+- **Runtime**: Node.js 22 (adapter `@astrojs/node` standalone)
-- **Database**: SQLite (better-sqlite3)
+- **Database**: SQLite via `better-sqlite3`
-- **Autenticazione**: bcryptjs
+- **Autenticazione**: sessioni con password hashate (`bcryptjs`)
-- **Email**: Nodemailer
+- **Email**: Nodemailer (SMTP)
-- **Markup Editor**: TipTap (rich text)
+- **Editor articoli**: TipTap (rich text)
-- **Font System**: @fontsource (Montserrat, Open Sans)
+- **Font**: `@fontsource` (Montserrat, Open Sans) — nessun CDN esterno
-- **Sitemap**: endpoint runtime `/sitemap.xml` (route vetrina, programmi e articoli pubblicati)
+- **Sitemap**: endpoint runtime `/sitemap.xml` (route vetrina + articoli pubblicati)
-- **Testing**: Vitest
+- **Test**: Vitest
 - **Linguaggio**: TypeScript
+- **Deploy**: Docker (multi‑stage, `node:22-slim`) + Traefik su VPS
 
-## Installazione
+## Funzionalità principali
+
+- **Vetrina**: home, chi siamo, training, servizi (con schede di dettaglio), blog, contatti, landing "Promo ed eventi".
+- **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 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)
 
 ### Prerequisiti
-
 - Node.js 18+ e npm
 
 ### Setup
-
 ```bash
-# Installa dipendenze
 npm install
-
+cp .env.example .env          # poi compila i valori reali
-# Copia il template di configurazione env
+npm run create-user -- admin <password> admin
-cp .env.example .env
+npm run dev                   # http://localhost:4321
-
-# Crea il primo utente amministratore (dopo aver configurato il DB)
-npm run create-user -- admin tuapassword
 ```
 
-Modifica `.env` con le credenziali SMTP, percorsi database e upload directory secondo il tuo ambiente.
+Il database `data/insanitylab.db` viene creato al primo avvio ed è popolato automaticamente con i contenuti di default (seed) e le migrazioni idempotenti.
 
-## Comandi Disponibili
+## Comandi
 
 | Comando | Descrizione |
 |---------|-------------|
-| `npm run dev` | Avvia il server di sviluppo (localhost:4321) |
+| `npm run dev` | Server di sviluppo (localhost:4321) |
-| `npm run build` | Compila il progetto per production |
+| `npm run build` | Build di produzione |
-| `npm run preview` | Visualizza l'anteprima della build (locale) |
+| `npm run preview` | Anteprima locale della build |
-| `npm run start` | Avvia il server production (richiede `npm run build` preliminare) |
+| `npm run start` | Server di produzione (`node --env-file=.env`) |
-| `npm run test` | Esegui i test con Vitest |
+| `npm run test` | Test con Vitest |
-| `npm run create-user` | Crea un nuovo utente: `-- <nome> <password> [admin\|editor]` |
+| `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
+## Gestione contenuti
 
-I testi e le immagini del sito vetrina sono contenuti taggati, modificabili senza toccare il codice tramite il pannello `/admin/content`. Ogni blocco di contenuto è identificato da un tag (ad esempio `home.hero.title`) e può essere aggiornato nel valore, negli stili predefiniti (dimensione, peso, colore) e — per le immagini — sostituito con un upload o riportato all'originale.
+I testi e le immagini della vetrina sono **blocchi taggati** salvati nella tabella `content_blocks`. Ogni blocco ha un tag stabile (es. `home.hero.title-line-1`), un valore, eventuali stili predefiniti, un tipo (`text` / `html` / `image`) e un **GUID** univoco.
 
-Il pannello raggruppa i tag per pagina, offre una ricerca per tag o contenuto e mostra per ogni blocco l'ultima modifica effettuata. Visitando il sito da utente autenticato con il parametro `?annotate=1` (link "Vedi sito con tag" nel pannello), ogni contenuto taggato viene evidenziato con un badge che rimanda direttamente al form di modifica corrispondente.
+- **Pannello** `/admin/content`: i blocchi sono raggruppati per pagina, con ricerca per tag o contenuto, upload delle immagini e ripristino all'originale.
+- **Modifica inline**: attivando "Mostra tag" dal menu utente, ogni blocco mostra un badge (nome tag + matita) che apre una finestra di modifica direttamente in pagina.
+- **Componenti** `<T>` e `<TImg>`: rendono i blocchi con fallback automatico al seed quando un tag non è ancora nel database.
 
-Sono previsti due ruoli utente: `admin` ha accesso completo (articoli del blog, contenuti, upload), mentre `editor` può operare esclusivamente sul pannello contenuti. Gli utenti si creano con `npm run create-user -- <nome> <password> editor`.
+Il seed dei contenuti è in `src/data/content-seed.ts`; le variazioni sui contenuti già esistenti (rinomine, testi aggiornati) si applicano tramite **migrazioni idempotenti** in `src/lib/db.ts`, così da non sovrascrivere le modifiche fatte dal pannello.
 
-## Struttura Progetto
+> Nota tecnica: gli elementi resi dai componenti `<T>`/`<TImg>` **non** ereditano il `data-astro-cid` del componente che li usa. Uno stile scoped basato solo sulla classe (es. `.hero__line`) non li raggiunge: va ancorato a un contenitore che ha il cid usando `:global()` (es. `.hero__text :global(.hero__line)`).
+
+## Ruoli e accessi
+
+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`), 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). 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/               # Pagine Astro (routing automatico)
+│   ├── pages/            # Route Astro (vetrina, /admin, /api, /campus)
-│   ├── components/          # Componenti Astro riutilizzabili
+│   ├── components/       # Componenti (home/, content/, Header, Footer, …)
-│   ├── layouts/             # Layout master
+│   ├── layouts/          # Layout Base, Admin, Campus
-│   ├── utils/               # Funzioni di utilità
+│   ├── data/             # Dati statici + seed contenuti (services, trainings, site, content-seed)
-│   ├── env.d.ts            # Type definitions globali
+│   ├── lib/              # db, auth, content, mailer, rate-limit, safe-next, env
-│   └── ...
+│   ├── assets/img/       # Immagini ottimizzate da Astro
-├── data/                    # Database SQLite e dati persistenti
+│   └── styles/           # global.css
-│   └── insanitylab.db      # (generato al primo avvio)
+├── data/                 # SQLite (volume in produzione)
-├── uploads/                 # Directory per upload immagini e file
+├── uploads/              # Upload immagini (volume in produzione)
-├── dist/                    # Output build (server)
+├── campus-content/       # Contenuti del Campus generati da sync-campus
-├── tests/                   # Test suite
+├── scripts/              # create-user, sync-campus, smoke test
-├── astro.config.mjs        # Configurazione Astro
+├── astro.config.mjs      # Config Astro (site, allowedDomains, redirects)
-├── tsconfig.json           # Configurazione TypeScript
+├── compose.yaml          # Stack Docker + label Traefik
-├── vitest.config.ts        # Configurazione test framework
+├── Dockerfile            # Build multi-stage
-├── .env.example            # Template variabili di ambiente
+├── .env.example          # Template variabili d'ambiente
-├── .env                    # Variabili di ambiente (non versionato)
+└── README.md
-├── package.json            # Dipendenze e script npm
-└── README.md               # Questo file
 ```
 
-## Configurazione Ambiente
+## Variabili d'ambiente
 
-Il file `.env` richiede le seguenti variabili:
+Il file `.env` (non versionato) richiede:
 
-- `SMTP_HOST`: Host SMTP per invio email
+| Variabile | Descrizione |
-- `SMTP_PORT`: Porta SMTP (solitamente 587)
+|-----------|-------------|
-- `SMTP_USER`: Utente SMTP
+| `SMTP_HOST` | Host SMTP (produzione: `smtps.aruba.it`) |
-- `SMTP_PASS`: Password SMTP
+| `SMTP_PORT` | Porta SMTP (`465` con SSL) |
-- `CONTACT_TO`: Email di destinazione contatti
+| `SMTP_USER` | Casella di invio (deve coincidere con `CONTACT_FROM`) |
-- `CONTACT_FROM`: Email mittente
+| `SMTP_PASS` | Password della casella |
-- `DB_PATH`: Percorso database SQLite
+| `CONTACT_FROM` | Mittente delle email (= `SMTP_USER`) |
-- `UPLOADS_DIR`: Cartella upload file
+| `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`) |
 
-## Development Workflow
+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`.
 
-1. **Avvia il server locale**: `npm run dev`
+## Deploy in produzione
-2. **Modifica file** in `src/` (hot reload automatico)
-3. **Test**: `npm run test`
-4. **Build**: `npm run build` (verifica errori di build)
-5. **Commit**: Con prefisso `feat:` (feature) o `chore:` (manutenzione)
 
-## Deployment
+Il sito gira in Docker su un VPS, dietro Traefik. Lo stack è in `/opt/docker/insanitylab/` (repo in `src/`, volumi `data/` e `uploads/`). Aggiornamento:
 
 ```bash
-# Build per production
+cd /opt/docker/insanitylab/src
-npm run build
+git pull
-
+docker compose up -d --build
-# Opzionalmente, preview locale
-npm run preview
-
-# In production, il server parte con:
-npm run start
-
-# Variabili ambiente in production vanno impostate sull'hosting
-# (es. Hostinger VPS, Vercel, etc.)
 ```
 
-## Riferimenti Tecnici
+Le migrazioni del database (in `src/lib/db.ts`) sono idempotenti e girano all'avvio del container: aggiornano lo schema e i contenuti senza perdere le modifiche fatte dal pannello.
 
-Per dettagli su architettura, schema database, componenti e specifiche vedi:
+### Dominio e DNS
-- `/docs/superpowers/specs/2026-07-01-insanitylab-website-design.md`
-- `/docs/superpowers/plans/2026-07-01-insanitylab-website.md`
 
-## Problemi Comuni
+- Dominio ufficiale: **insanitylab.it** (canonico l'apex; `www` fa redirect 301 all'apex tramite Traefik).
+- I record **A** di `@` e `www` puntano al VPS; la **posta resta su Aruba** (MX, SPF, webmail non vengono toccati).
+- TLS Let's Encrypt automatico via Traefik (certresolver `mytlschallenge`).
 
-### `better-sqlite3` fallisce su npm install
+> Attenzione dietro Traefik: `allowedDomains` in `astro.config.mjs` deve elencare i domini serviti, altrimenti Astro ignora `X-Forwarded-Proto/Host` e il controllo CSRF respinge i POST con 403.
 
-Se `better-sqlite3` non compila, assicurati di avere build tools installati:
+## Problemi comuni
-- **Linux**: `sudo apt-get install build-essential python3`
-- **macOS**: Xcode Command Line Tools (`xcode-select --install`)
-- **Windows**: Visual Studio Build Tools o MinGW
 
-### Database locked
+**`better-sqlite3` non compila su `npm install`** — servono i build tools:
+- Linux: `sudo apt-get install build-essential python3`
+- macOS: `xcode-select --install`
+- Windows: Visual Studio Build Tools
 
-Se il database è locato durante i test, verifica che non ci siano processi in background che accedono a `data/insanitylab.db`.
+**Modifiche allo `<style>` scoped di `[slug].astro` non compaiono in dev** — l'HMR di Astro 7 non sempre ricompila lo stile scoped delle route dinamiche: riavviare il dev server (`astro dev stop` + `npm run dev`).
+
+**Database "locked" durante i test** — assicurarsi che nessun processo stia accedendo a `data/insanitylab.db`.
 
 ## Licenza
 
-Proprietario InsanityLab.
+Proprietà di InsanityLab.

astro.config.mjs

@@ -1,18 +1,36 @@
 import { defineConfig } from 'astro/config';
 import node from '@astrojs/node';
 
+import react from '@astrojs/react';
+
 export default defineConfig({
-  site: 'https://insanitylab.tielogic.xyz',
+  site: 'https://insanitylab.it',
   output: 'server',
+
   // Dietro Traefik il TLS termina al proxy: senza allowedDomains Astro ignora
   // X-Forwarded-Proto/Host e il checkOrigin CSRF respinge i POST (403).
+  // Dominio ufficiale insanitylab.it (canonico apex); www e il vecchio
+  // sottodominio tielogic.xyz redirigono all'apex a livello Traefik.
   security: {
-    allowedDomains: [{ hostname: 'insanitylab.tielogic.xyz', protocol: 'https' }],
+    allowedDomains: [
+      { hostname: 'insanitylab.it', protocol: 'https' },
+      { hostname: 'www.insanitylab.it', protocol: 'https' },
+      { hostname: 'insanitylab.tielogic.xyz', protocol: 'https' },
+    ],
   },
+
   adapter: node({ mode: 'standalone' }),
+
   // La sezione "Programmi" è stata rinominata "Servizi": redirect permanenti dai vecchi URL.
   redirects: {
     '/programs': { status: 301, destination: '/services' },
     '/programs/[slug]': { status: 301, destination: '/services/[slug]' },
+    // Modifiche 02: "Pilates Flow" → "Profilazione". "Rehab" esce dalla griglia Servizi e
+    // diventa un riquadro Training, ma la pagina dettaglio resta su /services/rehab.
+    '/services/pilates-flow': { status: 301, destination: '/services/profilazione' },
+    // "Personal Training" rinominato "One to One" (nuovo slug); Small Group è una pagina a sé.
+    '/services/personal-training': { status: 301, destination: '/services/one-to-one' },
   },
-});
+
+  integrations: [react()],
+});