JA - ADSWnext in breve

La porta d'ingresso: cos'è, la mappa a strati, cosa succede quando lo usi.

Cosa ci guadagni. Chi arriva nuovo capisce il sistema in dieci minuti.

SCHEMA ANIMATO

PRESENTAZION POWER POINT

JA1 - Cos'è ADSWnext

JA1 - Cos'è ADSWnext

JA1.1 - In tre frasi

In una frase. ADSWnext è il gestionale SIGEA dentro il browser: funzioni nuove e funzioni storiche nella stessa finestra, con un solo accesso.

Dietro la pagina che apri lavorano tanti piccoli programmi, ognuno con un compito solo. Si chiamano servizi. Tu ne vedi uno solo: l'app web.

  1. Un solo ingresso. Entri una volta con utente e password. Da lì usi tutto, con i tuoi permessi.
  2. Nuovo e legacy insieme. Le funzioni riscritte (SIGEAnext) e quelle del programma COBOL (SBHweb) si aprono dallo stesso menu.
  3. Stampa e analisi ovunque. Su ogni tabella ci sono due pulsanti: uno fa il PDF, l'altro apre grafici e totali.
Un ingresso, due mondi, gli stessi dati: pagine nuove e pagine storiche lavorano sugli stessi dati aziendali

Un ingresso, due mondi, gli stessi dati: pagine nuove e pagine storiche lavorano sugli stessi dati aziendali

Cosa ci guadagni.
• Niente da installare sul computer: basta il browser, anche per le funzioni di sempre.
• Un solo utente e una sola password, con gli stessi permessi in tutti i programmi.
• Da ogni tabella nasce un PDF impaginato o un cruscotto, senza chiedere un report a nessuno.

Per chi sviluppa. L'app web è un'unica applicazione Angular (frontend/). I servizi sono moduli separati in backend/middleware/ e backend/business-logic/, ognuno con la sua porta. Le pagine nuove passano dal Gateway, le pagine storiche dal Ponte col COBOL.

JA1 - Cos'è ADSWnext

JA1.2 - La mappa a strati

In una frase. Tutto ADSWnext in un disegno solo, da leggere dall'alto in basso: in alto ci sei tu, in basso ci sono i dati.

Questa mappa torna in ogni libro della raccolta, con acceso solo il componente di cui si parla. Imparata qui, la riconosci dappertutto.

La mappa a strati di ADSWnext: tu e l'app web, l'ingresso, i servizi, gli archivi

La mappa a strati di ADSWnext: tu e l'app web, l'ingresso, i servizi, gli archivi

Come leggerla

Gli strati

Nota. In BookStack la mappa è un disegno draw.io: chi ha il permesso di modificare la pagina la apre e la cambia con un doppio clic.

Per chi sviluppa. La mappa nasce da docs/guide/adswnext/_strumenti/mappa-adswnext.json. Se cambia un servizio si corregge lì e si rigenerano tutti gli schemi della raccolta con schema.cjs --tutti.

JA1 - Cos'è ADSWnext

JA1.3 - Chi fa cosa

In una frase. L'elenco dei servizi di ADSWnext, gruppo per gruppo: nome, nome tecnico e cosa fa.

Serve quando senti un nome e vuoi sapere al volo di cosa si parla. Ogni servizio ha poi il suo libro.

L'ingresso

Fanno entrare le persone giuste e portano ogni richiesta al posto giusto.

Novità

Quello che è stato riscritto per il browser.

Gestionale storico

Il programma COBOL di sempre, che continua a funzionare.

Strato agentico

Risponde a domande sui dati scritte in italiano.

Gli archivi

Dove restano scritti i dati.

Per chi sviluppa. Dove sta il codice: Gateway backend/middleware/it_gsba_api_gateway, Monitor servizi backend/middleware/it_gsba_eureka_server, ERP nuovo backend/business-logic/it_gsba_sigea_next, Motore low-code backend/middleware/it_gsba_ade_next, Stampe backend/middleware/it_gsba_gpe_next, Ponte col COBOL backend/middleware/it_gsba_sbh_gateway, Macro/Workflow SBH backend/middleware/sbh-flow, Assistente dei dati backend/middleware/sigeagent.

JA2 - Cosa succede quando lo usi

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 - Cosa succede quando lo usi

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 - Cosa succede quando lo usi

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 - Cosa succede quando lo usi

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 - Cosa succede quando lo usi

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.

JA3 - Orientarsi

JA3 - Orientarsi

JA3.1 - A che punto siamo

In una frase. Cosa funziona già, cosa è scritto ma va ancora provato dal vivo, cosa manca. Stato al 17 novembre 2026.

Funziona

Visto funzionare.

Da provare dal vivo

Scritto e controllato, non ancora usato sul server vero.

Ancora da fare

Non c'è ancora.

Nota. Questa pagina invecchia in fretta. Quando cambia qualcosa si aggiorna la data in alto e si sposta la voce nel gruppo giusto. Ogni voce è spiegata nel libro del suo componente.

Per chi sviluppa. Lo stato di lavoro giorno per giorno è in docs/STATO.md. Gli avvisi per chi aggiorna il proprio ambiente sono in docs/AVVISI-SVILUPPATORI.md.

JA3 - Orientarsi

JA3.2 - Parole da sapere

In una frase. Le parole che tornano in tutta la raccolta, una riga ciascuna.

Ogni libro chiude con le parole del suo componente.

JA3 - Orientarsi

JA3.3 - Come leggere questa raccolta

In una frase. Come sono fatti i libri di ADSWnext, cosa vogliono dire i codici davanti ai titoli e come si leggono gli schemi.

Libri, capitoli, pagine

Ogni titolo comincia con un codice. Il codice dice il libro, il capitolo e la pagina, e tiene tutto nell'ordine in cui conviene leggere. Se cerchi una pagina di cui ti hanno detto il codice, scrivilo nella ricerca.

Ogni libro ha la stessa forma

  1. Si apre con «A cosa serve»: cosa fa il componente, cosa ci guadagni, dove sta nella mappa.
  2. In mezzo ci sono i capitoli su come si usa, con una schermata vera per ogni passo importante.
  3. Si chiude con «Se qualcosa non va» e con le parole da sapere.

In fondo alle pagine trovi due riquadri. «Per chi sviluppa» ha i dettagli tecnici: se non sei tecnico lo salti. «Per approfondire» dice quale guida più dettagliata esiste su quell'argomento.

Tre tipi di schema

La mappa con il componente acceso. È la mappa a strati con tutto spento tranne il componente del libro. Dice subito dove sei.

Esempio di «dove sta»: Gateway e Monitor servizi accesi sulla mappa

Esempio di «dove sta»: Gateway e Monitor servizi accesi sulla mappa

Chi parla con chi. Gli attori in alto, un passo per riga. Il numero dice l'ordine. La freccia tratteggiata è una risposta che torna indietro.

Esempio di «chi parla con chi»: entro e apro una pagina

Esempio di «chi parla con chi»: entro e apro una pagina

Blocchi e frecce. Per spiegare un meccanismo solo, senza il resto della mappa. Ne trovi uno in In tre frasi.

Nota. Gli schemi sono disegni draw.io. Chi ha il permesso di modificare la pagina li apre con un doppio clic, li cambia e li salva: non serve nessun altro programma.

Per chi sviluppa. La raccolta nasce dal repository, cartella docs/guide/adswnext. Le regole di scrittura sono in docs/guide/adswnext/STILE.md, i passi per pubblicare in docs/guide/adswnext/PUBBLICARE.md. Le guide tecniche di tutti i giorni restano in docs/guide.