DoveVannoINostriSoldi

Progetto civico open source per capire, con dati ufficiali, come vengono usati i soldi pubblici italiani.

Riunisce fonti pubbliche sparse su portali diversi e le rende leggibili in un unico posto. Ogni numero mostra fonte, periodo e limiti. Un valore insolito indica dove controllare meglio: non dimostra da solo uno spreco o un illecito.

Sito: dovevannoinostrisoldi.com

Perché esiste

Bilanci, pagamenti, appalti, debito, partecipazioni e fonti istituzionali esistono già, ma spesso sono dispersi, difficili da confrontare o poco leggibili per chi non lavora tutti i giorni con dati pubblici. DoveVannoINostriSoldi prova a ridurre questa distanza: meno opacità, più contesto, più verificabilità.

Cosa puoi fare in 2 minuti

• Vedere come spendono Comuni, Stato, sanità ed enti pubblici.
• Confrontare territori, amministrazioni e serie storiche.
• Aprire la fonte ufficiale dietro ogni numero.
• Capire rapidamente che cosa il dato misura, e che cosa non misura.
• Fare domande al catalogo dati e al server MCP in sola lettura.

Oggi il portale copre spesa pubblica (Eurostat COFOG), pagamenti comunali, imprese, istruzione, sanità, pensioni, debito, fondi e progetti, opere pubbliche (previsto vs effettivo), enti, appalti ANAC, povertà, segnali da fonti ufficiali e una pagella politico-economica dei governi. Il registro fonti elenca 60 collegamenti ufficiali. Il catalogo MCP espone 103 dataset interrogabili in sola lettura. L’assistente collega la tua AI personale per conversare sui dati verificati del sito e sui documenti che alleghi.

Territori	Pagella dei governi

Atlante Istruzione	Atlante Imprese

Opere pubbliche	Operatori ANAC

Cosa controllare	Catalogo dati

Confronto Comuni	Debito pubblico

Sanità	Spese dello Stato

Povertà	Assistente

MCP

Cosa trovi sul sito

