palermo-ps

Tempi di attesa dei Pronto Soccorso di Palermo città, letti ogni 5 minuti dalle fonti pubbliche degli ospedali, con mappa, schede per presidio, storico e analisi. Stato: in produzione (Worker palermo-ps su Cloudflare, sito + API + storico + archivio CSV).

Come funziona

Un Cloudflare Worker con cron ogni 5 minuti interroga 5 fonti, normalizza in Lettura (src/types.ts) e salva lo snapshot in D1 (tabella stato). Lo stesso Worker serve l'API e il sito statico in web/.

• Il cron chiama /api/refresh tramite un binding a sé stesso (SELF): lo scraping parte da una richiesta, così rispetta il placement aws:eu-south-1 (Milano). Riuniti e ARNAS Civico non rispondono a IP di datacenter esteri.
• Se una fonte cade resta l'ultima lettura buona con acquisitaAlle e ultimoErrore: un dato vecchio non passa mai per fresco (src/freschezza.ts). Fonti congelate e incoerenze sono segnalate (src/coerenza.ts, src/salute.ts).
• Gli endpoint /api/* pubblici sono pensati per il sito: rispondono solo a richieste della stessa origine o di palermohub.opendatasicilia.it e siciliahub.github.io (con CORS), con un limite di 30 richieste al minuto per IP (src/origine.ts, binding LIMITE in wrangler.toml). Export CSV e archivio grezzo richiedono EXPORT_TOKEN.
• Ogni risposta grezza delle fonti è archiviata (src/grezzo.ts), così i parser si possono rieseguire sul passato. Le catture ok più vecchie di 7 giorni sono potate (resta la prima per fonte/chiave/giorno), gli errori restano 90 giorni.

Fonte	Formato	PS	File
Ospedali Riuniti	HTML (classi CSS)	Villa Sofia, Cervello adulti, Cervello pediatrico	src/sources/riuniti.ts
ARNAS Civico	HTML + testo	Civico, Di Cristina	src/sources/civico.ts
Policlinico	JSON (2 endpoint)	Policlinico	src/sources/policlinico.ts
ASP Palermo	HTML	Ingrassia	src/sources/asp.ts
Fatebenefratelli	JSON (POST)	Buccheri La Ferla	src/sources/buccheri.ts

Regola dei dati: se la fonte non pubblica un valore è null, mai 0 inventato né totali calcolati da noi (eccezione dichiarata: pazientiTotali Buccheri/Policlinico e sovraffollamentoPct Policlinico).

Sito (web/)

• index.html: mappa Leaflet, schede per presidio, filtro adulti/pediatrico, riepilogo, pulsante 112 e disclaimer «non sostituisce il 118».
• grafici.html: analisi (presenti nelle ultime ore, fasce con meno gente, chi aspetta di più, permanenza, sovraffollamento, affidabilità dei dati), esportazione dei grafici in PNG e sezione Scarica i dati (CSV di giorni, settimane e mesi).
• privacy.html: informativa (cosa resta nel browser, posizione, servizi di terzi). I font (Archivo, Figtree) sono in web/fonts/, senza richieste a Google Fonts. Anche le librerie (Leaflet, MapLibre, html2canvas) sono locali, in web/vendor/ (licenze in web/vendor/LICENZE.md). Restano esterni solo le mappe (OpenFreeMap/OSM) e i CSV su GitHub: se ne cambi uno, aggiorna l'informativa.
• Modalità embed per le pagine PalermoHub: vedi docs/embed.md.

Storico e archivio CSV

• Ogni lettura finisce nel database D1 palermo-ps-storico (migrazioni in migrations/).
• .github/workflows/backup-storico.yml gira ogni notte (02:30 UTC): scarica il CSV di ieri in dati/storico/AAAA/, ricalcola heatmap.json, crea con scripts/aggrega.mjs i CSV di settimane e mesi chiusi e riscrive indice.json, poi fa commit e push. Il sito legge questi file da raw.githubusercontent.com, senza nuovo deploy (cache ~5 min). Le colonne sono descritte in dati/storico/descrizione-colonne.csv.
• Backup locale dell'archivio grezzo: scripts/backup-d1.sh (vedi docs/backup-grezzo.md).

Allarmi

.github/workflows/controllo-fonti.yml (ogni 30 minuti) legge /api/stato (serve EXPORT_TOKEN) e apre una issue con label allarme-dati se una fonte è irraggiungibile da almeno 30 minuti, ferma («congelata») o vecchia, se il Worker non aggiorna da oltre 20 minuti o se il sito non risponde. L'issue si chiude da sola quando il problema rientra. Anche il backup notturno apre e chiude la sua issue. Le regole sono in src/allarmi.ts. Per ricevere l'email, metti il repo in «Watch» su GitHub.

Comandi

npm test · npm run typecheck · npm run dev (anteprima locale su http://localhost:8787) · npm run deploy

Deploy

.github/workflows/deploy.yml: a ogni push su main esegue typecheck e test, poi wrangler deploy. Secret nel repo: CLOUDFLARE_API_TOKEN (template "Edit Cloudflare Workers"), CLOUDFLARE_ACCOUNT_ID, EXPORT_TOKEN (stesso del Worker, per il backup notturno). Se l'Action non parte, il deploy si fa a mano con npm run deploy.

Licenze

Copyright © 2026 OpenDataSicilia.

• Codice (src/, web/, scripts/, test/): MIT.
• Dati (dati/): CC BY 4.0, da citare come «Pronto Soccorso Palermo (#opendatasicilia), CC BY 4.0». I numeri di partenza restano degli enti che li pubblicano.