Adds the inception docs and design for the homepage sections

Refreshes the shared reverse engineering docs, adds the requirements,
application design and units for the homepage-sections feature, and
updates the static design: live prices and form fields, the new
Lieve woorden block and the coming-soon gate over the contact form.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-19 23:46:30 +02:00
co-authored by Claude Opus 5.5
parent 38c5c3e262
commit c81dcd3979
33 changed files with 2354 additions and 275 deletions
@@ -0,0 +1,213 @@
# Verificatievragen — Homepage-secties
Al vastgelegd (geen vraag nodig):
- **Zes blokken** onder de hero, elk een eigen unit: Lifestyle fotografie, Over mij, Prijzen, **Lieve woorden** (nieuw, van de live site), Contact en **Instagram**.
- **Contactformulier**: wordt gebouwd, inclusief anti-spam en een robotcheck, maar staat achter een **overlay** met de tekst dat het formulier binnenkort komt en dat je voor nu mailt naar info@andreaslop.nl. Het e-mailadres in de overlay komt uit `siteContent.email` en wordt pas in de browser samengevoegd, net als in de footer (anti-spam).
- **Layout en stijl** komen uit het ontwerp (`design/andreaslop-static`). Teksten en afbeeldingen staan als vaste data in `content/`, in de vorm die de API straks levert.
- **"Lees mijn verhaal"** in het blok Over mij linkt naar `/over-mij` (nu nog een placeholder).
Wat ik op de live site (andreaslop.nl) zag en wat afwijkt van het ontwerp:
| Onderdeel | Ontwerp | Live site |
| ------------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Prijzen | Newborn € 185, Zwangerschap € 175, **Loveshoot** € 175 · "1 uur, 15–20 foto's" | Zwangerschap € 175, Newborn € 185, **Gezin** € 175 · "1 uur (newborn 1–2 uur), minstens 30/40 zorgvuldig nabewerkte foto's, persoonlijke online fotogalerij" |
| Galerij | intro-1 t/m 4 | 4 andere, nieuwere foto's (2025/2026) |
| Formulier | Naam, E-mail, Onderwerp (vrije tekst), Bericht | Naam, E-mail, **"In welke shoot heb je interesse?"** (Zwangerschap / Newborn / Familie / Overig), Bericht · knop "(Aan)vraag versturen" |
| Lieve woorden | ontbreekt | slider met per review een foto, de soort shoot als titel, de tekst en de namen (2 reviews: Trouwshoot – Majella & Mark, Newbornshoot – Demi & Kevin) |
| Instagram | raster van 6 vaste foto's met link naar het profiel | WordPress-widget die op dit moment **niet werkt** ("you haven't connected with your Instagram account") |
Vul per vraag de letter in na `[Answer]:`. Past geen enkele optie, kies dan de laatste (Anders) en licht toe.
---
## Vraag 1: Bron voor de inhoud
Waar komen teksten, prijzen en foto's vandaan als ontwerp en live site verschillen?
- A) De live site voor de inhoud (prijzen, pakketten, galerijfoto's, formuliervelden, reviews) en het ontwerp voor layout en stijl. De live site is het nieuwst. (aanbevolen)
- B) Het ontwerp voor alles; de live inhoud zet Andrea later via de API/CMS goed
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 2: Ontwerp van "Lieve woorden"
Hoe moet het blok eruitzien? In alle varianten: kop "Lieve woorden", de stijl van het ontwerp (Marcellus-koppen, papierkleuren, heidegroen accent) en per review de soort shoot, de tekst en de namen.
- A) **Eén review tegelijk, groot.** Foto links, aan de rechterkant een groot aanhalingsteken als decoratie, de soort shoot als label, de tekst in Marcellus en daaronder de namen. Vorige/volgende-knoppen en puntjes; **geen automatisch doorspelen**. Lijkt het meest op de live site en blijft rustig. (aanbevolen)
- B) **Kaarten naast elkaar.** Twee of drie kaarten in een raster (op mobiel onder elkaar), elk met een kleine ronde foto, de tekst en de namen. Geen slider: alle reviews zijn meteen zichtbaar. Werkt goed tot ongeveer 3–6 reviews.
- C) **Alleen tekst, gecentreerd.** Eén grote quote zonder foto op een `paper.alt`-achtergrond, met vorige/volgende-knoppen. Het meest minimalistisch; de foto's van de live site vervallen.
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 3: Ontwerp eerst in de statische design-map?
Het ontwerp in `design/andreaslop-static` is de bron voor layout ([LAYOUT.md](../../../../../LAYOUT.md)). Lieve woorden staat er nog niet in.
- A) Ja: eerst het gekozen ontwerp toevoegen aan `design/andreaslop-static` (index.html + style.css) en [LAYOUT.md](../../../../../LAYOUT.md) bijwerken. Dan kun je het in de browser bekijken en goedkeuren voordat het in React komt. De inhoud van het ontwerp (prijzen, formuliervelden) zet ik daarbij ook gelijk aan de live site, als je bij vraag 1 voor A kiest. (aanbevolen)
- B) Alleen [LAYOUT.md](../../../../../LAYOUT.md) bijwerken en het ontwerp direct in React bouwen; de statische map blijft zoals hij is
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 4: Positie van "Lieve woorden"
Op de live site staat het blok tussen Prijzen en Contact.
- A) Tussen Prijzen en Contact, zoals op de live site. Volgorde: Hero, Lifestyle fotografie, Over mij, Prijzen, Lieve woorden, Contact, Instagram (aanbevolen)
- B) Tussen Over mij en Prijzen
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 5: Foto's
De foto's van de live site (galerij, Andrea, reviews) moeten in de repo komen. Hoe gaan we daarmee om?
- A) Ik download ze van andreaslop.nl, verklein ze eenmalig (maximaal ±1600 px breed, goed gecomprimeerd) en zet ze in `web/src/assets`. Geen nieuwe dependency, en de homepage blijft binnen het Lighthouse-budget. (aanbevolen)
- B) Zoals A, maar ook automatisch meerdere formaten (srcset/WebP) bij het bouwen, met een Vite-plugin. Dat is een nieuwe dependency; het verhelpt ook de bekende schuld bij de hero-foto's.
- C) Andrea levert de foto's zelf aan; tot die tijd gebruik ik de foto's uit het ontwerp
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 6: Instagram-blok
Een echte live feed kan alleen via de API van Meta met een toegangstoken. Op een statische site staat dat token voor iedereen leesbaar in de browser. Een externe widget laadt scripts en cookies van derden, en daarvoor moet de CSP worden aangepast.
- A) Kop "Instagram", @andreaslopfotografie als link en een raster van 6 vast gekozen foto's die naar het profiel linken, zoals in het ontwerp. De lijst foto's staat in `content/`, zodat de .NET API hem later kan vullen met de echte feed (die haalt hem dan veilig op aan de serverkant). (aanbevolen)
- B) Een externe widget (bijv. Behold of SnapWidget) voor een live feed nu al, inclusief CSP-aanpassing en een vermelding in de privacyverklaring
- C) Alleen de kop, de handle en een knop "Volg mij op Instagram", zonder foto's
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 7: Velden van het contactformulier
- A) Zoals op de live site: Naam, E-mail, "In welke shoot heb je interesse?" (keuzelijst) en Bericht, met de knop "(Aan)vraag versturen" (aanbevolen)
- B) Zoals in het ontwerp: Naam, E-mail, Onderwerp (vrije tekst) en Bericht, met de knop "Verzenden"
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 8: Keuzes in de keuzelijst (alleen bij 7A)
Op de live site heet het pakket **Gezin**, maar in de keuzelijst staat **Familie**.
- A) Dezelfde namen als de pakketten: Zwangerschap, Newborn, Gezin, Overig. De lijst komt dan uit dezelfde data als de prijskaarten en loopt daardoor nooit uit de pas. (aanbevolen)
- B) Precies zoals live: Zwangerschap, Newborn, Familie, Overig
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 9: Knop "Boek je shoot" bij de prijskaarten
- A) Scrollt naar het contactblok op de homepage en kiest het bijbehorende pakket alvast in de keuzelijst. Nu het formulier nog achter de overlay zit, kom je zo direct bij de e-mailtekst uit. (aanbevolen)
- B) Scrollt alleen naar het contactblok, zonder iets voor te kiezen
- C) Gaat naar de pagina `/contact` (nu nog een placeholder)
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 10: De overlay over het formulier
Wat ziet en kan een bezoeker zolang het formulier nog niet werkt?
- A) Het formulier is zichtbaar maar gedempt (vervaagd) en is **niet** te bedienen: de velden zijn `inert`, dus toetsenbord- en schermlezergebruikers komen niet in een formulier terecht dat niets doet. Over het formulier staat een paneel met de tekst "Het contactformulier komt binnenkort. Mail me voor nu op info@andreaslop.nl" en een knop "Stuur een e-mail" (mailto). (aanbevolen)
- B) Zoals A, maar het formulier is wel in te vullen; bij Verzenden opent het e-mailprogramma met de ingevulde gegevens (naam, shoot en bericht al in de mail)
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 11: Hoe zetten we de overlay later uit?
- A) Met één instelling in de code (bijv. `contactFormEnabled: false`), gekoppeld aan de verzendfunctie `submitContactForm`. Als de API er is: de functie invullen en de instelling op `true` zetten (aanbevolen)
- B) Als het formulier aangaat, haal ik de overlay helemaal weg; nu geen instelling
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A, Als we het er dan toch inbouwen dan kan ik het later ook makkelijk uitzetten mocht dat nodig zijn.
## Vraag 12: Anti-spam
Welke maatregelen bouwen we nu al in het formulier? Let op: echte bescherming vraagt altijd ook controle aan de serverkant (de API). Wat hier staat, is de kant van de browser.
- A) Een honeypot (verborgen veld dat alleen bots invullen) en een tijdcheck (minder dan ±3 seconden tussen laden en verzenden = bot). Beide als kleine, geteste functies in `lib/`. Daarnaast een maximale lengte per veld. Rate limiting en de echte controle komen in de API-feature. (aanbevolen)
- B) Alleen een honeypot
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 13: Robotcheck (captcha)
Een captcha geeft een token dat de server moet controleren. Zonder API kan het formulier de check dus nog niet echt gebruiken.
- A) **Nu kiezen, inbouwen in de API-feature.** We kiezen nu de dienst (zie vraag 14) en leggen dat vast. Het formulier krijgt een plek voor de widget, maar het script wordt pas geladen als het formulier aangaat. Zo komt er nu geen script van derden op de site voor een formulier dat nog niets doet. (aanbevolen)
- B) **Nu al inbouwen** achter de overlay, inclusief CSP-aanpassing (script-src, frame-src, connect-src) en een vermelding in de privacyverklaring
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 14: Welke robotcheck?
- A) **Cloudflare Turnstile**: gratis, meestal onzichtbaar (geen puzzels), zonder tracking-cookies. Een goede balans tussen gemak en privacy (aanbevolen)
- B) **Friendly Captcha**: Europees (Duits), volledig AVG-gericht, onzichtbaar (proof-of-work); gratis voor kleine sites
- C) **hCaptcha**: gratis, maar vaker puzzels voor bezoekers
- D) **Google reCAPTCHA**: bekend, maar stuurt gegevens naar Google; minder geschikt onder de AVG
- E) Nog niet kiezen; beslissen in de API-feature
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: B
## Vraag 15: Animatie bij het scrollen
Het ontwerp laat blokken zacht invagen bij het scrollen (`.reveal`).
- A) Ja, overnemen als kleine hook (`useReveal` met IntersectionObserver), uitgeschakeld bij `prefers-reduced-motion`. Zonder JavaScript of observer is de inhoud gewoon zichtbaar (aanbevolen)
- B) Nee, geen scroll-animaties
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 16: De pagina /contact
Het contactformulier wordt een herbruikbaar component. Komt het in deze feature ook op `/contact`?
- A) Nee, `/contact` blijft een placeholder. De contactpagina wordt een eigen feature en gebruikt dan hetzelfde component (aanbevolen)
- B) Ja, het formulier (met overlay) komt ook op `/contact`
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag: Beveiligingsextensies
Moeten de beveiligingsregels als harde vereisten worden afgedwongen voor dit project? (Bij de shell stond dit op Ja.)
- A) Ja — dwing alle BEVEILIGINGSREGELS af als blokkerende vereisten (aanbevolen voor productietoepassingen)
- B) Nee — sla alle BEVEILIGINGSREGELS over (geschikt voor PoC's, prototypes en experimentele projecten)
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag: Property-Based Testing Extensie
Moeten de property-based testing (PBT) regels worden afgedwongen voor dit project? (Bij de shell stond dit op Ja, volledig.)
- A) Ja — dwing alle PBT-regels af als blokkerende vereisten (aanbevolen voor projecten met bedrijfslogica, datatransformaties, serialisatie of stateful componenten)
- 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)
[Answer]: A
## Vraag: Operations-fase
Moet deze feature na Construction door de Operations-fase (deployment en monitoring)? De pipeline en monitoring bestaan al sinds de shell.
- A) Ja — draai de Operations-fase na Construction (deployment + monitoring)
- B) Nee — stop na Build and Test; de bestaande pipeline deployt naar test bij een merge naar master
- C) Weet ik nog niet — vraag het me opnieuw na de Construction-fase
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: C
@@ -0,0 +1,212 @@
# Requirements — Homepage Sections
## Intent Analysis
- **User Request**: add the homepage blocks below the existing hero with AI-DLC, one feature with one unit per block; suggest a temporary solution for the contact form while there is no back-end. Extended at Reverse Engineering review with the Instagram block and the "Lieve woorden" (testimonials) block from the live site, and with a contact form overlay, anti-spam and a robot check.
- **Request Type**: New Feature (new user-facing sections on an existing page)
- **Scope Estimate**: Multiple components within one package (`web/`), plus the static design reference (`design/andreaslop-static/`) and [LAYOUT.md](../../../../../LAYOUT.md)
- **Complexity Estimate**: Moderate — six mostly presentational sections, one small carousel, one form with validation and anti-spam logic, content and image preparation
- **Requirements Depth**: Standard
## Source of Truth
- **Layout and styling**: `design/andreaslop-static/` (`index.html`, `assets/css/style.css`) and [LAYOUT.md](../../../../../LAYOUT.md). *Source: Q1 = A*
- **Content** (texts, prices, packages, photos, form fields, reviews): the live site https://andreaslop.nl/ as of 2026-10-19, because it is newer than the design. *Source: Q1 = A*
- **Decisions**: [requirement-verification-questions.md](requirement-verification-questions.md)
## Section Order
Hero (exists) → **Lifestyle fotografie** → **Over mij** → **Prijzen** → **Lieve woorden** → **Contact** → **Instagram**. *Source: Q4 = A*
Each of the six new sections is a separate unit of work.
## Out of Scope
- The hero (exists; unchanged)
- A working contact form submission, server-side spam checks, rate limiting and the actual robot check integration — all part of the future API feature
- The `/contact` page (stays a placeholder; it will reuse the contact form component in its own feature). *Source: Q16 = A*
- A live Instagram feed (needs the API). *Source: Q6 = A*
- The decorative banner image between Prices and Lieve woorden on the live site (`landing-img-18.png`) and the decoration next to the live contact form — the design's own pricing decorations are used instead
- Responsive image pipeline (srcset/WebP). *Source: Q5 = A*
- Operations phase: undecided, asked again at Build and Test. *Source: Operations = C*
---
## Functional Requirements
### FR-HP-01 Static design and LAYOUT.md updated first
- Add the **Lieve woorden** section to `design/andreaslop-static/index.html` and its styles to `assets/css/style.css`, following the chosen design (FR-HP-05), so it can be reviewed in the browser before it is built in React.
- Align the static design's homepage **content** with the live site: price cards (FR-HP-04) and contact form fields (FR-HP-06).
- Update the Home diagram in [LAYOUT.md](../../../../../LAYOUT.md) to the seven blocks in the section order above, following [.ai/layout-conventions.md](../../../../../.ai/layout-conventions.md).
- *Source: Q3 = A, user request ("eventueel verwerken in het design in deze workspace")*
### FR-HP-02 Lifestyle fotografie
- Heading **"Lifestyle fotografie"** (h2) with lead text "Jouw favoriete momenten, vastgelegd op een natuurlijke en ongedwongen manier."
- A gallery of **four photos** (the four current live photos), layout as `.intro-gallery` in the design.
- Every photo has a descriptive Dutch alt text (to be reviewed by Andrea).
- The live page's stray headings "Foto2" and "Foto" are not carried over.
- *Source: Q1 = A*
### FR-HP-03 Over mij
- Photo of Andrea (live photo) next to the text block, layout as `.about` in the design, on the `paper.alt` background.
- Eyebrow **"Over mij"**, heading **"Lifestyle fotograaf met een passie voor storytelling"** (h2) and the three paragraphs from the live site / design (identical).
- Link **"Lees mijn verhaal"** to `/over-mij`.
### FR-HP-04 Prijzen
- Heading **"Prijzen"** (h2) with lead "Pakketten", and the design's two decorative images (`deco-1.png`, `deco-2.png`, decorative only).
- Three price cards (h3 per package), in the live order and with the live content:
| Package | Price | Included |
|---|---|---|
| Zwangerschap | € 175 | 1 uur fotografie · Minstens 30 zorgvuldig nabewerkte foto's · Persoonlijke online fotogalerij |
| Newborn | € 185 | 1-2 uur fotografie · Minstens 40 zorgvuldig nabewerkte foto's · Persoonlijke online fotogalerij |
| Gezin | € 175 | 1 uur fotografie · Minstens 30 zorgvuldig nabewerkte foto's · Persoonlijke online fotogalerij |
- Each card has a **"Boek je shoot"** button that moves to the contact section on the homepage and preselects that package in the shoot field (FR-HP-06). *Source: Q9 = A*
- The packages are one data list in `content/`; the price cards and the shoot field options are both derived from it. *Source: Q8 = A*
### FR-HP-05 Lieve woorden (testimonials)
- Heading **"Lieve woorden"** (h2).
- **One review at a time, large**: photo on the left; on the right a large decorative quotation mark, the shoot type as a label, the review text in Marcellus and the names below it. Stacked on small screens. *Source: Q2 = A*
- **Previous/next buttons and dots**; **no autoplay**. Keyboard operable; the change of review is announced to screen readers. With only one review the controls are not shown.
- Content (from the live site, each with its live photo):
- **Trouwshoot** — "Super mooie foto's door Andrea gemaakt op onze trouwdag en pré-wedding shoot. Wij zijn er super blij mee! Een aantal hebben wij laten afdrukken en hangen nu ingelijst aan de muur, dus wij genieten er nog elke dag van." — *Majella & Mark*
- **Newbornshoot** — "Heel tevreden met de newbornshoot. De foto's zijn prachtig geworden en we zijn erg blij met het resultaat. Zeker aan te raden!" — *Demi & Kevin*
- The data list supports any number of reviews, so more can be added later without code changes.
- *Source: user request, Q2 = A, Q4 = A*
### FR-HP-06 Contact — form
- Heading **"Contact"** (h2) with lead "Wil je meer informatie ontvangen? Neem gerust contact met mij op." Section anchor `#contact`.
- Fields (live site): **Naam**, **E-mail**, **"In welke shoot heb je interesse?"** (select: the package names + **Overig**, with an empty "Kies een optie..." default), **Bericht** ("Stel hier je vraag"). Submit button **"(Aan)vraag versturen"**. *Source: Q7 = A, Q8 = A*
- Client-side validation with an error message per field and `aria-invalid`, as in the design: required fields, valid e-mail format, maximum lengths.
- Submission goes through **one function `submitContactForm(payload)`**. Until the API exists it is not called (see FR-HP-07); the payload shape is ready for `POST /api/contact`.
- The form is a reusable component so the `/contact` page can use it later. *Source: Q16 = A*
### FR-HP-07 Contact — "coming soon" overlay
- While the form is switched off, it is visible but **dimmed** and **cannot be used**: the fields are `inert`, so keyboard and screen reader users never land in a form that does nothing.
- Over the form is a panel with the text **"Het contactformulier komt binnenkort. Mail me voor nu op info@andreaslop.nl"** and a button **"Stuur een e-mail"** (mailto).
- The e-mail address comes from `siteContent.email` and is assembled only in the browser, as in the footer (anti-spam). If the address is invalid, the panel still shows the coming-soon text without the address and button.
- **One setting** (`contactFormEnabled`) switches between overlay and working form, in both directions, so the form can also be switched off again later if needed. *Source: Q10 = A, Q11 = A (+ user note)*
### FR-HP-08 Contact — anti-spam (browser side)
- A **honeypot** field: hidden from sighted users and assistive technology, not focusable, no autocomplete. A filled honeypot means the submission is treated as spam.
- A **time check**: a submission less than ±3 seconds after the form was shown is treated as spam.
- Spam is rejected silently (the visitor sees the normal success flow; nothing is sent).
- Both checks are small pure functions in `lib/` with tests.
- Server-side checks and rate limiting are required in the API feature; the browser checks are not the only line of defence.
- *Source: Q12 = A*
### FR-HP-09 Contact — robot check (decided, integrated later)
- The chosen service is **Friendly Captcha** (EU, privacy-friendly, invisible proof-of-work). *Source: Q14 = B*
- The form has a place for the widget, but **no Friendly Captcha script is loaded** in this feature; it is integrated, together with server-side token verification and the required CSP changes, in the API feature. *Source: Q13 = A*
### FR-HP-10 Instagram
- Heading **"Instagram"** (h2) with **@andreaslopfotografie** as a link to the profile.
- A grid of **six fixed photos**, each linking to the profile, layout as `.instagram__grid` in the design.
- The photo list lives in `content/`, so the API can later fill it with the real feed (fetched server-side).
- Initial selection: six existing site photos (Andrea can swap them).
- *Source: Q6 = A*
### FR-HP-11 Scroll reveal
- Sections fade in gently when scrolled into view, as `.reveal` in the design, via a small `useReveal` hook (IntersectionObserver).
- Disabled under `prefers-reduced-motion`. Without JavaScript or IntersectionObserver the content is simply visible.
- *Source: Q15 = A*
### FR-HP-12 Content and images
- All section content lives as API-shaped static data in `web/src/content/` with interfaces in `content/types.ts`, passed into the components from the home route.
- Photos are downloaded from andreaslop.nl (and the design for the decorations), resized once to at most ±1600 px wide, compressed, and stored in `web/src/assets`. No new dependency. *Source: Q5 = A*
---
## Non-Functional Requirements
### NFR-HP-01 Accessibility (WCAG 2.1 AA as guideline)
- The hero title remains the page's only h1; sections use h2, cards and reviews h3 where a heading is needed.
- Each section is a `section` with an accessible name (its heading).
- Text contrast ≥ 4.5:1: reuse the shell's choices (`ink.soft` instead of `ink.muted`, `accent.deep` instead of `accent` for small text on light backgrounds). The overlay panel text keeps full contrast; only the form behind it is dimmed.
- Form: visible labels linked to fields, errors linked via `aria-describedby`, error announcement, focus to the first invalid field on submit.
- Carousel: buttons with Dutch labels, current dot marked (`aria-current`), polite live region for manual changes, no autoplay.
- Touch targets ≥ 44×44 px; keyboard operable; visible focus ring (theme).
- `prefers-reduced-motion` respected (reveal, carousel transitions, smooth scrolling to `#contact`).
- Axe checks in the component tests; Lighthouse accessibility stays 1.0.
### NFR-HP-02 Styling and consistency
- Same principles as the shell (frontend-shell NFR-02/02a): reuse theme tokens, text styles, recipes and components first (`LinkButton`, `linkButton` variants, `eyebrow`, `paper.alt`, `Container`); use Chakra primitives where they fit; lift repeated styling (e.g. the section heading block used by five sections) into a shared component or recipe; no hard-coded colours, CSS files or Tailwind.
- Components in their own folders under `components/`, Prettier style.
- **Code comments in English** in all new code, including new comments added to existing files. Existing Dutch comments are not translated as part of this feature. Visitor-facing texts (labels, messages, alt texts, aria labels) stay Dutch. *Source: user change request at Requirements review*
- Responsive from 320 px to ultrawide, mobile-first, no horizontal scroll, works at 200% zoom.
### NFR-HP-03 Testing
- **Example-based tests** per section: rendered content, links and attributes, carousel controls, form validation messages, overlay behaviour (inert form, mailto, toggle), "Boek je shoot" preselection, axe checks.
- **Property-based tests** (fast-check, existing setup and shared arbitraries) for the pure logic, e.g. form validation, honeypot/time check, shoot options derived from packages, carousel index wrapping.
- Coverage: new pure helpers in `src/lib/**` fall under the existing 100% threshold.
- `pnpm check` (lint, format, tests, build, audits, Lighthouse) passes.
- *Source: PBT extension = A (full)*
### NFR-HP-04 Security (Security Baseline extension enabled)
- **No new third parties**: no external scripts, widgets, fonts or form endpoints in this feature. The CSP in `web/config/securityHeaders.ts` stays unchanged (`form-action 'self'`, `connect-src` self/Umami/Sentry).
- **External links** (Instagram) use `target="_blank"` with `rel="noopener noreferrer"` and a "opent in nieuw tabblad" hint for screen readers, as in the footer.
- **E-mail address** never appears literally in HTML, bundle or content (assembled in the browser).
- **Input handling**: client-side length limits and format checks on all fields; user input is rendered only as text by React (no HTML injection). The payload is ready for server-side validation in the API (SECURITY-05 applies there).
- **Defence in depth / misuse**: honeypot + time check now; Friendly Captcha + server-side validation + rate limiting in the API feature (SECURITY-11). The overlay disables the form entirely while there is no server.
- **Fail safe**: a failing `submitContactForm` shows a generic message and leaves the visitor's input intact; no internal details (SECURITY-15).
- **Dependencies**: no new runtime dependencies (SECURITY-10).
- **For the API feature**: Friendly Captcha requires CSP additions (script/worker and connect to its EU endpoint) and a privacy statement entry — recorded here, not done now.
### NFR-HP-05 Performance
- The homepage mobile Lighthouse budget (performance 0.8, see `lighthouserc.cjs`) and desktop 0.9 still pass.
- All new images are below the fold: `loading="lazy"`, explicit width/height (no layout shift), compressed per FR-HP-12.
- No new network requests other than the bundled images.
### NFR-HP-06 Content for the future API
- Content interfaces are plain data (strings, numbers, arrays, image references) so the API can deliver them 1-to-1: `PricingPackage`, `Testimonial`, `GalleryPhoto`, `InstagramContent` and the section texts.
- The contact payload is `{ naam, email, shoot, bericht }` (the design's `onderwerp` becomes the shoot choice).
---
## Extension Compliance — Requirements Level
### Security Baseline
| Rule | Status | Rationale |
|---|---|---|
| SECURITY-01 Encryption | N/A | No data stores |
| SECURITY-02 Access logging | N/A | No intermediaries added; hosting unchanged |
| SECURITY-03 Application logging | N/A | No server-side component; client errors already go to Sentry |
| SECURITY-04 HTTP security headers | Compliant | Existing header set unchanged; no CSP loosening (NFR-HP-04) |
| SECURITY-05 Input validation | Compliant (planned) | No API endpoint in this feature; client-side limits/format checks now, server-side validation required in the API feature |
| SECURITY-06 Least privilege | N/A | No IAM |
| SECURITY-07 Network configuration | N/A | No network infrastructure |
| SECURITY-08 Access control | N/A | Public content, no protected resources |
| SECURITY-09 Hardening | Compliant (planned) | No debug output; generic messages |
| SECURITY-10 Supply chain | Compliant (planned) | No new dependencies |
| SECURITY-11 Secure design | Compliant (planned) | Misuse case (form spam) addressed: overlay, honeypot, time check; captcha + rate limiting assigned to the API feature |
| SECURITY-12 Authentication | N/A | No authentication |
| SECURITY-13 Integrity | Compliant | No external CDN resources; captcha script deferred |
| SECURITY-14 Alerting | N/A | No server-side component; existing monitoring unchanged |
| SECURITY-15 Exception handling | Compliant (planned) | Generic failure message in the form; existing global error handling |
### Property-Based Testing
| Rule | Status | Rationale |
|---|---|---|
| PBT-01 Property identification | Planned | Done per unit in Functional Design |
| PBT-02 … PBT-06 | Planned | Applied to the pure helpers identified in Functional Design (validation invariants, carousel index wrapping, derived shoot options) |
| PBT-07 Generators | Planned | Domain generators added to `src/test/arbitraries.ts` |
| PBT-08 Shrinking/reproducibility | Compliant | Existing seed logging and shrinking (`config/testSeed.ts`) |
| PBT-09 Framework | Compliant | fast-check already configured |
| PBT-10 Complementary testing | Planned | Example-based tests per section alongside PBT |
---
## Summary of Key Decisions
| # | Decision |
|---|---|
| Q1 | Content from the live site, layout/style from the design |
| Q2 | Lieve woorden: one large review at a time, photo + quote, prev/next + dots, no autoplay |
| Q3 | Add Lieve woorden (and live content) to the static design and LAYOUT.md first |
| Q4 | Lieve woorden between Prijzen and Contact |
| Q5 | Download live photos, resize once, no new dependency |
| Q6 | Instagram: fixed grid of 6 photos in `content/`, real feed later via the API |
| Q7 / Q8 | Live form fields; shoot options = package names + Overig |
| Q9 | "Boek je shoot" scrolls to contact and preselects the package |
| Q10 / Q11 | Dimmed, inert form under a coming-soon overlay with mailto; one setting toggles it both ways |
| Q12 | Honeypot + time check + length limits now |
| Q13 / Q14 | Robot check: Friendly Captcha, integrated in the API feature |
| Q15 | Scroll reveal with reduced-motion support |
| Q16 | `/contact` stays a placeholder |
| Ext. | Security Baseline: Yes · PBT: Yes (full) · Operations: undecided |