Files
AndreaSlopFotografie/aidlc-docs/features/soorten-fotoshoots-page/inception/plans/application-design-plan.md
T
SluijsensandClaude Opus 5.5 166e5d32bb Records unit 1 of the Soorten fotoshoots page as generated
Adds the feature's inception documents (requirements, execution plan,
application design), the code generation plan and summary of unit 1,
its state and audit log, and its row in the active features list.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-25 08:26:06 +01:00

7.9 KiB
Raw Blame History

Application Design Plan — Soorten fotoshoots Page

Depth: minimal. Business rules (contact-link derivation, structured data, PBT properties) follow in Functional Design for unit 2.

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. link derivation and SEO builders)
  • Generate services.md: composition in the route (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)

  • MediaText reverse: optional boolean, default false; from lg the photo moves to the second column (design .about--reverse / .shoot:nth-child(even)), stacked it stays on top. Existing callers pass nothing and render exactly as before.
  • Page-specific parts go in components/shoots/ (e.g. ShootBlock for one shoot, ShootList for the five with the divider lines and the alternation), the same split as components/home/ and components/about/ (Over mij design Q4 = A). Shared building blocks get their own folder directly under components/.
  • Contact link: a pure function in lib/ derives the router link props from a shoot type ({ to: '/', search: { pakket }, hash: 'contact' } or without search). The target is never stored as a URL in the content (NFR-SF-06). Switching to /contact?pakket= later means changing only this function.
  • Accessible link name: the same pattern as the price cards: visible "Stuur een berichtje" plus a VisuallyHidden part ("over een newbornshoot").
  • Content: ShootType in content/types.ts, the list in content/shootTypes.ts, page texts (intro, closing block) in a page content object; passed in from the route. Shape agreed with portfolio-page, which uses the list for its filters and captions: { id: ShootTypeId; name; shootLabel; paragraphs; image; packageId? } with ShootTypeId = 'newborn' | 'zwangerschap' | 'gezin' | 'loveshoot' | 'portret' (stable ids; id instead of the earlier working name slug, as in packages.ts). shootLabel ("Newbornshoot") also feeds the hidden part of the link name.
  • SEO: serviceArea in SiteContent; professionalService reads it; a pure builder for the page (ItemList of Service) passed as extra into contact-page's webPage(). The route's head() combines pageHead('/soorten-fotoshoots') with one extra application/ld+json script.
  • Anchor: Pricing passes id="prijzen" to its PageSection, which already handles scrollMarginTop for anchors.

Vul per vraag de letter in na [Answer]:. Past geen enkele optie, kies dan de laatste (Anders) en licht toe.

Vraag 1: Foto zonder kader in MediaText

MediaText toont de foto nu altijd met het zandkleurige vlak erachter (FramedImage, design .about__media). In het ontwerp hebben de shootfoto's geen kader (.shoot__media: alleen de foto, staand 4:5).

  • A) MediaText krijgt een optie frame (standaard aan). Met frame={false} toont hij dezelfde foto zonder het vlak; het laden (DeferredImage, of priority voor de eerste foto) blijft hetzelfde. FramedImage krijgt daarvoor dezelfde optie, zodat de fotostijl op één plek blijft. Bestaand gebruik verandert niet. (aanbevolen: volgt het ontwerp, en de layout blijft in één component)
  • B) De shootfoto's krijgen ook het zandkleurige kader. Geen extra optie nodig, maar dat wijkt af van het ontwerp.
  • C) ShootBlock bouwt zijn eigen grid met een gewone foto en gebruikt MediaText niet. Dan is ook de reverse-optie op MediaText niet nodig.
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Answer: X, in het live design heb je op deze pagina een soortgelijk kader, maar per shoot een andere kleur. Kan je het kader niet laten staan, maar dan een kleur opgeven voor het kader met als standaard de kleurdie nu wordt gebruikt? Dus houden wat er nu is, maar de kleur kunnen meegeven.

Vraag 2: Interface van CallToAction