Sezione	In sintesi
Home	Spesa PA (Eurostat COFOG), bilancio dello Stato e pagamenti dei Comuni
Imprese	Imprese attive, addetti, localizzazioni e fatturato aggregato (ISTAT)
Istruzione	Scuola secondaria di II grado per Regione (MIM) e università/ricerca
Povertà	Povertà assoluta e relativa (ISTAT)
Soldi	Uscite di cassa comunali (SIOPE), sanità, invalidità, pensioni, ambiente, consulenze
Territori	Confronti per Regione e Comune, profili OpenCivitas, CPT e IRPEF MEF
Fondi e progetti	OpenCoesione, PNRR Italia Domani, asili e incarichi PNRR
Opere pubbliche	Costo previsto vs effettivo (OpenBDAP MOP), avanzamento e filtri
Spese dello Stato	Pagamenti per funzione e amministrazione (OpenBDAP/RGS)
Debito pubblico	Stock, detentori, scadenze e interessi (Banca d'Italia ed Eurostat)
Legge di Bilancio	Stanziamenti per missione e riallocazione ipotetica (OpenBDAP, competenza A1)

Pagine di dettaglio: pensioni, sanità, invalidità civile, operatori ANAC, opere pubbliche, pagella dei governi, confronto Comuni, partecipazioni, studio asili PNRR.

Come leggere il progetto

Non è un feed di accuse e non è un motore che inventa conclusioni. È uno strumento di lettura:

• separa pagamenti, stanziamenti, costi previsti e stock di debito;
• mostra quando una copertura è parziale;
• espone caveat e perimetro di ogni fonte;
• mantiene visibile il collegamento con l'origine ufficiale del dato.

Regole in breve

• Nessun numero senza fonte e data.
• Nessun dato inventato o dimostrativo nelle pagine pubbliche.
• Pagamenti, costi previsti, debiti e ipotesi restano separati.
• Un segnale non è una colpa.
• I confronti usano solo misure compatibili.
• Se una fonte non risponde, il problema resta visibile.

Dettaglio: docs/LEGAL_AND_ETHICS.md e docs/ARCHITECTURE.md.

Anno e limiti

Su Home, Soldi e Territori puoi scegliere 2024, 2025 o 2026 (resta nell’URL, es. /?anno=2025).

Limiti importanti:

• ANAC CIG 2025: snapshot mensile verificato, non ricerca live per CIG o fornitore.
• PNRR: perimetro asili e prima infanzia; non include i pagamenti ReGiS né tutto il Piano.
• OpenCivitas 2022: Comuni a statuto ordinario (6.557 enti, 15 Regioni).
• Pagella dei governi: descrive il periodo osservato e il confronto con Francia, Germania e Spagna; non stima quanto sia attribuibile all’esecutivo.
• Assistente: intenti predefiniti, una domanda per volta; non risponde su un singolo Comune e non accetta richieste su frode o corruzione.
• Contabilità diverse non si sommano (SIOPE, IRPEF, CPT, costi previsti, debiti).

Registro integrato, copertura e caveat: docs/INTEGRATED_SOURCE_LEDGER.md.

Per chi sviluppa

Avvio locale

Node.js 22.19+.

npm ci
npm run dev

Apri http://localhost:3000.

MCP (assistenti AI)

Server Model Context Protocol pubblico, sola lettura:

https://www.dovevannoinostrisoldi.com/api/mcp

In locale: http://localhost:3000/api/mcp. Pagina catalogo: /mcp. Per evitare errori di configurazione, POST /mcp e OPTIONS /mcp sono alias compatibili dell'endpoint canonico; GET /mcp resta la pagina informativa.

Strumenti principali: list_datasets, query_dataset.

{
  "mcpServers": {
    "dove-vanno-i-nostri-soldi": {
      "type": "http",
      "url": "https://www.dovevannoinostrisoldi.com/api/mcp"
    }
  }
}

Guida completa: docs/MCP.md. Distribuzione su client esterni: docs/MCP_DISTRIBUTION.md.

Il MCP pubblico di Cruscotto Italia (AgID) è un servizio esterno complementare: DVNS non lo inoltra e non lo tratta come dato validato localmente.

API HTTP

Esempi:

GET /api/spese/comuni
GET /api/territori/irpef?anno=2024&livello=regione
GET /api/controlli
GET /api/opere?cup=…
GET /api/dati/consulenze-legali?q=2024&limit=20

Elenco e contratti: documentazione in docs/ e catalogo su /mcp.

Controlli prima di una modifica

npm run ci:static
npm test
npm run build
NEXT_PORT=3218 npm run test:production

Il runner produzione avvia e termina il proprio server. Setup Python, test ETL, verifica snapshot e comandi mirati in CONTRIBUTING.md.

Screenshot del README

DVNS_BASE_URL=https://www.dovevannoinostrisoldi.com npm run readme:screenshots

Le catture finiscono in docs/readme/. In locale si può puntare a un next start sulla stessa porta usata per i test.

Aggiornamento dati

Gli script in scripts/etl/ scaricano le fonti ufficiali e producono gli snapshot usati dal sito. Esempio:

python3 scripts/etl/siope_municipal_snapshot.py --year 2025 \
  --output src/data/generated/siope-municipal-2025.json
python3 scripts/etl/opencoesione_snapshot.py --check
python3 scripts/etl/public_debt_snapshot.py --check

La route /debito, GET /api/debito e il dataset MCP debito_pubblico_italiano usano lo stesso snapshot verificato di Banca d'Italia ed Eurostat. Il refresh live è atomico; la CI delle pull request usa esclusivamente fixture offline.

Politica di freschezza: docs/FRESHNESS_AND_REFRESH.md.

Struttura del repository

src/app/            pagine e API
src/components/     interfaccia
src/lib/            lettura e collegamento dati
src/lib/mcp/        catalogo MCP
src/data/generated/ snapshot verificati
scripts/etl/        aggiornamento fonti
tests/              controlli automatici
docs/               metodo, architettura, note legali

Contribuire

Segnalazioni utili: fonti mancanti, correzioni alle spiegazioni, qualità dei dati, accessibilità. Dal sito puoi usare il pulsante «Segnala un problema», presente in ogni pagina: crea una issue pubblica già strutturata (docs/SEGNALAZIONI.md).

Se vuoi contribuire anche senza scrivere codice, sono utili:

• segnalazioni di fonti ufficiali mancanti;
• controlli sui testi e sulla chiarezza delle spiegazioni;
• verifiche su date, perimetri e limiti esposti nelle pagine;
• feedback su accessibilità e leggibilità.

Prima di una PR leggi CONTRIBUTING.md.

Il comando GovCore facoltativo aggiunge riferimenti pubblici separati alla proiezione degli enti, senza modificare contabilità o attivare lookup nelle pagine.

Ruoli dei maintainer e regole di decisione: GOVERNANCE.md.

Per una vulnerabilità non ancora corretta non aprire una issue: usa il canale privato.

Per una nuova fonte, in issue indica: ente, URL ufficiale, licenza, formato, frequenza, identificativi (IPA, CF, CIG, CUP) e cosa il dato non misura.

Richieste della community: docs/COMMUNITY_FEEDBACK.md. Coda di sviluppo con priorità e issue: docs/ROADMAP.md.

Fondatori

• @fragiannicola
• @dom_gag_96

Contributors

Licenza

Il codice è sotto GNU Affero GPL v3.

Puoi usare, studiare e migliorare il progetto rispettando l’AGPL (incluso, quando richiesto, il codice sorgente corrispondente). Per un prodotto o servizio proprietario da vendere senza obblighi AGPL serve una licenza commerciale.

I dati di terzi restano sotto le loro licenze: THIRD_PARTY_NOTICES.md.