feat: implement metadata catalog database management

CONTEXT.md

@@ -246,10 +246,23 @@ precedente o di un altro workspace.
 
 ## Catalogo dei metadati
 
-**Workspace Database** — Il database associato in modo uno-a-uno a un workspace,
-considerato nella sua interezza fisica: tutte le tabelle, le colonne e le relazioni
-disponibili. La sua struttura fisica viene acquisita interrogando il database; il
-Metadata Catalog non crea né possiede l'identità del workspace.
+**Workspace Database** — Il database che appartiene a un solo workspace e non può essere
+condiviso con altri workspace; un workspace può averne al massimo uno. È considerato nella
+coppia composta dal database PostgreSQL e da un solo schema: tutte le tabelle, le colonne e
+le relazioni catalogate appartengono a quello schema. Il Metadata Catalog conserva
+l'associazione, ma non crea né possiede l'identità del workspace.
+
+**Database Binding** — La configurazione specifica di un'installazione che seleziona un
+trasporto e fornisce i riferimenti necessari a raggiungere un Workspace Database. Non è una
+seconda identità del database e non viene condivisa automaticamente fra installazioni.
+
+**Thoth REST Connector** — Il trasporto REST tipizzato con cui ThothII interroga ed
+introspeziona un Workspace Database attraverso il contratto RPC DWH supportato. Non è un
+client configurabile per API REST arbitrarie.
+
+**Orphaned Workspace Database** — Un Workspace Database il cui workspace non è più presente
+nel catalogo autorevole. Rimane conservato per il recupero amministrativo, ma non può essere
+usato dal workflow finché non viene riassegnato a un workspace esistente.
 
 **Metadata Catalog** — Il contesto amministrativo che raccoglie e cura i metadati di un
 Workspace Database. Non definisce quali elementi partecipano al workflow SQL.
@@ -257,12 +270,61 @@ 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.
 
-**Physical Schema Snapshot** — L'inventario della struttura fisica osservata in un
-Workspace Database durante una specifica introspezione. Non è un progetto dello schema
-né un'autorizzazione a modificarne la struttura.
+**Physical Table** — Una tabella osservata nello schema esterno di un Workspace Database.
+La sua identità e il suo nome appartengono al database esterno, non al Metadata Catalog.
 
-**AI Proposal** — Un contenuto generato con l'ausilio dell'AI che non è ancora stato
-approvato come contenuto canonico.
+**Catalog Table** — La rappresentazione persistita di una Physical Table nel Metadata Catalog.
+La sua appartenenza e identità fisica derivano esclusivamente dall'introspezione; soltanto i suoi
+Catalog Metadata possono essere curati amministrativamente.
+_Avoid_: SqlTable, managed table
 
-**Publication** — Una versione approvata e immutabile dei contenuti del Metadata
-Catalog resa disponibile ai suoi consumatori.
+**Physical Column** — Una colonna osservata in una Physical Table, inclusi nome, posizione,
+tipo e appartenenza a chiavi dichiarate. La sua identità e i suoi fatti strutturali appartengono
+al database esterno.
+
+**Catalog Column** — La rappresentazione persistita di una Physical Column nel Metadata Catalog.
+I fatti osservati sono governati dalla sincronizzazione; Description e Generated Description
+sono metadati amministrativi modificabili.
+_Avoid_: SqlColumn, managed column
+
+**Physical Relationship** — Un vincolo foreign key dichiarato nel database esterno. La sua
+identità comprende il vincolo e la sequenza ordinata delle coppie di colonne che lo compongono.
+
+**Catalog Relationship** — La rappresentazione persistita di una Physical Relationship nel
+Metadata Catalog. È governata esclusivamente dall'introspezione e non è creata o modificata
+manualmente.
+_Avoid_: denormalized FK, relationship string
+
+**Logical Relationship** — Una relazione semantica curata o inferita che non corrisponde
+necessariamente a un vincolo fisico. Ha ownership e lifecycle distinti da Catalog Relationship.
+
+**Description** — Il testo curato e consolidato che descrive una Catalog Table o Catalog Column
+per gli usi downstream.
+
+**Generated Description** — Una proposta modificabile sottoposta a revisione umana prima di
+essere consolidata come Description. Rimane distinta dal commento osservato nel database.
+_Avoid_: generated comment, source comment
+
+**Table Synchronization** — La riconciliazione esplicita che rende le Catalog Table di un
+Workspace Database uguali alle Physical Table osservate: crea quelle nuove, aggiorna i metadati
+di origine ed elimina definitivamente quelle assenti. Non modifica mai il database esterno.
+_Avoid_: table import
+
+**Schema Synchronization** — La riconciliazione esplicita e autorevole di tabelle, colonne e
+Catalog Relationship di un Workspace Database. Può operare su uno scope specifico oppure su
+un unico snapshot completo tramite Synchronize All.
+
+**Catalog Sync Run** — L'esecuzione durevole in background di una Schema Synchronization, con
+scope, stato, avanzamento e log propri. Al massimo un run per Workspace Database può essere attivo.
+
+**Catalog Freshness** — La corrispondenza fra uno scope sincronizzato e la versione corrente
+della Database Binding. Uno scope rimane consultabile ma è stale finché non viene sincronizzato
+con la binding corrente.
+
+**Catalog Metadata** — I campi mutabili che descrivono database, tabelle, colonne e relazioni,
+distinti dai fatti strutturali governati dalla sincronizzazione. Possono essere popolati dall'AI,
+da un'importazione o da una modifica amministrativa senza cambiare il database esterno.
+
+**Introspection Capability** — Una categoria di struttura fisica che una Database Binding
+può osservare, come tabelle, colonne, relazioni, indici o enum. Una capability non disponibile
+è distinta da una capability osservata che non ha restituito elementi.