feat(frontend): add database management surface

2026-08-26 18:00:47 +02:00
parent 11f78c4467
commit a701b19a03
8 changed files with 708 additions and 8 deletions
@@ -0,0 +1,21 @@
+# PostgreSQL come autorità dei metadati dei database dei workspace
+
+ThothII userà un Metadata Catalog PostgreSQL interno per conservare, per ogni workspace, la
+struttura fisica acquisita interrogando il relativo database e i metadati semantici generati con
+l'AI. Ogni workspace avrà un solo Workspace Database; identità e lista dei workspace resteranno
+autorevoli in `thoth-workspaces.yaml`, mentre il catalogo ne conserverà soltanto il riferimento
+stabile. `schema/annotations.yaml` verrà sostituito come input del core in uno step successivo;
+l'interfaccia e il lifecycle amministrativi resteranno separati dal workflow NL→SQL.
+
+## Considered Options
+
+- Conservare `annotations.yaml` come fonte di verità avrebbe mantenuto il revisionamento Git, ma
+  non avrebbe fornito il CRUD e il processo di introspezione/generazione richiesti.
+- Leggere metadati mutabili dal catalogo senza un confine esplicito avrebbe accoppiato il workflow
+  alla disponibilità del nuovo servizio e consentito viste parziali durante gli aggiornamenti.
+
+## Consequences
+
+PSD importerà le annotations esistenti; gli altri workspace genereranno i metadati da zero. Il
+cutover futuro dovrà sostituire consapevolmente i consumatori delle annotations e verificarne
+l'equivalenza semantica. Le sessioni di test esistenti non sono un vincolo di migrazione.