diff --git a/.gitattributes b/.gitattributes index 9cbe4cac..01fe6cec 100644 --- a/.gitattributes +++ b/.gitattributes @@ -9,4 +9,5 @@ Dockerfile* text eol=lf *.tsx text eol=lf *.py text eol=lf *.md text eol=lf +*.pptx binary *.ps1 text eol=crlf diff --git a/presentations/thothii-congresso.html b/presentations/thothii-congresso.html new file mode 100644 index 00000000..118bd0de --- /dev/null +++ b/presentations/thothii-congresso.html @@ -0,0 +1,784 @@ + + + + + +ThothII · Dal quesito clinico al dato tracciabile + + + + + + + +
+ + +
+
+
Congresso · Informatica clinica
+
ThothII
+

L'intelligenza artificiale propone. Il medico decide. + Ogni risposta è tracciata fino all'evidenza.

+
+ Dal linguaggio naturale all'SQL + Evidence curata + Umano nel ciclo +
+

Usa le frecce ← → per navigare

+
+
+ + +
+
+
02Il contesto
+
+
+

Il dato c'è. La domanda è fatta di parole.

+

I dati clinici vivono in un data warehouse, ma li + interroga solo chi scrive SQL. Ogni risposta ad hoc consuma il tempo di competenze + rare e non lascia traccia di come è stata costruita.

+
DWH clinico · Policlinico San Donato · aritmologia
+
+
+
+ 01 +

Il linguaggio è ambiguo

+

"Ricoveri nel 2023": anno solare o fiscale? Pazienti attivi o tutti? + Ogni parola nasconde una scelta clinica prima che tecnica.

+
+
+ 02 +

Il significato è locale

+

Le definizioni appartengono all'ospedale, non al dizionario: + cosa intende esattamente "fascia pediatrica" in questo dato?

+
+
+ 03 +

Un numero senza percorso non è evidenza

+

Una risposta che non si può verificare, ripetere e citare + non entra in una decisione clinica né in una ricerca.

+
+
+
+
+
+ + +
+
+
03Il principio
+

Il modello propone.
Il medico decide.

+

ThothII è un banco di lavoro clinico: trasforma una domanda + in linguaggio naturale in SQL verificato, fase dopo fase, con un revisore umano a ogni + passaggio decisivo. Il modello non ha mai l'ultima parola, e non può prendersela: + persino l'avanzamento di fase è un atto umano registrato.

+
+
La catena, in un rigo
+
+ Browser→ + Backend→ + Pi · agente→ + tht · workflow→ + DWH in sola lettura +
+

Nessuna scrittura sul magazzino dati: ThothII legge, propone e + documenta. Il risultato approvato può diventare un datamart, ma la fonte resta intoccata.

+
+
+
+ + +
+
+
04Il workflow
+

Otto fasi, uno stato che si calcola.

+
+
1

Chiarimento

+

il significato della domanda, un'ambiguità alla volta

+
2

Memoria

+

riuso della conoscenza già approvata in passato

+
3

Riscrittura

+

la domanda diventa esplicita e non ambigua

+
4

Schema linking

+

tabelle, colonne e join scelti sul catalogo

+
5

Sintesi

+

il piano di calcolo, definito prima del codice

+
6

CTE

+

ogni blocco viene testato sul dato reale

+
7

SQL finale

+

approvato dal revisore, poi eseguito

+
8

Datamart

+

export opzionale e promozione in memoria

+
+
+ § +
+

La fase corrente non è mai memorizzata: è calcolata.

+

Ripiegando il registro delle decisioni (review_decisions.jsonl) + il sistema ricava sempre lo stato vero. Riaprire una fase ricalcola tutto ciò che + viene dopo: le approvazioni diventate obsolete non contano più.

+
+
+
+
+ + +
+
+
05Disambiguazione
+

Una ambiguità alla volta,
con le conseguenze in vista.

+
+
+

Ogni proposta di interpretazione + porta con sé tutto il necessario per decidere: il significato attribuito alle parole, + le tabelle coinvolte, il filtro che ne deriva sul dato, l'evidenza che la sostiene + e il rischio residuo.

+

