Plans the Over mij page

Refreshes the reverse engineering docs after the homepage sections and
records the requirements, execution plan and application design for the
Over mij page: live texts in the design's structure, an indexed page with
its own structured data and preview image, and shared building blocks
(PageSection, MediaText, Eyebrow) reused by the homepage.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-22 23:35:21 +02:00
co-authored by Claude Opus 5.5
parent 99d4610928
commit 26106f280f
21 changed files with 1341 additions and 41 deletions
@@ -0,0 +1,24 @@
# Verduidelijkingsvraag — Over mij-pagina
Alle antwoorden zijn verwerkt. Bij één antwoord vroeg je me om mee te denken.
## Kopniveau van "Hoe het begon" en "Buiten de camera om" (vraag 2)
Je koos voor h3, met als reden dat alles onder het "Over mij"-deel valt, en dat is een h2. Op de **homepage** klopt dat: daar is "Over mij" een h2 onder de h1 van de hero. Op **deze pagina** is "Over mij" zelf de **h1** (de paginatitel in `PageIntro`). De koppenstructuur wordt dan:
| Kies je h2 (A) | Kies je h3 (B) |
| ------------------------ | -------------------------- |
| h1 Over mij | h1 Over mij |
| · h2 Hoi! Ik ben Andrea | · h2 Hoi! Ik ben Andrea |
| · h2 Hoe het begon | · · h3 Hoe het begon |
| · h2 Buiten de camera om | · · h3 Buiten de camera om |
Met h3 vallen "Hoe het begon" en "Buiten de camera om" onder **"Hoi! Ik ben Andrea"**, niet onder "Over mij". In het ontwerp zijn het drie losse, gelijkwaardige secties: elk een eigen `section` met een eigen achtergrond. Een screenreader noemt elke sectie bij de naam van zijn kop, en wie met de toetsen van kop naar kop springt, verwacht gelijkwaardige blokken op hetzelfde niveau. Technisch zijn beide toegestaan: axe en Lighthouse geven bij h3 geen fout, omdat er een h2 voor staat.
Bij beide keuzes ziet de kop eruit als het kleine label uit het ontwerp. Alleen het kopniveau verschilt.
- A) h2 in de stijl van het ontwerp: drie gelijkwaardige secties onder de h1 "Over mij" (aanbevolen)
- B) h3 in de stijl van het ontwerp: "Hoe het begon" en "Buiten de camera om" vallen onder "Hoi! Ik ben Andrea"
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: ah ja dat bedoelde ik ook. ze staan onder hoi ik ben andrea en zijn een vervolg op haar verhaal daar. dus daarom zou ik zeggen h3 wat ook het verschil in styling zou kunnen verklaren. als we h2 doen denk ik dat de styling hetzelfde als de andere h2's moet worden
@@ -0,0 +1,183 @@
# Verificatievragen — Over mij-pagina
Al vastgelegd (geen vraag nodig):
- **Route** `/over-mij` bestaat al als placeholder ([over-mij.tsx](../../../../../web/src/routes/over-mij.tsx)) en wordt de echte pagina. De navigatie, de footer en de link "Lees mijn verhaal" op de homepage verwijzen er al naar.
- **Layout en stijl** komen uit het ontwerp ([over-mij.html](../../../../../design/andreaslop-static/over-mij.html)). Teksten en foto's komen als vaste data in `web/src/content/`, in de vorm die de API straks levert (zoals bij de homepage).
- **Hergebruik eerst**: `PageIntro` (h1), `HomeSection`, `SectionHeading`, `FramedImage`, `DeferredImage`, `Reveal`, `LinkButton` (variant `accent`), de `underline`-variant van `Link`, plus de theme-tokens (`paper.alt`, `contentNarrow`, `sectionY`, `gridGap`, tekststijlen). Geen hardgecodeerde kleuren, geen CSS-bestanden en geen nieuwe dependencies.
- **Toegankelijkheid**: dezelfde lat als bij de homepage (NFR-HP-01): één h1, secties met een toegankelijke naam, contrast ≥ 4.5:1, `prefers-reduced-motion`, axe in de tests en Lighthouse accessibility 1.0.
- **Codecommentaar** in het Engels in nieuwe code; teksten voor bezoekers blijven Nederlands (afspraak uit homepage-sections).
Wat ik op de live site (andreaslop.nl/over-mij) zag en wat afwijkt van het ontwerp:
| Onderdeel | Ontwerp | Live site |
| ----------------------- | --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Kop van het eerste blok | eyebrow "Lifestyle fotograaf" + h2 **"Hoi! Ik ben Andrea"** | alleen "Lifestyle Fotograaf" (h3) |
| Eerste alinea | "…liefde voor het vastleggen van momenten." | zelfde, plus **"Momenten die je voor altijd bewaart."** |
| Achtergrond | eyebrow **"Hoe het begon"** + de tekst over de studie | geen kop; de tekst eindigt met **"Het was even een zoektocht maar uiteindelijk heb ik mijn specialisatie gevonden. Je kunt bij mij terecht voor newbornshoots, zwangerschapsshoots en gezinsshoots."** |
| Persoonlijk | eyebrow **"Buiten de camera om"**; "…tekenen, schilderen of lezen **(vaak met een kat naast me)**." | geen kop; "…tekenen, schilderen of lezen." |
| Afsluiting | knop **"Boek je shoot"** | geen knop |
| Foto's | portret + 2 foto's, alt-teksten "Portret van Andrea Slop" en twee keer "Werk van Andrea Slop" | dezelfde foto's, **zonder alt-teksten** |
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 teksten
Welke teksten komen op de pagina als ontwerp en live site verschillen?
- A) De opbouw van het ontwerp (eyebrows, de kop "Hoi! Ik ben Andrea", de knop) met de **volledige live teksten** erin: de extra zin in de eerste alinea en de zin over de specialisatie erbij. "(vaak met een kat naast me)" uit het ontwerp blijft ook staan. (aanbevolen)
- B) Zelfde als A, maar zonder "(vaak met een kat naast me)" (precies de live tekst)
- C) Alles precies zoals in het ontwerp
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: B
## Vraag 2: Koppen van "Hoe het begon" en "Buiten de camera om"
In het ontwerp zijn dit kleine labels (eyebrows) zonder kopelement. Voor screenreaders en zoekmachines is een pagina met echte tussenkoppen beter te scannen.
- A) Echte h2-koppen die er precies uitzien als het label uit het ontwerp (tekststijl `eyebrow`). Visueel verandert er niets; de structuur wordt beter. (aanbevolen)
- B) Echte h2-koppen in de grote koptekststijl (`sectionTitle`), zoals op de homepage. Dat wijkt visueel af van het ontwerp.
- C) Gewone labels zonder kopelement, letterlijk zoals in het ontwerp
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: X, Net als A, maar dan met h3. Het valt uiteindelijk allemaal onder het "Over mij" deel wat een H2 is. Dus ik denk dat h3 dan logischer is. in de stijl van het design. Als jij wat anders denkt laat me dat dan weten. Misschien mis ik iets.
## Vraag 3: Links "mijn portfolio" en "neem contact op"
`/portfolio` en `/contact` zijn nu nog placeholders ("in de maak", noindex). Het werkende contactblok staat op de homepage (`/#contact`).
- A) Link naar `/portfolio` en `/contact`. Die pagina's worden later echt, en dan klopt de link vanzelf. (aanbevolen)
- B) "neem contact op" linkt voorlopig naar `/#contact` op de homepage, "mijn portfolio" naar `/portfolio`. Later omzetten naar `/contact`.
- C) Voorlopig geen links: platte tekst tot die pagina's bestaan
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: B
## Vraag 4: Knop "Boek je shoot"
Waar gaat de knop onderaan de pagina naartoe?
- A) Naar dezelfde plek als "neem contact op" uit vraag 3, zodat beide contactlinks overeenkomen (aanbevolen)
- B) Altijd naar `/#contact` op de homepage (het contactblok met de "binnenkort"-melding en de mailto-link)
- C) Knop weglaten, net als op de live site
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 5: Indexeren door zoekmachines
`/over-mij` staat nu op `noindex` en ontbreekt in `sitemap.xml`.
- A) Bij het mergen van deze feature op **geïndexeerd** zetten: geen `noindex` meer, opnemen in de sitemap, in Lighthouse CI als geïndexeerde pagina controleren. (aanbevolen: de pagina is dan af)
- B) Voorlopig op `noindex` laten tot alle pagina's klaar zijn en de site live gaat
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 6: Titel en beschrijving (SEO)
De huidige titel is "Over mij | Andrea Slop Fotografie" en de beschrijving: "Hi! Ik ben Andrea, lifestyle fotograaf uit Huizen. Ik leg jullie vast zoals jullie zijn: spontaan en natuurlijk, zonder ongemakkelijke poses."
- A) Titel met zoekwoorden, bijvoorbeeld "Over mij – lifestyle fotograaf in Huizen", en een beschrijving die aansluit op de tekst van deze pagina (warm en spontaan; newborn-, zwangerschaps- en gezinsshoots). Ik stel ze voor in requirements.md en jij keurt ze goed. (aanbevolen)
- B) Titel en beschrijving laten zoals ze zijn
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 7: Gestructureerde data (JSON-LD)
De site geeft nu op elke pagina een `ProfessionalService` (het bedrijf) mee. Zoekmachines kunnen een over-mijpagina beter begrijpen met extra gegevens.
- A) Op deze pagina een `AboutPage` toevoegen met een `Person` (Andrea Slop, fotograaf, Huizen, met de social-links), gekoppeld aan de bestaande `ProfessionalService`. Zonder e-mailadres, net als nu. (aanbevolen)
- B) Alleen de bestaande `ProfessionalService`, niets extra
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 8: Preview-afbeelding bij delen (Open Graph)
Bij het delen via WhatsApp of Facebook verschijnt nu de standaardafbeelding van de site (heide op een arm).
- A) Een eigen preview voor deze pagina: het portret van Andrea, bijgesneden tot 1200×630 in `web/public/` (aanbevolen)
- B) De standaardafbeelding van de site houden
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 9: Naam van het sectieframe `HomeSection`
`HomeSection` (achtergrond, verticale ritmiek, contentkolom, `aria-labelledby`) is precies wat deze pagina, en straks ook Portfolio, Soorten fotoshoots en Contact, nodig heeft. Alleen de naam verwijst naar de homepage.
- A) Hernoemen naar `PageSection` (map, component, test en alle imports op de homepage), zonder gedragswijziging. Daarna gebruiken alle pagina's hetzelfde frame. (aanbevolen)
- B) De naam laten staan en `HomeSection` gewoon ook op deze pagina gebruiken
- C) Een aparte, nieuwe component voor gewone pagina's
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 10: Gedeeld blok "foto naast tekst"
Het eerste blok van deze pagina (portret met het zandkleurige kader naast eyebrow, kop en tekst) is dezelfde opbouw als het blok Over mij op de homepage (`AboutBlock`). In het ontwerp is het allebei `.about`.
- A) Eén gedeelde component maken (bijvoorbeeld `MediaText`: foto met kader naast een tekstkolom, stapelt op telefoon en tablet) en die zowel in `AboutBlock` als op deze pagina gebruiken. Zo staat de layout op één plek. (aanbevolen)
- B) Alleen de bestaande kleine bouwstenen hergebruiken (`FramedImage`, `SectionHeading`, `Reveal`) en de grid op deze pagina apart opbouwen
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 11: Foto's en alt-teksten
De live foto's hebben geen alt-teksten, en die in het ontwerp ("Werk van Andrea Slop") beschrijven niet wat er te zien is.
- A) De originele foto's van andreaslop.nl downloaden, eenmalig verkleinen en comprimeren (zoals bij de homepage) en per foto een beschrijvende Nederlandse alt-tekst schrijven die Andrea later kan nalezen (aanbevolen)
- B) De foto's uit het ontwerp gebruiken (`assets/img`) met beschrijvende alt-teksten
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 12: LAYOUT.md
In [LAYOUT.md](../../../../../LAYOUT.md) heeft "About me" nu drie blokken: About Me, Background en Personal. Het ontwerp heeft ook de twee foto's tussen Background en Personal, en de knop onderaan.
- A) LAYOUT.md bijwerken naar het ontwerp: About Me → Background → Photos → Personal (de knop hoort bij Personal), volgens [.ai/layout-conventions.md](../../../../../.ai/layout-conventions.md) (aanbevolen)
- B) LAYOUT.md laten zoals het is
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
---
## Vraag: Beveiligingsextensies
Moeten de beveiligingsregels als harde vereisten worden afgedwongen voor dit project?
- 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?
- 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 inrichten)? Deployment naar test en productie en de monitoring (Sentry, Umami, UptimeRobot) bestaan al.
- A) Ja — na Construction de Operations-fase doorlopen (deployment + monitoring inrichten)
- B) Nee — stoppen na Build and Test (deployment en monitoring vallen buiten deze feature)
- C) Weet ik nog niet — vraag het opnieuw na de Construction-fase
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: B
@@ -0,0 +1,186 @@
# Requirements — Over mij Page
## Intent Analysis
- **User Request**: add the "Over mij" page to the front end with AI-DLC, paying attention to SEO, accessibility and reuse of code and styling (Chakra UI, theme).
- **Request Type**: New Feature (replaces the `/over-mij` placeholder with the real page) with a small supporting refactor (shared section frame and media+text block)
- **Scope Estimate**: Multiple components within one package (`web/`), plus [LAYOUT.md](../../../../../LAYOUT.md)
- **Complexity Estimate**: Simple to moderate — one presentational page, two refactors of existing shared components, SEO additions (indexing, page-specific structured data and preview image), image preparation
- **Requirements Depth**: Standard
## Source of Truth
- **Layout and styling**: [design/andreaslop-static/over-mij.html](../../../../../design/andreaslop-static/over-mij.html) and `assets/css/style.css` (`.page-head`, `.about`, `.section--alt`, `.container--narrow`, `.intro-gallery--duo`, `.btn--accent`).
- **Texts**: the live page https://andreaslop.nl/over-mij/ as of 2026-10-22, placed in the design's structure (eyebrows, heading, button). *Source: Q1 = B*
- **Decisions**: [requirement-verification-questions.md](requirement-verification-questions.md), [requirement-clarification-questions.md](requirement-clarification-questions.md)
## Page Structure
Shell header → **Intro** (page head, h1) → **About me** → **Background** → **Photos** → **Personal** (with booking button) → shell footer.
## Out of Scope
- The `/portfolio` and `/contact` pages (stay placeholders; linked from this page).
- A responsive image pipeline (srcset/WebP) — unchanged from homepage-sections.
- Rewriting existing Dutch code comments.
- Operations phase. *Source: Operations = B*
---
## Functional Requirements
### FR-OM-01 Intro (page head)
- Eyebrow **"Andrea Slop Fotografie"** and the page's only h1 **"Over mij"**, via the existing `PageIntro` without intro text (design `.page-head`).
### FR-OM-02 About me
- Portrait of Andrea (live photo `WhatsApp-Image-2024-10-27-at-14.31.41.jpeg`, design `andrea-portret.jpg`) in the sand-coloured frame, next to the text column; stacked on phones and tablets (design `.about`, same breakpoint as the homepage block).
- Eyebrow **"Lifestyle fotograaf"**, heading **"Hoi! Ik ben Andrea"** (h2, `sectionTitle` style), and the live paragraphs:
1. "Hoi! Ik ben Andrea, een fotograaf met liefde voor het vastleggen van momenten. Momenten die je voor altijd bewaart."
2. "Mijn stijl is te omschrijven als warm en spontaan. Ik houd van natuurlijke, ongedwongen foto's die een verhaal vertellen."
3. "Nieuwsgierig naar mijn werk? Bekijk **mijn portfolio** of **neem contact op** voor een fotoshoot!"
- "mijn portfolio" links to `/portfolio`; "neem contact op" links to **`/#contact`** (the homepage contact section) for now, to become `/contact` once that page exists. Both use the `underline` link variant. *Source: Q3 = B*
- Background `paper` with the section directly below the page head (design `.section--flush-top`).
### FR-OM-03 Background ("Hoe het begon")
- **h3 "Hoe het begon"** styled as the design's eyebrow label. *Source: Q2 = X, clarification answer — the two story sections continue Andrea's story under "Hoi! Ik ben Andrea", and the smaller style matches the lower level*
- The live text, in the narrow content column on the `paper.alt` background: "Tijdens de studie Communicatie & Media Design … Ik was helemaal in mijn element. Het was even een zoektocht maar uiteindelijk heb ik mijn specialisatie gevonden. Je kunt bij mij terecht voor newbornshoots, zwangerschapsshoots en gezinsshoots." *Source: Q1 = B*
### FR-OM-04 Photos
- Two photos side by side at a 3:2 crop (design `.intro-gallery--duo`), one below the other on phones; live photos `slide-1.jpg` and `IMG_1718.jpg`.
- Decorative or informative is decided per photo when the alt texts are written (FR-OM-07); both are expected to be informative.
### FR-OM-05 Personal ("Buiten de camera om")
- **h3 "Buiten de camera om"** styled as the eyebrow label (same rule as FR-OM-03).
- The live text, without the design's "(vaak met een kat naast me)": "Mijn camera gaat altijd mee op reis. Het liefst ga ik naar een plek met een mooie zee maar ik ga ook graag op pad om de natuur vast te leggen met mijn camera." / "Wanneer ik niet achter de camera sta ben ik bezig met tekenen, schilderen of lezen." *Source: Q1 = B*
- Button **"Boek je shoot"** (`LinkButton`, variant `accent`) to the same target as "neem contact op": `/#contact`. *Source: Q4 = A*
- Navigating to `/#contact` from this page lands on the homepage contact section below the fixed header, as the price card links already do.
### FR-OM-06 Scroll reveal
- Blocks fade in as on the homepage (existing `Reveal`), respecting `prefers-reduced-motion`; content is always in the DOM.
### FR-OM-07 Content and images
- All page content lives as API-shaped static data in `web/src/content/` (a new `aboutContent.ts` with an `AboutPageContent` interface in `content/types.ts`), passed into the components from the route.
- Photos are downloaded from andreaslop.nl in their original size, resized once to at most ±1600 px wide, compressed and stored in `web/src/assets/` — same approach as homepage-sections, no new dependency. *Source: Q11 = A*
- Every photo gets a descriptive Dutch alt text, written after looking at the photo, for Andrea to review.
### FR-OM-08 LAYOUT.md
- Update the "About me" diagram to the page structure above — **Intro → About Me → Background → Photos → Personal** — following [.ai/layout-conventions.md](../../../../../.ai/layout-conventions.md). "Intro" is added for consistency with the other page diagrams (Types of shoots, Contact), which start with their page head. *Source: Q12 = A*
### FR-OM-09 Shared section frame: `HomeSection` → `PageSection`
- Rename `HomeSection` to `PageSection` (folder, component, test, every import on the homepage) without changing its behaviour, and use it on this page. *Source: Q9 = A*
### FR-OM-10 Shared media+text block
- Extract the photo-in-frame next to a text column (design `.about`) into one shared component (working name `MediaText`), used by both the homepage `AboutBlock` and FR-OM-02. The homepage must look and behave exactly as before. *Source: Q10 = A*
---
## SEO Requirements
### SEO-OM-01 Indexing
- `/over-mij` becomes **indexed** when this feature merges: `indexed: true` in `sitePages.ts` (no `robots noindex`, included in `sitemap.xml`), and moved to the indexed paths in `web/lighthouserc.cjs` / `.desktop.cjs` (the existing sync test must pass). *Source: Q5 = A*
### SEO-OM-02 Title and description
- Title: **"Over mij – fotograaf in Huizen"** → rendered as "Over mij – fotograaf in Huizen | Andrea Slop Fotografie" (55 characters, within the ~60 guideline).
- Description: **"Hoi! Ik ben Andrea, lifestyle fotograaf uit Huizen. Ik maak warme, spontane foto's die een verhaal vertellen: newborn-, zwangerschaps- en gezinsshoots."** (151 characters, within the ~155 guideline).
- *Source: Q6 = A; description wording changed by the user at Requirements review (the second sentence now has a subject)*
### SEO-OM-03 Structured data
- On this page, add an `AboutPage` JSON-LD whose `mainEntity` is a `Person` (Andrea Slop; job title lifestyle fotograaf; locality Huizen, NL; `sameAs` the visible social links; `image` the page preview image), linked to the existing `ProfessionalService` by `@id` (the business gets a stable `@id`, e.g. `https://andreaslop.nl/#business`).
- No e-mail address in the structured data (same rule as today). Escaped through the existing `jsonLdScript`.
- Built by pure functions in `seo.ts` (100% coverage threshold applies). *Source: Q7 = A*
### SEO-OM-04 Preview image (Open Graph)
- A page-specific preview image: the portrait cropped to **1200×630**, stored in `web/public/` (stable URL, outside the bundle), set as the page's `ogImage` in `sitePages.ts` with its own alt text. *Source: Q8 = A*
### SEO-OM-05 Semantic structure
- One h1; `section` landmarks named by their heading; a heading outline that matches the content (h1 Over mij → h2 Hoi! Ik ben Andrea → h3 Hoe het begon, h3 Buiten de camera om); descriptive link texts; images with width/height.
---
## Non-Functional Requirements
### NFR-OM-01 Accessibility (WCAG 2.1 AA as guideline)
- Heading outline as in SEO-OM-05; no skipped levels.
- Each content block is a `section` with an accessible name (`aria-labelledby` its h2/h3). The photos block is not a landmark of its own unless it has a name (it has no heading in the design).
- Text contrast ≥ 4.5:1: `accent.deep` for eyebrow-styled text (incl. the h3 labels), `ink.soft` for running text.
- Descriptive alt texts (FR-OM-07); links distinguishable and keyboard reachable with the theme focus ring; touch targets ≥ 44×44 px for the button.
- `prefers-reduced-motion` respected (reveal).
- Axe checks in the component and route tests; Lighthouse accessibility 1.0 for `/over-mij` (mobile and desktop).
### NFR-OM-02 Styling and reuse
- Reuse before building: `PageIntro`, `PageSection` (renamed), `SectionHeading`, `FramedImage`, `DeferredImage`, `Reveal`, `LinkButton` (`accent`), `Link` (`underline`), `RouterLink`, and theme tokens/text styles (`paper.alt`, `contentNarrow`, `sectionY`, `gridGap`, `eyebrow`, `sectionTitle`, `pageTitle`).
- If the h3 eyebrow heading or the photo duo needs styling that another page will need too, it goes into a shared component, text style or recipe, not inline per page.
- No hard-coded colours, CSS files or Tailwind; Chakra primitives where they fit.
- Components in their own folders under `components/`, Prettier style; code comments in English in new code (including new comments in existing files); visitor-facing texts in Dutch.
- Responsive from 320 px to ultrawide, mobile-first, no horizontal scroll, works at 200% zoom.
### NFR-OM-03 Testing
- **Example-based**: page content and structure (heading outline, section names, links and their targets, button target), the renamed `PageSection`, the shared media+text block, the homepage `AboutBlock` unchanged in output, head tags (title, description, no `noindex`, canonical, `og:image`), axe checks.
- **Property-based** (fast-check, existing arbitraries) for the new pure SEO functions, e.g. the structured data never contains an e-mail address, `sameAs` only contains valid https social links, the script output always stays escaped. *Source: PBT extension = A (full)*
- `pnpm check` (lint, format, tests incl. coverage thresholds, build, audits, Lighthouse) passes.
### NFR-OM-04 Security (Security Baseline extension enabled)
- No new third parties: no external scripts, fonts, embeds or endpoints; CSP in `web/config/securityHeaders.ts` unchanged.
- No e-mail address in markup, bundle, content or structured data.
- Structured data goes through `jsonLdScript` (escapes `<`, `>`, `&`).
- No new runtime dependencies; image processing is a one-off local step, not a build dependency.
### NFR-OM-05 Performance
- All page photos except possibly the portrait are below the fold and use `DeferredImage` with intrinsic width/height (no layout shift). Whether the portrait is above the fold at common viewport sizes is decided in design; if it is the largest contentful paint it must not be deferred.
- Lighthouse performance for `/over-mij`: ≥ 0.9 on mobile and desktop (the default budget for pages other than the homepage).
- No new network requests other than the bundled images.
### NFR-OM-06 Content for the future API
- `AboutPageContent` is plain data (strings, arrays, `ContentImage`, link targets typed as routes or route-plus-hash) so the API can deliver it 1-to-1; rich text with links is modelled without HTML strings.
---
## 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-OM-04) |
| SECURITY-05 Input validation | N/A | No input or API endpoint on this page |
| 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 |
| SECURITY-09 Hardening | Compliant | No debug output; no new configuration |
| SECURITY-10 Supply chain | Compliant | No new dependencies |
| SECURITY-11 Secure design | Compliant | Structured data escaped; e-mail kept out of the page |
| SECURITY-12 Authentication | N/A | No authentication |
| SECURITY-13 Integrity | Compliant | No external CDN resources; all assets self-hosted |
| SECURITY-14 Alerting | N/A | No server-side component; existing monitoring unchanged |
| SECURITY-15 Exception handling | Compliant | Existing global error handling and error page |
### Property-Based Testing
| Rule | Status | Rationale |
|---|---|---|
| PBT-01 Property identification | Planned | Properties of the new SEO functions identified in design |
| PBT-02 Round-trip | Planned | `jsonLdScript` output parses back to the same data (if not already covered) |
| PBT-03 Invariants | Planned | No e-mail in structured data; `sameAs` ⊆ valid https socials |
| PBT-04 Idempotency | N/A | No idempotent operations added |
| PBT-05 Oracle | N/A | No reference implementation |
| PBT-06 Stateful | N/A | No stateful logic added |
| PBT-07 Generators | Planned | Reuse/extend `src/test/arbitraries.ts` |
| PBT-08 Shrinking/reproducibility | Compliant | Existing seed logging (`config/testSeed.ts`) |
| PBT-09 Framework | Compliant | fast-check already configured |
| PBT-10 Complementary testing | Planned | Example-based tests for the page and components alongside PBT |
---
## Summary of Key Decisions
| # | Decision |
|---|---|
| Q1 | Design structure with the exact live texts (no cat remark) |
| Q2 | "Hoe het begon" and "Buiten de camera om" are h3, styled as eyebrow labels, under h2 "Hoi! Ik ben Andrea" |
| Q3 | "mijn portfolio" → `/portfolio`; "neem contact op" → `/#contact` for now |
| Q4 | "Boek je shoot" → same target as "neem contact op" (`/#contact`) |
| Q5 | Indexed on merge (sitemap, no noindex, Lighthouse indexed list) |
| Q6 | New title and description (proposed above) |
| Q7 | `AboutPage` + `Person` JSON-LD linked to the business |
| Q8 | Own 1200×630 preview image from the portrait |
| Q9 | `HomeSection` renamed to `PageSection` |
| Q10 | Shared media+text block for this page and the homepage `AboutBlock` |
| Q11 | Original live photos, resized once, descriptive alt texts |
| Q12 | LAYOUT.md updated (Intro → About Me → Background → Photos → Personal) |
| Ext. | Security Baseline: Yes · PBT: Yes (full) · Operations: No |