Files
AndreaSlopFotografie/aidlc-docs/features/contact-page/inception/requirements/requirement-verification-questions.md
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

14 KiB
Raw Permalink Blame History

Verificatievragen — Contactpagina

Al vastgelegd (geen vraag nodig):

  • Route /contact bestaat al als placeholder (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): 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)

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)

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)

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)

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)

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)

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

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)

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)

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)

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)

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)

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)

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)

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)

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)