JL1 - A cosa servono JL1.1 - Quattro archivi, quattro compiti In una frase. ADSWnext tiene i dati in quattro archivi separati: ognuno conserva una cosa sola e ha un servizio che se ne occupa. Un archivio è il posto dove i dati restano scritti quando spegni il computer. In ADSWnext non ce n'è uno solo dove finisce tutto. Ce ne sono quattro, e ognuno ha un compito preciso. Così, quando cerchi una cosa, sai già dove sta. Dati aziendali. I dati veri dell'azienda: clienti, fornitori, ordini, magazzino. Li usa SIGEAnext e li usa l'ERP legacy/COBOL. Sono gli stessi dati, non due copie. Schermate salvate. Come sono fatte le schermate disegnate con ADEnext, i cruscotti di Analytics e i ruoli. Qui non c'è nemmeno una fattura: c'è il disegno della pagina che la mostra. Modelli di stampa. I modelli dei documenti di GPEnext, le ditte e i loro loghi. Dati spiegati. Una copia riordinata dei dati aziendali, con nomi chiari, rifatta ogni notte. Serve solo all'Assistente dei dati. Quattro archivi, quattro compiti: ogni archivio ha il servizio che lo usa Cosa ci guadagni. • Sai sempre dov'è un dato e chi lo può cambiare. Un ordine sta nei Dati aziendali. Il disegno di una schermata sta nelle Schermate salvate. Un modello di fattura sta nei Modelli di stampa. Ogni archivio lo scrive solo il suo servizio. • ERP nuovo e legacy lavorano sugli stessi dati. Un ordine inserito da una maschera storica si vede nella pagina nuova, e viceversa. Non c'è una copia da allineare e non c'è un passaggio di dati da fare prima di cominciare. • I dati per l'intelligenza artificiale sono separati da quelli veri. L'Assistente dei dati legge solo la copia notturna, e non la può modificare. Qualunque domanda tu faccia, i dati dell'azienda non cambiano. Questo libro presenta gli archivi uno per uno, poi le regole: chi legge, chi scrive, e come si aggiorna la struttura di un archivio quando esce una versione nuova. Per chi sviluppa. • I nomi tecnici sono SIGEA2, ADENEXT2, GPENEXT2 e il DB semantico ( sigeagent ). • SIGEA2 sta su Oracle o su MySQL, secondo l'installazione. Gli altri tre sono MySQL. • Ogni servizio ha le sue variabili di collegamento: SIGEA_DB_* , ADE_DB_* , GPE_DB_* , SIGEAGENT_DB_* . Il registro è docs/devops/ENVIRONMENT.md . JL1.2 - Dove stanno nella mappa In una frase. Gli Archivi sono lo strato più in basso della mappa: sotto i servizi, lontano dal browser. La posizione dice già la regola più importante. Dal browser non si arriva mai a un archivio. In mezzo ci sono sempre il Gateway, che controlla chi sei, e un servizio, che decide cosa puoi leggere e cosa puoi cambiare. La mappa di ADSWnext con accesi i quattro archivi Chi usa gli archivi. Ogni archivio ha sopra di sé il suo servizio. GPEnext usa i Modelli di stampa. ADEnext e Analytics usano le Schermate salvate. SIGEAnext usa i Dati aziendali. L'Assistente dei dati usa i Dati spiegati. L'archivio con due ingressi. Ai Dati aziendali arriva anche una freccia dal Gestionale storico: l'ERP legacy/COBOL legge e scrive lì, come ha sempre fatto. È l'unico archivio usato da due programmi. La freccia lunga in basso. Va dai Dati aziendali ai Dati spiegati. È la copia notturna: ogni notte i dati vengono letti, riordinati e scritti con nomi chiari per l'assistente. Va in una direzione sola. Cosa vuol dire per te. Tu lavori sempre da una pagina. La pagina chiede al servizio, il servizio parla con il suo archivio. Nessuno apre un archivio direttamente per lavorare. Per chi sviluppa. • Tessere della mappa: gpedb , adedb , sigeadb , agentdb . • Le schermate disegnate con ADEnext mostrano dati aziendali, ma non li leggono da sole: li chiedono a SIGEAnext ( docs/low-code/entita-runtime.md ). • I Dati spiegati stanno su un MySQL a parte, che parte insieme all'Assistente dei dati e non pubblica porte all'esterno.