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>
66 lines
5.1 KiB
Markdown
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
|