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>
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=HomeSectionrenamed, 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 inseo.ts, next toprofessionalService. The route'shead()combinespageHead('/over-mij')with one extraapplication/ld+jsonscript; the business gets a stable@id. The page registry (sitePages.ts) stays limited to title, description, indexed andogImage. - Content:
content/aboutContent.ts+AboutPageContentincontent/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
LinkButtonwithvariant="accent"; links in text useLink 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:
MediaTextkrijgt de foto (image,aspectRatio) en de tekstkolom alschildren. Elk gebruik vult zelf de kop en de tekst in metSectionHeading,Texten links. Flexibel, en de inhoud blijft bij de pagina die hem kent. (aanbevolen) - B) Inhoud als data:
MediaTextkrijgt{ 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 eenas-prop: standaard een gewone tekst, en metas="h3"een kop.SectionHeadingenPageIntrogaan hem ook gebruiken, zodat de labelstijl (tekststijl + kleur + marge) op één plek staat. (aanbevolen) - B)
SectionHeadinguitbreiden met een optie die alleen een label als kop rendert (bijvoorbeeldlevel="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 algemenerPhotoGridmet een aantal kolommen), dieDeferredImageen de theme-tokens hergebruikt.IntroGalleryblijft zoals hij is. Simpel, want het gedrag verschilt duidelijk. (aanbevolen) - B) Eén gedeelde galerijcomponent uit
IntroGalleryhalen met de variantenstaggered(homepage) enduo(hier), enIntroGallerydaarop 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 (bijvoorbeeldAboutIntroen éénStorySectionvoor beide tekstblokken). Gedeelde bouwstenen (MediaText,Eyebrow,PhotoDuo,PageSection) staan elk in een eigen map direct ondercomponents/. Dezelfde indeling als de homepage. (aanbevolen) - B) Alles direct in de route
routes/over-mij.tsxopbouwen met de gedeelde bouwstenen, zonder pagina-specifieke componenten - X) Anders (beschrijf hieronder na de Answer:-tag)