Files
SluijsensandClaude Opus 5.5 4c257b7ac0 Plans the Contact page and records unit 1 as generated
Workspace detection, a reverse engineering delta, requirements with the
approved layout mockups, the execution plan and the application design
for the Contact page, plus the code generation plan and summary of the
webPage helper. Corrects the contact payload in the shared API notes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-25 16:59:38 +01:00

69 lines
6.1 KiB
Markdown

# Application Design Plan — Contact Page
Depth: minimal. Business rules (what `ContactPanel` must keep from the homepage, which channels the card shows, the `?pakket=` handling on this page, the responsive photo) follow in Functional Design for units 2 and 3.
## 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. `webPage()`)
- [x] Generate `services.md` — composition in the routes (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)
- **`webPage(type: WebPageType, path: RoutePath, extra = {})`** in `seo.ts`, as agreed with portfolio-page and soorten-fotoshoots-page: `@context`, `@type`, `@id` = `url` = `canonicalUrl(path)`, `name`/`description` from `sitePages[path]`, `inLanguage: 'nl-NL'`, then `...extra`. `WebPageType = 'WebPage' | 'AboutPage' | 'ContactPage' | 'ImageGallery' | 'CollectionPage'`. `aboutPage()` keeps its signature and becomes `webPage('AboutPage', path, { mainEntity: person(...) })`. A new `contactPage(path)` = `webPage('ContactPage', path, { about: { '@id': businessId } })`.
- **Icons**: the card reuses the existing platform registry (`content/socialPlatforms.ts`: name + offline icon for Facebook and Instagram) plus one mail icon from the same set (`@iconify-icons/ant-design`). No new dependency.
- **Privacy line**: part of `ContactForm` itself (under the submit button), so every form that uses it has the line. Link target `/privacyverklaring` as a typed route.
- **Reply time**: one value in `SiteContent` (e.g. `contactForm: { enabled, replyTime: '1-2 werkdagen' }`), passed to `ContactForm` for the thank-you message and used by the contact page intro.
- **Folders**: shared pieces at the top level of `components/` (`ContactPanel/`, `ContactDetails/`), page-specific pieces in `components/contact/` (like `components/about/` for Over mij). Content in `content/contactContent.ts` with a `ContactPageContent` interface in `content/types.ts`.
---
Vul per vraag de letter in na `[Answer]:`. Past geen enkele optie, kies dan de laatste (Anders) en licht toe.
## Vraag 1: Wat gaat er mee in `ContactPanel`?
Het contactblok op de homepage (`ContactSection`) doet nu zes dingen: (1) de kop "Contact", (2) de gate, (3) het formulier lazy laden met een placeholder, (4) de shoot-opties uit de pakketten, (5) de voorselectie uit `?pakket=` plus het mailonderwerp, en (6) `?pakket=` uit de adresbalk halen, naar `#contact` scrollen en de focus op de kop zetten.
- A) **Punt 2 t/m 5 gaan in `ContactPanel`**, met een prop voor het laden (`lazy` op de homepage, direct op de contactpagina). Punt 1 en 6 blijven bij de pagina, omdat ze per pagina verschillen: de homepage scrollt en verplaatst de focus, de contactpagina ruimt alleen de URL op. (aanbevolen)
- B) **Alleen punt 2, 4 en 5** in `ContactPanel`. Het lazy laden (3) blijft in `ContactSection`, dat het formulier dan als `children` aan het panel geeft. Het panel blijft kleiner, maar de koppeling tussen gate, formulier en placeholder wordt omslachtiger.
- C) **Ook punt 6** in `ContactPanel`, met opties voor wel of niet scrollen en de focus verplaatsen. Alles op één plek, maar het panel moet dan de router en de pagina kennen.
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 2: Hoe komt de contactkaart op twee plekken?
Op brede schermen staat de kaart rechts, over de foto, ná het formulier. Op smalle schermen staat hij bovenaan, vóór het formulier en met het kleine portret. Voor toetsenbord- en screenreadergebruikers moet de volgorde in de HTML gelijk zijn aan wat je ziet.
- A) **Twee keer renderen, per schermbreedte één zichtbaar**: één kaart in de rechterkolom (alleen breed), één boven het formulier met portret (alleen smal). De verborgen kaart is met `display: none` volledig weg, ook voor screenreaders. Ze krijgen elk een eigen id, zodat er geen dubbele ids zijn. De volgorde klopt dan altijd. (aanbevolen)
- B) **Eén keer renderen, vóór het formulier in de HTML**. Op brede schermen zet CSS hem rechts. Op desktop komt de toetsenbordfocus dan eerst langs de kaart en pas daarna bij het formulier, terwijl je het formulier links als eerste ziet.
- C) **Eén keer renderen, op de plek die past bij de schermbreedte**: React kiest met een media query waar hij staat. Na het laden kan hij één keer verspringen als de schermbreedte bekend wordt.
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 3: De tekst bij Instagram en Facebook in de kaart
Bij e-mail is het adres de linktekst. Voor Instagram en Facebook heeft de content nu alleen het platform en de URL.
- A) **Een optioneel `label` per sociale link in de content** (bijvoorbeeld "@andreaslopfotografie"). Zonder label toont de kaart de naam van het platform ("Instagram"). Andrea kan het straks in het CMS aanpassen. (aanbevolen)
- B) **Afleiden uit de URL**: "@" plus het laatste stuk van het pad (`instagram.com/andreaslopfotografie/` → "@andreaslopfotografie"). Geen extra veld, maar dat werkt niet voor elke link (bijvoorbeeld een Facebook-pagina met een id-URL).
- C) **Altijd de naam van het platform** ("Instagram", "Facebook"), zoals in de footer
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 4: Het blok "foto met kaart erover"
De rechterkolom (foto 4:5 met de kaart over de onderrand) is nu alleen voor deze pagina. Het lijkt op `FramedImage` (foto met een zandkleurig vlak erachter), maar dan met inhoud over de foto heen.
- A) **Een paginacomponent in `components/contact/`** (werktitel `ContactAside`), die `ContactDetails` en de foto samenstelt. Wordt het later ook elders nodig, dan maken we hem dan algemeen. (aanbevolen)
- B) **Nu al een algemene component** (werktitel `MediaCard`: foto met een willekeurige kaart erover), voor eventueel later gebruik op andere pagina's
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A