Files
AndreaSlopFotografie/aidlc-docs/features/over-mij-page/inception/plans/application-design-plan.md
T
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

66 lines
5.1 KiB
Markdown

# 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
- [x] Answer the design questions below
- [x] Generate `components.md` — new and changed components with responsibilities and interfaces
- [x] Generate `component-methods.md` — props and function signatures (incl. the new SEO builders)
- [x] Generate `services.md` — composition in the route (there is no service layer in this SPA)
- [x] Generate `component-dependency.md` — dependency matrix and data flow
- [x] Generate `application-design.md` — consolidated design
- [x] 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)
[Answer]: A
## 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)
[Answer]: A
## 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)
[Answer]: A
## 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)
[Answer]: A