Het afsluitende blok heeft een h2, een intro met een link erin ("de pakketten") en een knop.

  • A) Layout met vaste plekken: CallToAction krijgt title, titleId, lead (tekst of tekst met link, als ReactNode) en de knop als children. Hij regelt de sectie (achtergrond paper.alt, smalle gecentreerde kolom, compacte ruimte), de koptekststijl, de intro-stijl en de ruimte boven de knop. Elke pagina kiest zelf de knop (LinkButton) en de link in de tekst. (aanbevolen: dezelfde aanpak als MediaText, en een andere pagina kan hem gebruiken met een andere knop)
  • B) Alles als data: CallToAction krijgt { title, lead, action: { label, to, hash } } en rendert de knop zelf. Minder code per gebruik, maar een link in de intro moet dan via een apart model voor tekst met links.
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Vervolgvragen

Vraag 1 is duidelijk: het vlak blijft, FramedImage/MediaText krijgen een optie voor de kleur van het vlak, standaard sand (#d9cdbc), dus homepage en Over mij blijven gelijk.

Op de live pagina heeft elk shootvlak deze kleur. Geen ervan staat nu in het thema:

Shoot Kleur live
Newborn #ABA699 (grijsbeige)
Zwangerschap #975030 (roestbruin)
Loveshoot #A18679 (taupe)
Portretten #84847C (grijsgroen)
Gezin (nieuw) bestaat live nog niet

Vervolgvraag 1: Welke kleuren krijgen de vlakken?

  • A) De vier live kleuren als nieuwe theme-tokens in een eigen groep (bijv. frame.stone, frame.rust, frame.taupe, frame.olive, naast sand als standaard). In shootTypes.ts staat per shoot alleen de naam van het token, geen hexcode, zodat de kleuren op één plek in het thema blijven. Gezin krijgt het heidegroen van de site (accent, #7f8b76), al een themakleur die bij de rest past. (aanbevolen)
  • B) Zoals A, maar Gezin krijgt sand, de standaardkleur
  • C) Geen nieuwe kleuren: elke shoot kiest uit de bestaande themakleuren (sand, paper.deep, accent, ink.muted). Rustiger, maar wijkt af van de live site.
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Vervolgvraag 2: Liggend of staand?

Het ontwerp snijdt de shootfoto's staand bij (4:5). De live foto's zijn liggend (3:2, bijv. 1600×1067). Een liggende foto staand bijsnijden laat bijna de helft van de breedte weg.

  • A) Liggend 3:2, zoals de live foto's. Er valt niets weg, en het vlak achter de foto valt net zo als op de homepage. (aanbevolen: past bij de foto's die er zijn)
  • B) Staand 4:5, zoals het ontwerp. Per foto kies ik het uitsnedepunt en laat ik je het resultaat zien voordat het vastligt; komt een foto er slecht uit, dan kiezen we samen een andere.
  • C) 4:3, zoals de foto in het blok Over mij: een tussenweg
  • X) Anders (beschrijf hieronder na de Answer:-tag)

De portfoliopagina (parallelle feature) krijgt filters per shoot, en dat filter kan in de URL: /portfolio?shoot=newborn toont alleen de newbornfoto's; een onbekende soort of een soort zonder foto's valt terug op "Alles". Elk shootblok hier zou daarnaar kunnen linken. Dit staat niet in het ontwerp en niet in de goedgekeurde requirements.

  • A) Ja: onder elk shootblok, naast "Stuur een berichtje", een tweede link "Bekijk meer newbornfoto's" (per shoot de juiste naam) naar /portfolio?shoot=<id>. Zolang portfolio nog niet gemerged is, komt de bezoeker daar op de placeholder "in de maak" uit; daarom zet ik de link pas aan als portfolio in master staat.
  • B) Nee, niet in deze feature. Later één kleine aanpassing, zodra beide pagina's live zijn. (aanbevolen: deze feature hangt dan niet af van de planning van portfolio)
  • X) Anders (beschrijf hieronder na de Answer:-tag)