longevity: revisione finale — il motore ora si calcola, il consenso è atomico, il codice cliente è tipato fuori dal corpo

Sei correzioni dalla revisione finale del 22/08, ognuna con test scritto prima:

1. salvaDalForm calcolava mai i punteggi (calcolaSessione/salvaScore) dopo il
   salvataggio: un cliente compilava venti domande e vedeva un referto vuoto.
   Ora avviene nella stessa transazione del salvataggio.
2. Il corpo della richiesta dell'endpoint questionario è tipato
   (CorpoQuestionario): client_code non esiste in quel tipo, non è più
   prendibile per errore. Il vecchio test a lista di nomi vietati era vacuo
   (cercava body./corpo., il file usa data.) — sostituito con un test
   comportamentale end-to-end sull'endpoint vero.
3. Il consenso: aggiunto il test sul ramo affermativo (non coperto, vacuo
   quanto il punto 2); la nota di consenso ora è nella stessa transazione dei
   dati sanitari; ha una versione propria (CONSENT_VERSION) invece di quella
   del questionario.
4. La prima apertura del referto ora spiega invece di sembrare rotta: Fitness
   Age con nota quando manca, spiegazione del radar prima del grafico,
   copertura sempre visibile, invito a fare i test in sala col trainer,
   numeri formattati all'italiana.
5. Aggiunto il link per ricompilare il questionario nella pagina del referto
   (prima spariva appena esisteva una compilazione).
6. Il test anti-query ora scandisce tutte le pagine sotto src/pages/longevity/,
   non due nomi a mano. Il test anti-giunzione identity/longevity resta con lo
   stesso limite di sempre (createIdentityDb è esportata per creaCliente) —
   corretto solo il commento perché lo dichiari onestamente.

Report con comandi e output letterali:
.superpowers/sdd/2026-08-22-longevity-interfaccia/review-finale-report.md

.gitignore

@@ -7,3 +7,9 @@ data/*.db*
 uploads/*
 !uploads/.gitkeep
 assets-src/
+
+# Artefatti di lavoro dei subagenti (ledger, brief, review package)
+.superpowers/
+
+# Cache di Python generata rieseguendo l'oracolo
+__pycache__/

docs/plans/2026-08-22-longevity-interfaccia.md

@@ -0,0 +1,405 @@
+# Longevity — l'interfaccia: piano di implementazione
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** dare una faccia al fascicolo del cliente — il questionario che si compila in pagina e il referto che il cliente legge, col radar a sette assi.
+
+**Architecture:** pagine Astro dentro il sito esistente, sotto `/longevity/`, con un layout dedicato e un foglio di stile prefissato. Il contenuto statico è Astro; React solo dove serve interattività vera — il questionario a blocchi e il radar. I dati arrivano dal motore già costruito, mai da query scritte nelle pagine.
+
+**Tech Stack:** Astro, React, recharts (già in casa), better-sqlite3, vitest. Nessuna dipendenza nuova.
+
+**Spec:** `docs/specs/2026-08-21-longevity-design.md`
+
+**Piani precedenti, già eseguiti:** `2026-08-21-longevity-strato-dati.md` e `2026-08-22-longevity-motore.md`. Lo strato dati e il motore esistono, sono testati, e nessuna pagina li usa ancora.
+
+## Global Constraints
+
+- Branch **`feat/longevity`**. `main` non si tocca, non si deploya, non si pusha senza che Adriano lo chieda.
+- **Nessuna dipendenza npm nuova.**
+- Test in `tests/longevity/`, eseguiti con `npm test`. Codice e commenti in italiano.
+- ⚠️ **La suite parte con un rosso che non è nostro:** `tests/modifiche-agosto.test.ts` (test del sito disallineato su `main`, fuori perimetro). L'atteso è **1 fallito pre-esistente**, il resto verde. Non ripararlo.
+- ⚠️ **`npx tsc --noEmit` deve restare pulito.** In questo lavoro il tipo è il meccanismo di sicurezza: un typecheck rosso è un cancello che nessuno guarda più.
+- **Nessun dato reale di persone** nelle fixture.
+
+## Le due regole di prodotto che l'interfaccia non può violare
+
+**1. Un punteggio insufficiente non si mostra come numero.** Il motore restituisce un tipo che nel ramo insufficiente **non ha il campo `valore`**: la pagina non ha da dove prenderlo. Ma la barriera finisce lì — la tabella dei punteggi è letta da una funzione tipata (`leggiScore`), e **le pagine devono usare quella**, mai una query propria. Una `SELECT valore FROM score` scritta in una pagina riapre il buco.
+
+**2. Il colore non giudica il corpo.** Niente semaforo verde/giallo/rosso sui punteggi: il servizio è premium ma **non clinico**, e un rosso su «Composizione Corporea» detto a una persona è un giudizio, non un'informazione. I punteggi si esprimono con l'**intensità** del colore d'accento del sito. L'unico colore di segnale — il mattone `#b05a4e` già presente nel foglio di Stress Index — è riservato ai **valori fuori range**, che segnalano un problema **della misura**, non della persona.
+
+## Il gesto che questa interfaccia deve avere
+
+Il radar mostra **quello che sappiamo** come area piena, e dove la misura non basta lascia un **perimetro tratteggiato** con, sotto, cosa manca per completarlo. Non un buco, non un errore: un invito.
+
+Regge tre cose insieme — la regola di prodotto («tratteggiato, mai un numero pieno fasullo»), la leva commerciale che il cliente voleva per il livello avanzato, e una posizione onesta: *non ti diciamo un numero che non sappiamo*.
+
+⚠️ **Con i dati di oggi sei assi su sette saranno tratteggiati**, perché nel registro c'è solo il questionario e i test fisici arrivano col piano degli import. È atteso: chi guarda la prima dashboard non deve scambiarlo per un guasto.
+
+## Struttura dei file
+
+| File | Responsabilità |
+|---|---|
+| `src/layouts/Longevity.astro` | layout della piattaforma: intestazione, niente header pubblico |
+| `src/styles/longevity.css` | stile prefissato `.lg`, globale (deve raggiungere le isole React) |
+| `src/pages/longevity/questionario.astro` | la pagina del questionario |
+| `src/components/longevity/Questionario.tsx` | isola React: quattro blocchi, validazione, invio |
+| `src/pages/api/longevity/questionario.ts` | endpoint che salva una compilazione |
+| `src/pages/longevity/io.astro` | il referto del cliente |
+| `src/components/longevity/Radar.tsx` | isola React: il radar a sette assi col tratteggio |
+| `src/components/longevity/MacroScore.astro` | le tre carte dei macro-score |
+| `src/lib/longevity/vista.ts` | ciò che serve alle pagine, letto dal motore |
+
+---
+
+### Task 1: Il guscio — layout, stile, e una rotta che risponde
+
+**Files:**
+- Create: `src/layouts/Longevity.astro`, `src/styles/longevity.css`, `src/pages/longevity/index.astro`
+- Test: `tests/longevity/pagine.test.ts`
+
+**Interfaces:**
+- Consumes: `isProtectedPath`, `canAccessAdminPath` da `src/lib/auth.ts`
+- Produces: il layout `Longevity.astro` con `title` e `crumbs`, e le classi `.lg-*`
+
+**Il modello da seguire:** `src/layouts/StressIndex.astro` e `src/styles/stress-index.css`. Leggili prima di scrivere. Il foglio di stile va **globale e prefissato**, non in `<style>` scoped: le stesse classi servono ai componenti Astro e alle isole React, che lo scope di Astro non raggiunge — la ragione è scritta in testa al foglio di Stress Index.
+
+**La differenza voluta rispetto a Stress Index.** Quella piattaforma ha una barra laterale con sette voci, giusta per chi ci **lavora** dentro. Qui i pubblici sono due e uno non è staff: il **cliente** entra tre o quattro volte l'anno per guardare il proprio referto, e una barra di navigazione è l'arredamento di uno strumento di lavoro. Quindi il layout prevede due forme: `variante="referto"` (una colonna che scorre, nessuna navigazione) e `variante="gestionale"` (barra laterale come Stress Index). Questo task realizza la prima; la seconda arriva col piano del gestionale.
+
+- [ ] **Step 1: Write the failing test**
+
+```ts
+// tests/longevity/pagine.test.ts
+import { describe, it, expect } from 'vitest';
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+
+const leggi = (p: string) => readFileSync(join(process.cwd(), p), 'utf8');
+
+describe('il guscio della piattaforma', () => {
+  it('il layout esiste e non monta header e footer pubblici', () => {
+    const l = leggi('src/layouts/Longevity.astro');
+    expect(l).not.toMatch(/import\s+Header/);
+    expect(l).not.toMatch(/import\s+Footer/);
+    expect(l).toMatch(/noindex/);          // area riservata: mai indicizzata
+  });
+
+  it('il foglio di stile e globale e prefissato, non scoped', () => {
+    expect(existsSync(join(process.cwd(), 'src/styles/longevity.css'))).toBe(true);
+    const css = leggi('src/styles/longevity.css');
+    const classi = [...css.matchAll(/^\.([a-z-]+)/gm)].map((m) => m[1]);
+    expect(classi.length).toBeGreaterThan(3);
+    expect(classi.every((c) => c.startsWith('lg'))).toBe(true);
+  });
+
+  it('usa i token del sito invece di inventare colori', () => {
+    const css = leggi('src/styles/longevity.css');
+    expect(css).toMatch(/var\(--c-/);
+  });
+
+  it('nessun semaforo sui punteggi: il colore non giudica il corpo', () => {
+    const css = leggi('src/styles/longevity.css').toLowerCase();
+    // il mattone del fuori range e ammesso; un verde "tutto bene" no
+    expect(css).not.toMatch(/--lg-ok|--lg-buono|--lg-verde/);
+  });
+
+  it('la rotta del cliente e sotto /longevity, dove le regole la proteggono', () => {
+    expect(existsSync(join(process.cwd(), 'src/pages/longevity/index.astro'))).toBe(true);
+  });
+});
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `npm test -- tests/longevity/pagine.test.ts`
+Expected: FAIL — i file non esistono
+
+- [ ] **Step 3: Write minimal implementation**
+
+Il layout prende `title`, `crumbs` e `variante`, importa i font e i due fogli di stile (`global.css` e `longevity.css`), e dichiara `noindex`. Nessun `Header`/`Footer` pubblico: la navigazione è interna.
+
+Il foglio `longevity.css` definisce, **tutte prefissate `lg`**: il guscio del referto (una colonna centrata, larghezza leggibile), l'intestazione, la carta di un punteggio, e i token locali. Le variabili locali riprendono quelle del sito (`--c-accent`, `--c-dark`, `--c-bg-alt`) e ne aggiungono due sole:
+
+```css
+--lg-tratteggio: #d8d2c8;   /* il perimetro di cio che non sappiamo */
+--lg-fuori-range: #b05a4e;  /* SOLO per una misura sospetta, mai per un punteggio */
+```
+
+⚠️ Non definire un colore «buono» o «cattivo» per i punteggi: l'intensità si ottiene variando l'opacità dell'accento. È la regola di prodotto, e il test la controlla.
+
+`src/pages/longevity/index.astro` reindirizza a `/longevity/io`.
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `npm test -- tests/longevity/pagine.test.ts` → PASS (5 test)
+Poi: `npm test` per intero e `npx tsc --noEmit`.
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/layouts/Longevity.astro src/styles/longevity.css src/pages/longevity/index.astro tests/longevity/pagine.test.ts
+git commit -m "longevity: il guscio della piattaforma, senza semaforo sui punteggi"
+```
+
+---
+
+### Task 2: Il questionario in pagina
+
+Sostituisce il prototipo del cliente, che salva nel browser e che il documento stesso dichiara da buttare in produzione.
+
+**Files:**
+- Create: `src/components/longevity/Questionario.tsx`, `src/pages/longevity/questionario.astro`, `src/pages/api/longevity/questionario.ts`
+- Test: `tests/longevity/questionario-pagina.test.ts`
+
+**Interfaces:**
+- Consumes: `testAttivi` da `registro.ts`; `salvaCompilazione`, `QUEST_VERSION`, `CAMPI_LIBERI` da `questionario.ts`; `codicePerUtente` da `anagrafica.ts`
+- Produces: `POST /api/longevity/questionario` → `{ sessioneId }` o errore
+
+**Le domande vengono dal registro, non dal codice.** La pagina legge `testAttivi` e costruisce i campi da lì: etichetta, tipo, minimo e massimo. Aggiungere una domanda resta una modifica ai dati — è la promessa della spec, e qui va mantenuta.
+
+⚠️ **Tre regole che l'endpoint deve rispettare, e sono di sostanza:**
+
+1. **Il codice cliente si ricava dalla sessione, mai dalla richiesta.** Un codice che arriva dal browser va ignorato. È la regola §8 della spec, e questo è il primo endpoint su cui si può finalmente provare.
+2. **Il consenso al trattamento dei dati sanitari non è «compilato», è «dato».** Il prototipo del cliente blocca il salvataggio solo se il campo è vuoto: rispondendo **«No»** i dati vengono salvati lo stesso. È l'esatto contrario di ciò per cui il campo esiste. Qui: se il consenso non è affermativo, **la compilazione non si salva**, e la risposta lo dice chiaramente.
+3. **Il consenso va registrato, non solo controllato.** Un consenso è un fatto che un domani va **dimostrato**: chi, quando, a cosa. Salvalo fra le note di profilo con la sua data e la versione del questionario, **anche quando la risposta è no** — il rifiuto è precisamente ciò di cui bisogna poter provare il rispetto.
+
+- [ ] **Step 1: Write the failing test**
+
+```ts
+// tests/longevity/questionario-pagina.test.ts
+import { describe, it, expect } from 'vitest';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { createLongevityDb } from '../../src/lib/longevity/db';
+import { seedRegistro } from '../../src/lib/longevity/registro';
+import { campiDelQuestionario, salvaDalForm } from '../../src/lib/longevity/vista';
+
+function dbPronto() {
+  const db = createLongevityDb(':memory:');
+  seedRegistro(db);
+  db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0001','F')`).run();
+  return db;
+}
+
+describe('i campi del questionario vengono dal registro', () => {
+  it('costruisce i campi leggendo il registro, non una lista nel codice', () => {
+    const db = dbPronto();
+    const campi = campiDelQuestionario(db, '2026-08-22');
+    expect(campi.length).toBe(20);
+    const alcol = campi.find((c) => c.id === 'q_alcol_life')!;
+    expect(alcol.etichetta).toMatch(/alcoliche/i);
+    expect(alcol.max).toBe(30);
+  });
+
+  it('una domanda disattivata sparisce dal modulo senza toccare il codice', () => {
+    const db = dbPronto();
+    db.prepare(`UPDATE registro_test SET attivo_a = '2026-01-01' WHERE test_id = 'q_sigarette'`).run();
+    const campi = campiDelQuestionario(db, '2026-08-22');
+    expect(campi.map((c) => c.id)).not.toContain('q_sigarette');
+    expect(campi.length).toBe(19);
+  });
+});
+
+describe('il salvataggio, e il consenso', () => {
+  const risposte = { q_riposato: 8, q_ore_sonno: 7.5 };
+
+  it('salva una compilazione quando il consenso e dato', () => {
+    const db = dbPronto();
+    const esito = salvaDalForm(db, {
+      client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+      risposte, consensoSanitario: 'Si', liberi: {},
+    });
+    expect(esito.ok).toBe(true);
+    const n = db.prepare(`SELECT COUNT(*) n FROM sessioni`).get() as { n: number };
+    expect(n.n).toBe(1);
+  });
+
+  it('NON salva se il consenso e rifiutato: "No" non e un consenso', () => {
+    const db = dbPronto();
+    const esito = salvaDalForm(db, {
+      client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+      risposte, consensoSanitario: 'No', liberi: {},
+    });
+    expect(esito.ok).toBe(false);
+    const n = db.prepare(`SELECT COUNT(*) n FROM sessioni`).get() as { n: number };
+    expect(n.n).toBe(0);   // niente sessione, niente misure
+  });
+
+  it('NON salva se il consenso manca del tutto', () => {
+    const db = dbPronto();
+    const esito = salvaDalForm(db, {
+      client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+      risposte, consensoSanitario: '', liberi: {},
+    });
+    expect(esito.ok).toBe(false);
+  });
+
+  it('registra il consenso anche quando e rifiutato: il rifiuto va dimostrato', () => {
+    const db = dbPronto();
+    salvaDalForm(db, {
+      client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+      risposte, consensoSanitario: 'No', liberi: {},
+    });
+    const note = db.prepare(
+      `SELECT campo_id, testo FROM profilo_note WHERE campo_id LIKE 'consenso%'`
+    ).all() as { campo_id: string; testo: string }[];
+    expect(note.length).toBeGreaterThan(0);
+    expect(note[0].testo).toMatch(/No/);
+  });
+
+  it('il codice cliente NON puo arrivare da chi chiama la pagina', () => {
+    const src = readFileSync(join(process.cwd(), 'src/pages/api/longevity/questionario.ts'), 'utf8');
+    // il codice si prende dalla sessione dell'utente, mai dal corpo della richiesta
+    expect(src).toMatch(/codicePerUtente/);
+    expect(src).not.toMatch(/body\.client_code|body\.clientId|corpo\.client_code/);
+  });
+});
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `npm test -- tests/longevity/questionario-pagina.test.ts`
+Expected: FAIL — `src/lib/longevity/vista.ts` non esiste
+
+- [ ] **Step 3: Write minimal implementation**
+
+`vista.ts` espone `campiDelQuestionario(db, alla)` — che legge `testAttivi` e tiene i soli `test_id` che iniziano per `q_` — e `salvaDalForm(db, input)`, che controlla il consenso **prima** di scrivere qualsiasi cosa, registra il consenso fra le note col suo esito e la versione del questionario, e delega a `salvaCompilazione`.
+
+L'isola React mostra i quattro blocchi uno per schermata, con avanti e indietro, e invia in fondo. L'endpoint ricava il codice cliente dalla sessione con `codicePerUtente` e passa a `salvaDalForm`.
+
+⚠️ Il consenso **rifiutato va scritto comunque** fra le note: apri la sessione solo se il consenso è affermativo, ma la nota del consenso si scrive in entrambi i casi, legata al cliente.
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `npm test` — atteso 1 fallito pre-esistente, il resto verde. Poi `npx tsc --noEmit` pulito.
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/lib/longevity/vista.ts src/components/longevity/Questionario.tsx \
+        src/pages/longevity/questionario.astro src/pages/api/longevity/questionario.ts \
+        tests/longevity/questionario-pagina.test.ts
+git commit -m "longevity: il questionario in pagina, e il consenso che si puo negare davvero"
+```
+
+---
+
+### Task 3: Il radar, e come si mostra ciò che non si sa
+
+**Files:**
+- Create: `src/components/longevity/Radar.tsx`, `src/components/longevity/MacroScore.astro`, `src/pages/longevity/io.astro`
+- Modify: `src/lib/longevity/vista.ts` — aggiungere `refertoDi`
+- Test: `tests/longevity/referto.test.ts`
+
+**Interfaces:**
+- Consumes: `calcolaSessione`, `leggiScore` dal motore; `codicePerUtente` da `anagrafica.ts`
+- Produces:
+  - `type AsseVista = { nome: string; valore: number | null; copertura: number; mancano: string[] }`
+  - `refertoDi(db, sessioneId): { assi: AsseVista[]; macro: {...}[]; fitnessAge: number | null }`
+
+**Il punto del task.** Un asse senza dati sufficienti non porta un numero: porta **cosa manca per averlo**. `mancano` è l'elenco dei test del registro che alimenterebbero quell'asse e che quella sessione non ha — è ciò che trasforma un buco in un invito, ed è il gesto su cui si regge tutta l'interfaccia.
+
+⚠️ **Le pagine non interrogano il database.** Tutto passa da `refertoDi`, che a sua volta usa `leggiScore`. Una `SELECT` scritta dentro una pagina riaprirebbe il buco che il tipo del motore chiude.
+
+- [ ] **Step 1: Write the failing test**
+
+```ts
+// tests/longevity/referto.test.ts
+import { describe, it, expect } from 'vitest';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { createLongevityDb } from '../../src/lib/longevity/db';
+import { seedRegistro, seedPesi, MODEL_VERSION } from '../../src/lib/longevity/registro';
+import { salvaCompilazione } from '../../src/lib/longevity/questionario';
+import { calcolaSessione, salvaScore } from '../../src/lib/longevity/motore';
+import { refertoDi } from '../../src/lib/longevity/vista';
+
+function conCompilazione() {
+  const db = createLongevityDb(':memory:');
+  seedRegistro(db); seedPesi(db, MODEL_VERSION);
+  db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0001','F')`).run();
+  const s = salvaCompilazione(db, {
+    client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+    risposte: { q_attivita: 5, q_alimentazione: 8, q_sigarette: 0, q_alcol_life: 2, q_luce: 2, q_schermi: 10 },
+  });
+  salvaScore(db, s, calcolaSessione(db, s));
+  return { db, s };
+}
+
+describe('il referto del cliente', () => {
+  it('restituisce i sette assi', () => {
+    const { db, s } = conCompilazione();
+    expect(refertoDi(db, s).assi.length).toBe(7);
+  });
+
+  it('un asse senza dati NON porta un numero', () => {
+    const { db, s } = conCompilazione();
+    const forza = refertoDi(db, s).assi.find((a) => a.nome === 'Forza & Struttura')!;
+    expect(forza.valore).toBeNull();
+  });
+
+  it('e dice cosa manca per completarlo, invece di lasciare un buco', () => {
+    const { db, s } = conCompilazione();
+    const forza = refertoDi(db, s).assi.find((a) => a.nome === 'Forza & Struttura')!;
+    expect(forza.mancano.length).toBeGreaterThan(0);
+  });
+
+  it('un asse coperto porta il suo numero', () => {
+    const { db, s } = conCompilazione();
+    const stile = refertoDi(db, s).assi.find((a) => a.nome === 'Stile di Vita & Sonno')!;
+    expect(stile.valore).not.toBeNull();
+    expect(stile.mancano).toEqual([]);
+  });
+
+  it('legge i punteggi congelati, non li ricalcola al volo', () => {
+    const { db, s } = conCompilazione();
+    // se rileggesse le misure invece degli score salvati, cambiare i pesi cambierebbe il referto
+    const prima = JSON.stringify(refertoDi(db, s));
+    db.prepare(`UPDATE pesi SET peso = 0.99 WHERE model_version = ? AND elemento = 'questionario_lifestyle'`).run(MODEL_VERSION);
+    expect(JSON.stringify(refertoDi(db, s))).toBe(prima);
+  });
+
+  it('nessuna pagina interroga il database da sola', () => {
+    for (const f of ['src/pages/longevity/io.astro', 'src/pages/longevity/questionario.astro']) {
+      const src = readFileSync(join(process.cwd(), f), 'utf8');
+      expect(src, `${f} contiene SQL`).not.toMatch(/\bSELECT\b|\.prepare\(/i);
+    }
+  });
+});
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `npm test -- tests/longevity/referto.test.ts`
+Expected: FAIL — `refertoDi` non esiste
+
+- [ ] **Step 3: Write minimal implementation**
+
+`refertoDi` legge i punteggi congelati con `leggiScore` e, per ogni asse insufficiente, calcola `mancano`: i sotto-domini di quell'asse che non hanno nessuna misura nella sessione, tradotti nelle etichette leggibili del registro.
+
+Il radar è un'isola React con `recharts`: due serie sovrapposte — una piena con i valori noti, una tratteggiata che chiude il perimetro dove il dato manca. Sotto, l'elenco di ciò che manca.
+
+Le carte dei macro-score sono Astro. Un macro insufficiente mostra **un trattino**, non uno zero.
+
+⚠️ I numeri usano `font-variant-numeric: tabular-nums`: in una pagina che confronta misure nel tempo, cifre che ballano sono un difetto di lettura.
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `npm test` — atteso 1 fallito pre-esistente. Poi `npx tsc --noEmit` pulito.
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/components/longevity/Radar.tsx src/components/longevity/MacroScore.astro \
+        src/pages/longevity/io.astro src/lib/longevity/vista.ts tests/longevity/referto.test.ts
+git commit -m "longevity: il referto del cliente, e il radar che dice cosa non sa"
+```
+
+---
+
+## Cosa esiste alla fine di questo piano
+
+Un cliente entra, compila il questionario, e vede il proprio referto col radar. Il consenso ai dati sanitari si può **negare davvero**, e il rifiuto resta registrato.
+
+**Non esiste ancora**: il gestionale del trainer, l'inserimento dei check-up, l'assorbimento delle sezioni HRV di Stress Index, la progressione nel tempo. Sono i piani successivi.
+
+⚠️ **E non si deploya niente.** Il consenso al trattamento dei dati sanitari è una questione aperta che il cliente sta chiudendo con un consulente legale: si può costruire tutto, non si può accendere la raccolta su persone vere finché quella risposta non arriva.

docs/plans/2026-08-22-longevity-motore.md

@@ -0,0 +1,766 @@
+# Longevity — motore di calcolo: piano di implementazione
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** portare in TypeScript il motore di punteggio del cliente, con un verificatore numerico che dimostri che i due producono gli stessi numeri.
+
+**Architecture:** le curve di normalizzazione e la cascata a quattro livelli diventano funzioni pure in `src/lib/longevity/motore/`. Curve e pesi si leggono dal registro nel database, non da costanti nel codice. Il tipo di ritorno rende impossibile leggere il valore di un punteggio dichiarato insufficiente. Un oracolo Python versionato genera i casi di riferimento contro cui il porting si confronta.
+
+**Tech Stack:** TypeScript, vitest, `python3` (solo per generare il riferimento). Nessuna dipendenza npm nuova.
+
+**Spec:** `docs/specs/2026-08-21-longevity-design.md`
+
+**Piano precedente, già eseguito:** `docs/plans/2026-08-21-longevity-strato-dati.md` — lo strato dati è costruito (ramo `feat/longevity`, 20 commit).
+
+## Global Constraints
+
+- Branch **`feat/longevity`**. `main` non si tocca, non si deploya, non si pusha senza che Adriano lo chieda.
+- Nessuna dipendenza npm nuova.
+- Test in `tests/longevity/`, eseguiti con `npm test`, che usano `':memory:'`.
+- Codice e commenti in italiano.
+- Soglia di copertura: **0.40**, la costante `COPERTURA_MINIMA` già esportata da `src/lib/longevity/db.ts`. Mai un numero scritto a mano nei rami.
+- `MODEL_VERSION` iniziale: **`v1.0`**.
+- **Nessun dato reale di persone** nelle fixture: i casi di prova sono sintetici.
+- ⚠️ **La suite parte con un rosso che non è nostro:** `tests/modifiche-agosto.test.ts` fallisce da prima (test del sito disallineato su `main`, fuori perimetro). L'atteso è **1 fallito pre-esistente**, il resto verde. Non ripararlo.
+
+## Il principio che regge tutto il piano
+
+Il porting delle curve è la parte più pericolosa dell'intera piattaforma, e il pericolo non è il codice che non compila: è **un coefficiente trascritto male**. Produce un punteggio sanitario sbagliato che sembra plausibile, che nessun test funzionale intercetta, e che diventa il valore "atteso" di tutto ciò che gli sta sopra.
+
+Quindi la fedeltà **non è garantita dalla trascrizione**, ma dal confronto numerico con l'originale. L'oracolo (`tests/longevity/riferimento/isl_scoring_engine.py`, scritto dal cliente) genera i valori attesi su una griglia fitta di ingressi; il test TypeScript li rilegge e confronta. Un implementatore che sbagli una cifra se ne accorge subito, non fra sei mesi.
+
+⚠️ **Corollario:** nessun task di questo piano è "finito" perché i suoi test passano. È finito quando il **confronto con l'oracolo** passa sulle funzioni che tocca.
+
+## Struttura dei file
+
+| File | Responsabilità |
+|---|---|
+| `tests/longevity/riferimento/isl_scoring_engine.py` | l'oracolo (già presente, del cliente, non si modifica) |
+| `tests/longevity/riferimento/genera-riferimento.py` | esegue l'oracolo su una griglia e scrive `riferimento.json` |
+| `src/lib/longevity/motore/curve.ts` | le cinque curve del questionario + le utility |
+| `src/lib/longevity/motore/test-fisici.ts` | le curve dei test misurati in sala e dagli strumenti |
+| `src/lib/longevity/motore/cascata.ts` | aggregazione, assi, macro-score, Fitness Age |
+| `src/lib/longevity/motore/index.ts` | la funzione che calcola una sessione leggendo dal registro |
+
+---
+
+### Task 1: L'oracolo genera il riferimento
+
+Prima di portare una sola curva, serve il metro di paragone.
+
+**Files:**
+- Create: `tests/longevity/riferimento/genera-riferimento.py`
+- Create (generato): `tests/longevity/riferimento/riferimento.json`
+- Test: nessuno — è uno strumento; lo verificano i task seguenti
+
+**Interfaces:**
+- Consumes: `tests/longevity/riferimento/isl_scoring_engine.py`
+- Produces: `riferimento.json`, con questa forma esatta:
+
+```json
+{
+  "generato_da": "isl_scoring_engine.py",
+  "casi": [
+    { "fn": "score_plank", "args": [110, "M"], "atteso": 62.5 },
+    { "fn": "score_bell_curve", "args": [7.5, 4, 7, 9, 12], "atteso": 100 }
+  ]
+}
+```
+
+- [ ] **Step 1: Scrivi il generatore**
+
+⚠️ **Questo passo è già stato eseguito.** La griglia definitiva vive in
+`tests/longevity/riferimento/genera-riferimento.py`, committata e verificata: rieseguirla
+riproduce `riferimento.json` byte per byte (4018 casi, 25 funzioni, nessuna eccezione).
+
+Qui **non** ne teniamo una seconda copia, e la ragione è un incidente vero: quando il piano
+conteneva anche il codice, piano e script sono divergiti — il file di riferimento è rimasto
+per un momento non riproducibile dal proprio generatore, che per un oracolo è il difetto
+peggiore possibile. Due copie della stessa cosa si separano sempre; il codice sta nel repo,
+il piano dice cosa deve fare e perché.
+
+**Cosa la griglia copre**, che è ciò che va verificato se un domani si tocca:
+
+- le curve del questionario su **tutto** il dominio, non su un campione, comprese le due
+  coppie di parametri di `score_decreasing` — quella normale e quella dell'alcol (7→14);
+- `score_increasing_plateau` con `worst` **diverso da zero**: zero è il caso degenere in
+  cui un errore sull'offset resterebbe invisibile;
+- `vo2max_from_2km_walk` variando **un parametro alla volta** dal caso base, così una
+  divergenza dice anche quale dei cinque coefficienti è sbagliato;
+- i confini di banda **esatti** delle funzioni a bande (composizione, pressione, plank,
+  flamingo, SpO2), che una griglia a passo regolare salterebbe;
+- le tre tabelle dei sollevamenti sul rapporto col peso corporeo, per entrambi i sessi.
+
+- [ ] **Step 2: Eseguilo e guarda l'esito**
+
+Run: `python3 tests/longevity/riferimento/genera-riferimento.py`
+Expected: stampa il numero di casi (nell'ordine delle migliaia) e scrive il file.
+
+⚠️ Se una chiamata solleva un'eccezione, **non aggirarla**: significa che l'oracolo ha un dominio più stretto di quanto la griglia assume. Restringi la griglia per quella funzione e **annota nel rapporto quale dominio hai dovuto escludere** — è un'informazione che serve a chi userà il motore.
+
+- [ ] **Step 3: Verifica che il file sia sensato**
+
+Run: `python3 -c "import json;d=json.load(open('tests/longevity/riferimento/riferimento.json'));print(len(d['casi']),'casi');print(sorted({c['fn'] for c in d['casi']}))"`
+Expected: l'elenco delle funzioni coperte, senza buchi rispetto alla griglia sopra.
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add tests/longevity/riferimento/
+git commit -m "longevity: l'oracolo del motore e la griglia di riferimento"
+```
+
+---
+
+### Task 2: Le cinque curve del questionario
+
+**Files:**
+- Create: `src/lib/longevity/motore/curve.ts`
+- Test: `tests/longevity/motore-curve.test.ts`
+
+**Interfaces:**
+- Consumes: `riferimento.json` (Task 1)
+- Produces:
+  - `clamp(x: number, lo?: number, hi?: number): number`
+  - `lerp(x: number, x0: number, x1: number, y0: number, y1: number): number`
+  - `curvaCampana(v: number, low: number, peakLow: number, peakHigh: number, high: number): number`
+  - `curvaDecrescente(v: number, best: number, worst: number): number`
+  - `curvaCrescenteConPlateau(v: number, worst: number, plateauStart: number): number`
+  - `curvaDirettaX10(v: number): number`
+  - `curvaDirettaX10Invertita(v: number): number`
+  - `curvaGradini(v: number, steps: [number, number][], zeroVal: number | undefined, decrescente: boolean): number`
+
+- [ ] **Step 1: Write the failing test**
+
+```ts
+// tests/longevity/motore-curve.test.ts
+import { describe, it, expect } from 'vitest';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import {
+  clamp, lerp, curvaCampana, curvaDecrescente, curvaCrescenteConPlateau,
+  curvaDirettaX10, curvaDirettaX10Invertita, curvaGradini,
+} from '../../src/lib/longevity/motore/curve';
+
+const RIF = JSON.parse(
+  readFileSync(join(process.cwd(), 'tests/longevity/riferimento/riferimento.json'), 'utf8')
+) as { casi: { fn: string; args: unknown[]; atteso: number }[] };
+
+const casiDi = (fn: string) => RIF.casi.filter((c) => c.fn === fn);
+
+describe('curve del questionario, confrontate con l oracolo', () => {
+  it('la campana combacia su tutto il dominio', () => {
+    const casi = casiDi('score_bell_curve');
+    expect(casi.length).toBeGreaterThan(20);
+    for (const c of casi) {
+      const [v, low, pl, ph, high] = c.args as number[];
+      expect(curvaCampana(v, low, pl, ph, high)).toBeCloseTo(c.atteso, 1);
+    }
+  });
+
+  it('la decrescente combacia, inclusa la soglia 7-14 dell alcol', () => {
+    const casi = casiDi('score_decreasing');
+    expect(casi.length).toBeGreaterThan(40);
+    for (const c of casi) {
+      const [v, best, worst] = c.args as number[];
+      expect(curvaDecrescente(v, best, worst)).toBeCloseTo(c.atteso, 1);
+    }
+  });
+
+  it('la crescente con plateau combacia', () => {
+    for (const c of casiDi('score_increasing_plateau')) {
+      const [v, worst, plateau] = c.args as number[];
+      expect(curvaCrescenteConPlateau(v, worst, plateau)).toBeCloseTo(c.atteso, 1);
+    }
+  });
+
+  it('la diretta per dieci combacia', () => {
+    for (const c of casiDi('score_direct_x10')) {
+      expect(curvaDirettaX10((c.args as number[])[0])).toBeCloseTo(c.atteso, 1);
+    }
+  });
+
+  // Questa curva NON esiste nell'oracolo: è la quinta, che al motore del cliente manca.
+  // Serve a q_calo_pomeridiano e nel prototipo HTML è `scale10_inv`: (10 - v) * 10.
+  it('la diretta invertita e il complemento della diretta', () => {
+    for (const v of [0, 2.5, 5, 7.5, 10]) {
+      expect(curvaDirettaX10Invertita(v)).toBeCloseTo(curvaDirettaX10(10 - v), 6);
+    }
+    expect(curvaDirettaX10Invertita(0)).toBe(100);
+    expect(curvaDirettaX10Invertita(10)).toBe(0);
+  });
+
+  it('i gradini decrescenti riproducono il prototipo: q_sigarette', () => {
+    const steps: [number, number][] = [[0, 100], [5, 60], [10, 40], [20, 20], [999, 0]];
+    expect(curvaGradini(0, steps, undefined, true)).toBe(100);
+    expect(curvaGradini(5, steps, undefined, true)).toBe(60);
+    expect(curvaGradini(10, steps, undefined, true)).toBe(40);
+    expect(curvaGradini(20, steps, undefined, true)).toBe(20);
+    expect(curvaGradini(40, steps, undefined, true)).toBeLessThan(20);
+  });
+
+  it('zeroVal ha la precedenza sui gradini: q_schermi a zero vale 100', () => {
+    const steps: [number, number][] = [[15, 85], [30, 70], [60, 40], [999, 10]];
+    expect(curvaGradini(0, steps, 100, true)).toBe(100);
+    expect(curvaGradini(15, steps, 100, true)).toBe(85);
+  });
+
+  it('clamp e lerp si comportano come nell oracolo', () => {
+    expect(clamp(150)).toBe(100);
+    expect(clamp(-5)).toBe(0);
+    expect(lerp(5, 0, 10, 0, 100)).toBe(50);
+    expect(lerp(-1, 0, 10, 0, 100)).toBe(0);   // t viene limitato a [0,1]
+    expect(lerp(11, 0, 10, 0, 100)).toBe(100);
+  });
+});
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `npm test -- tests/longevity/motore-curve.test.ts`
+Expected: FAIL — modulo `motore/curve` non trovato
+
+- [ ] **Step 3: Write minimal implementation**
+
+Porta le funzioni dall'oracolo `tests/longevity/riferimento/isl_scoring_engine.py`, sezione «Questionario: curve generiche» più `clamp` e `_lerp` in cima al file. Nomi italiani come da interfacce sopra.
+
+Due avvertenze che l'oracolo non dichiara e che i test qui sopra pretendono:
+
+- **`_lerp` limita `t` all'intervallo [0,1]**, quindi le curve non escono mai oltre gli estremi: è il motivo per cui `curvaDecrescente(0, 7, 14)` vale 100 e non di più. È esattamente ciò che rende voluta la soglia dell'alcol.
+- **`curvaGradini` non è nell'oracolo**: è la logica `decstep`/`incstep` del prototipo HTML del cliente. Se il valore è zero ed esiste `zeroVal`, vince quello; altrimenti si interpola fra i gradini, partendo da `(0, 100)` per le decrescenti e `(0, 20)` per le crescenti.
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `npm test -- tests/longevity/motore-curve.test.ts`
+Expected: PASS, 8 test
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/lib/longevity/motore/curve.ts tests/longevity/motore-curve.test.ts
+git commit -m "longevity: le cinque curve del questionario, verificate contro l oracolo"
+```
+
+---
+
+### Task 3: Le curve dei test fisici
+
+**Files:**
+- Create: `src/lib/longevity/motore/test-fisici.ts`
+- Test: `tests/longevity/motore-fisici.test.ts`
+
+**Interfaces:**
+- Consumes: `clamp`, `lerp` da `motore/curve` (Task 2); `riferimento.json` (Task 1)
+- Produces, con questi nomi esatti (l'ordine dei parametri è quello dell'oracolo):
+  - `scoreGrassoPercento(fatPct: number, sesso: Sesso): number`
+  - `scoreMuscoloPercento(musclePct: number, sesso: Sesso): number`
+  - `scoreWhr(whr: number, sesso: Sesso): number`
+  - `scoreVo2max(vo2max: number, eta: number, sesso: Sesso): number`
+  - `scoreSpo2(spo2: number): number`
+  - `scorePressione(sistolica: number, diastolica: number): number`
+  - `scoreRecuperoCardiaco(caloBpm1min: number): number`
+  - `scoreHandgrip(kg: number, eta: number, sesso: Sesso): number`
+  - `scorePushup(reps: number, eta: number, sesso: Sesso): number`
+  - `scoreSollevamentoSuPeso(caricoKg, pesoKg, rip, tiersM, tiersF, sesso): number`
+  - `scoreTrazioneIsometrica(sec: number, sesso: Sesso): number`
+  - `scoreSitToStand(reps: number, eta: number, sesso: Sesso, bmi?: number): number`
+  - `scorePlank(sec: number, sesso: Sesso): number`
+  - `scoreBackScratch(cm: number, eta: number, sesso: Sesso): number`
+  - `scoreMobilitaSpalla(outreachDeg: number, bucklingDeg: number): number`
+  - `scoreFlamingo(cadute: number): number`
+  - `scoreSitAndReach(cm: number, sesso: Sesso): number`
+  - `vo2maxDaStepTest`, `vo2maxDa2kmWalk`, `vo2maxDaMutt`, `vo2maxDaMilfit`
+  - `type Sesso = 'M' | 'F'`
+  - le sei tabelle: `TIERS_BENCH_M`, `TIERS_BENCH_F`, `TIERS_SQUAT_M`, `TIERS_SQUAT_F`, `TIERS_ROW_M`, `TIERS_ROW_F`
+
+⚠️ **Due funzioni dell'oracolo NON vanno portate**, e non è una dimenticanza:
+- `score_agility_ms` — l'agilità è stata **rimossa dallo score** dal cliente il 13/08: 548 ms reali contro i 250 attesi davano 20/100, falsi, per una scala non comparabile fra protocolli. Nel motore la funzione è rimasta ma nessun peso la richiama.
+- `score_generic_range_local` — definita in fondo al file e mai chiamata.
+
+Portarle significherebbe riportare in vita una misura che il cliente ha escluso.
+
+- [ ] **Step 1: Write the failing test**
+
+```ts
+// tests/longevity/motore-fisici.test.ts
+import { describe, it, expect } from 'vitest';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import * as F from '../../src/lib/longevity/motore/test-fisici';
+
+const RIF = JSON.parse(
+  readFileSync(join(process.cwd(), 'tests/longevity/riferimento/riferimento.json'), 'utf8')
+) as { casi: { fn: string; args: unknown[]; atteso: number }[] };
+
+/** Ogni funzione dell'oracolo con la sua gemella in TypeScript. */
+const COPPIE: [string, (...a: never[]) => number][] = [
+  ['score_fat_percent', F.scoreGrassoPercento as never],
+  ['score_muscle_percent', F.scoreMuscoloPercento as never],
+  ['score_whr', F.scoreWhr as never],
+  ['score_vo2max', F.scoreVo2max as never],
+  ['score_spo2', F.scoreSpo2 as never],
+  ['score_blood_pressure', F.scorePressione as never],
+  ['score_hrr', F.scoreRecuperoCardiaco as never],
+  ['score_handgrip', F.scoreHandgrip as never],
+  ['score_pushup', F.scorePushup as never],
+  ['score_flexed_arm_hang', F.scoreTrazioneIsometrica as never],
+  ['score_sit_to_stand_1min', F.scoreSitToStand as never],
+  ['score_plank', F.scorePlank as never],
+  ['score_back_scratch', F.scoreBackScratch as never],
+  ['score_shoulder_mobility_wt', F.scoreMobilitaSpalla as never],
+  ['score_flamingo', F.scoreFlamingo as never],
+  ['score_sit_and_reach', F.scoreSitAndReach as never],
+  ['vo2max_from_step_test', F.vo2maxDaStepTest as never],
+  ['vo2max_from_2km_walk', F.vo2maxDa2kmWalk as never],
+  ['vo2max_from_mutt', F.vo2maxDaMutt as never],
+  ['vo2max_from_milfit', F.vo2maxDaMilfit as never],
+];
+
+describe('curve dei test fisici, confrontate con l oracolo caso per caso', () => {
+  for (const [nomePython, fnTs] of COPPIE) {
+    it(`${nomePython} combacia su tutti i casi del riferimento`, () => {
+      const casi = RIF.casi.filter((c) => c.fn === nomePython);
+      expect(casi.length, `nessun caso per ${nomePython}: la griglia non lo copre`).toBeGreaterThan(0);
+      const divergenti: string[] = [];
+      for (const c of casi) {
+        const ottenuto = (fnTs as (...a: unknown[]) => number)(...c.args);
+        if (Math.abs(ottenuto - c.atteso) > 0.05) {
+          divergenti.push(`${nomePython}(${c.args.join(', ')}): atteso ${c.atteso}, ottenuto ${ottenuto}`);
+        }
+      }
+      expect(divergenti.slice(0, 5).join('\n')).toBe('');
+    });
+  }
+
+  it('i sollevamenti sul peso corporeo combaciano su tutte e tre le tabelle', () => {
+    const casi = RIF.casi.filter((c) => c.fn === 'score_bw_ratio_lift');
+    expect(casi.length).toBeGreaterThan(50);
+    const perTabella = (nome: string) =>
+      ({ bench: [F.TIERS_BENCH_M, F.TIERS_BENCH_F], squat: [F.TIERS_SQUAT_M, F.TIERS_SQUAT_F],
+         row: [F.TIERS_ROW_M, F.TIERS_ROW_F] } as Record<string, unknown[]>)[nome];
+    for (const c of casi) {
+      const [carico, peso, rip, tiersM, tiersF, sesso] = c.args as [number, number, number, unknown, unknown, 'M' | 'F'];
+      const ottenuto = F.scoreSollevamentoSuPeso(
+        carico, peso, rip,
+        tiersM as [number, number][], tiersF as [number, number][], sesso
+      );
+      expect(ottenuto, `carico ${carico} ${sesso}`).toBeCloseTo(c.atteso, 1);
+    }
+    expect(perTabella('bench')).toBeTruthy();
+  });
+
+  it('l agilita NON e stata portata: il cliente l ha esclusa dallo score', () => {
+    expect((F as Record<string, unknown>).scoreAgilita).toBeUndefined();
+    expect((F as Record<string, unknown>).scoreAgilityMs).toBeUndefined();
+  });
+});
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `npm test -- tests/longevity/motore-fisici.test.ts`
+Expected: FAIL — modulo `motore/test-fisici` non trovato
+
+- [ ] **Step 3: Write minimal implementation**
+
+Porta le funzioni dall'oracolo, una per una, mantenendo **identici** i coefficienti, le tabelle di ancoraggio e l'ordine dei confronti. Le trovi nelle sezioni «Composizione Corporea», «Cardio-Respiratorio», «Recupero & Sistema Nervoso», «Forza & Struttura» e «Stabilità & Mobilità».
+
+⚠️ **Non "sistemare" nulla mentre porti**, nemmeno ciò che sembra un difetto: se una funzione ha un ramo irraggiungibile o un valore di ripiego che pare arbitrario, va riprodotto tale e quale. L'oracolo è la definizione, non una proposta — e il confronto numerico ti dirà subito se hai cambiato qualcosa.
+
+⚠️ **Attenzione a `score_handgrip`**: usa un ciclo con `break` e un ramo `else` del `for` (costrutto che in TypeScript non esiste). Riproduci il comportamento: se l'età non cade in nessun intervallo fra le ancore, vale il valore dell'ultima.
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `npm test -- tests/longevity/motore-fisici.test.ts`
+Expected: PASS, 22 test
+
+Se un test elenca divergenze, il messaggio ti dà ingressi, atteso e ottenuto: **correggi la tua funzione**, non il riferimento.
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/lib/longevity/motore/test-fisici.ts tests/longevity/motore-fisici.test.ts
+git commit -m "longevity: le curve dei test fisici, verificate contro l oracolo"
+```
+
+---
+
+### Task 4: La cascata, e il tipo che impedisce di mostrare un numero che non c'è
+
+**Files:**
+- Create: `src/lib/longevity/motore/cascata.ts`
+- Test: `tests/longevity/motore-cascata.test.ts`
+
+**Interfaces:**
+- Consumes: `COPERTURA_MINIMA` da `src/lib/longevity/db.ts`
+- Produces:
+  - `type Punteggio = { stato: 'ok'; valore: number; copertura: number } | { stato: 'insufficiente'; copertura: number }`
+  - `type VocePesata = { punteggio: number | null; peso: number }`
+  - `aggrega(voci: VocePesata[]): Punteggio`
+  - `calcolaAsse(pesi: Record<string, number>, punteggi: Record<string, number | null>): Punteggio`
+  - `calcolaMacro(pesiMacro: Record<string, number>, assi: Record<string, Punteggio>): Punteggio`
+  - `calcolaFitnessAge(etaAnagrafica: number, pesi: Record<string, number>, voci: Record<string, number | null>): { fitnessAge: number | null; composito: Punteggio }`
+
+- [ ] **Step 1: Write the failing test**
+
+```ts
+// tests/longevity/motore-cascata.test.ts
+import { describe, it, expect } from 'vitest';
+import { COPERTURA_MINIMA } from '../../src/lib/longevity/db';
+import { aggrega, calcolaAsse, calcolaMacro, calcolaFitnessAge } from '../../src/lib/longevity/motore/cascata';
+
+describe('aggregazione e rinormalizzazione', () => {
+  it('con tutti i dati fa la media pesata', () => {
+    const r = aggrega([{ punteggio: 80, peso: 0.5 }, { punteggio: 60, peso: 0.5 }]);
+    expect(r.stato).toBe('ok');
+    if (r.stato === 'ok') { expect(r.valore).toBeCloseTo(70, 1); expect(r.copertura).toBe(1); }
+  });
+
+  it('un dato mancante ridistribuisce il suo peso, non vale zero', () => {
+    const r = aggrega([{ punteggio: 80, peso: 0.5 }, { punteggio: null, peso: 0.25 }, { punteggio: 60, peso: 0.25 }]);
+    expect(r.stato).toBe('ok');
+    // 80*0.5 + 60*0.25 = 55, su peso disponibile 0.75 -> 73.3, non 55
+    if (r.stato === 'ok') { expect(r.valore).toBeCloseTo(73.3, 1); expect(r.copertura).toBeCloseTo(0.75, 2); }
+  });
+
+  it('sotto la soglia di copertura NON esiste un valore da leggere', () => {
+    const r = aggrega([{ punteggio: 90, peso: 0.2 }, { punteggio: null, peso: 0.8 }]);
+    expect(r.stato).toBe('insufficiente');
+    expect(r.copertura).toBeCloseTo(0.2, 2);
+    // il punto dell'intero tipo: chi consuma non ha il campo da cui prendere il numero
+    expect((r as { valore?: number }).valore).toBeUndefined();
+  });
+
+  it('la soglia e quella dichiarata una volta sola, non un numero sparso', () => {
+    const pocoSotto = aggrega([{ punteggio: 90, peso: COPERTURA_MINIMA - 0.01 }, { punteggio: null, peso: 1 - COPERTURA_MINIMA + 0.01 }]);
+    const esatto = aggrega([{ punteggio: 90, peso: COPERTURA_MINIMA }, { punteggio: null, peso: 1 - COPERTURA_MINIMA }]);
+    expect(pocoSotto.stato).toBe('insufficiente');
+    expect(esatto.stato).toBe('ok');   // la soglia e inclusiva, come nell'oracolo
+  });
+
+  it('senza nessun dato e insufficiente con copertura zero', () => {
+    const r = aggrega([{ punteggio: null, peso: 1 }]);
+    expect(r.stato).toBe('insufficiente');
+    expect(r.copertura).toBe(0);
+  });
+});
+
+describe('assi, macro e Fitness Age', () => {
+  const PESI_FORZA = { handgrip: 0.25, spinta: 0.2, trazione: 0.2, arti_inferiori: 0.2, core: 0.15 };
+
+  it('un asse si calcola sui suoi sotto-domini', () => {
+    const r = calcolaAsse(PESI_FORZA, { handgrip: 70, spinta: 60, trazione: 65, arti_inferiori: 80, core: 50 });
+    expect(r.stato).toBe('ok');
+    if (r.stato === 'ok') expect(r.valore).toBeCloseTo(66.25, 1);
+  });
+
+  it('un asse insufficiente NON entra nel macro-score, invece di entrarci come zero', () => {
+    const assi = {
+      A: { stato: 'ok', valore: 80, copertura: 1 } as const,
+      B: { stato: 'insufficiente', copertura: 0.1 } as const,
+    };
+    const r = calcolaMacro({ A: 0.5, B: 0.5 }, assi);
+    expect(r.stato).toBe('ok');
+    // se B entrasse come zero il risultato sarebbe 40: la rinormalizzazione lo esclude
+    if (r.stato === 'ok') { expect(r.valore).toBeCloseTo(80, 1); expect(r.copertura).toBeCloseTo(0.5, 2); }
+  });
+
+  it('la Fitness Age scende sotto l eta quando il composito supera 50', () => {
+    const pesi = { cardio: 0.3, handgrip_isolato: 0.2, hrv_isolato: 0.2, forza_resto: 0.15, composizione: 0.1, stabilita: 0.05 };
+    const r = calcolaFitnessAge(40, pesi, { cardio: 75, handgrip_isolato: 75, hrv_isolato: 75, forza_resto: 75, composizione: 75, stabilita: 75 });
+    // 40 - (75 - 50) * 0.4 = 30
+    expect(r.fitnessAge).toBeCloseTo(30, 1);
+  });
+
+  it('senza dati sufficienti la Fitness Age non esiste', () => {
+    const pesi = { cardio: 0.3, handgrip_isolato: 0.2, hrv_isolato: 0.2, forza_resto: 0.15, composizione: 0.1, stabilita: 0.05 };
+    const r = calcolaFitnessAge(40, pesi, { cardio: 75, handgrip_isolato: null, hrv_isolato: null, forza_resto: null, composizione: null, stabilita: null });
+    expect(r.composito.stato).toBe('insufficiente');
+    expect(r.fitnessAge).toBeNull();
+  });
+});
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `npm test -- tests/longevity/motore-cascata.test.ts`
+Expected: FAIL — modulo `motore/cascata` non trovato
+
+- [ ] **Step 3: Write minimal implementation**
+
+Porta `aggregate`, `compute_axis`, `compute_macro_scores` e `compute_fitness_age` dall'oracolo, **con una differenza deliberata**:
+
+⚠️ Nell'oracolo `aggregate()` restituisce il punteggio pieno **anche quando lo dichiara insufficiente** — la docstring dice il contrario di ciò che il codice fa. È una trappola: chi consuma deve ricordarsi di guardare lo stato, e prima o poi qualcuno non lo fa. Qui il tipo `Punteggio` la chiude: nel ramo `insufficiente` **il campo `valore` non esiste**, quindi la regola di prodotto — *«tratteggiato, mai un numero pieno fasullo»* — diventa impossibile da violare per distrazione.
+
+Il resto va riprodotto fedelmente: la soglia è **inclusiva** (`copertura < MINIMA` è insufficiente, quindi esattamente 0.40 è ok), i pesi si rinormalizzano su quelli disponibili, la Fitness Age è `eta - (composito - 50) * 0.4`.
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `npm test -- tests/longevity/motore-cascata.test.ts`
+Expected: PASS, 10 test
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/lib/longevity/motore/cascata.ts tests/longevity/motore-cascata.test.ts
+git commit -m "longevity: la cascata a quattro livelli, con il tipo che chiude la trappola dell insufficiente"
+```
+
+---
+
+### Task 5: Il motore legge dal registro, non da costanti
+
+È il task che collega il motore allo strato dati: curve, parametri e pesi vengono dal database, così aggiungere o togliere un test resta una modifica ai dati.
+
+**Files:**
+- Create: `src/lib/longevity/motore/index.ts`
+- Modify: `src/lib/longevity/registro.ts` — aggiungere `MODEL_VERSION` e `pesiDi`
+- Test: `tests/longevity/motore.test.ts`
+
+**Interfaces:**
+- Consumes: tutto quanto sopra, più `createLongevityDb`, `seedRegistro`, `seedPesi`, `apriSessione`, `registraMisure`
+- Produces:
+  - `MODEL_VERSION: string` (`'v1.0'`, esportata da `registro.ts`)
+  - `pesiDi(db, modelVersion, livello, contenitore): Record<string, number>` in `registro.ts`
+  - `applicaCurva(voce: VoceRegistro, valore: number): number | null` — normalizza un valore grezzo secondo la curva dichiarata nel registro
+  - `calcolaSessione(db, sessioneId): { assi, macro, fitnessAge, modelVersion, questVersion }`
+  - `salvaScore(db, sessioneId, risultato): void` — congela i punteggi nella tabella `score`
+
+- [ ] **Step 1: Write the failing test**
+
+```ts
+// tests/longevity/motore.test.ts
+import { describe, it, expect } from 'vitest';
+import { createLongevityDb } from '../../src/lib/longevity/db';
+import { seedRegistro, seedPesi, MODEL_VERSION, pesiDi } from '../../src/lib/longevity/registro';
+import { salvaCompilazione } from '../../src/lib/longevity/questionario';
+import { applicaCurva, calcolaSessione, salvaScore } from '../../src/lib/longevity/motore';
+
+function dbPronto() {
+  const db = createLongevityDb(':memory:');
+  seedRegistro(db);
+  seedPesi(db, MODEL_VERSION);
+  db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0001','F')`).run();
+  return db;
+}
+
+const voce = (db: ReturnType<typeof dbPronto>, id: string) =>
+  db.prepare(`SELECT * FROM registro_test WHERE test_id = ?`).get(id) as Record<string, unknown>;
+
+describe('il motore legge le curve dal registro', () => {
+  it('applica la curva dichiarata per il test, non una scritta nel codice', () => {
+    const db = dbPronto();
+    const v = { ...voce(db, 'q_ore_sonno'), params: JSON.parse(voce(db, 'q_ore_sonno').params as string) };
+    expect(applicaCurva(v as never, 8)).toBe(100);    // dentro il picco 7-9
+    expect(applicaCurva(v as never, 4)).toBeLessThan(20);
+  });
+
+  it('rispetta la soglia dell alcol come e scritta nel registro', () => {
+    const db = dbPronto();
+    const v = { ...voce(db, 'q_alcol_life'), params: JSON.parse(voce(db, 'q_alcol_life').params as string) };
+    expect(applicaCurva(v as never, 0)).toBe(100);
+    expect(applicaCurva(v as never, 7)).toBe(100);
+    expect(applicaCurva(v as never, 14)).toBe(0);
+  });
+
+  it('cambiare i parametri nel registro cambia il punteggio, senza toccare il codice', () => {
+    const db = dbPronto();
+    db.prepare(`UPDATE registro_test SET params = ? WHERE test_id = 'q_alcol_life'`)
+      .run(JSON.stringify({ best: 0, worst: 7 }));
+    const v = { ...voce(db, 'q_alcol_life'), params: JSON.parse(voce(db, 'q_alcol_life').params as string) };
+    expect(applicaCurva(v as never, 7)).toBe(0);   // con i parametri nuovi, 7 non vale piu 100
+  });
+
+  it('un test disattivato non entra nel calcolo', () => {
+    const db = dbPronto();
+    salvaCompilazione(db, {
+      client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+      risposte: { q_ore_sonno: 8, q_riposato: 8, q_min_addorm: 10, q_risvegli: 0, q_caffeina: 0, q_sonnolenza_diurna: 0 },
+    });
+    const prima = calcolaSessione(db, 1);
+    db.prepare(`UPDATE registro_test SET attivo_a = '2026-01-01' WHERE test_id = 'q_ore_sonno'`).run();
+    const dopo = calcolaSessione(db, 1);
+    expect(JSON.stringify(prima)).not.toBe(JSON.stringify(dopo));
+  });
+});
+
+describe('calcolo e congelamento di una sessione', () => {
+  it('produce i sette assi, e quelli senza dati sono insufficienti', () => {
+    const db = dbPronto();
+    salvaCompilazione(db, {
+      client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+      risposte: { q_ore_sonno: 8, q_riposato: 8, q_min_addorm: 10, q_risvegli: 0, q_caffeina: 0, q_sonnolenza_diurna: 1 },
+    });
+    const r = calcolaSessione(db, 1);
+    expect(Object.keys(r.assi).length).toBe(7);
+    // il questionario copre il sonno, che pesa 0.20 dentro Recupero: sotto il 40%
+    expect(r.assi['Recupero & Sistema Nervoso'].stato).toBe('insufficiente');
+    // Stile di Vita e coperto al 100% dal solo questionario, ma qui non abbiamo risposto
+    expect(r.assi['Forza & Struttura'].stato).toBe('insufficiente');
+  });
+
+  it('congela i punteggi con le DUE versioni', () => {
+    const db = dbPronto();
+    salvaCompilazione(db, {
+      client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+      risposte: { q_riposato: 7 },
+    });
+    salvaScore(db, 1, calcolaSessione(db, 1));
+    const righe = db.prepare(`SELECT tipo, elemento, valore, stato, quest_version, model_version FROM score`).all() as Record<string, unknown>[];
+    expect(righe.length).toBeGreaterThan(0);
+    for (const r of righe) {
+      expect(r.model_version).toBe(MODEL_VERSION);
+      expect(r.quest_version).toBe('v1.0');
+      if (r.stato === 'insufficiente') expect(r.valore).toBeNull();
+    }
+  });
+
+  it('i pesi arrivano dal registro e sono quelli della versione richiesta', () => {
+    const db = dbPronto();
+    const pesi = pesiDi(db, MODEL_VERSION, 'asse', 'Forza & Struttura');
+    expect(pesi.handgrip).toBe(0.25);
+    expect(Object.values(pesi).reduce((a, b) => a + b, 0)).toBeCloseTo(1, 6);
+  });
+});
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `npm test -- tests/longevity/motore.test.ts`
+Expected: FAIL — modulo `motore` non trovato
+
+- [ ] **Step 3: Write minimal implementation**
+
+In `registro.ts` aggiungi:
+
+```ts
+/** Versione del modello di calcolo: curve e pesi. Distinta da QUEST_VERSION, che versiona le domande. */
+export const MODEL_VERSION = 'v1.0';
+
+export function pesiDi(
+  db: Database.Database, modelVersion: string,
+  livello: 'asse' | 'macro' | 'fitness_age', contenitore: string
+): Record<string, number> {
+  const righe = db.prepare(
+    `SELECT elemento, peso FROM pesi WHERE model_version = ? AND livello = ? AND contenitore = ?`
+  ).all(modelVersion, livello, contenitore) as { elemento: string; peso: number }[];
+  return Object.fromEntries(righe.map((r) => [r.elemento, r.peso]));
+}
+```
+
+In `motore/index.ts`: `applicaCurva` smista sulla curva dichiarata nel registro e passa i parametri letti da lì; `calcolaSessione` legge le misure attive della sessione, le normalizza, raggruppa per sotto-dominio (facendo la **media** dei test dello stesso sotto-dominio), calcola i sette assi, i tre macro e la Fitness Age; `salvaScore` scrive in `score` una riga per asse, macro e Fitness Age, con `valore` a `null` quando lo stato è insufficiente.
+
+⚠️ **La copertura si calcola sui pesi, non sul numero di test.** Un sotto-dominio senza nessuna misura è `null` e il suo peso si ridistribuisce; è la regola dell'oracolo e vale a ogni livello.
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `npm test`
+Expected: PASS su tutta la suite nuova; atteso il solo rosso pre-esistente.
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/lib/longevity/motore/index.ts src/lib/longevity/registro.ts tests/longevity/motore.test.ts
+git commit -m "longevity: il motore legge curve e pesi dal registro, e congela i punteggi"
+```
+
+---
+
+### Task 6: La prova sul caso reale documentato
+
+L'ultimo controllo non è sulle funzioni: è sul fatto che l'insieme produca i numeri che il cliente ha già visto.
+
+**Files:**
+- Test: `tests/longevity/motore-caso-reale.test.ts`
+
+**Interfaces:**
+- Consumes: tutto il motore
+
+⚠️ **I dati di Donata e Nicola non entrano nelle fixture** — sono dati sanitari di due persone identificabili, e le fixture stanno in git. Il caso qui sotto è **sintetico**, costruito per esercitare le stesse condizioni descritte nella documentazione: un profilo con composizione corporea completa e tutto il resto mancante.
+
+- [ ] **Step 1: Write the failing test**
+
+```ts
+// tests/longevity/motore-caso-reale.test.ts
+import { describe, it, expect } from 'vitest';
+import { createLongevityDb } from '../../src/lib/longevity/db';
+import { seedRegistro, seedPesi, MODEL_VERSION } from '../../src/lib/longevity/registro';
+import { apriSessione, registraMisure } from '../../src/lib/longevity/misure';
+import { calcolaSessione } from '../../src/lib/longevity/motore';
+
+/**
+ * Riproduce la situazione descritta nella documentazione del cliente: una persona di cui
+ * si conosce solo la composizione corporea, misurata dalla Wellness Tower. Un asse pieno,
+ * tutti gli altri scoperti. È il caso in cui un motore ingenuo mostrerebbe sei zeri.
+ * Dati sintetici: nessuna persona reale.
+ */
+describe('un profilo con una sola area misurata', () => {
+  it('mostra l asse coperto e dichiara insufficienti gli altri sei', () => {
+    const db = createLongevityDb(':memory:');
+    seedRegistro(db);
+    seedPesi(db, MODEL_VERSION);
+    db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0001','M')`).run();
+
+    // i tre test di composizione esistono nel registro solo dopo il piano degli import:
+    // finche non ci sono, questo test dimostra il comportamento con zero misure fisiche
+    const s = apriSessione(db, { client_code: 'ISL-0001', data: '2026-08-22', tipo: 'checkup', eta_alla_data: 38 });
+    registraMisure(db, s, 'questionario', []);
+
+    const r = calcolaSessione(db, s);
+    const insufficienti = Object.values(r.assi).filter((a) => a.stato === 'insufficiente').length;
+    expect(insufficienti).toBe(7);
+    expect(r.fitnessAge).toBeNull();
+  });
+
+  it('nessun asse insufficiente porta con se un valore da mostrare per sbaglio', () => {
+    const db = createLongevityDb(':memory:');
+    seedRegistro(db);
+    seedPesi(db, MODEL_VERSION);
+    db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0002','F')`).run();
+    const s = apriSessione(db, { client_code: 'ISL-0002', data: '2026-08-22', tipo: 'checkup', eta_alla_data: 35 });
+    registraMisure(db, s, 'questionario', []);
+
+    const r = calcolaSessione(db, s);
+    for (const [nome, asse] of Object.entries(r.assi)) {
+      if (asse.stato === 'insufficiente') {
+        expect((asse as { valore?: number }).valore, `${nome} espone un valore`).toBeUndefined();
+      }
+    }
+  });
+});
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `npm test -- tests/longevity/motore-caso-reale.test.ts`
+Expected: FAIL se qualcosa nella catena non regge il caso senza misure.
+
+- [ ] **Step 3: Correggi ciò che il caso reale smonta**
+
+Non c'è codice nuovo da scrivere: se questo test fallisce, il difetto è in un task precedente. Correggilo lì e **annota nel rapporto quale task ha dovuto essere corretto** — è l'informazione che dice se il porting regge davvero o solo sui casi comodi.
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `npm test`
+Expected: PASS, con il solo rosso pre-esistente.
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add tests/longevity/motore-caso-reale.test.ts
+git commit -m "longevity: la prova sul profilo con una sola area misurata"
+```
+
+---
+
+## Cosa esiste alla fine di questo piano
+
+Il motore completo: le curve verificate una per una contro l'oracolo del cliente su migliaia di casi, la cascata a quattro livelli, la lettura di curve e pesi dal registro, il congelamento dei punteggi con le due versioni distinte.
+
+**Non esiste ancora nessuna pagina.** È il piano successivo, e da lì in poi il radar ha numeri veri da mostrare.
+
+## Nota per il piano dell'interfaccia
+
+I sette assi che il motore restituisce sono `Punteggio`, cioè o `{stato:'ok', valore}` o `{stato:'insufficiente'}` senza valore. La dashboard **non può** stampare un numero dove non c'è: è il tipo a impedirlo, ed è il motivo per cui il tratteggio del radar non dipende dalla disciplina di chi scrive la vista.
+
+⚠️ Con i dati di oggi — solo questionario, nessun test fisico — **sei assi su sette risultano insufficienti**. È corretto e atteso: i test fisici entrano col piano degli import. Chi guarderà la prima dashboard non deve scambiarlo per un difetto.

docs/specs/2026-08-21-longevity-design.md

@@ -0,0 +1,504 @@
+# IN-SANITY LONGEVITY PROJECT — piattaforma dati cliente
+
+**Data:** 2026-08-21
+**Stato:** design approvato, implementazione non iniziata
+**Branch:** `feat/longevity` — `main` non viene toccato, nessun deploy
+**Committente:** In-Sanity Lab (Nicola Antonelli) — sviluppo Tielogic
+
+---
+
+## 1. Cos'è, e come si chiama
+
+Il nome esiste già e viene dal cliente: **IN-SANITY LONGEVITY PROJECT** è
+l'iniziativa — *«servizio premium basato su dati, con monitoraggio
+longitudinale»* — e **IN-SANITY LONGEVITY SCORE** è il sistema di punteggio che
+ne è il prodotto di punta. Questa piattaforma è l'implementazione software del
+primo. Nel codice il nome tecnico è **`longevity`**.
+
+Non è una raccolta di applicazioni separate: è **un fascicolo del cliente**.
+Questionario, check-up in sala, Wellness Tower e VALD non sono quattro
+sottosistemi, sono **quattro sorgenti che scrivono nello stesso posto**;
+dashboard, vista trainer e punteggi sono **viste e funzioni derivate** di quel
+posto. È la differenza fra progettare per dati e progettare per schermate, e
+determina tutto quello che segue.
+
+## 2. Perimetro
+
+**Dentro:** anagrafica cliente, questionario in pagina, registrazione delle
+misure da tutte le sorgenti, motore di calcolo degli score, dashboard cliente,
+vista trainer, export per le statistiche.
+
+**Fuori, e per ragioni diverse:**
+
+- **I percentili interni ISL** — non per scelta: la documentazione del cliente
+  dichiara che sotto 15 campioni sono inutilizzabili e sotto 30 provvisori.
+  Vanno costruiti quando i dati esistono, non prima.
+- **Gli 8 indicatori posturali** della Wellness Tower — esistono solo nel PDF
+  stampato, non nell'export a 55 colonne. Il cliente li ha già esclusi dallo
+  score.
+- **Il blocco Trimestre / 2 Mesocicli** — dichiarato aperto dal cliente stesso e
+  ancora in analisi da parte sua.
+- **Il deploy** — la piattaforma si sviluppa e si prova in locale. Quando mettere
+  qualcosa in produzione è una decisione separata, che non appartiene a questo
+  documento.
+
+## 3. Collocazione
+
+La piattaforma vive **dentro l'applicazione Astro esistente**, come già fanno
+Biohacking Campus e Stress Index. Non è un secondo servizio, non è un secondo
+container.
+
+```
+src/pages/longevity/         rotte visibili
+src/pages/api/longevity/     endpoint
+src/lib/longevity/           modello dati, motore, import
+tests/longevity/             test
+```
+
+Il motivo per cui non è un progetto separato è che l'autenticazione, le sessioni
+e l'anagrafica utenti esistono già qui e funzionano in produzione: rifarle altrove
+significherebbe mantenerne due.
+
+⚠️ **Il calcolo è in TypeScript, non in Python.** Il motore fornito dal cliente
+(`isl_scoring_engine.py`, 537 righe) è aritmetica pura — interpolazioni lineari,
+tabelle di soglie, medie pesate — e importa solo `dataclasses` e `typing`: nessuna
+libreria numerica. Portarlo in TypeScript costa poco e evita un secondo runtime
+dentro un'immagine `node:22-slim` a processo unico. La stessa scelta vale per il
+prototipo del questionario, che calcola già in JavaScript: tenere le formule in
+due linguaggi è il modo silenzioso di farle divergere.
+
+## 4. I tre database
+
+SQLite, tre file distinti, aperti da connessioni distinte.
+
+| File | Contiene | Non contiene |
+|---|---|---|
+| `insanitylab.db` | il sito: articoli, contenuti, **utenti e sessioni** | niente di clinico |
+| `identity.db` | `client_code` ↔ `user_id`, nome, cognome, nascita, recapiti | nessuna misura |
+| `longevity.db` | misure, questionari, punteggi, registro test | **nessun nome, mai** |
+
+La proprietà che ne discende è la richiesta esplicita del cliente del 21/08: *«la
+mappatura codice↔nome va tenuta in un posto separato e più ristretto rispetto
+all'export usato per le statistiche, così anche chi ha accesso ai dati clinici
+non può risalire all'identità»*. Qui l'export per le statistiche **è**
+`longevity.db`: già pseudonimizzato per costruzione, senza una funzione di
+anonimizzazione che qualcuno debba ricordarsi di chiamare.
+
+**Vincolo di implementazione, verificabile con un test:** esiste **un solo
+modulo** che apre insieme `identity` e `longevity`. Nessun altro punto del codice
+importa entrambe le connessioni.
+
+## 5. Modello dati
+
+```sql
+-- ============ identity.db ============
+CREATE TABLE clienti (
+  client_code   TEXT PRIMARY KEY,          -- es. 'ISL-0007'
+  user_id       INTEGER,                   -- users.id in insanitylab.db (nessuna FK: file diverso)
+  nome          TEXT NOT NULL,
+  cognome       TEXT NOT NULL,
+  data_nascita  TEXT,                      -- ISO; resta QUI, non passa in longevity
+  email         TEXT,
+  telefono      TEXT,
+  created_at    TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE UNIQUE INDEX idx_clienti_user ON clienti (user_id);
+
+-- ============ longevity.db ============
+CREATE TABLE soggetti (
+  client_code   TEXT PRIMARY KEY,
+  sesso         TEXT NOT NULL CHECK (sesso IN ('M','F')),
+  created_at    TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE sessioni (
+  id            INTEGER PRIMARY KEY AUTOINCREMENT,
+  client_code   TEXT NOT NULL REFERENCES soggetti(client_code),
+  data          TEXT NOT NULL,
+  tipo          TEXT NOT NULL CHECK (tipo IN ('checkup','questionario')),
+  eta_alla_data INTEGER,                   -- l'età serve al motore; la data di nascita no
+  operatore     TEXT,
+  note          TEXT,
+  quest_version TEXT,                      -- solo per tipo='questionario'
+  created_at    TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE INDEX idx_sessioni_cliente ON sessioni (client_code, data DESC);
+
+CREATE TABLE misure (
+  id            INTEGER PRIMARY KEY AUTOINCREMENT,
+  sessione_id   INTEGER NOT NULL REFERENCES sessioni(id) ON DELETE CASCADE,
+  client_code   TEXT NOT NULL REFERENCES soggetti(client_code),
+  test_id       TEXT NOT NULL REFERENCES registro_test(test_id),
+  valore_num    REAL,
+  valore_txt    TEXT,                      -- per le risposte non numeriche
+  unita         TEXT,
+  fonte         TEXT NOT NULL CHECK (fonte IN
+                  ('manuale','questionario','wellness_tower','vald','calibre','stress_index')),
+  fuori_range   INTEGER NOT NULL DEFAULT 0,
+  created_at    TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE INDEX idx_misure_cliente_test ON misure (client_code, test_id);
+CREATE INDEX idx_misure_sessione ON misure (sessione_id);
+
+CREATE TABLE registro_test (
+  test_id       TEXT PRIMARY KEY,          -- 'handgrip_dx', 'plank', 'q_sonno_ore'
+  etichetta     TEXT NOT NULL,
+  unita         TEXT,
+  tipo_valore   TEXT NOT NULL CHECK (tipo_valore IN ('num','txt')),
+  curva         TEXT,                      -- 'bell','lin_dec','inc_plateau','x10','x10_inv','decstep','incstep'
+  params        TEXT,                      -- JSON dei parametri della curva
+  asse          TEXT,                      -- uno dei 7 assi; NULL = non entra nello score
+  sotto_dominio TEXT,                      -- a QUALE sotto-dominio contribuisce; il peso sta in `pesi`
+  range_min     REAL,                      -- atteso, non vincolante: fuori range si marca
+  range_max     REAL,
+  attivo_da     TEXT NOT NULL,
+  attivo_a      TEXT,                      -- NULL = ancora attivo
+  note          TEXT
+);
+
+CREATE TABLE pesi (
+  model_version TEXT NOT NULL,
+  livello       TEXT NOT NULL CHECK (livello IN ('asse','macro','fitness_age')),
+  contenitore   TEXT NOT NULL,             -- l'asse, il macro-score, o 'fitness_age'
+  elemento      TEXT NOT NULL,             -- il sotto-dominio, o l'asse, o la voce isolata
+  peso          REAL NOT NULL,
+  PRIMARY KEY (model_version, livello, contenitore, elemento)
+);
+
+CREATE TABLE profilo_note (
+  id            INTEGER PRIMARY KEY AUTOINCREMENT,
+  client_code   TEXT NOT NULL REFERENCES soggetti(client_code),
+  sessione_id   INTEGER REFERENCES sessioni(id),
+  campo_id      TEXT NOT NULL,             -- 'farmaci', 'problematiche_attuali', 'obiettivi'
+  testo         TEXT NOT NULL,
+  created_at    TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE score (
+  id            INTEGER PRIMARY KEY AUTOINCREMENT,
+  client_code   TEXT NOT NULL REFERENCES soggetti(client_code),
+  sessione_id   INTEGER NOT NULL REFERENCES sessioni(id),
+  tipo          TEXT NOT NULL CHECK (tipo IN ('asse','macro','fitness_age')),
+  elemento      TEXT NOT NULL,             -- 'Forza & Struttura', 'PERFORMANCE', ...
+  valore        REAL,                      -- NULL quando stato='insufficiente'
+  copertura     REAL NOT NULL,
+  stato         TEXT NOT NULL CHECK (stato IN ('ok','insufficiente')),
+  quest_version TEXT,
+  model_version TEXT NOT NULL,
+  calcolato_at  TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE INDEX idx_score_cliente ON score (client_code, calcolato_at DESC);
+```
+
+### Perché l'età e non la data di nascita
+
+Il motore ha bisogno dell'età — `score_handgrip(kg, eta, sex)`,
+`score_vo2max(vo2max, eta, sex)`, le bande per decade — ma gli serve **un numero
+al momento della misura**, non una data. Sesso ed età non identificano nessuno;
+una data di nascita esatta, combinata con pochi altri campi, quasi sì. Costa una
+colonna e toglie un quasi-identificatore dal database clinico.
+
+### Perché il peso non sta sulla riga del test
+
+Un sotto-dominio può essere coperto da **test alternativi**: la *spinta* si
+misura con i push-up o con il 5RM di panca, a seconda del livello del cliente, e
+il peso — 20% dentro *Forza & Struttura* — è del sotto-dominio, non del singolo
+test. Se il peso stesse sulla riga del test si ripeterebbe su ogni alternativa,
+e prima o poi due copie divergerebbero.
+
+I pesi stanno quindi in una tabella loro, **con la `model_version` nella chiave**.
+È ciò che rende reale il congelamento del §6: uno score del passato si può
+rileggere con i pesi che erano in vigore quando è stato calcolato, invece che con
+quelli di oggi. Senza questo, `model_version` sarebbe un'etichetta senza niente
+dietro.
+
+⚠️ Nota per l'implementazione: nel motore Python `plank` compare in **due** assi
+— `core` in *Forza & Struttura* (0.15) e `plank` in *Stabilità & Mobilità* (0.20).
+È lo stesso doppio conteggio ammesso dal cliente per l'handgrip nella Fitness Age,
+ma quello del plank **non è dichiarato da nessuna parte**. Questo schema lo
+rappresenta senza problemi (due righe in `pesi`), però va segnalato al cliente
+invece che riprodotto in silenzio.
+
+### Perché il registro dei test è dato e non codice
+
+Il cliente ha già i test in forma di registro: un foglio di 30 righe con fonte e
+stato per ciascuno. Qui diventa una tabella, e la conseguenza è che **il set dei
+test è mobile senza migrazioni**, cosa che è già successa tre volte in un mese:
+l'agilità è stata rimossa dallo score, la capacità vitale pure, e l'HRR è passato
+dalla finestra a 2' a quella a 1'.
+
+Con questo modello: disattivare un test è valorizzare `attivo_a`; cambiare la
+finestra dell'HRR è **un `test_id` nuovo che convive col vecchio**, e le
+misurazioni già fatte restano leggibili e restano marcate per quello che sono,
+invece di diventare confrontabili per sbaglio con le nuove.
+
+## 6. Versioni e congelamento
+
+Decisione del cliente, 21/08: quando cambia una formula i punteggi storici si
+**congelano**, non si ricalcolano. La ragione è di prodotto ed è corretta — se
+lo score storico cambia, il cliente non distingue più il proprio miglioramento
+da un cambio di matematica, e il confronto nel tempo perde valore.
+
+L'implementazione ha due conseguenze:
+
+1. **Gli score si salvano**, non si ricalcolano a ogni visualizzazione. La
+   tabella `score` è la memoria di ciò che il cliente ha visto.
+2. **Le misure grezze si salvano tutte**, quindi un ricalcolo con formule nuove
+   resta sempre possibile in lettura, per analisi, senza sovrascrivere niente.
+
+**Due versioni, non una.** Ogni score porta `quest_version` (quali domande) e
+`model_version` (quali curve e quali pesi). Il cliente ne ha implementata una
+sola perché dal suo lato coincidevano, ma i pesi degli assi possono cambiare
+senza che cambi una domanda: con una versione sola un punteggio del passato non
+saprebbe dire quale delle due cose è cambiata.
+
+⚠️ **Il congelamento sposta il problema del confronto, non lo elimina.** Due
+compilazioni con versioni diverse restano non confrontabili anche se nessuno le
+ha riscritte. Il grafico della progressione deve quindi **dichiarare
+visivamente il cambio di versione**, altrimenti il cliente vede una linea
+continua di numeri calcolati con matematiche diverse — che è l'equivoco che la
+decisione voleva evitare.
+
+## 7. Flusso dei dati
+
+### Ingresso: un solo varco
+
+```
+questionario in pagina  ─┐
+gestionale trainer      ─┤
+import file (WT, VALD)  ─┼─→  registraMisure(sessione, misure[])  ─→  misure
+API (VALD Hub)          ─┘         ↑ valida contro registro_test
+```
+
+`registraMisure` è l'unica funzione che scrive in `misure`. Valida ogni riga
+contro il registro: **un `test_id` sconosciuto viene rifiutato**, non scritto in
+silenzio. Un valore fuori dal range atteso viene invece **scritto e marcato**
+(`fuori_range = 1`), perché scartarlo perderebbe un dato vero e clamparlo lo
+falserebbe — vedi §9.
+
+### Calcolo
+
+Il motore legge misure e registro, e produce gli score seguendo la cascata a
+quattro livelli del cliente: sotto-metrica → asse → macro-score → Fitness Age,
+con rinormalizzazione dei pesi disponibili a ogni livello e soglia di copertura
+al **40%**.
+
+Il tipo di ritorno impedisce la trappola presente nel motore Python, dove
+`aggregate()` restituisce il punteggio pieno **anche quando lo dichiara
+insufficiente**:
+
+```ts
+type Punteggio =
+  | { stato: 'ok'; valore: number; copertura: number }
+  | { stato: 'insufficiente'; copertura: number }   // non c'è nessun valore da leggere
+```
+
+La regola di prodotto — *«tratteggiato, mai un numero pieno fasullo»* — diventa
+così impossibile da violare per distrazione: chi disegna il radar non ha il campo
+da cui prendere il numero.
+
+### Uscita
+
+Dashboard cliente (radar a 7 assi, 3 macro-score, Fitness Age), vista trainer, ed
+export per le statistiche — che è il contenuto di `longevity.db`, senza passare
+da nessuna funzione di anonimizzazione.
+
+## 8. Ruoli e accessi
+
+Il sito ha oggi `admin | superuser | user | piattaforme`, e nessuno di questi è
+il cliente finale né il trainer. Se ne aggiungono **due**: `cliente` e `trainer`.
+
+| Rotta | Chi entra |
+|---|---|
+| `/longevity/io` | `cliente` (solo il proprio fascicolo), `trainer`, `admin` |
+| `/longevity/gestionale` | `trainer`, `admin` |
+| `/api/longevity/**` | come sopra, verificato lato server |
+
+**Il cliente vede solo i propri dati, e non è una regola di interfaccia:** gli
+endpoint ricavano il `client_code` dalla sessione e **mai** dalla richiesta. Un
+client_code che arriva dal browser viene ignorato.
+
+## 9. Errori e casi limite
+
+**Misura fuori dal range atteso: si registra e si marca.** Il caso è già
+successo — la capacità vitale di 5148 mL su un fondoscala dichiarato di
+2000-3000 mL non era una prestazione eccezionale, era il range del fornitore
+sbagliato, e clamparla a 100 produceva un dato apparentemente ottimo. Le misure
+marcate finiscono in una lista che il trainer vede; non entrano nello score
+finché qualcuno non le conferma.
+
+**Scala non comparabile: si esclude dal registro, non si corregge nel codice.**
+L'agilità a 548 ms contro i 250 attesi dava 20/100 su Stabilità — falso, e la
+causa era il protocollo diverso. Un caso così si risolve disattivando il test nel
+registro, non aggiungendo un fattore di correzione da qualche parte.
+
+**Copertura sotto il 40%:** l'elemento è `insufficiente` e non ha un valore.
+
+**Test sconosciuto in ingresso:** errore esplicito, la sessione non viene scritta
+a metà.
+
+## 10. Test
+
+Il test principale è il **verificatore contro il motore Python**: gli stessi
+ingressi devono produrre gli stessi numeri, e ogni curva va confrontata su tutto
+il suo dominio, non su un caso singolo. È l'unico modo per sapere che il porting
+non ha spostato niente.
+
+Poi: le regole di copertura e rinormalizzazione, il rifiuto dei test sconosciuti,
+la marcatura del fuori range, l'isolamento dei tre database (nessun modulo, a
+parte quello designato, apre insieme identity e longevity), e il fatto che un
+`client_code` proveniente dalla richiesta non venga mai onorato.
+
+⚠️ **I dati reali di Donata e Nicola non entrano nelle fixture.** Sono dati
+sanitari di due persone identificabili, e le fixture stanno in git, dove restano
+per sempre e le legge chiunque abbia accesso al repository. I casi di prova si
+costruiscono sintetici; i referti veri restano dove sono, per il confronto a mano
+quando serve.
+
+## 11. Punti aperti che il codice non risolve
+
+Questi non sono dettagli implementativi: sono decisioni che spettano al cliente,
+e finché non arrivano il codice si comporterà come qui dichiarato — non come
+capita.
+
+1. **Base giuridica per i dati sanitari (art. 9 GDPR).** Il campo `consenso` del
+   questionario riguarda le comunicazioni promozionali, non il trattamento di
+   dati di salute, e la finalità statistica è ulteriore rispetto a quella di
+   cura. Serve un consenso esplicito dedicato. **Non è un blocco allo sviluppo,
+   è un blocco alla messa in produzione con clienti veri.**
+2. **Chi è il medico supervisore**, nominato nella specifica del questionario. Se
+   è un professionista sanitario, cambia la base giuridica utilizzabile
+   (art. 9.2.h), in meglio.
+3. **La regola dei buchi nel questionario.** Oggi esiste in due versioni: il
+   prototipo annulla un sotto-dominio solo se non c'è **nessuna** risposta, il
+   motore usa il 40%. La piattaforma userà **una soglia unica, dichiarata nel
+   registro come parametro**, e in attesa della risposta assume il **40%**,
+   coerente con la regola dei sette assi.
+4. **Il cambio di versione sul grafico** della progressione (§6).
+5. **Il registro delle versioni**: cosa cambia a ogni incremento di
+   `quest_version` e `model_version`, altrimenti fra sei mesi «v1.3» non dirà
+   niente a nessuno.
+6. **Nomi dei Livelli 1/2/3** — SPARK/FLUX/APEX o PULSE/FLOW/PEAK, aperti da
+   sessioni precedenti del cliente. Il livello è già una colonna del profilo.
+7. **Export CSV/API di Stress Index**, l'unico canale la cui automazione non è
+   confermata. L'HRV entra nel motore come passthrough, quindi senza quel canale
+   va inserito a mano.
+
+## 12-bis. Cosa ha scoperto la costruzione del motore (22/08)
+
+Il motore è stato costruito il 22/08 (ramo `feat/longevity`, 6 task, 308 test). Il porting
+è fedele: eseguendo la funzione dimostrativa del cliente sui due motori, i sette assi, i tre
+macro-score e la Fitness Age **combaciano numero per numero**.
+
+### Due divergenze deliberate dall'oracolo, entrambe volute
+
+1. **Un punteggio insufficiente non espone un valore.** Nell'originale la funzione di
+   aggregazione restituisce il numero anche quando dichiara l'elemento insufficiente; qui il
+   tipo non ha proprio il campo. È ciò che rende impossibile mostrare un numero dove i dati
+   non bastano.
+2. **La Fitness Age esclude gli assi insufficienti**, mentre l'oracolo li include comunque.
+   ⚠️ **Cambia il numero, e parecchio**: sullo stesso profilo parziale, 25,0 contro 34,8 —
+   quasi dieci anni. Chi confrontasse il nostro referto con il Python del cliente su un
+   profilo incompleto concluderebbe che il porting è rotto. **Da dire a Nicola.**
+
+### ⚠️ Le curve dei test fisici non sono collegate, e agganciarle non sarà «solo dati»
+
+Le venti curve dei test misurati sono portate e verificate, ma **irraggiungibili dal
+motore**: il vocabolario delle curve del registro non ha nomi per loro, e la funzione che
+applica una curva non può ricevere età e sesso, che quasi tutte richiedono.
+
+📌 Questo contraddice la §5, dove il registro è presentato come dato che si estende senza
+toccare il codice. **È vero per il questionario, non per i test fisici**: agganciarli
+richiede di estendere il vocabolario e la firma. Il piano degli import deve saperlo, perché
+oggi crede di trovare la presa già montata.
+
+### Il confine dove la barriera finisce
+
+Il tipo protegge il codice; la tabella `score` ha ora anche un vincolo che rifiuta un valore
+scritto sotto uno stato che lo nega. ⚠️ Ma quel vincolo entra solo nei database **creati da
+qui in avanti**: lo schema gira con `CREATE TABLE IF NOT EXISTS`, che su un file esistente
+non fa nulla. Oggi nessun database esiste ancora — diventa un problema il giorno del primo
+deploy, ed è quello il momento di ricordarsene.
+
+### La storia dei punteggi si tiene
+
+Un ricalcolo **aggiunge** righe invece di sovrascriverle, coerentemente col congelamento del
+§6: sovrascrivere cancellerebbe proprio ciò che il congelamento protegge. La lettura passa da
+una funzione tipata che restituisce l'ultimo calcolo per sessione — la dashboard non deve
+inventarsi una query sua.
+
+### 🔲 Una domanda per Nicola, sulla voce più pesante del modello
+
+`hrv` pesa **0,50 su due assi** — *Recupero* ed *Energia* — ed è la singola voce più pesante
+di tutto il modello. Nel motore è un dato solo, condiviso. Ma nella funzione dimostrativa
+dell'oracolo i due assi ricevono **numeri diversi sotto lo stesso nome** (68 e 65).
+O è la stessa misura riusata su due assi — come il plank, che Nicola ha già confermato — e i
+due numeri sono illustrativi; oppure sono due metriche distinte, e allora le stiamo fondendo
+per sbaglio. Diventa concreto appena si collega Stress Index, che è la sorgente di quel dato.
+
+---
+
+## 12. Cosa l'implementazione ha scoperto — da chiudere prima del motore
+
+Lo strato dati è stato costruito il 21/08 (ramo `feat/longevity`, 19 commit, 241 test).
+Costruirlo ha fatto emergere sei punti che questo documento non aveva previsto o su cui
+si contraddiceva. **Nessuno è bloccante per lo strato dati; tutti lo diventano per il
+motore di calcolo.**
+
+1. **La conferma delle misure fuori range non ha dove stare.** La §9 dice che una misura
+   marcata «non entra nello score finché qualcuno non la conferma», ma lo schema della §5
+   non prevede nessuna colonna che registri quella conferma. Le due sezioni si
+   contraddicono: va aggiunta la colonna o riscritta la regola.
+2. **`registraMisure` valida l'esistenza del test, non il valore.** Oggi accetta una
+   misura senza nessun valore, un testo dove il registro dichiara un numero, e un `NaN`
+   (che viene scritto come nullo e **non** marcato fuori range, perché ogni confronto con
+   NaN è falso). Una riga vuota conta come «test presente» ai fini della copertura del 40%.
+3. **`seedRegistro` rilanciato disfa il registro.** Usa `INSERT OR REPLACE` e riazzera
+   `attivo_a` e le note: disattivare un test e poi rilanciare il seed lo riattiva. È
+   esattamente l'opposto della promessa della §5, dove disattivare un test è valorizzare
+   `attivo_a`.
+4. **`MODEL_VERSION` non esiste.** `QUEST_VERSION` sta in `questionario.ts`; la gemella
+   che versiona curve e pesi non è dichiarata da nessuna parte, e `seedPesi` la riceve
+   come parametro che solo i test valorizzano. Finché non esiste, il congelamento del §6
+   ha metà del suo significato.
+5. **La soglia del 40% è una costante di codice**, non un parametro nel registro come
+   chiede la §11.3 — e nessuno la consuma ancora.
+6. **Registro e pesi sono disallineati per costruzione.** Il registro contiene oggi i 20
+   campi del questionario; i pesi citano handgrip, vo2max, plank, flamingo — sotto-domini
+   che nessun test ancora alimenta. Con i dati attuali sei assi su sette resterebbero
+   permanentemente «insufficiente». È atteso, perché i test fisici arrivano col piano degli
+   import, ma va saputo: il primo che lancia il motore lo legge come un difetto.
+
+⚠️ **Una trappola già armata per il piano delle API.** Nelle regole di accesso, tutto ciò
+che sta sotto `/api/longevity/` e non sotto `/api/longevity/gestionale/` è raggiungibile da
+**ogni** cliente. Oggi è innocuo perché non esiste nessun endpoint, ma significa che la
+scelta dei nomi delle rotte è una questione di sicurezza, non di stile: un domani
+`/api/longevity/clienti` sarebbe l'elenco di tutti, aperto a tutti.
+
+⚠️ **Due limiti noti dell'anagrafica**, accettati con cognizione: se fallisse anche la
+cancellazione compensativa su identity, l'errore diagnostico verrebbe mascherato e
+resterebbe un cliente senza pendant clinico; e i codici sono ordinati come stringhe,
+quindi oltre `ISL-9999` l'ordinamento sbaglia e un codice potrebbe essere riusato.
+
+📌 **Da dire a Nicola, non ancora detto:** il plank pesa su due assi — `core` in *Forza &
+Struttura* (0.15) e `plank` in *Stabilità & Mobilità* (0.20). È lo stesso doppio conteggio
+che lui dichiara per l'handgrip nella Fitness Age, ma questo non è dichiarato da nessuna
+parte.
+
+---
+
+## 12. Decisioni prese, e da chi
+
+| Decisione | Chi | Quando |
+|---|---|---|
+| Un record per compilazione + export Excel | Nicola | 21/08 |
+| Versione del questionario su ogni record | Nicola | 21/08 |
+| Formula cambiata → punteggi storici congelati | Nicola | 21/08 |
+| Export pseudonimizzato, mappatura separata e ristretta | Nicola | 21/08 |
+| Curva alcol 0-7 = 100 (soglia NIAAA/WHO), voluta | Nicola | 21/08 |
+| La piattaforma vive dentro il sito, area riservata | Adriano | 13/08 |
+| Ramo separato, nessun deploy | Adriano | 21/08 |
+| Tre database separati | Adriano | 21/08 |
+| Registro di misure invece di colonne fisse | Adriano | 21/08 |
+| Il progetto è unico: un framework sui dati del cliente | Adriano | 21/08 |
+| Calcolo in TypeScript, non Python | Tielogic (verificato sul codice) | 21/08 |

scripts/create-user.mjs

@@ -8,8 +8,10 @@ if (!username || !password) {
   console.error('Uso: npm run create-user -- <username> <password> [role]');
   process.exit(1);
 }
-if (!['admin', 'superuser', 'user', 'campus'].includes(role)) {
+// Lista duplicata di proposito: questo file è JavaScript e non può importare da
-  console.error('Ruolo non valido. Ammessi: admin, superuser, user, campus');
+// src/lib/auth.ts. La fonte vera è ROLES in src/lib/auth.ts - se cambia là, va allineata qui.
+if (!['admin', 'superuser', 'user', 'piattaforme', 'cliente', 'trainer'].includes(role)) {
+  console.error('Ruolo non valido. Ammessi: admin, superuser, user, piattaforme, cliente, trainer');
   process.exit(1);
 }
 const path = process.env.DB_PATH ?? 'data/insanitylab.db';

src/components/longevity/MacroScore.astro

@@ -0,0 +1,37 @@
+---
+// La carta di un macro-score (Performance/Energy/Recovery). Stesso principio del radar:
+// il numero se il dato basta, un trattino se no — MAI uno zero, che si leggerebbe come
+// "hai zero" invece di "non lo sappiamo ancora". Il bordo tratteggiato (.lg-card--incompleto,
+// dal Task 1) è lo stesso linguaggio visivo del radar: non una convenzione nuova per le carte.
+// L'etichetta si deriva dal nome del contenitore (dato, letto da vista.ts), non da un
+// elenco scritto qui: PERFORMANCE/ENERGY/RECOVERY diventano Performance/Energy/Recovery
+// con una trasformazione, non con un dizionario da tenere allineato a mano.
+import { formattaNumero } from '../../lib/longevity/formato';
+
+interface Props {
+  nome: string;
+  valore: number | null;
+  copertura: number;
+}
+const { nome, valore, copertura } = Astro.props;
+const etichetta = nome.charAt(0) + nome.slice(1).toLowerCase();
+// L'intensità dell'accento (mai un colore diverso, Task 1): minimo 0.15 così una carta
+// nota ma bassa resta comunque leggibile, non sparisce nello sfondo.
+const intensita = valore !== null ? Math.max(valore / 100, 0.15) : 0;
+---
+<div class:list={['lg-card', 'lg-macro__card', { 'lg-card--incompleto': valore === null }]}>
+  <p class="lg-score__label">{etichetta}</p>
+  <div class="lg-score">
+    <span class="lg-score__value lg-num">{valore !== null ? formattaNumero(valore) : '—'}</span>
+    <span class="lg-score__max">/ 100</span>
+  </div>
+  <div class="lg-score__bar">
+    <span
+      class="lg-score__bar-fill"
+      style={`width:${valore !== null ? valore : 0}%; --lg-intensita:${intensita}`}
+    ></span>
+  </div>
+  <p class="lg-muted lg-macro__nota">
+    Copertura dati: {Math.round(copertura * 100)}%{valore === null && ' — non ancora sufficiente per un numero.'}
+  </p>
+</div>

src/components/longevity/Questionario.tsx

@@ -0,0 +1,192 @@
+// Il questionario in pagina: quattro schermate — le tre aree di domande punteggiate,
+// lette dal registro (props `campi`, costruite da `campiDelQuestionario`), più le note
+// libere e il consenso. Avanti/indietro fra i blocchi, invio solo sull'ultimo.
+//
+// Il consenso qui NON blocca lato client la scelta "No": bloccarlo qui ripeterebbe
+// l'errore del prototipo del cliente in un altro punto (un controllo che sembra
+// proteggere e non protegge). La verifica che conta è quella del server
+// (src/lib/longevity/vista.ts, salvaDalForm): se il consenso non è affermativo, la
+// compilazione non si salva e la risposta lo dice — questa isola si limita a mostrarlo.
+import { useMemo, useState } from 'react';
+import type { CampoQuestionario } from '../../lib/longevity/vista';
+
+interface Props {
+  campi: CampoQuestionario[];
+}
+
+const CAMPI_LIBERI: { id: string; etichetta: string }[] = [
+  { id: 'farmaci', etichetta: 'Farmaci assunti abitualmente' },
+  { id: 'problematiche_attuali', etichetta: 'Problematiche di salute attuali' },
+  { id: 'problematiche_pregresse', etichetta: 'Problematiche di salute pregresse' },
+  { id: 'obiettivi', etichetta: 'Obiettivi del percorso' },
+];
+
+const BLOCCHI = [
+  { titolo: 'Sonno & Recupero', sottoDominio: 'questionario_sonno' },
+  { titolo: 'Energia & Stress', sottoDominio: 'questionario_energia_stress' },
+  { titolo: 'Stile di Vita', sottoDominio: 'questionario_lifestyle' },
+] as const;
+
+type Esito = { tipo: 'ok'; sessioneId: number } | { tipo: 'errore'; messaggio: string };
+
+export default function Questionario({ campi }: Props) {
+  const [passo, setPasso] = useState(0);
+  const [risposte, setRisposte] = useState<Record<string, string>>({});
+  const [liberi, setLiberi] = useState<Record<string, string>>({});
+  const [consenso, setConsenso] = useState<'' | 'Si' | 'No'>('');
+  const [eta, setEta] = useState('');
+  const [inviando, setInviando] = useState(false);
+  const [esito, setEsito] = useState<Esito | null>(null);
+
+  // Le domande arrivano dal registro in ordine di test_id, non raggruppate: qui si
+  // ricostruiscono i tre blocchi filtrando sul sotto-dominio, senza toccare i dati.
+  const gruppi = useMemo(
+    () => BLOCCHI.map((b) => ({ ...b, campi: campi.filter((c) => c.sottoDominio === b.sottoDominio) })),
+    [campi]
+  );
+
+  // Il tipo dichiarato nel registro per ciascun campo: serve sia per scegliere il tipo di
+  // input (numero o testo) sia, all'invio, per non trattare una risposta testuale come un
+  // numero da scartare in silenzio.
+  const tipoDiCampo = useMemo(() => new Map(campi.map((c) => [c.id, c.tipo])), [campi]);
+
+  const totalePassi = gruppi.length + 1; // + il blocco note/consenso
+  const ultimo = passo === totalePassi - 1;
+
+  async function invia() {
+    setInviando(true);
+    setEsito(null);
+
+    const risposteNumeriche: Record<string, number> = {};
+    for (const [id, v] of Object.entries(risposte)) {
+      // Le domande testuali (tipo_valore='txt' nel registro) non sono ancora agganciate
+      // al salvataggio numerico: oggi non esistono nel questionario (i 20 campi attivi
+      // sono tutti 'num'), ma se un domani ne comparisse una non va convertita in NaN e
+      // scartata in silenzio — resta fuori esplicitamente.
+      if (tipoDiCampo.get(id) === 'txt') continue;
+      const n = Number(v);
+      if (v !== '' && Number.isFinite(n)) risposteNumeriche[id] = n;
+    }
+
+    try {
+      const res = await fetch('/api/longevity/questionario', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          risposte: risposteNumeriche,
+          liberi,
+          consensoSanitario: consenso,
+          eta: eta === '' ? undefined : Number(eta),
+        }),
+      });
+      const corpo = await res.json();
+      if (res.ok) setEsito({ tipo: 'ok', sessioneId: corpo.sessioneId });
+      else setEsito({ tipo: 'errore', messaggio: corpo.error ?? 'Invio non riuscito.' });
+    } catch {
+      setEsito({ tipo: 'errore', messaggio: 'Invio non riuscito: verifica la connessione.' });
+    } finally {
+      setInviando(false);
+    }
+  }
+
+  if (esito?.tipo === 'ok') {
+    return (
+      <div className="lg-card">
+        <p>Questionario salvato, grazie.</p>
+      </div>
+    );
+  }
+
+  return (
+    <div className="lg-form">
+      <p className="lg-form__passo">Passo {passo + 1} di {totalePassi}</p>
+
+      {passo < gruppi.length && (
+        <section className="lg-form__blocco">
+          <h2>{gruppi[passo].titolo}</h2>
+          {gruppi[passo].campi.map((c) => (
+            <label className="lg-field" key={c.id}>
+              <span>{c.etichetta}{c.unita ? ` (${c.unita})` : ''}</span>
+              {c.tipo === 'txt' ? (
+                <input
+                  type="text"
+                  value={risposte[c.id] ?? ''}
+                  onChange={(e) => setRisposte((r) => ({ ...r, [c.id]: e.target.value }))}
+                />
+              ) : (
+                <input
+                  type="number"
+                  min={c.min}
+                  max={c.max}
+                  step="any"
+                  value={risposte[c.id] ?? ''}
+                  onChange={(e) => setRisposte((r) => ({ ...r, [c.id]: e.target.value }))}
+                />
+              )}
+            </label>
+          ))}
+        </section>
+      )}
+
+      {ultimo && (
+        <section className="lg-form__blocco">
+          <h2>Note e consenso</h2>
+
+          {CAMPI_LIBERI.map((c) => (
+            <label className="lg-field" key={c.id}>
+              <span>{c.etichetta}</span>
+              <textarea
+                value={liberi[c.id] ?? ''}
+                onChange={(e) => setLiberi((l) => ({ ...l, [c.id]: e.target.value }))}
+              />
+            </label>
+          ))}
+
+          <label className="lg-field">
+            <span>La tua età</span>
+            <input type="number" min={0} max={120} value={eta} onChange={(e) => setEta(e.target.value)} />
+          </label>
+
+          <fieldset className="lg-field lg-field--consenso">
+            <legend>
+              Acconsenti al trattamento dei tuoi dati sanitari (farmaci, patologie, pressione,
+              composizione corporea) per il monitoraggio del percorso?
+            </legend>
+            <label>
+              <input
+                type="radio" name="consenso" checked={consenso === 'Si'}
+                onChange={() => setConsenso('Si')}
+              />
+              Sì, acconsento
+            </label>
+            <label>
+              <input
+                type="radio" name="consenso" checked={consenso === 'No'}
+                onChange={() => setConsenso('No')}
+              />
+              No, non acconsento
+            </label>
+          </fieldset>
+
+          {esito?.tipo === 'errore' && <p className="lg-form__errore">{esito.messaggio}</p>}
+        </section>
+      )}
+
+      <div className="lg-form__nav">
+        <button type="button" disabled={passo === 0} onClick={() => setPasso((p) => Math.max(0, p - 1))}>
+          Indietro
+        </button>
+        {!ultimo && (
+          <button type="button" onClick={() => setPasso((p) => Math.min(totalePassi - 1, p + 1))}>
+            Avanti
+          </button>
+        )}
+        {ultimo && (
+          <button type="button" disabled={inviando || consenso === ''} onClick={invia}>
+            {inviando ? 'Invio…' : 'Invia'}
+          </button>
+        )}
+      </div>
+    </div>
+  );
+}

src/components/longevity/Radar.tsx

@@ -0,0 +1,95 @@
+// Il radar a sette assi del referto: isola React perché recharts ha bisogno del DOM.
+// Due serie sovrapposte sugli stessi sette assi (recharts vuole un solo `data` condiviso,
+// non può disegnare un poligono che copre solo alcuni assi):
+// - "noto": l'area piena, coi valori congelati che la sessione ha davvero. Dove il dato
+//   manca vale 0 — non si inventa un centro pieno per una misura che non c'è, si lascia
+//   che l'area si ritiri, onestamente, verso il centro;
+// - "potenziale": il perimetro tratteggiato. Dove il dato c'è coincide col bordo di
+//   "noto" (stesso valore, la linea tratteggiata sparisce dietro quella piena); dove
+//   manca si allarga fino al massimo (100) — è la parte che CHIUDE il perimetro, il gesto
+//   su cui si regge l'interfaccia: non un errore, un invito a completare quell'asse.
+// Sotto il grafico, l'elenco leggibile di cosa completerebbe ogni asse ancora tratteggiato,
+// letto da `mancano` (calcolato in vista.ts, mai qui: questo componente non tocca il db).
+import {
+  ResponsiveContainer, RadarChart, PolarGrid, PolarAngleAxis, PolarRadiusAxis, Radar,
+} from 'recharts';
+import type { AsseVista } from '../../lib/longevity/vista';
+
+interface Props {
+  assi: AsseVista[];
+}
+
+// Stessi colori del sito (come in DataChart.tsx, che per lo stesso motivo — attributi SVG,
+// non proprietà CSS — non passa var(--...) a recharts): l'accento e il tratteggio di
+// longevity.css, non un colore nuovo.
+const ACCENTO = '#9c8b70';
+const TRATTEGGIO = '#d8d2c8';
+const LINEA = '#e4dfd7';
+const TESTO_CHIARO = '#8a8a8a';
+
+export default function RadarAssi({ assi }: Props) {
+  const dati = assi.map((a) => ({
+    nome: a.nome,
+    noto: a.valore ?? 0,
+    potenziale: a.valore ?? 100,
+  }));
+  const incompleti = assi.filter((a) => a.mancano.length > 0);
+
+  return (
+    <div className="lg-radar">
+      {/* La spiegazione del linguaggio visivo viene PRIMA del grafico che spiega, non dopo:
+          chi legge deve sapere cosa sta guardando prima di guardarlo. */}
+      <p className="lg-radar__intro">
+        L'area piena è quello che sappiamo davvero; il perimetro tratteggiato è il resto
+        dell'asse, dove il dato non c'è ancora.
+      </p>
+      <div className="lg-radar__grafico">
+        <ResponsiveContainer width="100%" height={360}>
+          <RadarChart data={dati} outerRadius="72%">
+            <PolarGrid stroke={LINEA} />
+            <PolarAngleAxis dataKey="nome" tick={{ fill: TESTO_CHIARO, fontSize: 11 }} />
+            <PolarRadiusAxis domain={[0, 100]} tick={false} axisLine={false} />
+            {/* il perimetro tratteggiato si disegna per primo: quello pieno gli va sopra */}
+            <Radar
+              name="Perimetro completo"
+              dataKey="potenziale"
+              stroke={TRATTEGGIO}
+              strokeDasharray="4 3"
+              strokeWidth={1.5}
+              fill="none"
+              isAnimationActive={false}
+            />
+            <Radar
+              name="Quello che sappiamo"
+              dataKey="noto"
+              stroke={ACCENTO}
+              fill={ACCENTO}
+              fillOpacity={0.32}
+              strokeWidth={2}
+              isAnimationActive={false}
+            />
+          </RadarChart>
+        </ResponsiveContainer>
+      </div>
+
+      {incompleti.length > 0 && (
+        <div className="lg-radar__mancano">
+          {/* L'invito concreto: l'elenco sotto è nomi di test, da solo non dice cosa fare.
+              Questi test si fanno in palestra con lo staff, non a casa da soli. */}
+          <p className="lg-muted">
+            Questi test si fanno in sala, con il trainer: prenota la prossima sessione per
+            completare il quadro.
+          </p>
+          {incompleti.map((a) => (
+            <div className="lg-radar__voce" key={a.nome}>
+              <p className="lg-radar__voce-nome">{a.nome}</p>
+              <ul className="lg-radar__lista">
+                {a.mancano.map((m) => <li key={m}>{m}</li>)}
+              </ul>
+            </div>
+          ))}
+        </div>
+      )}
+    </div>
+  );
+}

src/data/content-seed.ts

@@ -318,7 +318,8 @@ export const contentSeed: SeedEntry[] = [
   T('eventi.meta.title', 'Eventi', []),
   T('eventi.meta.description', 'Gli eventi InsanityLab: inaugurazione del nuovo spazio il 19 settembre 2026, con aperitivo e dj set.', []),
   T('eventi.hero.title', 'Eventi', []),
-  T('eventi.inaugurazione.title', 'Inaugurazione — 19 settembre 2026'),
+  T('eventi.inaugurazione.title', 'Inaugurazione'),
+  T('eventi.inaugurazione.date', '19 settembre 2026'),
   T('eventi.inaugurazione.body', 'Apriamo le porte del nuovo spazio con un aperitivo e dj set. Sarà l’occasione per conoscere lo staff, visitare la struttura e prenotare una prova gratuita dei nostri servizi. Il programma completo della giornata sarà pubblicato a breve.'),
   T('eventi.cta.label', 'Scrivici su WhatsApp', []),
   T('eventi.torna.label', '← Torna a promo ed eventi', []),

src/layouts/Longevity.astro

@@ -0,0 +1,47 @@
+---
+// Layout della piattaforma Longevity. Come Stress Index: token, font e palette del sito,
+// senza Header e Footer pubblici — l'area è riservata e non va mai indicizzata.
+// A differenza di Stress Index (barra laterale con sette voci, giusta per chi ci lavora
+// dentro) qui i pubblici sono due, e uno non è staff: il cliente entra tre o quattro
+// volte l'anno a leggere il proprio referto, non gli serve l'arredamento di uno
+// strumento di lavoro. Il layout prevede due forme:
+// - "referto": una colonna che scorre, senza navigazione (questo task)
+// - "gestionale": barra laterale come Stress Index (arriva col piano del gestionale)
+import '@fontsource/montserrat/400.css';
+import '@fontsource/montserrat/500.css';
+import '@fontsource/montserrat/600.css';
+import '@fontsource/open-sans/400.css';
+import '@fontsource/open-sans/600.css';
+import '../styles/global.css';
+import '../styles/longevity.css';
+
+interface Props {
+  title: string;
+  /** Voci di percorso mostrate nell'intestazione, dopo "Longevity". */
+  crumbs?: string[];
+  /** "referto" (colonna centrata, senza navigazione) o "gestionale" (barra laterale, non ancora implementata). */
+  variante?: 'referto' | 'gestionale';
+}
+const { title, crumbs = [], variante = 'referto' } = Astro.props;
+---
+<!doctype html>
+<html lang="it">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>{title} — Longevity InsanityLab</title>
+    <meta name="robots" content="noindex, nofollow" />
+    <link rel="icon" href="/favicon.svg" type="image/svg+xml" />
+  </head>
+  <body class="lg" data-variante={variante}>
+    <div class="lg-shell">
+      <header class="lg-top">
+        <p class="lg-top__crumbs">
+          <strong>Longevity</strong>
+          {crumbs.map((c) => <span> / {c}</span>)}
+        </p>
+      </header>
+      <main class="lg-main"><slot /></main>
+    </div>
+  </body>
+</html>

src/lib/auth.ts

@@ -5,7 +5,13 @@ import { randomBytes } from 'node:crypto';
 export const SESSION_COOKIE = 'session';
 const SESSION_DAYS = 7;
 
-export type Role = 'admin' | 'superuser' | 'user' | 'piattaforme';
+// Unica fonte dei ruoli validi: da qui si derivano il tipo Role e la validazione isRole,
+// così aggiungere un ruolo in futuro è una modifica sola. Prima erano quattro punti
+// indipendenti - questo tipo, isRole, la tendina di admin/users.astro e create-user.mjs -
+// ed è già andato fuori sincrono due volte in questo stesso ramo (create-user.mjs resta
+// duplicato: è JavaScript, non può importare da qui, vedi il commento lì).
+export const ROLES = ['user', 'superuser', 'piattaforme', 'admin', 'cliente', 'trainer'] as const;
+export type Role = typeof ROLES[number];
 
 export function hashPassword(plain: string): string {
   return bcrypt.hashSync(plain, 12);
@@ -51,8 +57,9 @@ export function logout(db: Database.Database, token: string): void {
 
 // Autorizzazione per prefisso di rotta. L'admin passa sempre; per gli altri, la prima regola
 // che matcha decide; se nessuna regola matcha la rotta è "blog/upload/logout" → consentita a
-// qualsiasi loggato (il middleware protegge solo /admin e /api/admin, quindi qui arrivano solo
+// qualsiasi loggato. L'elenco vero di cosa il middleware protegge (non solo /admin e
-// utenti già autenticati).
+// /api/admin: anche /campus, /piattaforme e /longevity) vive in isProtectedPath, più sotto:
+// qui arrivano solo utenti già autenticati su una di quelle rotte.
 const RULES: [RegExp, Role[]][] = [
   [/^\/admin\/users(\/|$)/, ['admin']],
   [/^\/api\/admin\/users(\/|$)/, ['admin']],
@@ -62,6 +69,11 @@ const RULES: [RegExp, Role[]][] = [
   // sotto /piattaforme. Stesso ruolo per entrambe.
   [/^\/campus(\/|$)/, ['admin', 'piattaforme']],
   [/^\/piattaforme(\/|$)/, ['admin', 'piattaforme']],
+  // Longevity: il cliente vede solo il proprio spazio, il gestionale è del trainer.
+  [/^\/longevity\/gestionale(\/|$)/, ['admin', 'trainer']],
+  [/^\/api\/longevity\/gestionale(\/|$)/, ['admin', 'trainer']],
+  [/^\/longevity(\/|$)/, ['admin', 'trainer', 'cliente']],
+  [/^\/api\/longevity(\/|$)/, ['admin', 'trainer', 'cliente']],
 ];
 
 export function canAccessAdminPath(role: string, pathname: string): boolean {
@@ -71,6 +83,8 @@ export function canAccessAdminPath(role: string, pathname: string): boolean {
   }
   // piattaforme vede solo le sue sezioni (coperte da RULES) e il logout
   if (role === 'piattaforme') return pathname === '/admin/logout';
+  // cliente e trainer non sono utenti del sito: fuori dalle rotte elencate non passano.
+  if (role === 'cliente' || role === 'trainer') return pathname === '/admin/logout';
   return true; // blog, upload, logout, showtags: tutti i loggati
 }
 
@@ -111,11 +125,24 @@ export function randomPassword(): string {
 }
 
 export function isRole(v: unknown): v is Role {
-  return v === 'admin' || v === 'superuser' || v === 'user' || v === 'piattaforme';
+  return (ROLES as readonly unknown[]).includes(v);
 }
 
 export function landingFor(role: string): string {
   if (role === 'superuser') return '/admin/content';
   if (role === 'piattaforme') return '/piattaforme';
+  if (role === 'cliente') return '/longevity/io';
+  if (role === 'trainer') return '/longevity/gestionale';
   return '/admin';
 }
+
+export function isProtectedPath(pathname: string): boolean {
+  return (
+    (pathname.startsWith('/admin') && pathname !== '/admin/login') ||
+    pathname.startsWith('/api/admin') ||
+    pathname.startsWith('/campus') ||
+    pathname.startsWith('/piattaforme') ||
+    pathname.startsWith('/longevity') ||
+    pathname.startsWith('/api/longevity')
+  );
+}

src/lib/longevity/anagrafica.ts

@@ -0,0 +1,96 @@
+//
+// QUESTO è l'unico modulo autorizzato ad aprire insieme identity e longevity.
+// La separazione dei due database è la garanzia che chi legge i dati clinici non
+// risalga alla persona (richiesta del cliente, 21/08): un secondo punto di giunzione
+// la annullerebbe in silenzio. Un test in tests/longevity/anagrafica.test.ts lo verifica.
+import type Database from 'better-sqlite3';
+import { createIdentityDb } from './db';
+
+// Connessione singola a identity, privata di questo modulo: non è esportata, quindi non
+// è raggiungibile da nessun'altra parte del codice, nemmeno con un re-export su più file
+// (un controllo testuale file-per-file non lo vedrebbe, ma qui il problema non si pone:
+// non esiste un nome da importare). QUESTO è il modo in cui il vincolo si rende vero,
+// non solo sorvegliato.
+let identitySingleton: Database.Database | null = null;
+function getIdentityDb(): Database.Database {
+  if (!identitySingleton) identitySingleton = createIdentityDb();
+  return identitySingleton;
+}
+
+/**
+ * Il prossimo codice libero: il massimo fra quelli già usati in identity.clienti E in
+ * longevity.soggetti. Dedurlo da una sola metà è il bug che permette di riassegnare il
+ * codice di un cliente cancellato dall'anagrafica (le sue misure restano in longevity)
+ * a una persona nuova: qui non torna mai disponibile.
+ */
+function prossimoCodice(identity: Database.Database, longevity: Database.Database): string {
+  const numero = (code: string) => Number(code.slice(4));
+  const ultimoIdentity = identity.prepare(
+    `SELECT client_code FROM clienti ORDER BY client_code DESC LIMIT 1`
+  ).get() as { client_code: string } | undefined;
+  const ultimoLongevity = longevity.prepare(
+    `SELECT client_code FROM soggetti ORDER BY client_code DESC LIMIT 1`
+  ).get() as { client_code: string } | undefined;
+
+  const max = Math.max(
+    ultimoIdentity ? numero(ultimoIdentity.client_code) : 0,
+    ultimoLongevity ? numero(ultimoLongevity.client_code) : 0,
+  );
+  return `ISL-${String(max + 1).padStart(4, '0')}`;
+}
+
+export function creaCliente(
+  identity: Database.Database,
+  longevity: Database.Database,
+  dati: {
+    nome: string; cognome: string; sesso: 'M' | 'F';
+    data_nascita?: string; email?: string; telefono?: string; user_id?: number;
+  }
+): string {
+  const code = prossimoCodice(identity, longevity);
+
+  identity.prepare(
+    `INSERT INTO clienti (client_code, user_id, nome, cognome, data_nascita, email, telefono)
+     VALUES (?, ?, ?, ?, ?, ?, ?)`
+  ).run(code, dati.user_id ?? null, dati.nome, dati.cognome,
+        dati.data_nascita ?? null, dati.email ?? null, dati.telefono ?? null);
+
+  try {
+    longevity.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES (?, ?)`).run(code, dati.sesso);
+  } catch (err) {
+    // Compensazione: due database distinti, quindi nessuna transazione unica possibile.
+    // Se longevity rifiuta il cliente non deve restarne uno orfano in identity, senza
+    // corrispettivo nell'altro database.
+    identity.prepare(`DELETE FROM clienti WHERE client_code = ?`).run(code);
+    throw err;
+  }
+
+  return code;
+}
+
+export function codicePerUtente(identity: Database.Database, userId: number): string | null {
+  const r = identity.prepare(`SELECT client_code FROM clienti WHERE user_id = ?`).get(userId) as
+    { client_code: string } | undefined;
+  return r?.client_code ?? null;
+}
+
+/**
+ * Il codice cliente a partire dall'utente di sessione del sito: apre lei stessa la
+ * connessione a identity (getIdentityDb), perché QUESTO è il modulo autorizzato a farlo.
+ * Un endpoint che deve solo sapere "chi è" chiama questa funzione e non ha mai bisogno
+ * di aprire identity da sé — riceve una stringa, mai una connessione che potrebbe
+ * incrociarsi con quella di longevity nello stesso file.
+ */
+export function codicePerUtenteLoggato(userId: number): string | null {
+  return codicePerUtente(getIdentityDb(), userId);
+}
+
+/** L'eta' al momento della misura: è ciò che serve al motore, e non è un quasi-identificatore. */
+export function etaAllaData(dataNascita: string, alla: string): number {
+  const n = new Date(dataNascita);
+  const d = new Date(alla);
+  let eta = d.getFullYear() - n.getFullYear();
+  const m = d.getMonth() - n.getMonth();
+  if (m < 0 || (m === 0 && d.getDate() < n.getDate())) eta--;
+  return eta;
+}

src/lib/longevity/db.ts

@@ -0,0 +1,150 @@
+import Database from 'better-sqlite3';
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+
+/**
+ * Sotto questa copertura di peso un elemento calcolato e' 'insufficiente' e non ha valore.
+ * Vale a ogni livello E dentro il questionario: soglia unica, confermata da Nicola il
+ * 22/08 — due criteri diversi sarebbero due cose da spiegare e da ricordare.
+ */
+export const COPERTURA_MINIMA = 0.4;
+
+const SCHEMA_LONGEVITY = `
+CREATE TABLE IF NOT EXISTS soggetti (
+  client_code   TEXT PRIMARY KEY,
+  sesso         TEXT NOT NULL CHECK (sesso IN ('M','F')),
+  created_at    TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE TABLE IF NOT EXISTS registro_test (
+  test_id       TEXT PRIMARY KEY,
+  etichetta     TEXT NOT NULL,
+  unita         TEXT,
+  tipo_valore   TEXT NOT NULL CHECK (tipo_valore IN ('num','txt')),
+  curva         TEXT,
+  params        TEXT,
+  asse          TEXT,
+  sotto_dominio TEXT,
+  range_min     REAL,
+  range_max     REAL,
+  attivo_da     TEXT NOT NULL,
+  attivo_a      TEXT,
+  note          TEXT
+);
+CREATE TABLE IF NOT EXISTS sessioni (
+  id            INTEGER PRIMARY KEY AUTOINCREMENT,
+  client_code   TEXT NOT NULL REFERENCES soggetti(client_code),
+  data          TEXT NOT NULL,
+  tipo          TEXT NOT NULL CHECK (tipo IN ('checkup','questionario')),
+  eta_alla_data INTEGER,
+  operatore     TEXT,
+  note          TEXT,
+  quest_version TEXT,
+  created_at    TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_sessioni_cliente ON sessioni (client_code, data DESC);
+CREATE TABLE IF NOT EXISTS misure (
+  id            INTEGER PRIMARY KEY AUTOINCREMENT,
+  sessione_id   INTEGER NOT NULL REFERENCES sessioni(id) ON DELETE CASCADE,
+  client_code   TEXT NOT NULL REFERENCES soggetti(client_code),
+  test_id       TEXT NOT NULL REFERENCES registro_test(test_id),
+  valore_num    REAL,
+  valore_txt    TEXT,
+  unita         TEXT,
+  fonte         TEXT NOT NULL CHECK (fonte IN
+                  ('manuale','questionario','wellness_tower','vald','calibre','stress_index')),
+  fuori_range   INTEGER NOT NULL DEFAULT 0,
+  created_at    TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_misure_cliente_test ON misure (client_code, test_id);
+CREATE INDEX IF NOT EXISTS idx_misure_sessione ON misure (sessione_id);
+CREATE TABLE IF NOT EXISTS pesi (
+  model_version TEXT NOT NULL,
+  livello       TEXT NOT NULL CHECK (livello IN ('asse','macro','fitness_age')),
+  contenitore   TEXT NOT NULL,
+  elemento      TEXT NOT NULL,
+  peso          REAL NOT NULL,
+  PRIMARY KEY (model_version, livello, contenitore, elemento)
+);
+CREATE TABLE IF NOT EXISTS profilo_note (
+  id            INTEGER PRIMARY KEY AUTOINCREMENT,
+  client_code   TEXT NOT NULL REFERENCES soggetti(client_code),
+  sessione_id   INTEGER REFERENCES sessioni(id),
+  campo_id      TEXT NOT NULL,
+  testo         TEXT NOT NULL,
+  created_at    TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE TABLE IF NOT EXISTS score (
+  id            INTEGER PRIMARY KEY AUTOINCREMENT,
+  client_code   TEXT NOT NULL REFERENCES soggetti(client_code),
+  sessione_id   INTEGER NOT NULL REFERENCES sessioni(id),
+  tipo          TEXT NOT NULL CHECK (tipo IN ('asse','macro','fitness_age')),
+  elemento      TEXT NOT NULL,
+  valore        REAL,
+  copertura     REAL NOT NULL,
+  stato         TEXT NOT NULL CHECK (stato IN ('ok','insufficiente')),
+  quest_version TEXT,
+  model_version TEXT NOT NULL,
+  calcolato_at  TEXT NOT NULL DEFAULT (datetime('now')),
+  -- Il tipo Punteggio protegge il codice ma non la tabella: l'interfaccia leggera'
+  -- 'score' direttamente, dove quel tipo non c'e' piu'. Questo vincolo lo riscrive
+  -- a livello di dato: o lo stato e' 'ok' e il valore c'e', o e' 'insufficiente' e
+  -- il valore e' NULL, mai un numero scritto sotto uno stato che lo nega.
+  -- ATTENZIONE al limite, che non e' quello che sembra: lo schema qui sopra gira con
+  -- CREATE TABLE IF NOT EXISTS, che su un file gia' esistente e' un'operazione a vuoto.
+  -- Quindi un longevity.db creato prima di questa modifica NON ha questo vincolo, e
+  -- continuera' a non averlo finche' qualcuno non lo migra a mano.
+  -- (Non e' un limite di SQLite: la versione imbarcata da better-sqlite3 e' la 3.53,
+  -- che ALTER TABLE ... ADD CONSTRAINT lo supporta. E' che qui una migrazione non c'e'.
+  -- Verificato il 22/08: la CLI di sistema e' la 3.37 e non lo supporta, quindi provarlo
+  -- da riga di comando da' un errore fuorviante.)
+  -- Oggi nessun longevity.db esiste ancora, quindi il caso e' teorico: lo diventa il
+  -- giorno del primo deploy, ed e' quello il momento di ricordarselo.
+  CHECK ((stato = 'ok' AND valore IS NOT NULL) OR (stato = 'insufficiente' AND valore IS NULL))
+);
+CREATE INDEX IF NOT EXISTS idx_score_cliente ON score (client_code, calcolato_at DESC);
+`;
+
+const SCHEMA_IDENTITY = `
+CREATE TABLE IF NOT EXISTS clienti (
+  client_code   TEXT PRIMARY KEY,
+  user_id       INTEGER,
+  nome          TEXT NOT NULL,
+  cognome       TEXT NOT NULL,
+  data_nascita  TEXT,
+  email         TEXT,
+  telefono      TEXT,
+  created_at    TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_clienti_user ON clienti (user_id);
+`;
+
+function apri(p: string, schema: string): Database.Database {
+  if (p !== ':memory:') mkdirSync(dirname(p), { recursive: true });
+  const db = new Database(p);
+  db.pragma('journal_mode = WAL');
+  db.pragma('foreign_keys = ON');
+  db.exec(schema);
+  return db;
+}
+
+export function createLongevityDb(path?: string): Database.Database {
+  return apri(path ?? process.env.LONGEVITY_DB_PATH ?? 'data/longevity.db', SCHEMA_LONGEVITY);
+}
+
+export function createIdentityDb(path?: string): Database.Database {
+  return apri(path ?? process.env.IDENTITY_DB_PATH ?? 'data/identity.db', SCHEMA_IDENTITY);
+}
+
+// Connessione singola per processo, come getDb() in src/lib/db.ts: gli endpoint chiedono
+// una connessione già aperta invece di aprirne una nuova a ogni richiesta.
+// ⚠️ Qui c'è SOLO longevity (il database senza nomi: può usarlo chiunque). Un singleton
+// analogo per identity non si esporta da qui — vive privato dentro anagrafica.ts, l'unico
+// modulo autorizzato a tenerlo: un controllo testuale file-per-file non vede una giunzione
+// che passa da un re-export su piu' file, quindi la connessione condivisa a identity non
+// deve essere raggiungibile da fuori quel modulo, punto.
+let longevitySingleton: Database.Database | null = null;
+
+export function getLongevityDb(): Database.Database {
+  if (!longevitySingleton) longevitySingleton = createLongevityDb();
+  return longevitySingleton;
+}

src/lib/longevity/export.ts

@@ -0,0 +1,36 @@
+//
+// L'export per le statistiche legge SOLO longevity.db, che per costruzione non contiene
+// nomi: non serve nessuna funzione di anonimizzazione, e non c'è niente da ricordarsi.
+// I campi liberi (farmaci, patologie) restano fuori: sono per il coach, non per l'analisi.
+import type Database from 'better-sqlite3';
+
+const INTESTAZIONI = [
+  'client_code', 'sesso', 'eta', 'data', 'tipo_sessione',
+  'quest_version', 'test_id', 'valore', 'unita', 'fonte', 'fuori_range',
+];
+
+export function esportaMisure(db: Database.Database): {
+  intestazioni: string[];
+  righe: (string | number | null)[][];
+} {
+  const righe = db.prepare(
+    `SELECT sg.client_code, sg.sesso, s.eta_alla_data, s.data, s.tipo, s.quest_version,
+            m.test_id, COALESCE(m.valore_num, m.valore_txt) AS valore, m.unita, m.fonte, m.fuori_range
+     FROM misure m
+     JOIN sessioni s ON s.id = m.sessione_id
+     JOIN soggetti sg ON sg.client_code = m.client_code
+     ORDER BY s.data, m.id`
+  ).raw().all() as (string | number | null)[][];
+
+  return { intestazioni: INTESTAZIONI, righe };
+}
+
+export function esportaCsv(db: Database.Database): string {
+  const { intestazioni, righe } = esportaMisure(db);
+  const cella = (v: string | number | null) => {
+    if (v === null) return '';
+    const s = String(v);
+    return /[",\n]/.test(s) ? `"${s.replace(/"/g, '""')}"` : s;
+  };
+  return [intestazioni.join(','), ...righe.map((r) => r.map(cella).join(','))].join('\n') + '\n';
+}

src/lib/longevity/formato.ts

@@ -0,0 +1,11 @@
+// Formattazione dei numeri del referto. Un solo posto, perché prima ognuno stampava il
+// numero grezzo di JavaScript (punto, non virgola) direttamente nel template — e un
+// referto italiano con "72.5" al posto di "72,5" si legge come un difetto, non come un
+// dettaglio.
+
+/** Un punteggio o una Fitness Age, formattati con la virgola decimale italiana.
+ * Le ETICHETTE dei punteggi (PERFORMANCE/ENERGY/RECOVERY, nomi di prodotto) non si
+ * toccano: solo i NUMERI si leggono all'italiana in un referto italiano. */
+export function formattaNumero(n: number): string {
+  return n.toLocaleString('it-IT');
+}

src/lib/longevity/misure.ts

@@ -0,0 +1,74 @@
+import type Database from 'better-sqlite3';
+import { esisteTest } from './registro';
+
+export type Fonte = 'manuale' | 'questionario' | 'wellness_tower' | 'vald' | 'calibre' | 'stress_index';
+
+export type MisuraIn = {
+  test_id: string;
+  valore_num?: number;
+  valore_txt?: string;
+  unita?: string;
+};
+
+export function apriSessione(
+  db: Database.Database,
+  s: {
+    client_code: string; data: string; tipo: 'checkup' | 'questionario';
+    eta_alla_data?: number; operatore?: string; quest_version?: string;
+  }
+): number {
+  const r = db.prepare(
+    `INSERT INTO sessioni (client_code, data, tipo, eta_alla_data, operatore, quest_version)
+     VALUES (?, ?, ?, ?, ?, ?)`
+  ).run(s.client_code, s.data, s.tipo, s.eta_alla_data ?? null, s.operatore ?? null, s.quest_version ?? null);
+  return Number(r.lastInsertRowid);
+}
+
+/**
+ * L'unico punto in cui si scrive nella tabella `misure`.
+ * Un test_id sconosciuto fa fallire l'intero lotto: meglio un errore subito che una
+ * sessione scritta a metà. Un valore fuori dal range atteso invece si scrive e si
+ * marca — scartarlo perderebbe un dato vero, clamparlo lo falserebbe.
+ */
+export function registraMisure(
+  db: Database.Database,
+  sessioneId: number,
+  fonte: Fonte,
+  misure: MisuraIn[]
+): { scritte: number; fuoriRange: string[] } {
+  const sess = db.prepare(`SELECT client_code FROM sessioni WHERE id = ?`).get(sessioneId) as
+    { client_code: string } | undefined;
+  if (!sess) throw new Error(`sessione ${sessioneId} inesistente`);
+
+  for (const m of misure) {
+    if (!esisteTest(db, m.test_id)) {
+      throw new Error(`test_id non nel registro: ${m.test_id}`);
+    }
+  }
+
+  const range = db.prepare(`SELECT range_min, range_max FROM registro_test WHERE test_id = ?`);
+  const ins = db.prepare(
+    `INSERT INTO misure (sessione_id, client_code, test_id, valore_num, valore_txt, unita, fonte, fuori_range)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?)`
+  );
+  const fuoriRange: string[] = [];
+
+  const tx = db.transaction(() => {
+    for (const m of misure) {
+      const r = range.get(m.test_id) as { range_min: number | null; range_max: number | null };
+      let fuori = 0;
+      if (m.valore_num !== undefined) {
+        if ((r.range_min !== null && m.valore_num < r.range_min) ||
+            (r.range_max !== null && m.valore_num > r.range_max)) {
+          fuori = 1;
+          fuoriRange.push(m.test_id);
+        }
+      }
+      ins.run(sessioneId, sess.client_code, m.test_id,
+        m.valore_num ?? null, m.valore_txt ?? null, m.unita ?? null, fonte, fuori);
+    }
+  });
+  tx();
+
+  return { scritte: misure.length, fuoriRange };
+}

src/lib/longevity/motore/cascata.ts

@@ -0,0 +1,140 @@
+/**
+ * La cascata a quattro livelli: dalle sotto-metriche normalizzate ai
+ * punteggi di sotto-dominio, ai sette assi del radar, ai tre macro-score
+ * (Performance/Energy/Recovery), fino alla Fitness Age.
+ *
+ * Porting di `aggregate`, `compute_axis`, `compute_macro_scores` e
+ * `compute_fitness_age` dall'oracolo del cliente
+ * (`tests/longevity/riferimento/isl_scoring_engine.py`, sezioni LIVELLO 2-4).
+ * Regola di copertura, uguale a ogni livello: se un elemento manca, il suo
+ * peso si ridistribuisce su quelli disponibili; se la copertura di peso
+ * disponibile scende sotto `COPERTURA_MINIMA`, l'elemento e' insufficiente.
+ *
+ * DUE DIVERGENZE VOLUTE dall'oracolo:
+ *
+ * 1) Nell'oracolo `aggregate()` restituisce il punteggio pieno anche quando lo
+ *    dichiara insufficiente (la docstring dice il contrario di cio' che il
+ *    codice fa) - chi consuma deve ricordarsi di guardare lo stato, e prima o
+ *    poi qualcuno non lo fa. Qui il tipo `Punteggio` chiude la trappola: nel
+ *    ramo 'insufficiente' il campo `valore` non esiste, quindi la regola di
+ *    prodotto - un asse con dati insufficienti si mostra tratteggiato, mai
+ *    con un numero pieno fasullo - e' impossibile da violare per distrazione.
+ *
+ * 2) Nel calcolo della Fitness Age (vedi `motore/index.ts`, `valoreAsse`)
+ *    escludiamo gli assi 'insufficiente' dal composito: `cardio`,
+ *    `forza_resto`, `composizione` e `stabilita` entrano solo se il rispettivo
+ *    asse e' 'ok'. L'oracolo invece li include comunque - per lo stesso motivo
+ *    del punto 1: `compute_axis` restituisce uno `score` numerico anche
+ *    quando lo stato e' "insufficiente", e `compute_fitness_age` lo riceve e
+ *    lo usa senza controllare lo stato. E' il comportamento GIUSTO (un asse
+ *    sotto soglia non e' un dato affidabile da far pesare sull'eta biologica),
+ *    ma cambia il numero: su un profilo con assi parzialmente insufficienti,
+ *    verificato a mano, la nostra Fitness Age e' 25,0 contro 34,8 dell'oracolo
+ *    - quasi dieci anni di scarto. Chi confronta il nostro referto col Python
+ *    del cliente su un profilo parziale concludera' che il porting e' rotto:
+ *    non lo e', diverge di proposito qui.
+ *
+ * Tutto il resto e' fedele all'oracolo.
+ */
+
+import { COPERTURA_MINIMA } from '../db';
+import { arrotonda1 } from './curve';
+
+/** Esito di un'aggregazione pesata: 'ok' porta il valore, 'insufficiente' no. */
+export type Punteggio =
+  | { stato: 'ok'; valore: number; copertura: number }
+  | { stato: 'insufficiente'; copertura: number };
+
+/** Una voce da aggregare: punteggio 0-100 (o null se il dato manca) e il suo peso nominale. */
+export type VocePesata = { punteggio: number | null; peso: number };
+
+/**
+ * Media pesata delle voci disponibili, con i pesi delle voci mancanti
+ * ridistribuiti su quelle presenti. Come `aggregate` nell'oracolo, con la
+ * differenza di tipo descritta sopra.
+ *
+ * ATTENZIONE (bug corretto, trovato in revisione): il confronto con la soglia
+ * usa la copertura GREZZA (`pesoDisponibile / pesoTotale`), non quella
+ * arrotondata. L'arrotondamento a due decimali (`arrotonda1(.., 2)`) serve
+ * solo al valore esposto nel campo `copertura` del risultato. Confrontare la
+ * copertura gia' arrotondata avrebbe fatto passare per 'ok' una copertura
+ * grezza appena sotto 0.40 che arrotonda a 0.40 (es. 0.396) - esattamente il
+ * numero pieno fasullo che il tipo `Punteggio` esiste per impedire.
+ */
+export function aggrega(voci: VocePesata[]): Punteggio {
+  const pesoTotale = voci.reduce((s, v) => s + v.peso, 0);
+  const disponibili = voci.filter((v) => v.punteggio !== null);
+  const pesoDisponibile = disponibili.reduce((s, v) => s + v.peso, 0);
+  const coperturaGrezza = pesoTotale ? pesoDisponibile / pesoTotale : 0;
+  const copertura = arrotonda1(coperturaGrezza, 2);
+
+  if (disponibili.length === 0) {
+    return { stato: 'insufficiente', copertura: 0 };
+  }
+
+  if (coperturaGrezza < COPERTURA_MINIMA) {
+    return { stato: 'insufficiente', copertura };
+  }
+
+  const sommaPesata = disponibili.reduce((s, v) => s + (v.punteggio as number) * v.peso, 0);
+  const valore = arrotonda1(sommaPesata / pesoDisponibile);
+  return { stato: 'ok', valore, copertura };
+}
+
+/**
+ * Livello 2: punteggi di sotto-dominio -> punteggio Asse. Come `compute_axis`
+ * nell'oracolo: `pesi` e' la config del foglio "Pesi e Formule" per quell'asse,
+ * `punteggi` i valori 0-100 disponibili (assenti = mancanti).
+ */
+export function calcolaAsse(pesi: Record<string, number>, punteggi: Record<string, number | null>): Punteggio {
+  const voci: VocePesata[] = Object.entries(pesi).map(([chiave, peso]) => ({
+    punteggio: punteggi[chiave] ?? null,
+    peso,
+  }));
+  return aggrega(voci);
+}
+
+/**
+ * Livello 3: i sette Assi -> un macro-score (Performance/Energy/Recovery).
+ * Come `compute_macro_scores` nell'oracolo: un asse insufficiente non entra
+ * col suo valore (che qui non esiste nemmeno), entra come mancante e il suo
+ * peso si ridistribuisce.
+ */
+export function calcolaMacro(pesiMacro: Record<string, number>, assi: Record<string, Punteggio>): Punteggio {
+  const voci: VocePesata[] = Object.entries(pesiMacro).map(([asse, peso]) => {
+    const p = assi[asse];
+    return { punteggio: p && p.stato === 'ok' ? p.valore : null, peso };
+  });
+  return aggrega(voci);
+}
+
+/**
+ * Livello 4: Fitness Age. Come `compute_fitness_age` nell'oracolo: un
+ * composito di sei elementi (handgrip e HRV isolati, non tramite l'intero
+ * asse) da cui `eta - (composito - 50) * 0.4`. Se il composito e'
+ * insufficiente non c'e' Fitness Age da mostrare.
+ *
+ * `etaAnagrafica` e' `number | null` perche' `sessioni.eta_alla_data` e'
+ * nullable nello schema: l'apertura di una sessione e il salvataggio di un
+ * questionario accettano l'eta come opzionale. Senza eta la Fitness Age NON
+ * ESISTE - deve restituire `null`, mai un numero calcolato con un ripiego
+ * (es. 0), che produrrebbe un'eta di forma negativa dichiarata valida. Gli
+ * assi e i macro-score non dipendono dall'eta e restano calcolabili a monte:
+ * solo questo ultimo livello si ferma.
+ */
+export function calcolaFitnessAge(
+  etaAnagrafica: number | null,
+  pesi: Record<string, number>,
+  voci: Record<string, number | null>
+): { fitnessAge: number | null; composito: Punteggio } {
+  const vociPesate: VocePesata[] = Object.entries(pesi).map(([chiave, peso]) => ({
+    punteggio: voci[chiave] ?? null,
+    peso,
+  }));
+  const composito = aggrega(vociPesate);
+  if (composito.stato === 'insufficiente' || etaAnagrafica === null) {
+    return { fitnessAge: null, composito };
+  }
+  const fitnessAge = arrotonda1(etaAnagrafica - (composito.valore - 50) * 0.4);
+  return { fitnessAge, composito };
+}

src/lib/longevity/motore/curve.ts

@@ -0,0 +1,178 @@
+/**
+ * Curve di normalizzazione del questionario Longevity: portano una risposta
+ * grezza a un punteggio 0-100.
+ *
+ * `clamp`, `lerp`, `curvaCampana`, `curvaDecrescente`, `curvaCrescenteConPlateau`
+ * e `curvaDirettaX10` sono il porting letterale di `clamp`, `_lerp`,
+ * `score_bell_curve`, `score_decreasing`, `score_increasing_plateau` e
+ * `score_direct_x10` dell'oracolo del cliente
+ * (`tests/longevity/riferimento/isl_scoring_engine.py`, sezione «Questionario:
+ * curve generiche»). Non toccare quella logica: è verificata riga per riga
+ * contro `riferimento.json`.
+ *
+ * `curvaDirettaX10Invertita` e `curvaGradini` NON sono nell'oracolo Python:
+ * vengono dal prototipo HTML del cliente (`scale10_inv`, `decstep`/`incstep`)
+ * e non hanno un oracolo di riferimento — sono coperte solo dai test scritti
+ * a mano in `tests/longevity/motore-curve.test.ts`.
+ */
+
+/** Limita x all'intervallo [lo, hi]. Come `clamp` nell'oracolo. */
+export function clamp(x: number, lo = 0, hi = 100): number {
+  return Math.max(lo, Math.min(hi, x));
+}
+
+/**
+ * Interpolazione lineare fra (x0, y0) e (x1, y1). Il fattore t è limitato a
+ * [0, 1]: la curva non esce mai oltre y0/y1, anche se x è fuori da [x0, x1].
+ * Come `_lerp` nell'oracolo.
+ */
+export function lerp(x: number, x0: number, x1: number, y0: number, y1: number): number {
+  if (x1 === x0) return y0;
+  let t = (x - x0) / (x1 - x0);
+  t = Math.max(0, Math.min(1, t));
+  return y0 + t * (y1 - y0);
+}
+
+/**
+ * Arrotonda a `decimali` cifre decimali (default 1), come `round(x, decimali)`
+ * in Python: sui pareggi ESATTI (il valore binario del double è esattamente a
+ * metà, es. 86.25 per un decimale) arrotonda al pari (banker's rounding), non
+ * sempre in su come farebbe `Math.round`. Alcune curve a gradini producono
+ * pareggi veri — `lerp` che restituisce 86.25 esatto va a 86.2, non 86.3.
+ *
+ * Non basta moltiplicare per 10^decimali e confrontare con una tolleranza: un
+ * valore come 86.35 NON è un pareggio vero a un decimale (il double che gli
+ * sta dietro è 86.34999999999999431..., quindi Python arrotonda a 86.3, non
+ * a metà), ma `86.35 * 10` in virgola mobile arrotonda esattamente a 863.5 —
+ * un pareggio fasullo creato dalla moltiplicazione, non presente nel valore
+ * originale. Una prima versione con tolleranza ci cadeva (dava 86.4). Per
+ * evitarlo si scompone il double nella sua mantissa ed esponente esatti (bit
+ * IEEE 754, via `DataView`) e si confrontano `ax*10^decimali` e il pareggio
+ * con aritmetica razionale su `BigInt`, senza mai passare per una
+ * moltiplicazione in virgola mobile che potrebbe introdurre o cancellare un
+ * pareggio.
+ *
+ * Unica funzione di arrotondamento del motore: la usano `curve.ts`,
+ * `test-fisici.ts` (a un decimale, i punteggi) e `cascata.ts` (anche a due
+ * decimali, la copertura), per non avere due implementazioni che sui pareggi
+ * potrebbero divergere fra loro.
+ */
+export function arrotonda1(x: number, decimali = 1): number {
+  if (!Number.isFinite(x) || x === 0) return x === 0 ? 0 : x;
+  const negativo = x < 0;
+  const ax = Math.abs(x);
+  const potenza = 10n ** BigInt(decimali);
+
+  // Scompone il double nella sua rappresentazione esatta ax = mantissa * 2^exponente.
+  const view = new DataView(new ArrayBuffer(8));
+  view.setFloat64(0, ax);
+  const hi = view.getUint32(0);
+  const lo = view.getUint32(4);
+  const expBits = (hi >>> 20) & 0x7ff;
+  let mantissa = (BigInt(hi & 0xfffff) << 32n) | BigInt(lo);
+  let exponent: number;
+  if (expBits === 0) {
+    exponent = -1074; // subnormale, non atteso su questi dati ma corretto comunque
+  } else {
+    mantissa |= 1n << 52n; // bit implicito
+    exponent = expBits - 1075;
+  }
+
+  // ax*10^decimali = num/den, con num e den interi esatti: nessuna
+  // moltiplicazione in virgola mobile, quindi nessun pareggio fasullo
+  // introdotto qui.
+  let num: bigint;
+  let den: bigint;
+  if (exponent >= 0) {
+    num = mantissa * (potenza << BigInt(exponent));
+    den = 1n;
+  } else {
+    num = mantissa * potenza;
+    den = 1n << BigInt(-exponent);
+  }
+
+  const n = num / den; // floor(ax*10^decimali), esatto
+  const resto2 = (num % den) * 2n; // confronta il resto con 1/2 di den, esatto
+  let risultato: bigint;
+  if (resto2 < den) risultato = n;
+  else if (resto2 > den) risultato = n + 1n;
+  else risultato = n % 2n === 0n ? n : n + 1n; // pareggio vero: arrotonda al pari
+
+  const valore = Number(risultato) / Number(potenza);
+  return negativo ? -valore : valore;
+}
+
+/**
+ * Curva a campana: punteggio massimo (100) fra peakLow e peakHigh, decresce
+ * verso low/high ai lati. Come `score_bell_curve` nell'oracolo.
+ */
+export function curvaCampana(v: number, low: number, peakLow: number, peakHigh: number, high: number): number {
+  if (v >= peakLow && v <= peakHigh) return 100;
+  if (v < peakLow) return clamp(arrotonda1(lerp(v, low, peakLow, 10, 100)));
+  return clamp(arrotonda1(lerp(v, peakHigh, high, 100, 10)));
+}
+
+/**
+ * Curva decrescente: 100 a `best`, 0 a `worst`. Come `score_decreasing`
+ * nell'oracolo — con `lerp` che limita t a [0,1], non scende sotto 0 né sale
+ * sopra 100 fuori da [best, worst].
+ */
+export function curvaDecrescente(v: number, best: number, worst: number): number {
+  return clamp(arrotonda1(lerp(v, best, worst, 100, 0)));
+}
+
+/**
+ * Curva crescente con plateau: 20 a `worst`, 100 da `plateauStart` in poi.
+ * Come `score_increasing_plateau` nell'oracolo.
+ */
+export function curvaCrescenteConPlateau(v: number, worst: number, plateauStart: number): number {
+  return clamp(arrotonda1(lerp(v, worst, plateauStart, 20, 100)));
+}
+
+/** Punteggio diretto: valore 0-10 moltiplicato per 10. Come `score_direct_x10` nell'oracolo. */
+export function curvaDirettaX10(v: number): number {
+  return clamp(arrotonda1(v * 10));
+}
+
+/**
+ * Complemento della diretta: valore 0-10, punteggio decrescente. Assente
+ * nell'oracolo Python (è la quinta curva, quella che al motore del cliente
+ * manca): serve a q_calo_pomeridiano, e nel prototipo HTML è `scale10_inv`,
+ * cioè (10 - v) * 10.
+ */
+export function curvaDirettaX10Invertita(v: number): number {
+  return clamp(arrotonda1((10 - v) * 10));
+}
+
+/**
+ * Curva a gradini: interpola fra coppie [valore, punteggio] ordinate per
+ * valore crescente, esattamente come `decstep`/`incstep` nel prototipo HTML
+ * del cliente (assente nell'oracolo Python).
+ *
+ * Se v è zero e zeroVal è definito, vince zeroVal. Altrimenti si interpola a
+ * tratti fra i gradini, partendo da un punto d'ancoraggio (0, 100) per le
+ * curve decrescenti o (0, 20) per le crescenti, e restando sull'ultimo
+ * gradino oltre la sua ascissa (tipicamente un valore-soglia molto alto che
+ * funge da "infinito").
+ */
+export function curvaGradini(
+  v: number,
+  steps: [number, number][],
+  zeroVal: number | undefined,
+  decrescente: boolean
+): number {
+  if (v === 0 && zeroVal !== undefined) return zeroVal;
+
+  const ancoraggio: [number, number] = [0, decrescente ? 100 : 20];
+  const punti: [number, number][] = [ancoraggio, ...steps];
+
+  for (let i = 0; i < punti.length - 1; i++) {
+    const [x0, y0] = punti[i];
+    const [x1, y1] = punti[i + 1];
+    if (v <= x1) {
+      return clamp(arrotonda1(lerp(v, x0, x1, y0, y1)));
+    }
+  }
+  // v oltre l'ultimo gradino: resta sull'ultimo valore.
+  return punti[punti.length - 1][1];
+}

src/lib/longevity/motore/index.ts

@@ -0,0 +1,307 @@
+/**
+ * Il motore che legge dal registro, non da costanti: curve, parametri e pesi
+ * sono dato (`registro_test`, `pesi`), non codice. Aggiungere o togliere un
+ * test, o cambiare un parametro, resta una modifica ai dati.
+ *
+ * Livello 1 (`applicaCurva`): smista sulla curva dichiarata per il test nel
+ * registro (`registro_test.curva`), coi parametri dichiarati lì
+ * (`registro_test.params`), e chiama la funzione di `curve.ts` giusta. Un
+ * test senza curva dichiarata (es. un campo testuale) non contribuisce al
+ * calcolo.
+ *
+ * Livelli 2-4 (`calcolaSessione`): raggruppa le misure attive della sessione
+ * per sotto-dominio (media dei test dello stesso sotto-dominio — più test
+ * possono contribuire allo stesso sotto-dominio, es. spinta via push-up o
+ * panca), poi usa `cascata.ts` (`calcolaAsse`, `calcolaMacro`,
+ * `calcolaFitnessAge`) coi pesi letti da `pesi` (via `pesiDi`) per i sette
+ * assi, i tre macro-score e la Fitness Age.
+ *
+ * `salvaScore` congela il risultato nella tabella `score`, una riga per
+ * asse/macro/Fitness Age, con `valore` a `null` quando lo stato è
+ * insufficiente (il tipo `Punteggio` non porta un `valore` in quel ramo).
+ * `leggiScore` fa il percorso inverso — legge `score` e la ritipa come
+ * `Punteggio` — perché nessun altro punto del codice deve fare quella query
+ * a mano su una colonna nullable.
+ *
+ * Tre barriere aggiunte in revisione, tutte nella direzione "dato insufficiente
+ * → null, mai un numero fasullo": l'età mancante (nullable nello schema) non
+ * usa più un ripiego a zero — senza età la Fitness Age è `null`, non un'età di
+ * forma negativa; `applicaCurva` valida i parametri della curva prima di
+ * applicarla, e restituisce `null` se il registro (dato modificabile senza
+ * migrazioni) ha una riga incompleta, invece del punteggio pieno che dava
+ * `lerp` con estremi indefiniti; e la lettura delle misure esclude
+ * `fuori_range = 1` (§9 della spec), in attesa della colonna di conferma
+ * (punto aperto in §12).
+ */
+
+import type Database from 'better-sqlite3';
+import {
+  curvaCampana, curvaDecrescente, curvaCrescenteConPlateau,
+  curvaDirettaX10, curvaDirettaX10Invertita, curvaGradini, arrotonda1,
+} from './curve';
+import { calcolaAsse, calcolaMacro, calcolaFitnessAge, type Punteggio } from './cascata';
+import { testAttivi, pesiDi, MODEL_VERSION, type VoceRegistro } from '../registro';
+
+/** Parametri possibili per una curva, nella forma dichiarata da ciascuna curva in `curve.ts`. */
+type ParamsCurva = {
+  low?: number; peakLow?: number; peakHigh?: number; high?: number;
+  best?: number; worst?: number; plateauStart?: number;
+  steps?: [number, number][]; zeroVal?: number;
+};
+
+/** Vero solo per un numero finito: esclude `undefined`, `NaN`, stringhe, ecc. */
+function numeroValido(x: unknown): x is number {
+  return typeof x === 'number' && Number.isFinite(x);
+}
+
+/**
+ * Verifica che `params` contenga tutto cio' che la curva dichiarata richiede,
+ * PRIMA di passarlo alla funzione di curva. Il registro e' dato modificabile
+ * senza migrazioni (la promessa della spec, §5): una riga con `params` vuoti
+ * o incompleti deve fermarsi qui, non arrivare a `lerp` con estremi
+ * indefiniti - dove `x1 === x0` (`undefined === undefined`) restituisce il
+ * punteggio pieno, la peggior direzione di guasto possibile per un motore
+ * clinico.
+ */
+function paramsValidi(curva: VoceRegistro['curva'], p: ParamsCurva): boolean {
+  switch (curva) {
+    case 'bell':
+      return numeroValido(p.low) && numeroValido(p.peakLow) && numeroValido(p.peakHigh) && numeroValido(p.high);
+    case 'lin_dec':
+      return numeroValido(p.best) && numeroValido(p.worst);
+    case 'inc_plateau':
+      return numeroValido(p.worst) && numeroValido(p.plateauStart);
+    case 'x10':
+    case 'x10_inv':
+      return true; // nessun parametro richiesto
+    case 'decstep':
+    case 'incstep':
+      return Array.isArray(p.steps) && p.steps.length > 0 &&
+        p.steps.every((s) => Array.isArray(s) && s.length === 2 && numeroValido(s[0]) && numeroValido(s[1]));
+    default:
+      return false;
+  }
+}
+
+/**
+ * Normalizza un valore grezzo secondo la curva dichiarata nel registro per
+ * quel test (`voce.curva` + `voce.params`), non secondo una curva scritta nel
+ * motore. Un test senza curva dichiarata restituisce `null`: non contribuisce
+ * al calcolo di sotto-dominio. Lo stesso vale per una curva coi parametri
+ * mancanti o incompleti: mai un punteggio inventato (vedi `paramsValidi`).
+ */
+export function applicaCurva(voce: VoceRegistro, valore: number): number | null {
+  if (!voce.curva) return null;
+  const p = (voce.params ?? {}) as ParamsCurva;
+  if (!paramsValidi(voce.curva, p)) return null;
+  switch (voce.curva) {
+    case 'bell':
+      return curvaCampana(valore, p.low as number, p.peakLow as number, p.peakHigh as number, p.high as number);
+    case 'lin_dec':
+      return curvaDecrescente(valore, p.best as number, p.worst as number);
+    case 'inc_plateau':
+      return curvaCrescenteConPlateau(valore, p.worst as number, p.plateauStart as number);
+    case 'x10':
+      return curvaDirettaX10(valore);
+    case 'x10_inv':
+      return curvaDirettaX10Invertita(valore);
+    case 'decstep':
+      return curvaGradini(valore, p.steps ?? [], p.zeroVal, true);
+    case 'incstep':
+      return curvaGradini(valore, p.steps ?? [], p.zeroVal, false);
+    default:
+      return null;
+  }
+}
+
+/**
+ * Esito del calcolo di una sessione: i sette assi, i tre macro-score, la Fitness Age.
+ * `fitnessAge` è `number | null` — non `Punteggio` come gli assi e i macro-score — perché
+ * e' cosi' che la produce `calcolaFitnessAge` in `cascata.ts` (l'oracolo del cliente la
+ * tratta come un numero singolo, non come un contenitore stato/valore): `null` quando il
+ * composito e' insufficiente. `fitnessAgeCopertura` porta la copertura del composito, che
+ * altrimenti andrebbe persa: serve a `salvaScore` per scrivere la riga 'fitness_age'.
+ */
+export type RisultatoSessione = {
+  assi: Record<string, Punteggio>;
+  macro: Record<string, Punteggio>;
+  fitnessAge: number | null;
+  fitnessAgeCopertura: number;
+  modelVersion: string;
+  questVersion: string | null;
+};
+
+/**
+ * Calcola i punteggi di una sessione leggendo dal registro e dai pesi, non da
+ * costanti: `testAttivi` alla data della sessione, i valori grezzi da
+ * `misure`, i pesi da `pesi` (tramite `pesiDi`).
+ */
+export function calcolaSessione(db: Database.Database, sessioneId: number): RisultatoSessione {
+  const sessione = db.prepare(
+    `SELECT data, eta_alla_data, quest_version FROM sessioni WHERE id = ?`
+  ).get(sessioneId) as { data: string; eta_alla_data: number | null; quest_version: string | null } | undefined;
+  if (!sessione) throw new Error(`sessione ${sessioneId} inesistente`);
+
+  const attivi = testAttivi(db, sessione.data);
+  // fuori_range = 1 esclusa: §9 della spec, "non entrano nello score finche' qualcuno
+  // non le conferma". La colonna della conferma non esiste ancora (punto aperto in
+  // §12 della spec) - quando ci sara', questo filtro andra' rilassato per lasciar
+  // passare le misure confermate, non tolto del tutto.
+  const misurate = new Map<string, number>(
+    (db.prepare(`SELECT test_id, valore_num FROM misure WHERE sessione_id = ? AND fuori_range = 0`).all(sessioneId) as
+      { test_id: string; valore_num: number | null }[])
+      .filter((m) => m.valore_num !== null)
+      .map((m) => [m.test_id, m.valore_num as number])
+  );
+
+  // Livello 1: normalizza ogni test attivo e misurato, poi raggruppa per
+  // sotto-dominio — più test nello stesso sotto-dominio contano come media.
+  const perSottoDominio = new Map<string, number[]>();
+  for (const voce of attivi) {
+    if (!voce.sotto_dominio) continue;
+    const grezzo = misurate.get(voce.test_id);
+    if (grezzo === undefined) continue;
+    const punteggio = applicaCurva(voce, grezzo);
+    if (punteggio === null) continue;
+    const lista = perSottoDominio.get(voce.sotto_dominio) ?? [];
+    lista.push(punteggio);
+    perSottoDominio.set(voce.sotto_dominio, lista);
+  }
+  const sottoDominio: Record<string, number> = {};
+  for (const [nome, valori] of perSottoDominio) {
+    sottoDominio[nome] = arrotonda1(valori.reduce((a, b) => a + b, 0) / valori.length);
+  }
+
+  // Livello 2: i sette assi. I nomi vengono dai pesi in database, non da un elenco fisso.
+  const nomiAssi = (db.prepare(
+    `SELECT DISTINCT contenitore FROM pesi WHERE model_version = ? AND livello = 'asse'`
+  ).all(MODEL_VERSION) as { contenitore: string }[]).map((r) => r.contenitore);
+
+  const assi: Record<string, Punteggio> = {};
+  for (const nomeAsse of nomiAssi) {
+    assi[nomeAsse] = calcolaAsse(pesiDi(db, MODEL_VERSION, 'asse', nomeAsse), sottoDominio);
+  }
+
+  // Livello 3: i tre macro-score (Performance/Energy/Recovery).
+  const nomiMacro = (db.prepare(
+    `SELECT DISTINCT contenitore FROM pesi WHERE model_version = ? AND livello = 'macro'`
+  ).all(MODEL_VERSION) as { contenitore: string }[]).map((r) => r.contenitore);
+
+  const macro: Record<string, Punteggio> = {};
+  for (const nomeMacro of nomiMacro) {
+    macro[nomeMacro] = calcolaMacro(pesiDi(db, MODEL_VERSION, 'macro', nomeMacro), assi);
+  }
+
+  // Livello 4: Fitness Age. cardio/forza_resto/composizione/stabilita vengono
+  // dal punteggio intero dell'asse; handgrip_isolato e hrv_isolato dal
+  // sotto-dominio isolato, prima che entri nell'aggregazione del suo asse —
+  // come nell'oracolo, che guarda quei due sotto-domini da soli.
+  const valoreAsse = (nome: string): number | null => {
+    const a = assi[nome];
+    return a && a.stato === 'ok' ? a.valore : null;
+  };
+  const vociFitnessAge: Record<string, number | null> = {
+    cardio: valoreAsse('Cardio-Respiratorio'),
+    handgrip_isolato: sottoDominio.handgrip ?? null,
+    hrv_isolato: sottoDominio.hrv ?? null,
+    forza_resto: valoreAsse('Forza & Struttura'),
+    composizione: valoreAsse('Composizione Corporea'),
+    stabilita: valoreAsse('Stabilità & Mobilità Funzionale'),
+  };
+  const { fitnessAge, composito } = calcolaFitnessAge(
+    sessione.eta_alla_data,
+    pesiDi(db, MODEL_VERSION, 'fitness_age', 'fitness_age'),
+    vociFitnessAge
+  );
+
+  return {
+    assi, macro, fitnessAge, fitnessAgeCopertura: composito.copertura,
+    modelVersion: MODEL_VERSION, questVersion: sessione.quest_version,
+  };
+}
+
+/**
+ * Congela il risultato di `calcolaSessione` nella tabella `score`: una riga
+ * per asse, una per macro-score, una per la Fitness Age. `valore` va a
+ * `null` quando lo stato è insufficiente — il tipo `Punteggio` non porta un
+ * `valore` in quel ramo, quindi non c'è modo di scrivere un numero fasullo.
+ */
+export function salvaScore(db: Database.Database, sessioneId: number, risultato: RisultatoSessione): void {
+  const sessione = db.prepare(`SELECT client_code FROM sessioni WHERE id = ?`).get(sessioneId) as
+    { client_code: string } | undefined;
+  if (!sessione) throw new Error(`sessione ${sessioneId} inesistente`);
+
+  const ins = db.prepare(
+    `INSERT INTO score (client_code, sessione_id, tipo, elemento, valore, copertura, stato, quest_version, model_version)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`
+  );
+
+  const riga = (tipo: 'asse' | 'macro' | 'fitness_age', elemento: string, p: Punteggio): void => {
+    ins.run(
+      sessione.client_code, sessioneId, tipo, elemento,
+      p.stato === 'ok' ? p.valore : null,
+      p.copertura, p.stato, risultato.questVersion, risultato.modelVersion
+    );
+  };
+
+  const tx = db.transaction(() => {
+    for (const [nome, p] of Object.entries(risultato.assi)) riga('asse', nome, p);
+    for (const [nome, p] of Object.entries(risultato.macro)) riga('macro', nome, p);
+    const fitnessAgePunteggio: Punteggio = risultato.fitnessAge === null
+      ? { stato: 'insufficiente', copertura: risultato.fitnessAgeCopertura }
+      : { stato: 'ok', valore: risultato.fitnessAge, copertura: risultato.fitnessAgeCopertura };
+    riga('fitness_age', 'fitness_age', fitnessAgePunteggio);
+  });
+  tx();
+}
+
+/** Esito di `leggiScore`: gli assi, i macro-score e la Fitness Age, tipati come `Punteggio`. */
+export type PunteggiSessione = {
+  assi: Record<string, Punteggio>;
+  macro: Record<string, Punteggio>;
+  /** `null` = nessun calcolo mai salvato per questa sessione (non un composito insufficiente). */
+  fitnessAge: Punteggio | null;
+};
+
+/**
+ * Legge i punteggi congelati di una sessione dalla tabella `score`, tipati come
+ * `Punteggio` — la stessa unione discriminata del resto del motore. Nessuno
+ * legge ancora `score` (la scrive solo `salvaScore`): la prima query cruda che
+ * l'interfaccia scriverà su una colonna nullable perderebbe la barriera del
+ * tipo se restasse un semplice `SELECT *`. Qui non la perde.
+ *
+ * `salvaScore` non ha vincolo di unicità di proposito — la storia si tiene,
+ * non si sovrascrive (discende dal congelamento della §6: sovrascrivere
+ * cancellerebbe cio' che il congelamento protegge). Una sessione ricalcolata
+ * più volte ha quindi più righe per lo stesso tipo/elemento: questa query
+ * dichiara ESPLICITAMENTE il criterio dell'ultimo calcolo (il `MAX(id)` per
+ * tipo+elemento, non l'ordine naturale con cui SQLite restituisce le righe,
+ * che non è un criterio).
+ */
+export function leggiScore(db: Database.Database, sessioneId: number): PunteggiSessione {
+  const righe = db.prepare(
+    `SELECT s.tipo, s.elemento, s.valore, s.copertura, s.stato
+     FROM score s
+     JOIN (
+       SELECT tipo, elemento, MAX(id) AS ultimo_id
+       FROM score
+       WHERE sessione_id = ?
+       GROUP BY tipo, elemento
+     ) ultimo ON ultimo.tipo = s.tipo AND ultimo.elemento = s.elemento AND ultimo.ultimo_id = s.id
+     WHERE s.sessione_id = ?`
+  ).all(sessioneId, sessioneId) as
+    { tipo: 'asse' | 'macro' | 'fitness_age'; elemento: string; valore: number | null; copertura: number; stato: 'ok' | 'insufficiente' }[];
+
+  const aPunteggio = (r: { valore: number | null; copertura: number; stato: 'ok' | 'insufficiente' }): Punteggio =>
+    r.stato === 'ok' ? { stato: 'ok', valore: r.valore as number, copertura: r.copertura } : { stato: 'insufficiente', copertura: r.copertura };
+
+  const assi: Record<string, Punteggio> = {};
+  const macro: Record<string, Punteggio> = {};
+  let fitnessAge: Punteggio | null = null;
+  for (const r of righe) {
+    if (r.tipo === 'asse') assi[r.elemento] = aPunteggio(r);
+    else if (r.tipo === 'macro') macro[r.elemento] = aPunteggio(r);
+    else fitnessAge = aPunteggio(r);
+  }
+  return { assi, macro, fitnessAge };
+}

src/lib/longevity/motore/test-fisici.ts

@@ -0,0 +1,281 @@
+/**
+ * Curve dei test fisici: da misura grezza (kg al dinamometro, secondi di
+ * plank, VO2max stimato...) a punteggio 0-100.
+ *
+ * Porting letterale delle funzioni dell'oracolo del cliente
+ * (`tests/longevity/riferimento/isl_scoring_engine.py`, sezioni «Composizione
+ * Corporea», «Cardio-Respiratorio», «Recupero & Sistema Nervoso», «Forza &
+ * Struttura», «Stabilità & Mobilità»). Coefficienti, soglie e tabelle sono
+ * copiati tali e quali e verificati contro `riferimento.json` in
+ * `tests/longevity/motore-fisici.test.ts`. Non "aggiustare" nulla qui dentro:
+ * l'oracolo è la definizione, non una proposta.
+ *
+ * `score_agility_ms` e `score_generic_range_local` NON sono portate: la prima
+ * perché il cliente ha rimosso l'agilità dallo score il 13/08 (scale non
+ * comparabili fra protocolli), la seconda perché non è mai chiamata da
+ * nessun peso.
+ *
+ * ⚠️ NON COLLEGATE AL MOTORE. Queste venti funzioni sono corrette e verificate
+ * contro l'oracolo (`tests/longevity/motore-fisici.test.ts`), ma oggi sono
+ * irraggiungibili in produzione: `applicaCurva` (`motore/index.ts`) smista solo
+ * sulle sette curve generiche dichiarate nel vocabolario di `registro.ts`
+ * (`bell`, `lin_dec`, `inc_plateau`, `x10`, `x10_inv`, `decstep`, `incstep`) e
+ * non conosce nessun `test_id` fisico; e la sua firma prende `(voce, valore)`,
+ * senza modo di passare età e sesso, che quasi tutte queste funzioni
+ * richiedono. Agganciarle è lavoro del piano degli import, non di questa
+ * revisione, e richiederà di ESTENDERE il vocabolario delle curve e di far
+ * arrivare età/sesso fino ad `applicaCurva` — quindi non sarà "una modifica ai
+ * dati" nel senso in cui lo intende la spec (registro senza migrazioni): serve
+ * anche codice nuovo nel motore, non solo righe nuove in `registro_test`.
+ */
+
+import { clamp, lerp, arrotonda1 } from './curve';
+
+export type Sesso = 'M' | 'F';
+
+/** Come `sex.strip().lower().startswith("m")` nell'oracolo. */
+function eMaschio(sesso: Sesso): boolean {
+  return sesso.trim().toLowerCase().startsWith('m');
+}
+
+// --- Composizione Corporea -------------------------------------------------
+
+/** Curva a campana ACE. Il picco è su Atleti/Fitness, non sul grasso più basso. Come `score_fat_percent`. */
+export function scoreGrassoPercento(fatPct: number, sesso: Sesso): number {
+  const m = eMaschio(sesso);
+  const bands: [number, number, number][] = m
+    ? [[0, 2, 40], [2, 5, 65], [5, 13, 100], [13, 17, 90], [17, 24, 65], [24, 35, 30], [35, 200, 10]]
+    : [[0, 10, 40], [10, 13, 65], [13, 20, 100], [20, 24, 90], [24, 31, 65], [31, 40, 30], [40, 200, 10]];
+  for (const [lo, hi, val] of bands) {
+    if (lo <= fatPct && fatPct < hi) return val;
+  }
+  return 50;
+}
+
+/** Crescente con plateau: uomini 42.9-52.4%, donne 37.8-46.2% (standard device). Come `score_muscle_percent`. */
+export function scoreMuscoloPercento(musclePct: number, sesso: Sesso): number {
+  const [lo, hi] = eMaschio(sesso) ? [42.9, 52.4] : [37.8, 46.2];
+  if (musclePct >= hi) return 100;
+  if (musclePct <= lo - 10) return 20;
+  return arrotonda1(lerp(musclePct, lo - 10, hi, 20, 100));
+}
+
+/** Come `score_whr`. */
+export function scoreWhr(whr: number, sesso: Sesso): number {
+  const threshold = eMaschio(sesso) ? 0.9 : 0.85;
+  if (whr <= threshold - 0.1) return 100;
+  if (whr <= threshold) return arrotonda1(lerp(whr, threshold - 0.1, threshold, 100, 60));
+  return clamp(arrotonda1(60 - (whr - threshold) * 300));
+}
+
+// --- Cardio-Respiratorio ----------------------------------------------------
+
+/** Queen's College Step Test (McArdle et al. 1972). Come `vo2max_from_step_test`. */
+export function vo2maxDaStepTest(hrRecovery: number, sesso: Sesso): number {
+  if (eMaschio(sesso)) return 111.33 - 0.42 * hrRecovery;
+  return 65.81 - 0.1847 * hrRecovery;
+}
+
+/** UKK 2km Walking Test (Laukkanen/Oja). Come `vo2max_from_2km_walk`. */
+export function vo2maxDa2kmWalk(tempoMin: number, hr: number, eta: number, bmi: number): number {
+  return 116.2 - 2.98 * tempoMin - 0.11 * hr - 0.14 * eta - 0.39 * bmi;
+}
+
+/** Formula ACSM su VAM raggiunta al tapis. Teorico/stimato. Come `vo2max_from_mutt`. */
+export function vo2maxDaMutt(vamMMin: number): number {
+  return 0.2 * vamMMin + 3.5;
+}
+
+/** Formula ACSM cicloergometro. Teorico/stimato, valida 50-200W. Come `vo2max_from_milfit`. */
+export function vo2maxDaMilfit(watt: number, pesoKg: number): number {
+  return (10.8 * watt) / pesoKg + 7;
+}
+
+/** ACSM/FRIEND Registry, bande approssimate per fascia d'età e sesso. Come `score_vo2max`. */
+export function scoreVo2max(vo2max: number, eta: number, sesso: Sesso): number {
+  const m = eMaschio(sesso);
+  // soglie 'buono' per decade (uomini), interpolate da FRIEND Registry
+  const goodThresholdsM: Record<number, number> = { 20: 46, 30: 43, 40: 42, 50: 38, 60: 35, 70: 30 };
+  const goodThresholdsF: Record<number, number> = { 20: 38, 30: 37, 40: 34, 50: 30, 60: 27, 70: 23 };
+  const table = m ? goodThresholdsM : goodThresholdsF;
+  const decade = Math.min(70, Math.max(20, Math.floor(eta / 10) * 10));
+  const good = table[decade];
+  const poor = good * 0.65;
+  const superior = good * 1.35;
+  if (vo2max <= poor) return clamp(arrotonda1(lerp(vo2max, 0, poor, 10, 40)));
+  if (vo2max <= good) return arrotonda1(lerp(vo2max, poor, good, 40, 70));
+  return clamp(arrotonda1(lerp(vo2max, good, superior, 70, 100)));
+}
+
+/** Saturazione O2: 95-100% normale, sotto 90% campanello d'allarme clinico. Come `score_spo2`. */
+export function scoreSpo2(spo2Pct: number): number {
+  if (spo2Pct >= 97) return 100;
+  if (spo2Pct >= 95) return 85;
+  if (spo2Pct >= 90) return 50;
+  return 15;
+}
+
+// --- Recupero & Sistema Nervoso --------------------------------------------
+
+/** ESC/ESH 2018. Vale la categoria più alta tra sistolica e diastolica. Come `score_blood_pressure`. */
+export function scorePressione(sistolica: number, diastolica: number): number {
+  if (sistolica >= 180 || diastolica >= 110) return 5;
+  if (sistolica >= 160 || diastolica >= 100) return 25;
+  if (sistolica >= 140 || diastolica >= 90) return 45;
+  if (sistolica >= 130 || diastolica >= 85) return 70;
+  if (sistolica >= 120 || diastolica >= 80) return 90;
+  return 100;
+}
+
+/** Recupero cardiaco 1' post-sforzo. >=12bpm considerato normale (Cole et al. 1999). Come `score_hrr`. */
+export function scoreRecuperoCardiaco(caloBpm1min: number): number {
+  if (caloBpm1min >= 12) return clamp(arrotonda1(lerp(caloBpm1min, 12, 30, 70, 100)));
+  return clamp(arrotonda1(lerp(caloBpm1min, 0, 12, 20, 70)));
+}
+
+// --- Forza & Struttura -------------------------------------------------------
+
+/**
+ * Approssimazione da NIH Toolbox / Dodds et al. Curva discendente con l'età.
+ * Come `score_handgrip`.
+ *
+ * L'oracolo usa un `for...else` di Python: se il ciclo trova l'intervallo fra
+ * due ancore, fa `break` con `mean_val` calcolato; se lo esaurisce senza mai
+ * entrare nel ramo, l'`else` del `for` scatta e vale l'ultima ancora. In
+ * TypeScript non esiste il for-else: lo si riproduce con un flag.
+ */
+export function scoreHandgrip(kg: number, eta: number, sesso: Sesso): number {
+  const m = eMaschio(sesso);
+  // ancore (età, valore medio kg) approssimate dalla letteratura citata
+  const anchorsM: [number, number][] = [[25, 49.7], [40, 46], [60, 38], [75, 30]];
+  const anchorsF: [number, number][] = [[25, 30], [40, 28], [60, 24], [75, 18.7]];
+  const anchors = m ? anchorsM : anchorsF;
+  const etaC = clamp(eta, 25, 75);
+  let meanVal: number | undefined;
+  for (let i = 0; i < anchors.length - 1; i++) {
+    const [aEta, aVal] = anchors[i];
+    const [bEta, bVal] = anchors[i + 1];
+    if (aEta <= etaC && etaC <= bEta) {
+      meanVal = lerp(etaC, aEta, bEta, aVal, bVal);
+      break;
+    }
+  }
+  if (meanVal === undefined) meanVal = anchors[anchors.length - 1][1];
+  // media = punteggio 70; +/- 40% della media copre la banda 20-100
+  const ratio = meanVal ? kg / meanVal : 1;
+  return clamp(arrotonda1(lerp(ratio, 0.5, 1.5, 20, 100)));
+}
+
+/** ACSM/CSEP, bande approssimate per decade. Come `score_pushup`. */
+export function scorePushup(reps: number, eta: number, sesso: Sesso): number {
+  const m = eMaschio(sesso);
+  const baseGoodM = 22;
+  const baseGoodF = 15; // 35-39 anni, 'buono' minimo
+  const decadeOffset = Math.max(0, Math.floor((eta - 35) / 10)) * 2.5; // calo ~2.5 rip/decade dopo i 35
+  const good = (m ? baseGoodM : baseGoodF) - decadeOffset;
+  const superior = good * 1.6;
+  const poor = good * 0.5;
+  if (reps <= poor) return clamp(arrotonda1(lerp(reps, 0, poor, 10, 40)));
+  if (reps <= good) return arrotonda1(lerp(reps, poor, good, 40, 70));
+  return clamp(arrotonda1(lerp(reps, good, superior, 70, 100)));
+}
+
+/** Generico per 5RM->1RM(Brzycki)->rapporto peso corporeo, su tiers (beg/nov/int/adv/elite). Come `score_bw_ratio_lift`. */
+export function scoreSollevamentoSuPeso(
+  caricoKg: number,
+  pesoKg: number,
+  rip: number,
+  tiersM: [number, number][],
+  tiersF: [number, number][],
+  sesso: Sesso
+): number {
+  const rm1 = (caricoKg * 36) / (37 - rip); // Brzycki
+  const ratio = rm1 / pesoKg;
+  const tiers = eMaschio(sesso) ? tiersM : tiersF;
+  // tiers = [(soglia_ratio, punteggio), ...] crescente
+  let prevR = 0;
+  let prevS = 10;
+  for (const [r, s] of tiers) {
+    if (ratio <= r) return arrotonda1(lerp(ratio, prevR, r, prevS, s));
+    prevR = r;
+    prevS = s;
+  }
+  return 100;
+}
+
+export const TIERS_BENCH_M: [number, number][] = [[0.5, 30], [1.0, 60], [1.25, 80], [1.5, 100]];
+export const TIERS_BENCH_F: [number, number][] = [[0.3, 30], [0.6, 60], [0.75, 80], [1.0, 100]];
+export const TIERS_SQUAT_M: [number, number][] = [[0.75, 30], [1.5, 60], [1.75, 80], [2.0, 100]];
+export const TIERS_SQUAT_F: [number, number][] = [[0.5, 30], [1.1, 60], [1.3, 80], [1.5, 100]];
+export const TIERS_ROW_M: [number, number][] = [[0.45, 30], [0.70, 60], [0.95, 80], [1.20, 100]];
+export const TIERS_ROW_F: [number, number][] = [[0.30, 30], [0.45, 60], [0.60, 80], [0.80, 100]];
+
+/** Come `score_flexed_arm_hang`. */
+export function scoreTrazioneIsometrica(sec: number, sesso: Sesso): number {
+  const [good, superior] = eMaschio(sesso) ? [45, 70] : [25, 50];
+  if (sec <= good * 0.4) return clamp(arrotonda1(lerp(sec, 0, good * 0.4, 10, 40)));
+  if (sec <= good) return arrotonda1(lerp(sec, good * 0.4, good, 40, 70));
+  return clamp(arrotonda1(lerp(sec, good, superior, 70, 100)));
+}
+
+/** Reference equation adulti 18-95 (Zalewski et al.-style). Come `score_sit_to_stand_1min`. */
+export function scoreSitToStand(reps: number, eta: number, sesso: Sesso, bmi = 24): number {
+  const sexCode = eMaschio(sesso) ? 0 : 1;
+  const predicted = 61.53 - 0.34 * eta - 3.57 * sexCode - 0.33 * bmi;
+  const ratio = predicted ? reps / predicted : 1;
+  return clamp(arrotonda1(lerp(ratio, 0.5, 1.3, 20, 100)));
+}
+
+/** Come `score_plank`. */
+export function scorePlank(sec: number, sesso: Sesso): number {
+  const bandsM: [number, number][] = [[79, 20], [97, 40], [122, 55], [157, 75], [201, 90]];
+  const bandsF: [number, number][] = [[35, 20], [63, 40], [84, 55], [108, 75], [142, 90]];
+  const bands = eMaschio(sesso) ? bandsM : bandsF;
+  let prevT = 0;
+  let prevS = 10;
+  for (const [t, s] of bands) {
+    if (sec <= t) return arrotonda1(lerp(sec, prevT, t, prevS, s));
+    prevT = t;
+    prevS = s;
+  }
+  return 100;
+}
+
+// --- Stabilità & Mobilità ----------------------------------------------------
+
+/**
+ * Rikli & Jones (Senior Fitness Test) + studio norvegese per fascia under 60.
+ * Positivo=sovrapposizione dita, negativo=distanza. Anchor a 62 anni (dato
+ * solido), estrapolato linearmente (~4cm/5 anni) per le altre età.
+ * Approssimazione da dichiarare, non tabella completa. Come `score_back_scratch`.
+ */
+export function scoreBackScratch(cm: number, eta: number, sesso: Sesso): number {
+  const m = eMaschio(sesso);
+  const anchorEta = 62;
+  const anchorCm = m ? -8.6 : -1.8;
+  const declinePerYear = 0.8; // cm peggioramento per anno di età in più
+  const expected = anchorCm - (eta - anchorEta) * declinePerYear;
+  // punteggio: 0/pieno contatto (0cm) o sovrapposizione (positivo) = ottimo
+  const diff = cm - expected;
+  return clamp(arrotonda1(lerp(diff, -15, 15, 20, 100)));
+}
+
+/** Wellness Tower, riferimento 180 gradi (outreach/buckling). Come `score_shoulder_mobility_wt`. */
+export function scoreMobilitaSpalla(outreachDeg: number, bucklingDeg: number): number {
+  const avg = (outreachDeg + bucklingDeg) / 2;
+  return clamp(arrotonda1((avg / 180) * 100));
+}
+
+/** Decrescente: meno cadute = meglio. Come `score_flamingo`. */
+export function scoreFlamingo(cadute: number): number {
+  if (cadute <= 3) return 100;
+  if (cadute <= 7) return arrotonda1(lerp(cadute, 3, 7, 100, 80));
+  if (cadute <= 15) return arrotonda1(lerp(cadute, 7, 15, 80, 50));
+  return clamp(arrotonda1(lerp(cadute, 15, 30, 50, 10)));
+}
+
+/** Come `score_sit_and_reach`. */
+export function scoreSitAndReach(cm: number, sesso: Sesso): number {
+  const median = eMaschio(sesso) ? 24 : 31;
+  return clamp(arrotonda1(lerp(cm, median - 20, median + 10, 20, 100)));
+}

src/lib/longevity/questionario.ts

@@ -0,0 +1,64 @@
+import type Database from 'better-sqlite3';
+import { apriSessione, registraMisure } from './misure';
+import { esisteTest } from './registro';
+
+/** Versione del set di domande. Si incrementa quando cambia una domanda. */
+export const QUEST_VERSION = 'v1.0';
+
+/** Versione del TESTO del consenso al trattamento dei dati sanitari — distinta da
+ * QUEST_VERSION apposta: se cambia la formulazione del consenso senza che cambi una
+ * domanda del questionario, il record del consenso deve poterlo dire. Prima di questa
+ * costante il record portava QUEST_VERSION, la versione sbagliata. */
+export const CONSENT_VERSION = 'v1.0';
+
+/**
+ * Campi testuali che si salvano ma non entrano MAI in una formula
+ * (indicazione esplicita del cliente, punto 7 della specifica).
+ */
+export const CAMPI_LIBERI = ['farmaci', 'problematiche_attuali', 'problematiche_pregresse', 'obiettivi'];
+
+export function salvaCompilazione(
+  db: Database.Database,
+  input: {
+    client_code: string; data: string; eta?: number;
+    risposte: Record<string, number>;
+    liberi?: Record<string, string>;
+  }
+): number {
+  // Validare PRIMA della transazione: se un test_id è sconosciuto, non apriamo
+  // nemmeno una sessione. La validazione non è nel corpo della transazione.
+  for (const id of Object.keys(input.risposte)) {
+    if (!esisteTest(db, id)) throw new Error(`test_id non nel registro: ${id}`);
+  }
+
+  // Avvolgi le tre scritture (apertura sessione, registra misure, inserisci note)
+  // in un'unica transazione: tutto o niente, senza tracce parziali su dati sanitari.
+  const tx = db.transaction(() => {
+    const sessioneId = apriSessione(db, {
+      client_code: input.client_code,
+      data: input.data,
+      tipo: 'questionario',
+      eta_alla_data: input.eta,
+      quest_version: QUEST_VERSION,
+    });
+
+    registraMisure(
+      db, sessioneId, 'questionario',
+      Object.entries(input.risposte).map(([test_id, valore_num]) => ({ test_id, valore_num }))
+    );
+
+    if (input.liberi) {
+      const ins = db.prepare(
+        `INSERT INTO profilo_note (client_code, sessione_id, campo_id, testo) VALUES (?, ?, ?, ?)`
+      );
+      for (const [campo, testo] of Object.entries(input.liberi)) {
+        if (testo.trim() === '') continue;
+        ins.run(input.client_code, sessioneId, campo, testo);
+      }
+    }
+
+    return sessioneId;
+  });
+
+  return tx();
+}

src/lib/longevity/registro.ts

@@ -0,0 +1,199 @@
+import type Database from 'better-sqlite3';
+
+export type Curva = 'bell' | 'lin_dec' | 'inc_plateau' | 'x10' | 'x10_inv' | 'decstep' | 'incstep';
+
+/** Versione del modello di calcolo: curve e pesi. Distinta da QUEST_VERSION, che versiona le domande. */
+export const MODEL_VERSION = 'v1.0';
+
+export type VoceRegistro = {
+  test_id: string;
+  etichetta: string;
+  unita?: string;
+  tipo_valore: 'num' | 'txt';
+  curva?: Curva;
+  params?: unknown;
+  asse?: string;
+  sotto_dominio?: string;
+  range_min?: number;
+  range_max?: number;
+  attivo_da: string;
+  attivo_a?: string;
+};
+
+const DA = '2026-01-01';
+
+// I 20 campi punteggiati, presi dal prototipo del cliente (questionario_longevity_score.html).
+// Gli id portano il prefisso q_ per distinguerli dai test fisici; i params sono nella forma
+// dichiarata per ciascuna curva, non nell'array posizionale del prototipo.
+const QUESTIONARIO: VoceRegistro[] = [
+  { test_id: 'q_ore_sonno', etichetta: 'Ore di sonno per notte (media)', unita: 'h', tipo_valore: 'num',
+    curva: 'bell', params: { low: 4, peakLow: 7, peakHigh: 9, high: 12 },
+    asse: 'Recupero & Sistema Nervoso', sotto_dominio: 'questionario_sonno', range_min: 0, range_max: 14, attivo_da: DA },
+  { test_id: 'q_min_addorm', etichetta: 'Minuti per addormentarti', unita: 'min', tipo_valore: 'num',
+    curva: 'decstep', params: { steps: [[15, 100], [30, 75], [60, 50], [999, 25]] },
+    asse: 'Recupero & Sistema Nervoso', sotto_dominio: 'questionario_sonno', range_min: 0, range_max: 180, attivo_da: DA },
+  { test_id: 'q_risvegli', etichetta: 'Risvegli notturni (numero)', tipo_valore: 'num',
+    curva: 'decstep', params: { steps: [[0, 100], [1, 80], [2, 50], [999, 25]] },
+    asse: 'Recupero & Sistema Nervoso', sotto_dominio: 'questionario_sonno', range_min: 0, range_max: 10, attivo_da: DA },
+  { test_id: 'q_riposato', etichetta: 'Quanto ti senti riposato al risveglio', tipo_valore: 'num',
+    curva: 'x10', params: {}, asse: 'Recupero & Sistema Nervoso', sotto_dominio: 'questionario_sonno',
+    range_min: 0, range_max: 10, attivo_da: DA },
+  { test_id: 'q_caffeina', etichetta: 'Caffeina dopo le 16:00 (volte/settimana)', tipo_valore: 'num',
+    curva: 'lin_dec', params: { best: 0, worst: 7 },
+    asse: 'Recupero & Sistema Nervoso', sotto_dominio: 'questionario_sonno', range_min: 0, range_max: 14, attivo_da: DA },
+  { test_id: 'q_sonnolenza_diurna', etichetta: 'Sonnolenza/fatica a concentrarti durante il giorno (volte/settimana)',
+    tipo_valore: 'num', curva: 'lin_dec', params: { best: 0, worst: 7 },
+    asse: 'Recupero & Sistema Nervoso', sotto_dominio: 'questionario_sonno', range_min: 0, range_max: 14, attivo_da: DA },
+
+  { test_id: 'q_energia_media', etichetta: 'Energia media nella giornata, ultima settimana', tipo_valore: 'num',
+    curva: 'x10', params: {}, asse: 'Energia & Regolazione Stress', sotto_dominio: 'questionario_energia_stress',
+    range_min: 0, range_max: 10, attivo_da: DA },
+  { test_id: 'q_esaurimento', etichetta: 'Episodi di esaurimento senza motivo fisico (volte/sett.)', tipo_valore: 'num',
+    curva: 'lin_dec', params: { best: 0, worst: 7 },
+    asse: 'Energia & Regolazione Stress', sotto_dominio: 'questionario_energia_stress', range_min: 0, range_max: 14, attivo_da: DA },
+  { test_id: 'q_calo_pomeridiano', etichetta: 'Quanto forte e il calo di energia dal mattino al pomeriggio',
+    tipo_valore: 'num', curva: 'x10_inv', params: {},
+    asse: 'Energia & Regolazione Stress', sotto_dominio: 'questionario_energia_stress', range_min: 0, range_max: 10, attivo_da: DA },
+
+  { test_id: 'q_sopraffatto', etichetta: 'Sopraffatto da imprevisti (volte/mese)', tipo_valore: 'num',
+    curva: 'decstep', params: { steps: [[2, 100], [5, 70], [10, 40], [999, 20]] },
+    asse: 'Energia & Regolazione Stress', sotto_dominio: 'questionario_energia_stress', range_min: 0, range_max: 30, attivo_da: DA },
+  { test_id: 'q_controllo', etichetta: 'Percezione di controllo sulla tua vita', tipo_valore: 'num',
+    curva: 'x10', params: {}, asse: 'Energia & Regolazione Stress', sotto_dominio: 'questionario_energia_stress',
+    range_min: 0, range_max: 10, attivo_da: DA },
+  { test_id: 'q_sicurezza_gestione', etichetta: 'Ti senti sicuro/a nella tua capacita di gestire i problemi personali',
+    tipo_valore: 'num', curva: 'x10', params: {},
+    asse: 'Energia & Regolazione Stress', sotto_dominio: 'questionario_energia_stress', range_min: 0, range_max: 10, attivo_da: DA },
+  { test_id: 'q_tensione', etichetta: 'Tensione/irritabilita (volte/settimana)', tipo_valore: 'num',
+    curva: 'lin_dec', params: { best: 0, worst: 7 },
+    asse: 'Energia & Regolazione Stress', sotto_dominio: 'questionario_energia_stress', range_min: 0, range_max: 14, attivo_da: DA },
+  { test_id: 'q_pensieri_lavoro', etichetta: 'Ore/giorno di pensieri di lavoro fuori orario', unita: 'h',
+    tipo_valore: 'num', curva: 'lin_dec', params: { best: 0, worst: 4 },
+    asse: 'Energia & Regolazione Stress', sotto_dominio: 'questionario_energia_stress', range_min: 0, range_max: 8, attivo_da: DA },
+
+  { test_id: 'q_attivita', etichetta: 'Giorni/settimana attivita fisica extra ISL', tipo_valore: 'num',
+    curva: 'incstep', params: { steps: [[0, 20], [2, 50], [4, 80], [999, 100]] },
+    asse: 'Stile di Vita & Sonno', sotto_dominio: 'questionario_lifestyle', range_min: 0, range_max: 7, attivo_da: DA },
+  { test_id: 'q_alimentazione', etichetta: 'Qualita percepita alimentazione abituale', tipo_valore: 'num',
+    curva: 'x10', params: {}, asse: 'Stile di Vita & Sonno', sotto_dominio: 'questionario_lifestyle',
+    range_min: 0, range_max: 10, attivo_da: DA },
+  { test_id: 'q_sigarette', etichetta: 'Sigarette al giorno', tipo_valore: 'num',
+    curva: 'decstep', params: { steps: [[0, 100], [5, 60], [10, 40], [20, 20], [999, 0]] },
+    asse: 'Stile di Vita & Sonno', sotto_dominio: 'questionario_lifestyle', range_min: 0, range_max: 40, attivo_da: DA },
+  // Soglia 0-7 = punteggio pieno: scelta deliberata del cliente (basso rischio NIAAA/WHO),
+  // confermata il 21/08. Non e' un refuso per 0=100 -> 7=0.
+  { test_id: 'q_alcol_life', etichetta: 'Unita alcoliche/settimana', tipo_valore: 'num',
+    curva: 'lin_dec', params: { best: 7, worst: 14 },
+    asse: 'Stile di Vita & Sonno', sotto_dominio: 'questionario_lifestyle', range_min: 0, range_max: 30, attivo_da: DA },
+  { test_id: 'q_luce', etichetta: 'Ore/giorno luce naturale/esterno', unita: 'h', tipo_valore: 'num',
+    curva: 'incstep', params: { steps: [[0.5, 60], [1, 90], [999, 100]], zeroVal: 20 },
+    asse: 'Stile di Vita & Sonno', sotto_dominio: 'questionario_lifestyle', range_min: 0, range_max: 8, attivo_da: DA },
+  { test_id: 'q_schermi', etichetta: 'Minuti schermi nell\'ora pre-sonno', unita: 'min', tipo_valore: 'num',
+    curva: 'decstep', params: { steps: [[15, 85], [30, 70], [60, 40], [999, 10]], zeroVal: 100 },
+    asse: 'Stile di Vita & Sonno', sotto_dominio: 'questionario_lifestyle', range_min: 0, range_max: 90, attivo_da: DA },
+];
+
+export function seedRegistro(db: Database.Database): void {
+  const ins = db.prepare(
+    `INSERT OR REPLACE INTO registro_test
+       (test_id, etichetta, unita, tipo_valore, curva, params, asse, sotto_dominio,
+        range_min, range_max, attivo_da, attivo_a, note)
+     VALUES (@test_id, @etichetta, @unita, @tipo_valore, @curva, @params, @asse, @sotto_dominio,
+             @range_min, @range_max, @attivo_da, @attivo_a, @note)`
+  );
+  const tx = db.transaction((voci: VoceRegistro[]) => {
+    for (const v of voci) {
+      ins.run({
+        test_id: v.test_id, etichetta: v.etichetta, unita: v.unita ?? null,
+        tipo_valore: v.tipo_valore, curva: v.curva ?? null,
+        params: v.params === undefined ? null : JSON.stringify(v.params),
+        asse: v.asse ?? null, sotto_dominio: v.sotto_dominio ?? null,
+        range_min: v.range_min ?? null, range_max: v.range_max ?? null,
+        attivo_da: v.attivo_da, attivo_a: v.attivo_a ?? null, note: null,
+      });
+    }
+  });
+  tx(QUESTIONARIO);
+}
+
+// Pesi presi dal motore del cliente (AXIS_SUBDOMAIN_WEIGHTS, MACRO_SCORE_WEIGHTS,
+// FITNESS_AGE_WEIGHTS). I macro con peso 0 non si inseriscono: assenza e zero sono
+// la stessa cosa per la rinormalizzazione, e una riga a zero confonde chi legge.
+// ⚠️ Il plank compare volutamente in DUE assi: 'core' in Forza & Struttura (0.15) e
+// 'plank' in Stabilità & Mobilità (0.20). Confermato da Nicola il 22/08 e motivato:
+// il plank non è forza pura, richiede controllo neuromuscolare del tronco, quindi
+// contribuisce davvero a entrambi i domini che misura. Non è un refuso da correggere.
+const PESI_ASSE: Record<string, Record<string, number>> = {
+  'Forza & Struttura': { handgrip: 0.25, spinta: 0.20, trazione: 0.20, arti_inferiori: 0.20, core: 0.15 },
+  'Composizione Corporea': { grasso: 0.40, muscolo: 0.35, whr: 0.25 },
+  'Cardio-Respiratorio': { vo2max: 0.60, spirometria: 0.20, wellness_tower_cardio: 0.20 },
+  'Recupero & Sistema Nervoso': { hrv: 0.50, pressione: 0.15, hrr: 0.15, questionario_sonno: 0.20 },
+  'Energia & Regolazione Stress': { hrv: 0.50, questionario_energia_stress: 0.50 },
+  'Stabilità & Mobilità Funzionale': { flamingo: 0.35, sit_and_reach: 0.25, plank: 0.20, back_scratch: 0.14, wellness_tower_shoulder: 0.06 },
+  'Stile di Vita & Sonno': { questionario_lifestyle: 1.00 },
+};
+
+const PESI_MACRO: Record<string, Record<string, number>> = {
+  PERFORMANCE: {
+    'Forza & Struttura': 0.25, 'Cardio-Respiratorio': 0.25, 'Composizione Corporea': 0.15,
+    'Stabilità & Mobilità Funzionale': 0.20, 'Recupero & Sistema Nervoso': 0.10,
+    'Energia & Regolazione Stress': 0.05,
+  },
+  ENERGY: {
+    'Energia & Regolazione Stress': 0.30, 'Stile di Vita & Sonno': 0.20,
+    'Recupero & Sistema Nervoso': 0.25, 'Cardio-Respiratorio': 0.15, 'Composizione Corporea': 0.10,
+  },
+  RECOVERY: {
+    'Recupero & Sistema Nervoso': 0.45, 'Energia & Regolazione Stress': 0.15,
+    'Stile di Vita & Sonno': 0.20, 'Stabilità & Mobilità Funzionale': 0.15, 'Forza & Struttura': 0.05,
+  },
+};
+
+const PESI_FITNESS_AGE: Record<string, number> = {
+  cardio: 0.30, handgrip_isolato: 0.20, hrv_isolato: 0.20,
+  forza_resto: 0.15, composizione: 0.10, stabilita: 0.05,
+};
+
+export function seedPesi(db: Database.Database, modelVersion: string): void {
+  const ins = db.prepare(
+    `INSERT OR REPLACE INTO pesi (model_version, livello, contenitore, elemento, peso)
+     VALUES (?, ?, ?, ?, ?)`
+  );
+  const tx = db.transaction(() => {
+    for (const [asse, sd] of Object.entries(PESI_ASSE))
+      for (const [el, p] of Object.entries(sd)) ins.run(modelVersion, 'asse', asse, el, p);
+    for (const [macro, assi] of Object.entries(PESI_MACRO))
+      for (const [el, p] of Object.entries(assi)) ins.run(modelVersion, 'macro', macro, el, p);
+    for (const [el, p] of Object.entries(PESI_FITNESS_AGE))
+      ins.run(modelVersion, 'fitness_age', 'fitness_age', el, p);
+  });
+  tx();
+}
+
+export function testAttivi(db: Database.Database, alla: string): VoceRegistro[] {
+  const righe = db.prepare(
+    `SELECT * FROM registro_test
+     WHERE attivo_da <= ? AND (attivo_a IS NULL OR attivo_a > ?)
+     ORDER BY test_id`
+  ).all(alla, alla) as Record<string, unknown>[];
+  return righe.map((r) => ({
+    ...r,
+    params: r.params ? JSON.parse(r.params as string) : undefined,
+  })) as VoceRegistro[];
+}
+
+export function esisteTest(db: Database.Database, testId: string): boolean {
+  const r = db.prepare(`SELECT 1 FROM registro_test WHERE test_id = ?`).get(testId);
+  return r !== undefined;
+}
+
+/** I pesi di un contenitore (un asse, un macro-score o la Fitness Age) per la versione del modello data. */
+export function pesiDi(
+  db: Database.Database, modelVersion: string,
+  livello: 'asse' | 'macro' | 'fitness_age', contenitore: string
+): Record<string, number> {
+  const righe = db.prepare(
+    `SELECT elemento, peso FROM pesi WHERE model_version = ? AND livello = ? AND contenitore = ?`
+  ).all(modelVersion, livello, contenitore) as { elemento: string; peso: number }[];
+  return Object.fromEntries(righe.map((r) => [r.elemento, r.peso]));
+}

src/lib/longevity/vista.ts

@@ -0,0 +1,250 @@
+//
+// La vista che il questionario in pagina usa. Due responsabilità:
+// - campiDelQuestionario: i campi del modulo, letti dal registro (mai una lista nel
+//   codice) — aggiungere o disattivare una domanda resta una modifica ai dati.
+// - salvaDalForm: il salvataggio, con la sola regola che conta davvero — il consenso al
+//   trattamento dei dati sanitari va DATO, non solo compilato. Il prototipo del cliente
+//   salvava anche con "No" perché controllava solo che il campo non fosse vuoto: qui il
+//   consenso si verifica PRIMA di scrivere qualsiasi altra cosa, e un rifiuto non apre
+//   nessuna sessione. Il rifiuto stesso si registra comunque: è un fatto (chi, quando, a
+//   cosa) che un domani va dimostrato tanto quanto un assenso.
+import type Database from 'better-sqlite3';
+import { testAttivi, pesiDi, MODEL_VERSION } from './registro';
+import { salvaCompilazione, CONSENT_VERSION } from './questionario';
+import { leggiScore, calcolaSessione, salvaScore } from './motore';
+
+export type CampoQuestionario = {
+  id: string;
+  etichetta: string;
+  tipo: 'num' | 'txt';
+  unita?: string;
+  min?: number;
+  max?: number;
+  sottoDominio?: string;
+};
+
+/** I campi del modulo alla data indicata: solo i test_id del questionario (prefisso
+ * `q_`, per non confonderli con quelli dei test fisici), attivi a quella data. */
+export function campiDelQuestionario(db: Database.Database, alla: string): CampoQuestionario[] {
+  return testAttivi(db, alla)
+    .filter((v) => v.test_id.startsWith('q_'))
+    .map((v) => ({
+      id: v.test_id,
+      etichetta: v.etichetta,
+      tipo: v.tipo_valore,
+      unita: v.unita,
+      min: v.range_min,
+      max: v.range_max,
+      sottoDominio: v.sotto_dominio,
+    }));
+}
+
+export type EsitoSalvataggio =
+  | { ok: true; sessioneId: number }
+  | { ok: false; errore: string };
+
+const CONSENSI_AFFERMATIVI = new Set(['si', 'sì']);
+
+function consensoDato(risposta: string): boolean {
+  return CONSENSI_AFFERMATIVI.has(risposta.trim().toLowerCase());
+}
+
+/** Registra il fatto del consenso — chi, quando, a che versione del TESTO del consenso
+ * (CONSENT_VERSION, non QUEST_VERSION: il consenso può cambiare formulazione senza che
+ * cambi una domanda) — indipendentemente dall'esito. Legata al cliente sempre; alla
+ * sessione solo quando il consenso è affermativo e la sessione esiste davvero. */
+function registraConsenso(
+  db: Database.Database, clientCode: string, sessioneId: number | null, risposta: string
+): void {
+  const esito = risposta.trim() === '' ? '(non risposto)' : risposta.trim();
+  const oggi = new Date().toISOString().slice(0, 10);
+  const testo = `Consenso al trattamento dei dati sanitari: ${esito} — consenso ${CONSENT_VERSION}, registrato il ${oggi}`;
+  db.prepare(
+    `INSERT INTO profilo_note (client_code, sessione_id, campo_id, testo) VALUES (?, ?, ?, ?)`
+  ).run(clientCode, sessioneId, 'consenso_sanitario', testo);
+}
+
+/**
+ * Il salvataggio dal form del questionario. Il consenso si controlla PRIMA di scrivere
+ * qualunque altra cosa: se non è affermativo, non si apre nessuna sessione — né misure né
+ * note di profilo — e la compilazione non entra nel fascicolo. La nota del consenso si
+ * scrive comunque, con l'esito letterale ricevuto.
+ *
+ * Quando il consenso è affermativo, TUTTO il resto avviene in un'unica transazione (il
+ * salvataggio dei dati sanitari, il calcolo dei punteggi e il congelamento in `score`, la
+ * nota di consenso): o entra tutto nel fascicolo, o non entra niente. Prima di questa
+ * correzione il calcolo restava scollegato dal salvataggio — nessuno chiamava
+ * calcolaSessione/salvaScore in produzione — e la nota di consenso si scriveva fuori dalla
+ * transazione, quindi un fallimento lì poteva lasciare dati sanitari senza il consenso che
+ * li giustifica. `db.transaction` di better-sqlite3 annida automaticamente con savepoint
+ * quelle interne di `salvaCompilazione` e `salvaScore`.
+ */
+export function salvaDalForm(
+  db: Database.Database,
+  input: {
+    client_code: string; data: string; eta?: number;
+    risposte: Record<string, number>;
+    consensoSanitario: string;
+    liberi?: Record<string, string>;
+  }
+): EsitoSalvataggio {
+  if (!consensoDato(input.consensoSanitario)) {
+    registraConsenso(db, input.client_code, null, input.consensoSanitario);
+    return {
+      ok: false,
+      errore: 'Senza consenso al trattamento dei dati sanitari la compilazione non viene salvata.',
+    };
+  }
+
+  const tx = db.transaction(() => {
+    const sessioneId = salvaCompilazione(db, {
+      client_code: input.client_code,
+      data: input.data,
+      eta: input.eta,
+      risposte: input.risposte,
+      liberi: input.liberi,
+    });
+
+    // Il calcolo e il congelamento dei punteggi sono parte del salvataggio, non un passo
+    // successivo affidato a chi legge: senza questo, una compilazione restava per sempre
+    // senza i suoi punteggi.
+    salvaScore(db, sessioneId, calcolaSessione(db, sessioneId));
+
+    registraConsenso(db, input.client_code, sessioneId, input.consensoSanitario);
+
+    return sessioneId;
+  });
+
+  return { ok: true, sessioneId: tx() };
+}
+
+//
+// Il referto che il cliente legge: il radar a sette assi e le carte dei macro-score.
+// Due regole non negoziabili, entrambe già chiuse a monte, non da questo modulo:
+// - il valore viene da `leggiScore` (punteggi congelati in `score`), mai da un
+//   ricalcolo — cambiare i pesi non deve mai cambiare un referto già emesso;
+// - un asse/macro insufficiente non porta un `valore` (resta `null`): è il tipo
+//   `Punteggio` del motore che lo rende impossibile da violare per distrazione.
+//
+
+/** Un asse del radar: il valore (assente se il dato non basta), la copertura di peso
+ * disponibile e — solo quando manca — l'elenco leggibile di cosa lo completerebbe. */
+export type AsseVista = { nome: string; valore: number | null; copertura: number; mancano: string[] };
+
+/** Una carta di macro-score: stesso principio degli assi, senza l'elenco di cosa manca
+ * (il "cosa manca" si legge scendendo ai sette assi, non qui). */
+export type MacroVista = { nome: string; valore: number | null; copertura: number };
+
+/**
+ * Le etichette leggibili dei sotto-domini che alimentano un asse: le chiavi sono quelle
+ * di `PESI_ASSE` in registro.ts. Non tutte hanno oggi una riga in `registro_test` — i
+ * test fisici (handgrip, VO2max, plank...) arrivano con un piano successivo, il
+ * questionario è l'unica fonte di misure che esiste davvero — quindi la traduzione non
+ * può venire da lì: è dato locale a questo modulo, non duplica il registro, lo completa
+ * dove il registro non arriva ancora.
+ */
+const ETICHETTE_SOTTO_DOMINIO: Record<string, string> = {
+  handgrip: 'Forza di presa (handgrip)',
+  spinta: 'Test di spinta (push-up o panca)',
+  trazione: 'Test di trazione',
+  arti_inferiori: 'Test arti inferiori',
+  core: 'Test del core (plank)',
+  grasso: 'Composizione corporea — massa grassa',
+  muscolo: 'Composizione corporea — massa muscolare',
+  whr: 'Rapporto vita-fianchi (WHR)',
+  vo2max: 'Test cardio (VO2max)',
+  spirometria: 'Spirometria',
+  wellness_tower_cardio: 'Wellness Tower — cardio',
+  hrv: 'Variabilità della frequenza cardiaca (HRV)',
+  pressione: 'Pressione arteriosa',
+  hrr: 'Frequenza cardiaca di recupero (HRR)',
+  questionario_sonno: 'Questionario del sonno',
+  questionario_energia_stress: 'Questionario energia e stress',
+  flamingo: 'Test di equilibrio (flamingo)',
+  sit_and_reach: 'Test di flessibilità (sit and reach)',
+  plank: 'Plank (tenuta)',
+  back_scratch: 'Test di mobilità delle spalle (back scratch)',
+  wellness_tower_shoulder: 'Wellness Tower — spalla',
+  questionario_lifestyle: 'Questionario di stile di vita',
+};
+
+/** I contenitori (assi o macro-score) dichiarati nei pesi per il model version corrente,
+ * nell'ordine in cui compaiono nella tabella — che è l'ordine di inserimento di `seedPesi`,
+ * cioè quello dichiarato in registro.ts. Non un elenco duplicato qui: si legge dal dato. */
+function contenitoriDi(db: Database.Database, livello: 'asse' | 'macro'): string[] {
+  return (db.prepare(
+    `SELECT contenitore FROM pesi WHERE model_version = ? AND livello = ?
+     GROUP BY contenitore ORDER BY MIN(rowid)`
+  ).all(MODEL_VERSION, livello) as { contenitore: string }[]).map((r) => r.contenitore);
+}
+
+/** I sotto-domini con almeno una misura valida (nel range atteso) in questa sessione:
+ * l'informazione grezza da cui `mancano` si costruisce, non un punteggio — leggere quali
+ * test sono stati fatti non è ricalcolare come pesano. */
+function sottoDominiPresenti(db: Database.Database, sessioneId: number): Set<string> {
+  const righe = db.prepare(
+    `SELECT DISTINCT rt.sotto_dominio AS sd
+     FROM misure m JOIN registro_test rt ON rt.test_id = m.test_id
+     WHERE m.sessione_id = ? AND m.fuori_range = 0 AND m.valore_num IS NOT NULL
+       AND rt.sotto_dominio IS NOT NULL`
+  ).all(sessioneId) as { sd: string }[];
+  return new Set(righe.map((r) => r.sd));
+}
+
+/** Cosa manca per completare un asse insufficiente: i sotto-domini pesati per quell'asse
+ * che questa sessione non ha, tradotti nell'etichetta leggibile. */
+function mancanoPer(db: Database.Database, sessioneId: number, nomeAsse: string, presenti: Set<string>): string[] {
+  const pesi = pesiDi(db, MODEL_VERSION, 'asse', nomeAsse);
+  return Object.keys(pesi)
+    .filter((sd) => !presenti.has(sd))
+    .map((sd) => ETICHETTE_SOTTO_DOMINIO[sd] ?? sd);
+}
+
+/**
+ * Il referto di una sessione: i sette assi del radar, i macro-score e la Fitness Age.
+ * Legge SOLO `leggiScore` per i valori (punteggi congelati): non chiama mai
+ * `calcolaSessione`, quindi un peso cambiato dopo il fatto non altera un referto già
+ * emesso. `mancano` guarda invece le misure grezze della sessione (quali test ci sono),
+ * non il punteggio — è informazione su cosa manca, non un ricalcolo di quanto vale.
+ */
+export function refertoDi(
+  db: Database.Database,
+  sessioneId: number
+): { assi: AsseVista[]; macro: MacroVista[]; fitnessAge: number | null; fitnessAgeCopertura: number } {
+  const punteggi = leggiScore(db, sessioneId);
+  const presenti = sottoDominiPresenti(db, sessioneId);
+
+  const assi: AsseVista[] = contenitoriDi(db, 'asse').map((nome) => {
+    const p = punteggi.assi[nome];
+    if (p?.stato === 'ok') return { nome, valore: p.valore, copertura: p.copertura, mancano: [] };
+    return {
+      nome, valore: null, copertura: p?.copertura ?? 0,
+      mancano: mancanoPer(db, sessioneId, nome, presenti),
+    };
+  });
+
+  const macro: MacroVista[] = contenitoriDi(db, 'macro').map((nome) => {
+    const p = punteggi.macro[nome];
+    return p?.stato === 'ok'
+      ? { nome, valore: p.valore, copertura: p.copertura }
+      : { nome, valore: null, copertura: p?.copertura ?? 0 };
+  });
+
+  const fitnessAge = punteggi.fitnessAge?.stato === 'ok' ? punteggi.fitnessAge.valore : null;
+  // Prima apertura: con poche misure la Fitness Age manca quasi sempre. La pagina deve
+  // poter dire QUANTO manca (come fa già ogni carta di macro-score), non solo che manca:
+  // la copertura resta leggibile anche quando lo stato è 'insufficiente'.
+  const fitnessAgeCopertura = punteggi.fitnessAge?.copertura ?? 0;
+
+  return { assi, macro, fitnessAge, fitnessAgeCopertura };
+}
+
+/** L'ultima sessione di un cliente (la più recente per data, a parità di data la più
+ * recente per id). `null` se il cliente non ha ancora nessuna sessione — la pagina del
+ * referto la usa per non dover interrogare `sessioni` da sola. */
+export function ultimaSessioneDi(db: Database.Database, clientCode: string): number | null {
+  const r = db.prepare(
+    `SELECT id FROM sessioni WHERE client_code = ? ORDER BY data DESC, id DESC LIMIT 1`
+  ).get(clientCode) as { id: number } | undefined;
+  return r?.id ?? null;
+}

src/middleware.ts

@@ -1,15 +1,10 @@
 import { defineMiddleware } from 'astro:middleware';
 import { getDb } from './lib/db';
-import { getSessionUser, SESSION_COOKIE, canAccessAdminPath, landingFor } from './lib/auth';
+import { getSessionUser, SESSION_COOKIE, canAccessAdminPath, landingFor, isProtectedPath } from './lib/auth';
 
 export const onRequest = defineMiddleware((context, next) => {
   const { pathname } = context.url;
-  const isProtected =
+  if (!isProtectedPath(pathname)) return next();
-    (pathname.startsWith('/admin') && pathname !== '/admin/login') ||
-    pathname.startsWith('/api/admin') ||
-    pathname.startsWith('/campus') ||
-    pathname.startsWith('/piattaforme');
-  if (!isProtected) return next();
 
   const token = context.cookies.get(SESSION_COOKIE)?.value;
   const user = token ? getSessionUser(getDb(), token) : null;
@@ -21,7 +16,7 @@ export const onRequest = defineMiddleware((context, next) => {
     }
     // Le piattaforme riservate si raggiungono dal sito, quindi passano dal login
     // pubblico e ci tornano dopo l'accesso; il pannello ha il proprio.
-    if (pathname.startsWith('/campus') || pathname.startsWith('/piattaforme'))
+    if (pathname.startsWith('/campus') || pathname.startsWith('/piattaforme') || pathname.startsWith('/longevity'))
       return context.redirect(`/login?next=${encodeURIComponent(pathname)}`);
     return context.redirect('/admin/login');
   }

src/pages/admin/users.astro

@@ -1,7 +1,7 @@
 ---
 import Admin from '../../layouts/Admin.astro';
 import { getDb } from '../../lib/db';
-import { listUsers } from '../../lib/auth';
+import { listUsers, ROLES } from '../../lib/auth';
 export const prerender = false;
 const users = listUsers(getDb());
 const me = Astro.locals.user!;
@@ -45,7 +45,7 @@ const me = Astro.locals.user!;
           <td>{u.username}{u.id === me.id && ' (tu)'}</td>
           <td>
             <select class="role-sel arole" data-id={u.id} data-role={u.role} aria-label={`Ruolo di ${u.username}`}>
-              {['user', 'superuser', 'piattaforme', 'admin'].map((r) => <option value={r} selected={u.role === r}>{r}</option>)}
+              {ROLES.map((r) => <option value={r} selected={u.role === r}>{r}</option>)}
             </select>
           </td>
           <td class="uactions">

src/pages/admin/users/new.astro

@@ -2,7 +2,19 @@
 // Creazione di un utente, su pagina propria come per gli articoli: l'elenco resta pulito e
 // il modulo ha spazio per le sue spiegazioni.
 import Admin from '../../../layouts/Admin.astro';
+import { ROLES } from '../../../lib/auth';
 export const prerender = false;
+
+// Descrizioni solo per la UI: se un ruolo nuovo non è qui, compare comunque nella tendina
+// (fonte di validità unica: ROLES), semplicemente senza spiegazione accanto.
+const DESCRIZIONI: Partial<Record<(typeof ROLES)[number], string>> = {
+  user: 'scrive i propri articoli',
+  superuser: 'articoli e contenuti del sito',
+  piattaforme: 'solo Campus e Stress Index',
+  admin: 'accesso completo',
+  cliente: 'solo il proprio fascicolo Longevity',
+  trainer: 'gestionale Longevity',
+};
 ---
 <Admin title="Nuovo utente">
   <h1>Nuovo utente</h1>
@@ -17,10 +29,7 @@ export const prerender = false;
 
     <label class="alabel" for="role">Ruolo</label>
     <select class="afield" id="role" name="role">
-      <option value="user">user — scrive i propri articoli</option>
+      {ROLES.map((r) => <option value={r}>{r}{DESCRIZIONI[r] ? ` — ${DESCRIZIONI[r]}` : ''}</option>)}
-      <option value="superuser">superuser — articoli e contenuti del sito</option>
-      <option value="piattaforme">piattaforme — solo Campus e Stress Index</option>
-      <option value="admin">admin — accesso completo</option>
     </select>
 
     <div class="aactions">

src/pages/api/longevity/questionario.ts

@@ -0,0 +1,94 @@
+import type { APIRoute } from 'astro';
+import { getLongevityDb } from '../../../lib/longevity/db';
+import { codicePerUtenteLoggato } from '../../../lib/longevity/anagrafica';
+import { salvaDalForm } from '../../../lib/longevity/vista';
+import { CAMPI_LIBERI } from '../../../lib/longevity/questionario';
+
+export const prerender = false;
+
+const json = (status: number, body: object) =>
+  new Response(JSON.stringify(body), { status, headers: { 'Content-Type': 'application/json' } });
+
+/**
+ * Il corpo legittimo della richiesta: SOLO i campi che un cliente può davvero mandare.
+ * `client_code` non è un campo di questo tipo — non per una lista di nomi vietati (una
+ * lista così invecchia appena il file rinomina la variabile, vedi il commento nel test),
+ * ma perché il tipo non lo prevede: chi scrivesse domani `corpo.client_code` non
+ * supererebbe `tsc --noEmit`, il campo non esiste. Il codice cliente resta SEMPRE quello
+ * della sessione (codicePerUtenteLoggato, spec §8), mai un campo letto da qui.
+ */
+type CorpoQuestionario = {
+  risposte: Record<string, number>;
+  liberi: Record<string, string>;
+  consensoSanitario: string;
+  eta?: number;
+};
+
+/** Estrae SOLO i campi di CorpoQuestionario da un JSON grezzo; `null` se il corpo non è
+ * nemmeno un oggetto, o se manca `risposte`. Ogni altra chiave del corpo (incluso un
+ * eventuale `client_code`) viene semplicemente ignorata: non esiste modo di farla arrivare
+ * al chiamante, perché il tipo di ritorno non la contiene. */
+function corpoDaJson(raw: unknown): CorpoQuestionario | null {
+  if (typeof raw !== 'object' || raw === null) return null;
+  const grezzo = raw as Record<string, unknown>;
+
+  const risposteIn = grezzo.risposte;
+  if (typeof risposteIn !== 'object' || risposteIn === null) return null;
+  const risposte: Record<string, number> = {};
+  for (const [id, v] of Object.entries(risposteIn as Record<string, unknown>)) {
+    if (typeof v === 'number' && Number.isFinite(v)) risposte[id] = v;
+  }
+
+  // Solo i campi liberi dichiarati: un corpo con chiavi arbitrarie non ne inventa di nuove.
+  const liberiIn = grezzo.liberi;
+  const liberi: Record<string, string> = {};
+  if (typeof liberiIn === 'object' && liberiIn !== null) {
+    for (const campo of CAMPI_LIBERI) {
+      const v = (liberiIn as Record<string, unknown>)[campo];
+      if (typeof v === 'string') liberi[campo] = v;
+    }
+  }
+
+  const consensoSanitario = typeof grezzo.consensoSanitario === 'string' ? grezzo.consensoSanitario : '';
+  const eta = typeof grezzo.eta === 'number' && Number.isFinite(grezzo.eta) ? grezzo.eta : undefined;
+
+  return { risposte, liberi, consensoSanitario, eta };
+}
+
+export const POST: APIRoute = async ({ request, locals }) => {
+  // Il codice cliente si ricava SEMPRE dalla sessione dell'utente loggato (spec §8), mai dal
+  // corpo della richiesta: la risoluzione passa da anagrafica.ts (l'unico modulo autorizzato
+  // a toccare quella connessione). `corpo`, qui sotto, non ha nemmeno un campo da cui
+  // prenderlo per errore.
+  const codice = codicePerUtenteLoggato(locals.user!.id);
+  if (!codice) return json(403, { error: 'Nessun fascicolo cliente associato a questo utente.' });
+
+  let raw: unknown;
+  try { raw = await request.json(); } catch { return json(400, { error: 'Dati non validi.' }); }
+  if (typeof raw !== 'object' || raw === null) return json(400, { error: 'Dati non validi.' });
+
+  const corpo = corpoDaJson(raw);
+  if (!corpo) return json(400, { error: 'Risposte mancanti.' });
+  const { risposte, liberi, consensoSanitario, eta } = corpo;
+
+  // La data della compilazione è quella del server, non quella (manomettibile) del client.
+  const oggi = new Date().toISOString().slice(0, 10);
+
+  // salvaDalForm delega a salvaCompilazione, che lancia se una risposta porta un test_id
+  // sconosciuto al registro (client disallineato, non serve malizia): un'eccezione qui
+  // non deve diventare un 500 generico, come in src/pages/api/contact.ts per l'invio email.
+  let esito;
+  try {
+    esito = salvaDalForm(getLongevityDb(), {
+      client_code: codice, data: oggi, eta, risposte, consensoSanitario, liberi,
+    });
+  } catch (err) {
+    console.error('Salvataggio questionario fallito:', err);
+    return json(400, {
+      error: 'Impossibile salvare: alcune risposte non sono riconosciute. Ricarica la pagina e riprova.',
+    });
+  }
+
+  if (!esito.ok) return json(422, { error: esito.errore });
+  return json(201, { sessioneId: esito.sessioneId });
+};

src/pages/longevity/index.astro

@@ -0,0 +1,7 @@
+---
+// Punto di ingresso della piattaforma: non c'è un indice, solo la scorciatoia al
+// referto del cliente. La protezione della rotta è già del middleware (isProtectedPath
+// e canAccessAdminPath in src/lib/auth.ts).
+export const prerender = false;
+return Astro.redirect('/longevity/io');
+---

src/pages/longevity/io.astro

@@ -0,0 +1,72 @@
+---
+// Il referto del cliente: il radar a sette assi, la Fitness Age, le carte dei macro-score.
+// La pagina non interroga il database da sola (c'è un test che lo verifica): il codice
+// cliente arriva da codicePerUtenteLoggato (anagrafica.ts, l'unico modulo autorizzato a
+// toccare identity), la sessione più recente e il referto stesso da vista.ts.
+import Longevity from '../../layouts/Longevity.astro';
+import Radar from '../../components/longevity/Radar';
+import MacroScore from '../../components/longevity/MacroScore.astro';
+import { getLongevityDb } from '../../lib/longevity/db';
+import { codicePerUtenteLoggato } from '../../lib/longevity/anagrafica';
+import { refertoDi, ultimaSessioneDi } from '../../lib/longevity/vista';
+import { formattaNumero } from '../../lib/longevity/formato';
+
+export const prerender = false;
+
+const user = Astro.locals.user!;
+const codice = codicePerUtenteLoggato(user.id);
+const db = getLongevityDb();
+const sessioneId = codice ? ultimaSessioneDi(db, codice) : null;
+const referto = sessioneId !== null ? refertoDi(db, sessioneId) : null;
+---
+<Longevity title="Il tuo referto" crumbs={['Il tuo referto']}>
+  {!codice && (
+    <div class="lg-card">
+      <p>Nessun fascicolo è ancora collegato al tuo account. Contatta lo staff InsanityLab.</p>
+    </div>
+  )}
+
+  {codice && !referto && (
+    <div class="lg-card lg-card--incompleto">
+      <p>Non hai ancora compilato il questionario: senza quello non c'è ancora un referto da mostrare.</p>
+      <p><a href="/longevity/questionario">Comincia da qui</a>.</p>
+    </div>
+  )}
+
+  {referto && (
+    <div class="lg-referto">
+      <section class:list={['lg-card', { 'lg-card--incompleto': referto.fitnessAge === null }]}>
+        <p class="lg-score__label">Fitness Age</p>
+        <div class="lg-score">
+          <span class="lg-score__value lg-num">
+            {referto.fitnessAge !== null ? formattaNumero(referto.fitnessAge) : '—'}
+          </span>
+          {referto.fitnessAge !== null && <span class="lg-score__max">anni</span>}
+        </div>
+        <p class="lg-muted lg-macro__nota">
+          Copertura dati: {Math.round(referto.fitnessAgeCopertura * 100)}%
+          {referto.fitnessAge === null && ' — non ancora sufficiente per un numero.'}
+        </p>
+      </section>
+
+      <section class="lg-card">
+        <h2>Il tuo radar</h2>
+        <Radar client:load assi={referto.assi} />
+      </section>
+
+      <section class="lg-macro">
+        {referto.macro.map((m) => (
+          <MacroScore nome={m.nome} valore={m.valore} copertura={m.copertura} />
+        ))}
+      </section>
+
+      <section class="lg-card">
+        <p>
+          InsanityLab Longevity monitora il tuo percorso nel tempo: più compilazioni
+          raccontano come cambi, non solo come stai oggi.
+          <a href="/longevity/questionario">Compila di nuovo il questionario</a>.
+        </p>
+      </section>
+    </div>
+  )}
+</Longevity>

src/pages/longevity/questionario.astro

@@ -0,0 +1,22 @@
+---
+// Il questionario in pagina, sostituisce il prototipo del cliente. La pagina non
+// interroga il database da sola: chiede i campi a `campiDelQuestionario` (letti dal
+// registro), l'isola React fa il resto — quattro blocchi, e l'invio va a
+// /api/longevity/questionario, dove il consenso si verifica davvero.
+import Longevity from '../../layouts/Longevity.astro';
+import Questionario from '../../components/longevity/Questionario';
+import { getLongevityDb } from '../../lib/longevity/db';
+import { campiDelQuestionario } from '../../lib/longevity/vista';
+
+export const prerender = false;
+
+const oggi = new Date().toISOString().slice(0, 10);
+const campi = campiDelQuestionario(getLongevityDb(), oggi);
+---
+<Longevity title="Questionario" crumbs={['Questionario']}>
+  <div class="lg-head">
+    <h1>Questionario</h1>
+    <p>Rispondi con calma: puoi tornare indietro finché non invii.</p>
+  </div>
+  <Questionario client:load campi={campi} />
+</Longevity>

src/pages/promo-eventi/eventi.astro

@@ -18,6 +18,7 @@ const waLink = `https://wa.me/39${wa.replace(/\D/g, '')}`;
     <div class="container">
       <article class="evento" data-reveal>
         <T tag="eventi.inaugurazione.title" as="h2" />
+        <T tag="eventi.inaugurazione.date" as="p" class="evento__data" />
         <T tag="eventi.inaugurazione.body" as="p" />
         <a class="btn" href={waLink} target="_blank" rel="noopener">{t('eventi.cta.label')}</a>
       </article>
@@ -29,6 +30,7 @@ const waLink = `https://wa.me/39${wa.replace(/\D/g, '')}`;
 <style>
   .evento { max-width: 760px; margin: 0 auto; text-align: center; display: flex; flex-direction: column; align-items: center; gap: 20px; }
   .evento :global(h2) { text-transform: uppercase; letter-spacing: .1em; margin: 0; }
+  .evento :global(.evento__data) { font-family: var(--font-heading); text-transform: uppercase; letter-spacing: .12em; font-size: clamp(1.15rem, 2.4vw, 1.6rem); color: var(--c-accent-dark); margin-top: -4px; }
   .evento :global(p) { margin: 0; }
   .evento__torna { text-align: center; margin-top: 46px; }
   .evento__torna a { font-family: var(--font-heading); font-size: .72rem; letter-spacing: .18em; text-transform: uppercase; color: var(--c-heading); text-decoration: none; }

src/styles/longevity.css

@@ -0,0 +1,141 @@
+/* Stile della piattaforma Longevity.
+   Vive in un foglio globale, non in <style> scoped, perché le stesse classi servono sia
+   ai componenti Astro sia alle isole React (questionario e radar), che lo scope di Astro
+   non raggiungerebbe. Tutto è prefissato `.lg` e usa i token del sito.
+
+   A differenza di Stress Index qui non c'è semaforo verde/ambra/mattone sui punteggi:
+   il servizio è premium ma non clinico, e un rosso su un punteggio del corpo sarebbe un
+   giudizio, non un'informazione. L'intensità di un punteggio si legge nell'opacità
+   dell'accento del sito (var(--lg-intensita), impostata inline dal componente che disegna
+   il punteggio), mai in un colore diverso. I due soli colori di segnale locali sono:
+   - --lg-tratteggio: il perimetro di ciò che non sappiamo ancora (un asse senza dati
+     sufficienti), non un errore;
+   - --lg-fuori-range: SOLO per una misura sospetta (es. un valore fisiologicamente
+     improbabile), mai per un punteggio — segnala un problema della misura, non della
+     persona. Riusa il mattone di Stress Index (--si-bad: #b05a4e). */
+
+.lg {
+  --lg-line: #e4dfd7;
+  --lg-surface: #ffffff;
+  --lg-tratteggio: #d8d2c8;
+  --lg-fuori-range: #b05a4e;
+  display: flex;
+  justify-content: center;
+  min-height: 100vh;
+  background: var(--c-bg-alt);
+}
+
+/* --- guscio del referto: una colonna che scorre, senza navigazione --- */
+.lg-shell {
+  width: 100%;
+  max-width: 760px;
+  min-height: 100vh;
+  background: var(--lg-surface);
+  display: flex;
+  flex-direction: column;
+}
+
+/* --- intestazione --- */
+.lg-top {
+  padding: 18px 32px;
+  border-bottom: 1px solid var(--lg-line);
+  position: sticky;
+  top: 0;
+  z-index: 10;
+  background: var(--lg-surface);
+}
+.lg-top p { margin: 0; }
+.lg-top__crumbs {
+  font-family: var(--font-heading); font-size: .74rem; letter-spacing: .14em;
+  text-transform: uppercase; color: var(--c-text-light);
+}
+.lg-top__crumbs strong { color: var(--c-heading); font-weight: 600; }
+
+.lg-main { flex: 1; padding: 34px 32px 70px; }
+
+/* --- intestazione di pagina --- */
+.lg-head { margin-bottom: 28px; }
+.lg-head h1 { font-size: clamp(1.6rem, 3vw, 2.1rem); text-transform: none; letter-spacing: .02em; margin-bottom: .25em; }
+.lg-head p { margin: 0; color: var(--c-text-light); font-size: .9rem; }
+
+/* --- la carta di un punteggio ---
+   Nessun colore «buono» o «cattivo»: l'intensità si legge nell'opacità dell'accento
+   (--lg-intensita, 0..1, impostata inline dal componente in base al punteggio). */
+.lg-card { background: var(--lg-surface); border: 1px solid var(--lg-line); padding: 20px 22px; }
+.lg-card--incompleto { border-style: dashed; border-color: var(--lg-tratteggio); }
+
+.lg-score { display: flex; align-items: baseline; gap: 8px; }
+.lg-score__value { font-family: var(--font-heading); font-size: 1.9rem; font-weight: 500; color: var(--c-heading); }
+.lg-score__max { font-size: .82rem; color: var(--c-text-light); }
+.lg-score__label {
+  font-family: var(--font-heading); font-size: .78rem; font-weight: 600;
+  letter-spacing: .16em; text-transform: uppercase; color: var(--c-heading);
+}
+
+.lg-score__bar { height: 6px; background: var(--c-bg-alt); overflow: hidden; }
+.lg-score__bar-fill { height: 100%; background: var(--c-accent); opacity: var(--lg-intensita, 1); }
+
+.lg-misura--fuori-range { color: var(--lg-fuori-range); font-weight: 600; }
+
+.lg-muted { color: var(--c-text-light); }
+
+/* i numeri che si confrontano nel tempo non devono ballare a ogni cifra */
+.lg-num { font-variant-numeric: tabular-nums; }
+
+/* --- il referto: colonna di sezioni --- */
+.lg-referto { display: flex; flex-direction: column; gap: 24px; }
+
+/* --- il radar dei sette assi: area piena + perimetro tratteggiato ---
+   Il disegno vive nell'isola React (Radar.tsx); qui solo il testo sotto al grafico —
+   l'elenco di ciò che manca, che è la parte che rende il buco un invito. */
+.lg-radar { display: flex; flex-direction: column; gap: 20px; }
+.lg-radar__grafico { width: 100%; }
+.lg-radar__intro { margin: 0; font-size: .86rem; color: var(--c-text-light); }
+.lg-radar__mancano { display: flex; flex-direction: column; gap: 14px; }
+.lg-radar__voce { border-top: 1px dashed var(--lg-tratteggio); padding-top: 12px; }
+.lg-radar__voce-nome {
+  margin: 0 0 6px; font-family: var(--font-heading); font-size: .82rem; font-weight: 600;
+  color: var(--c-heading);
+}
+.lg-radar__lista { margin: 0; padding-left: 18px; font-size: .86rem; color: var(--c-text-light); }
+.lg-radar__lista li { margin-bottom: 2px; }
+
+/* --- le carte dei macro-score --- */
+.lg-macro { display: grid; grid-template-columns: repeat(auto-fit, minmax(160px, 1fr)); gap: 16px; }
+.lg-macro__nota { margin: 8px 0 0; font-size: .78rem; }
+
+/* --- il questionario: un blocco alla volta, avanti/indietro --- */
+.lg-form { display: flex; flex-direction: column; gap: 24px; }
+.lg-form__passo {
+  font-family: var(--font-heading); font-size: .74rem; letter-spacing: .12em;
+  text-transform: uppercase; color: var(--c-text-light); margin: 0;
+}
+.lg-form__blocco { display: flex; flex-direction: column; gap: 16px; }
+.lg-form__blocco h2 { font-size: 1.1rem; margin: 0; }
+
+.lg-field { display: flex; flex-direction: column; gap: 6px; font-size: .92rem; }
+.lg-field > span { color: var(--c-heading); font-weight: 500; }
+.lg-field input[type="number"],
+.lg-field textarea {
+  border: 1px solid var(--lg-line); padding: 9px 11px; font: inherit; background: var(--lg-surface);
+}
+.lg-field textarea { min-height: 68px; resize: vertical; }
+
+.lg-field--consenso { border: 1px solid var(--lg-line); padding: 16px 18px; gap: 10px; }
+.lg-field--consenso legend { padding: 0 4px; font-weight: 500; color: var(--c-heading); }
+.lg-field--consenso label { display: flex; align-items: center; gap: 8px; font-weight: 400; }
+
+.lg-form__errore { color: var(--c-heading); font-weight: 600; margin: 0; }
+
+.lg-form__nav { display: flex; justify-content: space-between; gap: 12px; }
+.lg-form__nav button {
+  font-family: var(--font-heading); font-size: .78rem; font-weight: 600; letter-spacing: .08em;
+  text-transform: uppercase; padding: 11px 22px; border: 1px solid var(--c-heading);
+  background: transparent; color: var(--c-heading); cursor: pointer;
+}
+.lg-form__nav button:disabled { opacity: .35; cursor: not-allowed; }
+.lg-form__nav button:last-child:not(:only-child) { background: var(--c-accent); border-color: var(--c-accent); color: #fff; }
+
+@media (max-width: 640px) {
+  .lg-top, .lg-main { padding-left: 20px; padding-right: 20px; }
+}

tests/longevity/anagrafica.test.ts

@@ -0,0 +1,144 @@
+import { describe, it, expect } from 'vitest';
+import { readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { createLongevityDb, createIdentityDb } from '../../src/lib/longevity/db';
+import { creaCliente, codicePerUtente, etaAllaData } from '../../src/lib/longevity/anagrafica';
+
+describe('anagrafica pseudonimizzata', () => {
+  it('il nome sta in identity, il sesso in longevity, e i due non si mescolano', () => {
+    const id = createIdentityDb(':memory:');
+    const lg = createLongevityDb(':memory:');
+    const code = creaCliente(id, lg, { nome: 'Mario', cognome: 'Rossi', sesso: 'M', data_nascita: '1988-03-04' });
+
+    const inIdentity = id.prepare(`SELECT nome, cognome FROM clienti WHERE client_code = ?`).get(code) as
+      { nome: string; cognome: string };
+    expect(inIdentity.nome).toBe('Mario');
+
+    const inLongevity = lg.prepare(`SELECT sesso FROM soggetti WHERE client_code = ?`).get(code) as { sesso: string };
+    expect(inLongevity.sesso).toBe('M');
+
+    // in longevity non deve esistere nessuna colonna che contenga il nome
+    const dump = JSON.stringify(lg.prepare(`SELECT * FROM soggetti`).all());
+    expect(dump).not.toContain('Mario');
+    expect(dump).not.toContain('Rossi');
+    expect(dump).not.toContain('1988-03-04');
+  });
+
+  it('assegna codici progressivi e non riusa i vecchi', () => {
+    const id = createIdentityDb(':memory:');
+    const lg = createLongevityDb(':memory:');
+    const a = creaCliente(id, lg, { nome: 'A', cognome: 'A', sesso: 'F' });
+    const b = creaCliente(id, lg, { nome: 'B', cognome: 'B', sesso: 'M' });
+    expect(a).toMatch(/^ISL-\d{4}$/);
+    expect(b).not.toBe(a);
+  });
+
+  it('ritrova il codice a partire dall utente del sito', () => {
+    const id = createIdentityDb(':memory:');
+    const lg = createLongevityDb(':memory:');
+    const code = creaCliente(id, lg, { nome: 'C', cognome: 'C', sesso: 'F', user_id: 42 });
+    expect(codicePerUtente(id, 42)).toBe(code);
+    expect(codicePerUtente(id, 99)).toBeNull();
+  });
+
+  it('calcola l eta alla data della sessione', () => {
+    expect(etaAllaData('1988-03-04', '2026-08-21')).toBe(38);
+    expect(etaAllaData('1988-12-31', '2026-08-21')).toBe(37); // compleanno non ancora passato
+  });
+
+  it('un codice cancellato dall anagrafica non torna mai disponibile: le misure del vecchio non si attribuiscono al nuovo', () => {
+    const id = createIdentityDb(':memory:');
+    const lg = createLongevityDb(':memory:');
+    const a = creaCliente(id, lg, { nome: 'A', cognome: 'A', sesso: 'F' });
+    const b = creaCliente(id, lg, { nome: 'B', cognome: 'B', sesso: 'M' });
+
+    // Il secondo cliente viene cancellato dall'anagrafica (disdetta, richiesta di
+    // cancellazione, errore): le sue misure restano in longevity, pseudonimizzate.
+    id.prepare(`DELETE FROM clienti WHERE client_code = ?`).run(b);
+    lg.prepare(`INSERT INTO sessioni (client_code, data, tipo) VALUES (?, '2026-08-01', 'checkup')`).run(b);
+
+    const c = creaCliente(id, lg, { nome: 'C', cognome: 'C', sesso: 'F' });
+
+    // Il terzo cliente riceve un codice nuovo, mai il codice riciclato del secondo.
+    expect(c).not.toBe(b);
+    expect(c).not.toBe(a);
+
+    // Le sessioni del vecchio cliente (b) restano leggibili sotto il suo codice...
+    const sessioniDiB = lg.prepare(`SELECT * FROM sessioni WHERE client_code = ?`).all(b);
+    expect(sessioniDiB.length).toBe(1);
+
+    // ...e non risultano in nessun modo attribuite al nuovo cliente (c).
+    const sessioniDiC = lg.prepare(`SELECT * FROM sessioni WHERE client_code = ?`).all(c);
+    expect(sessioniDiC.length).toBe(0);
+  });
+
+  it('se la scrittura su longevity fallisce, quella gia fatta su identity viene annullata', () => {
+    const id = createIdentityDb(':memory:');
+    const lg = createLongevityDb(':memory:');
+    const primaDelTentativo = (id.prepare(`SELECT COUNT(*) AS n FROM clienti`).get() as { n: number }).n;
+
+    // 'Z' non è un sesso valido (CHECK IN ('M','F') su longevity.soggetti): la scrittura
+    // su longevity fallisce per costruzione, dopo che quella su identity è già avvenuta.
+    expect(() =>
+      creaCliente(id, lg, { nome: 'Errato', cognome: 'Errato', sesso: 'Z' as unknown as 'M' | 'F' })
+    ).toThrow();
+
+    const dopoIlTentativo = (id.prepare(`SELECT COUNT(*) AS n FROM clienti`).get() as { n: number }).n;
+    expect(dopoIlTentativo).toBe(primaDelTentativo); // nessun cliente orfano rimasto in identity
+    expect(id.prepare(`SELECT * FROM clienti WHERE nome = 'Errato'`).get()).toBeUndefined();
+  });
+
+  it('rete secondaria: nessun file in src/ (escluso anagrafica.ts e db.ts) fa riferimento sia a identity sia a longevity', () => {
+    // ⚠️ QUESTO TEST NON È LA GARANZIA. La garanzia vera è che getIdentityDb non è più
+    // esportata da db.ts (vive privata dentro anagrafica.ts): non esiste, da nessuna
+    // parte del codice fuori da lì, un nome da importare per ottenere quella connessione.
+    // Un controllo testuale come questo non può bastare da solo — è stato dimostrato:
+    // tre file, uno che riesporta la connessione a identity, uno che riesporta quella a
+    // longevity, un terzo che importa da entrambi e le usa insieme, e NESSUNO dei tre
+    // contiene singolarmente le due parole. Un controllo file-per-file non vede una
+    // giunzione che attraversa più file, e non c'è formulazione di questo test che lo
+    // possa vedere: la risposta era rendere la cosa impossibile, non sorvegliarla meglio.
+    // Questo test resta come rete secondaria — cattura il caso comune (una giunzione
+    // dentro un solo file) e protegge contro un domani in cui getIdentityDb tornasse
+    // esportata per errore — non come prova che la giunzione non possa esistere.
+    // Cerca i due riferimenti letterali "Identity"/"Longevity" (con l'iniziale maiuscola,
+    // come compaiono in qualunque accessore camelCase) invece di un elenco chiuso di nomi:
+    // un elenco di nomi vietati invecchia (è già successo qui: getIdentityDb/getLongevityDb
+    // sono nati dopo la prima versione di questo test e sono passati indisturbati).
+    // ⚠️ VERIFICATO IL 22/08, UN TERZO BUCO, STAVOLTA IN UN FILE SOLO: `createIdentityDb`
+    // (a differenza del singleton privato getIdentityDb) È esportata da db.ts — serve a
+    // creaCliente, che riceve due connessioni già aperte da fuori. Un file che chiama
+    // `createIdentityDb()` direttamente e apre longevity con una connessione propria (es.
+    // `new Database(process.env.LONGEVITY_DB_PATH ?? 'data/longevity.db')`, mai col nome
+    // `getLongevityDb`/`createLongevityDb`) contiene "Identity" ma MAI "Longevity" con
+    // l'iniziale maiuscola — LONGEVITY_DB_PATH è tutto maiuscolo, 'longevity.db' tutto
+    // minuscolo — e questo test lo lascia passare. Provato con un file del genere in
+    // src/lib/longevity/: zero test rossi. Non è una falla da chiudere con un controllo
+    // più furbo (già tentato e aggirato due volte prima di questa): la garanzia resta solo
+    // quella architetturale sopra, e su `createIdentityDb` non c'è — è pensata per essere
+    // chiamata da fuori anagrafica.ts (creaCliente la riceve come parametro), quindi non si
+    // può chiuderla come si è chiusa getIdentityDb senza cambiare quella funzione.
+    const srcDir = join(process.cwd(), 'src');
+    const colpevoli: string[] = [];
+
+    const files = readdirSync(srcDir, { recursive: true, withFileTypes: false }) as string[];
+    for (const f of files) {
+      const path = join(srcDir, f);
+
+      // Salta node_modules e dist
+      if (f.includes('node_modules') || f.includes('dist')) continue;
+
+      // Accetta solo .ts e .astro
+      if (!f.endsWith('.ts') && !f.endsWith('.astro')) continue;
+
+      // Esclude i moduli autorizzati
+      if (f === 'lib/longevity/anagrafica.ts' || f === 'lib/longevity/db.ts') continue;
+
+      const src = readFileSync(path, 'utf8');
+      if (src.includes('Identity') && src.includes('Longevity')) {
+        colpevoli.push(f);
+      }
+    }
+    expect(colpevoli).toEqual([]);
+  });
+});

tests/longevity/consenso-atomico.test.ts

@@ -0,0 +1,52 @@
+// Il consenso veniva scritto DOPO che salvaCompilazione aveva già chiuso la propria
+// transazione: se il passo successivo falliva, restavano i dati sanitari SENZA il record
+// di consenso che li giustifica — l'esatto contrario dell'invariante ("o entra tutto nel
+// fascicolo, o non entra niente"). Questo file forza un fallimento nel calcolo dei
+// punteggi (mockando calcolaSessione) DOPO che la sessione e le misure sono già scritte, e
+// verifica che l'intera transazione — sessione, misure, punteggi, consenso — vada
+// indietro insieme. Il mock vive in un file a parte perché vi.mock è per-file: gli altri
+// test su calcolaSessione (referto.test.ts, salvataggio-e2e.test.ts) devono restare reali.
+import { describe, it, expect, vi } from 'vitest';
+import { createLongevityDb } from '../../src/lib/longevity/db';
+import { seedRegistro, seedPesi, MODEL_VERSION } from '../../src/lib/longevity/registro';
+
+vi.mock('../../src/lib/longevity/motore', async (importOriginal) => {
+  const reale = await importOriginal<typeof import('../../src/lib/longevity/motore')>();
+  return {
+    ...reale,
+    calcolaSessione: () => { throw new Error('rottura simulata nel calcolo dei punteggi'); },
+  };
+});
+
+function dbPronto() {
+  const db = createLongevityDb(':memory:');
+  seedRegistro(db);
+  seedPesi(db, MODEL_VERSION);
+  db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0001','F')`).run();
+  return db;
+}
+
+describe('salvaDalForm — atomicità di dati, punteggi e consenso', () => {
+  it('se il calcolo dei punteggi fallisce DOPO che sessione e misure sono state scritte, tutto torna indietro: niente sessione, niente misure, niente nota di consenso', async () => {
+    const { salvaDalForm } = await import('../../src/lib/longevity/vista');
+    const db = dbPronto();
+
+    expect(() =>
+      salvaDalForm(db, {
+        client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+        risposte: { q_riposato: 8 }, consensoSanitario: 'Si', liberi: {},
+      })
+    ).toThrow(/rottura simulata/);
+
+    const sessioni = db.prepare(`SELECT COUNT(*) n FROM sessioni`).get() as { n: number };
+    const misure = db.prepare(`SELECT COUNT(*) n FROM misure`).get() as { n: number };
+    const score = db.prepare(`SELECT COUNT(*) n FROM score`).get() as { n: number };
+    const consenso = db.prepare(`SELECT COUNT(*) n FROM profilo_note WHERE campo_id = 'consenso_sanitario'`)
+      .get() as { n: number };
+
+    expect(sessioni.n).toBe(0);
+    expect(misure.n).toBe(0);
+    expect(score.n).toBe(0);
+    expect(consenso.n).toBe(0);
+  });
+});

tests/longevity/db.test.ts

@@ -0,0 +1,89 @@
+import { describe, it, expect } from 'vitest';
+import { createLongevityDb, createIdentityDb, COPERTURA_MINIMA } from '../../src/lib/longevity/db';
+
+describe('schema longevity', () => {
+  it('crea le tabelle previste dalla spec', () => {
+    const db = createLongevityDb(':memory:');
+    const nomi = (db.prepare(`SELECT name FROM sqlite_master WHERE type='table'`).all() as { name: string }[])
+      .map((r) => r.name);
+    expect(nomi).toEqual(
+      expect.arrayContaining(['soggetti', 'sessioni', 'misure', 'registro_test', 'pesi', 'profilo_note', 'score'])
+    );
+  });
+
+  it('rifiuta un sesso non previsto', () => {
+    const db = createLongevityDb(':memory:');
+    expect(() =>
+      db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0001', 'X')`).run()
+    ).toThrow();
+  });
+
+  it('rifiuta una misura con test_id non nel registro', () => {
+    const db = createLongevityDb(':memory:');
+    db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0001', 'F')`).run();
+    db.prepare(`INSERT INTO sessioni (client_code, data, tipo) VALUES ('ISL-0001', '2026-08-21', 'checkup')`).run();
+    expect(() =>
+      db.prepare(
+        `INSERT INTO misure (sessione_id, client_code, test_id, valore_num, fonte)
+         VALUES (1, 'ISL-0001', 'test_inventato', 10, 'manuale')`
+      ).run()
+    ).toThrow();
+  });
+
+  it('uno score insufficiente puo non avere valore', () => {
+    const db = createLongevityDb(':memory:');
+    db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0001', 'F')`).run();
+    db.prepare(`INSERT INTO sessioni (client_code, data, tipo) VALUES ('ISL-0001', '2026-08-21', 'checkup')`).run();
+    db.prepare(
+      `INSERT INTO score (client_code, sessione_id, tipo, elemento, valore, copertura, stato, model_version)
+       VALUES ('ISL-0001', 1, 'asse', 'Forza & Struttura', NULL, 0.2, 'insufficiente', 'v1.0')`
+    ).run();
+    const row = db.prepare(`SELECT valore, stato FROM score`).get() as { valore: number | null; stato: string };
+    expect(row.valore).toBeNull();
+    expect(row.stato).toBe('insufficiente');
+  });
+
+  it('la tabella rifiuta uno score insufficiente CON un valore scritto', () => {
+    // Il tipo Punteggio protegge il codice, ma l'interfaccia legge dalla tabella,
+    // dove il tipo non c'e' piu': senza questo vincolo si potrebbe scrivere un
+    // numero dichiarato "insufficiente" e chi legge crud dalla tabella lo prenderebbe.
+    const db = createLongevityDb(':memory:');
+    db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0001', 'F')`).run();
+    db.prepare(`INSERT INTO sessioni (client_code, data, tipo) VALUES ('ISL-0001', '2026-08-21', 'checkup')`).run();
+    expect(() =>
+      db.prepare(
+        `INSERT INTO score (client_code, sessione_id, tipo, elemento, valore, copertura, stato, model_version)
+         VALUES ('ISL-0001', 1, 'asse', 'Forza & Struttura', 42, 0.2, 'insufficiente', 'v1.0')`
+      ).run()
+    ).toThrow();
+  });
+
+  it('la tabella rifiuta uno score ok SENZA valore', () => {
+    const db = createLongevityDb(':memory:');
+    db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0001', 'F')`).run();
+    db.prepare(`INSERT INTO sessioni (client_code, data, tipo) VALUES ('ISL-0001', '2026-08-21', 'checkup')`).run();
+    expect(() =>
+      db.prepare(
+        `INSERT INTO score (client_code, sessione_id, tipo, elemento, valore, copertura, stato, model_version)
+         VALUES ('ISL-0001', 1, 'asse', 'Forza & Struttura', NULL, 1, 'ok', 'v1.0')`
+      ).run()
+    ).toThrow();
+  });
+
+  it('identity tiene la persona, longevity non la conosce', () => {
+    const id = createIdentityDb(':memory:');
+    const cols = (id.prepare(`PRAGMA table_info(clienti)`).all() as { name: string }[]).map((c) => c.name);
+    expect(cols).toEqual(expect.arrayContaining(['client_code', 'user_id', 'nome', 'cognome', 'data_nascita']));
+
+    const lg = createLongevityDb(':memory:');
+    const tutte = (lg.prepare(`SELECT name FROM sqlite_master WHERE type='table'`).all() as { name: string }[])
+      .flatMap((t) => (lg.prepare(`PRAGMA table_info(${t.name})`).all() as { name: string }[]).map((c) => c.name));
+    expect(tutte).not.toContain('nome');
+    expect(tutte).not.toContain('cognome');
+    expect(tutte).not.toContain('data_nascita');
+  });
+
+  it('la soglia di copertura e 0.40', () => {
+    expect(COPERTURA_MINIMA).toBe(0.4);
+  });
+});

tests/longevity/export.test.ts

@@ -0,0 +1,85 @@
+import { describe, it, expect } from 'vitest';
+import { createLongevityDb } from '../../src/lib/longevity/db';
+import { seedRegistro } from '../../src/lib/longevity/registro';
+import { salvaCompilazione } from '../../src/lib/longevity/questionario';
+import { esportaMisure, esportaCsv } from '../../src/lib/longevity/export';
+
+function dbConDati() {
+  const db = createLongevityDb(':memory:');
+  seedRegistro(db);
+  db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0001', 'F')`).run();
+  salvaCompilazione(db, {
+    client_code: 'ISL-0001', data: '2026-08-21', eta: 35,
+    risposte: { q_ore_sonno: 7, q_riposato: 8 },
+    liberi: { farmaci: 'nessuno' },
+  });
+  return db;
+}
+
+describe('export per le statistiche', () => {
+  it('esporta una riga per misura con codice, non con nome', () => {
+    const db = dbConDati();
+    const out = esportaMisure(db);
+    expect(out.intestazioni).toEqual(
+      ['client_code', 'sesso', 'eta', 'data', 'tipo_sessione', 'quest_version', 'test_id', 'valore', 'unita', 'fonte', 'fuori_range']
+    );
+    expect(out.righe.length).toBe(2);
+    expect(out.righe[0][0]).toBe('ISL-0001');
+  });
+
+  it('l export non contiene campi identificativi', () => {
+    const db = dbConDati();
+    const testo = JSON.stringify(esportaMisure(db));
+    for (const vietato of ['nome', 'cognome', 'email', 'telefono', 'data_nascita']) {
+      expect(testo).not.toContain(vietato);
+    }
+  });
+
+  it('i campi liberi restano fuori dall export statistico', () => {
+    const db = dbConDati();
+    expect(JSON.stringify(esportaMisure(db))).not.toContain('nessuno');
+  });
+
+  it('produce un CSV con intestazione e una riga per misura', () => {
+    const db = dbConDati();
+    const righe = esportaCsv(db).trim().split('\n');
+    expect(righe.length).toBe(3); // intestazione + 2 misure
+    expect(righe[0]).toBe('client_code,sesso,eta,data,tipo_sessione,quest_version,test_id,valore,unita,fonte,fuori_range');
+  });
+
+  it('ogni valore sta sotto l intestazione giusta, colonna per colonna (asserzione posizionale)', () => {
+    // Non un indice scritto a mano: l'indice si cerca per NOME nell'intestazione prodotta.
+    // Se un domani la SELECT in export.ts viene riordinata senza riallineare INTESTAZIONI,
+    // il valore letto a quell'indice smette di corrispondere e l'asserzione fallisce -
+    // invece di restare verde con l'età etichettata come sesso.
+    const db = dbConDati();
+    const { intestazioni, righe } = esportaMisure(db);
+    const idx = (col: string) => {
+      const i = intestazioni.indexOf(col);
+      if (i < 0) throw new Error(`intestazione mancante: ${col}`);
+      return i;
+    };
+
+    const rigaSonno = righe.find((r) => r[idx('test_id')] === 'q_ore_sonno')!;
+    expect(rigaSonno).toBeDefined();
+    expect(rigaSonno[idx('client_code')]).toBe('ISL-0001');
+    expect(rigaSonno[idx('sesso')]).toBe('F');
+    expect(rigaSonno[idx('eta')]).toBe(35);
+    expect(rigaSonno[idx('data')]).toBe('2026-08-21');
+    expect(rigaSonno[idx('tipo_sessione')]).toBe('questionario');
+    expect(rigaSonno[idx('quest_version')]).toBe('v1.0');
+    expect(rigaSonno[idx('valore')]).toBe(7);
+    // salvaCompilazione non passa 'unita' per le risposte del questionario: resta null.
+    expect(rigaSonno[idx('unita')]).toBeNull();
+    expect(rigaSonno[idx('fonte')]).toBe('questionario');
+    expect(rigaSonno[idx('fuori_range')]).toBe(0);
+
+    const rigaRiposato = righe.find((r) => r[idx('test_id')] === 'q_riposato')!;
+    expect(rigaRiposato).toBeDefined();
+    expect(rigaRiposato[idx('client_code')]).toBe('ISL-0001');
+    expect(rigaRiposato[idx('sesso')]).toBe('F');
+    expect(rigaRiposato[idx('eta')]).toBe(35);
+    expect(rigaRiposato[idx('valore')]).toBe(8);
+    expect(rigaRiposato[idx('unita')]).toBeNull();
+  });
+});

tests/longevity/formato.test.ts

@@ -0,0 +1,16 @@
+import { describe, it, expect } from 'vitest';
+import { formattaNumero } from '../../src/lib/longevity/formato';
+
+describe('formattaNumero — i numeri del referto in italiano', () => {
+  it('un decimale usa la virgola, non il punto', () => {
+    expect(formattaNumero(72.5)).toBe('72,5');
+  });
+
+  it('un intero resta senza decimali spuri', () => {
+    expect(formattaNumero(80)).toBe('80');
+  });
+
+  it('un negativo (possibile solo per differenze, non per un punteggio 0-100) mantiene il segno', () => {
+    expect(formattaNumero(-3.2)).toBe('-3,2');
+  });
+});

tests/longevity/middleware.test.ts

@@ -0,0 +1,87 @@
+// Il difetto più serio di questo ramo era "una funzione di autorizzazione corretta che
+// nessuno chiama": isProtectedPath e canAccessAdminPath erano giuste, ma finché niente le
+// collegava dentro src/middleware.ts le pagine sanitarie restavano pubbliche. Nessun altro
+// test in tutto il repo importa src/middleware.ts: qui lo si carica davvero (vedi l'alias
+// 'astro:middleware' in vitest.config.ts, necessario perché quel modulo è virtuale e
+// risolto solo dentro la pipeline vite di Astro) e si esercita la funzione vera, non una
+// sua reimplementazione.
+import { describe, it, expect, beforeAll } from 'vitest';
+
+// getDb() (usato da src/middleware.ts) apre 'data/insanitylab.db' su disco per default:
+// DB_PATH va puntato a :memory: PRIMA che qualcosa lo chiami (il singleton è pigro).
+process.env.DB_PATH = ':memory:';
+
+type FakeContext = {
+  url: URL;
+  cookies: { get: (name: string) => { value: string } | undefined };
+  redirect: (path: string, status?: number) => Response;
+  locals: Record<string, unknown>;
+};
+
+function contesto(pathname: string, cookieValue?: string): FakeContext {
+  return {
+    url: new URL(`http://localhost${pathname}`),
+    cookies: { get: () => (cookieValue !== undefined ? { value: cookieValue } : undefined) },
+    redirect: (path, status) => new Response(null, { status: status ?? 302, headers: { Location: path } }),
+    locals: {},
+  };
+}
+
+function next() {
+  let chiamata = false;
+  const fn = async () => { chiamata = true; return new Response('PAGINA-SERVITA'); };
+  return { fn, fuChiamata: () => chiamata };
+}
+
+describe('src/middleware.ts — protezione reale delle rotte longevity', () => {
+  let onRequest: (context: FakeContext, next: () => Promise<Response>) => Response | Promise<Response>;
+
+  beforeAll(async () => {
+    const mod = await import('../../src/middleware.ts');
+    // FakeContext è un doppio minimale di APIContext (solo cio' che onRequest usa
+    // davvero: url, cookies, redirect, locals), non un APIContext completo: il cast
+    // diretto viene rifiutato dal typecheck perche' i due tipi non si sovrappongono
+    // abbastanza. Si passa da 'unknown' perche' e' un cast intenzionale, non un bug.
+    onRequest = mod.onRequest as unknown as typeof onRequest;
+  });
+
+  it('una rotta longevity senza sessione (nessun cookie) redirige al login e non serve la pagina', async () => {
+    const ctx = contesto('/longevity/io');
+    const n = next();
+    const res = await onRequest(ctx, n.fn);
+
+    expect(n.fuChiamata()).toBe(false);
+    expect(res).toBeInstanceOf(Response);
+    expect([301, 302, 303, 307, 308]).toContain((res as Response).status);
+    expect((res as Response).headers.get('Location')).toMatch(/^\/login/);
+  });
+
+  it('una rotta longevity con un token di sessione inesistente redirige comunque al login', async () => {
+    const ctx = contesto('/longevity/gestionale', 'token-che-non-esiste-in-nessuna-sessione');
+    const n = next();
+    const res = await onRequest(ctx, n.fn);
+
+    expect(n.fuChiamata()).toBe(false);
+    expect((res as Response).headers.get('Location')).toMatch(/^\/login/);
+  });
+
+  it('una API longevity senza sessione risponde 401, non serve la richiesta', async () => {
+    const ctx = contesto('/api/longevity/qualcosa');
+    const n = next();
+    const res = await onRequest(ctx, n.fn);
+
+    expect(n.fuChiamata()).toBe(false);
+    expect((res as Response).status).toBe(401);
+    const body = await (res as Response).json();
+    expect(body.error).toBeTruthy();
+  });
+
+  it('una rotta pubblica non passa da nessun controllo: next() viene chiamata', async () => {
+    const ctx = contesto('/blog');
+    const n = next();
+    const res = await onRequest(ctx, n.fn);
+
+    expect(n.fuChiamata()).toBe(true);
+    expect(await (res as Response).text()).toBe('PAGINA-SERVITA');
+  });
+});

tests/longevity/misure.test.ts

@@ -0,0 +1,64 @@
+import { describe, it, expect } from 'vitest';
+import { createLongevityDb } from '../../src/lib/longevity/db';
+import { seedRegistro } from '../../src/lib/longevity/registro';
+import { apriSessione, registraMisure } from '../../src/lib/longevity/misure';
+
+function dbPronto() {
+  const db = createLongevityDb(':memory:');
+  seedRegistro(db);
+  db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0001', 'F')`).run();
+  return db;
+}
+
+describe('registrazione delle misure', () => {
+  it('scrive le misure di una sessione', () => {
+    const db = dbPronto();
+    const s = apriSessione(db, { client_code: 'ISL-0001', data: '2026-08-21', tipo: 'questionario', quest_version: 'v1.0' });
+    const esito = registraMisure(db, s, 'questionario', [
+      { test_id: 'q_ore_sonno', valore_num: 7.5 },
+      { test_id: 'q_riposato', valore_num: 8 },
+    ]);
+    expect(esito.scritte).toBe(2);
+    const n = db.prepare(`SELECT COUNT(*) n FROM misure WHERE sessione_id = ?`).get(s) as { n: number };
+    expect(n.n).toBe(2);
+  });
+
+  it('rifiuta un test sconosciuto e non scrive niente del lotto', () => {
+    const db = dbPronto();
+    const s = apriSessione(db, { client_code: 'ISL-0001', data: '2026-08-21', tipo: 'checkup' });
+    expect(() =>
+      registraMisure(db, s, 'manuale', [
+        { test_id: 'q_ore_sonno', valore_num: 7 },
+        { test_id: 'test_inventato', valore_num: 1 },
+      ])
+    ).toThrow(/test_inventato/);
+    const n = db.prepare(`SELECT COUNT(*) n FROM misure`).get() as { n: number };
+    expect(n.n).toBe(0);
+  });
+
+  it('un valore fuori dal range atteso si scrive e si marca', () => {
+    const db = dbPronto();
+    const s = apriSessione(db, { client_code: 'ISL-0001', data: '2026-08-21', tipo: 'questionario' });
+    const esito = registraMisure(db, s, 'questionario', [{ test_id: 'q_ore_sonno', valore_num: 26 }]);
+    expect(esito.fuoriRange).toEqual(['q_ore_sonno']);
+    const row = db.prepare(`SELECT valore_num, fuori_range FROM misure WHERE test_id = 'q_ore_sonno'`).get() as { valore_num: number; fuori_range: number };
+    expect(row.fuori_range).toBe(1);
+    expect(row.valore_num).toBe(26);
+  });
+
+  it('la sessione porta la versione del questionario', () => {
+    const db = dbPronto();
+    const s = apriSessione(db, { client_code: 'ISL-0001', data: '2026-08-21', tipo: 'questionario', quest_version: 'v1.0' });
+    const row = db.prepare(`SELECT quest_version FROM sessioni WHERE id = ?`).get(s) as { quest_version: string };
+    expect(row.quest_version).toBe('v1.0');
+  });
+
+  it('il client_code della misura viene dalla sessione, non da chi chiama', () => {
+    const db = dbPronto();
+    db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0002', 'M')`).run();
+    const s = apriSessione(db, { client_code: 'ISL-0002', data: '2026-08-21', tipo: 'checkup' });
+    registraMisure(db, s, 'manuale', [{ test_id: 'q_riposato', valore_num: 5 }]);
+    const row = db.prepare(`SELECT client_code FROM misure`).get() as { client_code: string };
+    expect(row.client_code).toBe('ISL-0002');
+  });
+});

tests/longevity/motore-cascata.test.ts

@@ -0,0 +1,99 @@
+// tests/longevity/motore-cascata.test.ts
+import { describe, it, expect } from 'vitest';
+import { COPERTURA_MINIMA } from '../../src/lib/longevity/db';
+import { aggrega, calcolaAsse, calcolaMacro, calcolaFitnessAge } from '../../src/lib/longevity/motore/cascata';
+
+describe('aggregazione e rinormalizzazione', () => {
+  it('con tutti i dati fa la media pesata', () => {
+    const r = aggrega([{ punteggio: 80, peso: 0.5 }, { punteggio: 60, peso: 0.5 }]);
+    expect(r.stato).toBe('ok');
+    if (r.stato === 'ok') { expect(r.valore).toBeCloseTo(70, 1); expect(r.copertura).toBe(1); }
+  });
+
+  it('un dato mancante ridistribuisce il suo peso, non vale zero', () => {
+    const r = aggrega([{ punteggio: 80, peso: 0.5 }, { punteggio: null, peso: 0.25 }, { punteggio: 60, peso: 0.25 }]);
+    expect(r.stato).toBe('ok');
+    // 80*0.5 + 60*0.25 = 55, su peso disponibile 0.75 -> 73.3, non 55
+    if (r.stato === 'ok') { expect(r.valore).toBeCloseTo(73.3, 1); expect(r.copertura).toBeCloseTo(0.75, 2); }
+  });
+
+  it('sotto la soglia di copertura NON esiste un valore da leggere', () => {
+    const r = aggrega([{ punteggio: 90, peso: 0.2 }, { punteggio: null, peso: 0.8 }]);
+    expect(r.stato).toBe('insufficiente');
+    expect(r.copertura).toBeCloseTo(0.2, 2);
+    // il punto dell'intero tipo: chi consuma non ha il campo da cui prendere il numero
+    expect((r as { valore?: number }).valore).toBeUndefined();
+  });
+
+  it('la soglia e quella dichiarata una volta sola, non un numero sparso', () => {
+    const pocoSotto = aggrega([{ punteggio: 90, peso: COPERTURA_MINIMA - 0.01 }, { punteggio: null, peso: 1 - COPERTURA_MINIMA + 0.01 }]);
+    const esatto = aggrega([{ punteggio: 90, peso: COPERTURA_MINIMA }, { punteggio: null, peso: 1 - COPERTURA_MINIMA }]);
+    expect(pocoSotto.stato).toBe('insufficiente');
+    expect(esatto.stato).toBe('ok');   // la soglia e inclusiva, come nell'oracolo
+  });
+
+  it('senza nessun dato e insufficiente con copertura zero', () => {
+    const r = aggrega([{ punteggio: null, peso: 1 }]);
+    expect(r.stato).toBe('insufficiente');
+    expect(r.copertura).toBe(0);
+  });
+
+  // Bug trovato in revisione: il confronto con la soglia usava la copertura
+  // GIA' arrotondata a due decimali, non quella grezza. Una copertura grezza
+  // di 0.396 arrotonda a 0.40 - uguale alla soglia - e con l'arrotondamento
+  // fatto PRIMA del confronto passava per 'ok'. Verificato anche contro
+  // l'oracolo Python: aggregate([WeightedScore(90, 0.396), WeightedScore(None,
+  // 0.604)]) -> (90.0, 0.4, 'insufficiente').
+  it('una copertura grezza appena sotto la soglia resta insufficiente anche se arrotonda a 0.40', () => {
+    const r = aggrega([{ punteggio: 90, peso: 0.396 }, { punteggio: null, peso: 0.604 }]);
+    expect(r.stato).toBe('insufficiente');
+    expect(r.copertura).toBeCloseTo(0.40, 2);  // il valore esposto arrotonda a 0.40, ma lo stato resta insufficiente
+  });
+
+  // Simmetrico: una copertura grezza appena SOPRA la soglia (0.404, che
+  // arrotonda anch'essa a 0.40) deve restare 'ok' - il fix non deve aver
+  // spostato la soglia dall'altra parte. Oracolo: aggregate([WeightedScore(90,
+  // 0.404), WeightedScore(None, 0.596)]) -> (90.0, 0.4, 'ok').
+  it('una copertura grezza appena sopra la soglia resta ok: il fix non ha spostato la soglia', () => {
+    const r = aggrega([{ punteggio: 90, peso: 0.404 }, { punteggio: null, peso: 0.596 }]);
+    expect(r.stato).toBe('ok');
+    if (r.stato === 'ok') expect(r.copertura).toBeCloseTo(0.40, 2);
+  });
+});
+
+describe('assi, macro e Fitness Age', () => {
+  const PESI_FORZA = { handgrip: 0.25, spinta: 0.2, trazione: 0.2, arti_inferiori: 0.2, core: 0.15 };
+
+  it('un asse si calcola sui suoi sotto-domini', () => {
+    const r = calcolaAsse(PESI_FORZA, { handgrip: 70, spinta: 60, trazione: 65, arti_inferiori: 80, core: 50 });
+    expect(r.stato).toBe('ok');
+    // 70*.25 + 60*.2 + 65*.2 + 80*.2 + 50*.15 = 66.0 (verificato anche a mano, non 66.25 come
+    // nel brief: la costante li' e' un refuso, corretto qui dopo averlo verificato col conto)
+    if (r.stato === 'ok') expect(r.valore).toBeCloseTo(66.0, 1);
+  });
+
+  it('un asse insufficiente NON entra nel macro-score, invece di entrarci come zero', () => {
+    const assi = {
+      A: { stato: 'ok', valore: 80, copertura: 1 } as const,
+      B: { stato: 'insufficiente', copertura: 0.1 } as const,
+    };
+    const r = calcolaMacro({ A: 0.5, B: 0.5 }, assi);
+    expect(r.stato).toBe('ok');
+    // se B entrasse come zero il risultato sarebbe 40: la rinormalizzazione lo esclude
+    if (r.stato === 'ok') { expect(r.valore).toBeCloseTo(80, 1); expect(r.copertura).toBeCloseTo(0.5, 2); }
+  });
+
+  it('la Fitness Age scende sotto l eta quando il composito supera 50', () => {
+    const pesi = { cardio: 0.3, handgrip_isolato: 0.2, hrv_isolato: 0.2, forza_resto: 0.15, composizione: 0.1, stabilita: 0.05 };
+    const r = calcolaFitnessAge(40, pesi, { cardio: 75, handgrip_isolato: 75, hrv_isolato: 75, forza_resto: 75, composizione: 75, stabilita: 75 });
+    // 40 - (75 - 50) * 0.4 = 30
+    expect(r.fitnessAge).toBeCloseTo(30, 1);
+  });
+
+  it('senza dati sufficienti la Fitness Age non esiste', () => {
+    const pesi = { cardio: 0.3, handgrip_isolato: 0.2, hrv_isolato: 0.2, forza_resto: 0.15, composizione: 0.1, stabilita: 0.05 };
+    const r = calcolaFitnessAge(40, pesi, { cardio: 75, handgrip_isolato: null, hrv_isolato: null, forza_resto: null, composizione: null, stabilita: null });
+    expect(r.composito.stato).toBe('insufficiente');
+    expect(r.fitnessAge).toBeNull();
+  });
+});

tests/longevity/motore-caso-reale.test.ts

@@ -0,0 +1,81 @@
+import { describe, it, expect } from 'vitest';
+import { createLongevityDb } from '../../src/lib/longevity/db';
+import { seedRegistro, seedPesi, MODEL_VERSION } from '../../src/lib/longevity/registro';
+import { apriSessione, registraMisure } from '../../src/lib/longevity/misure';
+import { calcolaSessione } from '../../src/lib/longevity/motore';
+
+/**
+ * Riproduce la situazione descritta nella documentazione del cliente: una persona di cui
+ * si conosce solo la composizione corporea, misurata dalla Wellness Tower. Un asse pieno,
+ * tutti gli altri scoperti. È il caso in cui un motore ingenuo mostrerebbe sei zeri.
+ * Dati sintetici: nessuna persona reale.
+ */
+describe('un profilo con una sola area misurata', () => {
+  it('mostra l asse coperto e dichiara insufficienti gli altri sei', () => {
+    const db = createLongevityDb(':memory:');
+    seedRegistro(db);
+    seedPesi(db, MODEL_VERSION);
+    db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0001','M')`).run();
+
+    // i tre test di composizione esistono nel registro solo dopo il piano degli import:
+    // finche non ci sono, questo test dimostra il comportamento con zero misure fisiche
+    const s = apriSessione(db, { client_code: 'ISL-0001', data: '2026-08-22', tipo: 'checkup', eta_alla_data: 38 });
+    registraMisure(db, s, 'questionario', []);
+
+    const r = calcolaSessione(db, s);
+    const insufficienti = Object.values(r.assi).filter((a) => a.stato === 'insufficiente').length;
+    expect(insufficienti).toBe(7);
+    expect(r.fitnessAge).toBeNull();
+  });
+
+  it('nessun asse insufficiente porta con se un valore da mostrare per sbaglio', () => {
+    const db = createLongevityDb(':memory:');
+    seedRegistro(db);
+    seedPesi(db, MODEL_VERSION);
+    db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0002','F')`).run();
+    const s = apriSessione(db, { client_code: 'ISL-0002', data: '2026-08-22', tipo: 'checkup', eta_alla_data: 35 });
+    registraMisure(db, s, 'questionario', []);
+
+    const r = calcolaSessione(db, s);
+    for (const [nome, asse] of Object.entries(r.assi)) {
+      if (asse.stato === 'insufficiente') {
+        expect((asse as { valore?: number }).valore, `${nome} espone un valore`).toBeUndefined();
+      }
+    }
+  });
+
+  /**
+   * Il caso misto: quello che la prima dashboard disegnera' davvero, non "tutto
+   * insufficiente". Realizza per intero la premessa del describe qui sopra — la
+   * composizione corporea davvero misurata dalla Wellness Tower — aggiungendo le
+   * due voci al registro (arrivano col piano degli import; qui bastano due righe,
+   * non serve aspettarle) e registrando le misure end-to-end.
+   */
+  it('un asse valido (Composizione Corporea) e sei insufficienti, end-to-end', () => {
+    const db = createLongevityDb(':memory:');
+    seedRegistro(db);
+    seedPesi(db, MODEL_VERSION);
+    db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0003','M')`).run();
+
+    db.prepare(
+      `INSERT INTO registro_test (test_id, etichetta, tipo_valore, curva, params, asse, sotto_dominio, attivo_da)
+       VALUES ('wt_grasso', 'Grasso % (Wellness Tower)', 'num', 'lin_dec', ?, 'Composizione Corporea', 'grasso', '2026-01-01')`
+    ).run(JSON.stringify({ best: 10, worst: 40 }));
+    db.prepare(
+      `INSERT INTO registro_test (test_id, etichetta, tipo_valore, curva, params, asse, sotto_dominio, attivo_da)
+       VALUES ('wt_muscolo', 'Muscolo % (Wellness Tower)', 'num', 'lin_dec', ?, 'Composizione Corporea', 'muscolo', '2026-01-01')`
+    ).run(JSON.stringify({ best: 50, worst: 30 }));
+
+    const s = apriSessione(db, { client_code: 'ISL-0003', data: '2026-08-22', tipo: 'checkup', eta_alla_data: 38 });
+    registraMisure(db, s, 'wellness_tower', [
+      { test_id: 'wt_grasso', valore_num: 15 },
+      { test_id: 'wt_muscolo', valore_num: 45 },
+    ]);
+
+    const r = calcolaSessione(db, s);
+    expect(r.assi['Composizione Corporea'].stato).toBe('ok');
+    const insufficienti = Object.entries(r.assi)
+      .filter(([nome, a]) => nome !== 'Composizione Corporea' && a.stato === 'insufficiente');
+    expect(insufficienti.length).toBe(6);
+  });
+});

tests/longevity/motore-curve.test.ts

@@ -0,0 +1,173 @@
+import { describe, it, expect } from 'vitest';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import {
+  clamp, lerp, arrotonda1, curvaCampana, curvaDecrescente, curvaCrescenteConPlateau,
+  curvaDirettaX10, curvaDirettaX10Invertita, curvaGradini,
+} from '../../src/lib/longevity/motore/curve';
+
+const RIF = JSON.parse(
+  readFileSync(join(process.cwd(), 'tests/longevity/riferimento/riferimento.json'), 'utf8')
+) as { casi: { fn: string; args: unknown[]; atteso: number }[] };
+
+const casiDi = (fn: string) => RIF.casi.filter((c) => c.fn === fn);
+
+describe('curve del questionario, confrontate con l oracolo', () => {
+  it('la campana combacia su tutto il dominio', () => {
+    const casi = casiDi('score_bell_curve');
+    expect(casi.length).toBeGreaterThan(20);
+    for (const c of casi) {
+      const [v, low, pl, ph, high] = c.args as number[];
+      expect(curvaCampana(v, low, pl, ph, high)).toBeCloseTo(c.atteso, 1);
+    }
+  });
+
+  it('la decrescente combacia, inclusa la soglia 7-14 dell alcol', () => {
+    const casi = casiDi('score_decreasing');
+    expect(casi.length).toBeGreaterThan(40);
+    for (const c of casi) {
+      const [v, best, worst] = c.args as number[];
+      expect(curvaDecrescente(v, best, worst)).toBeCloseTo(c.atteso, 1);
+    }
+  });
+
+  it('la crescente con plateau combacia', () => {
+    const casi = casiDi('score_increasing_plateau');
+    expect(casi.length).toBeGreaterThan(20);
+    for (const c of casi) {
+      const [v, worst, plateau] = c.args as number[];
+      expect(curvaCrescenteConPlateau(v, worst, plateau)).toBeCloseTo(c.atteso, 1);
+    }
+  });
+
+  it('la diretta per dieci combacia', () => {
+    const casi = casiDi('score_direct_x10');
+    expect(casi.length).toBeGreaterThan(10);
+    for (const c of casi) {
+      expect(curvaDirettaX10((c.args as number[])[0])).toBeCloseTo(c.atteso, 1);
+    }
+  });
+
+  // Questa curva NON esiste nell'oracolo: è la quinta, che al motore del cliente manca.
+  // Serve a q_calo_pomeridiano e nel prototipo HTML è `scale10_inv`: (10 - v) * 10.
+  it('la diretta invertita e il complemento della diretta', () => {
+    for (const v of [0, 2.5, 5, 7.5, 10]) {
+      expect(curvaDirettaX10Invertita(v)).toBeCloseTo(curvaDirettaX10(10 - v), 6);
+    }
+    expect(curvaDirettaX10Invertita(0)).toBe(100);
+    expect(curvaDirettaX10Invertita(10)).toBe(0);
+  });
+
+  it('i gradini decrescenti riproducono il prototipo: q_sigarette', () => {
+    const steps: [number, number][] = [[0, 100], [5, 60], [10, 40], [20, 20], [999, 0]];
+    expect(curvaGradini(0, steps, undefined, true)).toBe(100);
+    expect(curvaGradini(5, steps, undefined, true)).toBe(60);
+    expect(curvaGradini(10, steps, undefined, true)).toBe(40);
+    expect(curvaGradini(20, steps, undefined, true)).toBe(20);
+    expect(curvaGradini(40, steps, undefined, true)).toBeLessThan(20);
+  });
+
+  // Il ramo crescente non era esercitato da nessun test: l'ancoraggio (0, 20)
+  // — invece di (0, 100) — poteva essere invertito o sbagliato senza che
+  // niente diventasse rosso. Parametri veri da src/lib/longevity/registro.ts.
+  it('i gradini crescenti riproducono il prototipo: q_attivita e q_luce', () => {
+    // q_attivita: nessun zeroVal, i gradini partono già da (0, 20).
+    const stepsAttivita: [number, number][] = [[0, 20], [2, 50], [4, 80], [999, 100]];
+    expect(curvaGradini(0, stepsAttivita, undefined, false)).toBe(20);
+    expect(curvaGradini(2, stepsAttivita, undefined, false)).toBe(50);
+    expect(curvaGradini(4, stepsAttivita, undefined, false)).toBe(80);
+    expect(curvaGradini(999, stepsAttivita, undefined, false)).toBe(100);
+    expect(curvaGradini(1, stepsAttivita, undefined, false)).toBe(35);   // interpolato fra (0,20) e (2,50)
+    expect(curvaGradini(3, stepsAttivita, undefined, false)).toBe(65);   // interpolato fra (2,50) e (4,80)
+
+    // q_luce: zeroVal 20, gradini che partono da 0.5 — l'ancoraggio (0, 20)
+    // serve davvero per interpolare fra 0 (escluso, coperto da zeroVal) e 0.5.
+    const stepsLuce: [number, number][] = [[0.5, 60], [1, 90], [999, 100]];
+    expect(curvaGradini(0.5, stepsLuce, 20, false)).toBe(60);
+    expect(curvaGradini(1, stepsLuce, 20, false)).toBe(90);
+    expect(curvaGradini(999, stepsLuce, 20, false)).toBe(100);
+    expect(curvaGradini(0.75, stepsLuce, 20, false)).toBe(75);          // interpolato fra (0.5,60) e (1,90)
+    expect(curvaGradini(0.25, stepsLuce, 20, false)).toBe(40);          // interpolato fra l'ancoraggio (0,20) e (0.5,60)
+  });
+
+  // Non basta controllare che a zero il risultato sia il valore atteso: se
+  // zeroVal COINCIDE con l'ancoraggio di default (100 per il decrescente,
+  // 20 per il crescente, come in q_schermi e q_luce) il test passa anche
+  // cancellando dal codice la riga che gestisce lo zero. Qui zeroVal è
+  // deliberatamente diverso dall'ancoraggio, in entrambe le direzioni: se
+  // la riga sparisse, l'interpolazione a v=0 darebbe l'ancoraggio (100 o 20),
+  // non questi valori, e il test diventerebbe rosso.
+  it('zeroVal vince sui gradini anche quando NON coincide con l ancoraggio', () => {
+    // q_schermi, il caso reale: qui zeroVal (100) coincide con l'ancoraggio
+    // decrescente (100), quindi da solo NON è discriminante — resta utile
+    // come controllo del valore vero, non come prova dello zero speciale.
+    const stepsSchermi: [number, number][] = [[15, 85], [30, 70], [60, 40], [999, 10]];
+    expect(curvaGradini(0, stepsSchermi, 100, true)).toBe(100);
+    expect(curvaGradini(15, stepsSchermi, 100, true)).toBe(85);
+
+    // Discriminante, decrescente: ancoraggio di default sarebbe 100,
+    // zeroVal è 42. Senza la riga dello zero speciale risulterebbe 100.
+    const stepsDecrescenteDiscriminante: [number, number][] = [[10, 80], [30, 50], [999, 10]];
+    expect(curvaGradini(0, stepsDecrescenteDiscriminante, 42, true)).toBe(42);
+
+    // Discriminante, crescente: ancoraggio di default sarebbe 20,
+    // zeroVal è 55. Senza la riga dello zero speciale risulterebbe 20.
+    const stepsCrescenteDiscriminante: [number, number][] = [[5, 40], [20, 70], [999, 100]];
+    expect(curvaGradini(0, stepsCrescenteDiscriminante, 55, false)).toBe(55);
+  });
+
+  it('clamp e lerp si comportano come nell oracolo', () => {
+    expect(clamp(150)).toBe(100);
+    expect(clamp(-5)).toBe(0);
+    expect(lerp(5, 0, 10, 0, 100)).toBe(50);
+    expect(lerp(-1, 0, 10, 0, 100)).toBe(0);   // t viene limitato a [0,1]
+    expect(lerp(11, 0, 10, 0, 100)).toBe(100);
+  });
+
+  // round(x, 1) di Python arrotonda al pari sui pareggi ESATTI (banker's
+  // rounding), non sempre in su. Senza questi casi un arrotondamento naive
+  // (Math.round(x*10)/10, che su 86.25 darebbe 86.3) sarebbe indistinguibile
+  // dal corretto in tutti gli altri test: qui il pareggio e' deliberato.
+  it('arrotonda1 arrotonda al pari sui pareggi esatti, come round() di Python', () => {
+    expect(arrotonda1(86.25)).toBe(86.2);  // 862 e' pari: resta 86.2, non sale a 86.3
+    expect(arrotonda1(86.75)).toBe(86.8);  // 867 e' dispari: sale a 86.8, non resta 86.7
+    expect(arrotonda1(86.24)).toBe(86.2);  // non un pareggio: arrotondamento normale, per basso
+    expect(arrotonda1(86.26)).toBe(86.3);  // non un pareggio: arrotondamento normale, per alto
+  });
+
+  // 86.35 NON e' un pareggio vero: il double che gli sta dietro vale
+  // 86.34999999999999431..., quindi Python arrotonda (senza ambiguita') a
+  // 86.3. Una prima versione di arrotonda1, che moltiplicava per 10 e
+  // testava una tolleranza, ci cadeva: 86.35 * 10 arrotonda ESATTAMENTE a
+  // 863.5 in virgola mobile (un pareggio creato dalla moltiplicazione, non
+  // presente nel valore originale) e restituiva 86.4. Questo test blocca
+  // proprio quella regressione.
+  it('arrotonda1 non inventa un pareggio dove il double non ce l ha (86.35 -> 86.3, non un pareggio)', () => {
+    expect(arrotonda1(86.35)).toBe(86.3);
+    expect(arrotonda1(-86.35)).toBe(-86.3);
+  });
+
+  // Generalizzazione a `decimali` cifre (usata da cascata.ts per la copertura,
+  // a 2 decimali): stesso criterio dei test sopra, un gradino piu' in la'.
+  // 0.125 e 0.375 sono pareggi ESATTI a due decimali (double rappresentabili
+  // in binario senza resto: 1/8 e 3/8), verificati anche a mano con
+  // round(0.125, 2) e round(0.375, 2) in Python.
+  it('arrotonda1(x, 2) arrotonda al pari sui pareggi esatti a due decimali', () => {
+    expect(arrotonda1(0.125, 2)).toBe(0.12);  // 12 e' pari: resta 0.12, non sale a 0.13
+    expect(arrotonda1(0.375, 2)).toBe(0.38);  // 37 e' dispari: sale a 0.38, non resta 0.37
+    expect(arrotonda1(0.124, 2)).toBe(0.12);  // non un pareggio: arrotondamento normale, per basso
+    expect(arrotonda1(0.126, 2)).toBe(0.13);  // non un pareggio: arrotondamento normale, per alto
+  });
+
+  // 0.045 e' l'analogo a due decimali di 86.35: il double che gli sta dietro
+  // vale 0.044999999999999998..., quindi Python (e l'oracolo) arrotondano
+  // SENZA ambiguita' a 0.04. Ma 0.045 * 100 arrotonda ESATTAMENTE a 4.5 in
+  // virgola mobile - un pareggio creato dalla moltiplicazione, non presente
+  // nel valore originale - e un arrotondamento naive (Math.round(x*100)/100,
+  // la stessa `arrotonda2` locale rimossa da cascata.ts) ci sarebbe caduto,
+  // restituendo 0.05 invece di 0.04.
+  it('arrotonda1(x, 2) non inventa un pareggio dove il double non ce l ha (0.045 -> 0.04, non un pareggio)', () => {
+    expect(arrotonda1(0.045, 2)).toBe(0.04);
+    expect(arrotonda1(-0.045, 2)).toBe(-0.04);
+  });
+});

tests/longevity/motore-fisici.test.ts

@@ -0,0 +1,91 @@
+import { describe, it, expect } from 'vitest';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import * as F from '../../src/lib/longevity/motore/test-fisici';
+
+const RIF = JSON.parse(
+  readFileSync(join(process.cwd(), 'tests/longevity/riferimento/riferimento.json'), 'utf8')
+) as { casi: { fn: string; args: unknown[]; atteso: number }[] };
+
+/** Ogni funzione dell'oracolo con la sua gemella in TypeScript. */
+const COPPIE: [string, (...a: never[]) => number][] = [
+  ['score_fat_percent', F.scoreGrassoPercento as never],
+  ['score_muscle_percent', F.scoreMuscoloPercento as never],
+  ['score_whr', F.scoreWhr as never],
+  ['score_vo2max', F.scoreVo2max as never],
+  ['score_spo2', F.scoreSpo2 as never],
+  ['score_blood_pressure', F.scorePressione as never],
+  ['score_hrr', F.scoreRecuperoCardiaco as never],
+  ['score_handgrip', F.scoreHandgrip as never],
+  ['score_pushup', F.scorePushup as never],
+  ['score_flexed_arm_hang', F.scoreTrazioneIsometrica as never],
+  ['score_sit_to_stand_1min', F.scoreSitToStand as never],
+  ['score_plank', F.scorePlank as never],
+  ['score_back_scratch', F.scoreBackScratch as never],
+  ['score_shoulder_mobility_wt', F.scoreMobilitaSpalla as never],
+  ['score_flamingo', F.scoreFlamingo as never],
+  ['score_sit_and_reach', F.scoreSitAndReach as never],
+  ['vo2max_from_step_test', F.vo2maxDaStepTest as never],
+  ['vo2max_from_2km_walk', F.vo2maxDa2kmWalk as never],
+  ['vo2max_from_mutt', F.vo2maxDaMutt as never],
+  ['vo2max_from_milfit', F.vo2maxDaMilfit as never],
+];
+
+describe('curve dei test fisici, confrontate con l oracolo caso per caso', () => {
+  for (const [nomePython, fnTs] of COPPIE) {
+    it(`${nomePython} combacia su tutti i casi del riferimento`, () => {
+      const casi = RIF.casi.filter((c) => c.fn === nomePython);
+      expect(casi.length, `nessun caso per ${nomePython}: la griglia non lo copre`).toBeGreaterThan(0);
+      const divergenti: string[] = [];
+      for (const c of casi) {
+        const ottenuto = (fnTs as (...a: unknown[]) => number)(...c.args);
+        if (Math.abs(ottenuto - c.atteso) > 0.05) {
+          divergenti.push(`${nomePython}(${c.args.join(', ')}): atteso ${c.atteso}, ottenuto ${ottenuto}`);
+        }
+      }
+      expect(divergenti.slice(0, 5).join('\n')).toBe('');
+    });
+  }
+
+  it('i sollevamenti sul peso corporeo combaciano su tutte e tre le tabelle DEFINITE NEL CODICE', () => {
+    // Prima versione di questo test: passava alla funzione le tabelle lette dagli
+    // argomenti del riferimento (c.args), non le costanti TIERS_* definite nel
+    // codice — le sei tabelle non erano confrontate contro l'oracolo da nessuno.
+    // Qui si usano SOLO le costanti del modulo: se una venisse alterata, nessun
+    // caso combacerebbe piu' con gli argomenti del riferimento e il test cade.
+    const casi = RIF.casi.filter((c) => c.fn === 'score_bw_ratio_lift');
+    expect(casi.length).toBeGreaterThan(50);
+
+    const TABELLE: [string, [number, number][], [number, number][]][] = [
+      ['bench', F.TIERS_BENCH_M, F.TIERS_BENCH_F],
+      ['squat', F.TIERS_SQUAT_M, F.TIERS_SQUAT_F],
+      ['row', F.TIERS_ROW_M, F.TIERS_ROW_F],
+    ];
+    const perTabella: Record<string, number> = { bench: 0, squat: 0, row: 0 };
+
+    for (const c of casi) {
+      const [carico, peso, rip, tiersMRif, , sesso] = c.args as [number, number, number, unknown, unknown, 'M' | 'F'];
+      // Identifica QUALE tabella del codice questo caso sta esercitando confrontando
+      // gli argomenti del riferimento con le costanti vere — non il contrario.
+      const trovata = TABELLE.find(([, tm]) => JSON.stringify(tm) === JSON.stringify(tiersMRif));
+      expect(trovata, `nessuna tabella del codice combacia con gli argomenti del caso: carico ${carico} ${sesso}`).toBeDefined();
+      const [nome, tiersM, tiersF] = trovata!;
+      perTabella[nome]++;
+
+      const ottenuto = F.scoreSollevamentoSuPeso(carico, peso, rip, tiersM, tiersF, sesso);
+      expect(ottenuto, `${nome} carico ${carico} ${sesso}`).toBeCloseTo(c.atteso, 1);
+    }
+    // Tutte e tre le tabelle sono state esercitate davvero, non solo dichiarate.
+    expect(perTabella.bench).toBeGreaterThan(0);
+    expect(perTabella.squat).toBeGreaterThan(0);
+    expect(perTabella.row).toBeGreaterThan(0);
+  });
+
+  it('le due funzioni escluse dal porting non esistono nel modulo', () => {
+    // Agilita: il cliente l'ha esclusa dallo score il 13/08 (scale non comparabili fra protocolli).
+    expect((F as Record<string, unknown>).scoreAgilita).toBeUndefined();
+    expect((F as Record<string, unknown>).scoreAgilityMs).toBeUndefined();
+    // score_generic_range_local: definita in fondo all'oracolo ma non chiamata da nessun peso.
+    expect((F as Record<string, unknown>).scoreGenericRangeLocal).toBeUndefined();
+  });
+});

tests/longevity/motore.test.ts

@@ -0,0 +1,305 @@
+import { describe, it, expect } from 'vitest';
+import { createLongevityDb } from '../../src/lib/longevity/db';
+import { seedRegistro, seedPesi, MODEL_VERSION, pesiDi } from '../../src/lib/longevity/registro';
+import { salvaCompilazione } from '../../src/lib/longevity/questionario';
+import { apriSessione, registraMisure } from '../../src/lib/longevity/misure';
+import { calcolaAsse } from '../../src/lib/longevity/motore/cascata';
+import { applicaCurva, calcolaSessione, salvaScore, leggiScore } from '../../src/lib/longevity/motore';
+
+function dbPronto() {
+  const db = createLongevityDb(':memory:');
+  seedRegistro(db);
+  seedPesi(db, MODEL_VERSION);
+  db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0001','F')`).run();
+  return db;
+}
+
+const voce = (db: ReturnType<typeof dbPronto>, id: string) =>
+  db.prepare(`SELECT * FROM registro_test WHERE test_id = ?`).get(id) as Record<string, unknown>;
+
+describe('il motore legge le curve dal registro', () => {
+  it('applica la curva dichiarata per il test, non una scritta nel codice', () => {
+    const db = dbPronto();
+    const v = { ...voce(db, 'q_ore_sonno'), params: JSON.parse(voce(db, 'q_ore_sonno').params as string) };
+    expect(applicaCurva(v as never, 8)).toBe(100);    // dentro il picco 7-9
+    expect(applicaCurva(v as never, 4)).toBeLessThan(20);
+  });
+
+  it('rispetta la soglia dell alcol come e scritta nel registro', () => {
+    const db = dbPronto();
+    const v = { ...voce(db, 'q_alcol_life'), params: JSON.parse(voce(db, 'q_alcol_life').params as string) };
+    expect(applicaCurva(v as never, 0)).toBe(100);
+    expect(applicaCurva(v as never, 7)).toBe(100);
+    expect(applicaCurva(v as never, 14)).toBe(0);
+  });
+
+  it('cambiare i parametri nel registro cambia il punteggio, senza toccare il codice', () => {
+    const db = dbPronto();
+    db.prepare(`UPDATE registro_test SET params = ? WHERE test_id = 'q_alcol_life'`)
+      .run(JSON.stringify({ best: 0, worst: 7 }));
+    const v = { ...voce(db, 'q_alcol_life'), params: JSON.parse(voce(db, 'q_alcol_life').params as string) };
+    expect(applicaCurva(v as never, 7)).toBe(0);   // con i parametri nuovi, 7 non vale piu 100
+  });
+
+  it('un test disattivato non entra nel calcolo', () => {
+    // NOTA: la versione originale di questo test disattivava 'q_ore_sonno' e si
+    // aspettava una differenza. Ma 'q_ore_sonno' e' uno delle SEI voci del
+    // sotto-dominio 'questionario_sonno' (peso 0.20 dentro "Recupero & Sistema
+    // Nervoso", che pesa in tutto 1.00: hrv 0.50 + pressione 0.15 + hrr 0.15 +
+    // questionario_sonno 0.20). Quell'asse resta 'insufficiente' con o senza
+    // 'q_ore_sonno' (0.20 < COPERTURA_MINIMA 0.4, e hrv/pressione/hrr non hanno
+    // ancora una voce nel registro): siccome un asse insufficiente non porta
+    // 'valore' nel tipo Punteggio, il JSON prima/dopo risultava IDENTICO — la
+    // suite lo ha confermato (verificato eseguendo il test: fallisce con le due
+    // stringhe uguali). Corretto qui usando 'q_attivita': NON e' l'unica voce
+    // del sotto-dominio 'questionario_lifestyle' (ne ha sei: q_attivita,
+    // q_alimentazione, q_sigarette, q_alcol_life, q_luce, q_schermi), ma in
+    // QUESTO fixture e' l'unica delle sei a cui si risponde. Disattivarla
+    // svuota davvero il sotto-dominio (nessun'altra voce lifestyle compilata a
+    // sostituirla), la copertura dell'asse "Stile di Vita & Sonno" (peso 1.00
+    // su quel solo sotto-dominio) cade da 1.00 a 0 e lo stato passa da 'ok' a
+    // 'insufficiente' — una differenza vera e osservabile. Se in futuro il
+    // fixture compilasse anche un'altra risposta lifestyle, questo test
+    // andrebbe aggiornato: la disattivazione non svuoterebbe piu' il
+    // sotto-dominio da sola.
+    const db = dbPronto();
+    salvaCompilazione(db, {
+      client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+      risposte: {
+        q_ore_sonno: 8, q_riposato: 8, q_min_addorm: 10, q_risvegli: 0, q_caffeina: 0, q_sonnolenza_diurna: 0,
+        q_attivita: 5,
+      },
+    });
+    const prima = calcolaSessione(db, 1);
+    expect(prima.assi['Stile di Vita & Sonno'].stato).toBe('ok');
+    db.prepare(`UPDATE registro_test SET attivo_a = '2026-01-01' WHERE test_id = 'q_attivita'`).run();
+    const dopo = calcolaSessione(db, 1);
+    expect(dopo.assi['Stile di Vita & Sonno'].stato).toBe('insufficiente');
+    expect(JSON.stringify(prima)).not.toBe(JSON.stringify(dopo));
+  });
+
+  it('una curva con i parametri mancanti nel registro non calcola un punteggio: restituisce null, mai 100', () => {
+    // Riproduce il difetto trovato in revisione: registro modificabile senza migrazioni,
+    // una riga con params vuoti o incompleti non deve mai dare il punteggio pieno.
+    const db = dbPronto();
+    // bell (q_ore_sonno): params svuotati del tutto.
+    const sonno = { ...voce(db, 'q_ore_sonno'), params: {} };
+    expect(applicaCurva(sonno as never, 3)).toBeNull(); // 3 ore di sonno: mai 100
+    // lin_dec (q_alcol_life): manca 'worst'.
+    const alcol = { ...voce(db, 'q_alcol_life'), params: { best: 7 } };
+    expect(applicaCurva(alcol as never, 40)).toBeNull(); // 40 unita/settimana: mai 100
+    // decstep (q_sigarette): steps mancanti.
+    const sigarette = { ...voce(db, 'q_sigarette'), params: {} };
+    expect(applicaCurva(sigarette as never, 40)).toBeNull(); // 40 sigarette/giorno: mai 100
+  });
+
+  it('una curva coi parametri completi continua a funzionare (il controllo non e troppo severo)', () => {
+    const db = dbPronto();
+    const v = { ...voce(db, 'q_ore_sonno'), params: JSON.parse(voce(db, 'q_ore_sonno').params as string) };
+    expect(applicaCurva(v as never, 8)).toBe(100);
+  });
+
+  it('due test dello stesso sotto-dominio danno la MEDIA dei punteggi, non la somma ne un singolo valore', () => {
+    // q_attivita e q_alimentazione condividono il sotto-dominio 'questionario_lifestyle',
+    // che pesa 1.00 (unico elemento) dentro l'asse "Stile di Vita & Sonno": il valore
+    // dell'asse coincide col valore del sotto-dominio, quindi la media si legge diretta.
+    const db = dbPronto();
+    salvaCompilazione(db, {
+      client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+      // q_attivita curva incstep, steps [[0,20],[2,50],[4,80],[999,100]]: valore 3 ->
+      // lerp fra (2,50) e (4,80) a meta' strada -> punteggio 65.
+      // q_alimentazione curva x10: valore 6 -> punteggio 60.
+      // media = (65+60)/2 = 62.5: diversa dalla somma (125) e da ciascun addendo (65, 60).
+      risposte: { q_attivita: 3, q_alimentazione: 6 },
+    });
+    const r = calcolaSessione(db, 1);
+    const asse = r.assi['Stile di Vita & Sonno'];
+    expect(asse.stato).toBe('ok');
+    if (asse.stato === 'ok') expect(asse.valore).toBe(62.5);
+  });
+});
+
+describe('calcolo e congelamento di una sessione', () => {
+  it('produce i sette assi, e quelli senza dati sono insufficienti', () => {
+    const db = dbPronto();
+    salvaCompilazione(db, {
+      client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+      risposte: { q_ore_sonno: 8, q_riposato: 8, q_min_addorm: 10, q_risvegli: 0, q_caffeina: 0, q_sonnolenza_diurna: 1 },
+    });
+    const r = calcolaSessione(db, 1);
+    expect(Object.keys(r.assi).length).toBe(7);
+    // il questionario copre il sonno, che pesa 0.20 dentro Recupero: sotto il 40%
+    expect(r.assi['Recupero & Sistema Nervoso'].stato).toBe('insufficiente');
+    // Stile di Vita e coperto al 100% dal solo questionario, ma qui non abbiamo risposto
+    expect(r.assi['Forza & Struttura'].stato).toBe('insufficiente');
+  });
+
+  it('congela i punteggi con le DUE versioni', () => {
+    const db = dbPronto();
+    salvaCompilazione(db, {
+      client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+      risposte: { q_riposato: 7 },
+    });
+    salvaScore(db, 1, calcolaSessione(db, 1));
+    const righe = db.prepare(`SELECT tipo, elemento, valore, stato, quest_version, model_version FROM score`).all() as Record<string, unknown>[];
+    expect(righe.length).toBeGreaterThan(0);
+    for (const r of righe) {
+      expect(r.model_version).toBe(MODEL_VERSION);
+      expect(r.quest_version).toBe('v1.0');
+      if (r.stato === 'insufficiente') expect(r.valore).toBeNull();
+    }
+  });
+
+  it('i pesi arrivano dal registro e sono quelli della versione richiesta', () => {
+    const db = dbPronto();
+    const pesi = pesiDi(db, MODEL_VERSION, 'asse', 'Forza & Struttura');
+    expect(pesi.handgrip).toBe(0.25);
+    expect(Object.values(pesi).reduce((a, b) => a + b, 0)).toBeCloseTo(1, 6);
+  });
+
+  it('senza eta la Fitness Age e null, non un numero negativo dichiarato valido', () => {
+    // Bug trovato in revisione: eta_alla_data e' nullable nello schema (l'apertura di
+    // una sessione e il salvataggio di un questionario accettano l'eta opzionale), ma
+    // il motore la leggeva con un ripiego a zero. Qui costruiamo un composito Fitness
+    // Age davvero 'ok' (copertura esattamente 0.40: cardio 0.30 + composizione 0.10),
+    // cosi' il difetto e' osservabile: col ripiego a zero l'eta anagrafica diventa 0
+    // e la formula "eta - (composito - 50) * 0.4" esce negativa ma con stato 'ok'.
+    // Due voci fisiche aggiunte al registro qui (arriveranno davvero col piano degli
+    // import): servono solo a rendere il composito calcolabile senza aspettarle.
+    const db = dbPronto();
+    db.prepare(
+      `INSERT INTO registro_test (test_id, etichetta, tipo_valore, curva, params, asse, sotto_dominio, attivo_da)
+       VALUES ('wt_vo2max', 'VO2max stimato', 'num', 'lin_dec', ?, 'Cardio-Respiratorio', 'vo2max', '2026-01-01')`
+    ).run(JSON.stringify({ best: 40, worst: 20 }));
+    db.prepare(
+      `INSERT INTO registro_test (test_id, etichetta, tipo_valore, curva, params, asse, sotto_dominio, attivo_da)
+       VALUES ('wt_grasso', 'Grasso % (Wellness Tower)', 'num', 'lin_dec', ?, 'Composizione Corporea', 'grasso', '2026-01-01')`
+    ).run(JSON.stringify({ best: 10, worst: 40 }));
+
+    const s = apriSessione(db, { client_code: 'ISL-0001', data: '2026-08-22', tipo: 'checkup' }); // nessuna eta
+    registraMisure(db, s, 'wellness_tower', [
+      { test_id: 'wt_vo2max', valore_num: 40 }, // curva a 100
+      { test_id: 'wt_grasso', valore_num: 10 }, // curva a 100
+    ]);
+
+    const r = calcolaSessione(db, s);
+    expect(r.assi['Cardio-Respiratorio'].stato).toBe('ok');
+    expect(r.assi['Composizione Corporea'].stato).toBe('ok');
+    expect(r.fitnessAgeCopertura).toBe(0.4);   // composito 'ok': la soglia e' inclusiva
+    expect(r.fitnessAge).toBeNull();           // ma senza eta anagrafica, la Fitness Age non esiste
+  });
+
+  it('una misura fuori range non entra nello score (§9 della spec)', () => {
+    // Caso letterale della spec: una risposta 0-10 di 999 e' fuori dal fondoscala
+    // dichiarato (come la capacita' vitale di 5148 mL su un fondoscala 2000-3000),
+    // si scrive e si marca, ma non deve produrre un punteggio.
+    // q_alimentazione e' l'UNICA voce del sotto-dominio 'questionario_lifestyle'
+    // (peso 1.00, unico elemento dell'asse "Stile di Vita & Sonno"): se la misura
+    // fuori range entrasse nel calcolo l'asse risulterebbe 'ok' con valore 100
+    // (curvaDirettaX10(999) clampato); esclusa, il sotto-dominio resta scoperto e
+    // l'asse e' 'insufficiente'. E' la differenza osservabile che prova il filtro.
+    const db = dbPronto();
+    const s = apriSessione(db, { client_code: 'ISL-0001', data: '2026-08-22', tipo: 'questionario', eta_alla_data: 35 });
+    const esito = registraMisure(db, s, 'questionario', [{ test_id: 'q_alimentazione', valore_num: 999 }]);
+    expect(esito.fuoriRange).toEqual(['q_alimentazione']);
+
+    const r = calcolaSessione(db, s);
+    expect(r.assi['Stile di Vita & Sonno'].stato).toBe('insufficiente');
+
+    const riga = db.prepare(`SELECT fuori_range FROM misure WHERE test_id = 'q_alimentazione'`).get() as { fuori_range: number };
+    expect(riga.fuori_range).toBe(1);
+  });
+
+  it('scrive nella tabella score un valore vero e la copertura vera, non solo lo stato', () => {
+    // Sabotaggi che questo test deve intercettare: tutti i valori scritti a null, o
+    // tutte le coperture forzate a 1. Serve un caso con copertura NON piena (0.5, non
+    // 1.0) perche' un "sempre 1" non si distinguerebbe da un caso gia' pieno.
+    const db = dbPronto();
+    salvaCompilazione(db, {
+      client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+      // q_energia_media (x10) e' l'unica voce misurata del sotto-dominio
+      // 'questionario_energia_stress' (peso 0.50 nell'asse, l'altro 0.50 e' hrv,
+      // non ancora nel registro): copertura 0.50, non 1.
+      risposte: { q_energia_media: 8 },
+    });
+    const risultato = calcolaSessione(db, 1);
+    salvaScore(db, 1, risultato);
+    const riga = db.prepare(
+      `SELECT valore, copertura, stato FROM score WHERE tipo = 'asse' AND elemento = ?`
+    ).get('Energia & Regolazione Stress') as { valore: number; copertura: number; stato: string };
+    expect(riga.stato).toBe('ok');
+    expect(riga.valore).toBe(80);       // curvaDirettaX10(8) = 80, unico contributo
+    expect(riga.copertura).toBe(0.5);   // 0.50 di peso disponibile su 1.00
+  });
+});
+
+describe('leggiScore legge dalla tabella, tipato come Punteggio', () => {
+  it('restituisce assi/macro/fitness_age come Punteggio: nessun valore leggibile da un insufficiente', () => {
+    const db = dbPronto();
+    salvaCompilazione(db, {
+      client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+      risposte: { q_attivita: 3, q_alimentazione: 6 },
+    });
+    const risultato = calcolaSessione(db, 1);
+    salvaScore(db, 1, risultato);
+    const letto = leggiScore(db, 1);
+    expect(letto.assi['Stile di Vita & Sonno'].stato).toBe('ok');
+    if (letto.assi['Stile di Vita & Sonno'].stato === 'ok') {
+      expect(letto.assi['Stile di Vita & Sonno'].valore).toBe(62.5);
+    }
+    expect(letto.assi['Forza & Struttura'].stato).toBe('insufficiente');
+    expect((letto.assi['Forza & Struttura'] as { valore?: number }).valore).toBeUndefined();
+  });
+
+  it('due calcoli sulla stessa sessione non si sovrascrivono: leggiScore prende l ultimo', () => {
+    // Decisione presa: salvaScore non ha vincolo di unicita', la storia si tiene.
+    // leggiScore deve dichiarare esplicitamente nella query il criterio dell'ultimo
+    // calcolo (non l'ordine naturale delle righe).
+    const db = dbPronto();
+    salvaCompilazione(db, {
+      client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+      risposte: { q_attivita: 3, q_alimentazione: 6 },   // -> 62.5
+    });
+    salvaScore(db, 1, calcolaSessione(db, 1));
+
+    // Aggiunge una risposta lifestyle: cambia la media del sotto-dominio, ricalcola
+    // e salva una SECONDA volta sulla stessa sessione.
+    registraMisure(db, 1, 'questionario', [{ test_id: 'q_sigarette', valore_num: 0 }]); // curva decstep, v=0 -> 100
+    salvaScore(db, 1, calcolaSessione(db, 1));
+
+    const righe = db.prepare(
+      `SELECT COUNT(*) n FROM score WHERE sessione_id = 1 AND tipo = 'asse' AND elemento = 'Stile di Vita & Sonno'`
+    ).get() as { n: number };
+    expect(righe.n).toBe(2); // la storia si tiene: due righe, non una sovrascritta
+
+    const letto = leggiScore(db, 1);
+    const asse = letto.assi['Stile di Vita & Sonno'];
+    expect(asse.stato).toBe('ok');
+    // media di tre voci ora (65+60+100)/3 = 75, non piu' 62.5 del primo calcolo
+    if (asse.stato === 'ok') expect(asse.valore).toBe(75);
+  });
+});
+
+describe('i pesi sono legati alla versione del modello, non fusi insieme', () => {
+  it('togliendo il filtro sulla versione dalla lettura dei pesi, due versioni diverse darebbero lo stesso punteggio: qui devono differire', () => {
+    const db = createLongevityDb(':memory:');
+    seedPesi(db, 'v1.0');
+    // Seconda versione del modello, con pesi DIVERSI per lo stesso asse.
+    const ins = db.prepare(
+      `INSERT INTO pesi (model_version, livello, contenitore, elemento, peso) VALUES (?, 'asse', 'Forza & Struttura', ?, ?)`
+    );
+    ins.run('v2.0', 'handgrip', 0.9);
+    ins.run('v2.0', 'core', 0.1);
+
+    const punteggi = { handgrip: 100, spinta: 0, trazione: 0, arti_inferiori: 0, core: 0 };
+    const v1 = calcolaAsse(pesiDi(db, 'v1.0', 'asse', 'Forza & Struttura'), punteggi);
+    const v2 = calcolaAsse(pesiDi(db, 'v2.0', 'asse', 'Forza & Struttura'), punteggi);
+    expect(v1.stato).toBe('ok');
+    expect(v2.stato).toBe('ok');
+    if (v1.stato === 'ok' && v2.stato === 'ok') {
+      expect(v1.valore).toBe(25);   // 100*0.25 (v1.0)
+      expect(v2.valore).toBe(90);   // 100*0.9  (v2.0)
+      expect(v1.valore).not.toBe(v2.valore);
+    }
+  });
+});

tests/longevity/pagine.test.ts

@@ -0,0 +1,96 @@
+// tests/longevity/pagine.test.ts
+import { describe, it, expect } from 'vitest';
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+
+const leggi = (p: string) => readFileSync(join(process.cwd(), p), 'utf8');
+
+describe('il guscio della piattaforma', () => {
+  it('il layout esiste e non monta header e footer pubblici', () => {
+    const l = leggi('src/layouts/Longevity.astro');
+    expect(l).not.toMatch(/import\s+Header/);
+    expect(l).not.toMatch(/import\s+Footer/);
+    expect(l).toMatch(/noindex/);          // area riservata: mai indicizzata
+  });
+
+  it('il foglio di stile e globale e prefissato, non scoped', () => {
+    expect(existsSync(join(process.cwd(), 'src/styles/longevity.css'))).toBe(true);
+    const css = leggi('src/styles/longevity.css');
+    const classi = [...css.matchAll(/^\.([a-z-]+)/gm)].map((m) => m[1]);
+    expect(classi.length).toBeGreaterThan(3);
+    // "lg" da solo o "lg-qualcosa": il solo startsWith('lg') lascerebbe passare anche "lgfoo".
+    expect(classi.every((c) => c === 'lg' || c.startsWith('lg-'))).toBe(true);
+  });
+
+  it('usa i token del sito invece di inventare colori', () => {
+    const css = leggi('src/styles/longevity.css');
+    expect(css).toMatch(/var\(--c-/);
+  });
+
+  it('nessuna variabile porta un nome da semaforo (verde/buono/ok)', () => {
+    const css = leggi('src/styles/longevity.css').toLowerCase();
+    // il mattone del fuori range e ammesso; un verde "tutto bene" no
+    expect(css).not.toMatch(/--lg-ok|--lg-buono|--lg-verde/);
+  });
+
+  it('in tutto il foglio compaiono solo i colori ammessi, salvo le eccezioni dichiarate', () => {
+    // Il test sopra cerca nomi vietati: chi scrivesse un verde in esadecimale, o lo
+    // chiamasse con un nome innocuo (var(--lg-buona-salute)), passerebbe indisturbato.
+    // Qui si fa il contrario: si elenca ciò che PUÒ comparire, e qualunque altro colore —
+    // letterale (esadecimale, rgb(), nome CSS) o var() con un altro nome — è una
+    // regressione.
+    //
+    // PRIMA questo test filtrava le regole sul selettore ("solo quelle con 'lg-score' nel
+    // nome"): un elenco di QUALI regole guardare invecchia appena nasce una classe nuova —
+    // è successo con .lg-radar__voce-nome, .lg-radar__intro, .lg-macro__nota (Task 3): non
+    // contengono la stringa "lg-score", quindi non venivano MAI controllate, in silenzio.
+    // Il foglio è interamente prefissato `lg-` per costruzione (verificato dal test sopra):
+    // non serve scegliere quali regole guardare, si guardano TUTTE, e le eccezioni
+    // legittime si dichiarano una per una — selettore, valore esatto, motivo — così un
+    // colore fuori lista entra solo con una decisione visibile, mai con un buco nel filtro.
+    const css = leggi('src/styles/longevity.css');
+    const AMMESSI = new Set([
+      '--c-accent', '--c-accent-dark',              // l'accento del sito: l'unica leva per l'intensità
+      '--c-heading', '--c-text', '--c-text-light',  // testo neutro, uguale ovunque nel sito
+      '--c-bg', '--c-bg-alt',                       // sfondi neutri
+      '--lg-line', '--lg-surface',                  // struttura locale, neutra
+      '--lg-tratteggio',                            // il perimetro di ciò che non sappiamo
+      '--lg-fuori-range',                            // SOLO una misura sospetta, mai un punteggio
+    ]);
+    // Eccezioni dichiarate: selettore esatto + valore esatto + perché non è un giudizio sul
+    // punteggio. Ogni riga qui è una decisione presa a vista, non un buco silenzioso.
+    const ECCEZIONI: { selettore: string; valore: string; motivo: string }[] = [
+      {
+        selettore: '.lg-form__nav button:last-child:not(:only-child)',
+        valore: '#fff',
+        motivo: "testo bianco per contrasto sul bottone pieno d'accento — non un colore di punteggio",
+      },
+    ];
+    const NON_COLORE = /^(transparent|inherit|initial|unset|currentcolor|none)$/i;
+    const PROP_COLORE = /^(color|background|background-color|border(-\w+)?-color|outline-color|fill|stroke)$/i;
+
+    const violazioni: string[] = [];
+    for (const regola of css.matchAll(/([^{}]+)\{([^{}]*)\}/g)) {
+      const selettore = regola[1].trim();
+      for (const dich of regola[2].split(';')) {
+        const due = dich.indexOf(':');
+        if (due < 0) continue;
+        const prop = dich.slice(0, due).trim().toLowerCase();
+        const val = dich.slice(due + 1).trim();
+        if (!PROP_COLORE.test(prop) || val === '' || NON_COLORE.test(val)) continue;
+        const varMatch = val.match(/^var\(\s*(--[a-z0-9-]+)\s*(?:,.*)?\)$/i);
+        if (varMatch && AMMESSI.has(varMatch[1])) continue;
+        if (ECCEZIONI.some((e) => e.selettore === selettore && e.valore === val)) continue;
+        violazioni.push(`${selettore} { ${prop}: ${val} }`);
+      }
+    }
+    expect(violazioni).toEqual([]);
+  });
+
+  it('la rotta del cliente e sotto /longevity, e rimanda davvero al referto', () => {
+    const p = join(process.cwd(), 'src/pages/longevity/index.astro');
+    expect(existsSync(p)).toBe(true);
+    const src = readFileSync(p, 'utf8');
+    expect(src).toMatch(/Astro\.redirect\(\s*['"`]\/longevity\/io['"`]/);
+  });
+});

tests/longevity/prima-apertura.test.ts

@@ -0,0 +1,66 @@
+// La prima apertura del referto (revisione del 22/08): con i dati di oggi il cliente vede
+// molti assi tratteggiati. È corretto, ma la pagina deve SPIEGARLO, non lasciarlo sembrare
+// un guasto. Questi controlli leggono il sorgente delle pagine/componenti — come già fa
+// referto.test.ts per "nessuna pagina interroga il database da sola" — perché non c'è un
+// harness di rendering per Astro/React in questo repo (nessuna dipendenza nuova ammessa).
+import { describe, it, expect } from 'vitest';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+const leggi = (p: string) => readFileSync(join(process.cwd(), p), 'utf8');
+
+describe('la Fitness Age, quando manca, spiega perché (come le altre carte)', () => {
+  it('io.astro mostra una nota di copertura anche per la Fitness Age, non solo un trattino nudo', () => {
+    const src = leggi('src/pages/longevity/io.astro');
+    // Deve leggere la copertura dedicata (vista.ts, fitnessAgeCopertura), non inventarsi
+    // un numero: la sola presenza del trattino '—' non basta più.
+    expect(src).toMatch(/fitnessAgeCopertura/);
+    expect(src).toMatch(/Copertura dati/);
+  });
+
+  it('il numero della Fitness Age, quando c\'è, è formattato all\'italiana', () => {
+    const src = leggi('src/pages/longevity/io.astro');
+    expect(src).toMatch(/formattaNumero\(referto\.fitnessAge\)/);
+  });
+});
+
+describe('il radar spiega prima di mostrare', () => {
+  it('la spiegazione del radar precede il grafico, non lo segue', () => {
+    const src = leggi('src/components/longevity/Radar.tsx');
+    const idxIntro = src.indexOf("L'area piena");
+    const idxGrafico = src.indexOf('<ResponsiveContainer');
+    expect(idxIntro).toBeGreaterThan(-1);
+    expect(idxGrafico).toBeGreaterThan(-1);
+    expect(idxIntro).toBeLessThan(idxGrafico);
+  });
+
+  it("l'elenco di ciò che manca invita a fare qualcosa, non solo a leggere nomi di test", () => {
+    const src = leggi('src/components/longevity/Radar.tsx');
+    expect(src).toMatch(/trainer/i);
+  });
+});
+
+describe('la copertura si mostra sempre, non solo quando il numero manca', () => {
+  it('MacroScore.astro non nasconde più la copertura quando il punteggio c\'è', () => {
+    const src = leggi('src/components/longevity/MacroScore.astro');
+    // PRIMA: `{valore === null && (<p ...>Copertura dati...`. La nota deve poter comparire
+    // anche quando valore !== null: la vecchia guardia esatta non deve più esserci.
+    expect(src).not.toMatch(/\{valore === null && \(\s*<p class="lg-muted lg-macro__nota">/);
+    expect(src).toMatch(/Copertura dati/);
+  });
+
+  it('il punteggio di MacroScore è formattato all\'italiana', () => {
+    const src = leggi('src/components/longevity/MacroScore.astro');
+    expect(src).toMatch(/formattaNumero\(valore\)/);
+  });
+});
+
+describe('chi ha già compilato può ricompilare (monitoraggio nel tempo)', () => {
+  it('io.astro offre il collegamento al questionario anche quando il referto esiste già', () => {
+    const src = leggi('src/pages/longevity/io.astro');
+    const idxReferto = src.indexOf('{referto && (');
+    expect(idxReferto).toBeGreaterThan(-1);
+    const blocco = src.slice(idxReferto);
+    expect(blocco).toMatch(/href=["'`]\/longevity\/questionario["'`]/);
+  });
+});

tests/longevity/questionario-pagina.test.ts

@@ -0,0 +1,182 @@
+import { describe, it, expect } from 'vitest';
+import { readFileSync, mkdtempSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { createLongevityDb, createIdentityDb } from '../../src/lib/longevity/db';
+import { seedRegistro } from '../../src/lib/longevity/registro';
+import { campiDelQuestionario, salvaDalForm } from '../../src/lib/longevity/vista';
+import { creaCliente } from '../../src/lib/longevity/anagrafica';
+import { CONSENT_VERSION, QUEST_VERSION } from '../../src/lib/longevity/questionario';
+
+function dbPronto() {
+  const db = createLongevityDb(':memory:');
+  seedRegistro(db);
+  db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0001','F')`).run();
+  return db;
+}
+
+describe('i campi del questionario vengono dal registro', () => {
+  it('costruisce i campi leggendo il registro, non una lista nel codice', () => {
+    const db = dbPronto();
+    const campi = campiDelQuestionario(db, '2026-08-22');
+    expect(campi.length).toBe(20);
+    const alcol = campi.find((c) => c.id === 'q_alcol_life')!;
+    expect(alcol.etichetta).toMatch(/alcoliche/i);
+    expect(alcol.max).toBe(30);
+  });
+
+  it('una domanda disattivata sparisce dal modulo senza toccare il codice', () => {
+    const db = dbPronto();
+    db.prepare(`UPDATE registro_test SET attivo_a = '2026-01-01' WHERE test_id = 'q_sigarette'`).run();
+    const campi = campiDelQuestionario(db, '2026-08-22');
+    expect(campi.map((c) => c.id)).not.toContain('q_sigarette');
+    expect(campi.length).toBe(19);
+  });
+});
+
+describe('il salvataggio, e il consenso', () => {
+  const risposte = { q_riposato: 8, q_ore_sonno: 7.5 };
+
+  it('salva una compilazione quando il consenso e dato', () => {
+    const db = dbPronto();
+    const esito = salvaDalForm(db, {
+      client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+      risposte, consensoSanitario: 'Si', liberi: {},
+    });
+    expect(esito.ok).toBe(true);
+    const n = db.prepare(`SELECT COUNT(*) n FROM sessioni`).get() as { n: number };
+    expect(n.n).toBe(1);
+  });
+
+  it('NON salva se il consenso e rifiutato: "No" non e un consenso', () => {
+    const db = dbPronto();
+    const esito = salvaDalForm(db, {
+      client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+      risposte, consensoSanitario: 'No', liberi: {},
+    });
+    expect(esito.ok).toBe(false);
+    const n = db.prepare(`SELECT COUNT(*) n FROM sessioni`).get() as { n: number };
+    expect(n.n).toBe(0);   // niente sessione, niente misure
+  });
+
+  it('NON salva se il consenso manca del tutto', () => {
+    const db = dbPronto();
+    const esito = salvaDalForm(db, {
+      client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+      risposte, consensoSanitario: '', liberi: {},
+    });
+    expect(esito.ok).toBe(false);
+  });
+
+  it('registra il consenso anche quando e rifiutato: il rifiuto va dimostrato', () => {
+    const db = dbPronto();
+    salvaDalForm(db, {
+      client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+      risposte, consensoSanitario: 'No', liberi: {},
+    });
+    const note = db.prepare(
+      `SELECT campo_id, testo FROM profilo_note WHERE campo_id LIKE 'consenso%'`
+    ).all() as { campo_id: string; testo: string }[];
+    expect(note.length).toBeGreaterThan(0);
+    expect(note[0].testo).toMatch(/No/);
+  });
+
+  // PRIMA di questa correzione il ramo del consenso DATO non era coperto da nessun test:
+  // cancellando la riga che registra il consenso accettato (registraConsenso dentro il ramo
+  // affermativo di salvaDalForm) la suite restava tutta verde — provato. Il consenso dato è
+  // l'unico documento che un domani si esibisce a chi chiede conto del trattamento, tanto
+  // quanto il rifiuto (già coperto sopra).
+  it('registra il consenso anche quando e dato: e il documento che un domani va esibito', () => {
+    const db = dbPronto();
+    const esito = salvaDalForm(db, {
+      client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+      risposte, consensoSanitario: 'Si', liberi: {},
+    });
+    expect(esito.ok).toBe(true);
+    const note = db.prepare(
+      `SELECT campo_id, testo, sessione_id FROM profilo_note WHERE campo_id = 'consenso_sanitario'`
+    ).all() as { campo_id: string; testo: string; sessione_id: number | null }[];
+    expect(note.length).toBe(1);
+    expect(note[0].testo).toMatch(/Si/);
+    if (esito.ok) expect(note[0].sessione_id).toBe(esito.sessioneId);
+  });
+
+  // Il record del consenso portava la versione delle DOMANDE (QUEST_VERSION): se cambia il
+  // testo del consenso senza che cambi una domanda, il record non lo diceva. Ora porta una
+  // versione propria (CONSENT_VERSION, questionario.ts), dichiarata accanto a QUEST_VERSION.
+  it('il record del consenso porta CONSENT_VERSION, non QUEST_VERSION', () => {
+    const db = dbPronto();
+    salvaDalForm(db, {
+      client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+      risposte, consensoSanitario: 'Si', liberi: {},
+    });
+    const nota = db.prepare(
+      `SELECT testo FROM profilo_note WHERE campo_id = 'consenso_sanitario'`
+    ).get() as { testo: string };
+    expect(nota.testo).toContain(`consenso ${CONSENT_VERSION}`);
+    expect(nota.testo).not.toMatch(/questionario\s+v/i);
+    // Le due costanti oggi coincidono di valore ('v1.0'): la prova che conta è che sono
+    // DUE COSTANTI DISTINTE (non lo stesso import rietichettato) — non che i valori
+    // divergano oggi.
+    expect(CONSENT_VERSION).not.toBe(undefined);
+    expect(QUEST_VERSION).not.toBe(undefined);
+  });
+
+  it('il codice cliente si risolve dalla sessione (codicePerUtenteLoggato)', () => {
+    const src = readFileSync(join(process.cwd(), 'src/pages/api/longevity/questionario.ts'), 'utf8');
+    expect(src).toMatch(/codicePerUtente/);
+  });
+
+  // PRIMA questo test cercava, nel sorgente, le stringhe letterali "body.client_code" e
+  // "corpo.client_code" — ma il file chiama la variabile del corpo `data`, non `body` né
+  // `corpo`: la lista di divieti non nominava nessuna variabile che il file usasse
+  // davvero, quindi era vacua per costruzione. Provato: aggiungendo all'endpoint
+  // `if (typeof data.client_code === 'string') codice = data.client_code;` (la vulnerabilità
+  // vera — un cliente scrive nel fascicolo di un altro) la suite restava tutta verde.
+  //
+  // Il fix e' strutturale (il tipo del corpo, in questionario.ts, non ha il campo
+  // client_code — chi lo leggesse da li' non passerebbe tsc --noEmit) e questo e' il test
+  // di comportamento che lo dimostra end-to-end: chiama l'endpoint VERO con un client_code
+  // estraneo nel corpo e verifica dove la sessione finisce scritta.
+  it('un client_code nel corpo della richiesta viene ignorato: la sessione finisce sul cliente vero, mai su quello iniettato', async () => {
+    const dir = mkdtempSync(join(tmpdir(), 'lg-api-test-'));
+    const idPath = join(dir, 'identity.db');
+    const lgPath = join(dir, 'longevity.db');
+    const primaId = process.env.IDENTITY_DB_PATH;
+    const primaLg = process.env.LONGEVITY_DB_PATH;
+    try {
+      process.env.IDENTITY_DB_PATH = idPath;
+      process.env.LONGEVITY_DB_PATH = lgPath;
+
+      // Setup con connessioni proprie, sullo stesso file che il singleton dell'endpoint
+      // aprirà (le due variabili d'ambiente sopra), come in anagrafica.test.ts.
+      const id = createIdentityDb(idPath);
+      const lg = createLongevityDb(lgPath);
+      seedRegistro(lg);
+      const codiceVero = creaCliente(id, lg, { nome: 'Vera', cognome: 'Utente', sesso: 'F', user_id: 1 });
+      const codiceAltro = creaCliente(id, lg, { nome: 'Altro', cognome: 'Cliente', sesso: 'M', user_id: 2 });
+
+      const { POST } = await import('../../src/pages/api/longevity/questionario');
+      const richiesta = new Request('http://localhost/api/longevity/questionario', {
+        method: 'POST',
+        body: JSON.stringify({
+          client_code: codiceAltro, // tentativo: scrivere nel fascicolo di un altro cliente
+          risposte: { q_riposato: 8 },
+          consensoSanitario: 'Si',
+        }),
+      });
+      const res = await POST({ request: richiesta, locals: { user: { id: 1 } } } as any);
+      expect(res.status).toBe(201);
+      const corpo = await res.json();
+
+      const riga = lg.prepare(`SELECT client_code FROM sessioni WHERE id = ?`).get(corpo.sessioneId) as
+        { client_code: string };
+      expect(riga.client_code).toBe(codiceVero);
+      expect(riga.client_code).not.toBe(codiceAltro);
+    } finally {
+      if (primaId === undefined) delete process.env.IDENTITY_DB_PATH; else process.env.IDENTITY_DB_PATH = primaId;
+      if (primaLg === undefined) delete process.env.LONGEVITY_DB_PATH; else process.env.LONGEVITY_DB_PATH = primaLg;
+      rmSync(dir, { recursive: true, force: true });
+    }
+  });
+});

tests/longevity/questionario.test.ts

@@ -0,0 +1,90 @@
+import { describe, it, expect } from 'vitest';
+import { createLongevityDb } from '../../src/lib/longevity/db';
+import { seedRegistro } from '../../src/lib/longevity/registro';
+import { salvaCompilazione, QUEST_VERSION } from '../../src/lib/longevity/questionario';
+
+function dbPronto() {
+  const db = createLongevityDb(':memory:');
+  seedRegistro(db);
+  db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0001', 'F')`).run();
+  return db;
+}
+
+describe('compilazione del questionario', () => {
+  it('salva le risposte punteggiate come misure', () => {
+    const db = dbPronto();
+    const s = salvaCompilazione(db, {
+      client_code: 'ISL-0001', data: '2026-08-21',
+      risposte: { q_ore_sonno: 7.5, q_riposato: 8, q_alcol_life: 3 },
+    });
+    const n = db.prepare(`SELECT COUNT(*) n FROM misure WHERE sessione_id = ? AND fonte = 'questionario'`)
+      .get(s) as { n: number };
+    expect(n.n).toBe(3);
+  });
+
+  it('marchia la compilazione con la versione del questionario', () => {
+    const db = dbPronto();
+    const s = salvaCompilazione(db, { client_code: 'ISL-0001', data: '2026-08-21', risposte: { q_riposato: 6 } });
+    const row = db.prepare(`SELECT tipo, quest_version FROM sessioni WHERE id = ?`).get(s) as
+      { tipo: string; quest_version: string };
+    expect(row.tipo).toBe('questionario');
+    expect(row.quest_version).toBe(QUEST_VERSION);
+  });
+
+  it('i campi liberi vanno in profilo_note, non fra le misure', () => {
+    const db = dbPronto();
+    const s = salvaCompilazione(db, {
+      client_code: 'ISL-0001', data: '2026-08-21',
+      risposte: { q_riposato: 6 },
+      liberi: { farmaci: 'nessuno', obiettivi: 'dormire meglio' },
+    });
+    const note = db.prepare(`SELECT campo_id, testo FROM profilo_note WHERE sessione_id = ? ORDER BY campo_id`)
+      .all(s) as { campo_id: string; testo: string }[];
+    expect(note.map((n) => n.campo_id)).toEqual(['farmaci', 'obiettivi']);
+    const misure = db.prepare(`SELECT test_id FROM misure WHERE sessione_id = ?`).all(s) as { test_id: string }[];
+    expect(misure.map((m) => m.test_id)).toEqual(['q_riposato']);
+  });
+
+  it('ogni compilazione e un record nuovo, non un aggiornamento', () => {
+    const db = dbPronto();
+    salvaCompilazione(db, { client_code: 'ISL-0001', data: '2026-08-21', risposte: { q_riposato: 6 } });
+    salvaCompilazione(db, { client_code: 'ISL-0001', data: '2026-09-21', risposte: { q_riposato: 9 } });
+    const n = db.prepare(`SELECT COUNT(*) n FROM sessioni WHERE tipo = 'questionario'`).get() as { n: number };
+    expect(n.n).toBe(2);
+  });
+
+  it('una risposta con id sconosciuto fa fallire la compilazione intera', () => {
+    const db = dbPronto();
+    expect(() =>
+      salvaCompilazione(db, {
+        client_code: 'ISL-0001', data: '2026-08-21',
+        risposte: { q_riposato: 6, q_domanda_nuova: 3 },
+      })
+    ).toThrow(/q_domanda_nuova/);
+    const n = db.prepare(`SELECT COUNT(*) n FROM sessioni`).get() as { n: number };
+    expect(n.n).toBe(0);
+  });
+
+  it('fallimento a metà non lascia traccia: sessione, misure e note sono atomiche', () => {
+    const db = dbPronto();
+    // Passa due campi liberi: il primo valido (farmaci), il secondo con null (obiettivi).
+    // Il primo insert su profilo_note avviene (per farmaci: 'nessuno'), poi fallisce su
+    // obiettivi quando tenta di eseguire testo.trim() su un null, lanciando un TypeError.
+    // Il rollback della transazione deve annullare anche il primo insert già avvenuto.
+    expect(() =>
+      salvaCompilazione(db, {
+        client_code: 'ISL-0001', data: '2026-08-21',
+        risposte: { q_riposato: 6 },
+        liberi: { farmaci: 'nessuno', obiettivi: null as any }, // null causa TypeError su .trim()
+      })
+    ).toThrow();
+    // Verifica che la transazione sia stata rollback: niente sessione, niente misure, niente note.
+    // Se il rollback non funzionasse, almeno il record di farmaci resterebbe in profilo_note.
+    const sessioni = db.prepare(`SELECT COUNT(*) n FROM sessioni`).get() as { n: number };
+    const misure = db.prepare(`SELECT COUNT(*) n FROM misure`).get() as { n: number };
+    const note = db.prepare(`SELECT COUNT(*) n FROM profilo_note`).get() as { n: number };
+    expect(sessioni.n).toBe(0);
+    expect(misure.n).toBe(0);
+    expect(note.n).toBe(0);
+  });
+});

tests/longevity/referto.test.ts

@@ -0,0 +1,124 @@
+// tests/longevity/referto.test.ts
+import { describe, it, expect } from 'vitest';
+import { readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { createLongevityDb } from '../../src/lib/longevity/db';
+import { seedRegistro, seedPesi, MODEL_VERSION } from '../../src/lib/longevity/registro';
+import { salvaCompilazione } from '../../src/lib/longevity/questionario';
+import { calcolaSessione, salvaScore } from '../../src/lib/longevity/motore';
+import { refertoDi } from '../../src/lib/longevity/vista';
+
+function conCompilazione() {
+  const db = createLongevityDb(':memory:');
+  seedRegistro(db); seedPesi(db, MODEL_VERSION);
+  db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0001','F')`).run();
+  const s = salvaCompilazione(db, {
+    client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+    risposte: { q_attivita: 5, q_alimentazione: 8, q_sigarette: 0, q_alcol_life: 2, q_luce: 2, q_schermi: 10 },
+  });
+  salvaScore(db, s, calcolaSessione(db, s));
+  return { db, s };
+}
+
+/**
+ * Come conCompilazione, con IN PIU' una risposta di questionario_sonno (q_riposato).
+ * Serve solo alla prova sul congelamento, che ha bisogno di un asse con PIU' sotto-domini
+ * pesati e copertura parziale non nulla — vedi il commento sopra la mutazione qui sotto per
+ * il perche' conCompilazione da sola non basta.
+ */
+function conCoperturaParziale() {
+  const db = createLongevityDb(':memory:');
+  seedRegistro(db); seedPesi(db, MODEL_VERSION);
+  db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0001','F')`).run();
+  const s = salvaCompilazione(db, {
+    client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+    risposte: {
+      q_attivita: 5, q_alimentazione: 8, q_sigarette: 0, q_alcol_life: 2, q_luce: 2, q_schermi: 10,
+      q_riposato: 8,
+    },
+  });
+  salvaScore(db, s, calcolaSessione(db, s));
+  return { db, s };
+}
+
+describe('il referto del cliente', () => {
+  it('restituisce i sette assi', () => {
+    const { db, s } = conCompilazione();
+    expect(refertoDi(db, s).assi.length).toBe(7);
+  });
+
+  it('un asse senza dati NON porta un numero', () => {
+    const { db, s } = conCompilazione();
+    const forza = refertoDi(db, s).assi.find((a) => a.nome === 'Forza & Struttura')!;
+    expect(forza.valore).toBeNull();
+  });
+
+  it('e dice cosa manca per completarlo, invece di lasciare un buco', () => {
+    const { db, s } = conCompilazione();
+    const forza = refertoDi(db, s).assi.find((a) => a.nome === 'Forza & Struttura')!;
+    expect(forza.mancano.length).toBeGreaterThan(0);
+  });
+
+  it('espone la copertura della Fitness Age anche quando è insufficiente (serve alla nota in pagina)', () => {
+    // conCompilazione() non porta nessuna misura del composito Fitness Age (cardio,
+    // handgrip, hrv, forza_resto, composizione, stabilita: nessuno di questi sotto-domini
+    // ha dati in questa sessione, solo il questionario), quindi fitnessAge è null — ma
+    // PRIMA di questa correzione refertoDi scartava anche la copertura insieme al valore:
+    // la pagina non aveva modo di dire "41%", solo di dire "manca".
+    const { db, s } = conCompilazione();
+    const referto = refertoDi(db, s);
+    expect(referto.fitnessAge).toBeNull();
+    expect(referto.fitnessAgeCopertura).toBe(0);
+  });
+
+  it('un asse coperto porta il suo numero', () => {
+    const { db, s } = conCompilazione();
+    const stile = refertoDi(db, s).assi.find((a) => a.nome === 'Stile di Vita & Sonno')!;
+    expect(stile.valore).not.toBeNull();
+    expect(stile.mancano).toEqual([]);
+  });
+
+  it('legge i punteggi congelati, non li ricalcola al volo', () => {
+    const { db, s } = conCoperturaParziale();
+    const prima = JSON.stringify(refertoDi(db, s));
+    // ATTENZIONE alla scelta della mutazione: non una qualunque, una che DISCRIMINA
+    // davvero un ricalcolo da una lettura congelata.
+    //
+    // 'Recupero & Sistema Nervoso' pesa QUATTRO sotto-domini (hrv 0.50, pressione 0.15,
+    // hrr 0.15, questionario_sonno 0.20); questa sessione ne misura UNO solo
+    // (questionario_sonno, via q_riposato in conCoperturaParziale) — copertura vera
+    // 0.20/1.00=0.20, sotto COPERTURA_MINIMA (0.4): l'asse e' 'insufficiente', ma con
+    // disponibili.length===1, non 0 — la formula del peso viene davvero eseguita, non
+    // bypassata dalla scorciatoia "nessun dato disponibile" di aggrega() in cascata.ts.
+    // Azzerando il peso di 'hrv' (un sotto-dominio ASSENTE) il totale scende a 0.50 e la
+    // copertura vera diventa 0.20/0.50=0.40: attraversa la soglia, l'asse passerebbe da
+    // insufficiente a ok SE il referto ricalcolasse (provato: vedi task-3-report.md).
+    //
+    // Una mutazione come questa NON discrimina, ed e' un errore da non ripetere:
+    // il peso dell'UNICO sotto-dominio di un asse a un solo elemento (es.
+    // 'questionario_lifestyle', 1.00 in 'Stile di Vita & Sonno') si semplifica sempre,
+    // sia al numeratore sia al denominatore della media pesata — cambiarlo non altera
+    // ne' il valore ne' la copertura, quindi il test resterebbe verde anche se
+    // refertoDi ricalcolasse davvero (era il bug di questo stesso test, corretto qui).
+    db.prepare(
+      `UPDATE pesi SET peso = 0 WHERE model_version = ? AND livello='asse' AND contenitore='Recupero & Sistema Nervoso' AND elemento='hrv'`
+    ).run(MODEL_VERSION);
+    expect(JSON.stringify(refertoDi(db, s))).toBe(prima);
+  });
+
+  it('nessuna pagina interroga il database da sola', () => {
+    // Scandisce TUTTE le pagine sotto src/pages/longevity/, non un elenco scritto qui:
+    // un elenco di due nomi non protegge una pagina nuova, che passerebbe indisturbata
+    // anche con una query dentro (verificato: una prova-query.astro con un
+    // db.prepare('SELECT 1') non veniva vista dalla versione precedente di questo test).
+    const dir = join(process.cwd(), 'src/pages/longevity');
+    const pagine = (readdirSync(dir, { recursive: true }) as string[])
+      .filter((f) => f.endsWith('.astro'));
+    expect(pagine.length).toBeGreaterThan(0); // se la cartella si svuota, il test non deve tacere per errore
+    for (const f of pagine) {
+      const percorso = `src/pages/longevity/${f}`;
+      const src = readFileSync(join(dir, f), 'utf8');
+      expect(src, `${percorso} contiene SQL`).not.toMatch(/\bSELECT\b|\.prepare\(/i);
+    }
+  });
+});

tests/longevity/registro.test.ts

@@ -0,0 +1,74 @@
+import { describe, it, expect } from 'vitest';
+import { createLongevityDb } from '../../src/lib/longevity/db';
+import { seedRegistro, seedPesi, testAttivi, esisteTest } from '../../src/lib/longevity/registro';
+
+describe('registro dei test', () => {
+  it('carica i 20 campi punteggiati del questionario', () => {
+    const db = createLongevityDb(':memory:');
+    seedRegistro(db);
+    const q = db.prepare(`SELECT COUNT(*) n FROM registro_test WHERE test_id LIKE 'q_%'`).get() as { n: number };
+    expect(q.n).toBe(20);
+  });
+
+  it('alcol_life porta la soglia 7-14 voluta da Nicola', () => {
+    const db = createLongevityDb(':memory:');
+    seedRegistro(db);
+    const row = db.prepare(`SELECT curva, params FROM registro_test WHERE test_id = 'q_alcol_life'`)
+      .get() as { curva: string; params: string };
+    expect(row.curva).toBe('lin_dec');
+    expect(JSON.parse(row.params)).toEqual({ best: 7, worst: 14 });
+  });
+
+  it('calo_pomeridiano usa la curva invertita, la quinta che al Python manca', () => {
+    const db = createLongevityDb(':memory:');
+    seedRegistro(db);
+    const row = db.prepare(`SELECT curva FROM registro_test WHERE test_id = 'q_calo_pomeridiano'`)
+      .get() as { curva: string };
+    expect(row.curva).toBe('x10_inv');
+  });
+
+  it('un test disattivato non e piu attivo dopo la sua data', () => {
+    const db = createLongevityDb(':memory:');
+    seedRegistro(db);
+    db.prepare(`UPDATE registro_test SET attivo_a = '2026-08-01' WHERE test_id = 'q_sigarette'`).run();
+    const attivi = testAttivi(db, '2026-08-21').map((t) => t.test_id);
+    expect(attivi).not.toContain('q_sigarette');
+    expect(testAttivi(db, '2026-07-01').map((t) => t.test_id)).toContain('q_sigarette');
+  });
+
+  it('esisteTest distingue un test vero da uno inventato', () => {
+    const db = createLongevityDb(':memory:');
+    seedRegistro(db);
+    expect(esisteTest(db, 'q_ore_sonno')).toBe(true);
+    expect(esisteTest(db, 'q_inventato')).toBe(false);
+  });
+
+  it('i pesi di ogni asse sommano a 1', () => {
+    const db = createLongevityDb(':memory:');
+    seedPesi(db, 'v1.0');
+    const righe = db.prepare(
+      `SELECT contenitore, ROUND(SUM(peso), 6) tot FROM pesi
+       WHERE model_version = 'v1.0' AND livello = 'asse' GROUP BY contenitore`
+    ).all() as { contenitore: string; tot: number }[];
+    expect(righe.length).toBe(7);
+    for (const r of righe) expect(r.tot).toBe(1);
+  });
+
+  it('i pesi sono legati alla versione del modello', () => {
+    const db = createLongevityDb(':memory:');
+    seedPesi(db, 'v1.0');
+    seedPesi(db, 'v2.0');
+    const n = db.prepare(`SELECT COUNT(DISTINCT model_version) n FROM pesi`).get() as { n: number };
+    expect(n.n).toBe(2);
+  });
+
+  it('il plank pesa su due assi: va visto, non nascosto', () => {
+    const db = createLongevityDb(':memory:');
+    seedPesi(db, 'v1.0');
+    const righe = db.prepare(
+      `SELECT contenitore FROM pesi WHERE model_version='v1.0' AND livello='asse' AND elemento IN ('core','plank')`
+    ).all() as { contenitore: string }[];
+    expect(righe.map((r) => r.contenitore).sort())
+      .toEqual(['Forza & Struttura', 'Stabilità & Mobilità Funzionale']);
+  });
+});

tests/longevity/riferimento/README.md

@@ -0,0 +1,22 @@
+# L'oracolo del motore di calcolo
+
+`isl_scoring_engine.py` è il motore di punteggio **scritto dal cliente** (In-Sanity Lab),
+ricevuto il 2026-08-21. Non è codice nostro e non va modificato: sta qui perché è
+l'**oracolo** contro cui verifichiamo il porting in TypeScript.
+
+Il porting delle curve è la parte più delicata della piattaforma: un coefficiente
+trascritto male produce un punteggio sanitario sbagliato che sembra plausibile e che
+nessun test funzionale intercetterebbe, perché diventerebbe il valore "atteso" di tutto
+ciò che viene dopo. La fedeltà non è garantita dalla trascrizione, ma dal confronto
+numerico: `genera-riferimento.py` esegue questo motore su una griglia di casi e scrive
+`riferimento.json`, che il test TypeScript rilegge per confrontare i due risultati.
+
+Serve `python3` (solo libreria standard: il motore importa unicamente `dataclasses` e
+`typing`).
+
+## Rigenerare il riferimento
+
+    python3 tests/longevity/riferimento/genera-riferimento.py
+
+Va rifatto solo se il cliente manda una versione nuova del motore. In quel caso il
+confronto dirà da sé quali curve sono cambiate.

tests/longevity/riferimento/genera-riferimento.py

@@ -0,0 +1,127 @@
+#!/usr/bin/env python3
+"""
+Esegue il motore del cliente su una griglia fitta di ingressi e scrive i risultati
+in riferimento.json. È il metro contro cui si misura il porting in TypeScript:
+non serve a provare che l'oracolo è giusto, ma che il nostro porting gli è fedele.
+
+Uso: python3 tests/longevity/riferimento/genera-riferimento.py
+"""
+import json
+import pathlib
+import sys
+
+QUI = pathlib.Path(__file__).parent
+sys.path.insert(0, str(QUI))
+
+import isl_scoring_engine as m
+
+casi = []
+
+
+def prova(fn_nome, *args):
+    """Esegue una funzione dell'oracolo e registra ingressi e uscita."""
+    fn = getattr(m, fn_nome)
+    casi.append({"fn": fn_nome, "args": list(args), "atteso": fn(*args)})
+
+
+def griglia(inizio, fine, passo):
+    """Valori da inizio a fine compreso, con arrotondamento pulito."""
+    n, v = [], inizio
+    while v <= fine + 1e-9:
+        n.append(round(v, 4))
+        v += passo
+    return n
+
+
+# --- curve generiche del questionario: tutto il dominio, non un campione ---
+for v in griglia(0, 14, 0.5):
+    prova("score_bell_curve", v, 4, 7, 9, 12)      # q_ore_sonno
+    prova("score_decreasing", v, 0, 7)             # q_caffeina e gemelle
+    prova("score_decreasing", v, 7, 14)            # q_alcol_life: la soglia voluta
+for v in griglia(0, 10, 0.5):
+    prova("score_direct_x10", v)
+for v in griglia(0, 7, 0.5):
+    prova("score_increasing_plateau", v, 0, 4)
+    prova("score_increasing_plateau", v, 2, 6)   # worst != 0: l'offset e' l'unico parametro a rischio refuso
+
+# --- composizione corporea: attorno ai confini delle bande ---
+for sesso in ("M", "F"):
+    for v in griglia(0, 45, 0.5):
+        prova("score_fat_percent", v, sesso)
+    for v in griglia(20, 60, 0.5):
+        prova("score_muscle_percent", v, sesso)
+    for v in griglia(0.5, 1.3, 0.01):
+        prova("score_whr", v, sesso)
+
+# --- cardio ---
+for v in griglia(85, 100, 1):
+    prova("score_spo2", v)
+for sbp in griglia(90, 200, 5):
+    for dbp in griglia(50, 120, 5):
+        prova("score_blood_pressure", sbp, dbp)
+for v in griglia(0, 40, 1):
+    prova("score_hrr", v)
+for sesso in ("M", "F"):
+    for eta in griglia(20, 75, 5):
+        for v in griglia(15, 70, 2.5):
+            prova("score_vo2max", v, eta, sesso)
+for v in griglia(120, 200, 5):
+    prova("vo2max_from_step_test", v, "M")
+    prova("vo2max_from_step_test", v, "F")
+for v in griglia(100, 300, 10):
+    prova("vo2max_from_mutt", v)
+for w in griglia(50, 200, 10):
+    prova("vo2max_from_milfit", w, 75)
+# caso base + variazione di un parametro alla volta: un punto solo non separa i 5 coefficienti
+BASE_2KM = (15.5, 130, 40, 24)  # tempo_min, hr, eta, bmi
+prova("vo2max_from_2km_walk", *BASE_2KM)
+for tempo in griglia(10, 25, 2.5):
+    prova("vo2max_from_2km_walk", tempo, BASE_2KM[1], BASE_2KM[2], BASE_2KM[3])
+for hr in griglia(100, 160, 10):
+    prova("vo2max_from_2km_walk", BASE_2KM[0], hr, BASE_2KM[2], BASE_2KM[3])
+for eta in griglia(20, 75, 5):
+    prova("vo2max_from_2km_walk", BASE_2KM[0], BASE_2KM[1], eta, BASE_2KM[3])
+for bmi in griglia(18, 32, 2):
+    prova("vo2max_from_2km_walk", BASE_2KM[0], BASE_2KM[1], BASE_2KM[2], bmi)
+
+# --- forza ---
+for sesso in ("M", "F"):
+    for eta in griglia(25, 75, 5):
+        for v in griglia(10, 70, 2.5):
+            prova("score_handgrip", v, eta, sesso)
+        for v in griglia(0, 60, 2):
+            prova("score_pushup", v, eta, sesso)
+    for v in griglia(0, 250, 5):
+        prova("score_plank", v, sesso)
+    confini_plank = [79, 97, 122, 157, 201] if sesso == "M" else [35, 63, 84, 108, 142]
+    for v in confini_plank:            # confini esatti delle bande: costano zero, tolgono ogni dubbio
+        prova("score_plank", v, sesso)
+    for v in griglia(0, 120, 5):
+        prova("score_flexed_arm_hang", v, sesso)
+    for v in griglia(0, 60, 2):
+        prova("score_sit_to_stand_1min", v, 40, sesso)
+    for v in griglia(-30, 30, 1):
+        prova("score_sit_and_reach", v, sesso)
+    for eta in griglia(25, 75, 5):
+        for v in griglia(-30, 20, 2):
+            prova("score_back_scratch", v, eta, sesso)
+
+# --- sollevamenti sui rapporti col peso corporeo ---
+for sesso in ("M", "F"):
+    for carico in griglia(20, 200, 10):
+        prova("score_bw_ratio_lift", carico, 80, 5, m.TIERS_BENCH_M, m.TIERS_BENCH_F, sesso)
+        prova("score_bw_ratio_lift", carico, 80, 5, m.TIERS_SQUAT_M, m.TIERS_SQUAT_F, sesso)
+        prova("score_bw_ratio_lift", carico, 80, 5, m.TIERS_ROW_M, m.TIERS_ROW_F, sesso)
+
+# --- stabilità ---
+for v in griglia(0, 30, 1):
+    prova("score_flamingo", v)
+for a in griglia(0, 180, 10):
+    prova("score_shoulder_mobility_wt", a, a)
+
+uscita = QUI / "riferimento.json"
+uscita.write_text(json.dumps(
+    {"generato_da": "isl_scoring_engine.py", "casi": casi},
+    indent=1, ensure_ascii=False,
+))
+print(f"{len(casi)} casi scritti in {uscita}")

tests/longevity/riferimento/isl_scoring_engine.py

@@ -0,0 +1,537 @@
+"""
+IN-SANITY LAB — Motore di calcolo Longevity Score
+===================================================
+
+Implementa la cascata a 4 livelli definita nel foglio "Pesi e Formule" del
+Registro Test:
+
+    1. Sotto-metrica grezza  -> punteggio 0-100 (normalizzazione test-specifica)
+    2. Punteggi sotto-metrica -> punteggio Asse (media pesata, rinormalizzata
+       se mancano dati)
+    3. Punteggi Asse -> 3 Macro-score (Performance / Energy / Recovery)
+    4. Punteggi Asse -> Fitness Age
+
+Regola di copertura (uguale a ogni livello): se un elemento manca, il suo
+peso si ridistribuisce sugli elementi disponibili. Se la copertura di peso
+disponibile scende sotto il 40%, l'elemento calcolato viene marcato
+'insufficiente' invece che pieno.
+
+Questo modulo NON include l'interfaccia (dashboard) - produce solo i numeri.
+Si integra con:
+  - parse_wellness_tower.py (dati automatici Composizione/Cardio/Recupero)
+  - analyze_calibre.py (VO2max diretto, gia' esistente)
+  - inserimento manuale / futura web app (resto dei test)
+
+Uso rapido: vedi la funzione demo() in fondo al file.
+"""
+
+from dataclasses import dataclass, field
+from typing import Optional
+
+
+MIN_COVERAGE = 0.40  # sotto questa soglia di peso disponibile, l'elemento e' 'insufficiente'
+
+
+# =========================================================================
+# LIVELLO 1 — Normalizzazione sotto-metrica -> 0-100
+# =========================================================================
+
+def clamp(x, lo=0, hi=100):
+    return max(lo, min(hi, x))
+
+
+def _lerp(x, x0, x1, y0, y1):
+    if x1 == x0:
+        return y0
+    t = (x - x0) / (x1 - x0)
+    t = max(0, min(1, t))
+    return y0 + t * (y1 - y0)
+
+
+# --- Composizione Corporea -------------------------------------------------
+
+def score_fat_percent(fat_pct, sex):
+    """Curva a campana ACE. Il picco e' su Atleti/Fitness, non sul grasso piu basso."""
+    m = sex.strip().lower().startswith("m")
+    bands = [
+        (0, 2, 40), (2, 5, 65), (5, 13, 100), (13, 17, 90), (17, 24, 65), (24, 35, 30), (35, 200, 10),
+    ] if m else [
+        (0, 10, 40), (10, 13, 65), (13, 20, 100), (20, 24, 90), (24, 31, 65), (31, 40, 30), (40, 200, 10),
+    ]
+    for lo, hi, val in bands:
+        if lo <= fat_pct < hi:
+            return val
+    return 50
+
+
+def score_muscle_percent(muscle_pct, sex):
+    """Crescente con plateau: uomini 42.9-52.4%, donne 37.8-46.2% (standard device)."""
+    lo, hi = (42.9, 52.4) if sex.strip().lower().startswith("m") else (37.8, 46.2)
+    if muscle_pct >= hi:
+        return 100
+    if muscle_pct <= lo - 10:
+        return 20
+    return round(_lerp(muscle_pct, lo - 10, hi, 20, 100), 1)
+
+
+def score_whr(whr, sex):
+    threshold = 0.90 if sex.strip().lower().startswith("m") else 0.85
+    if whr <= threshold - 0.10:
+        return 100
+    if whr <= threshold:
+        return round(_lerp(whr, threshold - 0.10, threshold, 100, 60), 1)
+    return clamp(round(60 - (whr - threshold) * 300, 1))
+
+
+# --- Cardio-Respiratorio ----------------------------------------------------
+
+def vo2max_from_step_test(hr_recovery, sex):
+    """Queen's College Step Test (McArdle et al. 1972)."""
+    if sex.strip().lower().startswith("m"):
+        return 111.33 - 0.42 * hr_recovery
+    return 65.81 - 0.1847 * hr_recovery
+
+
+def vo2max_from_2km_walk(tempo_min, hr, eta, bmi):
+    """UKK 2km Walking Test (Laukkanen/Oja)."""
+    return 116.2 - 2.98 * tempo_min - 0.11 * hr - 0.14 * eta - 0.39 * bmi
+
+
+def vo2max_from_mutt(vam_m_min):
+    """Formula ACSM su VAM raggiunta al tapis. Etichettare come 'teorico/stimato'."""
+    return 0.2 * vam_m_min + 3.5
+
+
+def vo2max_from_milfit(watt, peso_kg):
+    """Formula ACSM cicloergometro. Etichettare come 'teorico/stimato'. Valida 50-200W."""
+    return (10.8 * watt) / peso_kg + 7
+
+
+def score_vo2max(vo2max, eta, sex):
+    """ACSM/FRIEND Registry, bande approssimate per fascia d'eta e sesso."""
+    m = sex.strip().lower().startswith("m")
+    # soglie 'buono' per decade (uomini), interpolate da FRIEND Registry
+    good_thresholds_m = {20: 46, 30: 43, 40: 42, 50: 38, 60: 35, 70: 30}
+    good_thresholds_f = {20: 38, 30: 37, 40: 34, 50: 30, 60: 27, 70: 23}
+    table = good_thresholds_m if m else good_thresholds_f
+    decade = min(70, max(20, (eta // 10) * 10))
+    good = table[decade]
+    poor = good * 0.65
+    superior = good * 1.35
+    if vo2max <= poor:
+        return clamp(round(_lerp(vo2max, 0, poor, 10, 40), 1))
+    if vo2max <= good:
+        return round(_lerp(vo2max, poor, good, 40, 70), 1)
+    return clamp(round(_lerp(vo2max, good, superior, 70, 100), 1))
+
+
+def score_spo2(spo2_pct):
+    """Saturazione O2: 95-100% normale, sotto 90% campanello d'allarme clinico."""
+    if spo2_pct >= 97:
+        return 100
+    if spo2_pct >= 95:
+        return 85
+    if spo2_pct >= 90:
+        return 50
+    return 15
+
+
+# --- Recupero & Sistema Nervoso --------------------------------------------
+
+def score_blood_pressure(sbp, dbp):
+    """ESC/ESH 2018. Vale la categoria piu alta tra sistolica e diastolica."""
+    if sbp >= 180 or dbp >= 110:
+        return 5
+    if sbp >= 160 or dbp >= 100:
+        return 25
+    if sbp >= 140 or dbp >= 90:
+        return 45
+    if sbp >= 130 or dbp >= 85:
+        return 70
+    if sbp >= 120 or dbp >= 80:
+        return 90
+    return 100
+
+
+def score_hrr(calo_bpm_1min):
+    """Recupero cardiaco 1' post-sforzo. >=12bpm considerato normale (Cole et al. 1999)."""
+    if calo_bpm_1min >= 12:
+        return clamp(round(_lerp(calo_bpm_1min, 12, 30, 70, 100), 1))
+    return clamp(round(_lerp(calo_bpm_1min, 0, 12, 20, 70), 1))
+
+
+# --- Forza & Struttura -------------------------------------------------------
+
+def score_handgrip(kg, eta, sex):
+    """Approssimazione da NIH Toolbox / Dodds et al. Curva discendente con l'eta."""
+    m = sex.strip().lower().startswith("m")
+    # ancore (eta, valore medio kg) approssimate dalla letteratura citata
+    anchors_m = [(25, 49.7), (40, 46), (60, 38), (75, 30)]
+    anchors_f = [(25, 30), (40, 28), (60, 24), (75, 18.7)]
+    anchors = anchors_m if m else anchors_f
+    eta_c = clamp(eta, 25, 75)
+    for i in range(len(anchors) - 1):
+        a_eta, a_val = anchors[i]
+        b_eta, b_val = anchors[i + 1]
+        if a_eta <= eta_c <= b_eta:
+            mean_val = _lerp(eta_c, a_eta, b_eta, a_val, b_val)
+            break
+    else:
+        mean_val = anchors[-1][1]
+    # media = punteggio 70; +/- 40% della media copre la banda 20-100
+    ratio = kg / mean_val if mean_val else 1
+    return clamp(round(_lerp(ratio, 0.5, 1.5, 20, 100), 1))
+
+
+def score_pushup(reps, eta, sex):
+    """ACSM/CSEP, bande approssimate per decade."""
+    m = sex.strip().lower().startswith("m")
+    base_good_m, base_good_f = 22, 15  # 35-39 anni, 'buono' minimo
+    decade_offset = max(0, (eta - 35) // 10) * 2.5  # calo ~2.5 rip/decade dopo i 35
+    good = (base_good_m if m else base_good_f) - decade_offset
+    superior = good * 1.6
+    poor = good * 0.5
+    if reps <= poor:
+        return clamp(round(_lerp(reps, 0, poor, 10, 40), 1))
+    if reps <= good:
+        return round(_lerp(reps, poor, good, 40, 70), 1)
+    return clamp(round(_lerp(reps, good, superior, 70, 100), 1))
+
+
+def score_bw_ratio_lift(carico_kg, peso_corporeo_kg, rip, tiers_m, tiers_f, sex):
+    """Generico per 5RM->1RM(Brzycki)->rapporto peso corporeo, su tiers (beg/nov/int/adv/elite)."""
+    rm1 = carico_kg * 36 / (37 - rip)  # Brzycki
+    ratio = rm1 / peso_corporeo_kg
+    tiers = tiers_m if sex.strip().lower().startswith("m") else tiers_f
+    # tiers = [(soglia_ratio, punteggio), ...] crescente
+    prev_r, prev_s = 0, 10
+    for r, s in tiers:
+        if ratio <= r:
+            return round(_lerp(ratio, prev_r, r, prev_s, s), 1)
+        prev_r, prev_s = r, s
+    return 100
+
+
+TIERS_BENCH_M = [(0.5, 30), (1.0, 60), (1.25, 80), (1.5, 100)]
+TIERS_BENCH_F = [(0.3, 30), (0.6, 60), (0.75, 80), (1.0, 100)]
+TIERS_SQUAT_M = [(0.75, 30), (1.5, 60), (1.75, 80), (2.0, 100)]
+TIERS_SQUAT_F = [(0.5, 30), (1.1, 60), (1.3, 80), (1.5, 100)]
+TIERS_ROW_M = [(0.45, 30), (0.70, 60), (0.95, 80), (1.20, 100)]
+TIERS_ROW_F = [(0.30, 30), (0.45, 60), (0.60, 80), (0.80, 100)]
+
+
+def score_flexed_arm_hang(sec, sex):
+    good, superior = (45, 70) if sex.strip().lower().startswith("m") else (25, 50)
+    if sec <= good * 0.4:
+        return clamp(round(_lerp(sec, 0, good * 0.4, 10, 40), 1))
+    if sec <= good:
+        return round(_lerp(sec, good * 0.4, good, 40, 70), 1)
+    return clamp(round(_lerp(sec, good, superior, 70, 100), 1))
+
+
+def score_sit_to_stand_1min(reps, eta, sex, bmi=24):
+    """Reference equation adulti 18-95 (Zalewski et al.-style)."""
+    sex_code = 0 if sex.strip().lower().startswith("m") else 1
+    predicted = 61.53 - 0.34 * eta - 3.57 * sex_code - 0.33 * bmi
+    ratio = reps / predicted if predicted else 1
+    return clamp(round(_lerp(ratio, 0.5, 1.3, 20, 100), 1))
+
+
+def score_plank(sec, sex):
+    bands_m = [(79, 20), (97, 40), (122, 55), (157, 75), (201, 90)]
+    bands_f = [(35, 20), (63, 40), (84, 55), (108, 75), (142, 90)]
+    bands = bands_m if sex.strip().lower().startswith("m") else bands_f
+    prev_t, prev_s = 0, 10
+    for t, s in bands:
+        if sec <= t:
+            return round(_lerp(sec, prev_t, t, prev_s, s), 1)
+        prev_t, prev_s = t, s
+    return 100
+
+
+# --- Stabilità & Mobilità ----------------------------------------------------
+
+def score_back_scratch(cm, eta, sex):
+    """Rikli & Jones (Senior Fitness Test) + studio norvegese per fascia under 60.
+    Positivo=sovrapposizione dita, negativo=distanza. Anchor a 62 anni (dato solido),
+    estrapolato linearmente (~4cm/5 anni) per le altre eta. Approssimazione da
+    dichiarare, non tabella completa."""
+    m = sex.strip().lower().startswith("m")
+    anchor_eta, anchor_cm = 62, (-8.6 if m else -1.8)
+    decline_per_year = 0.8  # cm peggioramento per anno di eta in piu
+    expected = anchor_cm - (eta - anchor_eta) * decline_per_year
+    # punteggio: 0/pieno contatto (0cm) o sovrapposizione (positivo) = ottimo
+    diff = cm - expected
+    return clamp(round(_lerp(diff, -15, 15, 20, 100), 1))
+
+
+def score_shoulder_mobility_wt(outreach_deg, buckling_deg):
+    """Wellness Tower, riferimento 180 gradi (outreach/buckling)."""
+    avg = (outreach_deg + buckling_deg) / 2
+    return clamp(round(avg / 180 * 100, 1))
+
+
+def score_flamingo(cadute):
+    """Decrescente: meno cadute = meglio."""
+    if cadute <= 3:
+        return 100
+    if cadute <= 7:
+        return round(_lerp(cadute, 3, 7, 100, 80), 1)
+    if cadute <= 15:
+        return round(_lerp(cadute, 7, 15, 80, 50), 1)
+    return clamp(round(_lerp(cadute, 15, 30, 50, 10), 1))
+
+
+def score_sit_and_reach(cm, sex):
+    median = 24 if sex.strip().lower().startswith("m") else 31
+    return clamp(round(_lerp(cm, median - 20, median + 10, 20, 100), 1))
+
+
+def score_agility_ms(ms, eta, sex):
+    """Blomkvist et al. 2017, decrescente (meno ms = meglio)."""
+    base = 250 if sex.strip().lower().startswith("m") else 265
+    decade_add = max(0, (eta - 30) // 10) * 35
+    expected = base + decade_add
+    ratio = expected / ms if ms else 1
+    return clamp(round(_lerp(ratio, 0.7, 1.3, 20, 100), 1))
+
+
+# --- Questionario: curve generiche -----------------------------------------
+
+def score_bell_curve(value, low, peak_low, peak_high, high):
+    """Curva a campana: picco tra peak_low e peak_high, decresce ai lati."""
+    if peak_low <= value <= peak_high:
+        return 100
+    if value < peak_low:
+        return clamp(round(_lerp(value, low, peak_low, 10, 100), 1))
+    return clamp(round(_lerp(value, peak_high, high, 100, 10), 1))
+
+
+def score_decreasing(value, best, worst):
+    return clamp(round(_lerp(value, best, worst, 100, 0), 1))
+
+
+def score_increasing_plateau(value, worst, plateau_start):
+    return clamp(round(_lerp(value, worst, plateau_start, 20, 100), 1))
+
+
+def score_direct_x10(value_0_10):
+    return clamp(round(value_0_10 * 10, 1))
+
+
+# =========================================================================
+# LIVELLO 2 — Sotto-metriche -> punteggio Asse
+# =========================================================================
+
+@dataclass
+class WeightedScore:
+    score: Optional[float]   # None se dato mancante
+    weight: float             # peso nominale (dalla config)
+
+
+def aggregate(items: list[WeightedScore]):
+    """Rinormalizza sui pesi disponibili. Ritorna (punteggio, copertura, stato)."""
+    total_weight = sum(i.weight for i in items)
+    available = [i for i in items if i.score is not None]
+    available_weight = sum(i.weight for i in available)
+    coverage = available_weight / total_weight if total_weight else 0
+
+    if not available:
+        return None, 0.0, "insufficiente"
+
+    weighted_sum = sum(i.score * i.weight for i in available)
+    score = weighted_sum / available_weight
+
+    status = "insufficiente" if coverage < MIN_COVERAGE else "ok"
+    return round(score, 1), round(coverage, 2), status
+
+
+# Config pesi sotto-dominio -> asse (dal foglio "Pesi e Formule")
+AXIS_SUBDOMAIN_WEIGHTS = {
+    "Forza & Struttura": {
+        "handgrip": 0.25, "spinta": 0.20, "trazione": 0.20, "arti_inferiori": 0.20, "core": 0.15,
+    },
+    "Composizione Corporea": {
+        "grasso": 0.40, "muscolo": 0.35, "whr": 0.25,
+    },
+    "Cardio-Respiratorio": {
+        "vo2max": 0.60, "spirometria": 0.20, "wellness_tower_cardio": 0.20,
+    },
+    "Recupero & Sistema Nervoso": {
+        "hrv": 0.50, "pressione": 0.15, "hrr": 0.15, "questionario_sonno": 0.20,
+    },
+    "Energia & Regolazione Stress": {
+        "hrv": 0.50, "questionario_energia_stress": 0.50,
+    },
+    "Stabilità & Mobilità Funzionale": {
+        "flamingo": 0.35, "sit_and_reach": 0.25, "plank": 0.20, "back_scratch": 0.14, "wellness_tower_shoulder": 0.06,
+    },
+    "Stile di Vita & Sonno": {
+        "questionario_lifestyle": 1.00,
+    },
+}
+
+# Config pesi asse -> macro-score
+MACRO_SCORE_WEIGHTS = {
+    "PERFORMANCE": {
+        "Forza & Struttura": 0.25, "Cardio-Respiratorio": 0.25, "Composizione Corporea": 0.15,
+        "Stabilità & Mobilità Funzionale": 0.20, "Recupero & Sistema Nervoso": 0.10,
+        "Energia & Regolazione Stress": 0.05, "Stile di Vita & Sonno": 0.0,
+    },
+    "ENERGY": {
+        "Energia & Regolazione Stress": 0.30, "Stile di Vita & Sonno": 0.20,
+        "Recupero & Sistema Nervoso": 0.25, "Cardio-Respiratorio": 0.15,
+        "Composizione Corporea": 0.10, "Forza & Struttura": 0.0, "Stabilità & Mobilità Funzionale": 0.0,
+    },
+    "RECOVERY": {
+        "Recupero & Sistema Nervoso": 0.45, "Energia & Regolazione Stress": 0.15,
+        "Stile di Vita & Sonno": 0.20, "Stabilità & Mobilità Funzionale": 0.15,
+        "Forza & Struttura": 0.05, "Cardio-Respiratorio": 0.0, "Composizione Corporea": 0.0,
+    },
+}
+
+# Config pesi Fitness Age (nota: Handgrip ed HRV entrano isolati, non tramite l'intero asse)
+FITNESS_AGE_WEIGHTS = {
+    "cardio": 0.30, "handgrip_isolato": 0.20, "hrv_isolato": 0.20,
+    "forza_resto": 0.15, "composizione": 0.10, "stabilita": 0.05,
+}
+
+
+def compute_axis(axis_name, subdomain_scores: dict):
+    """subdomain_scores: {nome_sottodominio: score_0_100 or None}"""
+    weights = AXIS_SUBDOMAIN_WEIGHTS[axis_name]
+    items = [WeightedScore(subdomain_scores.get(k), w) for k, w in weights.items()]
+    score, coverage, status = aggregate(items)
+    return {"score": score, "coverage": coverage, "status": status}
+
+
+# =========================================================================
+# LIVELLO 3 — 7 Assi -> 3 Macro-score
+# =========================================================================
+
+def compute_macro_scores(axis_scores: dict):
+    """axis_scores: {nome_asse: {'score':..,'status':..}}"""
+    results = {}
+    for macro_name, weights in MACRO_SCORE_WEIGHTS.items():
+        items = [
+            WeightedScore(axis_scores[axis]["score"] if axis_scores[axis]["status"] != "insufficiente" else None, w)
+            for axis, w in weights.items() if w > 0
+        ]
+        score, coverage, status = aggregate(items)
+        results[macro_name] = {"score": score, "coverage": coverage, "status": status}
+    return results
+
+
+# =========================================================================
+# LIVELLO 4 — Fitness Age
+# =========================================================================
+
+def compute_fitness_age(eta_anagrafica, cardio_score, handgrip_score, hrv_score,
+                         forza_resto_score, composizione_score, stabilita_score):
+    items = [
+        WeightedScore(cardio_score, FITNESS_AGE_WEIGHTS["cardio"]),
+        WeightedScore(handgrip_score, FITNESS_AGE_WEIGHTS["handgrip_isolato"]),
+        WeightedScore(hrv_score, FITNESS_AGE_WEIGHTS["hrv_isolato"]),
+        WeightedScore(forza_resto_score, FITNESS_AGE_WEIGHTS["forza_resto"]),
+        WeightedScore(composizione_score, FITNESS_AGE_WEIGHTS["composizione"]),
+        WeightedScore(stabilita_score, FITNESS_AGE_WEIGHTS["stabilita"]),
+    ]
+    composite, coverage, status = aggregate(items)
+    if composite is None:
+        return {"fitness_age": None, "coverage": coverage, "status": "insufficiente"}
+    fitness_age = eta_anagrafica - (composite - 50) * 0.4
+    return {"fitness_age": round(fitness_age, 1), "composite": composite, "coverage": coverage, "status": status}
+
+
+# =========================================================================
+# DEMO END-TO-END
+# =========================================================================
+
+def demo():
+    """Esempio completo su un cliente fittizio (M, 38 anni, dati plausibili)."""
+    eta, sex, peso = 38, "M", 90.3
+
+    # --- Livello 1: normalizzazione sotto-metriche ---
+    forza = {
+        "handgrip": score_handgrip(kg=48, eta=eta, sex=sex),
+        "spinta": score_pushup(reps=24, eta=eta, sex=sex),
+        "trazione": score_bw_ratio_lift(80, peso, 5, TIERS_ROW_M, TIERS_ROW_F, sex),
+        "arti_inferiori": score_bw_ratio_lift(140, peso, 5, TIERS_SQUAT_M, TIERS_SQUAT_F, sex),
+        "core": score_plank(sec=110, sex=sex),
+    }
+    composizione = {
+        "grasso": score_fat_percent(12.8, sex),
+        "muscolo": score_muscle_percent(48.8, sex),
+        "whr": score_whr(0.71, sex),
+    }
+    vo2 = vo2max_from_mutt(vam_m_min=230)
+    cardio = {
+        "vo2max": score_vo2max(vo2, eta, sex),
+        "spirometria": 75,  # placeholder: da calcolatore GLI dedicato
+        "wellness_tower_cardio": score_spo2(98),
+    }
+    recupero = {
+        "hrv": 68,  # placeholder: score gia' normalizzato da ISL HRV Monitor
+        "pressione": score_blood_pressure(114, 81),
+        "hrr": score_hrr(calo_bpm_1min=15),
+        "questionario_sonno": 72,  # placeholder aggregato risposte questionario
+    }
+    energia = {
+        "hrv": 65,
+        "questionario_energia_stress": 60,
+    }
+    stabilita = {
+        "flamingo": score_flamingo(cadute=5),
+        "sit_and_reach": score_sit_and_reach(cm=20, sex=sex),
+        "plank": score_plank(sec=110, sex=sex),
+        "back_scratch": score_back_scratch(cm=-5, eta=eta, sex=sex),
+        "wellness_tower_shoulder": score_shoulder_mobility_wt(180, 180),
+    }
+    stile_vita = {
+        "questionario_lifestyle": 70,
+    }
+
+    # --- Livello 2: sotto-metriche -> assi ---
+    axis_scores = {
+        "Forza & Struttura": compute_axis("Forza & Struttura", forza),
+        "Composizione Corporea": compute_axis("Composizione Corporea", composizione),
+        "Cardio-Respiratorio": compute_axis("Cardio-Respiratorio", cardio),
+        "Recupero & Sistema Nervoso": compute_axis("Recupero & Sistema Nervoso", recupero),
+        "Energia & Regolazione Stress": compute_axis("Energia & Regolazione Stress", energia),
+        "Stabilità & Mobilità Funzionale": compute_axis("Stabilità & Mobilità Funzionale", stabilita),
+        "Stile di Vita & Sonno": compute_axis("Stile di Vita & Sonno", stile_vita),
+    }
+
+    print("=== RADAR — 7 ASSI ===")
+    for name, res in axis_scores.items():
+        print(f"  {name:35s} {res['score']:>6} (copertura {res['coverage']*100:.0f}%, {res['status']})")
+
+    # --- Livello 3: assi -> 3 macro-score ---
+    macro = compute_macro_scores(axis_scores)
+    print("\n=== MACRO-SCORE ===")
+    for name, res in macro.items():
+        print(f"  {name:12s} {res['score']:>6} (copertura {res['coverage']*100:.0f}%, {res['status']})")
+
+    # --- Livello 4: Fitness Age ---
+    fa = compute_fitness_age(
+        eta_anagrafica=eta,
+        cardio_score=axis_scores["Cardio-Respiratorio"]["score"],
+        handgrip_score=forza["handgrip"],
+        hrv_score=recupero["hrv"],
+        forza_resto_score=axis_scores["Forza & Struttura"]["score"],
+        composizione_score=axis_scores["Composizione Corporea"]["score"],
+        stabilita_score=axis_scores["Stabilità & Mobilità Funzionale"]["score"],
+    )
+    print(f"\n=== FITNESS AGE ===")
+    print(f"  Eta anagrafica: {eta}  ->  Fitness Age: {fa['fitness_age']} (composite {fa['composite']}, copertura {fa['coverage']*100:.0f}%)")
+
+
+def score_generic_range_local(value, low, high):
+    if high == low:
+        return 50
+    pct = (value - low) / (high - low)
+    return clamp(round(pct * 100, 1))
+
+
+if __name__ == "__main__":
+    demo()

tests/longevity/ruoli.test.ts

@@ -0,0 +1,123 @@
+import { describe, it, expect } from 'vitest';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { canAccessAdminPath, isProtectedPath, landingFor, isRole, ROLES } from '../../src/lib/auth';
+
+describe('accesso alle rotte longevity', () => {
+  it('il cliente entra nel proprio spazio', () => {
+    expect(canAccessAdminPath('cliente', '/longevity/io')).toBe(true);
+  });
+
+  it('il cliente NON entra nel gestionale', () => {
+    expect(canAccessAdminPath('cliente', '/longevity/gestionale')).toBe(false);
+  });
+
+  it('il trainer entra in entrambi', () => {
+    expect(canAccessAdminPath('trainer', '/longevity/io')).toBe(true);
+    expect(canAccessAdminPath('trainer', '/longevity/gestionale')).toBe(true);
+  });
+
+  it('il cliente non entra nelle altre piattaforme ne nel blog', () => {
+    expect(canAccessAdminPath('cliente', '/campus')).toBe(false);
+    expect(canAccessAdminPath('cliente', '/admin/content')).toBe(false);
+    expect(canAccessAdminPath('cliente', '/admin/posts')).toBe(false);
+  });
+
+  it('il trainer non entra nelle altre piattaforme ne nel blog', () => {
+    expect(canAccessAdminPath('trainer', '/campus')).toBe(false);
+    expect(canAccessAdminPath('trainer', '/admin/content')).toBe(false);
+    expect(canAccessAdminPath('trainer', '/admin/posts')).toBe(false);
+  });
+
+  it('il ruolo piattaforme non eredita longevity', () => {
+    expect(canAccessAdminPath('piattaforme', '/longevity/gestionale')).toBe(false);
+  });
+
+  it('admin passa sempre', () => {
+    expect(canAccessAdminPath('admin', '/longevity/gestionale')).toBe(true);
+  });
+});
+
+describe('isProtectedPath — quali rotte sono protette dal middleware', () => {
+  it('longevity è protetto', () => {
+    expect(isProtectedPath('/longevity/io')).toBe(true);
+    expect(isProtectedPath('/longevity/gestionale')).toBe(true);
+    expect(isProtectedPath('/api/longevity/qualcosa')).toBe(true);
+  });
+
+  it('i percorsi già esistenti restano protetti', () => {
+    expect(isProtectedPath('/admin')).toBe(true);
+    expect(isProtectedPath('/admin/content')).toBe(true);
+    expect(isProtectedPath('/api/admin/content')).toBe(true);
+    expect(isProtectedPath('/campus')).toBe(true);
+    expect(isProtectedPath('/piattaforme')).toBe(true);
+  });
+
+  it('il login e le pagine pubbliche non sono protetti', () => {
+    expect(isProtectedPath('/admin/login')).toBe(false);
+    expect(isProtectedPath('/blog')).toBe(false);
+    expect(isProtectedPath('/')).toBe(false);
+  });
+});
+
+describe('landingFor — indirizzo di atterraggio per ruolo', () => {
+  it('cliente atterra su longevity/io', () => {
+    expect(landingFor('cliente')).toBe('/longevity/io');
+  });
+
+  it('trainer atterra su longevity/gestionale', () => {
+    expect(landingFor('trainer')).toBe('/longevity/gestionale');
+  });
+
+  it('i ruoli già esistenti restano uguali', () => {
+    expect(landingFor('superuser')).toBe('/admin/content');
+    expect(landingFor('piattaforme')).toBe('/piattaforme');
+    expect(landingFor('admin')).toBe('/admin');
+    expect(landingFor('user')).toBe('/admin');
+  });
+});
+
+describe('isRole — validazione dei ruoli', () => {
+  it('cliente e trainer sono ruoli validi', () => {
+    expect(isRole('cliente')).toBe(true);
+    expect(isRole('trainer')).toBe(true);
+  });
+
+  it('i ruoli già esistenti restano validi', () => {
+    expect(isRole('admin')).toBe(true);
+    expect(isRole('superuser')).toBe(true);
+    expect(isRole('user')).toBe(true);
+    expect(isRole('piattaforme')).toBe(true);
+  });
+
+  it('campus e stringhe inventate non sono ruoli', () => {
+    expect(isRole('campus')).toBe(false);
+    expect(isRole('qualsiasi-cosa')).toBe(false);
+  });
+});
+
+describe('ROLES — fonte unica dei ruoli, usata dal pannello utenti', () => {
+  it('contiene tutti e sei i ruoli, cliente e trainer inclusi', () => {
+    expect(ROLES).toContain('cliente');
+    expect(ROLES).toContain('trainer');
+    expect(ROLES).toContain('admin');
+    expect(ROLES).toContain('superuser');
+    expect(ROLES).toContain('user');
+    expect(ROLES).toContain('piattaforme');
+    expect(ROLES.length).toBe(6);
+  });
+
+  it('isRole accetta esattamente i ruoli di ROLES, nessuno in piu o in meno', () => {
+    for (const r of ROLES) expect(isRole(r)).toBe(true);
+    expect(isRole('non-un-ruolo')).toBe(false);
+  });
+});
+
+describe('pannello utenti — la tendina dei ruoli non e piu scritta a mano', () => {
+  it('users.astro pesca i ruoli da ROLES, non da una lista propria che ne dimentica due', () => {
+    const src = readFileSync(join(process.cwd(), 'src/pages/admin/users.astro'), 'utf8');
+    expect(src).toContain('ROLES');
+    // La vecchia lista a quattro (dimenticava cliente e trainer) non deve piu comparire.
+    expect(src).not.toContain("['user', 'superuser', 'piattaforme', 'admin']");
+  });
+});

tests/longevity/salvataggio-e2e.test.ts

@@ -0,0 +1,60 @@
+// Il blocco scoperto nella revisione finale del 22/08: il salvataggio del questionario e la
+// lettura dei punteggi esistono entrambi, ma fra i due non calcolava niente nessuno.
+// I test esistenti (referto.test.ts) chiamavano calcolaSessione/salvaScore dentro la propria
+// fixture — cioè facevano a mano ciò che in produzione non fa nessuno — quindi restavano
+// verdi anche con l'endpoint reale del tutto scollegato dal motore.
+//
+// Questo file parte dal modulo compilato (salvaDalForm, la stessa funzione che chiama
+// l'endpoint POST /api/longevity/questionario) e arriva al referto (refertoDi): NON chiama
+// mai calcolaSessione o salvaScore a mano. Se un domani qualcuno stacca di nuovo il
+// calcolo dal salvataggio, questo è il test che deve diventare rosso.
+import { describe, it, expect } from 'vitest';
+import { createLongevityDb } from '../../src/lib/longevity/db';
+import { seedRegistro, seedPesi, MODEL_VERSION } from '../../src/lib/longevity/registro';
+import { salvaDalForm, refertoDi } from '../../src/lib/longevity/vista';
+
+function dbPronto() {
+  const db = createLongevityDb(':memory:');
+  seedRegistro(db);
+  seedPesi(db, MODEL_VERSION);
+  db.prepare(`INSERT INTO soggetti (client_code, sesso) VALUES ('ISL-0001','F')`).run();
+  return db;
+}
+
+describe('salvaDalForm calcola e congela i punteggi da solo', () => {
+  it('venti risposte compilate producono un referto con assi e macro-score valorizzati, senza ricalcolo a mano', () => {
+    const db = dbPronto();
+
+    const esito = salvaDalForm(db, {
+      client_code: 'ISL-0001', data: '2026-08-22', eta: 35,
+      risposte: {
+        q_ore_sonno: 7.5, q_min_addorm: 15, q_risvegli: 0, q_riposato: 8, q_caffeina: 1, q_sonnolenza_diurna: 1,
+        q_energia_media: 7, q_esaurimento: 0, q_calo_pomeridiano: 3,
+        q_sopraffatto: 1, q_controllo: 8, q_sicurezza_gestione: 8, q_tensione: 1, q_pensieri_lavoro: 0.5,
+        q_attivita: 5, q_alimentazione: 8, q_sigarette: 0, q_alcol_life: 2, q_luce: 2, q_schermi: 10,
+      },
+      consensoSanitario: 'Si', liberi: {},
+    });
+
+    expect(esito.ok).toBe(true);
+    if (!esito.ok) throw new Error(esito.errore);
+
+    // Riprova diretta sulla tabella score: prima di questa correzione restava vuota,
+    // perché nessuno chiamava calcolaSessione/salvaScore fra salvataggio e lettura.
+    const righeScore = db.prepare(`SELECT COUNT(*) n FROM score WHERE sessione_id = ?`).get(esito.sessioneId) as
+      { n: number };
+    expect(righeScore.n).toBeGreaterThan(0);
+
+    const referto = refertoDi(db, esito.sessioneId);
+    // 'Stile di Vita & Sonno' ha UN solo sotto-dominio (questionario_lifestyle, peso 1.00):
+    // con tutte le risposte compilate la copertura è piena.
+    const stile = referto.assi.find((a) => a.nome === 'Stile di Vita & Sonno')!;
+    expect(stile.valore).not.toBeNull();
+    // 'Energia & Regolazione Stress' pesa hrv 0.50 + questionario_energia_stress 0.50: con
+    // solo il questionario la copertura vera è 0.50, sopra la soglia del 40%.
+    const energia = referto.assi.find((a) => a.nome === 'Energia & Regolazione Stress')!;
+    expect(energia.valore).not.toBeNull();
+    const almenoUnMacro = referto.macro.some((m) => m.valore !== null);
+    expect(almenoUnMacro).toBe(true);
+  });
+});

vitest.config.ts

@@ -2,4 +2,14 @@ import { defineConfig } from 'vitest/config';
 
 export default defineConfig({
   test: { include: ['tests/**/*.test.ts'] },
+  resolve: {
+    alias: [
+      // src/middleware.ts importa da 'astro:middleware', un modulo virtuale che Astro
+      // risolve solo dentro la propria pipeline vite (dev/build), non sotto vitest puro.
+      // Stesso bersaglio che Astro stesso usa (node_modules/astro/dist/core/create-vite.js):
+      // defineMiddleware è identità (fn => fn), sequence è reale. Senza questo alias il
+      // middleware non è caricabile in isolamento e nessun test può importarlo davvero.
+      { find: 'astro:middleware', replacement: 'astro/virtual-modules/middleware.js' },
+    ],
+  },
 });