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,64 @@
# Components — Over mij Page
All paths are under `web/src/`. "Unit" refers to the execution plan (1 = Shared blocks, 2 = Over mij page).
## Shared building blocks (`components/<Name>/`)
### PageSection — changed (unit 1)
- **Was**: `HomeSection` (renamed: folder, file, component, test, all imports). *Source: Q9 = A*
- **Purpose**: frame of a content section on any page (design `.section`): `section` element named by its heading, vertical rhythm, background tone, content column, anchor offset under the fixed header.
- **Change besides the rename**: spacing option `flushTop` — no top padding, for the first block directly under a page head (design `.section--flush-top`). Existing options and output stay identical.
### MediaText — new (unit 1)
- **Purpose**: a photo in the sand-coloured frame next to a text column (design `.about`); stacked on phones and tablets, two equal columns from `lg`, vertically centred. Both columns fade in (`Reveal`).
- **Interface**: layout only — the photo comes in as data, the text column as `children`. *Source: Q1 = A*
- **Used by**: homepage `AboutBlock` (unit 1, no visible change) and `AboutIntro` (unit 2).
- **Reuses**: `FramedImage` (→ `DeferredImage`), `Reveal`, Chakra `Grid`.
### Eyebrow — new (unit 1)
- **Purpose**: the small capitals label above a heading (design `.eyebrow`) in one place: text style `eyebrow`, colour `accent.deep` (meets 4.5:1), standard space below. Renders a `p` by default; with `as="h3"` (or another heading level) it is a real heading that looks like the label. *Source: Q2 = A*
- **Replaces** the four identical inline label blocks in `SectionHeading`, `PageIntro`, `ContactFormGate` and `TestimonialSlide` (same output). Labels that look different on purpose (hero on photos, footer column titles, form labels, nav links, testimonial author line) are left alone.
### PhotoDuo — new (unit 2)
- **Purpose**: two landscape photos side by side at 3:2 (design `.intro-gallery--duo`), one below the other on phones; no stagger, no swipe row. *Source: Q3 = A*
- **Semantics**: a labelled list of figures (`ul`/`li`), each image with its own alt text.
- **Hover**: the design's `.intro-gallery figure:hover img` zoom applies to the duo too, so `PhotoDuo` zooms gently on hover like `IntroGallery`, with `_motionReduce` turning the transition off.
- **Reuses**: `DeferredImage`, `Reveal`, token `gridGap`.
### Existing, reused unchanged
- `PageIntro` (page head with the h1) — only switches to `Eyebrow` internally.
- `SectionHeading` (eyebrow + h2 + lead) — only switches to `Eyebrow` internally.
- `FramedImage`, `DeferredImage`, `Reveal`, `LinkButton` (`accent`), `RouterLink`, Chakra `Link` (`underline` variant).
## Page-specific components (`components/about/`, unit 2) — *Source: Q4 = A*
### AboutIntro
- **Purpose**: the "Hoi! Ik ben Andrea" block: `PageSection` (`flushTop`) → `MediaText` with the portrait → `SectionHeading` (eyebrow "Lifestyle fotograaf", h2, `align="start"`, compact) and the paragraphs, one of which contains the links "mijn portfolio" and "neem contact op".
### StorySection
- **Purpose**: one text block of Andrea's story, used twice ("Hoe het begon", "Buiten de camera om"): `PageSection` (narrow column, tone per use) → `Eyebrow as="h3"` → paragraphs → optional `children` below the text (the "Boek je shoot" button).
### RichParagraph (helper inside `components/about/`, or shared if Functional Design shows a second user)
- **Purpose**: renders one paragraph of the content model in which some words are links (shape defined in Functional Design), mapping link segments to `Link variant="underline"` + `RouterLink`.
## Route
### routes/over-mij.tsx — changed (unit 2)
- `head()`: `pageHead('/over-mij')` plus the `AboutPage` JSON-LD script.
- `component`: `PageIntro` → `AboutIntro` → `StorySection` (Hoe het begon, `paper.alt`) → `PhotoDuo` → `StorySection` (Buiten de camera om, with `LinkButton`).
## Content and SEO modules
### content/aboutContent.ts + `AboutPageContent` in content/types.ts — new (unit 2)
- Page head texts, intro block (eyebrow, title, paragraphs, portrait), two story blocks (title, paragraphs), duo photos, booking button (label, target).
### seo.ts — changed (unit 2)
- New pure builders for the `Person` and `AboutPage` structured data; the business (`professionalService`) gets a stable `@id`.
### sitePages.ts — changed (unit 2)
- `/over-mij`: new title and description, `indexed: true`, `ogImage` → `/og-over-mij.jpg` (1200×630).
### Lighthouse config — changed (unit 2)
- `lighthouserc.cjs` / `.desktop.cjs`: `/over-mij` moves from the noindex to the indexed paths.
## Assets (unit 2)
- `assets/about/`: portrait and two duo photos (resized originals).
- `public/og-over-mij.jpg`: 1200×630 crop of the portrait.