Eventi Vicini

Eventi Vicini è un'agenda gratuita degli eventi pubblici italiani: sagre, mostre, concerti, mercati, attività per bambini. Mostra cosa succede oggi, stasera e nel fine settimana nel tuo comune e intorno a te, in lista o su mappa. È pensata per chi cerca qualcosa da fare senza account, senza pubblicità e senza tracciamento. Gli eventi arrivano dai siti istituzionali dei comuni e dagli open data, ogni evento rimanda alla sua fonte, e il progetto non costa nulla da mantenere (Firebase Spark, Cloudflare Pages gratuito).

In English: Eventi Vicini is a free agenda of public events across Italy (festivals, exhibitions, concerts, markets, kids' activities). It collects events daily from municipal websites and open data that allow reuse (CC-BY/CC0), shows them as a list or on a map, has no ads and no tracking, and always links back to the original source. SvelteKit on Cloudflare Pages, Firebase Firestore, a Python importer on GitHub Actions. Code under MIT; event data stays under each source's license.

Indice: Screenshot · Funzioni · Come funziona · Copertura · Privacy · Sviluppo · Struttura · Limiti noti · Sicurezza · Crediti · Licenza

Screenshot

Dati reali dal sito, Brescia, 30 ottobre 2026.

Tema chiaro	Tema scuro

Immagine del dettaglio evento: Comune di Brescia, CC-BY 4.0, licenza dichiarata nelle note legali del sito · fonte.

Funzioni

• Lista per tempo: Oggi, Stasera, Prossimi giorni, Questo weekend, Più avanti, In corso (mostre e rassegne lunghe).
• Mappa con pin per categoria, cluster e anteprima al tocco; lista e mappa sincronizzate.
• Ricerca unificata di eventi e luoghi (tutti i circa 7.900 comuni italiani, anche senza eventi, con nomi bilingui e omonimi distinti dalla sigla), con il luogo nell'URL (link condivisibili) e filtri rapidi per categoria.
• Pagine per comune e per regione, bilingue dove serve (Bolzano / Bozen).
• Preferiti e proposte con account facoltativo (Google o link via email): puoi proporre un evento, che viene approvato prima di apparire.
• PWA installabile, con pagina offline, tema chiaro e scuro, design system sobrio con carta calda e accento terracotta (DESIGN.md).
• Fonti sempre citate: ogni evento ha il link alla pagina originale.

Come funziona

flowchart LR
  A["Siti dei comuni<br/>e open data<br/>(CC-BY / CC0)"] --> B["Importer Python<br/>GitHub Actions<br/>ogni giorno"]
  B --> C[("Firestore<br/>eventi + bundle<br/>per cella e città")]
  C --> D["SvelteKit<br/>Cloudflare Pages<br/>(Worker, lettura REST)"]
  D --> E(["Utente<br/>web / PWA"])
  N["Nominatim (OSM)<br/>geocoding"] --> B
  T["Tile OpenStreetMap"] --> E

1. L'importer (tools/importer/) legge ogni giorno le fonti attive con un adapter per CMS (Plone, WordPress e HTML Design Comuni Italia, Open Data Hub Alto Adige; con la chiave TICKETMASTER_API_KEY anche Ticketmaster), normalizza, geocodifica, deduplica e scrive su Firestore solo i documenti cambiati (contentHash).
2. A fine import scrive i bundle: liste precalcolate per cella geografica e per città, così la webapp legge poche decine di documenti invece di fare una query per visita.
3. La webapp (web/) fa SSR su un Worker Cloudflare, legge Firestore via REST (niente Admin SDK) e usa cache a due livelli. Il Firebase SDK nel browser si carica solo per login, preferiti e proposte.

Dettagli: architettura · importer · quote e letture Firestore.

Copertura

Dal registro delle fonti, stato al 29 ottobre 2026: 20 regioni, circa 7.900 comuni censiti (ISTAT / IndicePA), 921 con una fonte attiva (802 Design Comuni HTML, 112 WordPress, 6 Plone, 1 Open Data Hub). Il dry-run di fine ottobre contava circa 4.000 eventi su un orizzonte di 45-60 giorni; i numeri variano con la stagione (a ottobre molti comuni del Sud pubblicano pochi eventi).

Regione	Comuni	Fonti attive		Regione	Comuni	Fonti attive
Lombardia	1.502	255		Liguria	234	16
Veneto	560	157		Friuli-V. Giulia	215	12
Piemonte	1.180	111		Lazio	378	19
Emilia-Romagna	330	66		Sardegna	377	27
Trentino-Alto Adige	282	86		Sicilia	391	19
Toscana	273	54		Campania	550	13
Marche	225	25		Calabria	404	10
Valle d'Aosta	74	13		Abruzzo	305	10
Umbria	92	11		Puglia	257	9
Basilicata	131	6		Molise	136	2

Fonti: tools/importer/sources/*.csv (conteggio delle righe attivo) e i report in tools/importer/reports/.

Come si scelgono le fonti. Una fonte diventa attiva solo se: esiste un adapter per il suo CMS; la licenza dei contenuti è CC0 o CC-BY (mai NC, ND, SA, «tutti i diritti riservati» sui contenuti); il robots.txt consente i percorsi usati; un dry-run produce almeno un evento futuro valido con coordinate coerenti. Il resto resta da_verificare o escluso, con il motivo in note. L'importer fa una richiesta al secondo per sito, con User-Agent identificativo, e ogni evento mostra e linka la fonte. Procedura completa in docs/importer.md. Per proporre un comune: CONTRIBUTING.md.

Privacy

Nessun analytics, nessun pixel, nessun cookie di profilazione, nessun banner. Preferiti, posizione e tema stanno nel localStorage del dispositivo; l'account è facoltativo (età minima 14 anni). La posizione, se la concedi, non finisce nell'URL né nel profilo. Dettagli nella pagina /privacy.

Sviluppo

Requisiti: Node.js 24 (.nvmrc), JDK 21 per gli emulatori Firebase, Python 3.12 per l'importer.

cd web; npm install
cd ..\firebase; npm install

cd ..\web
npm run emulators   # Auth + Firestore (resta aperto, Ctrl+C per chiudere)
npm run seed        # dati di prova, in un altro terminale
npm run dev         # sviluppo con hot reload

npm run check; npm run lint; npm test; npm run build   # da web/
npm run test:e2e                                       # da web/: emulators:exec + Playwright
npm test                                               # da firebase/: test delle regole
python -m pytest -q tests                              # da tools/importer/
python run.py --dry-run --regione veneto               # importer, senza scrivere

Guide complete: sviluppo, test e deploy · importer · architettura e Firebase · design system.

Struttura

Cartella	Contenuto
web/	Webapp SvelteKit (adapter-cloudflare), test Vitest e Playwright
firebase/	Regole e indici Firestore, test delle regole
tools/importer/	Importer Python, adapter, registro fonti (sources/*.csv), report
.github/workflows/	CI, import giornaliero, ricontrollo settimanale delle fonti
docs/	Documentazione tecnica, brand kit, screenshot

Limiti noti

• Le liste vengono da bundle aggiornati una volta al giorno: un evento inserito o approvato dall'admin appare entro 24 ore.
• Le tile pubbliche di OpenStreetMap non sono adatte a traffico intenso; con molto traffico serve un altro provider.
• Cache e rate limit verso Nominatim valgono per isolate del Worker, non globalmente.
• Nessun adapter per Drupal, Joomla, Halley, Maggioli: quei comuni restano da_verificare.
• La ricerca testuale non guarda la descrizione degli eventi.

Elenco completo in docs/importer.md e docs/quote-firestore.md.

Sicurezza

Le regole Firestore sono testate (firebase/test/): events in lettura pubblica e scrittura solo admin, proposte validate, users solo del proprietario. Le chiavi web di Firebase sono pubbliche per costruzione; il service account dell'importer è un segreto di GitHub Actions. Per segnalare una vulnerabilità leggi SECURITY.md.

Crediti

• Dati degli eventi: siti istituzionali dei comuni, Open Data Hub Alto Adige e, per concerti e spettacoli, la Discovery API di Ticketmaster (senza affiliazione); elenco dei comuni ISTAT (CC BY 4.0), coordinate e popolazione dei comuni da Wikidata (CC0) e siti da IndicePA (CC-BY 4.0).
• Mappe e geocoding: © collaboratori di OpenStreetMap (ODbL), Leaflet, Nominatim.
• Icone: Lucide (ISC). Titoli: Fraunces (SIL OFL).
• Cronologia delle versioni: CHANGELOG.md.

Licenza

Il codice è rilasciato con licenza MIT © 2026 Andrea Azzarello. I dati degli eventi non sono coperti dalla licenza del codice: restano sotto le licenze delle rispettive fonti (CC-BY, CC0) e vanno citati. Nome, logo e immagini in docs/brand appartengono al progetto e non sono coperti dalla MIT.