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>
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 = {})inseo.ts, as agreed with portfolio-page and soorten-fotoshoots-page:@context,@type,@id=url=canonicalUrl(path),name/descriptionfromsitePages[path],inLanguage: 'nl-NL', then...extra.WebPageType = 'WebPage' | 'AboutPage' | 'ContactPage' | 'ImageGallery' | 'CollectionPage'.aboutPage()keeps its signature and becomeswebPage('AboutPage', path, { mainEntity: person(...) }). A newcontactPage(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
ContactFormitself (under the submit button), so every form that uses it has the line. Link target/privacyverklaringas a typed route. - Reply time: one value in
SiteContent(e.g.contactForm: { enabled, replyTime: '1-2 werkdagen' }), passed toContactFormfor 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 incomponents/contact/(likecomponents/about/for Over mij). Content incontent/contactContent.tswith aContactPageContentinterface incontent/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 (lazyop 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 inContactSection, dat het formulier dan alschildrenaan 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: nonevolledig 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
labelper 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/(werktitelContactAside), dieContactDetailsen 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)