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…

Что это?DoveVannoINostriSoldi — это гражданский опенсорс-проект, который собирает и анализирует данные публичных расходов Италии из официальных источников, используя ИИ, чтобы показать, где публичные ресурсы могли бы использоваться эффективнее. Он также включает симулятор перераспределения бюджетного закона (Legge di Bilancio) на основе ассигнований по обязательствам (commitment-basis) из OpenBDAP.
Это сайт или что-то, что я устанавливаю сам?Это веб-приложение на Next.js, опубликованное на dovevannoinostrisoldi.com, в паре с публичным read-only MCP-сервером, чтобы ИИ-ассистенты могли запрашивать те же проверенные наборы данных.
Как запустить его локально?Склонируйте репозиторий и убедитесь, что у вас Node.js 22.19 или новее, затем используйте стандартные скрипты Next.js: `npm run dev` для локальной разработки, `npm run build` и `npm start` для прода.
Что нужно, кроме Node.js?Node.js 22.19+ — главное требование для запуска сайта; некоторым ETL- и тестовым скриптам также нужна настройка Python, как описано в руководстве для контрибьюторов.
Все ли наборы данных живые и актуальные?Нет, несколько наборов данных — это периодические снимки, а не живые потоки: данные публичных закупок ANAC (CIG 2025) — это проверенный месячный снимок, а не живой поиск по ID контракта или поставщику, а покрытие PNRR ограничено проектами ясель/раннего детства, исключая платежи ReGiS и весь План целиком.
Что можно делать с публичным MCP-сервером?Он открывает 93 read-only набора данных через инструменты вроде listdatasets и querydataset, так что любой MCP-совместимый ИИ-ассистент может напрямую запрашивать проверенные данные о расходах; использование описано в docs/MCP.md.
Что именно симулирует симулятор бюджетного закона?Он позволяет попробовать гипотетическое перераспределение ассигнований госбюджета Италии (competenza A1), взятых из OpenBDAP, с разбивкой по расходным миссиям.
Может ли встроенный ИИ-ассистент отвечать на вопросы о моём городе или о коррупции?Нет, он обрабатывает только набор предопределённых интентов по одному вопросу за раз и явно не отвечает про отдельный муниципалитет и не принимает запросы о мошенничестве/коррупции.
Сколько официальных источников проект реально отслеживает?Реестр источников содержит 33 официальные ссылки, охватывающие муниципальные платежи, здравоохранение, образование, госдолг, фонды ЕС и закупки, среди прочих областей.
Size
2 GB
Stars
345
Updated
CommitOct 16
Age
1mo
Commits · 90 Days