# Contesto di dominio di ThothII

## Workflow

**Workflow core** — La parte condivisa del workflow NL→SQL che governa la sequenza
delle fasi, il ciclo di vita delle sessioni, la revisione umana e la persistenza. Non è
un processo distinto né un sistema estensibile di plugin.

**Internal workflow module** — Un insieme coeso di comportamento e conoscenza di
dominio sviluppato e rilasciato insieme a ThothII. È isolato per rendere locali le
modifiche, non per essere caricato dinamicamente o sostituito da implementazioni esterne.

**Pi** — Il runtime agentico concreto usato da ThothII per le elaborazioni che
richiedono un modello. Segue le istruzioni del workflow e usa gli strumenti messi a
disposizione dai moduli interni.

**Admission** — Il controllo che stabilisce se una domanda può entrare nel workflow
NL→SQL oppure deve essere riformulata o rifiutata.

**Disambiguation** — La responsabilità di rendere esplicita e sottoporre a revisione
l’interpretazione di una domanda ambigua prima della generazione SQL.

**Evidence** — La conoscenza di dominio curata e citabile usata per fondare
l’interpretazione della domanda e le scelte effettuate durante il workflow.

**Memory** — La conoscenza riutilizzabile derivata da decisioni o sessioni precedenti e
resa disponibile alle elaborazioni successive.

**Datamart** — L’attività finale già esistente che gestisce l’eventuale produzione del
datamart dopo la generazione del SQL.

**Paused session** — Una sessione interrotta intenzionalmente ma resumibile. L’azione
“Stop and save” mette la sessione in pausa; non la completa e non la marca come fallita.

**Finalized session** — Una sessione completata che non accetta ulteriori modifiche al
proprio risultato.

**Workspace scope** — La dichiarazione di ciò che il database di un workspace
rappresenta e delle domande alle quali è destinato a rispondere.

## Catalogo dei metadati

**Workspace Database** — Il database associato a un workspace, considerato nella sua
interezza fisica: tutte le tabelle, le colonne e le relazioni disponibili, anche quando
solo un loro sottoinsieme è destinato al core di ThothII.

**Metadata Catalog** — Il contesto amministrativo che raccoglie e cura i metadati di un
Workspace Database. Non definisce quali elementi partecipano al workflow SQL.

**Database Profile** — L'insieme curato di scope, descrizioni e metadati semantici
associato a un Workspace Database.

**Generated comment** — Il testo descrittivo prodotto dall'AI per una tabella o una
colonna. Rimane distinto dalla descrizione finché l'utente non ne richiede la copia.

**Core Schema Selection** — Il sottoinsieme di tabelle, colonne e relazioni di un
Workspace Database reso disponibile al processo core di ThothII. È distinto dal
Workspace scope, che descrive il dominio e le domande ammesse.

**Publication** — Una versione approvata e immutabile dei contenuti del Metadata
Catalog resa disponibile ai suoi consumatori.