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

![](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/logo-sigeanext.png)

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.

<div drawio-diagram="2610"><img src="https://gsdoc.genesyssoftware.eu/uploads/images/drawio/2026-11/un-ingresso-due-mondi-gli-stessi-dati-pagine-nuove-e-pagine-storiche-lavorano-sugli-stessi-dati-aziendali.png" alt="Un ingresso, due mondi, gli stessi dati: pagine nuove e pagine storiche lavorano sugli stessi dati aziendali"/></div>

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

<p class="callout success">**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. </p>

<p class="callout info">**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.</p>

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

<div drawio-diagram="2611"><img src="https://gsdoc.genesyssoftware.eu/uploads/images/drawio/2026-11/la-mappa-a-strati-di-adswnext-tu-e-lapp-web-lingresso-i-servizi-gli-archivi.png" alt="La mappa a strati di ADSWnext: tu e l&#039;app web, l&#039;ingresso, i servizi, gli archivi"/></div>

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

## Come leggerla

- **Ogni riquadro colorato è uno strato.** Dentro ci sono i servizi di quel gruppo.
- **Ogni tessera è un servizio.** Il nome è in grassetto. In piccolo c'è il nome tecnico. Sotto c'è cosa fa.
- **L'app web è una sola, con due parti.** Le pagine nuove passano dal Gateway. Le pagine storiche passano dal Ponte col COBOL, e dal Gateway solo per la stampa in PDF (la freccia più sottile).
- **Le frecce dicono chi chiama chi.**

## Gli strati

- **Tu e l'app web.** Tu, e la pagina che apri nel browser: pagine nuove e pagine storiche.
- **Ingresso e controlli.** Chi fa entrare le persone giuste e porta 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.** Chi risponde a domande sui dati scritte in italiano.
- **Archivi.** Dove restano scritti i dati.

<p class="callout info">**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.</p>

<p class="callout info">**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`.</p>

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

- **App web** (`frontend`), in uso. La pagina che apri nel browser. È una sola, con due parti: le pagine nuove (SIGEAnext) passano dal Gateway, quelle storiche (SBHweb) dal Ponte col COBOL.
- **Accesso** (`Keycloak`), in uso. Controlla utente e password e dice a quale livello appartieni: lettore, base, avanzato, staff.
- **Gateway** (`API gateway`), in uso. Ogni richiesta passa di qui: controlla che tu sia entrato e la manda al servizio giusto.
- **Monitor servizi** (`Eureka`), in uso. Tiene l'elenco dei servizi accesi, così il Gateway sa dove trovarli.

## Novità

Quello che è stato riscritto per il browser.

- **ERP nuovo** ![SIGEAnext](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/sigeanext.png), in uso. Le funzioni del gestionale riscritte. Dodici moduli: Gestione servizi, Management, Amministrazione, Adempimenti IVA, Finanza, Cespiti, Compensi a terzi, Contabilità analitica, Ciclo passivo, Produzione, Ciclo attivo, Magazzino.
- **Motore low-code** (`ADEnext`), in uso. Serve a costruire schermate, tabelle e cruscotti disegnandoli, senza scrivere programmi.
- **Stampe** (`GPEnext`), in uso da pochi giorni. Qui si disegnano i modelli dei documenti e si producono i PDF.
- **Analytics** (`analisi dei dati`), in uso. Numeri, grafici e cruscotti su ogni tabella, da salvare per sé o per l'azienda.

## Gestionale storico

Il programma COBOL di sempre, che continua a funzionare.

- **ERP legacy/COBOL** (`server COBOL`), esterno. Le funzioni non ancora riscritte girano qui, come hanno sempre fatto.
- **Ponte col COBOL** (`SBHgateway`), in uso. Porta le maschere del gestionale storico dentro il browser, senza il programma installato su ogni PC.
- **Macro/Workflow SBH** (`SBHflow`), in uso. Ripete da solo, all'ora stabilita, operazioni registrate sul gestionale storico.

## Strato agentico

Risponde a domande sui dati scritte in italiano.

- **Assistente dei dati** (`SigeAgent`), chat ancora da accendere. Gli chiedi «quanto abbiamo ordinato a quel fornitore?» e risponde con numeri, tabelle e grafici. Per ora conosce acquisti, ordini e giacenze.
- **Intelligenza artificiale** (`modello di AI`). Capisce la domanda e la trasforma in una ricerca precisa. Non vede i dati grezzi dell'azienda.

## Gli archivi

Dove restano scritti i dati.

- **Dati aziendali** (`SIGEA2`). Clienti, fornitori, ordini, magazzino: i dati veri dell'azienda. Li usano sia l'ERP nuovo sia quello legacy.
- **Schermate salvate** (`ADENEXT2`). I disegni di schermate e cruscotti, e chi può fare cosa.
- **Modelli di stampa** (`GPENEXT2`). I modelli dei documenti e i loghi delle ditte.
- **Dati spiegati** (`DB semantico`). Una copia dei dati aziendali con nomi chiari, fatta ogni notte per l'assistente.

<p class="callout info">**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`.</p>