Il Cruscotto San Vincenzo è un sito ufficiale del Comune?

No. È un progetto indipendente e non ufficiale, non affiliato ad AgID, al Governo italiano o al Comune di San Vincenzo. Aggrega dati pubblici aperti.

Da dove arrivano i dati?

La fonte principale è Cruscotto Italia (AgID), via MCP. Altre fonti (meteo, trasporti, ARPAT, mappe, MIUR) arrivano da API pubbliche dedicate, in sola lettura.

Serve un account o un database?

No. Il cruscotto è solo lettura: nessun database proprio e nessuna autenticazione obbligatoria. Le route /api/* fanno da proxy e cache.

Come funziona il Cruscotto San Vincenzo

Name: Cruscotto Italia (AgID)
Creator: AgID
License: https://creativecommons.org/licenses/by/4.0/

Come i dati aperti diventano la dashboard di San Vincenzo: stack, proxy API e moduli opzionali.

Come funziona

Architettura, stack tecnologico e flusso operativo del Cruscotto San Vincenzo: come i dati aperti diventano la dashboard che vedi.

In sintesi

Il cruscotto è un'applicazione solo lettura: non ha database proprio, né autenticazione obbligatoria. Aggrega dati pubblici del Comune di San Vincenzo (codice ISTAT 049018) e li presenta in sezioni tematiche. La fonte principale è Cruscotto Italia (AgID), raggiungibile via MCP; altre fonti (meteo, trasporti, ARPAT, mappe) arrivano da API dedicate.

Realizzato da Alessandro Cipriani. Progetto indipendente e non ufficiale — vedi anche le attribuzioni e regole.

Flusso operativo

Dal dato pubblico alla schermata: quattro passaggi, tutti lato server o client senza scrittura sui sistemi delle fonti.

Fonti aperte
Cruscotto Italia (AgID) e altre API pubbliche (ARPAT, Regione Toscana, meteo, OSM, MIUR, …) espongono i dati in lettura.
Proxy Next.js
Le route /api/* sul server recuperano, normalizzano e mettono in cache le risposte. Il browser non parla direttamente con l’MCP AgID.
Dashboard
I pannelli React leggono JSON dalle API interne e mostrano KPI, mappe, grafici e sezioni tematiche per San Vincenzo (ISTAT 049018).
Degrado controllato
I pannelli opzionali (meteo, ARPAT, cultura, porto, …) falliscono in modo indipendente: il resto del cruscotto resta consultabile.

Endpoint MCP AgID: https://cruscotto-italia-mcp.agid.workers.dev/mcp

Stack tecnologico

Tutto gira su un unico processo Next.js in sviluppo (npm run dev); in produzione su Vercel. Non serve avviare database o microservizi locali.

Next.js 16 (App Router) + TypeScript
Applicazione web, routing, rendering e API route server-side.
React 19 + Tailwind CSS 4
Interfaccia dashboard a sidebar, componenti e tema PA / Design Italia.
Chart.js / react-chartjs-2
Grafici KPI, serie storiche e confronti tra indicatori.
Leaflet / react-leaflet + OpenStreetMap / CARTO
Mappe interattive (civici, DAE, trasporti, meteo, accessibilità).
Three.js
Vista 3D stilizzata della morfologia del territorio.
@modelcontextprotocol/sdk
Client MCP verso Cruscotto Italia (AgID) per i KPI comunali.
Modal + Hugging Face (opzionale)
Assistente RAG: embedding e generazione senza API LLM a pagamento.
Vercel
Hosting, CDN e cache delle route API.

API interne

Il frontend chiama solo route locali sotto /api/*. Sono proxy/cache sottili: nessuna persistenza proprietaria dei dataset.

Principali route API interne del cruscotto
Route	Ruolo
`GET /api/kpi`	Proxy comune_kpi (cache ~24h)
`GET /api/dettaglio`	Sotto-sezioni comune_dashboard (SIOPE, ANAC, …)
`GET /api/mappa`	Layer GeoJSON (civici, EV, beni, sanità)
`GET /api/meteo*`	Meteo live, previsioni, radar, allerte
`GET /api/percorsi`	Percorsi ciclabili/pedonali OSM (lista, mappa, GPX)
`GET /api/dae`	Defibrillatori da GeoJSON locale / OSM
`POST /api/feedback`	Suggerimenti → issue GitHub
`POST /api/assistente`	Proxy RAG su Modal (se configurato)
`GET /api/amministratori`	Anagrafe DAIT (empty-safe)
`GET /api/terremoti`	INGV nel bbox comunale
`GET /api/ipa`	Domicili digitali IPA
`GET /api/demografia-mensile`	ISTAT D7B (ZIP latin-1)
`GET /api/stazioni`	WFS stazioni meteo-idro regionali
`GET /api/pubblico/*`	Export JSON/CSV indicizzabili

Sezioni del cruscotto

La navigazione (sidebar desktop / menu mobile) raggruppa i temi in tre aree. Ogni sezione è un deep-link (#sanita, #infra, …).

In evidenza
Panoramica, Sanità, Disabilità, Mobilità, Meteo, Partecipa
Territorio e mare
Turismo, Porto, Ambiente, Territorio, Mappa
Economia e PA
Economia, Istruzione, Società, Chi amministra, Confronto, Finanza

Torna al cruscotto

Servizi opzionali

Assistente RAG — corpus locale + modelli HF su Modal; richiede ASSISTENTE_MODAL_URL in ambiente. Senza variabile, l'assistente resta limitato alle FAQ integrate.
Bot Telegram DAE — segnalazioni cittadine di defibrillatori; webhook e overlay mappa se configurati.
PWA — installabile sulla schermata Home; offline solo per pagine già visitate.
Form Partecipa — i suggerimenti diventano issue sul repository GitHub del progetto.

Limiti e trasparenza

I dati sono quelli pubblicati dalle fonti al momento dell'estrazione: non c'è garanzia di aggiornamento in tempo reale su tutti i dataset. Per usi ufficiali o legali fare sempre riferimento alle fonti primarie. Licenze, stemma e elenco completo delle fonti sono in Attribuzioni e regole. Per duplicare lo stack su un altro comune vedi Riusa / fork.