JL3.2 - Aggiornamenti dello schema

In una frase. Quando esce una versione nuova, ADEnext e GPEnext adeguano da soli il proprio archivio mentre si accendono; i Dati aziendali, invece, SIGEAnext non li modifica mai.

Lo «schema» è la forma di un archivio: quali tabelle ha, quali colonne. Una funzione nuova spesso ne chiede una in più. Se qualcuno dovesse aggiungerla a mano su ogni server, prima o poi un server resterebbe indietro. Per questo l'aggiornamento viaggia insieme al programma.

Come funziona. Ogni modifica alla forma dell'archivio è un piccolo file numerato, chiamato migrazione. Il servizio li porta con sé. Quando si accende, guarda nell'archivio quali sono già state applicate e applica solo quelle che mancano, in ordine. Poi comincia a rispondere.

ADEnext si accende, vede che manca una modifica e la applica

ADEnext si accende, vede che manca una modifica e la applica

Schermate salvate. Le aggiorna ADEnext all'avvio. Oggi le migrazioni sono una settantina: ognuna è un passo nella crescita del motore.

Modelli di stampa. Li aggiorna GPEnext all'avvio. Al primo avvio su un archivio vuoto crea tutte le tabelle.

Dati aziendali. Qui la regola è opposta. SIGEAnext non crea e non modifica tabelle: la forma dell'archivio resta quella del gestionale.

Dati spiegati. Non si aggiornano da soli all'avvio. Le tavole si creano una volta, con un comando. Le modifiche successive le applica chi gestisce il server, una alla volta, quando l'aggiornamento lo chiede.

Cosa ci guadagni. Dopo un aggiornamento di ADEnext o GPEnext non c'è niente da ricordare: programma e archivio sono alla stessa versione. E i dati dell'azienda non cambiano forma perché è uscita una pagina nuova.

Attenzione. Una migrazione già applicata non si corregge: se ne aggiunge una nuova. Un archivio che l'ha già eseguita non la esegue una seconda volta.

Per chi sviluppa.
• Lo strumento è Flyway. Cartelle: backend/middleware/it_gsba_ade_next/src/main/resources/db/migration e backend/middleware/it_gsba_gpe_next/src/main/resources/db/migration-mysql.
• ADEnext fa repair() prima di migrate() a ogni avvio, con la validazione accesa (ADE_FLYWAY_VALIDATE_ON_MIGRATE).
• SIGEAnext: ddl-auto=none, nessuna migrazione.
• Dati spiegati: file numerati in backend/middleware/sigeagent/sql, passi in devops/deploy/README.md.
• In questo repository una migrazione si crea o si modifica solo con il permesso esplicito di chi lavora.


Revisione #2
Creato 17 novembre 2026 08:00:46 da Giuseppe Anelli
Aggiornato 17 novembre 2026 09:38:43 da Genesys Software