Guida tecnica
Fonti dati, metodologia, granularità, frequenze e licenze.
Catalogo delle fonti
Ogni KPI esposto su ItalIntel proviene da una fonte ufficiale e mantiene la dichiarazione esplicita di granularità, frequenza e licenza. Il registry completo è versionato nel repository (file apps/api/registry/datasets.yaml).
Demografia
| Fonte | Descrizione | Granularità | Frequenza | Licenza |
|---|---|---|---|---|
| ISTAT | Popolazione residente al 1° gennaio per comune | Comune | Annuale | CC BY 3.0 IT |
| ISTAT | Popolazione straniera residente | Comune | Mensile | CC BY 3.0 IT |
| Eurostat | Speranza di vita alla nascita | Regione (NUTS2) | Annuale | CC BY 4.0 |
Economia & lavoro
| Fonte | Descrizione | Granularità | Frequenza | Licenza |
|---|---|---|---|---|
| MEF BDAP | Dichiarazioni IRPEF per comune | Comune | Annuale | IODL 2.0 |
| ISTAT | Occupazione (RCFL) | Provincia | Trimestrale | CC BY 3.0 IT |
| Eurostat | PIL pro capite per NUTS3 | Provincia | Annuale | CC BY 4.0 |
Investimenti pubblici
| Fonte | Descrizione | Granularità | Frequenza | Licenza |
|---|---|---|---|---|
| OpenPNRR | Progetti PNRR per comune con importi e avanzamento | Comune | Settimanale | CC BY 4.0 |
| OpenCoesione | Fondi coesione 2021-27 | Comune | Mensile | CC BY 4.0 |
Servizi (scuola, sanità, cultura)
| Fonte | Descrizione | Granularità | Frequenza | Licenza |
|---|---|---|---|---|
| MIM | Anagrafe scuole statali e paritarie | Comune | Annuale | IODL 2.0 |
| Ministero Salute | Strutture sanitarie pubbliche e private | Comune | Annuale | IODL 2.0 |
| MiC SPARQL | Musei, biblioteche, archivi, monumenti | Comune | Mensile | CC BY 4.0 |
Ambiente & rischio
| Fonte | Descrizione | Granularità | Frequenza | Licenza |
|---|---|---|---|---|
| Catastima (ISPRA) | Rischio idrogeologico (alluvione+frana) e sismico aggregati per comune | Comune | Mensile | CC BY 4.0 |
Metodologia degli indici sintetici
Ogni indice (Vitalità, Attrattività, QoL, Rischio) è una media pesata di componenti normalizzati come percentili rispetto a tutti i 7.904 comuni italiani. Per componenti dove "meno è meglio" (es. indice di vecchiaia, rischio idrogeologico) il percentile è invertito.
Output: punteggio 0-100, percentile nazionale, percentile nel cluster di comuni di pari dimensione (micro <5k, piccolo 5-20k, medio 20-100k, grande >100k abitanti). I pesi delle componenti sono pubblici e versionati in packages/core/.../indices/weights.yaml.
Fallback di granularità
Quando un dato non è disponibile a livello comunale, ItalIntel mostra il valore alla granularità superiore disponibile (provincia → regione → nazione) marcandolo esplicitamente. Esempio: il tasso di occupazione RCFL è pubblicato da ISTAT solo a livello provinciale, quindi tutti i comuni di una stessa provincia mostrano lo stesso valore con granularity: provincia.
Tutela della privacy
Per dati fiscali MEF/BDAP, le classi di reddito con meno di 100 contribuenti sono soppresse (KPI = null) per evitare l'identificazione indiretta in comuni molto piccoli.