Visualize The Budget API

Het verhaal

Eurostat publiceert COFOG-data per land, maar in een vorm die dagen preprocessing vraagt vóór de eerste grafiek staat. Statbel, NBB en FOD Financiën vullen het bij, elk met een eigen formaat en cadans. Wie iets met Europese begrotingsdata wil doen, bouwt eerst een eigen datapipeline. Lefief bouwde Visualize The Budget als platform dat al die bronnen ingest, normaliseert tot één schema en aanbiedt via één API. Tier-gated: Free voor publieke COFOG-data, Tier 1 voor diepere uitsplitsingen per ESA-transactietype (lonen, sociale uitkeringen, investeringen, intermediair verbruik), Admin voor ingestbeheer. De vraag "waar gaat een euro overheid naartoe" wordt beantwoordbaar tot op transactieniveau, zonder zelf een datapipeline te bouwen.

Overwegingen

• Granulariteit voorbij COFOG

  Bovenop COFOG-functies splitst het schema elk bedrag verder uit naar ESA-transactietype. Geen kant-en-klare publieke API levert de COFOG × ESA-matrix in één call.

• Multi-source ingest, één schema

  Eurostat, Statbel, NBB en FOD Financiën worden automatisch ingelezen en gemapt naar één gemeenschappelijk model. De API verbergt dat de bronnen heterogeen rapporteren.

• OAuth2 met tier-gating

  Google OIDC nu, Apple klaar voor activatie. Endpoints zijn afgeschermd via expliciete annotaties (Free, Tier 1, Admin) met rate-limits in een AOP-aspect, geen ifs in de business-code.

• Onion-architectuur

  Het domein kent geen Spring of JPA, dependencies wijzen enkel naar binnen. Database of webframework vervangen raakt de business-logica niet aan.

• Flyway, geen ad-hoc DDL

  Elke schema-wijziging is een migratie. Hibernate weigert te starten als entity en database divergeren, dus dev en productie kunnen niet stilletjes uit elkaar groeien.

• Composable snapshot-endpoint

  Eén /snapshot-call met include-tokens bepaalt welke panels meekomen (debt-composition, expenditure-composition, real-activity). Frontend kiest, backend levert in één request.

Resultaat

Denkbare uitbreidingen

Zo kan Visualize The Budget API verder groeien.