motore: chiude i tre buchi laterali della barriera dell'insufficiente

- eta_alla_data NULL non usa più il ripiego a zero: senza età la
  Fitness Age è null, non un'età di forma negativa dichiarata valida.
  Gli assi e i macro-score restano calcolabili (non dipendono dall'età).
- applicaCurva valida i parametri richiesti da ciascuna curva prima di
  applicarla: un registro con params vuoti/incompleti dà null, mai il
  punteggio pieno che dava lerp con estremi indefiniti.
- calcolaSessione esclude le misure fuori_range=1 (§9 della spec): non
  entrano nello score finché non esiste la colonna di conferma (§12,
  punto aperto).
- leggiScore(db, sessioneId): legge la tabella score ritipata come
  Punteggio, con l'ultimo calcolo per tipo+elemento esplicito nella
  query (MAX(id)), non l'ordine naturale delle righe — salvaScore non
  sovrascrive di proposito (la storia degli score si tiene, discende
  dal congelamento della §6).
- documentata la seconda divergenza dall'oracolo, mai scritta finora:
  la Fitness Age esclude gli assi insufficienti, l'oracolo li include
  comunque. Comportamento giusto, ma cambia il numero (25,0 contro
  34,8 sullo stesso profilo parziale).
- nuovo test che prova che i pesi di due model_version diverse restano
  separati (pesiDi filtra su model_version, non li fonde).

Ogni fix verificato in TDD (test rosso prima, verde dopo) e ri-rotto a
mano per confermare che discrimina davvero (vedi report).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XhLbMQ1q7wHwJSykgXRwQF
This commit is contained in:
2026-08-22 10:49:25 +02:00
parent c4524e3a73
commit 469251366e
3 changed files with 312 additions and 14 deletions
+170 -1
View File
@@ -2,7 +2,9 @@ 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';
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:');
@@ -76,6 +78,27 @@ describe('il motore legge le curve dal registro', () => {
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
@@ -133,4 +156,150 @@ describe('calcolo e congelamento di una sessione', () => {
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);
}
});
});