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
This commit is contained in:
2026-08-22 15:17:47 +02:00
parent a56398ea02
commit 1d6bdd0b3d
14 changed files with 468 additions and 53 deletions
+13
View File
@@ -105,6 +105,19 @@ describe('anagrafica pseudonimizzata', () => {
// 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[] = [];
+52
View File
@@ -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);
});
});
+16
View File
@@ -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');
});
});
+66
View File
@@ -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["'`]/);
});
});
+100 -5
View File
@@ -1,9 +1,12 @@
import { describe, it, expect } from 'vitest';
import { readFileSync } from 'node:fs';
import { readFileSync, mkdtempSync, rmSync } from 'node:fs';
import { join } from 'node:path';
import { createLongevityDb } from '../../src/lib/longevity/db';
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:');
@@ -78,10 +81,102 @@ describe('il salvataggio, e il consenso', () => {
expect(note[0].testo).toMatch(/No/);
});
it('il codice cliente NON puo arrivare da chi chiama la pagina', () => {
// 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');
// 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/);
});
// 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 });
}
});
});
+25 -4
View File
@@ -1,6 +1,6 @@
// tests/longevity/referto.test.ts
import { describe, it, expect } from 'vitest';
import { readFileSync } from 'node:fs';
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';
@@ -59,6 +59,18 @@ describe('il referto del cliente', () => {
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')!;
@@ -95,9 +107,18 @@ describe('il referto del cliente', () => {
});
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);
// 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);
}
});
});
+60
View File
@@ -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);
});
});