Files
ThothII/docs/adr/0001-postgres-metadata-catalog.md
T

22 lines
1.3 KiB
Markdown

# 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.