JL2 - Uno per uno JL2.1 - Dati aziendali (SIGEA2) In una frase. I Dati aziendali sono l'archivio dei dati veri dell'azienda: lo usano insieme SIGEAnext e l'ERP legacy/COBOL. È l'archivio che esisteva già prima di ADSWnext, ed è rimasto dov'era. Le pagine nuove sono state costruite sopra gli stessi dati del gestionale di sempre. Per questo si può passare al nuovo una funzione alla volta, senza fermare il lavoro. Cosa c'è dentro. Clienti, fornitori, articoli, ordini, movimenti di magazzino, mezzi. Le tabelle hanno i nomi brevi, in sigla, che hanno sempre avuto: chi conosce il gestionale li riconosce. Chi lo usa. SIGEAnext legge e scrive: quando salvi da una pagina nuova, il dato finisce qui. L'ERP legacy/COBOL legge e scrive, come sempre. La copia notturna per l'Assistente dei dati legge soltanto. Un esempio. Un collega inserisce un ordine da una maschera storica. Tu apri la pagina nuova degli ordini e lo trovi. Non c'è stato nessun passaggio di dati: avete guardato lo stesso archivio. Cosa non c'è dentro. Il disegno delle schermate, i cruscotti, i modelli di stampa. Stanno negli altri archivi, così i dati dell'azienda restano solo dati dell'azienda. La struttura non la tocca SIGEAnext. SIGEAnext non crea tabelle e non le modifica quando si accende. La forma dell'archivio resta quella del gestionale. Attenzione. Questi sono i dati veri. Una prova fatta collegandosi all'archivio sbagliato scrive dati veri. Per questo SIGEAnext non parte se non gli si dice in modo esplicito a quale archivio collegarsi. Per chi sviluppa. • Motore: Oracle o MySQL, si sceglie all'installazione (profili oracle e mysql di backend/business-logic/it_gsba_sigea_next ). • Tutti e due i profili hanno ddl-auto=none e il servizio non ha migrazioni. • Collegamento: SIGEA_DB_URL , SIGEA_DB_USER , SIGEA_DB_PASSWORD , senza valore predefinito. • Lo stesso archivio visto da SIGEAnext: libro JD - SIGEAnext, pagina «JD5.2 - I dati: SIGEA2». JL2.2 - Schermate salvate (ADENEXT2) In una frase. Le Schermate salvate sono l'archivio di ADEnext: conserva come sono fatte le schermate disegnate, i cruscotti di Analytics e i ruoli. Con ADEnext una schermata non si programma: si disegna. Il disegno deve restare scritto da qualche parte, altrimenti al riavvio sarebbe perso. Sta qui. Quando apri una pagina disegnata, ADEnext legge il disegno da questo archivio e la pagina si compone. Cosa c'è dentro. I disegni: moduli, tabelle, grafici, viste, e le loro versioni. I flussi e i punti di accesso ai dati, disegnati senza scrivere programmi. I cruscotti di Analytics e l'elenco delle sorgenti che si possono analizzare. I ruoli di ADEnext: quale ruolo dà quale livello. Il registro dei dati: la descrizione delle tabelle del gestionale, con nomi e significati dei campi. Cosa non c'è dentro. I dati dell'azienda. Qui c'è scritto che la tabella degli ordini ha una colonna «Cliente» larga così. Gli ordini stanno nei Dati aziendali. Chi lo usa. Solo ADEnext, con Analytics che ne fa parte. Legge e scrive. Cosa ci guadagni. Una schermata disegnata oggi vale per tutti, perché tutti leggono lo stesso disegno. E i disegni hanno un posto loro: si possono salvare e ripristinare senza toccare i dati dell'azienda. La struttura si aggiorna da sola. Quando esce una versione nuova di ADEnext, è il servizio che adegua l'archivio mentre si accende. Vedi Aggiornamenti dello schema . Per chi sviluppa. • Schema MySQL ADENEXT2 . Collegamento: ADE_DB_URL , ADE_DB_USER , ADE_DB_PASSWORD . • Tabelle principali: dynamic_form , dynamic_table , dynamic_chart , view , low_code_endpoint , low_code_flow , analysis_source , ruoli , ade_record . • Migrazioni in backend/middleware/it_gsba_ade_next/src/main/resources/db/migration . JL2.3 - Modelli di stampa (GPENEXT2) In una frase. I Modelli di stampa sono l'archivio di GPEnext: conserva i modelli dei documenti, le ditte e i loro loghi. Una fattura stampata è fatta di due cose: i dati di quella fattura e il modello che dice dove vanno, con quale carattere, con quale logo. I dati arrivano al momento della stampa. Il modello sta qui, pronto per la prossima. Cosa c'è dentro. I modelli dei documenti e le loro versioni di base. Le ditte, ognuna con il suo logo. Le immagini caricate: loghi e figure usate nei modelli. I profili di stampa attivi e i ruoli di GPEnext. I dati dell'installazione: nome dell'azienda e logo predefinito. Cosa non c'è dentro. I dati dell'azienda. GPEnext non ha un collegamento ai Dati aziendali: riceve i dati da stampare insieme alla richiesta e compone il documento. Chi lo usa. Solo GPEnext. Legge e scrive. Quando cambi un modello o carichi un logo, la modifica finisce qui. Cosa ci guadagni. Il logo di una ditta si carica una volta e sta in un posto solo. E i modelli hanno un archivio loro: si possono salvare e ripristinare senza muovere i dati dell'azienda. La struttura si aggiorna da sola. Come per ADEnext, è GPEnext che adegua l'archivio quando si accende con una versione nuova. Al primo avvio le tabelle le crea lui: chi installa prepara solo l'archivio vuoto. Per chi sviluppa. • Schema MySQL GPENEXT2 . Collegamento: GPE_DB_URL , GPE_DB_USER , GPE_DB_PASSWORD . Sul server, senza queste il servizio non parte. • Tabelle principali: templates , template_base_versions , ditte , images , installation , ruoli . • Migrazioni in backend/middleware/it_gsba_gpe_next/src/main/resources/db/migration-mysql . • Come si usano modelli e loghi: libro JK - GPEnext. JL2.4 - Dati spiegati (DB semantico) In una frase. I Dati spiegati sono una copia dei dati aziendali con nomi chiari, rifatta ogni notte: è l'unico archivio che l'Assistente dei dati legge. Le tabelle del gestionale hanno nomi in sigla e regole che conosce solo chi ci lavora da anni. Un'intelligenza artificiale che le leggesse così sbaglierebbe senza accorgersene. E non è prudente lasciarla lavorare sui dati veri. La soluzione è una copia fatta apposta: ordinata, con nomi in italiano, e separata. La copia notturna, passo per passo, e la domanda del giorno dopo Cosa c'è dentro. Tavole con nomi che si capiscono: articolo , fornitore , giacenza_giornaliera . Insieme ai dati c'è scritto cosa vuol dire ogni colonna, e fino a che data ogni tavola è caricata. Come si riempie. Ogni notte una copia automatica legge i Dati aziendali, senza scrivere niente. Tiene solo le righe che servono, dà i nomi chiari e scrive il risultato qui. Se non si sceglie un altro orario, parte alle 02:30. Chi lo usa. La copia notturna scrive. L'Assistente dei dati legge soltanto: non ha il permesso di modificare niente, nemmeno questa copia. Cosa ci guadagni. L'assistente non tocca mai i dati veri. E se la copia si rovina, si rifà dai Dati aziendali: non contiene niente che non si possa ricostruire. Nota. I dati sono quelli della notte prima. Per sapere com'è una cosa «adesso» vale la schermata del gestionale. Nota. L'Assistente dei dati si accende a parte, installazione per installazione. Dove è spento, questo archivio non c'è. Per chi sviluppa. • MySQL proprio dell'assistente, schema sigeagent . Tre utenti distinti: uno di sola lettura per l'assistente, uno per la copia, uno per il catalogo. • La copia è backend/middleware/sigeagent/etl . Legge SIGEA2 con la connessione di SIGEAnext, in transazioni di sola lettura. Orario: SIGEAGENT_ETL_ORA_NOTTURNA . • Accanto c'è lo schema sigeagent_catalogo : contiene lavoro fatto dalle persone e va salvato, perché la copia notturna non lo ricostruisce. • Come ragiona l'assistente: libro JJ - Strato agentico. Per approfondire. • Lo schema dei Dati spiegati: backend/middleware/sigeagent/docs/SCHEMA.md