19 ottobre 2026 · V0.5

RICARDO — Guida operativa e verifica versione

Questa guida è inclusa nel progetto web. Il dossier PDF strategico aggiornato è fornito separatamente. La pubblicazione su Netlify non avviene automaticamente quando si scarica lo ZIP.

Verificare la versione effettivamente pubblicata

Aprire il sito RICARDO da browser.
Controllare la scritta V0.5 · Alert / Routes / Veicoli nella barra superiore.
In home deve essere visibile il riquadro Controllo agenda e percorsi — V0.5, con 4 pulsanti di prova.
Se manca la scritta V0.5, il sito non è stato aggiornato oppure viene mostrata una versione in cache: dopo un nuovo deploy usare ricarica forzata (Ctrl+F5) o riaprire la PWA.

Implementazioni richieste

Funzione	Dove si trova	Come verificarla
Titolo sintetico, categoria, luogo	Home → Prova «Dentista a Oria»	Anteprima «Dentista» · SALUTE · Oria (BR), data di domani alle 14:00; non salva automaticamente
Compatibilità e conflitti	Home → Prova alert; Agenda → Test alert	Rileva una sovrapposizione di 30 minuti, senza cambiare l'archivio
Google Routes	Home → Diagnosi Google Routes; Percorsi → 2 controlli	Prima verifica gratuita della Function; poi test reale Oria–Brindisi, potenzialmente a pagamento
Veicoli e costi	Home → I miei veicoli; Impostazioni → I miei veicoli; Percorsi → Stima costo auto	Aggiungere, modificare, eliminare, scegliere veicolo principale, inserire consumi e costi
Viste agenda	Agenda → Giorno, Settimana, Mese, Elenco	Controllare titolo, data, ora, categoria, luogo, eventuale stato del tragitto

Google Routes: attivazione necessaria

Google Routes non funziona caricando soltanto i file statici dello ZIP. È necessaria la pubblicazione della Netlify Function netlify/functions/routes.js, oltre alla variabile server GOOGLE_MAPS_API_KEY con Routes API attiva e fatturazione configurata. Non copiare la chiave dentro HTML/JS.

Google Cloud: abilitare Routes API nel progetto corretto, configurare una chiave limitata al servizio e un budget di controllo.
Netlify: Environment variables → GOOGLE_MAPS_API_KEY, scope Functions.
Ridistribuire da repository Git collegato oppure con Netlify CLI, dalla directory contenente netlify.toml e index.html.
In Percorsi eseguire «Verifica collegamento Netlify», poi «Test percorso reale Oria → Brindisi».

npx netlify-cli deploy --prod --dir=. --functions=netlify/functions

Stati diversi: la sovrapposizione degli orari funziona localmente; il tempo stradale non verificato resta giallo; un tempo Google verificato insufficiente è un trasferimento incompatibile; se è sufficiente compare compatibile.

Limiti dichiarati

Il traffico è valutato solo quando viene effettivamente chiamata la Routes API; non è previsto monitoraggio continuo a browser chiuso. L'apertura gratuita di Google Maps non equivale al calcolo API. Pedaggi, consumi e prezzi di carburante/energia vengono inseriti dall'utente.

Prima dell'aggiornamento

Esportare il backup JSON in Impostazioni → I tuoi dati. Il salvataggio degli eventi e dei veicoli è locale all'origine del sito. Non forzare download bloccati dall'antivirus; questa distribuzione non ha certificazione antivirus esterna.

← Torna a RICARDO V0.5