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 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 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 Ho salvato da una maschera storica e nella pagina nuova non lo vedo. I dati sono gli stessi. Aggiorna la pagina: stai guardando un elenco caricato prima. L'Assistente dei dati non sa di un ordine inserito stamattina. È normale: legge la copia della notte prima. Per l'«adesso» apri la schermata del gestionale. L'assistente dichiara dati vecchi di più giorni. La copia notturna non è andata a buon fine. Avvisa chi gestisce il server. Una schermata disegnata non si apre, le altre pagine sì. È fermo ADEnext, o non raggiunge le Schermate salvate. I dati dell'azienda non c'entrano. La stampa esce senza logo. Il logo sta nei Modelli di stampa, legato alla ditta. Controlla la ditta in GPEnext: vedi il libro JK - GPEnext. Per chi gestisce il server Un servizio non parte dopo un aggiornamento. Guarda il suo registro: se una migrazione è fallita, lo dice lì, con il numero. GPEnext si riavvia di continuo. Manca il collegamento al suo archivio. Il resto di ADSWnext lavora lo stesso. SIGEAnext non parte. Controlla che gli sia stato detto a quale archivio collegarsi: non ha un valore predefinito, apposta. La copia notturna segna un gruppo di dati come «saltato». In quei Dati aziendali mancano le tabelle di partenza. Gli altri gruppi sono caricati. Devo ripristinare i Dati spiegati. Non serve un salvataggio: si rifanno lanciando la copia. Il catalogo dell'assistente invece va salvato. Parole da sapere Archivio. Il posto dove i dati restano scritti. Qui sono quattro. Dati aziendali. I dati veri dell'azienda, usati da SIGEAnext e dall'ERP legacy/COBOL. Schermate salvate. I disegni di ADEnext, i cruscotti di Analytics, i ruoli. Modelli di stampa. Modelli dei documenti, ditte e loghi di GPEnext. Dati spiegati. La copia notturna con nomi chiari, per l'Assistente dei dati. Schema. La forma di un archivio: tabelle e colonne. Migrazione. Un file numerato che cambia lo schema. Il servizio la applica quando si accende. Copia notturna. Il lavoro automatico che ogni notte riempie i Dati spiegati. Sola lettura. Il permesso di guardare senza poter cambiare. 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 .