windapp — bias-gecorrigeerde windvoorspelling (v1)
Toont per gekalibreerde locatie de live windvoorspelling, gecorrigeerd met de
in fase 1 geleerde snelheid-bias, plus de modelspreiding als onzekerheidsband.
Eén punt of een route van aaneengeregen gekalibreerde punten. De app rekent niets
opnieuw — hij gebruikt de analyse-artefacten.
Bewust niet in v1 (komt later als de praktijk erom vraagt): blend,
richtingcorrectie, interpolatie naar willekeurige coördinaten.
Stack
Next.js (App Router) · Neon Postgres · Open-Meteo reguliere forecast API ·
Vercel. On-demand fetch met korte TTL-cache in Neon.
Datastromen
- Offline (seed):
recommendation→serving (beste enkele gecorrigeerde model
per locatie×lead, uit outputs/app_serving.csv), locations
(outputs/app_locations.csv) en de snelheid-biastabellen
(outputs/artifacts/bias_*.json). Richtingtabellen worden niet geladen.
- Live: per locatie de aanbevolen + overige modellen uit de reguliere
Open-Meteo API (knopen, UTC, 3 dagen), snelheid-correctie toegepast, resultaat
in
forecast_cache met TTL, dan naar de UI.
Architectuur (losgekoppeld voor latere uitbreiding)
lib/correction.ts — pure snelheid-biascorrectie; identiek aan de Python-fit
(geverifieerd via npm test tegen een cross-language golden file).lib/openmeteo.ts — live fetcher. lib/serving.ts — cache + correctie + band.lib/leads.ts — afstand + passagemoment→lead voor de routeweergave.app/api/* — forecast per locatie, en route. app/* — UI.
Cel-keuze gebeurt live op de voorspelde sector/seizoen/sterkte (offline gefit op
waargenomen cellen) — een onvermijdelijke benadering. Lege cel → grovere cel → ruw,
net als bij de fit.
Lokaal draaien
cd windapp
cp .env.example .env.local # vul DATABASE_URL (Neon) in
npm install
npm run typecheck && npm test # geen DB nodig
npm run seed # laadt artefacten in Neon (DB nodig)
npm run dev # http://localhost:3000
Deploy (Vercel + Neon)
- Maak een Neon-database, zet de connection string als
DATABASE_URL.
npm run seed (eenmalig + bij herijking).- Importeer de repo in Vercel, root =
windapp/, env DATABASE_URL
(+ optioneel FORECAST_TTL_MINUTES). Deploy.
Herijking
De biastabellen verouderen. Vervang de artefacten in outputs/ en draai
npm run seed opnieuw — de app hoeft niet herbouwd te worden.
Locatiedekking
v1 = vaste lijst van de vijf gekalibreerde punten (datagedreven uit de
locations-tabel, dus later uit te breiden). Buiten de meetpunten is de bias niet
onderbouwd; vrije-kaartdekking met expliciet "ongecorrigeerd"-label is een latere stap.