La scelta + consigliata non è mai pre-confermata. E esistono sempre le vie di uscita: + Altro, Torna indietro, Esci.

+

Ogni risposta diventa una + concept_clarified nel registro: la disambiguazione + non è una chiacchierata, è un atto documentato.

+
+ +
+
+
+ + +
+
+
06Evidence
+

La conoscenza clinica, curata e citabile.

+
+
Fontedocumento originale, immutato
+
Unità atomicheuna regola o definizione per unità
+
Manifestunità, fonte e impronta sha256
+
Validazionecontrolli che falliscono in chiuso
+
IndicizzazioneBM25 + vettori densi
+
Generazioniimmutabili, con puntatore ACTIVE
+
+
+
+
+

"La fascia pediatrica comprende i pazienti con età inferiore a 18 anni."

+

unità di evidence · fonte tracciata · sha256 verificato

+
+

Ciò che il modello + recupera sono candidati, non fatti: i valori vanno verificati + sul dato reale, e ogni uso di un'evidence va citato con la sua provenienza. Niente + entra nella base di conoscenza senza un curatore umano.

+
+
+
+
35
Unità approvate · PSD
+
60
In revisione del curatore
+
20/20
Accettazione retrieval · Hit@10
+
+
+
+
+
+ + +
+
+
07Metadati del DWH
+

Una fotografia versionata,
mai un bersaglio mobile.

+
+
+
+ DWH clinico · Policlinico San Donato + lo schema fiscale reale, letto una sola volta
+ ↓ snapshot +
+ Snapshot .tht-dwh · physical.yaml + catalogo preparato + firme LSH dei valori per la ricerca fuzzy
+ ↓ indici +
+ Indici ibridi Qdrant 1024 dim · BM25 + schema e memoria condividono il denso, l'evidence aggiunge il lessicale
+ ↓ uso +
+ Sessioni · workspace_revision bloccata + ogni domanda interroga una versione precisa dei metadati
+
+
+
+

Introspezione una volta sola

+

Il catalogo non viene interrogato a ogni domanda: si lavora su uno snapshot + preparato, veloce e stabile.

+
+
+

Generazioni immutabili

+

Ogni aggiornamento crea una nuova generazione con puntatore ACTIVE; le vecchie + restano leggibili.

+
+
+

Se l'impronta non torna, ci si ferma

+

La firma dell'owner viene verificata all'avvio: un ambiente che non corrisponde + fa fallire il sistema in chiuso, senza tentativi alla cieca.

+
+
+
+
+
+ + +
+
+
08Il dialogo umano-AI
+

Tre gesti per decidere.

+
+
+
reviewer_selectuna scelta
+

Il modello propone interpretazioni mutuamente esclusive, ognuna con significato, + filtro ed evidenza. La scelta è essa stessa la conferma: niente passaggi inutili.

+
+
+
reviewer_decidepiù scelte
+

Quando più letture sono legittime insieme, ogni voce selezionata è una decisione + distinta e registrata nel ledger.

+
+
+
reviewer_confirmun artefatto
+

Domanda riscritta, schema collegato, SQL finale: i prodotti del lavoro passano + da un gate esplicito prima di valere come verità della sessione.

+
+
+
+ § +
+

"Ciò che non è registrato non è accaduto."

+

Non esiste una trascrizione della conversazione: la verità di una sessione sono gli + artefatti su disco e il registro delle decisioni. Riprendere una sessione significa + rientrare nell'ultima fase incompleta, con tutto il filo ricostruibile. E un hook + anti-bypass impedisce al modello di avanzare da solo: la mano sul volante resta umana.

+
+
+
+
+ + +
+
+
09Una sessione reale
+

Da una domanda a 78 pazienti,
senza mai perdere il filo.

+
+
+
+
question.md · la domanda, riscritta e non ambigua
+
schema_linking.json · tabelle e join scelti
+
cte_plan.json · il piano, a blocchi verificabili
+
3 CTE testate · ognuna contro il dato reale
+
sql_final.sql · approvata al gate dal revisore
+
export · il risultato, con il suo percorso
+
+
+ 78 + pazienti restituiti da una sessione reale, + completata su tutti gli 8 passaggi +
+
+
+
+
Sola lettura sul magazzino + le credenziali di consultazione non scrivono mai sul DWH
+
Esecuzioni solo dall'elenco consentito + test CTE, explain, anteprima: massimo 10 righe, timeout a 30 secondi
+
Segreti fuori dal percorso + credenziali e configurazioni sensibili non vivono nel workspace
+
Cinque gate superati in questa sessione + ogni approvazione è una ricevuta nel registro delle decisioni
+
+
+
+
+
+ + +
+
+
10In sintesi
+

