feat: add FTS EU Grants explorer page

[matteocavo]

Sintesi

Aggiunge una pagina Data Explorer per fts_eu_grants con taglio BI: KPI annuali, distribuzione per programma UE, tipo beneficiario, città dichiarata e tabella dei principali beneficiari.

Contesto collegato

Closes #186

Cosa cambia

• Nuovo dataset — pagina explorer
• Bug fix frontend (data loader / layout / performance)
• Aggiornamento config / catalogo
• Modifica struttura dati upstream
• Documentazione
• Dipendenze o CI

Checklist nuovo dataset

Se la PR aggiunge un nuovo dataset in explorer:

• Data loader: src/data/fts-eu-grants.json.py — usa safe_connect() (non duckdb.connect())
• Pagina: src/dataset/fts-eu-grants.md — usa moduli condivisi (format-utils.js)
• Tema: aggiornato src/data/themes.json.py (sidebar auto-generata, non toccato observablehq.config.js)
• Frontmatter: title, description, source, source_url, period, last_modified, dataset_slug
• Sezione Limiti obbligatoria (copertura, note metodologiche)
• Verifica: lint, test e build eseguiti localmente

Standard check

Prima della review, verificare:

• Niente toLocaleString — usare num(), euro(), pct() da format-utils.js
• tableFormat e Inputs.table in celle separate (bug noto OF)
• Mappe: non applicabile, nessuna mappa in questa pagina
• Niente duckdb.connect() — usa safe_connect()
• Sidebar: auto-generata da themes.json.py — non modificato observablehq.config.js

Verifica

npm run lint
npm test
npm run build

• npm run lint — eslint + standard check: 30 pagine, 0 errori
• npm test — JS 57/57 pass, Python 13/13 pass
• npm run build — build completato: 39 pagine renderizzate, 26 link validati

Ho verificato le query del loader direttamente sui parquet pubblici via DuckDB: 40.449 righe 2020-2024, 108,6 mld euro di importo contrattato, aggregazioni programma/tipo ente/città/top beneficiari senza errori.

Checklist PR

• Perimetro stretto: una PR = un dataset o un fix mirato
• Issue collegata o motivazione dell'assenza

Note per chi revisiona

La pagina segnala esplicitamente due caveat: FTS non sostituisce OpenCoesione/fondi strutturali e la città del beneficiario può mancare (-), quindi la vista territoriale è una lettura della localizzazione dichiarata, non della destinazione finale dei fondi.

[matteocavo]

PR pronta per review.

Ho sistemato anche la verifica locale su Windows: ora npm run lint, npm test e npm run build passano tutti. La pagina è pensata come vista BI su FTS EU Grants: KPI, programma UE, tipo beneficiario, città dichiarata e top beneficiari.

[Gabrymi93]

Review PR #191 — FTS EU Grants

Clip: 3 file (loader + pagina + themes), solido, perimetro stretto.

Findings

• Low: data loader custom (non usa load_dataset) ma giustificato — 6 query aggregate diverse, impossibile con load_dataset.
• Low: classificazione programmi con ILIKE basata su pattern testuali. Caveat già dichiarato nei Limiti. ✅

Checklist

• ✅ safe_connect(), format-utils.js, themes.json.py
• ✅ Niente toLocaleString, tableFormat in celle separate
• ✅ Frontmatter + Limiti completi
• ✅ Build/lint/test dichiarati passati

Verdict: merge