Files
AndreaSlopFotografie/aidlc-docs/features/prerendering/inception/requirements/requirement-verification-questions.md
T
SluijsensandClaude Opus 5.5 65c850e949 Adds the prerendering requirements, design and baseline
Records the requirements, execution plan, application design, the first unit's
functional design and code generation plan, and the baseline on master.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-31 17:41:12 +01:00

7.8 KiB

Vragen bij de requirements: prerendering

Vul achter elke [Answer]: de letter van je keuze in. Past geen enkele optie, kies dan de laatste (Anders) en licht je keuze toe. Bij elke vraag staat welke optie ik aanbeveel en waarom.

Wat prerendering hier betekent: nu krijgt een bezoeker een lege index.html en bouwt JavaScript daarna de pagina op. Met prerendering maakt de build voor elke pagina vast een HTML-bestand met de volledige inhoud. De browser en Google zien de tekst en foto's dan meteen, en daarna maakt React de pagina interactief ("hydration").

Vaste uitgangspunten, hierover hoef je niets te beslissen:

  • De URL's blijven gelijk, dus zonder / aan het eind (/over-mij).
  • De hosting blijft statisch: nginx op test en IIS op productie, zonder Node-server.
  • De strenge beveiligingsheaders (CSP) blijven zoals ze zijn.
  • Links met een zoekparameter, zoals /?pakket=... en /portfolio?shoot=..., blijven werken.

Vraag 1

Welke pagina's krijgen een eigen vooraf gebouwd HTML-bestand?

  • A) Alle bestaande pagina's: de 10 geïndexeerde pagina's plus /privacyverklaring (aanbevolen: één werkwijze voor de hele site)
  • B) Alleen de 10 geïndexeerde pagina's; /privacyverklaring blijft client-side
  • C) Eerst alleen de homepage en de foto-pagina's die nu onder het Lighthouse-doel zitten
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Vraag 2

Met welke techniek bouwen we de HTML?

  • A) Een eigen build-stap met Vite: React rendert elke route naar HTML en de bestaande app blijft verder hetzelfde. Dit is aanbevolen, want het is de kleinste wijziging, er zijn geen inline scripts nodig die de CSP blokkeert, en de pagina's halen nu nergens data op die mee moet.
  • B) Overstappen op TanStack Start, het framework bij onze router, met statische prerendering. Dit is meer standaard, maar een grotere ombouw, en de inline scripts kunnen botsen met de CSP (nog te controleren).
  • C) Na de build elke pagina in een headless browser openen en de HTML opslaan. De code blijft ongewijzigd, maar elke build heeft dan Chromium nodig en de opgeslagen stijlen en toestand zijn kwetsbaarder.
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Vraag 3

Veel blokken faden nu in bij het scrollen (Reveal, 21 keer in 14 bestanden) en zijn tot dan onzichtbaar. In vooraf gebouwde HTML zouden ze onzichtbaar blijven totdat de JavaScript draait, en dat kost juist de snelheidswinst. Wat moet er gebeuren?

  • A) De animatie blijft, maar wat bij het laden al in beeld is, staat er direct zonder fade-in. Lager op de pagina blijft de fade-in werken. Aanbevolen: zo blijft het effect bestaan en verschijnt de eerste foto meteen. Dit vervangt je eerdere keuze om de fade-in op de eerste foto van de shootpagina's te laten staan.
  • B) De fade-in overal behouden zoals nu, ook bovenaan. De grootste foto verschijnt dan nog steeds pas na de JavaScript, dus de winst op die pagina's blijft beperkt.
  • C) De fade-in overal verwijderen
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Vraag 4

Wat moet er werken bij een bezoeker of crawler zonder JavaScript?

  • A) Alle tekst, foto's en links zijn zichtbaar en werken. Menu's op mobiel, de slider, de lightbox en het formulier hebben JavaScript nodig. Aanbevolen: dit dekt SEO en link-previews zonder dat we onderdelen dubbel moeten bouwen.
  • B) Zoals A, maar het mobiele menu werkt ook zonder JavaScript. Dat kost extra bouw- en testwerk.
  • C) Geen eis: alleen de HTML voor crawlers telt, ook als er zonder JavaScript onderdelen verborgen blijven
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Vraag 5

