Files
AndreaSlopFotografie/aidlc-docs/features/homepage-sections/inception/application-design/application-design.md
T
SluijsensandClaude Opus 5.5 c81dcd3979 Adds the inception docs and design for the homepage sections
Refreshes the shared reverse engineering docs, adds the requirements,
application design and units for the homepage-sections feature, and
updates the static design: live prices and form fields, the new
Lieve woorden block and the coming-soon gate over the contact form.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 23:46:30 +02:00

7.1 KiB
Raw Blame History

Application Design — homepage-sections

Consolidated design. Details: components.md, component-methods.md, services.md, component-dependency.md. Decisions: application-design-plan.md (Q1–Q6 all A, except Q1 = B).

1. Design reference (FR-HP-01, done in this stage)

  • design/andreaslop-static/index.html + assets/css/style.css + assets/js/main.js:
    • Prijzen: live packages (Zwangerschap € 175, Newborn € 185, Gezin € 175 with the live inclusions); "Boek je shoot" → index.html?pakket=<id>#contact, preselected by the script
    • Lieve woorden (new, section 13b in the CSS): between Prijzen and Contact on paper.alt; one review at a time — framed photo (same sand offset block as the about block), large Marcellus quotation mark in heidegroen, shoot type as eyebrow, quote in Marcellus, names in small caps; prev/next arrows and dots (44 px hit areas); polite live region; no autoplay; stacked below 1024 px
    • Contact: live fields (Naam, E-mail, "In welke shoot heb je interesse?" select, "Stel hier je vraag"), button "(Aan)vraag versturen", honeypot, time check; the form sits dimmed and inert under a "Binnenkort" notice with "Stuur een e-mail" (data-form-disabled switch); now on a plain paper background so backgrounds keep alternating
    • Lifestyle fotografie: intro-3.jpg replaced by the current live photo (manifest updated)
  • LAYOUT.md: Home now has seven blocks (Hero, Highlights, About me, Prices, Testimonials, Contact, Instagram); new letter G colour added to .ai/layout-conventions.md.
  • contact.html (the /contact page design) is unchanged — out of scope (Q16); the script supports both forms.

2. Structure

graph TD
    Route["routes/index.tsx (validateSearch pakket)"] --> Hero["Hero (exists)"]
    Route --> S1["home/IntroGallery"]
    Route --> S2["home/AboutBlock"]
    Route --> S3["home/Pricing"]
    Route --> S4["home/Testimonials"]
    Route --> S5["home/ContactSection"]
    Route --> S6["home/InstagramGrid"]
    S5 --> Gate["ContactForm/ContactFormGate"]
    Gate --> Form["ContactForm/ContactForm"]
    Form --> Adapter["contact/submitContactForm"]
    classDef route fill:#f6e05e,stroke:#c05621,stroke-width:1px,color:#000;
    classDef home fill:#9ae6b4,stroke:#2f855a,stroke-width:1px,color:#000;
    classDef shared fill:#63b3ed,stroke:#2b6cb0,stroke-width:1px,color:#000;
    classDef existing fill:#e2e8f0,stroke:#4a5568,stroke-width:1px,color:#000;
    class Route route;
    class S1,S2,S3,S4,S5,S6 home;
    class Gate,Form,Adapter shared;
    class Hero existing;

Text alternative: the home route renders the Hero and six home sections in page order; the contact section wraps the reusable form in a gate, and the form submits through a single adapter.

  • Folders (Q1 = B): components/home/{IntroGallery,AboutBlock,Pricing,Testimonials,ContactSection,InstagramGrid}; reusable pieces in components/{HomeSection,SectionHeading,Reveal,FramedImage,ContactForm}; hooks/useReveal.ts; contact/{types,submitContactForm}.ts.
  • Shared building blocks: HomeSection (padding, tone, width, aria-labelledby, anchor), SectionHeading (eyebrow, h2, lead), Reveal (+ useReveal), FramedImage (photo + sand offset block).

3. Content (Q2 = A)

  • content/packages.ts (PricingPackage[]), content/testimonials.ts (Testimonial[]), content/homeContent.ts (HomeContent: section texts, gallery, about, instagram), siteContent.contactForm.enabled = false (Q5 = A).
  • Images as ContentImage { src, alt, width, height } from web/src/assets.
  • Only the route imports content; components get props.

4. Key interactions

  • Testimonials (Q3 = A): Chakra Carousel (Ark UI) — keyboard, swipe, indicators and slide semantics built in; no autoplay; custom styling; live-region text from slideLabel; controls hidden for a single review.
  • Prijzen → Contact (Q4 = A): /?pakket=<id>#contact; packageFromSearch ignores unknown ids; preselected value flows into the form as initialShoot.
  • Contact form: Chakra Field/Input/Textarea/NativeSelect; plain React state; validateContact → per-field errors, focus to the first invalid field; isLikelySpam (honeypot + time check) → silent success; submitContactForm adapter (today rejects generically).
  • Gate: ContactFormGate with enabled from siteContent.contactForm; when off, the form is dimmed and inert, the notice shows the e-mail address (assembled with the existing emailAddress) and a mailto button; without a valid address only the coming-soon text.
  • Instagram: profile URL derived from siteContent.socials via visibleSocials; section hidden without one.

5. Pure helpers (lib/, PBT candidates)

formatPrice, shootOptions, packageFromSearch, validateContact, toContactPayload, isLikelySpam, slideLabel. Property identification per unit in Functional Design (PBT-01).

6. Requirements coverage

Requirement Covered by
FR-HP-01 §1 (done)
FR-HP-02 IntroGallery
FR-HP-03 AboutBlock, FramedImage
FR-HP-04 Pricing, PriceCard, packages.ts, formatPrice, package handover
FR-HP-05 Testimonials (Chakra Carousel), testimonials.ts, slideLabel
FR-HP-06 ContactSection, ContactForm, validateContact, shootOptions, submitContactForm
FR-HP-07 ContactFormGate, siteContent.contactForm
FR-HP-08 isLikelySpam, honeypot field, max lengths
FR-HP-09 Widget slot in ContactForm (no script); integration in the API feature
FR-HP-10 InstagramGrid, homeContent.instagram
FR-HP-11 Reveal, useReveal
FR-HP-12 content modules, ContentImage, assets
NFR-HP-01 HomeSection labelling, Field wiring, Carousel semantics, inert gate, 44 px targets
NFR-HP-02 Shared blocks, Chakra built-ins, theme reuse, English comments
NFR-HP-03 Injectable submit, pure helpers, arbitraries
NFR-HP-04 No new third parties, adapter + gate, spam filter, generic errors
NFR-HP-05 Lazy images with dimensions
NFR-HP-06 API-shaped content and payload types

7. Extension compliance (Application Design)

  • Security Baseline: SECURITY-04 compliant (no CSP change, no external resources); SECURITY-05 compliant at design level (client-side validation designed, server-side assigned to the API feature); SECURITY-10 compliant (no new dependencies — Chakra Carousel is part of the installed @chakra-ui/react); SECURITY-11 compliant (submission isolated in one adapter; misuse case: form spam — gate, honeypot, time check; captcha and rate limiting assigned to the API feature); SECURITY-13 compliant (no CDN resources); SECURITY-15 compliant (adapter failure → generic message, input kept). SECURITY-01/02/03/06/07/08/09/12/14 N/A (no server, data store, IAM or authentication in this feature).
  • Property-Based Testing: PBT-01 planned per unit in Functional Design; pure helpers are isolated in lib/ to make them property-testable; PBT-07 generators to be added to test/arbitraries.ts; PBT-08/09 compliant (existing fast-check setup with seed logging).