The project's README from github.com/Italian-Builders-Org/DoveVannoINostriSoldi. As one markdown file: README.md.
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

Il progetto resta indipendente. Un contributo su Buy Me a Coffee aiuta a pagare compute e hosting; non influenza i dati pubblicati.
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à.
Oggi il portale copre pagamenti comunali, imprese, istruzione, sanità, pensioni, debito, fondi e progetti, enti, appalti ANAC, segnali da fonti ufficiali e una pagella politico-economica dei governi. Il registro fonti elenca 33 collegamenti ufficiali. Il catalogo MCP espone 93 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 |
|---|---|
![]() |
![]() |
| Cosa controllare | Catalogo dati |
|---|---|
![]() |
![]() |
| Confronto Comuni | Debito pubblico |
|---|---|
![]() |
![]() |
| Sanità | MCP |
|---|---|
![]() |
![]() |
| Sezione | In sintesi |
|---|---|
| Home | Pagamenti dei Comuni, mappa regionale, composizione della spesa |
| 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 |
| 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) |
| Istituzioni | Parlamento, Palazzo Chigi, pagella dei governi, ministeri e regioni |
| Enti e società | Indice PA, schede enti, partecipazioni MEF, appalti per ente |
| Appalti | Affidamenti, operatori ANAC, TED e confronti verificati |
| Cosa controllare | Segnali da fonti ufficiali, incarichi e catalogo dati |
| Assistente | Chat con la tua AI personale, dati verificati del sito e allegati |
| Fonti | Stato dei collegamenti, catalogo, copertura e calendario |
| MCP | Catalogo e istruzioni per collegare un client AI in sola lettura |
| Dati | Catalogo integrato interrogabile (93 dataset) |
| Report | Articoli mensili e approfondimenti |
Pagine di dettaglio: pensioni, sanità, invalidità civile, operatori ANAC, pagella dei governi, confronto Comuni, partecipazioni, studio asili PNRR.
Non è un feed di accuse e non è un motore che inventa conclusioni. È uno strumento di lettura:
Dettaglio: docs/LEGAL_AND_ETHICS.md e docs/ARCHITECTURE.md.
Su Home, Soldi e Territori puoi scegliere 2024, 2025 o 2026 (resta nell’URL, es. /?anno=2025).
Limiti importanti:
Registro integrato, copertura e caveat: docs/INTEGRATED_SOURCE_LEDGER.md.
Node.js 22.19+.
npm ci
npm run dev
Apri http://localhost:3000.
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.
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.
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.
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.
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.
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
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:
Prima di una PR leggi CONTRIBUTING.md.
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.
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.