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 是一个公民开源项目,从官方来源收集并分析意大利公共支出数据,利用 AI 揭示公共资源在哪些地方可以更高效地使用。它还包含一个基于 OpenBDAP 承诺口径拨款的预算法(Legge di Bilancio)重新分配模拟器。
它是一个网站,还是要我自己安装的东西?它是一个发布在 dovevannoinostrisoldi.com 的 Next.js Web 应用,同时配有一个公开的只读 MCP 服务器,让 AI 助手可以查询相同的经验证数据集。
怎么在本地运行它?克隆仓库并确保你装有 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 服务器能用来做什么?它通过 listdatasets 和 querydataset 等工具暴露 93 个只读数据集,任何兼容 MCP 的 AI 助手都可以直接查询这些经过验证的支出数据;用法记录在 docs/MCP.md 中。
预算法模拟器实际模拟的是什么?它让你尝试对意大利国家预算拨款(competenza A1,来自 OpenBDAP)进行假设性的重新分配,并按支出使命细分。
内置的 AI 助手能回答关于我所在城镇或腐败的问题吗?不能,它一次只处理一组预定义意图中的一个,并且明确不会回答关于单个市镇的问题,也不接受欺诈/腐败相关的请求。
这个项目实际追踪多少个官方来源?来源登记表列出了 33 个官方链接,涵盖市政付款、医疗、教育、公共债务、欧盟基金和采购等领域。
Size
2 GB
Stars
345
Updated
CommitOct 16
Age
1mo
Commits · 90 Days