JL3 - Regole

JL3.1 - Chi legge e chi scrive

In una frase. Ogni archivio ha un solo servizio che lo scrive; l'unica eccezione, voluta, sono i Dati aziendali, scritti da SIGEAnext e dall'ERP legacy/COBOL.

Quando un dato è sbagliato, la prima domanda è: chi lo ha scritto? Se ogni archivio ha un solo padrone, la risposta è breve. È la regola che tiene in ordine tutto il resto.

Chi legge e chi scrive ciascun archivio

Chi legge e chi scrive ciascun archivio

Archivio Chi scrive Chi legge soltanto
Dati aziendali SIGEAnext, ERP legacy/COBOL La copia notturna
Schermate salvate ADEnext, con Analytics Nessuno
Modelli di stampa GPEnext Nessuno
Dati spiegati La copia notturna L'Assistente dei dati

Dati aziendali: due programmi, apposta. SIGEAnext e l'ERP legacy/COBOL scrivono le stesse tabelle. È ciò che permette di usare insieme pagine nuove e maschere storiche. Non ci sono due copie da tenere allineate.

Schermate salvate e Modelli di stampa: un padrone ciascuno. Se un cruscotto è cambiato, è passato da ADEnext. Se un modello è cambiato, è passato da GPEnext.

Dati spiegati: si scrive di notte, si legge di giorno. Li riempie solo la copia notturna. L'Assistente dei dati ha un permesso di sola lettura: anche volendo, non può modificare niente.

Le schermate disegnate e i dati aziendali. Una schermata disegnata con ADEnext mostra clienti e ordini, ma ADEnext non li va a prendere da solo. Li chiede a SIGEAnext, che li legge dai Dati aziendali e glieli passa.

E tu? Tu non scrivi mai in un archivio. Premi Salva su una pagina: la pagina chiede al servizio, il servizio controlla il tuo livello e scrive. I livelli sono spiegati nel libro JB - Accesso e permessi.

Per chi sviluppa.
• L'assistente si collega con un utente di database suo, che ha solo il permesso di lettura. La copia notturna apre su SIGEA2 solo transazioni di sola lettura.
• In produzione, per la copia notturna va usato un utente di sola lettura anche sui Dati aziendali: lo chiede devops/deploy/README.md.
• Solo chi disegna, nello Studio di ADEnext, può far leggere la struttura di un archivio (tabelle e colonne) per descriverla nel registro dei dati. ADE_DB_HOST_AMMESSI limita a quali archivi.
• GPEnext non ha variabili di collegamento a SIGEA2: riceve i dati da stampare con la richiesta.

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.

JL3.3 - Se qualcosa non va

In una frase. I problemi più comuni con gli archivi, come «vedo questo, faccio questo», e le parole da sapere.

Quasi sempre il problema non è l'archivio: è il servizio che non riesce a raggiungerlo. Sapere quale archivio serve a cosa aiuta a capire subito a chi chiedere.

Per chi usa il gestionale

Per chi gestisce il server

Parole da sapere

Per chi sviluppa. Variabili di collegamento e orari: docs/devops/ENVIRONMENT.md. Preparare gli archivi su un server, salvataggio e ripristino del catalogo: devops/deploy/README.md.