Proporre,
non decidere.

+
+
1 +

Il modello propone, il clinico decide.

+
2 +

Ciò che non è registrato non è accaduto.

+
3 +

Ogni numero cita la propria provenienza.

+
4 +

In caso di dubbio, il sistema si ferma.

+
+
+ ThothII + Dal quesito clinico al dato tracciabile + Grazie +
+
+
+ +
+ + + + + + + diff --git a/presentations/thothii-congresso.notes.json b/presentations/thothii-congresso.notes.json new file mode 100644 index 00000000..0d8cc533 --- /dev/null +++ b/presentations/thothii-congresso.notes.json @@ -0,0 +1,12 @@ +{ + "1": "Buongiorno. In dieci passaggi vi mostro come ThothII porta una domanda clinica fatta di parole fino al dato del warehouse, senza mai togliere la decisione al clinico. Tre parole chiave per oggi: proposte del modello, decisioni umane, evidenza citabile.", + "2": "Il dato esiste già: è il warehouse clinico del Policlinico San Donato, dominio aritmologia. Il problema non è il dato, è la domanda: \"ricoveri nel 2023\" nasconde scelte cliniche prima che tecniche. E una risposta senza percorso non è utilizzabile in clinica né in ricerca.", + "3": "Questa è l'idea centrale: il modello non è autonomo. Propone interpretazioni e calcoli, ma ogni passaggio decisivo passa da un revisore umano, e persino l'avanzamento di fase è un atto umano registrato. La catena termina sempre in lettura: nessuna scrittura sul warehouse.", + "4": "Otto fasi deterministiche, dal chiarimento del significato all'eventuale datamart. Il dettaglio che conta concettualmente: lo stato non è una variabile salvata, è ricalcolato dal registro delle decisioni. Riaprire una fase invalida tutto ciò che veniva dopo.", + "5": "Ecco come appare una scelta reale. Ogni opzione porta significato, filtro risultante sul dato, tabelle coinvolte ed evidenza a supporto: il medico decide sapendo cosa comporta. La voce consigliata non è mai pre-confermata, e esistono sempre le vie di uscita.", + "6": "La conoscenza locale diventa una collezione curata: unità atomiche con provenienza verificata, validazione che fallisce in chiuso, generazioni immutabili. Il modello può cercare nelle evidenze ma deve citarle, e i candidati vanno verificati sul dato reale. Nel PSD oggi: 35 unità approvate e retrieval 20 su 20.", + "7": "I metadati sono una fotografia versionata, presa una sola volta e firmata: se l'ambiente non corrisponde all'impronta, il sistema si ferma. Ogni sessione lavora su una revisione bloccata del catalogo, quindi domande ravvicinate interrogano lo stesso catalogo, non un bersaglio mobile.", + "8": "Tre soli gesti di revisione, così che l'interfaccia si impara in un attimo. Il punto concettuale è qui sotto: non esiste una trascrizione della conversazione, esistono artefatti e registro delle decisioni. È questo che rende una sessione riprendibile e verificabile a distanza di mesi.", + "9": "Una sessione reale completata su tutti gli otto passaggi: cinque gate approvati, tre CTE verificate sul dato, 78 pazienti restituiti. A destra le garanzie di contorno: sola lettura, esecuzioni limitate a un elenco consentito, segreti fuori dal percorso.", + "10": "Se dovete portarvi a casa una sola frase: ThothII propone, il clinico decide, e ogni numero porta con sé il proprio percorso. Grazie, e ora sono a disposizione per le domande." +} diff --git a/presentations/thothii-congresso.pptx b/presentations/thothii-congresso.pptx new file mode 100644 index 00000000..5a92e0b9 Binary files /dev/null and b/presentations/thothii-congresso.pptx differ