100 lines
3.7 KiB
Markdown
Executable File
100 lines
3.7 KiB
Markdown
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:
|
|
|
|
```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
|