IsHetAlAfgelast.nl
Check of je amateurvoetbalwedstrijd wordt afgelast vanwege het weer.
Statische site op GitHub Pages; geen backend nodig.
Hoe het werkt
De browser doet alles zelf:
- Plaats opzoeken via de Open-Meteo geocoding-API.
- Weer van de speeldag en de zeven dagen ervoor ophalen (Open-Meteo, één call).
- Het getrainde model draaien in JavaScript (
js/model.js): dezelfde
gekalibreerde logistische regressie als in de Python-repo
voetbal-voorspel-model. predictRaw() in js/engine.js geeft exact
dezelfde uitkomst als predict_full() in Python.
Bovenop het ruwe model zitten twee bewuste correcties in predict():
- Geen idee (veldtype): het model kent alleen gras of kunstgras (in de
trainingsdata is altijd één van de twee bekend). "Geen idee" is daarom een
gewogen mix van beide, met het aandeel gras uit de trainingsdata (~70%).
- Kunstgras gedempt (
KUNSTGRAS_WEIGHT = 0.75): het ruwe kunstgras-effect
is extreem optimistisch bij vorst of een zompige week. Het effect telt voor
75% mee, in logit-ruimte ten opzichte van gras.
Standaard staat het formulier op gras.
Geen server, geen cookies, geen trackers. Gedeelde links (?plaats=…&datum=…)
rekenen de uitslag opnieuw uit.
Bestanden
index.html Homepage en sjabloon voor de plaatspagina's
styles.css Alle vormgeving
js/app.js Formulier, veldkeuring, uitslag, delen, history
js/engine.js Geocoding, weer, model-inferentie, uitleg
js/model.js Geëxporteerde modelgewichten (gegenereerd)
js/scene.js Levende illustraties (regen, rimpels, lampen, Zzz, confetti)
js/stuitproef.js De stuitproef: scheids Henk laat een bal vallen, fysica uit het weer
js/eggs.js Easter eggs: hotspots in de illustraties, Henk-parade, appgroep
sw.js, manifest.webmanifest Installeerbaar + offline schil
art/ Bron-illustraties (niet direct gebruikt)
img/ Gegenereerde web-assets
fonts/ Zelf-gehoste lettertypes
tools/ Generators (zie hieronder)
Generators
python3 tools/build_assets.py --fonts <map met LilitaOne.ttf, Fredoka.ttf>
python3 tools/gen_pages.py
<backend>/.venv/bin/python tools/export_model.py <backend>/data/model.joblib
build_assets.py: scènes, perkamentrol, iconen en OG-afbeelding uit art/.gen_pages.py: plaatspagina's, plaatsenoverzicht, privacy, 404 en
sitemap. Adverteren staat uit (SPONSOR_LIVE = False); op True zetten
maakt sponsor.html, de footerlink en de sitemap-regel weer aan. De homepage is het sjabloon: blokken tussen <!--seo:x--> markers
worden per plaats vervangen. Wijzig index.html en draai dit opnieuw.export_model.py: na hertrainen van het model opnieuw draaien.
De publicatiebuild geeft sw.js automatisch een cacheversie op basis van
alle publieke bestanden. Test de build, niet een oude _site-map.
Lokaal testen
npm ci --ignore-scripts
npm test
npm run build
npx --no-install playwright install chromium
python3 -m http.server 8765 --bind 127.0.0.1 --directory _site
# in een tweede terminal:
npm run test:e2e
tools/e2e.cjs mockt Open-Meteo en loopt de hele flow door: validatie,
uitslag, delen, terug/vooruit, deeplinks, foutgevallen, plaatspagina's en de
easter eggs.
Veilige publicatie
master is beschermd: wijzigingen gaan via een pull request en de verplichte
security-checks. De workflow .github/workflows/pages.yml test het publieke
artefact en publiceert uitsluitend vanaf master; fork-PR's krijgen geen
deployrechten. Actions zijn beperkt tot GitHub Actions en gepind op commit-SHA.
tools/build_site.py maakt een nieuwe _site-map met alleen runtimebestanden.
docs/, tools/, art/, Gitbestanden en lokale configuratie blijven buiten
de website. Bestaat _site al, gebruik dan --output met een nieuwe lege
bestemming of verwijder uitsluitend je eigen oude buildmap vóór opnieuw bouwen.
Een public repo en de benodigde frontend-JavaScript blijven openbaar leesbaar.
HTTPS wordt afgedwongen. API-antwoorden worden gevalideerd en verzoeken hebben
een timeout. Resultaatlinks kunnen bij delen/herladen bij hosting terechtkomen;
zie privacy.html. Er worden geen referrers meegestuurd.
Resterende eigenaarstaken, hostingbeperkingen en incidentherstel staan in
docs/security/BEHEER.md. Een private repo, betaalde hosting of backend is niet
automatisch nodig voor deze statische site.
Algemene afgelasting melden
Legt de KNVB het amateurvoetbal in een regio of het hele land stil, zet dan
status.json aan via een gewone PR:
{
"algemeen_afgelast": true,
"tekst": "De KNVB heeft alle amateurwedstrijden van dit weekend afgelast.",
"bron": "https://www.knvb.nl/nieuws/...",
"tot": "2026-11-29"
}
Home en uitslag tonen dan een rode banner met de tekst (maximaal 200 tekens)
en een link naar de bron. Alleen https:// op knvb.nl of voetbal.nl telt;
een andere bron, een lege tekst of een tot in het verleden laat de banner weg.
Met tot verdwijnt hij vanzelf. Daarna weer "algemeen_afgelast": false.
Easter eggs
Hotspot-coördinaten staan in js/eggs.js (SPOTS) als percentages van de
illustratie. Bij nieuwe art opnieuw meten (pixelrooster over het bronbeeld,
zie de historie van HANDOVER.md). Verder: typ henk of de Konami-code,
klik op Henk in de stuitproef (gele, gele, rode kaart), of op het vaantje in de
kantine (je muis wordt een bal).
DNS
| Type | Naam | Waarde |
|---|
| A | @ | 185.199.108.153 … 185.199.111.153 |
| CNAME | www | <github-username>.github.io |
