# JC4.1 - Aggiungere una rotta

**In una frase.** Per far arrivare le richieste a un servizio nuovo basta una rotta nel Gateway: gli altri servizi non si toccano.

Una **rotta** è una riga che dice: le richieste che cominciano così vanno a quel servizio. Stanno tutte in una classe sola, quindi chi vuole sapere cosa è raggiungibile da fuori guarda in un posto solo. Aggiungerne una vuol dire copiare quelle che ci sono.

1. **Dai un nome al servizio.** È il nome con cui si iscrive al Monitor servizi: tutto maiuscolo, con i trattini, per esempio `NUOVO-SERVICE`. Sta in `spring.application.name` del servizio.
2. **Aggiungi la rotta nel Gateway.** Apri `GatewayConfig` e copia una rotta esistente. Cambiano tre cose: il nome della rotta (`nuovo-service`), l'inizio dell'indirizzo (`/api/nuovo/**`) e la destinazione (`lb://NUOVO-SERVICE`). Restano uguali `stripPrefix(2)` e il filtro `authenticationFilter`: vanno messi sempre.
3. **Nel servizio non ripetere l'inizio dell'indirizzo.** Il Gateway toglie `/api/nuovo` prima di inoltrare. Se la pagina chiama `/api/nuovo/clienti`, il servizio riceve `/clienti`.
4. **Fai controllare il lasciapassare anche al servizio.** Prendi come modello la `SecurityConfig` di un servizio esistente. Il nome utente lo leggi dall'intestazione `X-User-Id`, che scrive il Gateway.
5. **Ricostruisci e riavvia solo il Gateway.** I servizi già accesi non vanno fermati.
6. **Prova.** Chiama `/api/nuovo/...` dall'app. Un 503 vuol dire che il servizio non è ancora iscritto al Monitor servizi. Un 404 vuol dire che la rotta c'è ma il servizio non ha quell'indirizzo.
7. **Aggiorna la tabella delle rotte** in `docs/architettura/riferimento/ARCHITETTURA-MICROSERVIZI.md`.

Il server web dell'app non va toccato: manda già al Gateway tutto ciò che comincia per `/api/`. Serve una regola in più solo per i collegamenti che restano aperti a lungo.

<p class="callout warning">**Attenzione.**  
• Con un numero diverso da 2 in `stripPrefix` il servizio riceve indirizzi sbagliati.  
• Senza `authenticationFilter` il servizio non riceve il nome utente, e chi chiama potrebbe scriverne uno a piacere.  
• Un servizio raggiungibile senza passare dal Gateway non può fidarsi di `X-User-Id`. </p>

<p class="callout info">**Per chi sviluppa.**  
• File: `backend/middleware/it_gsba_api_gateway/src/main/java/it/gsba/api_gateway/config/GatewayConfig.java`.  
• Verifica: nella cartella del Gateway `./mvnw -o clean package -DskipTests`, vale solo `BUILD SUCCESS`.  
• Anche in sviluppo l'app manda già al Gateway tutto ciò che comincia per `/api`.  
• Prima di cambiare le regole di sicurezza del Gateway si dice cosa cambia e perché: una modifica piccola può spegnere i controlli. </p>