Web app “Confronto Esami di Laboratorio”

La lettura dei referti di laboratorio richiede attenzione a tre elementi che spesso creano confusione: il valore misurato, l’unità di misura e l’intervallo di riferimento indicato dal laboratorio. Questa web app nasce per supportare un confronto rapido e ordinato tra i valori inseriti dall’utente e gli intervalli di riferimento presenti nel dataset di base, evidenziando in modo chiaro se un risultato risulta “in range” oppure “fuori range”, e indicando il tipo di scostamento (ad esempio “alto” o “basso”, “sopra soglia” o “sotto soglia”).

Lo strumento è pensato come supporto informativo e organizzativo: aiuta a ridurre errori di trascrizione, a riunire più risultati in una tabella unica e a produrre un documento Word stampabile o archiviabile.

Cosa fa concretamente

La web app consente di:

• Selezionare il test da un elenco (ricerca tramite digitazione) per ridurre ambiguità sul nome dell’analita.

• Inserire il risultato (numero oppure testo, ad esempio “Negativo/Positivo/Tracce”) e l’unità di misura riportata sul referto.

• Confrontare automaticamente il valore con l’intervallo di riferimento, quando questo è interpretabile in forma numerica:

  • intervalli tipo min–max

  • soglie tipo <, ≤, >, ≥

  • intervalli differenziati per sesso (quando presenti nel testo di riferimento)

• Evidenziare l’esito con tre stati:

  • Normale (valore entro range o conforme alla soglia)

  • Anomalo (valore fuori range)

  • Da verificare (intervallo testuale/complesso, unità non confrontabile, valore qualitativo non riconducibile a regola univoca)

• Specificare la tipologia di scostamento, ad esempio:

  • “Basso” / “Alto”

  • “Sotto soglia” / “Sopra soglia”

• Mostrare l’entità dello scostamento (quando applicabile), indicando:

  • delta rispetto al limite (Δ)

  • percentuale indicativa rispetto al limite

• Gestire valori qualitativi (dove il riferimento è “Negativo”, ecc.), classificando in modo prudente e segnalando quando è necessaria verifica manuale.

• Importare rapidamente liste di esami tramite incolla (righe con separatori TAB o “;”), riducendo i tempi di compilazione.

• Salvare e richiamare sessioni (ad esempio per date di prelievo diverse) direttamente nel browser tramite localStorage:

  • salva con nome e data

  • carica, elimina e esporta in Word anche una singola sessione

• Esportare in Word un documento con tabella completa, metadati e disclaimer, per archiviazione o condivisione controllata.

Come funziona il controllo “Normale/Anomalo”

La logica di confronto segue criteri semplici e trasparenti:

1. L’utente seleziona il test e inserisce il valore.

2. La web app identifica l’intervallo di riferimento associato al test nel dataset.

3. Se l’intervallo è numerico (min–max o soglia), il valore viene confrontato:

   • se è dentro range → Normale

   • se è fuori range → Anomalo (alto/basso)

4. Se l’intervallo è testuale o non traducibile in una regola numerica stabile (ad esempio indicazioni descrittive, dipendenza da condizioni cliniche, “dipende dal test”), l’esito viene marcato come Da verificare, mostrando comunque il testo di riferimento per il controllo manuale.

La tabella riporta anche la “regola usata” (quando disponibile), così l’utente può verificare esattamente quale criterio è stato applicato.

Procedura d’uso consigliata (passo-passo)

1) Accetta il disclaimer iniziale

All’apertura la web app mostra un disclaimer che deve essere accettato per proseguire. È una protezione fondamentale: chiarisce che il confronto è informativo e che la valutazione clinica resta di competenza sanitaria.

2) Imposta i parametri generali

• Seleziona sesso (utile per analiti con intervalli differenziati).

• Inserisci l’età se vuoi tenerla come metadato nel documento Word (non sempre l’intervallo è stratificato per età nel dataset).

3) Inserisci i risultati

Puoi farlo in due modi:

• Inserimento singolo: scegli test, scrivi valore e unità, poi “Aggiungi”.

• Incolla elenco: incolla più righe in formato tabellare (es. da Excel o da un appunto), poi “Importa righe”.

4) Verifica gli esiti

Per ogni riga controlla:

• esito (Normale/Anomalo/Da verificare)

• dettaglio (alto/basso, delta, note)

• testo integrale dell’intervallo (sempre visibile in tabella)

5) Salva una sessione

Se devi archiviare più prelievi:

• apri “Sessioni”

• inserisci nome e (se vuoi) data prelievo

• salva
  In questo modo puoi richiamare in seguito lo stesso set di dati senza reinserirli.

6) Esporta in Word

Clicca “Esporta Word” per generare un file .doc con:

• metadati principali

• tabella completa dei risultati

• regole utilizzate

• disclaimer di utilizzo

Punti di attenzione (importanti)

Per evitare interpretazioni errate, la web app mette in evidenza aspetti critici:

• Unità di misura: se l’unità inserita non corrisponde a quella dell’intervallo, la comparazione può essere non valida. Lo strumento può gestire alcune conversioni comuni solo in modo limitato e prudente.

• Intervalli variabili: molti analiti hanno range che dipendono da metodica, laboratorio, condizioni cliniche, età, gravidanza e terapia.

• Risultati qualitativi: “Negativo/Positivo/Tracce” richiedono particolare attenzione e spesso conferma sul referto originale.

• “Da verificare” non è un errore: indica che il dato non è automaticamente classificabile con affidabilità e va controllato manualmente.

Disclaimer e responsabilità d’uso

La web app è progettata come strumento di supporto informativo: non produce diagnosi, non sostituisce il referto del laboratorio e non sostituisce il parere medico. In presenza di valori anomali o sintomi, la valutazione deve essere affidata al professionista sanitario.

Questa web app è particolarmente utile per chi vuole:

• ordinare e confrontare rapidamente più analiti

• ridurre errori di trascrizione

• archiviare sessioni di esami nel tempo

• generare un documento Word pulito e riutilizzabile