Files
SluijsensandClaude Opus 5.5 26106f280f 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>
2026-10-22 23:35:21 +02:00

5.1 KiB

Application Design Plan — Over mij Page

Depth: minimal. Business rules (structured data, content model with inline links) follow in Functional Design for unit 2.

Plan

  • Answer the design questions below
  • Generate components.md — new and changed components with responsibilities and interfaces
  • Generate component-methods.md — props and function signatures (incl. the new SEO builders)
  • Generate services.md — composition in the route (there is no service layer in this SPA)
  • Generate component-dependency.md — dependency matrix and data flow
  • Generate application-design.md — consolidated design
  • Validate completeness and consistency against requirements.md

Already decided (no question needed)

  • PageSection = HomeSection renamed, same props. One addition for this page: a way to drop the top padding, because the first block sits directly under the page head (design .section--flush-top), e.g. spacing="flushTop".
  • SEO: the structured data builders (aboutPage(...), person(...)) are pure functions in seo.ts, next to professionalService. The route's head() combines pageHead('/over-mij') with one extra application/ld+json script; the business gets a stable @id. The page registry (sitePages.ts) stays limited to title, description, indexed and ogImage.
  • Content: content/aboutContent.ts + AboutPageContent in content/types.ts, passed in from the route (same pattern as the homepage). The exact shape of a paragraph with inline links is defined in Functional Design.
  • Booking button: the existing LinkButton with variant="accent"; links in text use Link variant="underline" + RouterLink.

Vul per vraag de letter in na [Answer]:. Past geen enkele optie, kies dan de laatste (Anders) en licht toe.

Vraag 1: Interface van het gedeelde blok "foto naast tekst" (MediaText)

Het blok wordt gebruikt door AboutBlock op de homepage (eyebrow + h2 + 3 alinea's + link "Lees mijn verhaal") en door "Hoi! Ik ben Andrea" hier (eyebrow + h2 + 3 alinea's, waarvan één met twee links).

  • A) Alleen layout: MediaText krijgt de foto (image, aspectRatio) en de tekstkolom als children. Elk gebruik vult zelf de kop en de tekst in met SectionHeading, Text en links. Flexibel, en de inhoud blijft bij de pagina die hem kent. (aanbevolen)
  • B) Inhoud als data: MediaText krijgt { eyebrow, title, paragraphs, image, link? } en rendert alles zelf. Minder code per gebruik, maar inline links in een alinea en verschillen tussen de twee pagina's moeten dan via extra props.
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Vraag 2: De h3-koppen in labelstijl ("Hoe het begon", "Buiten de camera om")

De labelstijl (klein, hoofdletters, ruime letterafstand, accent.deep) staat nu twee keer los uitgeschreven: in SectionHeading en in PageIntro, beide als Text.

  • A) Eén Eyebrow-component met een as-prop: standaard een gewone tekst, en met as="h3" een kop. SectionHeading en PageIntro gaan hem ook gebruiken, zodat de labelstijl (tekststijl + kleur + marge) op één plek staat. (aanbevolen)
  • B) SectionHeading uitbreiden met een optie die alleen een label als kop rendert (bijvoorbeeld level="h3" zonder titel)
  • C) Per sectie direct <Heading as="h3" textStyle="eyebrow" color="accent.deep"> schrijven, zonder nieuwe component
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Vraag 3: De twee foto's naast elkaar

In het ontwerp is dit een variant van de introgalerij van de homepage (.intro-gallery--duo): 2 kolommen, liggend 3:2, geen verspringing en geen swipe-rij op telefoons (daar onder elkaar). IntroGallery is nu een complete homepage-sectie, met de kop en de swipe-rij erin.

  • A) Nieuwe kleine component PhotoDuo (of algemener PhotoGrid met een aantal kolommen), die DeferredImage en de theme-tokens hergebruikt. IntroGallery blijft zoals hij is. Simpel, want het gedrag verschilt duidelijk. (aanbevolen)
  • B) Eén gedeelde galerijcomponent uit IntroGallery halen met de varianten staggered (homepage) en duo (hier), en IntroGallery daarop laten draaien. Meer hergebruik, maar wel een component met varianten die zich anders gedragen (wel of geen swipe-rij, wel of geen verspringing).
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Vraag 4: Waar komen de onderdelen van deze pagina?

De homepage-secties staan in components/home/. Deze pagina heeft twee tekstblokken met dezelfde opbouw ("Hoe het begon" en "Buiten de camera om": smalle kolom, h3-label, alinea's, optioneel iets eronder zoals de knop).

  • A) components/about/ met de pagina-specifieke delen (bijvoorbeeld AboutIntro en één StorySection voor beide tekstblokken). Gedeelde bouwstenen (MediaText, Eyebrow, PhotoDuo, PageSection) staan elk in een eigen map direct onder components/. Dezelfde indeling als de homepage. (aanbevolen)
  • B) Alles direct in de route routes/over-mij.tsx opbouwen met de gedeelde bouwstenen, zonder pagina-specifieke componenten
  • X) Anders (beschrijf hieronder na de Answer:-tag)