Een onbekende URL krijgt nu de app terug met HTTP-status 200, en de router toont daarna de 404-pagina. Google kan dat zien als een "soft 404". Wat wil je?

  • A) Een vooraf gebouwde 404-pagina met een echte HTTP-status 404, op nginx én IIS (aanbevolen: goed voor SEO, en de serverconfig wordt toch al aangepast). De twee extra knoppen op de 404-pagina onder /soorten-fotoshoots/ blijven: de pagina kan die pas in de browser tonen, omdat ze afhangen van de opgevraagde URL.
  • B) Zo laten en dit later apart oppakken
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Vraag 6

Horen responsive foto's (meerdere formaten per foto, zodat een telefoon kleinere bestanden laadt) bij deze feature? In lighthouserc.cjs staat dat minder bytes aan foto's de score op de gemeten foto-pagina's niet verbeterden, en de homepagefoto's zijn nog niet responsive.

  • A) Nee, alleen prerendering, plus een preload van de belangrijkste foto per pagina. Responsive foto's worden een aparte feature. Aanbevolen: het houdt deze feature klein en laat apart zien wat prerendering oplevert.
  • B) Ja, responsive foto's horen er meteen bij
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Vraag 7

De Lighthouse-doelen voor mobiel zijn tijdelijk verlaagd "tot prerendering" (homepage 0,8, foto-pagina's 0,85). Prerendering versnelt het eerste beeld, maar de hoeveelheid JavaScript blijft gelijk, dus 0,9 is niet gegarandeerd. Wat is het doel?

  • A) Mikken op 0,9 op alle pagina's. Haalt een pagina dat niet, dan laat ik je de meting zien en beslis jij per pagina. Aanbevolen: het doel blijft ambitieus en we verlagen niets ongemerkt.
  • B) 0,9 is een harde eis: de feature is pas af als alle pagina's het halen, ook als daar extra werk aan de JavaScript-bundel voor nodig is
  • C) Geen vast nieuw doel: de doelen verhogen tot wat de metingen laten zien
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Vraag 8

De inhoud staat nu in de code, en later komt er een API/CMS. Met prerendering komt die inhoud vast in de HTML te staan. Hoe gaan we daar nu mee om?

  • A) De HTML wordt bij elke build gemaakt uit de huidige inhoud. Automatisch opnieuw bouwen bij een CMS-wijziging wordt onderdeel van de latere CMS-feature; ik leg dit als aandachtspunt vast. Aanbevolen: het CMS bestaat nog niet, dus we bouwen er nu niets voor.
  • B) Nu al een manier inbouwen om de build van buitenaf te starten (voorbereiding op het CMS)
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Vraag: Beveiligingsextensies

Moeten de beveiligingsregels als harde vereisten worden afgedwongen voor deze feature?

  • A) Ja — dwing alle BEVEILIGINGSREGELS af als blokkerende vereisten (aanbevolen voor productietoepassingen, en zo ook gekozen bij shoot-type-pages)
  • B) Nee — sla alle BEVEILIGINGSREGELS over (geschikt voor PoC's, prototypes en experimentele projecten)
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Vraag: Property-Based Testing Extensie

Moeten de property-based testing (PBT) regels worden afgedwongen voor deze feature?

  • A) Ja — dwing alle PBT-regels af als blokkerende vereisten (aanbevolen voor projecten met bedrijfslogica, datatransformaties, serialisatie of stateful componenten; zo ook gekozen bij shoot-type-pages)
  • B) Gedeeltelijk — dwing PBT-regels alleen af voor pure functies en serialisatie round-trips (geschikt voor projecten met beperkte algoritmische complexiteit)
  • C) Nee — sla alle PBT-regels over (geschikt voor eenvoudige CRUD-applicaties, UI-only projecten of dunne integratielagen zonder significante bedrijfslogica)
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Vraag: Operations-fase

Moet deze feature na Construction door de Operations-fase (deployment en monitoring inrichten)? De aanpassingen aan de serverconfig en CI-workflow horen sowieso bij Construction. Alleen de nginx-config op de Pi moet daarna nog met de hand worden bijgewerkt.

  • A) Ja — na Construction de Operations-fase uitvoeren (deployment en monitoring inrichten)
  • B) Nee — stoppen na Build and Test (aanbevolen: de bestaande deployment en monitoring blijven gelijk, en zo ook gekozen bij shoot-type-pages)
  • C) Weet ik nog niet — vraag het opnieuw na de Construction-fase
  • X) Anders (beschrijf hieronder na de Answer:-tag)