Laadgids
pSEO-site voor thuisladen en EV-fiscaliteit in de Benelux. Spec: CLAUDE.md, visueel systeem: DESIGN.md.
Starten
PowerShell (Windows):
pnpm install
Copy-Item .env.example .env.local # leeg laten = lokale seed-data, geen Supabase nodig
pnpm dev # http://localhost:3000/nl-be
pnpm test # calc, rules, hreflang, related, lead-matching
pnpm typecheck; pnpm lint
Bash / macOS / Linux:
pnpm install
cp .env.example .env.local
pnpm dev
pnpm test
pnpm typecheck && pnpm lint
Voorbeeldpagina's zonder database:
/nl-be/laadpaal-voor/tesla-model-3-rwd-2025 (11 kW, capaciteitstarief Vlaanderen)/nl-be/laadpaal-voor/peugeot-e-208-51-2025 (7,4 kW 1-fasig: twee rijen "geen winst")/fr-be/borne-pour/renault-zoe-r135-52-2023 (22 kW, Wallonië: geen piekblok)/design-lab (alle componenten met voorbeelddata)
Supabase
- Voer
supabase/migrations/0001_init.up.sql uit (idempotent; down-migratie ernaast).
- Zet de env-variabelen uit
.env.example.
pnpm seed laadt data/seed/*.json; pnpm recalc-pages zet pages.status volgens het indexatiebeleid (CLAUDE.md 4.3) en triggert revalidate.
Regels en tarieven met TODO(verify in notes houden alle afhankelijke pagina's op noindex. Verwijder de TODO pas na controle bij de bron.
Structuur
| Map | Inhoud |
|---|
lib/calc/ | Pure rekenfuncties + tests, zie lib/calc/README.md |
lib/rules/ | Zod-schema's voor rules.params, regelselectie op datum |
lib/copy/ | Alle tekst per locale (nl-BE, fr-BE, nl-NL) |
lib/seo/ | hreflang (alternates.ts), interne links (related.ts) |
lib/db/ | Repo-interface, Supabase-implementatie, lokale seed-implementatie, gecachte loaders met tags |
lib/pages/ | Indexatiebeleid (status.ts), assemblage P1-pagina (charger.ts), route-helper |
lib/lead/ | Zod-schema, installateursmatching, rate-limit, Resend-mails |
components/ | UI-componenten volgens DESIGN.md; alleen LeadForm is client-side |
app/[locale]/(pseo)/ | laadpaal-voor/[slug] (nl) en borne-pour/[slug] (fr) |
app/api/revalidate | On-demand revalidate, Authorization: Bearer <REVALIDATE_SECRET> |
scripts/ | seed, import-specs, recalc-pages, audit-sources, screenshot |
On-demand revalidate
PowerShell:
Invoke-RestMethod -Method Post -Uri "$env:NEXT_PUBLIC_SITE_URL/api/revalidate" `
-Headers @{ authorization = "Bearer $env:REVALIDATE_SECRET" } -ContentType "application/json" `
-Body '{"tags":["rules:BE","tariffs:BE","pages"]}'
Bash:
curl -X POST $NEXT_PUBLIC_SITE_URL/api/revalidate \
-H "authorization: Bearer $REVALIDATE_SECRET" -H "content-type: application/json" \
-d '{"tags":["rules:BE","tariffs:BE","pages"]}'
Tags: version:{slug}, rules:{BE|NL}, tariffs:{BE|NL}, pages:{locale}, pages, versions.
Open data als staging voor specs
Open bronnen landen in spec_candidates (migratie 0002), nooit rechtstreeks in versions. Zonder Supabase-env schrijven de scripts naar data/import/candidates/.
pnpm fetch-open-ev-data # laatste release naar data/import/
pnpm import-open-ev-data data/import/open-ev-data-v1.24.0.json # github.com/open-ev-data/open-ev-data-dataset
pnpm review-candidates --make tesla # of zonder filter
review-candidates schrijft data/import/review/report.txt (matches en conflicten per bestaande versie, drempel 3 %, fasen exact) en data/import/review/new-versions.csv voor onbekende modellen. Die CSV heeft het formaat van import-specs, maar zonder spec_source_url en spec_source_date: die vul je in vanuit de fabrikantenprijslijst voor je importeert. De dataset bevat geen WLTP-verbruik; dat veld blijft leeg tot de prijslijst het invult. De kolom oem_source_url_suggested is de fabrikantenbron die de dataset opgeeft: een startpunt om te controleren, geen bewijs.
EEA-inschrijvingen als prioriteit
pnpm fetch-eea --min 5 # via de EEA Discodata SQL-endpoint, geen download nodig
pnpm review-candidates
fetch-eea laat de EEA-server zelf tellen per variant voor BE en NL (tabelnaam met --table, standaard co2cars_2025Pv31; de naam staat op de Datahub-pagina onder "SQL Rest Endpoint"). Het oudere import-eea leest hetzelfde uit een gedownload CSV-jaarbestand. review-candidates gebruikt die tellingen om new-versions.csv op volume te sorteren en vult de kolommen registrations_be en registrations_nl. Kolomnamen wijken per jaargang af; pas ze zo nodig aan in lib/specs/eea.ts.
Regelpagina's en statische pagina's
Regelpagina's (template rule) bestaan alleen als er een entry staat in lib/content/rules.ts; de tekst is handgeschreven, met bronnen en datum. Over, contact en privacy staan in lib/content/static.ts.
Leads verzamelen zonder installateurs
Een lead wordt altijd opgeslagen in leads (status new) met het tijdstip van toestemming. Daarna:
- Is er een actieve installateur voor de postcode (
installers.regions: postcodeprefix of gewest), dan gaat de lead meteen naar maximaal drie installateurs en krijgt status forwarded.
- Is er geen installateur, dan blijft de lead op
new staan. De aanvrager krijgt een bevestiging dat de aanvraag binnen vier weken doorgestuurd wordt. De toestemmingstekst dekt dat uitstel.
- Elke lead gaat ook naar
LEAD_NOTIFY_EMAIL, met de status erbij.
Wachtrij doorsturen zodra er installateurs zijn:
pnpm forward-leads --dry # toont wie wat zou krijgen
pnpm forward-leads # verstuurt en zet status forwarded
pnpm forward-leads --max-age-days 42
Leads ouder dan --max-age-days (standaard 42) krijgen status expired en worden niet meer doorgestuurd. Zonder RESEND_API_KEY worden mails alleen gelogd. De testinstallateur in de seed staat op inactief; activeer nooit een installateur met een niet-bestaand e-mailadres, want een doorgestuurde lead komt niet terug in de wachtrij.
