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>
213 lines
14 KiB
Markdown
213 lines
14 KiB
Markdown
# Verificatievragen — Contactpagina
|
||
|
||
Al vastgelegd (geen vraag nodig):
|
||
|
||
- **Route** `/contact` bestaat al als placeholder ([contact.tsx](../../../../../web/src/routes/contact.tsx)) en wordt de echte pagina. Het hoofdmenu en de footer verwijzen er al naar.
|
||
- **Layout en stijl** komen uit het ontwerp ([contact.html](../../../../../design/andreaslop-static/contact.html)): page head (eyebrow "Neem contact op", h1 "Contact", intro), daaronder een sectie met twee kolommen: foto met contactgegevens, en het formulier.
|
||
- **Hergebruik eerst**: `PageIntro`, `PageSection` (`spacing="flushTop"`), `FramedImage`/`DeferredImage`, `Reveal`, `Eyebrow`, `ContactForm`, `ContactFormGate`, de pure logica (`contactFormReducer`, `validateContact`, `isLikelySpam`, `emailAddress`, `visibleSocials`, `mailtoLink`) en de theme-tokens. Geen hardgecodeerde kleuren, geen CSS-bestanden, geen nieuwe dependencies.
|
||
- **Formulier direct laden**: op deze pagina staat het formulier boven de vouw, dus het wordt niet lazy geladen zoals op de homepage.
|
||
- **E-mailadres** wordt, net als nu, pas in de browser samengesteld en komt nergens leesbaar in de bundle of de JSON-LD.
|
||
- **Toegankelijkheid**: dezelfde lat als Over mij: één h1, secties met een toegankelijke naam, contrast ≥ 4.5:1, `prefers-reduced-motion`, axe in de tests en Lighthouse accessibility 1.0.
|
||
- **Afspraken met de parallelle features**: generieke `webPage()`-helper voor JSON-LD als aparte eerste commit (Portfolio en Soorten fotoshoots bouwen erop), en alleen eigen regels in `sitePages.ts`, `lighthouserc.cjs` en `active-features.md`.
|
||
|
||
Wat ik zag op het ontwerp, in de code en op de live site (andreaslop.nl/contact):
|
||
|
||
| Onderdeel | Ontwerp | Huidige code (formulier homepage) | Live site |
|
||
| --------------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ----------------------------------------- |
|
||
| Velden | naam, e-mail, **onderwerp** (vrije tekst), bericht | naam, e-mail, **"In welke shoot heb je interesse?"** (Zwangerschap / Newborn / Gezin / Overig), bericht | zelfde als de code (Familie i.p.v. Gezin) |
|
||
| Reactietermijn | "binnen **2-3** werkdagen" (intro) | "binnen **1-2** werkdagen" (bedankbericht) | "binnen **1** werkdag" (intro) |
|
||
| Verzendknop | "Verzenden" | "(Aan)vraag versturen" | "(Aan)vraag versturen" |
|
||
| Contactgegevens | E-mail, Instagram, Facebook (h3 + link) onder de foto | bestaat nog niet als blok | Email en Instagram, plus social-iconen |
|
||
| Foto | `contact.jpg`, alt "Andrea Slop met haar camera" | — | zelfde foto, **zonder alt-tekst** |
|
||
| LAYOUT.md | — | Intro / Photo + Contact form / Contact details over de volle breedte | — |
|
||
|
||
Vul per vraag de letter in na `[Answer]:`. Past geen enkele optie, kies dan de laatste (Anders) en licht toe.
|
||
|
||
---
|
||
|
||
## Vraag 1: Velden van het formulier
|
||
|
||
- A) Hetzelfde formulier als op de homepage en de live site: naam, e-mail, de shoot-keuzelijst en bericht. Eén formulier, één payload (`{ naam, email, shoot, bericht }`) voor de API, en de keuzelijst blijft gekoppeld aan de pakketten. (aanbevolen)
|
||
- B) Zoals in het ontwerp: een vrij onderwerpveld in plaats van de keuzelijst. Dan krijgt `ContactForm` een variant, en de API twee soorten berichten.
|
||
- C) Allebei: de keuzelijst én een vrij onderwerpveld
|
||
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 2: Reactietermijn
|
||
|
||
Ontwerp, code en live site beloven alle drie iets anders. Ik zet de termijn op één plek in de content (`siteContent`), zodat de intro van deze pagina en het bedankbericht van het formulier (ook op de homepage) altijd hetzelfde zeggen. Welke termijn?
|
||
|
||
- A) 1-2 werkdagen (wat het formulier nu al zegt) (aanbevolen: haalbaar en al eerder goedgekeurd)
|
||
- B) 1 werkdag (live site)
|
||
- C) 2-3 werkdagen (ontwerp)
|
||
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 3: Shoot voorselecteren via de link
|
||
|
||
Soorten fotoshoots wil vanaf elke shoot linken naar het formulier met die shoot alvast gekozen. Op de homepage werkt dat al met `/?pakket=newborn#contact` (een onbekende waarde wordt genegeerd en nooit op de pagina getoond).
|
||
|
||
- A) Dezelfde parameter op deze pagina: `/contact?pakket=<id>`, met dezelfde logica als de homepage (`packageFromSearch`). Bekende waarden: `zwangerschap`, `newborn`, `gezin`. Een shoot zonder pakket (bijvoorbeeld een loveshoot) linkt gewoon naar `/contact`. (aanbevolen)
|
||
- B) Een nieuwe parameter `/contact?onderwerp=<slug>` met de slugs van de shoot-types van Soorten fotoshoots, die ook naar "Overig" kan
|
||
- C) Geen voorselectie: altijd gewoon `/contact`
|
||
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 4: Formulier zolang er geen back-end is
|
||
|
||
Het formulier kan nog niets versturen. Op de homepage staat het daarom gedimd en onbedienbaar onder een "Binnenkort"-melding met een mailknop (`siteContent.contactForm.enabled = false`).
|
||
|
||
- A) Hier precies hetzelfde gedrag, via dezelfde schakelaar. Zodra de API er is, gaan beide formulieren tegelijk aan. (aanbevolen)
|
||
- B) Op deze pagina het formulier verbergen tot de API er is, en alleen de contactgegevens en een mailknop tonen
|
||
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 5: Hergebruik van de formulier-opbouw
|
||
|
||
Op de homepage regelt `ContactSection` de koppeling tussen de gate, het formulier, de shoot-opties en de voorselectie. Deze pagina heeft precies hetzelfde nodig, alleen zonder lazy loading.
|
||
|
||
- A) Die koppeling uit `ContactSection` halen in een gedeeld blok (werktitel `ContactPanel`) dat zowel de homepage als deze pagina gebruikt. Het gedrag op de homepage blijft gelijk. (aanbevolen)
|
||
- B) Op deze pagina zelf `ContactFormGate` en `ContactForm` samenstellen en `ContactSection` laten zoals hij is
|
||
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 6: Welke contactgegevens
|
||
|
||
- A) E-mail, Instagram en Facebook, zoals in het ontwerp. Ze komen uit `siteContent`, dezelfde bron als de footer, en worden alleen getoond als ze geldig zijn. Gemaakt als herbruikbaar blok (werktitel `ContactDetails`). (aanbevolen)
|
||
- B) Alleen e-mail en Instagram, zoals op de live site
|
||
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 7: Koppen en structuur
|
||
|
||
In het ontwerp staan onder de h1 meteen h3's ("E-mail", "Instagram", "Facebook"). Het formulier heeft geen kop. Een sprong van h1 naar h3 maakt de pagina lastiger te scannen met een screenreader.
|
||
|
||
- A) Twee benoemde secties: het formulier krijgt een h2 die alleen voor screenreaders zichtbaar is (bijvoorbeeld "Stuur me een bericht"), de contactgegevens een zichtbare of verborgen h2 "Contactgegevens" met h3's per kanaal in de stijl van het ontwerp. Visueel verandert er niets. (aanbevolen)
|
||
- B) De kanalen worden h2's in de kleine labelstijl, zonder extra kop voor het formulier
|
||
- C) Letterlijk het ontwerp: alleen h3's
|
||
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||
|
||
[Answer]: X, Ik denk dat de contactgegevens mooier kunnen. Gebruik een icon bij de verschillende gegevens in plaats van een header. Kijk ook ove onder elkaar dan nog steeds de meest logische keuze is, maar de contactgegevens hanger er nu een beetje onder. Dat moet beter kunnen.
|
||
|
||
## Vraag 8: Plaats van de contactgegevens
|
||
|
||
In het ontwerp staan de contactgegevens onder de foto, in dezelfde kolom. In [LAYOUT.md](../../../../../LAYOUT.md) staan ze als apart blok over de volle breedte onder foto en formulier.
|
||
|
||
- A) Zoals in het ontwerp (onder de foto), en LAYOUT.md daarop aanpassen volgens [.ai/layout-conventions.md](../../../../../.ai/layout-conventions.md). Op telefoon komen foto en gegevens boven het formulier. (aanbevolen)
|
||
- B) Zoals in het ontwerp, maar op telefoon het formulier eerst, dan foto en gegevens (het formulier is waarvoor de bezoeker komt)
|
||
- C) Zoals in LAYOUT.md: een apart blok over de volle breedte onder foto en formulier
|
||
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||
|
||
[Answer]: Doe een suggestie. Op mobiel is de foto ook erg groot terwijl het formulier en de contactgegevens de belangrijkere elementen zijn. Kan je een suggestie doen voor een verbetering. Ook rekening houdend met mijn antwoor din vraag 7.
|
||
|
||
## Vraag 9: Foto en alt-tekst
|
||
|
||
- A) De originele foto van andreaslop.nl downloaden, eenmalig verkleinen en comprimeren (zoals bij Over mij) en een beschrijvende Nederlandse alt-tekst schrijven die Andrea later kan nalezen (aanbevolen)
|
||
- B) De foto uit het ontwerp gebruiken (`assets/img/contact.jpg`) met de alt-tekst uit het ontwerp
|
||
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 10: Tekst van de verzendknop
|
||
|
||
- A) "(Aan)vraag versturen" houden, zoals op de homepage en de live site. Eén formulier, één tekst. (aanbevolen)
|
||
- B) "Verzenden" uit het ontwerp, voor beide formulieren
|
||
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 11: Privacy bij het formulier
|
||
|
||
Het formulier vraagt om een naam en e-mailadres. Volgens de AVG hoort de bezoeker te kunnen lezen wat er met die gegevens gebeurt. `/privacyverklaring` is nog een placeholder.
|
||
|
||
- A) Onder het formulier één korte regel met een link: "Lees in de privacyverklaring wat ik met je gegevens doe." Op beide formulieren, want ze zijn gedeeld. (aanbevolen)
|
||
- B) Nu nog geen privacyregel, wel als de privacyverklaring af is
|
||
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 12: Links die nu naar `/#contact` gaan
|
||
|
||
Op Over mij gaan "neem contact op" en "Boek je shoot" voorlopig naar het contactblok op de homepage (`/#contact`), tot deze pagina af is (besluit uit Over mij, vraag 3).
|
||
|
||
- A) Die twee links omzetten naar `/contact`. De "Boek"-knoppen op de prijskaarten van de homepage blijven naar het formulier op de homepage zelf gaan, want daar hoef je de pagina niet voor te verlaten. (aanbevolen)
|
||
- B) Alle links laten zoals ze zijn
|
||
- C) Ook de "Boek"-knoppen op de homepage naar `/contact?pakket=…` laten gaan
|
||
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 13: Indexeren door zoekmachines
|
||
|
||
`/contact` staat nu op `noindex` en ontbreekt in `sitemap.xml`.
|
||
|
||
- A) Bij het mergen op **geïndexeerd** zetten: geen `noindex` meer, in de sitemap, in Lighthouse CI als geïndexeerde pagina controleren. Ook met het formulier nog achter de "Binnenkort"-melding is de pagina bruikbaar dankzij de mailknop en de contactgegevens. (aanbevolen)
|
||
- B) Op `noindex` laten tot het formulier echt werkt
|
||
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 14: Titel en beschrijving (SEO)
|
||
|
||
Nu: titel "Contact | Andrea Slop Fotografie", beschrijving "Neem contact op met Andrea Slop Fotografie voor een fotoshoot in Huizen en omgeving. Ik denk graag met je mee over jullie wensen."
|
||
|
||
- A) Titel met zoekwoorden, bijvoorbeeld "Contact – fotoshoot boeken in Huizen", en een beschrijving die de shoots en de reactietermijn noemt. Ik stel ze voor in requirements.md en jij keurt ze goed. (aanbevolen)
|
||
- B) Titel en beschrijving laten zoals ze zijn
|
||
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||
|
||
[Answer]: B, in beschrijving kanje wat uitgebreider zijn. Bij Soorten Fotoshoots had ik ook al wat aangegeven over de locatie dat dat breder is dan huizen. Misschien dat je daar kan navragen. Misschien "Fotoshoot boeken in Huizen en omgeving"? Geef mij suggesties
|
||
|
||
## Vraag 15: Gestructureerde data (JSON-LD)
|
||
|
||
- A) Een `ContactPage` via de nieuwe `webPage()`-helper, met als onderwerp de bestaande `ProfessionalService` (verwijzing naar `businessId`). Zonder e-mailadres, zoals nu overal. `aboutPage()` gaat op dezelfde helper draaien, met dezelfde uitvoer. (aanbevolen)
|
||
- B) Alleen de bestaande `ProfessionalService`, niets extra (de helper komt er dan toch, voor Portfolio en Soorten fotoshoots)
|
||
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 16: Preview-afbeelding bij delen (Open Graph)
|
||
|
||
- A) Een eigen preview voor deze pagina: de contactfoto, bijgesneden tot 1200×630 in `web/public/` (aanbevolen)
|
||
- B) De standaardafbeelding van de site houden
|
||
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 17: Beveiligingsextensies
|
||
|
||
Moeten de beveiligingsregels als harde vereisten worden afgedwongen voor dit project? (Bij homepage en Over mij: ja.)
|
||
|
||
- A) Ja — dwing alle BEVEILIGINGSREGELS af als blokkerende vereisten (aanbevolen voor productietoepassingen)
|
||
- B) Nee — sla alle BEVEILIGINGSREGELS over (geschikt voor PoC's, prototypes en experimentele projecten)
|
||
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 18: Property-Based Testing Extensie
|
||
|
||
Moeten de property-based testing (PBT) regels worden afgedwongen voor dit project? (Bij homepage en Over mij: ja, volledig.)
|
||
|
||
- A) Ja — dwing alle PBT-regels af als blokkerende vereisten (aanbevolen voor projecten met bedrijfslogica, datatransformaties, serialisatie of stateful componenten)
|
||
- B) Gedeeltelijk — dwing PBT-regels alleen af voor pure functies en serialisatie round-trips (geschikt voor projecten met beperkte algoritmische complexiteit)
|
||
- C) Nee — sla alle PBT-regels over (geschikt voor eenvoudige CRUD-applicaties, UI-only projecten of dunne integratielagen zonder significante bedrijfslogica)
|
||
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 19: Operations-fase
|
||
|
||
Moet deze feature na Construction de Operations-fase doorlopen (deployment en monitoring inrichten)? (Bij Over mij: nee, de CI deployt al naar test.)
|
||
|
||
- A) Ja — na Construction de Operations-fase uitvoeren (deployment + monitoring)
|
||
- B) Nee — stoppen na Build and Test (deployment/monitoring vallen buiten deze feature)
|
||
- C) Weet ik nog niet — vraag het me opnieuw na de Construction-fase
|
||
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||
|
||
[Answer]: B
|