DoveVannoINostriSoldi README

The project's README from github.com/Italian-Builders-Org/DoveVannoINostriSoldi. As one markdown file: README.md.

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

Marchio Confluenza

Buy me an AI compute

Il progetto resta indipendente. Un contributo su Buy Me a Coffee aiuta a pagare compute e hosting; non influenza i dati pubblicati.

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

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.

Home: pagamenti dei Comuni, mappa regionale e composizione della spesa

Territori Pagella dei governi
Territori: pagamenti comunali per regione, con filtro anno e metrica Pagella politico-economica del governo in carica, con confronto europeo
Atlante Istruzione Atlante Imprese
Atlante Istruzione: studenti osservati per Regione, anno e percorso Atlante Imprese: imprese attive per Regione, settore ATECO e periodo
Cosa controllare Catalogo dati
Cosa controllare: segnali da fonti ufficiali, con limiti visibili Catalogo dati: dataset integrati, filtri per evidenza e pubblicazione
Confronto Comuni Debito pubblico
Confronto Comuni: quattro profili OpenCivitas e perimetro 2022 Debito pubblico: stock, detentori e interessi da Banca d'Italia ed Eurostat
Sanità MCP
Sanità: voci del Conto economico SSN, personale e servizi Pagina MCP: endpoint pubblico, strumenti list_datasets e query_dataset

Cosa trovi sul sito

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.

Come leggere il progetto

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

Regole in breve

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:

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:

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.

Fondatori

Contributors

metaforismo dg996 sephmartin lucaosti rinocitarella Elgabor marianimatteo-lexroom nellicus Zer0codestuff calca saliougaye VoxamVox danielemeanti23 not-knope superpios

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.

DoveVannoINostriSoldi (Italian-Builders-Org/DoveVannoINostriSoldi)

Searching Database…

What is this?DoveVannoINostriSoldi is a civic open-source project that collects and analyzes Italian public spending data from official sources, using AI to highlight where public resources could be used more efficiently. It also includes a budget law (Legge di Bilancio) reallocation simulator based on OpenBDAP commitment-basis appropriations.
Is this a website or something I install myself?It is a Next.js web application published at dovevannoinostrisoldi.com, paired with a public read-only MCP server so AI assistants can query the same verified datasets.
How do I run it locally?Clone the repo and make sure you have Node.js 22.19 or newer, then use the standard Next.js scripts: `npm run dev` for local development, `npm run build` and `npm start` for production.
What do I need besides Node.js?Node.js 22.19+ is the main requirement for running the site; some ETL and test scripts also need a Python setup as described in the contributing guide.
Are all the datasets live and up to date?No, several datasets are periodic snapshots rather than live feeds: ANAC public procurement data (CIG 2025) is a verified monthly snapshot rather than a live search by contract ID or supplier, and PNRR coverage is limited to nurseries/early-childhood projects, excluding ReGiS payments and the full Plan.
What can I do with the public MCP server?It exposes 93 read-only datasets through tools like listdatasets and querydataset, so any MCP-compatible AI assistant can query the verified spending data directly; usage is documented in docs/MCP.md.
What does the budget law simulator actually simulate?It lets you try a hypothetical reallocation of Italy's state budget appropriations (competenza A1) sourced from OpenBDAP, broken down by spending mission.
Can the built-in AI assistant answer questions about my town or about corruption?No, it only handles a set of predefined intents one question at a time, and explicitly does not answer about a single municipality or accept fraud/corruption requests.
How many official sources does the project actually track?The source registry lists 33 official links covering municipal payments, healthcare, education, public debt, EU funds and procurement, among other areas.
Size
2 GB
Stars
344
Updated
CommitOct 18
Age
1mo
Commits · 90 Days