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

6.1 KiB

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

  • 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. webPage())
  • Generate services.md — composition in the routes (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)

  • 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)

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)

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)

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)