# OmgevingsPulse — V0.0.1

**IdeaFactory slot:** 2026-09-25 18:00 Europe/Amsterdam  
**Status:** V0.0.1_BUILT  
**Categorie:** Civic tech / local intelligence

## Pitch

OmgevingsPulse laat in één persoonlijke tijdlijn zien wat er rondom een gekozen adres gaat veranderen. Niet alleen vergunningen, maar ook wegwerkzaamheden, evenementen en verkeersmaatregelen worden samengebracht en vertaald naar verwachte buurtimpact.

## Waarom dit concept

Nederlandse overheidsinformatie is rijk, maar verspreid over verschillende publicatie- en verkeersbronnen. Bestaande diensten richten zich vaak primair op officiële bekendmakingen of vergunningen. OmgevingsPulse kiest een ander uitgangspunt: **wat merk ik hier de komende dagen en weken van?**

Voor de eerste live-adapters zijn onder meer deze officiële bronfamilies relevant:

- KOOP / Officiële bekendmakingen — vergunningen, ruimtelijke plannen en lokale besluiten.
- NDW Open Data — geplande wegwerkzaamheden, evenementen en tijdelijke verkeersmaatregelen.
- DSO / Omgevingswet API's — omgevingsdocumenten en locatiegebonden omgevingsinformatie.

## V0.0.1 bevat

- responsive dark-mode productinterface;
- adres/postcode-invoer als demo-interactie;
- radiuskeuze 500 m / 1 km / 3 km;
- categoriefilters;
- persoonlijke impactscore op basis van de zichtbare demo-items;
- kaartachtige omgevingspreview;
- chronologische impactfeed;
- detailpaneel per item;
- gebied volgen via localStorage;
- bron- en actualiteitslabels;
- volledig statisch te testen zonder buildstap.

## Demo-data

V0.0.1 gebruikt bewust lokale demonstratiedata uit `app.js`. Er worden nog geen live overheidsfeeds opgehaald en locaties/gebeurtenissen in de UI zijn voorbeelddata.

## Testen

Open `index.html` rechtstreeks in een browser of serveer de map via een simpele statische webserver.

Te controleren:

1. mobiel en desktop;
2. filterchips;
3. radiusknoppen;
4. zoekveld;
5. openen/sluiten detailpaneel;
6. knop **Volg dit gebied** blijft na refresh bewaard via localStorage.

## Datastrategie

Een latere backend krijgt provider-adapters die alle bronnen naar één intern eventmodel normaliseren:

```text
source adapters
  ├─ koop_publications
  ├─ ndw_roadworks
  ├─ ndw_events
  ├─ ndw_measures
  └─ dso_environment
          ↓
normalizer
          ↓
geo + impact enrichment
          ↓
OmgevingsPulse API
          ↓
web / mobile clients
```

Een event krijgt minimaal: bron-id, type, titel, samenvatting, geo, start/eind, publicatiedatum, status, impactniveau, bron-url en freshness timestamp.

## V0.0.2 voorstel

De eerstvolgende release zou één echte verticale slice moeten bewijzen:

1. postcode/adres geocoderen;
2. één live bronadapter koppelen (bij voorkeur NDW werkzaamheden/evenementen);
3. resultaten geografisch filteren;
4. echte kaartlaag via Leaflet/OpenStreetMap;
5. broninformatie en laatste synchronisatietijd tonen;
6. server-side cache zodat de frontend nooit rechtstreeks zware bronbestanden hoeft te verwerken.

Daarna kan KOOP/bekendmakingen als tweede adapter worden toegevoegd.