# JC1 - A cosa servono

# JC1.1 - Una porta sola per tutto

**In una frase.** Il Gateway è l'unica porta da cui le pagine nuove chiedono i dati; il Monitor servizi è l'elenco che gli dice quali servizi sono accesi e dove stanno.

ADSWnext non è un programma solo. È fatto di più servizi, ognuno con il suo compito: uno tiene le schermate disegnate, uno i dati del gestionale, uno le stampe. Se ogni pagina dovesse sapere dove sta ogni servizio, e ogni servizio dovesse farsi da solo i controlli d'ingresso, basterebbe una dimenticanza per lasciare una porta aperta.

Per questo c'è una porta sola. Le pagine mandano ogni richiesta al **Gateway**. Lui controlla che tu sia entrato, guarda cosa stai chiedendo e la consegna al servizio giusto. Per sapere dove sta quel servizio consulta il **Monitor servizi**: un elenco che i servizi stessi tengono aggiornato, perché ognuno si iscrive quando si accende.

Tu non vedi niente di tutto questo. Vedi la pagina che si riempie.

<div drawio-diagram="2652"><img src="https://gsdoc.genesyssoftware.eu/uploads/images/drawio/2026-11/le-pagine-chiedono-tutto-a-una-porta-sola-il-gateway-controlla-e-smista-verso-i-servizi.png" alt="Le pagine chiedono tutto a una porta sola: il Gateway controlla e smista verso i servizi"/></div>

*Le pagine chiedono tutto a una porta sola: il Gateway controlla e smista verso i servizi*

<p class="callout success">**Cosa ci guadagni.**  
• **I controlli d'ingresso si fanno in un punto solo.** Chi non è entrato si ferma al Gateway e non arriva a nessun servizio. Una regola cambiata lì vale subito per tutti.  
• **Un servizio nuovo si aggiunge senza toccare gli altri.** Si accende, si iscrive al Monitor servizi, e al Gateway basta una riga che dice quali richieste sono sue. Le stampe di GPEnext sono entrate così.  
• **Se un servizio è spento, il resto lavora.** Ferme le stampe, le tabelle si aprono lo stesso. Dopo un aggiornamento ogni servizio torna disponibile da solo, appena si è iscritto di nuovo. </p>

Questo libro racconta il viaggio di una richiesta, come si guarda quali servizi sono accesi e cosa vogliono dire gli errori 401, 403 e 503.

<p class="callout info">**Per chi sviluppa.** Il Gateway è `backend/middleware/it_gsba_api_gateway` (Spring Cloud Gateway, porta 8080). Il Monitor servizi è `backend/middleware/it_gsba_eureka_server` (Eureka, porta 8761). Le rotte stanno in una classe sola, `GatewayConfig`.</p>

# JC1.2 - Dove stanno nella mappa

**In una frase.** Gateway e Monitor servizi stanno nello strato «Ingresso e controlli», fra le pagine che apri e i servizi che rispondono.

Sapere dove stanno aiuta a capire una cosa: i servizi non si chiamano dal browser. Dal browser si arriva solo al Gateway, e da lì si prosegue.

<div drawio-diagram="2653"><img src="https://gsdoc.genesyssoftware.eu/uploads/images/drawio/2026-11/la-mappa-di-adswnext-con-accesi-il-gateway-e-il-monitor-servizi.png" alt="La mappa di ADSWnext con accesi il Gateway e il Monitor servizi"/></div>

*La mappa di ADSWnext con accesi il Gateway e il Monitor servizi*

**Chi chiama il Gateway.** Le pagine nuove di SIGEAnext, per ogni cosa: aprire una tabella, salvare, stampare, analizzare. Le pagine storiche di SBHweb lo chiamano solo per la stampa in PDF; le maschere fanno un'altra strada, raccontata in [Le due strade: Gateway e Ponte col COBOL](https://gsdoc.genesyssoftware.eu/link/37803).

**Chi chiama lui.** I servizi delle Novità: ADEnext per le schermate disegnate e i cruscotti di Analytics, SIGEAnext per i dati del gestionale, GPEnext per le stampe. Dove è acceso, anche l'Assistente dei dati. Per controllare il tuo lasciapassare usa le chiavi dell'Accesso.

**Chi usa il Monitor servizi.** I servizi, che si iscrivono all'elenco quando si accendono. E il Gateway, che lo consulta per sapere a quale indirizzo inoltrare. Tu non lo usi mai direttamente: lo guarda solo chi gestisce il server.

**Cosa vuol dire per te.** Entri una volta e il controllo vale per tutti i servizi. Gli archivi non si raggiungono mai dal browser: in mezzo ci sono sempre il Gateway e un servizio.

<p class="callout info">**Per chi sviluppa.**  
• Tessere della mappa: `gateway` (porta 8080) e `eureka` (porta 8761).  
• Il Gateway non emette lasciapassare: li emette solo l'Accesso (Keycloak). Il Gateway li verifica.  
• Sul server le porte dei servizi interni e del Monitor servizi sono aperte solo dal server stesso. Da un altro PC si entra dall'app web e dal Gateway. </p>