JA2 - Cosa succede quando lo usi
- JA2.1 - Apro una pagina
- JA2.2 - Uso l'ERP legacy
- JA2.3 - Stampo un documento
- JA2.4 - Analizzo i dati
- JA2.5 - Chiedo all'assistente
JA2.1 - Apro una pagina
In una frase. Cosa succede, passo per passo, quando entri e apri l'anagrafica dei mezzi della flotta.
In meno di un secondo lavorano sei servizi. Tu vedi solo la pagina che si riempie.
Il percorso di «Apro una pagina» sulla mappa: in colore i servizi che lavorano
Entri con utente e password. Lo fai una volta sola: da qui in poi vale per tutto il gestionale.
Chi lavora: Tu → Accesso
La pagina di accesso
Apri una pagina. La pagina compare subito, ancora senza dati: li sta chiedendo. In alto a destra ci sono già i pulsanti di analisi e di stampa.
Chi lavora: Tu → Pagine nuove
L'anagrafica dei mezzi appena aperta
Il Gateway controlla chi sei. Ogni richiesta passa dal Gateway, che verifica che tu sia entrato davvero.
Chi lavora: Pagine nuove → Gateway → Accesso
Cerca chi deve rispondere. Chiede al Monitor servizi chi si occupa di quella pagina.
Chi lavora: Gateway → Monitor servizi
Il gestionale legge i dati. L'ERP nuovo prende i dati dall'archivio dell'azienda, solo quelli che puoi vedere. Lo decide il tuo livello. I livelli sono quattro: lettore, base, avanzato, staff. Sono uguali in tutti i servizi.
Chi lavora: Gateway → ERP nuovo → Dati aziendali
La pagina dei ruoli e dei permessi
I dati arrivano sulla pagina. La tabella si riempie.
Chi lavora: Dati aziendali → ERP nuovo → Gateway → Pagine nuove → Tu
Una tabella con i dati arrivati. Pagina di prova con dati finti
Per chi sviluppa. Il Gateway (backend/middleware/it_gsba_api_gateway, porta 8080) verifica il
token dell'accesso e instrada verso il servizio registrato nel Monitor servizi (porta 8761). L'ERP nuovo
è backend/business-logic/it_gsba_sigea_next (porta 5081).
Per approfondire.
• Login unico con Keycloak: docs/guide/amministrazione/login-unico-keycloak/README.md
• Ruoli e permessi: docs/guide/amministrazione/ruoli-e-permessi/README.md
JA2.2 - Uso l'ERP legacy
In una frase. Cosa succede quando apri «Condizioni di pagamento», una funzione che gira ancora sul programma COBOL.
La funzione è quella di sempre, con gli stessi controlli. Cambia solo dove la usi: nel browser, senza installare nulla.
Il percorso di «Uso l'ERP legacy» sulla mappa: in colore i servizi che lavorano
Apri il gestionale storico. Lo trovi nello stesso menu delle pagine nuove.
Chi lavora: Tu → Pagine storiche → Ponte col COBOL
Il menu del gestionale storico, nel browser
Scegli la funzione. Decidi cosa fare (inserire, modificare, consultare) e dove mandare la stampa.
Chi lavora: Tu → Pagine storiche → Ponte col COBOL
Il pannello di avvio della funzione
Il Ponte chiama il programma legacy. Gli parla nella sua lingua. Il programma legge gli stessi dati aziendali dell'ERP nuovo.
Chi lavora: Ponte col COBOL → ERP legacy/COBOL → Dati aziendali
La maschera arriva nel browser. È la stessa di sempre: stessi campi, stessi tasti funzione.
Chi lavora: ERP legacy/COBOL → Ponte col COBOL → Pagine storiche → Tu
La funzione com'era nel programma storico
Quello che scrivi torna al programma. I controlli li fa ancora il programma storico. Se preferisci, la vedi in una veste più moderna.
Chi lavora: Tu → Pagine storiche → Ponte col COBOL → ERP legacy/COBOL
La stessa funzione nella vista moderna
E di notte lavora da solo. Le operazioni ripetitive si possono registrare e far rifare a orario, senza nessuno davanti.
Chi lavora: Macro/Workflow SBH → ERP legacy/COBOL
Per chi sviluppa. Le pagine storiche sono frontend/sbh-web, il Ponte col COBOL è
backend/middleware/it_gsba_sbh_gateway (porta 5086), le Macro/Workflow SBH sono
backend/middleware/sbh-flow. Il programma COBOL resta sul suo server e non viene modificato.
Per approfondire.
• SBH — accesso e novita': docs/guide/moduli/sbh-accesso-e-novita/README.md
• Il client web del legacy SBH — menu e maschere: docs/guide/moduli/sbh-menu-e-maschere/README.md
JA2.3 - Stampo un documento
In una frase. Cosa succede quando stampi la situazione dei mezzi della flotta e la vuoi in PDF.
Il programma storico manda solo i dati. L'impaginazione la fa il servizio delle stampe, con un modello che si può ridisegnare senza toccare il programma.
Il percorso di «Stampo un documento» sulla mappa: in colore i servizi che lavorano
Scegli la stampa in PDF. Prima di avviare la funzione scegli l'uscita
GPE_NEXT_PDF. Va scelta ogni volta.Chi lavora: Tu → Pagine storiche → Ponte col COBOL
L'uscita GPE_NEXT_PDF nel pannello di avvio
Il gestionale prepara i dati. Il programma storico manda solo i dati del documento, senza impaginazione.
Chi lavora: ERP legacy/COBOL → Ponte col COBOL → Pagine storiche → Tu
I dati vanno al servizio delle stampe. Passano dal Gateway come ogni altra richiesta: vale il tuo accesso.
Chi lavora: Tu → Pagine storiche → Gateway → Stampe
Si prende il modello giusto. Ogni documento ha il suo modello, disegnato una volta: titolo, colonne, totali. Chi ha il permesso lo può modificare.
Chi lavora: Stampe → Modelli di stampa
Il modello «Mezzi flotta» nel designer
Nasce il PDF. Dati e modello vengono uniti e trasformati nel file.
Chi lavora: Modelli di stampa → Stampe
Il PDF si apre. Lo vedi subito, pronto da stampare o scaricare.
Chi lavora: Stampe → Gateway → Pagine storiche → Tu
Il PDF della situazione mezzi
Vale anche per una tabella qualsiasi. Da ogni tabella puoi creare un documento nuovo: nasce già impaginato. Logo, testata, righe e totali sono messi in automatico.
Chi lavora: Tu → Pagine nuove → Gateway → Stampe
Un documento nato da una schermata. Documento di prova con dati finti
Per chi sviluppa. Il servizio delle stampe è backend/middleware/it_gsba_gpe_next, il designer dei
modelli è frontend/gpe-next. Il PDF lo produce direttamente il servizio delle stampe.
Per approfondire.
• Stampare in PDF con GPE-NEXT dalla sessione SBH: docs/guide/moduli/sbh-stampa-gpe-next/README.md
• Il designer di GPE-NEXT: elenco dei modelli e foglio: docs/guide/gpe-next/designer/README.md
JA2.4 - Analizzo i dati
In una frase. Cosa succede quando vuoi capire a colpo d'occhio i chilometri dei mezzi della flotta.
Non serve chiedere un report: i dati sono quelli che hai già davanti, e i grafici arrivano con un clic.
Il percorso di «Analizzo i dati» sulla mappa: in colore i servizi che lavorano
Premi «Analisi» su una tabella. Il pulsante c'è su ogni tabella. I dati sono quelli che hai già davanti.
Chi lavora: solo il tuo browser
Il pulsante «Analisi» sopra la tabella. Pagina di prova con dati finti
Si cerca un cruscotto già pronto. Se tu o la tua azienda ne avete salvato uno per quella tabella, si apre quello.
Chi lavora: Tu → Pagine nuove → Gateway → Analytics → Schermate salvate
Compaiono numeri e grafici. I calcoli si fanno direttamente nel browser, quindi sono immediati.
Chi lavora: Schermate salvate → Analytics → Gateway → Pagine nuove → Tu
Mezzi flotta: chilometri previsti, percorsi, rimanenti
Lo sistemi e lo salvi. Sposti i riquadri, aggiungi un grafico, poi lo salvi per te o per tutta l'azienda.
Chi lavora: Tu → Pagine nuove → Gateway → Analytics → Schermate salvate
Lo stesso cruscotto in modifica
Per chi sviluppa. L'analisi gira nel browser: il codice è in frontend/core/src/analisi e
frontend/ade-next/src/runtime/analisi. I cruscotti salvati stanno nell'archivio delle schermate
(ADENEXT2).
Per approfondire.
• Analisi dei dati: docs/guide/viste/analisi-dei-dati/README.md
JA2.5 - Chiedo all'assistente
In una frase. Cosa succede quando chiedi «quanto abbiamo ordinato a quel fornitore quest'anno?».
Chi non sa usare un database ottiene un numero, una tabella e un grafico. L'assistente legge soltanto: non può cambiare nessun dato.
Attenzione. La chat è ancora da accendere. I dati che l'assistente conosce ci sono già.
Il percorso di «Chiedo all'assistente» sulla mappa: in colore i servizi che lavorano
Ogni notte i dati vengono preparati. I dati aziendali vengono copiati in un archivio con nomi chiari, che l'assistente capisce. Ogni tessera è un argomento: articoli, fornitori, ordini.
Chi lavora: Dati aziendali → Dati spiegati
L'elenco di quello che l'assistente conosce
Scrivi la domanda. In italiano, come la faresti a un collega.
Chi lavora: Tu → Pagine nuove → Gateway → Assistente dei dati
L'intelligenza artificiale capisce la domanda. La trasforma in una ricerca precisa. Non vede i dati grezzi dell'azienda.
Chi lavora: Assistente dei dati → Intelligenza artificiale → Assistente dei dati
L'assistente cerca la risposta. Legge soltanto.
Chi lavora: Assistente dei dati → Dati spiegati → Assistente dei dati
Arriva la risposta. Un testo, una tabella e, se serve, un grafico.
Chi lavora: Assistente dei dati → Gateway → Pagine nuove → Tu
Per chi sviluppa. L'assistente è backend/middleware/sigeagent: la copia notturna, il catalogo dei
significati e la chat. Lo Studio del catalogo è in frontend/ade-next/src/studio/catalogo-semantico.