Files
SluijsensandClaude Opus 5.5 069c7cb7eb Adds AI-DLC construction docs for the front-end shell feature
Functional design, NFR requirements, code generation plan and summary,
and build-and-test instructions with results.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-18 17:05:03 +02:00

96 lines
6.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Functional Design Change Questions — SEO, schermlezers, responsive, hergebruik
Je vroeg om SEO, schermlezers, responsive design en hergebruik via Chakra/thema meteen mee te nemen. Het grootste deel kan ik op vaste uitgangspunten uitwerken (zie "Wordt uitgewerkt zonder vraag"). Hieronder staan alleen de punten waar een echte keuze in zit. Vul per vraag de letter in na `[Answer]:`. Waar ik een voorkeur heb staat **(aanbevolen)**.
## Wordt uitgewerkt zonder vraag
**SEO**
- Per pagina een unieke titel en beschrijving (bestaat al via `pageHead`). Placeholderpagina's en 404/fout krijgen `noindex`, zodat een lege "in de maak"-pagina niet in Google komt. Zodra de echte inhoud er staat, gaat `noindex` eraf.
- Eén `h1` per pagina, koppen in logische volgorde (geen niveaus overslaan). Footerkoppen zijn `h2`, opgemaakt als eyebrow: het zijn hoofdsecties van de pagina (gecorrigeerd bij het uitwerken, zie BR-SEO-09).
- Interne links zijn echte `<a href>`-links (geen klik-handlers op `div`s), zodat zoekmachines ze kunnen volgen.
- Alle afbeeldingen hebben een betekenisvolle `alt`, decoratieve krijgen `alt=""`.
**Schermlezers**
- `lang="nl"` (staat al), landmarks `header`/`nav`/`main`/`footer` met Nederlandse labels.
- Skip link, zichtbare focusstijl op alles wat focus kan krijgen, en die focusstijl komt **op één plek uit het thema** in plaats van per component.
- Iconen zijn `aria-hidden`; knoppen met alleen een icoon hebben een `aria-label`.
- Externe links die in een nieuw tabblad openen, melden dat aan schermlezers ("opent in nieuw tabblad", visueel verborgen).
- Respecteren van `prefers-reduced-motion`.
**Responsive**
- Mobile-first, met de standaard Chakra-breakpoints (`sm` 480, `md` 768, `lg` 1024, `xl` 1280, `2xl` 1536). Per component een tabel met wat er per breakpoint verandert.
- Werkt van 320px breed tot 32:9 zonder horizontaal scrollen; tekst kan 200% vergroot worden zonder dat er iets wegvalt.
- Klikdoelen minimaal 44×44px op touch (menu, footerlinks, to-top).
**Hergebruik via Chakra en het thema**
- Een overzicht per component van welke tokens, text styles en recipes het gebruikt, en welke nieuwe gedeelde stukken erbij komen (bv. één `pageTitle`-text style voor de `h1` van PageIntro en StatusPage, één `focusRing` voor de hele site, z-index-tokens voor header/menu/to-top in plaats van losse getallen).
- Geen waarden die al als token bestaan, opnieuw hard in een component.
---
## Questions
### Vraag 1: Link-previews en crawlers die geen JavaScript uitvoeren
De site wordt in de browser opgebouwd. Google voert JavaScript uit en ziet dus de juiste titel per pagina. **WhatsApp, Facebook en LinkedIn doen dat niet**: die zien bij elke pagina alleen de vaste fallback uit `index.html` (de homepage-titel). Dat los je alleen op door de pagina's bij het bouwen al als HTML te genereren ("prerendering").
A) Nu nog niet prerenderen, maar alles zo bouwen dat het later zonder ombouw kan: alle head-data via de route-`head`, geen `window`/`document` tijdens het renderen, content via props. Prerendering wordt een vervolgpunt bij hosting/Operations. **(aanbevolen)** Prerendering is pas zinvol als er echte pagina-inhoud is; nu zijn het placeholders.
B) Nu al prerendering toevoegen in deze feature (een build-stap die per route statische HTML maakt). Grotere scope en een extra afhankelijkheid.
X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
### Vraag 2: Domein voor canonical-URL's en `og:url`
Voor canonical-URL's (voorkomt dubbele pagina's in Google) en voor link-previews is het definitieve adres nodig.
A) `https://andreaslop.nl` (zonder www) **(aanbevolen)** Komt overeen met het e-maildomein; `www` stuurt de host dan door.
B) `https://www.andreaslop.nl`
X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
### Vraag 3: Afbeelding voor link-previews (`og:image`)
Zonder `og:image` tonen WhatsApp en Facebook een preview zonder plaatje.
A) Eén vaste site-brede afbeelding (een uitsnede van een hero-foto, 1200×630), die een pagina later kan overschrijven met een eigen beeld **(aanbevolen)**
B) Het logo als preview-afbeelding
C) Nog geen `og:image`
X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
### Vraag 4: Gestructureerde data voor Google (JSON-LD)
Met gestructureerde data begrijpt Google dat dit een lokale fotograaf is (naam, plaats, socials). Dat helpt bij lokaal zoeken ("fotograaf Huizen").
A) Ja, site-breed één `ProfessionalService`-blok met naam, website, regio Huizen, logo en de social-links. **Zonder e-mailadres**, anders staat het adres alsnog leesbaar in de pagina. **(aanbevolen)**
B) Nog niet, later met de echte pagina's
X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
### Vraag 5: `robots.txt` en `sitemap.xml`
A) Beide als statisch bestand in `public/`. De sitemap bevat alleen de geïndexeerde pagina's (nu: home) en wordt bijgewerkt zodra er een pagina live gaat. Een test controleert dat de sitemap en de routes niet uit elkaar lopen. **(aanbevolen)**
B) De sitemap wordt bij elke build automatisch gemaakt uit de routes. Meer werk nu, maar niets handmatig bij te houden.
C) Later, bij hosting/Operations
X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: B is het makkelijkste. Hoeveel meerwerk is het en hoe wordt het automatisch opgebouwd? Hoe betrouwbaar is het? Bij teveel gedoe of onzekerheden is A het beste. Anders B, met eventueel de test uit optie A
### Vraag 6: Paginawissel aankondigen aan schermlezers
Bij een gewone website leest een schermlezer na een klik de nieuwe pagina voor. In een app als deze gebeurt dat niet vanzelf: de inhoud wisselt, maar de schermlezer merkt het niet.
A) Na elke paginawissel (niet bij de eerste keer laden) gaat de focus naar `main#main`, net als bij de skip link en de to-top-knop. De schermlezer leest dan de nieuwe inhoud vanaf het begin. **(aanbevolen)** Eén consistent gedrag.
B) De focus blijft staan en een onzichtbaar meldingsgebied leest de nieuwe paginatitel voor ("Portfolio, pagina geladen")
X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A