Skip to content

fix(geo-utils): riconosce le P.A. Trentino in tutte le grafie delle fonti - #296

Merged
Gabrymi93 merged 1 commit into
mainfrom
fix/geo-trentino-varianti
Nov 17, 2026
Merged

Gabrymi93 merged 1 commit into
mainfrom
fix/geo-trentino-varianti

Conversation

@Gabrymi93

Copy link
Copy Markdown
Member

Sintesi

Le etichette del Trentino Alto Adige cambiano forma tra dataset e, in un caso, dentro la stessa serie. geo-utils dichiara nel suo contratto che «i dataset possono avere nomi regione leggermente diversi (maiuscole/minuscole, trattini, slash, P.A. Trentino separato)»: qui si rende vera quella promessa, senza toccare i dataset.

Contesto collegato

Closes #295

Cosa cambia

  • Bug fix frontend (data loader / layout / performance)

Il problema

Tre grafie per le stesse due province, che normalizzano in tre modi diversi:

fonte etichetta normalizzaReg
irpef_comunale, mef_irpef_regionale Trentino Alto Adige(P.A.Bolzano) …(P.A.BOLZANO)
irap, iva, irpef_calcolo, ires Trentino Alto Adige (P.A. Bolzano) …-(P.A.-BOLZANO)
acsp, abpf 2015 Trentino Alto Adige (Prov. Aut. Bolzano) …-(PROV.-AUT.-BOLZANO)

Due conseguenze:

  • REG_FALLBACKS non copre nessuna delle tre (P. A. BOLZANO è la forma BDAP, un'altra ancora);
  • irpef-comunale.md fondeva le P.A. con /P\.A\./, che non matcha (Prov. Aut. …), e buildRegLookupWithTrentino filtrava con un confronto sull'intera etichetta che non escludeva mai le province.

La soluzione

Nuova isTrentinoPA(nome): cerca i nomi delle due province (BOLZANO, TRENTO) invece della forma. "TRENTINO" non contiene "TRENTO" (T-R-E-N-T-I-N-O), quindi una riga aggregata Trentino Alto Adige non viene scambiata per una provincia — ed è il comportamento corretto.

  • buildRegLookupWithTrentino usa isTrentinoPA. Il parametro trentinoKey resta per le fonti che usano un prefisso senza il nome della provincia (ISTAT Gini: "Provincia Autonoma").
  • irpef-comunale.md usa isTrentinoPA al posto del regex.
  • irpef-regioni.json.py esclude la pseudo-regione per codice ISTAT '0', non per etichetta: 'Non indicato' fino al 2017, 'Mancante/errata' dal 2018. Il filtro per nome nella pagina era fragile e ora è superfluo.

Checklist

  • Data loader: usa safe_connect() tramite load_dataset
  • Pagina: usa moduli condivisi (geo-utils.js)
  • Niente toLocaleString
  • Mappe: buildMapLookup() invariato
  • Niente duckdb.connect()
  • Sidebar: non toccata

Verifica

node --test tests/test_shared-utils.test.mjs → 37 test, 0 fail.

Aggiunti:

  • isTrentinoPA(): 10 varianti riconosciute (incluse (P.A.Bolzano), (Prov. Aut. Bolzano), P. A. BOLZANO, Provincia Autonoma di Trento); Trentino Alto Adige e Trentino-Alto Adige/Südtirol no; input vuoti no.
  • buildRegLookupWithTrentino(): la fusione delle due P.A. è verificata su tutte e tre le grafie, con controllo che le chiavi separate non restino nella lookup; e il caso trentinoKey="Provincia Autonoma".

I 16 blocchi JS di irpef-comunale.md passano node --check.

Note / rischi

Perché non nei dataset. Standardizzare le etichette in 13 clean.sql significherebbe 13 re-run e republish, più l'allineamento dell'Explorer — per un dato che chi analizza legge già tramite cod_regione. La normalizzazione è delegata all'Explorer dal suo stesso contratto: meglio renderla robusta in un punto solo.

Dataset già sistemati a monte. irpef_comunale (dichiarazioni-italia #59) e abpf_titolari_piva_regione (#60) normalizzano già le proprie etichette; questa PR rende l'Explorer tollerante anche verso i dataset che non lo fanno, presenti e futuri.

…onti

Le fonti scrivono la provincia autonoma in almeno tre modi e ognuno normalizza
in modo diverso:
  "Trentino Alto Adige (P.A. Bolzano)"       -> ...-(P.A.-BOLZANO)
  "Trentino Alto Adige(P.A.Bolzano)"         -> ...(P.A.BOLZANO)
  "Trentino Alto Adige (Prov. Aut. Bolzano)" -> ...-(PROV.-AUT.-BOLZANO)
Un regex su /P\.A\./ o un confronto sulla stringa normalizzata ne perdono una.

- nuova `isTrentinoPA(nome)`: cerca i nomi delle due province, non la forma.
  "TRENTINO" non contiene "TRENTO", quindi la riga aggregata resta esclusa.
- `buildRegLookupWithTrentino` usa `isTrentinoPA`; il parametro `trentinoKey`
  resta per le fonti che usano un prefisso (ISTAT Gini: "Provincia Autonoma").
  Corretto anche il filtro iniziale, che confrontava l'intera etichetta con "P.A."
  e quindi non escludeva mai le province.
- `irpef-comunale.md` usa `isTrentinoPA` al posto di `/P\.A\./`.
- `irpef-regioni.json.py` esclude la pseudo-regione per codice ISTAT ('0'),
  non per etichetta: 'Non indicato' fino al 2017, 'Mancante/errata' dal 2018.

Test: 10 varianti riconosciute, "Trentino Alto Adige" e
"Trentino-Alto Adige/Südtirol" no, e la fusione delle due P.A. verificata su
tutte e tre le grafie (37 test passano).
@Gabrymi93
Gabrymi93 merged commit 30f77b6 into main Nov 17, 2026
1 check passed
@Gabrymi93
Gabrymi93 deleted the fix/geo-trentino-varianti branch November 17, 2026 18:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug] irpef-regioni: il loader include la pseudo-regione 'Mancante/errata' nei grafici

1 participant