Designs the content model and structured data of the Over mij page

A paragraph with links is stored as text pieces and typed route links, so
the API can deliver it without HTML. On the about page, Andrea becomes a
Person with her specialisations, linked both ways to the business that
every page already describes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-23 01:17:33 +02:00
co-authored by Claude Opus 5.5
parent 34a3e0fa6e
commit 93993718c7
6 changed files with 389 additions and 0 deletions
@@ -0,0 +1,55 @@
# Functional Design-vragen — Unit 2: Over mij-pagina
Al vastgelegd (geen vraag nodig):
- **`sameAs`** in de JSON-LD komt uit dezelfde social-links als in de footer, met dezelfde filter (`visibleSocials`: alleen geldige https-links). Zijn er geen geldige links, dan valt `sameAs` weg.
- **Geen e-mailadres** in de JSON-LD, net als nu.
- **Afbeelding van `Person`**: de nieuwe preview-afbeelding uit `public/` (`/og-over-mij.jpg`). Die heeft een vaste URL; de foto's in de bundel krijgen bij elke build een andere naam.
- **"Boek je shoot" en "neem contact op"** gaan naar `/#contact`, zonder een vooraf gekozen pakket. Dat werkt op dezelfde manier als de knoppen op de prijskaarten (`RouterLink` met `hash="contact"`).
- **Alt-teksten** schrijf ik nadat ik de foto's heb bekeken; Andrea leest ze later na.
Vul per vraag de letter in na `[Answer]:`. Past geen enkele optie, kies dan de laatste (Anders) en licht toe.
---
## Vraag 1: Hoe leggen we een alinea met links vast?
De alinea "Nieuwsgierig naar mijn werk? Bekijk **mijn portfolio** of **neem contact op** voor een fotoshoot!" bevat twee links. De content moet platte data blijven die de API straks 1-op-1 kan leveren, en Andrea moet zulke tekst later in een CMS kunnen bewerken.
- A) **Stukjes**: een alinea is een lijst van tekst en links, bijvoorbeeld `['Nieuwsgierig naar mijn werk? Bekijk ', { text: 'mijn portfolio', to: '/portfolio' }, ' of ', …]`. Geen parser nodig, de link-doelen zijn getypeerd, en het lijkt op wat rich-text-editors in een CMS opslaan. (aanbevolen)
- B) **Markdown-achtige tekst**: `'Bekijk [mijn portfolio](/portfolio) of …'`, met een kleine parser in `lib/`. Leesbaar voor mensen, maar de parser en de controle van de link-doelen moeten zelf gebouwd en getest worden, en een tikfout in een link valt pas bij het draaien op.
- C) **Sjabloon met plaatshouders**: `'Bekijk {portfolio} of {contact} voor een fotoshoot!'` plus een lijst links. Kort, maar twee plekken die bij elkaar moeten blijven passen.
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 2: Hoe ziet een link-doel eruit?
Links gaan naar een pagina, soms met een anker: `/portfolio`, `/#contact` en later `/contact`.
- A) **Route plus optioneel anker**: `{ to: '/', hash: 'contact' }`, waarbij `to` een bestaande route moet zijn (een tikfout is een typefout, net als in de menu's). Past direct op `RouterLink`. (aanbevolen)
- B) **Vrije tekst**: `'/#contact'`. Simpeler, maar zonder controle of de pagina bestaat.
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 3: Wat staat er over Andrea in de gestructureerde data (`Person`)?
Zoekmachines verwachten dat gestructureerde data overeenkomt met wat er zichtbaar op de pagina staat.
- A) **Basis**: naam (Andrea Slop), functie (lifestyle fotograaf), plaats (Huizen, NL), afbeelding, social-links en de koppeling aan het bedrijf
- B) **Basis + specialisaties**: als A, plus `knowsAbout` met de drie specialisaties die in de tekst staan (newbornfotografie, zwangerschapsfotografie, gezinsfotografie) (aanbevolen)
- C) **B + opleiding**: ook de studie Communicatie & Media Design. De naam van de hogeschool staat niet op de pagina, dus dat wordt een opleiding zonder instelling.
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: B
## Vraag 4: Koppeling tussen Andrea en het bedrijf
Het bedrijf (`ProfessionalService`) staat op elke pagina; Andrea (`Person`) alleen op deze pagina.
- A) **Alleen vanaf deze pagina**: `Person.worksFor` verwijst naar het bedrijf via zijn `@id`. De gegevens van het bedrijf op de andere pagina's veranderen niet, behalve dat ze dat vaste `@id` krijgen. (aanbevolen)
- B) **Twee kanten op**: ook het bedrijf op elke pagina verwijst naar Andrea (`founder`), via een `@id` dat naar deze pagina wijst
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: B
@@ -0,0 +1,10 @@
# Functional Design Plan — Unit 2: Over mij page
Depth: minimal. Scope from the execution plan: the content model with inline links, and the rules and testable properties of the structured data (PBT-01). Questions: [over-mij-page-fd-questions.md](over-mij-page-fd-questions.md).
- [x] Collect and analyse the answers in `over-mij-page-fd-questions.md`
- [x] `domain-entities.md` — `AboutPageContent`, `RichText` and its segments, link target, `ContentImage` reuse; structured data entities (`AboutPage`, `Person`, `ProfessionalService` `@id`)
- [x] `business-rules.md` — content rules (texts, link targets, alt texts), structured data rules (fields, sources, exclusions, linking), SEO registry rules (indexed, title/description limits, preview image)
- [x] `business-logic-model.md` — how the route turns content and site data into head tags, JSON-LD and the rendered page; pure functions and their properties for PBT (PBT-01)
- [x] `frontend-components.md` — component hierarchy, props, heading ids, interactions (links, hash navigation to `/#contact`, reveal), test ids
- [x] Validate against requirements.md, application-design.md and the extension rules