# Rollout acqua, documenti, Google e posta

Data riferimento: 2026-05-05.

## Modifiche operative appena consolidate

### Acqua / fatture elettroniche

- nella vista `Servizi / Utenze` il riferimento operativo viene mostrato una sola volta come `CBILL`
- il valore mostrato usa il fallback gia presente: prima `pagamento_cbill`, altrimenti `pagamento_codice_avviso`
- la tabella e stata resa piu flessibile per ridurre la barra di scorrimento orizzontale in basso

### Archivio / lettore codici

- il tab `Scansione documenti` e stato rinominato `Acquisizione Documenti`
- il box `Nuova acquisizione scanner` e stato rinominato `Nuova acquisizione`
- il pulsante `Acquisisci documento scanner` e stato rinominato `Acquisisci documento`
- nel pannello del lettore codici viene mostrato anche il `Testo etichetta archivio`, cioe il testo umano realmente associato al nodo archivistico selezionato

### Etichette e catena archivistica

- il modello etichetta operativo resta `11354`
- la catena da mantenere come riferimento e: `documento -> faldone -> contenitore`
- il protocollo deve essere assegnato il prima possibile, gia in fase di acquisizione/stampa del documento

## Collaudo funzionale minimo

1. Aprire `Servizi / Utenze` e verificare che la FE mostri `CBILL` una sola volta.
2. Verificare che la pagina non richieda piu scorrimento orizzontale per i casi standard.
3. Aprire `Acquisizione Documenti` e verificare testi e pulsanti aggiornati.
4. Fare una scansione sul lettore fisso e controllare che il pannello mostri il vero testo etichetta archivio.
5. Verificare che i documenti acquisiti mantengano modello etichetta `11354` e catena archivistica corretta.

## Google: cosa serve per l'abilitazione del sito definitivo

Il codice applicativo e gia predisposto a leggere:

- `GOOGLE_CLIENT_ID`
- `GOOGLE_CLIENT_SECRET`
- `GOOGLE_REDIRECT_URI`

Queste variabili sono lette da `config/services.php`.

Passi pratici da fare lato account/dominio:

1. scegliere il dominio definitivo del sito
2. verificare il dominio su Google Search Console o sulla piattaforma indicata da Google Cloud
3. creare o riusare un progetto Google Cloud dedicato a NetGescon
4. configurare la schermata consenso OAuth
5. aggiungere il dominio tra gli `Authorized domains`
6. creare credenziali `OAuth Client ID` di tipo web
7. registrare la `redirect URI` reale del sito definitivo

Checklist redirect da predisporre:

- `APP_URL=https://dominio-definitivo`
- `GOOGLE_REDIRECT_URI=https://dominio-definitivo/...`
- nessun redirect OAuth deve puntare a host locali o IP temporanei quando si passa in produzione

## Posta ufficiale: cosa serve per spedire dal sito

Per l'invio dal sito ufficiale non va usato `mailhog`.

Servono:

1. una casella reale sul dominio ufficiale, ad esempio `noreply@dominio.it` o `info@dominio.it`
2. DNS completi:
   - SPF
   - DKIM
   - DMARC
3. credenziali SMTP o relay del provider scelto
4. impostazione in ambiente di produzione delle variabili Laravel mail

Variabili da valorizzare in produzione:

```dotenv
MAIL_MAILER=smtp
MAIL_HOST=smtp.provider.tld
MAIL_PORT=587
MAIL_USERNAME=noreply@dominio.it
MAIL_PASSWORD=...
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=noreply@dominio.it
MAIL_FROM_NAME=NetGescon
MAIL_EHLO_DOMAIN=dominio.it
```

## Strategia consigliata per partire senza blocchi

1. in locale/staging continuare con `mailhog`
2. sul dominio definitivo attivare prima Google OAuth e DNS del dominio
3. poi passare l'invio SMTP reale in ambiente di produzione
4. solo dopo il collaudo dei record SPF/DKIM/DMARC usare il sito per invii verso destinatari esterni

## Stato attuale

- applicativo pronto per test Docker contro dati esistenti
- configurazione Google predisposta ma non ancora autorizzata sul dominio definitivo
- invio posta ufficiale non ancora attivo per mancanza di credenziali e DNS finali