JA2 - Cosa succede quando lo usi

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

Il percorso di «Apro una pagina» sulla mappa: in colore i servizi che lavorano

  1. 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

    La pagina di accesso

  2. 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

    L'anagrafica dei mezzi appena aperta

  3. Il Gateway controlla chi sei. Ogni richiesta passa dal Gateway, che verifica che tu sia entrato davvero.

    Chi lavora: Pagine nuove → Gateway → Accesso

  4. Cerca chi deve rispondere. Chiede al Monitor servizi chi si occupa di quella pagina.

    Chi lavora: Gateway → Monitor servizi

  5. 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

    La pagina dei ruoli e dei permessi

  6. 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

    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

Il percorso di «Uso l'ERP legacy» sulla mappa: in colore i servizi che lavorano

  1. 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

    Il menu del gestionale storico, nel browser

  2. 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 pannello di avvio della funzione

  3. 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

  4. 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

    La funzione com'era nel programma storico

  5. 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

    La stessa funzione nella vista moderna

  6. 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

Il percorso di «Stampo un documento» sulla mappa: in colore i servizi che lavorano

  1. 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

    L'uscita GPE_NEXT_PDF nel pannello di avvio

  2. 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

  3. 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

  4. 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

    Il modello «Mezzi flotta» nel designer

  5. Nasce il PDF. Dati e modello vengono uniti e trasformati nel file.

    Chi lavora: Modelli di stampa → Stampe

  6. Il PDF si apre. Lo vedi subito, pronto da stampare o scaricare.

    Chi lavora: Stampe → Gateway → Pagine storiche → Tu

    Il PDF della situazione mezzi

    Il PDF della situazione mezzi

  7. 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

    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

Il percorso di «Analizzo i dati» sulla mappa: in colore i servizi che lavorano

  1. 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

    Il pulsante «Analisi» sopra la tabella. Pagina di prova con dati finti

  2. 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

  3. 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

    Mezzi flotta: chilometri previsti, percorsi, rimanenti

  4. 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

    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

Il percorso di «Chiedo all'assistente» sulla mappa: in colore i servizi che lavorano

  1. 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

    L'elenco di quello che l'assistente conosce

  2. Scrivi la domanda. In italiano, come la faresti a un collega.

    Chi lavora: Tu → Pagine nuove → Gateway → Assistente dei dati

  3. 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

  4. L'assistente cerca la risposta. Legge soltanto.

    Chi lavora: Assistente dei dati → Dati spiegati → Assistente dei dati

  5. 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.