netgescon-day0/docs/000-FILAMENT/11-ROLLOUT-ACQUA-DOCUMENTI-GOOGLE-MAIL.md

3.7 KiB
Executable File

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:

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